JOSM 开源项目安装与使用指南

JOSM 开源项目安装与使用指南

josm !!!Mirror!!! of JOSM Subversion repository 项目地址: https://gitcode.com/gh_mirrors/jo/josm

1. 目录结构及介绍

JOSM（Java OpenStreetMap Editor）的代码仓库遵循清晰的组织结构，以便开发者能够快速定位到他们感兴趣的组件。以下是其主要的目录结构及简介：

• build.xml: Ant构建文件，用于创建JOSM的可执行版本。

• CONTRIBUTION: 列出了主要的代码贡献者名单。

• gpl-2.0.txt, gpl-3.0.txt: 包含GNU通用公共许可证的全文，指明了软件的许可条款。

• LICENSE: JOSM的特定许可协议细节。

• native/: 包含操作系统特异性文件，如针对不同平台的特定需求。

• linux/

  • 存放对Linux发行版有用的文件，包括AppData文件、桌面快捷方式、Debian/Ubuntu脚本等。

• macosx/

  • 涉及创建MacOS安装包所需的文件。

• windows/

  • 包含Windows安装程序相关的文件。

• josm.jnlp, josm-latest.jnlp: 分别是测试版和最新版的Java Web Start启动文件。

• nodist/: 包含不被包含在JOSM二进制分发中的文件。

• data/, images/, styles/: 分别存放数据文件、图片资源和地图样式相关文件。

• resources/: 将被包含在JOSM JAR文件中的资源文件。

• src/: 应用的核心源代码。

• test/: 自动化测试套件，包括单元测试和功能测试的相关代码和资源。

• scripts/: 开发者使用的各种脚本工具，比如图标管理、性能测试等。

2. 项目启动文件介绍

JOSM的主要启动依赖于JAR文件，尤其是josm-tested.jar或josm-latest.jar。启动方法因操作系统的不同而异：

• Windows: 可通过双击JAR文件来启动；若不行，则需在命令行输入java -jar josm-latest.jar。
• Linux: 打开终端，进入JAR文件所在的目录，运行java -jar josm-latest.jar。如果遇到问题，可能需要设置JAVA_HOME环境变量。
• macOS: 直接点击JAR文件图标即可启动。

3. 项目配置文件介绍

JOSM的配置主要涉及几个方面，但核心配置并不以单一文件的形式存在于上述列出的目录中。大多数配置是在应用运行时动态加载的，例如：

• 用户个人偏好保存在用户的主目录下的.josm文件夹内，如preferences.xml。
• 插件配置通常嵌入各自的XML文件中。
• 地图样式和显示设置也属于配置的一部分，分布在styles/目录下的一些文件里。
• 对于开发人员，build.xml是构建过程的重要配置文件。

值得注意的是，虽然JOSM提供了丰富的可自定义选项，但并非所有配置都集中在一个单独的文件里。很多高级配置和个性化调整发生在应用程序内部或通过插件进行管理。对于开发者而言，了解Ant构建文件也是调整编译过程和项目设置的关键点。

---

此指南旨在提供一个概览，实际使用JOSM时，建议参考项目wiki和官方文档，获取最全面的信息更新和支持。

josm !!!Mirror!!! of JOSM Subversion repository 项目地址: https://gitcode.com/gh_mirrors/jo/josm