This page (revision-17) was last changed on 15-Nov-2020 12:07 by Juan Pablo 

This page was created on 19-Feb-2014 22:18 by Juan Pablo

Only authorized users are allowed to rename pages.

Only authorized users are allowed to delete pages.

Version Date Modified Size Author Changes ... Change note
17 15-Nov-2020 12:07 3 KB Juan Pablo to previous jarbundler not used since some releases ago, so removing unneeded MacOs section
16 15-Nov-2020 12:03 3 KB Juan Pablo to previous | to last Update instructions for native launcher generation
15 04-Nov-2020 21:51 4 KB Juan Pablo to previous | to last add info style notes on windows compilation
14 27-Feb-2020 14:29 4 KB Juan Pablo to previous | to last -Djspwiki.tomcat.version=$TOMCAT_VERSION flag is required to generate binaries
13 08-Feb-2020 13:01 4 KB Dirk Frederickx to previous | to last Remove dirt
12 08-Feb-2020 02:50 4 KB pHqghUme to previous | to last Configuration ==> 1
11 04-Feb-2018 10:09 4 KB Juan Pablo to previous | to last
10 04-Feb-2018 10:02 1 KB Juan Pablo to previous | to last updating portable binaries with README.md from source (1/2)
9 22-Nov-2017 23:01 1 KB Juan Pablo to previous | to last
8 13-Feb-2017 20:37 1 KB bowlingb to previous | to last Minor grammar and spelling fixes
7 13-Feb-2017 20:35 1 KB bowlingb to previous | to last
6 20-Feb-2014 08:25 1 KB Juan Pablo to previous | to last
5 20-Feb-2014 08:24 1 KB Juan Pablo to previous | to last
4 20-Feb-2014 08:22 1 KB Juan Pablo to previous | to last
3 20-Feb-2014 00:00 1 KB Juan Pablo to previous | to last
2 19-Feb-2014 23:59 1 KB Juan Pablo to previous | to last
1 19-Feb-2014 22:18 1 KB Juan Pablo to last

Difference between version and

