source: josm/trunk/windows/README.txt@ 13862

Last change on this file since 13862 was 7934, checked in by Don-vip, 10 years ago

update animal-sniffer-ant-tasks to version 1.13

File size: 2.7 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 (more to follow?)
29- default preferences to the current user profile (if not already existing)
30
31When the installed josm.exe is executed, it should ask the user to download
32Java runtime if it's not already installed.
33
34build the installer
35-------------------
361.) You will need to download and install the following on your machine:
37- cygwin bash and wget
38- launch4j - http://launch4j.sourceforge.net/ (currently 3.6, older 2.x will NOT work!)
39- NSIS - http://nsis.sourceforge.net/ (any recent version should do)
40
412.) Edit the two absolute paths in the file josm-setup-unix.sh (in the calls
42to launch4jc and makensis)
43
443.) Start a cygwin shell and call ./josm-setup-unix.sh
45
46how the installer is build
47--------------------------
48First, wget will download the required files (e.g. the josm plugins) into the
49downloads subdir. Then jaunch4j wraps the josm.jar into a josm.exe, which
50makes registration of file extensions a lot easier. Then NSIS is called to
51create the actual josm-setup-latest.exe.
52
53known issues
54------------
55- absolute paths in josm-setup-unix.sh
56- josm should support "global settings" instead of only the personal profile
57- install all josm plugins by default and only enable them according to user wishes?
58
59build the installer under Linux / Debian
60----------------------------------------
61It's possible to build the installer under Linux. Beside the things mentioned above,
62the NSIS Debian package currently has an incomplete System.dll (in the plugins directory).
63This dll needs to be replaced by the System.dll included in the NSIS zip package, e.g. from
64http://nsis.sourceforge.net/Development_Files.
65More details can be found in the following NSIS forum thread:
66http://forums.winamp.com/showthread.php?s=bb7fa5bf8173e31c05e083340ca2c242&postid=2211132
Note: See TracBrowser for help on using the repository browser.