source: subversion/applications/editors/josm/nsis/README.txt @ 11485

Last change on this file since 11485 was 10374, checked in by ulf, 11 years ago

updates

File size: 3.2 KB
Line 
1This is the Win32 installer generator for JOSM, to create a Windows
2like installer. This should ease installation and provides a reasonable set of
3default preferences for Windows users.
4
5Currently only josm and a small assortment of josm plugins is included in the
6installer.
7
8As other osm related applications like osmarender and mapnik have a lot more
9UNIX related dependencies that will make them complicated to install, only JOSM
10is currently installed "the easy way".
11
12
13install
14-------
15simply execute josm-setup-latest.exe
16
17uninstall
18---------
19use "control panel / software" to uninstall
20
21
22current state of the art
23------------------------
24The 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
32When the installed josm.exe is executed, it should ask the user to download
33JAVA 1.5 runtime if it's not already installed. However, I've not tested this.
34
35build the installer
36-------------------
371.) 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.1, older 2.x will NOT work!)
40- NSIS - http://nsis.sourceforge.net/ (any recent version should do)
41
422.) Edit the two absolute paths in the file josm-setup.sh (in the calls
43to launch4jc and makensis)
44
453.) Start a cygwin shell and call ./josm-setup.sh
46
47how the installer is build
48--------------------------
49First, wget will download the required files (e.g. the josm plugins) into the
50downloads subdir. Then jaunch4j wraps the josm.jar into a josm.exe, which
51makes registration of file extensions a lot easier. Then NSIS is called to
52create the actual josm-setup-latest.exe.
53
54known 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
65build the installer under Linux / Debian
66----------------------------------------
67It's possible to build the installer under Linux. Beside the things mentioned above,
68the NSIS Debian package currently has an incomplete System.dll (in the plugins directory).
69This dll needs to be replaced by the System.dll included in the NSIS zip package, e.g. from
70http://nsis.sourceforge.net/Development_Files.
71More details can be found in the following NSIS forum thread:
72http://forums.winamp.com/showthread.php?s=bb7fa5bf8173e31c05e083340ca2c242&postid=2211132
Note: See TracBrowser for help on using the repository browser.