install

基于Java的地图数据管理软件。使用MySQL数据库管理系统。

             --- Installation Instructions: Garmin GPS Tool ---

Note: These are early release instructions for downloading and installing the 
Garmin GPS Tool. If you find any errors in this document, or have any 
suggestions, please e-mail them to [e-mail].

1.0: Installing Prerequisite Libraries

GarminGPSTool depends on the functionality of several Java libraries in order to
function. Please download and install the following packages:

	- Java2 SDK: http://java.sun.com

	- Xerces2: http://xml.apache.org/xerces2-j/index.html

	- JavaComm: http://java.sun.com/products/javacomm/index.html

	- Batik: http://xml.apache.org/batik/index.html

If you receive errors about classes not found, please be sure that 
batik-svg-dom.jar and batik-ext.jar are located in your CLASSPATH.


2.0: Obtaining a Distribution

Two distributions of this product are made available. The binary distribution is
a JAR file containing all the compiled classes and resource files. The source
distribution is made available as a .tar.gz file. Both can be found at

	http://garmingpstool.sourceforge.net/download/

Please skip to section 4.0 if you have obtained the binary distribution.


3.0: Compiling the Source Distribution

Before compiling the source distribution, please install the Ant build tool. 
This can be downloaded at

	http://jakarta.apache.org/ant/index.html

After installing Ant, please unpack the source files. If you are using a Unix-
variant, use the command 'tar -xzvf garmingpstool-src.tar.gz'. Under Windows and
other systems, use a utility such as WinZip or CygWin. 

You should now have a source directory called 'garmingpstool-src'. Go in this 
directory and build the distribution using the 'ant' command. After Ant 
completes building the files, there should be a file titled 
'net.aetherial.gis.garmin.jar'. This is the binary version.

(Should you encounter failure during any of these steps, chances are that it is
a result of an error in the packaging. Please e-mail [e-mail]
with the error so that this can be corrected in future releases.)


4.0: Running the Console Application

In order to execute the console application, run the following command


	Unix: java -classpath "$CLASSPATH;net.aetherial.gis.garmin.jar" \
		net.aetherial.gis.garmin.Console
	
	Windows (not CygWin): java -classpath \
		"$CLASSPATH;net.aetherial.gis.garmin.jar" \
		net.aetherial.gis.garmin.Console

A Java Swing application should appear shortly. For instructions about how to
use the application, please visit the online User's Guide at

	http://garmingpstool.sourceforge.net/doc/users-guide/


5.0: Bugs, Problems, and Errors

Should you find any problems with either distribution, you can contact me at
[e-mail] for help. No guarantee is made that I can solve the 
problem, but I would enjoy assisting users as the bugs are worked out of the
product.

In particular, this system has been developed using a Garmin eMap unit. If you
have a different unit and are experiencing problems, the unit is probably not
supported. Please e-mail me with the unit model and I will add support for that
model in future releases.