| 1 | This is the Win32 installer generator for OpenStreetMap, 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. Probably, other osm related applications like osmarender and mapnik
|
|---|
| 7 | will be added later.
|
|---|
| 8 |
|
|---|
| 9 |
|
|---|
| 10 | install
|
|---|
| 11 | -------
|
|---|
| 12 | simply execute openstreetmap-setup-x.x.x.exe
|
|---|
| 13 |
|
|---|
| 14 | uninstall
|
|---|
| 15 | ---------
|
|---|
| 16 | use "control panel / software" to uninstall
|
|---|
| 17 |
|
|---|
| 18 |
|
|---|
| 19 | current state of the art
|
|---|
| 20 | ------------------------
|
|---|
| 21 | The 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 |
|
|---|
| 29 | When the installed josm.exe is executed, it should ask the user to download
|
|---|
| 30 | JAVA 1.5 runtime if it's not already installed. However, I've not tested this.
|
|---|
| 31 |
|
|---|
| 32 | build the installer
|
|---|
| 33 | -------------------
|
|---|
| 34 | 1.) 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 |
|
|---|
| 39 | 2.) Edit the three absolute paths in the file openstreetmap-setup.sh (in the calls
|
|---|
| 40 | to launch4jc and makensis)
|
|---|
| 41 |
|
|---|
| 42 | 3.) Start a cygwin shell and call ./openstreetmap-setup.sh
|
|---|
| 43 |
|
|---|
| 44 | how the installer is build
|
|---|
| 45 | --------------------------
|
|---|
| 46 | First, wget will download the required files (e.g. the josm plugins) into the
|
|---|
| 47 | downloads subdir. Then jaunch4j wraps the josm.jar into a josm.exe, which
|
|---|
| 48 | makes registration of file extensions a lot easier. Then NSIS is called to
|
|---|
| 49 | create the actual openstreetmap-setup-x.x.x.exe.
|
|---|
| 50 |
|
|---|
| 51 | known 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?
|
|---|
