B4A Library [Tool] Simple Library Compiler - Build libraries without Eclipse

The purpose of Simple Library Compiler (SLC) is to make it easier to build libraries. SLC is responsible for taking the Java source code files and generating the Jar and XML files.

As I see it, it can be useful in two cases:
- Creating wrappers for 3rd party SDKs.
- Modifying and extending existing open source libraries.

Do note that you still need to provide the source code. This tool only helps with the building steps.

How to use

Using SLC is quite simple. The main project folder should include a folder named src and optionally a folder named libs.
The Java source code files should be under the 'src' folder. Java files are saved based on the package name. So if the package is com.example then the structure will be:

Under 'libs' folder you can put any additional libraries that should be referenced during compilation.
The 'bin' folder will be created during the build.

When you press on the Compile button the code will be compiled and the Jar file and XML files will be outputted to the "additional libraries folder" that is set in Basic4android configuration.

Wrapper example

The attached zip file includes a very simpler wrapper that wraps Flurry Analytics library.

The source code:

In order to compile it (and use it) you should download their SDK and copy FlurryAgent.jar to the project 'libs' folder and to the 'additional libraries folder'.

Tips

- A simple example is included in the package (FirstLib). It is recommended to start with it.
- You can use a text editor such as Notepad++ to write the Java code.
- Tutorials about libraries development are available in this forum: http://www.b4x.com/android/forum/forums/libraries-developers-questions.32/
- There is no installer. You should just unzip the package and run the program.
- If you need to include any additional files, such as .so files, in the jar then you can create a folder named 'additional'. Any file or folder inside this folder will be added to the jar file.
- Command line mode - You can also run this tool from the command line. It expects two arguments: library name and project path.

- B4J_SimpleLibraryCompiler is included in the zip file. It creates B4J libraries.
- In order to write the library code with Eclipse you need to reference Java 7 and also reference jfxrt.jar:

V1.14 - Fixes an issue with running SLC from command line.
V1.13 - Added a field to set the path to Java 8 compiler (javac.exe). Should be similar to: C:\Program Files\Java\jdk1.8.0_211\bin\javac.exe
V1.12 (B4A) - source and target raised to Java 8.
V1.11 - SLC tools compiled with .Net Framework 4.
V1.10 - Adds support for the new structure of Additional libraries folder.
March 2018 - New zip with doclet v1.07.
V1.06 - Fixes the missing "bin\classes" issue.
V1.05 - Fixes an issue with old compiled class files not being deleted.
V1.03 - Fixes an issue related to B4A v5.
V1.02 - Allows usages of Java 7 features.
V1.01 - Fixes an issue with ignore field.

Download link: www.b4x.com/android/files/SimpleLibraryCompiler.zip

You should use Java 8 with SLC (at least when generating the XML).

 

[Douglas Farias]

I am able to build the FirstLibrary test project which is included by default. But when i am adding these 2 imports to the same file i receive compillaion error as displayed in the image attached.
Can you please help me with this?

 

[DonManfred]

Can you please help me with this?

Remove the import. It is not needed as it does not exists!

 

[Douglas Farias]

Remove the import. It is not needed as it does not exists!

It does not just for this example. But the same error is displayed with some real examples. The same is with android.content.Context. Do you have any clue on this?

 

[DonManfred]

s. The same is with android.content.Context. Do you have any clue on this?

you dont need. I do not have this import in ANY of my libs.
And i´m always using ba.context to give a context to the lib.
Remove it

 

[DonManfred]

if you have any more questions:

Create A NEW Thread here.

 

[Serdar K.]

Hello,

I am trying to change the Parse 1.4 library for support different URL's, but i couldn't have success at first to compile the library as it is.

I wanted to test to compile the source code of 1.4, which Erel shared, with SLC.
The link is :
https://www.b4x.com/android/forum/attachments/parse_1-4_src-zip.41678/

But i have got an error and notes :