At line 39 removed 5 lines
!! Mac OS X
* The Mac OS X [JarBundler|http://informagen.com/JarBundler/index.html] 2.2.0 is used to build a native Mac OS X app but it depends on having the Apple JDK installed
* Supporting a modern Oracle JDK is done using the [Oracle's AppBundler Task|http://docs.oracle.com/javase/7/docs/technotes/guides/jweb/packagingAppsForMac.html]
At line 46 changed one line
The native launchers are under version control and can be re-created manually. In other words there are not automatically build because
The native launchers are under version control and can be re-created manually. In other words there are not automatically built and checked in because
At line 48 removed one line
* Considering the complex setup I'm glad that it works on the JSPWiki committer boxes
At line 52 changed one line
! Creating The Windows Launcher
As of 2.11.0-M8 recreating them is really easy, just run the following command
At line 54 removed 2 lines
Run the following commands
At line 57 changed one line
jspwiki-portable> mvn clean package
jspwiki-portable> mvn clean package -Dgenerate-native-launchers=true
}}}
At line 59 changed 2 lines
jspwiki-portable> ant woas:download-launch4j-for-mac woas:create-windows-app -Djspwiki.tomcat.version=$TOMCAT_VERSION
Buildfile: /Users/sgoeschl/work/asf/jspwiki/trunk/jspwiki/jspwiki-portable/build.xml
and that's it.
At line 62 changed 6 lines
woas:download-launch4j-for-mac:
[mkdir] Created dir: /Users/sgoeschl/work/asf/jspwiki/trunk/jspwiki/jspwiki-portable/target/unpack/launch4j
[get] Getting: http://netassist.dl.sourceforge.net/project/launch4j/launch4j-3/3.8/launch4j-3.8-macosx-x86.tgz
[get] To: /Users/sgoeschl/work/asf/jspwiki/trunk/jspwiki/jspwiki-portable/target/unpack/launch4j/launch4j-3.8-macosx-x86.tgz
[untar] Expanding: /Users/sgoeschl/work/asf/jspwiki/trunk/jspwiki/jspwiki-portable/target/unpack/launch4j/launch4j-3.8-macosx-x86.tgz into /Users/sgoeschl/work/asf/jspwiki/trunk/jspwiki/jspwiki-portable/target/unpack
[delete] Deleting: /Users/sgoeschl/work/asf/jspwiki/trunk/jspwiki/jspwiki-portable/target/unpack/launch4j/launch4j-3.8-macosx-x86.tgz
! Recreating manually the binary launchers
At line 69 changed 6 lines
woas:create-windows-app:
[launch4j] Compiling resources
[launch4j] Linking
[launch4j] Wrapping
[launch4j] Successfully created /Users/sgoeschl/work/asf/jspwiki/trunk/jspwiki/jspwiki-portable/target/woas/woas.exe
[echo] Created /Users/sgoeschl/work/asf/jspwiki/trunk/jspwiki/jspwiki-portable/target/woas/woas.exe ...
Under Windows, the above command translates to
At line 76 changed 3 lines
BUILD SUCCESSFUL
}}}
The generated {{woas.exe}} can be copied manually to {{./jspwiki-portable/src/overlay/launchers/tomcat/woas.exe}} after manual testing.
{{{
# generates the structure needed by the ant commands to build the launchers
jspwiki-portable> mvn clean package
At line 80 changed 5 lines
%%bg-info
%%label-info note%%
on windows platforms, use {{ant woas:download-launch4j-for-win woas:create-windows-app -Djspwiki.tomcat.version=$TOMCAT_VERSION}} to create the launcher.
%%
! Creating The Mac OS X Launcher
# downloads launch4j and builds the native launcher for windows
jspwiki-portable> ant woas:download-launch4j-for-win woas:create-windows-app -Djspwiki.tomcat.version=$TOMCAT_VERSION
At line 86 changed one line
Run the following commands
# downloads appbundler and builds the native launcher for mac
jspwiki-portable> ant woas:download-appbundler-for-mac-on-windows woas:create-mac-app -Djspwiki.tomcat.version=$TOMCAT_VERSION
At line 68 added 8 lines
# updates the module with the just created native launchers
jspwiki-portable> ant woas:update-tomcat-launchers
# builds the portable binaries with the updated native launchers, so manual testing can be performed right away
jspwiki-portable> mvn clean package
}}}
whereas under Unix platforms, it translates to
At line 77 added one line
# generates the structure needed by the ant commands to build the launchers
At line 80 added 4 lines
# downloads launch4j and builds the native launcher for windows
jspwiki-portable> ant woas:download-launch4j-for-mac woas:create-windows-app -Djspwiki.tomcat.version=$TOMCAT_VERSION
# downloads appbundler and builds the native launcher for mac
At line 92 removed one line
Buildfile: /Users/sgoeschl/work/asf/jspwiki/trunk/jspwiki/jspwiki-portable/build.xml
At line 94 changed 4 lines
woas:download-appbundler-for-mac:
[mkdir] Created dir: /Users/sgoeschl/work/asf/jspwiki/trunk/jspwiki/jspwiki-portable/target/unpack/appbundler
[get] Getting: https://java.net/downloads/appbundler/appbundler-1.0.jar
[get] To: /Users/sgoeschl/work/asf/jspwiki/trunk/jspwiki/jspwiki-portable/target/unpack/appbundler/appbundler-1.0.jar
# updates the module with the just created native launchers
jspwiki-portable> ant woas:update-tomcat-launchers
At line 99 changed 5 lines
woas:mac-app-oracle-jdk:
[echo] Building Mac OS X launcher for Oracle JDK
[bundleapp] Creating app bundle: woas
BUILD SUCCESSFUL
# builds the portable binaries with the updated native launchers, so manual testing can be performed right away
jspwiki-portable> mvn clean package
At line 105 removed one line
The generated {{woas.app}} can be copied manually to {{jspwiki-portable/src/overlay/launchers/tomcat/woas.app}} after manual testing.
At line 107 changed 4 lines
%%bg-info
%%label-info note%%
on windows platforms, use {{ant woas:download-appbundler-for-mac woas:download-launch4j-for-mac woas:create-mac-app -Djspwiki.tomcat.version=$TOMCAT_VERSION}}
%%
As noted above, the generated {{woas.exe}} file and {{woas.app}} folder are copied to {{./jspwiki-portable/src/overlay/launchers/tomcat}}; after manual testing of these binaries is performed, they can be committed and pushed.