Context Navigation

Editing Ja:Download

Adjust edit area height: Edit side-by-side

[[TranslatedPages(revision=225,outdated=incomplete translation)]]
[[PageOutline(2-3,目次)]]

= ダウンロード =

このページでは、JOSMの基本的なインストール手順とトラブルシューティング情報を提供しています。
JOSMの作業を開始するには、[wikitr:/Introduction JOSMことはじめ]と[wikitr:/Help メインヘルプ]ページを参照してください。
非常に複雑な問題については、[wikitr:/InstallNotes Installation Notes]を参照してください。

== 推奨オプション ==#Recommendedoptions

[[JOSMImage(openlocation, valign=middle, link=[/download/josm.jnlp])]] **[/download/josm.jnlp josm.jnlp]を起動する**（最新のテスト済みバージョン）\\
推奨バージョン、すべてのプラットフォーム、最新の''テスト済みバージョン''への自動アップデート ([#Webstart how to start])。\\ \\

[[JOSMImage(download, valign=middle, link=[/josm-tested.jar])]] **[/josm-tested.jar josm-tested.jar]をダウンロードする**（テスト済みバージョン [[Version(tested)]]）\\
すべてのプラットフォーム ([#Java how to run])。\\ \\

== すべてのダウンロードオプション ==#Moredownloadoptions
JOSMのチームは[/roadmap 毎月]、**テスト版**を[wikitr:/Releases リリース]します。
このテスト版では、MS WindowsおよびApple macOSの亜種が作成されています。
josm.jnlpをクリックしてJOSMを起動すると、常に最新のテスト済みのバージョンが取得されます。Java [wikitr:/InstallNotes#Webstart Web Start]メカニズムを使用しています。

[=#DevelopmentVersion]
[/log/josm/?verbose=on&limit=20 毎晩]ビルドシステムが**最新バージョン**を生成します。
これらのバージョンは重大なエラーが発生することがあります。しかし、ほとんどの場合はうまくいきます。
最新版では、Web Start版も利用できます。

||= =||||= **すべてのオペレーティングシステム用** =|||||||| ||= **Development** =||
||=**バージョン** =||=  **Web Start**  =||= **Download** =||= **Windows** =||= **Apple macOS** =||= **Ubuntu, Debian…**  =||= **openSUSE** =||= **Jar / Javadoc / Source** =||
||**テスト済み版 [[Version(tested)]]** ||  \
||  [/download/josm.jnlp josm.jnlp]  ||  \
||  [/josm-tested.jar]  ||  \
||  \\ [/download/windows/josm-setup.exe josm-setup.exe] \\ [/download/windows/josm-setup.msi josm-setup.msi] \\ [https://apps.microsoft.com/store/detail/josm/XPFCG1GV0WWGZX Microsoft Store]\\ ''([#Mswindowswrapper 下記参照])''  ||  \
||  \\ [/download/macosx/josm-macosx.zip package.zip] \\ ''または([#macOS homebrew])''  ||  \
||  ''[#Ubuntu 下記参照]''  ||  \
||  ''[#Opensuse 下記参照]''  ||  \
||  [/nexus/content/groups/public/org/openstreetmap/josm/josm/ josm]:[[Version(tested)]]  ||
||**開発版 [[Version(latest)]]** ||  \
||  [/download/josm-latest.jnlp latest.jnlp]  ||  \
||  [/josm-latest.jar]  ||  \
||  ''see [https://github.com/openstreetmap/josm/releases releases on github]  ||  \
||  ''see [https://github.com/openstreetmap/josm/releases releases on github]  ||  \
||  ''[#Ubuntu 下記参照]''  || ||  \
||  [/nexus/content/groups/public/org/openstreetmap/josm/josm/SNAPSHOT/ スナップショットを使用する] ||
||=''**過去バージョン**'' =|| ||  \
||  [/download/ download/]  ||  \
||  ''see [https://github.com/openstreetmap/josm/releases releases on github]  ||  \
||  ''see [https://github.com/openstreetmap/josm/releases releases on github]  ||  \
||  [/apt/pool/universe/j/ pool/]  || ||  \
||  [/nexus/content/groups/public/org/openstreetmap/josm/josm/ テスト済み版]  ||

スクリプトを実行する際には、[/latest 最新]、[/tested テスト済み]、または[/version すべて]をチェックして、ダウンロード帯域幅を減らしてください。

** Strip translations **[=#Striptranslations]  \\
ダウンロードサイズが問題である場合、テストされたバージョンのより小さいファイルが利用可能です。日本語のみを含むダウンロードの場合、[/josm-tested.jar?lang=ja ?lang=ja]をURLに追加します。翻訳を1つのみ含めるには、`ja`をあなたが望む[wikitr:/TracLanguages 言語コード]に置き換えます（最初の文字は小文字、サポートされている言語のみ）。また、[/josm-tested.jar?lang=ja&unsigned=1 ?unsigned=1]を追加して署名情報を取り除くことで、ファイルサイズをさらに減らすことができます。

== Linuxリポジトリ ==
=== Debianベースで主にUbuntu用のJOSM ===#Ubuntu
このパッケージリポジトリはUbuntu用です。他のDebianベースの（特にUbuntuベースの）ディストリビューションでも動作するはずですが、Ubuntu以外のディストリビューションではあまりテストやメンテナンスをしていません。

Ubuntuリポジトリには二つのパッケージが含まれています:
* ''josm'' - テスト済み版を提供します（安定版）。お使いのディストリビューションの公式リポジトリのパッケージを置き換えます。デフォルトの設定フォルダは `JOSM` になります。
* ''josm-latest'' - 最新版(nightly)。josmパッケージと並行してインストールできるので、デフォルトの設定フォルダは `JOSM-latest` になります。
Both packages provide `/etc/default/josm` respectively `/etc/default/josm-latest` as config file for [wikitr:Help/CommandLineOptions#Javaoptions java options].

以下で説明する通常の手順に加えて、古いDEBは[/apt/pool/universe/j/ アーカイブ]から手動でダウンロードできます。

==== インストール ====
パッケージリソースリスト `/etc/apt/sources.list.d/josm.list` を編集してください:

{{{#!sh
sudo editor /etc/apt/sources.list.d/josm.list
}}}
{{{#!comment
### below does not work on GNU Debian systems
`sudo $EDITOR /etc/apt/sources.list.d/josm.list`
}}}

利用中のUbuntuのバージョンに応じた行を追加してください:
 
{{{ #!sh
deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt plucky universe
deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt oracular universe
deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt noble universe
deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt jammy universe
deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt focal universe
deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt bionic universe

# その他のDebianベースのディストリビューションでは以下を追加:
deb [signed-by=/etc/apt/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt alldist universe
}}}

これに代えて、次の一行で行うこともできます（Linux MintのようなUbuntuベースのディストリビューションでは使えません）:
{{{#!sh
echo "deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt $(lsb_release -sc) universe" | sudo tee /etc/apt/sources.list.d/josm.list > /dev/null
}}}
またはLinux Mint用:
{{{#!sh
echo "deb [signed-by=/etc/apt/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt $(grep ^DISTRIB_CODENAME= /etc/upstream-release/lsb-release| awk -F = '{print $(2)}') universe" | sudo tee /etc/apt/sources.list.d/josm.list > /dev/null
}}}

{{{#!comment 
### below did not work on all systems 
以下の行を追加してください:
{{{#!sh
`deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt VERSION universe`
}}}
}}}

[/josm-apt.key 公開鍵]をダウンロードしてください:
{{{#!sh
sudo curl https://josm.openstreetmap.de/josm-apt.key -o /etc/apt/keyrings/josm-apt.gpg
}}}
以前の説明では `apt-key` を使っていました. 鍵がシステムのキーリングに追加されていた場合は、次の一行で削除してください:
{{{#!sh
sudo apt-key del $(apt-key list | grep -B1  "<josm-dev@openstreetmap.org>" | sed '$d' | cut -b 48-51,53-57)
}}}

ソースを更新します:
{{{#!sh
# You may need to install ssl support for apt in advance:
sudo apt-get install apt-transport-https
# Refresh sources
sudo apt-get update
}}}

インストールします:
{{{#!sh
# これらのパッケージが以前にインストールされていない場合は、この最初の行をスキップできます。
sudo apt-get remove josm josm-plugins

# テスト済み版の場合
sudo apt-get install josm
# 開発版の場合
sudo apt-get install josm-latest
}}}

=== GNU Debian ===#GNUDebian
私たちが開発した[#Ubuntu 上記の]Ubuntuのパッケージは、Debianでも動作しますので、これを推奨します。`sudo` の設定によりますが、いくつかの命令は「通常の」ユーザーでは動作せず、`root` としてのみ動作します。

[https://packages.debian.org/stable/josm JOSM]のテスト済み版は、セクション **''utils''** の **''main''** の下にありますが、大抵そのバージョンはとても古くなっています。 \\
[https://backports.debian.org backports リポジトリ]を使用して最新版を取得してください。また[https://backports.debian.org/Instructions 手順]を参考にしてください。このバージョンも私たちのパッケージよりも古いかもしれません。

Debian 11 (bullseye) 以降使用できる、 [https://packages.debian.org/stable/josm-installer josm-installer] は、セクション **''utils''** の **''main''** の下にあります。これはこのサイトから現在の .jar ファイルをダウンロードし、必要に応じて更新します。

=== openSUSE  ===#Opensuse
JOSMのテスト版は、Application:Geoリポジトリにあります。 [=#openSUSE]

最初にrootユーザーとしてyastに追加するか、リポジトリをzypperで追加します（Tumbleweed の場合は **$releasever** を **openSUSE_Tumbleweed** に置き換えてください）:
{{{#!sh
zypper ar -f 'https://download.opensuse.org/repositories/Application:/Geo/$releasever' Application:Geo
}}}

その後、''josm''と''josm-fonts''パッケージをインストールしてください。

== トラブルシューティング ==
=== Java ===#Java
[=#Doubleclickonafiledoesnothing jarファイルをダブルクリックしても何も起こらない]とき、ほとんどの場合、これはJavaがインストールされていないことを意味します。

JOSMでは現在、 [https://www.azul.com/downloads/?version=java-21-lts&package=jdk-fx#zulu Azul] または [https://bell-sw.com/pages/downloads/?package=jre-full#mn Bellsoft Liberica] のJDKを推奨しています。一般的には、現在のJava LTS (執筆時点ではJava 17)が望ましいとされていますが、Java 11でも動作します。現在の推奨環境は[source:/trunk/README README]を参照してください。しかし、まずオペレーティングシステムと共に配布されているJava（[https://ja.wikipedia.org/wiki/OpenJDK 例]）を試してみてください。

ダウンロードを選択する際は、次の点に注意してください。
 * Webブラウザ用のJava Plug-inは、JOSMを実行するために**必要ありません**。したがって、www.java.com/ja/download/installed8.jspのようなページからの結果は関係ありません。
 * JOSMには64ビットのJavaバリアントが推奨されます。オペレーティング・システムのアーキテクチャーは、32ビット版か64ビット版Javaかを決める上で重要です。JOSMは**Webブラウザのアーキテクチャの影響を受けない**ため、このページのほとんどの推奨事項はwww.java.com/ja/download/faq/java_win64bit.xmlとは関係ありません。
 * WebブラウザにJava Plug-inを配置するためのwww.java.com/ja/downloadのようなページは避けてください。これはJOSMにとって重要では**ありません**。

詳細については、[[wikitr:/InstallNotes インストールノート]および[https://www.java.com/en/download/help/troubleshoot_java.xml トラブルシューティング]のページを参照してください。
ここでいう「Java」とは、JDK (Java Development Kit)を使用して開発され、時にJNLP (Java Network Launch Protocol、別名Web StartでJavaプラグインの後継) で起動されるJavaプログラムであるJOSMを実行するためのJVM (Java Virtual Machine)を提供する、JRE (Java Runtime Engine)を意味します。

==== Javaのテスト ====#JavaTest
[=#Troubleshootingjarfile] Javaがインストールされているかどうか、JOSMが起動しない理由を確認します（主にMS Windowsの場合など）。
1. [/josm-tested.jar josm-tested.jar]をデスクトップにダウンロードします。
1. ターミナルもしくはコマンドプロンプトを開きます。
1. `cd %homepath%`と入力した後`cd Desktop`と入力します。
1. `java -version`と入力します。バージョンのデータを含む3行が表示されます。他に何か表示される場合は、Javaが正しくインストールされていません。
1. `java -jar josm-tested.jar`と入力します。JOSMは[wikitr:/Help/CommandLineOptions コマンドライン]から起動する必要があります。
1. JOSMを終了します。
1. `josm-tested.jar`と入力します。JOSMが再び起動すると、Windowsエクスプローラはjarファイルをダブルクリックして起動する準備が整います。

=== Web Start ===#Webstart
[=#Troubleshootingjhlplink]
まず、[https://openwebstart.com/ OpenWebStart]をインストールする必要があります。これだけでJavaをダウンロードし、実行することができます。Microsoft Windows の場合、64ビット版 (`x64`) の OpenWebStart を使用してください。Oracle WebStartからOpenWebStartへの移行はまだ進行中ですので、問題が発生した場合は[/newticket 新規チケット]を作成するか、#17858にコメントを投稿してください。

Oracle WebStart を使用していた場合、JNLP ファイルを開くための既定のアプリケーションを更新する必要があるかもしれません。OpenWebStartをjnlp ファイルのデフォルトプログラムとして設定する手順は、[https://openwebstart.com/docs/OWSGuide.html#_jnlp_file_association jnlpファイルの関連付け]を参照してください。

==== Web Startのテスト ====#Webstarttest
1. [/download/josm.jnlp josm.jnlp]をデスクトップにダウンロードします。
1. ターミナルを開き、上記のようにデスクトップに移動します。
1. `javaws josm.jnlp`と入力します。これは最初にJOSMをダウンロードし、セキュリティダイアログを表示してからJOSMを起動します。
1. それでも失敗する場合は、 `javaws -verbose josm.jnlp`と入力してください。これにより、まずJVMに関する情報を含むダイアログが表示され、次にJOSMが起動します。

=== 仮想マシン ===#Troubleshootingjvm
==== メモリ不足 ====
今日では、コンピュータで利用可能なRAMが増えたため、Javaのメモリを手動で制御する必要はほとんどありません。
間違った値を選択すると、JOSMのパフォーマンスが低下する可能性があります。

いくつかのタスクでは、JOSMはメモリを大量に消費します。一方では、より多くのプラグインや機能をサポートするメモリサイズを設定する必要があるかもしれません。他方では、Javaのメモリ使用量を制限することで、遅いマシンを安定させることができます。
必要に応じて、 [wikitr:/Help/CommandLineOptions コマンドライン] で [https://docs.oracle.com/en/java/javase/11/tools/java.html#GUID-3B1CE181-CD30-4178-9602-230B800D4FAE__BABHDABI Javaオプション] -Xmx…m を設定します。（例: `-Xmx512m` または `-Xmx1536m` ）In Debian/Ubuntu you can edit the file `/etc/default/josm` respectively `/etc/default/josm-latest`. \\
以前の古いjavaプログラムは `-Xmx=512m` または `-Xmx 512m` を受け入れました。現在ではこれらの不正な引数はエラーメッセージをスローします。

==== 仮想マシン選択 ====#VMselectiononWindowsx64
現在のMicrosoft Windowsでは、既定でJavaは主に`C:\Program Files\Java`ディレクトリにインストールされます。追加で、`C:\Program Files\Oracle\Java\`にも配置されます。ここにはPATH環境変数のターゲットとして、`.\javapath\`ディレクトリが存在します。これは、3つの仮想ファイル`java.exe`、`javaw.exe`、`javaws.exe`のホームディレクトリです。これらのファイルは、現在のJavaインストールからのシンボリックリンクです。

64ビットWindowsの古いバージョンでは、32ビットモードのJREが追加でインストールされていることがあります。また、いくつかのブラウザは、制限された機能を持つ独自のJava仮想マシンを持ってきました。そのような場合、ブラウザからのWeb Startは、パソコンにインストールされたJavaではなく、ブラウザにインストールされたJavaを使用します。

`\Windows\SysWow64`に他のjavawebstartが入っていないことを確認します。Javaコントロールパネルでは検出されないので、安全に削除できます。クリーンアップを行い、各JREの最新版のみを残しておきましょう（32ビットモードでは1つ、64ビットモードではもう1つ）。

JNLP用にデスクトップ上に作成され、Javawebstartランチャーを実行しているショートカットについては、VMオプションの前に中間スペースを入れずに、先頭に-JをつけたVMパラメータを渡すようにしてください。32ビット版と64ビット版の両方をインストールしている場合、64ビット版のVMを選択したい場合は、"`-d64`"オプションを渡す必要があります。一部のオラクルのドキュメントページでは、オプション"-D64"の大文字表記は間違っていることに注意してください。\r+
 
Windowsデスクトップ上のショートカットを編集したコマンドラインの例:
{{{
#!sh
javaws.exe -J-d64 -J-Xmx2048m  josm.jnlp
}}}

=== Microsoft Windows ===#MSWindows
==== josm.exe ====#Mswindowswrapper
Microsoft Windowsへのインストールにjosm-setup.exeを使用すると、次のことが実行されます。
 * `JOSM.exe` と `HWConsole.exe` の2つの実行ファイルをディレクトリ `%LOCALAPPDATA%\JOSM` に置きます。
 * ファイル拡張子 `*.osm` 、 `*.geojson` 、 `*.gpx` 、 `*.jos` 、 `*.joz` のターゲットとしてjosm.exeを登録します。
 * JOSMのショートカットをデスクトップとスタートメニューに配置します。
 * 適切な場所にアンインストールデータを追加します。

josm.exeが起動すると、Azul ZuluをベースにJOSM開発者がメンテナンスするJavaを組み込んだ状態でJOSMを起動します。
josm.exeは''ラッパー''として動作し、[wikitr:/USB_Stick ポータブル]です。

HWConsole.exeはJOSM.exeと似ていますが、JOSMの標準出力（ログ）を表示するWindowsコンソールを開いたまま、JOSMを起動することができます。

josm.exeは通常の[wikitr:/Help/CommandLineOptions#Programarguments JOSMプログラム引数]をすべて受け付けます。例:

{{{
#!sh
# OSMデータをロードする
josm.exe https://www.osm.org/way/476702262
}}}

Java VMに[wikitr:/Help/CommandLineOptions#Javaoptions Javaオプション]を与えるために、josm.exeはそのディレクトリにある設定ファイル`JOSM.cfg`を使用します。このファイルでは、各オプションは個別の行を必要とします。

For example, to change memory allocation, open `%LOCALAPPDATA%\JOSM\app\JOSM.cfg` and add `java-options=-Xmx8192m` (for 8 GB) to a new line under the `[JavaOptions]` header.

==== Graphics ====#MicrosoftWindowsGraphics
Some Windows installations have graphics driver issues (see #23784 for an example). This may exhibit symptoms such as:
* Black bars in JOSM toolbars
* Flickering
* Other unexpected user interface issues

1. Download and install Display Driver Uninstaller (DDU, [https://github.com/Wagnard/display-drivers-uninstaller source]) from the official mirror => https://www.wagnardsoft.com/display-driver-uninstaller-DDU-
2. From the "Device Type" drop-down on the right, select "GPU". DDU will automatically detect the GPU you're using.
3. Click on "Clean and Restart" at the top. This will uninstall the graphics drivers and restart your PC.
4. Reinstall the drivers.

//**WARNING: Create a backup of your PC before using DDU. Although it creates a recovery point by itself, it's ideal to make one yourself just in case.**//

=== macOS ===#macOS
[=#MacOSErrors][=#MacOSXMountainLionErrors][=#Macoserrors]
{{{
#!comment
old section title, keeping as anchor for old links
}}}

==== brewを使用する ====#brew
MacOSユーザーは、JOSMインスタンスをインストールして更新するために、[https://brew.sh/ homebrew] パッケージマネージャを選択することができます。

ターミナルで`brew install --cask josm`を実行してインストールするか、`brew upgrade --cask josm`を実行して現在のテスト済み版のJOSMにアップグレードします。

=== Linux ===#linux
==== Arch Linux ====
Using AUR you can install [https://aur.archlinux.org/packages/openwebstart-bin openwebstart-bin].

If you use [https://archlinux.org/packages/extra/x86_64/icedtea-web/ icedtea-web] instead of the recommended openwebstart you will get an error with the newest java. java-17-openjdk is known to work, but java-22-openjdk do not.

=== 既知の問題 ===

未解決の問題 …:
* [/query?status=!closed&type=defect&keywords=~java Java issues] - いくつかのバグはOracle Java仮想マシンのブロッカーに繋がります（[wiki:JavaBugs JavaBugs]でカバーされています）。
* [/query?status=assigned&type=defect&status=needinfo&status=new&status=reopened&keywords=~linux&order=priority Linux]
* [/query?status=assigned&type=defect&status=needinfo&status=new&status=reopened&keywords=~ubuntu&order=priority Ubuntu]
* [/query?status=assigned&type=defect&status=needinfo&status=new&status=reopened&keywords=~macos&order=priority macOS]
* [/query?status=assigned&type=defect&status=needinfo&status=new&status=reopened&keywords=~windows&order=priority Windows]

Note: See WikiFormatting and TracWiki for help on editing wiki content.

Change information

Your email or username:

E-mail address and name can be saved in the Preferences

Comment about this change (optional):

Note: See TracWiki for help on using the wiki.