Zh-hans:JOSM/Installation

From OpenStreetMap Wiki
Jump to navigation Jump to search

JOSM 安装非常简单。只需下载并运行 jar 文件,或使用 Web Start。然而,这并不总是有效。本页提供了有关系统要求的更多详细信息、链接以帮助你了解 JOSM 应用程序如何运行、如何最有效地进行设置,以及如何解决各种安装问题。

完成该步骤后,请参阅 JOSM 指南 了解 JOSM 的使用方法。

系统要求

为了在你的计算机上运行 JOSM,你需要:

  • Java 8(也支持 Java 版本 9-17,推荐使用 Java 17)。注意:
  • 512 MB 或更多内存
  • 分辨率为 1024×768 或更高的显示器(800×600 不会带来太多乐趣)
  • (推荐)启用了 2D 加速的图形适配器以获得更快的速度

下载

JOSM can be downloaded from the JOSM homepage.

"tested" 还是 "latest"?

选择 "tested"(经测试版) 还是 "latest"(最新版) 可能取决于你是否热衷于帮助测试最新功能。josm-tested 是应用程序的“稳定”版本,意味着它已在开发的稳定点建立了基线。josm-latest 是包含所有最新功能但也包含所有最新错误的版本。使用 josm-latest 对项目有帮助(你可以帮助报告错误并提出功能建议)。目前,由于插件版本的管理方式,它也可能更不易出问题。请注意,如果你自动安装/升级插件,josm-tested 将尝试加载最新版本的任何插件,而这些插件可能会抱怨需要更高版本的 JOSM!我们希望在某个时候改进新插件的发布流程。

安全下载

此处的下载链接应默认指向 JOSM 网站上受 SSL/HTTPS 保护的下载。通常,你无需进行任何其他努力。JOSM 网站目前使用由 “GlobalSign” CA 签名的证书。如果你不信任此 CA,可以将 外部来源 上的指纹进行比较。

许多 Linux 发行版提供 JOSM 软件包,请参见 JOSM/Linux。使用特定于 Linux 发行版的安装方法是通过 HTTPS 下载的替代方法,尽管安装的版本可能比直接从 JOSM 获得的版本更旧。其好处可能是通过你的发行版的包管理系统自动更新 JOSM。

启动 JOSM

jar 文件需要传递给 Java 运行时。

通常,你只需在图形界面操作系统中双击 josm.jar 文件即可。(Windows、macOS、某些 Linux 发行版)。如果无法运行,或者需要设置选项,请参阅 如何运行 Java 应用程序

JOSM 可能需要大量内存。Java 的默认最大值相当吝啬。设置选项 -Xmx1024m 以扩展可用内存。

建议使用启用 2D 图形加速器的选项(例如 -Dsun.java2d.opengl=true)。要在启用工作时 获取详细反馈,请使用 -Dsun.java2d.opengl=True(注意本例中的大写 T)。

各平台说明

JOSM 是一个 Java 应用程序。它可以在 Java 平台可以运行的任何地方运行,但在各种平台和操作系统上存在一些特性。有关具体说明,请参阅以下子页面:

从闪存盘运行 JOSM:

升级 JOSM

JOSM 将自动检查更新并在其启动屏幕中告知你有关更新的信息。要手动检查:你可以使用程序本身的“关于”菜单选项查看你拥有的 JOSM 版本。JOSM 网站 会显示“当前”版本是什么(当前最新版和当前经测试版)。

如果你决定要升级,大致步骤如下。这仅适用于 你不使用“Java Web Start”选项 的情况(它会通过 Web Start 自动更新)。

  • 再次 下载 JOSM jar 文件。
  • 找到你现有 jar 文件的位置。
  • 删除它或重命名旧的 jar 文件,并将新文件放在其位置。

但是,你用于安装 JOSM 的确切方法可能意味着很难找到 jar 文件,并且可能有替代(更好)的升级方法,例如使用包管理器或从安装程序重新安装。请按照上一节中的相关链接获取特定于平台的说明。

故障排除

JOSM 似乎启动正常,但窗口是空白的

如果你正在使用 Wayland/Sway

  • 设置 _JAVA_AWT_WM_NONREPARENTING=1 环境变量。

如果你启用了花哨的 compiz/beryl 图形特效,则可能会发生这种情况。解决方案很简单,将以下行添加到用户配置文件中:

export AWT_TOOLKIT="MToolkit"

或将其放入“运行应用程序”对话框中:

compiz --replace && export AWT_TOOLKIT=MToolkit

在 ratpoison 和 stumpwm 等平铺窗口管理器下使用 Java 6 VM 时也会发生这种情况(IcedTea/Java 7 没有问题)。似乎 JOSM 要求以某种方式调整其几何形状,当无法这样做时就会恐慌。

  • 截至 2009-02-28,在 StumpWM git 中使用 OpenJDK 1.6 不再需要此解决方法。

一种解决方法是在 Xnest 下启动 JOSM,或者在单独的 X 服务器中启动。使用 Xnest 启动:

Xnest :1 -ac -geometry 1280x1024
DISPLAY=:1 java -jar josm-latest.jar

你可能还需要一个窗口管理器,此示例使用 fluxbox:

Xnest :1 -ac -geometry 1280x1024
fluxbox -display :1
DISPLAY=:1 java -Xmx1024m -jar josm-custom.jar

类似地,在 Xephyr(Xnest 的替代品)下启动:

Xephyr :1 -ac -screen 1280x1024
DISPLAY=:1 java -Xmx1024m -jar josm-latest.jar

也可以导出上面的 AWT_TOOLKIT 变量,但这似乎对某些东西不起作用,例如下载对话框的大小为零。

使用另一个 X 服务器实例(一个专用于 JOSM 的 $DISPLAY):

X :1
fluxbox -display :1
DISPLAY=:1 java -Xmx1024m -jar josm-latest.jar

现在你可以使用 Ctrl+Alt+F7 和 Ctrl+Alt+F8 在显示之间切换。


针对许多 Java 和平铺窗口管理器相关问题的解决方法:

  • 如果你正在使用 openjdk6,请在 /etc/profile.d/openjdk6.sh 中添加 export _JAVA_AWT_WM_NONREPARENTING=1
  • 如果你正在使用 jre7-openjdk,请在 /etc/profile.d/jre.sh 中添加 export _JAVA_AWT_WM_NONREPARENTING=1

另见