RouteConverter 技术文档

1. 安装指南

1.1 安装 Java SDK

RouteConverter 需要 Java SDK 8 或更高版本。您可以从 Oracle 官方网站 下载并安装最新的 Java SDK。

1.2 设置环境变量

安装完成后，确保设置 JAVA_HOME 环境变量，并将其添加到 PATH 中。

set JAVA_HOME=c:\Program Files\Java\jdk1.8.0_271
set PATH=%JAVA_HOME%\bin;%PATH%

2. 项目使用说明

2.1 克隆项目

首先，从 GitHub 克隆 RouteConverter 项目：

git clone [e-mail]:cpesch/RouteConverter.git

2.2 打开项目

使用您喜欢的集成开发环境（IDE）打开项目：

• IntelliJ IDEA:

  • 安装 IntelliJ IDEA Community Edition。
  • 选择 "File/Open Project..." 并打开根目录下的 pom.xml。
  • 在 "Preferences/GUI Designer" 中选择 "Generate GUI to Java source code"，并禁用 "Automatically copy form runtime classes to the output directory"。

• Eclipse:

  • 安装 Eclipse IDE for Java Developers。
  • 安装 m2eclipse 插件。
  • 选择 "File/Import..." 并选择 "General/Maven Projects"，然后导入根目录。

• NetBeans:

  • 安装 NetBeans IDE Java SE。
  • 安装 Git 插件。
  • 选择 "Open Project..." 并打开根目录。

2.3 构建项目

使用 Maven 构建项目：

mvnw clean package

2.4 运行项目

构建完成后，您可以通过以下命令运行 RouteConverter：

java -jar RouteConverterCmdLine/target/RouteConverterCmdLine.jar
java -jar RouteConverterLinuxOpenSource/target/RouteConverterLinuxOpenSource.jar
java -jar RouteConverterMacOpenSource/target/RouteConverterMacOpenSource.jar
java -jar RouteConverterWindowsOpenSource/target/RouteConverterWindowsOpenSource.jar

3. 项目 API 使用文档

RouteConverter 提供了丰富的 API，用于显示、编辑、丰富和转换路线、轨迹和航点。以下是一些常用的 API 示例：

3.1 加载文件

RouteConverter.loadFile("path/to/your/file.gpx");

3.2 保存文件

RouteConverter.saveFile("path/to/your/file.gpx");

3.3 转换格式

RouteConverter.convertFormat("path/to/your/file.gpx", "new_format");

4. 项目安装方式

RouteConverter 可以通过以下几种方式安装：

4.1 从官方网站下载

您可以从 RouteConverter 官方网站 下载稳定版本。

4.2 使用 Maven 安装

如果您使用 Maven 进行项目管理，可以通过以下命令将 RouteConverter 添加到您的项目中：

<dependency>
    <groupId>io.github.cpesch.slash</groupId>
    <artifactId>RouteConverter</artifactId>
    <version>latest_version</version>
</dependency>

4.3 从 GitHub 克隆

如前所述，您可以直接从 GitHub 克隆项目并进行本地构建。

git clone [e-mail]:cpesch/RouteConverter.git

通过以上步骤，您可以顺利安装并使用 RouteConverter 项目。希望您在使用过程中获得愉快的体验！