| 1 | This is the Win32 installer generator for JOSM, to create a Windows |
|---|
| 2 | like installer. This should ease installation and provides a reasonable set of |
|---|
| 3 | default preferences for Windows users. |
|---|
| 4 | |
|---|
| 5 | Currently only josm and a small assortment of josm plugins is included in the |
|---|
| 6 | installer. |
|---|
| 7 | |
|---|
| 8 | As other osm related applications like osmarender and mapnik have a lot more |
|---|
| 9 | UNIX related dependencies that will make them complicated to install, only JOSM |
|---|
| 10 | is currently installed "the easy way". |
|---|
| 11 | |
|---|
| 12 | |
|---|
| 13 | install |
|---|
| 14 | ------- |
|---|
| 15 | simply execute josm-setup-latest.exe |
|---|
| 16 | |
|---|
| 17 | uninstall |
|---|
| 18 | --------- |
|---|
| 19 | use "control panel / software" to uninstall |
|---|
| 20 | |
|---|
| 21 | |
|---|
| 22 | current state of the art |
|---|
| 23 | ------------------------ |
|---|
| 24 | The installer will currently add: |
|---|
| 25 | - josm into "C:\Program Files\JOSM" (or the corresponding international dir) |
|---|
| 26 | - josm icons to the desktop and quick launch bar |
|---|
| 27 | - josm file associations to .osm and .gpx files |
|---|
| 28 | - some assorted plugins (more to follow?) |
|---|
| 29 | - default preferences to the current user profile (if not already existing) |
|---|
| 30 | |
|---|
| 31 | When the installed josm.exe is executed, it should ask the user to download |
|---|
| 32 | Java runtime if it's not already installed. |
|---|
| 33 | |
|---|
| 34 | build the installer |
|---|
| 35 | ------------------- |
|---|
| 36 | 1.) You will need to download and install the following on your machine: |
|---|
| 37 | - cygwin bash and wget |
|---|
| 38 | - launch4j - http://launch4j.sourceforge.net/ (currently 3.5, older 2.x will NOT work!) |
|---|
| 39 | - NSIS - http://nsis.sourceforge.net/ (any recent version should do) |
|---|
| 40 | |
|---|
| 41 | 2.) Edit the two absolute paths in the file josm-setup-unix.sh (in the calls |
|---|
| 42 | to launch4jc and makensis) |
|---|
| 43 | |
|---|
| 44 | 3.) Start a cygwin shell and call ./josm-setup-unix.sh |
|---|
| 45 | |
|---|
| 46 | how the installer is build |
|---|
| 47 | -------------------------- |
|---|
| 48 | First, wget will download the required files (e.g. the josm plugins) into the |
|---|
| 49 | downloads subdir. Then jaunch4j wraps the josm.jar into a josm.exe, which |
|---|
| 50 | makes registration of file extensions a lot easier. Then NSIS is called to |
|---|
| 51 | create the actual josm-setup-latest.exe. |
|---|
| 52 | |
|---|
| 53 | known issues |
|---|
| 54 | ------------ |
|---|
| 55 | - absolute paths in josm-setup-unix.sh |
|---|
| 56 | - josm should support "global settings" instead of only the personal profile |
|---|
| 57 | - install all josm plugins by default and only enable them according to user wishes? |
|---|
| 58 | |
|---|
| 59 | build the installer under Linux / Debian |
|---|
| 60 | ---------------------------------------- |
|---|
| 61 | It's possible to build the installer under Linux. Beside the things mentioned above, |
|---|
| 62 | the NSIS Debian package currently has an incomplete System.dll (in the plugins directory). |
|---|
| 63 | This dll needs to be replaced by the System.dll included in the NSIS zip package, e.g. from |
|---|
| 64 | http://nsis.sourceforge.net/Development_Files. |
|---|
| 65 | More details can be found in the following NSIS forum thread: |
|---|
| 66 | http://forums.winamp.com/showthread.php?s=bb7fa5bf8173e31c05e083340ca2c242&postid=2211132 |
|---|
