source: osm/applications/editors/josm/nsis/README.txt@ 14517

Last change on this file since 14517 was 14190, checked in by ulf, 16 years ago

remove some TODO stuff as it's done

File size: 2.9 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- josm should support "global settings" instead of only the personal profile
58- some way of automatic installer generation on the server (e.g. nightly build)?
59- install all josm plugins by default and only enable them according to user wishes?
60
61build the installer under Linux / Debian
62----------------------------------------
63It's possible to build the installer under Linux. Beside the things mentioned above,
64the NSIS Debian package currently has an incomplete System.dll (in the plugins directory).
65This dll needs to be replaced by the System.dll included in the NSIS zip package, e.g. from
66http://nsis.sourceforge.net/Development_Files.
67More details can be found in the following NSIS forum thread:
68http://forums.winamp.com/showthread.php?s=bb7fa5bf8173e31c05e083340ca2c242&postid=2211132
Note: See TracBrowser for help on using the repository browser.