B4J Tutorial UI apps packaging - self contained installers

It is recommended to use B4JPackager11: Integrated B4JPackager11 - The simple way to distribute standalone UI apps

Spoiler: Older tool

B4J Packager is a small utility that uses javapackager to create a single file installer for Mac or Windows, that includes the app files and the Java runtime.

This means that from the end user perspective your app doesn't depend on any additional runtime. It makes deployments very simple.
The installer size will be around 40mb as it includes the JRE.

The Windows installer (exe) is built on a Windows computer and the Mac installer (dmg) is built on a Mac computer.
You need to install Inno Setup on the Windows computer: http://www.jrsoftware.org/isinfo.php

You can either run the attached source code from the IDE or download the jar file: www.b4x.com/b4j/files/B4JPackager.jar

The source code depends on the following additional libraries: Archiver (B4A library) and jControlFX

Using this tool is quite simple. First you need to set the path to javapackager.
On Windows the path will be similar to:
C:\Program Files\Java\jdk1.8.0_51\bin\javapackager.exe
On Mac:
/Library/Java/JavaVirtualMachines/jdk1.8.0_51.jdk/Contents/Home/bin/javapackager

Compile your app in release mode and then set the path to the Jar file and fill the other fields.
The icon on Windows is an ico file and on Mac is an icns file.

Click on the Build button. The building process can take a minute or two.
The installer will be created under the bundles folder (the folder will be opened).

Notes & tips:

1. Make sure to test your app after it is installed. It will be installed under Program Files.
Program Files is a read-only folder. Any attempt to write to File.DirApp will fail (you should use File.DirData instead).

2. javapackager documentation:
Windows - https://docs.oracle.com/javase/8/docs/technotes/tools/windows/javapackager.html#BGBIJBHF
Linux / Mac - https://docs.oracle.com/javase/8/docs/technotes/tools/unix/javapackager.html

3. It is recommended to run the packager from the IDE (at least in the beginning) as it prints important information in the logs.
You can also run it from the command line with: java -jar B4JPackager.jar
4. The installers will use the app package name to identify the app. Make sure to change it from the default value. Otherwise all applications will be installed in the same folder.
5. Java 9 is currently not supported. Make sure that both B4J and the path to javapackager point to Java 8.
6. If running on a Mac then you probably should change the package to pkg. See this discussion: https://www.b4x.com/android/forum/t...staller-dmg-failed-to-produce-a-bundle.87897/

Change log:

v1.50

- Adds support for newer versions of Java 8.
- javapackager is run in verbose mode.
- The logs are updated while the process is running.

 

[Suntzu]

Thanks Erel. It worked.

 

[Douglas Farias]

someone know how to add a option to select a path on the instalation?

classPath=path

how can i set the path if have diferents OS (windows,mac etc)
Some users want to install on driver D:/ for example and the installer dont add this option.

 

[Mohammadreza]

I packed my .jar file to .exe
But when I'm trying to install it, most of AntiVirus known it as a virus during installation and don't let it install correctly. How to solve it?

 

[Erel]

The anti virus software suspects any new executable. If you want to avoid it then you need to purchase a certificate and sign it (some anti viruses will still warn about the installer until it is popular enough).

 

[Mohammadreza]

The anti virus software suspects any new executable. If you want to avoid it then you need to purchase a certificate and sign it (some anti viruses will still warn about the installer until it is popular enough).

Ok, but what can I do now or anyway to build the executable file not installation file ( to solve the problem ) ?

 

[Erel]

You can ignore the warning.

If you like to create an executable that doesn't include an installer: https://www.b4x.com/android/forum/threads/create-windows-native-executables-exe-files.35863/#content

Though you will probably see the same warnings.

 

[Mohammadreza]

You can ignore the warning.

If you like to create an executable that doesn't include an installer: https://www.b4x.com/android/forum/threads/create-windows-native-executables-exe-files.35863/#content

Though you will probably see the same warnings.

Thanks
No solution for fix that? and then does it includes internal JRE?

 

[Erel]

There is nothing that can be fixed. It is not unique to B4J. Any non-signed executable will be considered a suspicious executable until it gains enough reputation.

http://blogs.msdn.com/b/ie/archive/...plication-reputation-building-reputation.aspx

 

[tdocs2]

The anti virus software suspects any new executable. If you want to avoid it then you need to purchase a certificate and sign it (some anti viruses will still warn about the installer until it is popular enough).

Thank you, Erel.

When you refer to certificate are you referring to Symantec SSL Certificate?

https://www.symantec.com/ssl-certificates/#

Sandy

 

[Erel]

I was referring to code signing certificates: http://codesigning.ksoftware.net/

 

[alienhunter]

Hi Erel,

setting -BsystemWide=false it does not make the installer go to the user home !, otherwise this is great thanks

args.AddAll(Array ("-deploy", "-srcFiles", txtJar.Text, "-native", packageExtension, _
            "-BsystemWide=false", "-title", txtTitle.Text, "-name", txtName.Text, "-outdir", workingFolder, _
            "-outfile", "1.exe", "-BappVersion=" & txtVersion.Text, "-appclass", appClass, _
            "-Bidentifier=" & appClass))

systemWide=boolean
Flag that indicates if the application is installed in Program Files or in the standard location in the users home directory. Set to true to install the application in Program Files. Set to false to install the application in the user's home directory. The default is false.

 

[Erel]

These parameters are handled by Oracle's javapackager tool.

 

[alienhunter]

These parameters are handled by Oracle's javapackager tool.

Thanks Erel, it works I was just looking in the wrong folder .. ... oops sorry

 

[LWGShane]

This is one little amazing utility!

Thanks!

 

[tdocs2]

Greetings.

I need your help. I am convinced that this file came from Inno Setup.

I do not know if it is real malware as it was detected by Norton Sonar....

Any feedback is appreciated.

Thank you.

Sandy

 

[Erel]

It is related to the javapackager tool. You can see it in the source code: http://grepcode.com/file/repo1.mave...fx/tools/packager/bundlers/WinAppBundler.java

 

[tdocs2]

It is related to the javapackager tool. You can see it in the source code: http://grepcode.com/file/repo1.mave...fx/tools/packager/bundlers/WinAppBundler.java

Thank you, Erel.

I presume I should report it to Norton....

Sandy

 

[Timothy Schablin]

It runs, but then closes and does nothing. No file created. No errors. No results...?????

 

[Erel]

Have you installed Inno Setup?

 

[eurojam]

Try this for the menu name. Add the following line after the args.AddAll line:

args.AddAll(Array("-BmenuHint=true", "-Bwin.menuGroup=Test"))

Attached is a version where I added the above line - also in the form - and the possibility to add a Desktop shortcut (windows only).

args.Add("-BshortcutHint=true")