Starting step: Compiling Java code.
javac 1.8.0_66
D:\SLC\Parse\src\anywheresoftware\b4a\objects\ParseObjectWrapper.java:602: error: <anonymous anywheresoftware.b4a.objects.ParseObjectWrapper$ParseQueryWrapper$2> is not abstract and does not override abstract method done(List,ParseException) in FindCallback
       {
       ^
Note: D:\SLC\Parse\src\anywheresoftware\b4a\objects\ParseObjectWrapper.java uses or overrides a deprecated API.
Note: Recompile with -Xlint:deprecation for details.
Note: D:\SLC\Parse\src\anywheresoftware\b4a\objects\ParseObjectWrapper.java uses unchecked or unsafe operations.
Note: Recompile with -Xlint:unchecked for details.
1 error


Error.

Do you have any ideas i could try?

 

[Serdar K.]

May be it is a compatibility issue?

Hello,

I am trying to change the Parse 1.4 library for support different URL's, but i couldn't have success at first to compile the library as it is.

I wanted to test to compile the source code of 1.4, which Erel shared, with SLC. But i have got an error and notes :

Starting step: Compiling Java code.
javac 1.8.0_66
D:\SLC\Parse\src\anywheresoftware\b4a\objects\ParseObjectWrapper.java:602: error: <anonymous anywheresoftware.b4a.objects.ParseObjectWrapper$ParseQueryWrapper$2> is not abstract and does not override abstract method done(List,ParseException) in FindCallback
       {
       ^
Note: D:\SLC\Parse\src\anywheresoftware\b4a\objects\ParseObjectWrapper.java uses or overrides a deprecated API.
Note: Recompile with -Xlint:deprecation for details.
Note: D:\SLC\Parse\src\anywheresoftware\b4a\objects\ParseObjectWrapper.java uses unchecked or unsafe operations.
Note: Recompile with -Xlint:unchecked for details.
1 error


Error.

Do you have any ideas i could try?

 

[Erel]

Please start a new thread for this in the libraries developers forum.

 

[Roycefer]

Is there any chance we could get an update to the B4A Simple Library Compiler to allow for usage of Java 8 language features?

 

[Erel]

The IDE compiler doesn't yet support Java 8 features. Note that Android SDK doesn't fully support Java 8 features and some features are only supported by newer versions of Android.

 

[peter01]

Hi Erel,

how can I set the native library path for the B4J SLC, so that the created jar Library can refer to my included jMath.dll file (in Windows). In B4J I get an java.lang.UnsatisfiedLinkError: no jMath in java.library.path error.

In Eclipse everything works with the include path for my jMath folder: C:\eclipse\workspace\jMath\additional for the native library location. I inspected the created jar file with 7-zip. the dll is in the root and the jMath class in the com/peter/jmath folder as specified in the java file.

 

[Erel]

Please start a new thread here: https://www.b4x.com/android/forum/forums/libraries-developers-questions.32/

Also make sure not to limit your question to a single member.

 

[somed3v3loper]

Not a big issue but almost every time I press compile I get this log , the second try compile successfully .

Starting step: Compiling Java code.
javac 1.7.0_79
javac: directory not found: bin\classes
Usage: javac <options> <source files>
use -help for a list of possible options


Error.

SLC 1.05

 

[Erel]

Make sure that Windows Explorer is not open on the library folder as it will lock it.

 

[DonManfred]

I too have this phemomen. I´m using Eclipse. From Eclipse i too get this error on the first compile.
I then need to mark the project in the exclipse IDE and compile again.
No explorer window is open.
And it always work in the second try.

 

[Erel]

Fixed in v1.06.

 

[DonManfred]

Fixed in v1.06.

Works great! Thank you very much

 

[Erel]

BADoclet v1.07 was uploaded to the zip attached to the first post.

It adds support for custom class templates.

 

[Johan Hormaza]

 

[Johan Schoeman]

View attachment 66279

Do you have a "libs" folder on the same folder level as the "src" folder that has the jar files that the library must be compile with? If not I will post it later today

Also, the -b4aignore field needs to be complete with the correct value (it could have been "com"). Check what the package names start with in the original Java project (not the wrapper)