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

Last change on this file since 3770 was 2786, checked in by ulf, 13 years ago

slight enhancements of the build process,
the josm mappaint plugin doesn't need an elemstyles.xml file now

File size: 2.5 KB
Line 
1This is the Win32 installer generator for OpenStreetMap, 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. Probably, other osm related applications like osmarender and mapnik
7will be added later.
8
9
10install
11-------
12simply execute openstreetmap-setup-x.x.x.exe
13
14uninstall
15---------
16use "control panel / software" to uninstall
17
18
19current state of the art
20------------------------
21The installer will currently add:
22- josm into "C:\Program Files\OpenStreetMap" (or the corresponding international dir)
23- josm icons to the desktop and quick launch bar
24- josm file associations to .osm and .gpx files
25- some plugins to the current user profile (more to follow)
26- default preferences to the current user profile (if not already existing)
27- default bookmarks to the current user profile (if not already existing)
28
29When the installed josm.exe is executed, it should ask the user to download
30JAVA 1.5 runtime if it's not already installed. However, I've not tested this.
31
32build the installer
33-------------------
341.) You will need to download and install the following on your machine:
35- cygwin bash and wget
36- launch4j - http://launch4j.sourceforge.net/
37- NSIS - http://nsis.sourceforge.net/
38
392.) Edit the three absolute paths in the file openstreetmap-setup.sh (in the calls
40to launch4jc and makensis)
41
423.) Start a cygwin shell and call ./openstreetmap-setup.sh
43
44how the installer is build
45--------------------------
46First, wget will download the required files (e.g. the josm plugins) into the
47downloads subdir. Then jaunch4j wraps the josm.jar into a josm.exe, which
48makes registration of file extensions a lot easier. Then NSIS is called to
49create the actual openstreetmap-setup-x.x.x.exe.
50
51known issues
52------------
53- absolute paths in openstreetmap-setup.sh
54- bookmarks are of ulfl's personal interest (should be replaced e.g. by some "well known" places)
55- version number fixed to 0.0.x (better use SVN version?)
56- localisation/internationalisation settings (currently only english supported)
57- josm should support "global settings" instead of only the personal profile
58- josm should use some defaults already instead of the installer ones
59- some way of automatic installer generation on the server (e.g. nightly build)?
60- install all josm plugins by default and only enable them according to user wishes?
61- make instalation of icons and file extensions optional?
Note: See TracBrowser for help on using the repository browser.