[[TranslatedPages(revision=183)]]
[[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] \\ ''([#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]  || || ||  \
||  ''[#Ubuntu 下記参照]''  || ||  \
||  [/nexus/content/groups/public/org/openstreetmap/josm/josm/SNAPSHOT/ スナップショットを使用する] ||
||=''**過去バージョン**'' =|| ||  \
||  [/download/ download/]  || ||  \
||  [https://github.com/openstreetmap/josm/releases automatic JOSM.app builds]  ||  \
||  [/apt/dists/ dists/]  || ||  \
||  [/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-latest'' - 最新版(nightly)。josmパッケージと並行してインストールできるので、デフォルトの設定フォルダは `JOSM-latest` になります。

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

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

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

利用中のUbuntuのバージョンに応じた行を追加してください:
 
{{{ #!sh
deb https://josm.openstreetmap.de/apt hirsute universe
deb https://josm.openstreetmap.de/apt groovy universe
deb https://josm.openstreetmap.de/apt focal universe
deb https://josm.openstreetmap.de/apt eoan universe
deb https://josm.openstreetmap.de/apt disco universe
deb https://josm.openstreetmap.de/apt bionic universe

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

これに代えて、次の一行で行うこともできます（Linux MintのようなUbuntuベースのディストリビューションでは使えません）:
{{{
echo deb https://josm.openstreetmap.de/apt $(lsb_release -sc) universe | sudo tee /etc/apt/sources.list.d/josm.list > /dev/null
}}}
またはLinux Mint用:
{{{
echo deb 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 
以下の行を追加してください:
`deb https://josm.openstreetmap.de/apt VERSION universe`
}}}

[/josm-apt.key　公開鍵]をダウンロードして登録してください:
{{{#!sh
wget -q https://josm.openstreetmap.de/josm-apt.key -O- | sudo apt-key add -
}}}


ソースを更新します (`sudo apt-get install apt-transport-https`を実行する必要があります)
{{{#!sh
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
[https://packages.debian.org/stable/josm JOSM]のテスト済み版は、セクション **''utils''** の **''main''** の下にあります。

[https://backports.debian.org backports リポジトリ]を使用して最新版を取得してください。また[https://backports.debian.org/Instructions 手順]を参考にしてください。

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

Debian 11 (bullseye) 以降は、このサイトから .jar ファイルをダウンロードする [https://packages.debian.org/stable/josm-installer josm-installer] も、最新の JOSM のための追加オプションとして利用できます。

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

最初にrootユーザーとしてyastに追加するか、リポジトリをzypperで追加します（URLのバージョンを使用しているバージョンに置き換えてください）:
{{{
zypper ar -f https://download.opensuse.org/repositories/Application:/Geo/openSUSE_15.0 Application:Geo
}}}

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

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

JOSMはOracle版でテストされていたため、[https://www.java.com/download/manual.jsp 手動]ダウンロードや[http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html 中間]バージョンのページからJavaを入手することをお勧めしていました。

JOSMでは現在、[https://www.azul.com/downloads/?package=jre-fx#download-openjdk Azul]または[https://bell-sw.com/pages/downloads/?package=jre-full#mn Bellsoft Liberica]のJDKを推奨しています。一般的には、現在のJava LTS (執筆時点ではJava 17)が望ましいとされていますが、Java 8でも動作します。現在の推奨環境は[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にとって重要では**ありません**。

詳細については、[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をダウンロードし、実行することができますOracle WebStartからOpenWebStartへの移行はまだ進行中ですので、問題が発生した場合は[/newticket 新規チケット]を作成するか、#17858にコメントを投稿してください。

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

www.DeepL.com/Translator（無料版）で翻訳しました。

==== 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/javase/8/docs/technotes/tools/unix/java.html#BABHDABI Javaオプション] -Xmx…m を設定します。（例: `-Xmx512m` または `-Xmx1536m` ）
以前の古い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"の大文字表記は間違っていることに注意してください。

Windowsデスクトップ上のショートカットを編集したコマンドラインの例:
{{{
#!sh
javaws.exe -J-d64 -J-Xmx2048m  josm.jnlp
}}}


=== Windowsでの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`を使用します。このファイルでは、各オプションは個別の行を必要とします。

=== 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にアップグレードします。

=== 既知の問題 ===

未解決の問題 …:
* [/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]