| 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 into "C:\Program Files\JOSM\plugins" (more to follow?)
|
|---|
| 29 | - default preferences to the current user profile (if not already existing)
|
|---|
| 30 | - default bookmarks to the current user profile (if not already existing)
|
|---|
| 31 |
|
|---|
| 32 | When the installed josm.exe is executed, it should ask the user to download
|
|---|
| 33 | JAVA 1.5 runtime if it's not already installed. However, I've not tested this.
|
|---|
| 34 |
|
|---|
| 35 | build the installer
|
|---|
| 36 | -------------------
|
|---|
| 37 | 1.) You will need to download and install the following on your machine:
|
|---|
| 38 | - cygwin bash and wget
|
|---|
| 39 | - launch4j - http://launch4j.sourceforge.net/ (currently 3.0.0-pre2, older 2.x will NOT work!)
|
|---|
| 40 | - NSIS - http://nsis.sourceforge.net/ (any recent version should do)
|
|---|
| 41 |
|
|---|
| 42 | 2.) Edit the two absolute paths in the file josm-setup.sh (in the calls
|
|---|
| 43 | to launch4jc and makensis)
|
|---|
| 44 |
|
|---|
| 45 | 3.) Start a cygwin shell and call ./josm-setup.sh
|
|---|
| 46 |
|
|---|
| 47 | how the installer is build
|
|---|
| 48 | --------------------------
|
|---|
| 49 | First, wget will download the required files (e.g. the josm plugins) into the
|
|---|
| 50 | downloads subdir. Then jaunch4j wraps the josm.jar into a josm.exe, which
|
|---|
| 51 | makes registration of file extensions a lot easier. Then NSIS is called to
|
|---|
| 52 | create the actual josm-setup-latest.exe.
|
|---|
| 53 |
|
|---|
| 54 | known issues
|
|---|
| 55 | ------------
|
|---|
| 56 | - absolute paths in josm-setup.sh
|
|---|
| 57 | - bookmarks are of ulfl's personal interest (should be replaced e.g. by some "well known" places)
|
|---|
| 58 | - version number fixed to latest (JOSM and Plugins have different SVN versions, some plugins not even in SVN)
|
|---|
| 59 | - localisation/internationalisation settings (currently only english supported)
|
|---|
| 60 | - josm should support "global settings" instead of only the personal profile
|
|---|
| 61 | - josm should use some defaults already instead of the installer ones
|
|---|
| 62 | - some way of automatic installer generation on the server (e.g. nightly build)?
|
|---|
| 63 | - install all josm plugins by default and only enable them according to user wishes?
|
|---|
| 64 |
|
|---|
| 65 | build the installer under Linux / Debian
|
|---|
| 66 | ----------------------------------------
|
|---|
| 67 | It's possible to build the installer under Linux. Beside the things mentioned above,
|
|---|
| 68 | the NSIS Debian package currently has an incomplete System.dll (in the plugins directory).
|
|---|
| 69 | This dll needs to be replaced by the System.dll included in the NSIS zip package, e.g. from
|
|---|
| 70 | http://nsis.sourceforge.net/Development_Files.
|
|---|
| 71 | More details can be found in the following NSIS forum thread:
|
|---|
| 72 | http://forums.winamp.com/showthread.php?s=bb7fa5bf8173e31c05e083340ca2c242&postid=2211132
|
|---|
