Getting Started with JWrapper
To get started packaging your Java application with JWrapper you should first download the JWrapper application and request a trial license:
Using the JWrapper App
The JWrapper app is made to be simple and easy to use. When it first launches you will be asked to choose a folder for your new JWrapper project. This is where JWrapper will store temporary files related to your build and also where it will produce the final native applications.
On the first page of the application, you will see a configuration form with a few items highlighted in red. These are the minimum items you need to configure to produce a build with JWrapper.
To try out a simple build, you can fill in these items, then hit the 'Dev Build' button at the bottom of the application to start the build.
Once these are configured you can switch to the Enterprise tab and add your trial license at the top and hit the Dev Build button.
When you run the build, it will initially take a number of minutes (subsequent builds will be much quicker) before popping up a window with a link to the folder containing your new native apps.
After these steps, once your build is complete you will have native applications for Windows, Linux and MacOS in the build folder and can run your Java application as if it were a native app.
If you run your application and it doesn't pop up, you can check out our Debugging with JWrapper Guide to see where your app is installed and where it is logging errors to. Often this is something simple like a missing file you need to add to the bundle.
The JWrapper app also supports the following settings when building your application:
The Optional tab also supports a number of further settings:
Enterprise Configuration and Custom Additions
The Enterprise tab in the JWrapper app allows you to configure some more advanced options for your application:
Certain configurations such as code signing require more complex information to be added such as full details and references for certificates. In this case you can take a look at the guide that specifies the XML (e.g. Code Signing Guide) to use and then add that XML into the Custom tab in JWrapper.
Integrating JWrapper into your Build Process
When running JWrapper from the command line or from a build script the entirety of JWrapper is packaged up in one JAR file. You can find this jar file in our downloads area.
When you run JWrapper it will set up a few directories with resources it needs in the current directory. These won't be downloaded from the internet, they are extracted and you can just ignore them.
Once you have a basic project created with the JWrapper App, you can run the jwrapper jar from the command line or from a build script and specify the jwrapper.xml it produces to run the build.