他の言語:
目次
ダウンロード
このページでは、JOSMの基本的なインストール手順とトラブルシューティング情報を提供しています。 JOSMの作業を開始するには、JOSMことはじめとメインヘルプページを参照してください。 非常に複雑な問題については、Installation Notes (en)を参照してください。
推奨オプション
josm.jnlpを起動する（最新のテスト済みバージョン）
推奨バージョン、すべてのプラットフォーム、最新のテスト済みバージョンへの自動アップデート (how to start)。
josm-tested.jarをダウンロードする（テスト済みバージョン 19067）
すべてのプラットフォーム (how to run)。
すべてのダウンロードオプション
JOSMのチームは毎月、テスト版をリリースします。 このテスト版では、MS WindowsおよびApple macOSの亜種が作成されています。 josm.jnlpをクリックしてJOSMを起動すると、常に最新のテスト済みのバージョンが取得されます。Java Web Start (en)メカニズムを使用しています。
毎晩ビルドシステムが最新バージョンを生成します。 これらのバージョンは重大なエラーが発生することがあります。しかし、ほとんどの場合はうまくいきます。 最新版では、Web Start版も利用できます。
| すべてのオペレーティングシステム用 | Development | ||||||
|---|---|---|---|---|---|---|---|
| バージョン | Web Start | Download | Windows | Apple macOS | Ubuntu, Debian… | openSUSE | Jar / Javadoc / Source |
| テスト済み版 19067 | josm.jnlp | josm-tested.jar | josm-setup.exe (下記参照) | package.zip または(homebrew) | 下記参照 | 下記参照 | josm:19067 |
| 開発版 19075 | latest.jnlp | josm-latest.jar | 下記参照 | スナップショットを使用する | |||
| 過去バージョン | download/ | automatic JOSM.app builds | dists/ | テスト済み版 | |||
スクリプトを実行する際には、最新、テスト済み、またはすべてをチェックして、ダウンロード帯域幅を減らしてください。
Strip translations
ダウンロードサイズが問題である場合、テストされたバージョンのより小さいファイルが利用可能です。日本語のみを含むダウンロードの場合、?lang=jaをURLに追加します。翻訳を1つのみ含めるには、jaをあなたが望む言語コード (en)に置き換えます（最初の文字は小文字、サポートされている言語のみ）。また、?unsigned=1を追加して署名情報を取り除くことで、ファイルサイズをさらに減らすことができます。
Linuxリポジトリ
Debianベースで主にUbuntu用のJOSM
このパッケージリポジトリはUbuntu用です。他のDebianベースの（特にUbuntuベースの）ディストリビューションでも動作するはずですが、Ubuntu以外のディストリビューションではあまりテストやメンテナンスをしていません。
Ubuntuリポジトリには二つのパッケージが含まれています:
- josm - テスト済み版を提供します（安定版）。お使いのディストリビューションの公式リポジトリのパッケージを置き換えます。
- josm-latest - 最新版(nightly)。josmパッケージと並行してインストールできるので、デフォルトの設定フォルダは
JOSM-latestになります。
以下で説明する通常の手順に加えて、古いDEBはアーカイブから手動でダウンロードできます。
インストール
パッケージリソースリスト /etc/apt/sources.list を編集してください:
sudo editor /etc/apt/sources.list
利用中のUbuntuのバージョンに応じた行を追加してください:
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
公開鍵をダウンロードして登録してください:
wget -q https://josm.openstreetmap.de/josm-apt.key -O- | sudo apt-key add -
ソースを更新します (sudo apt-get install apt-transport-httpsを実行する必要があります)
sudo apt-get update
インストールします
# これらのパッケージが以前にインストールされていない場合は、この最初の行をスキップできます。 sudo apt-get remove josm josm-plugins # テスト済み版の場合 sudo apt-get install josm # 開発版の場合 sudo apt-get install josm-latest
GNU Debian
JOSMのテスト済み版は、セクション utils の main の下にあります。
backports リポジトリを使用して最新版を取得してください。また手順を参考にしてください。
また、私たちが開発した上記のUbuntuのパッケージは、Debianでも動作します。sudo の設定によりますが、いくつかの命令は「通常の」ユーザーでは動作せず、root としてのみ動作します。
Debian 11 (bullseye) 以降は、このサイトから .jar ファイルをダウンロードする josm-installer も、最新の JOSM のための追加オプションとして利用できます。
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
jarファイルをダブルクリックしても何も起こらないとき、ほとんどの場合、これはJavaがインストールされていないことを意味します。
JOSMはOracle版でテストされていたため、手動ダウンロードや中間バージョンのページからJavaを入手することをお勧めしていました。
JOSMでは現在、AzulまたはBellsoft LibericaのJDKを推奨しています。一般的には、現在のJava LTS (執筆時点ではJava 17)が望ましいとされていますが、Java 8でも動作します。現在の推奨環境はREADMEを参照してください。しかし、まずオペレーティングシステムと共に配布されているJava（例）を試してみてください。
ダウンロードを選択する際は、次の点に注意してください。
- 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にとって重要ではありません。
詳細については、インストールノートおよびトラブルシューティングのページを参照してください。 ここでいう「Java」とは、JDK (Java Development Kit)を使用して開発され、時にJNLP (Java Network Launch Protocol、別名Web StartでJavaプラグインの後継) で起動されるJavaプログラムであるJOSMを実行するためのJVM (Java Virtual Machine)を提供する、JRE (Java Runtime Engine)を意味します。
Javaのテスト
Javaがインストールされているかどうか、JOSMが起動しない理由を確認します（主にMS Windowsの場合など）。
- josm-tested.jarをデスクトップにダウンロードします。
- ターミナルもしくはコマンドプロンプトを開きます。
cd %homepath%と入力した後cd Desktopと入力します。java -versionと入力します。バージョンのデータを含む3行が表示されます。他に何か表示される場合は、Javaが正しくインストールされていません。java -jar josm-tested.jarと入力します。JOSMはコマンドラインから起動する必要があります。- JOSMを終了します。
josm-tested.jarと入力します。JOSMが再び起動すると、Windowsエクスプローラはjarファイルをダブルクリックして起動する準備が整います。
Web Start
まず、OpenWebStartをインストールする必要があります。これだけでJavaをダウンロードし、実行することができますOracle WebStartからOpenWebStartへの移行はまだ進行中ですので、問題が発生した場合は新規チケットを作成するか、#17858にコメントを投稿してください。
Oracle WebStart を使用していた場合、JNLP ファイルを開くための既定のアプリケーションを更新する必要があるかもしれません。OpenWebStartをjnlp ァイルのデフォルトプログラムとして設定する手順は、jnlpファイルの関連付けを参照してください。
www.DeepL.com/Translator（無料版）で翻訳しました。
Web Startのテスト
- josm.jnlpをデスクトップにダウンロードします。
- ターミナルを開き、上記のようにデスクトップに移動します。
javaws josm.jnlpと入力します。これは最初にJOSMをダウンロードし、セキュリティダイアログを表示してからJOSMを起動します。- それでも失敗する場合は、
javaws -verbose josm.jnlpと入力してください。これにより、まずJVMに関する情報を含むダイアログが表示され、次にJOSMが起動します。
仮想マシン
メモリ不足
今日では、コンピュータで利用可能なRAMが増えたため、Javaのメモリを手動で制御する必要はほとんどありません。 間違った値を選択すると、JOSMのパフォーマンスが低下する可能性があります。
いくつかのタスクでは、JOSMはメモリを大量に消費します。一方では、より多くのプラグインや機能をサポートするメモリサイズを設定する必要があるかもしれません。他方では、Javaのメモリ使用量を制限することで、遅いマシンを安定させることができます。
必要に応じて、 コマンドライン で Javaオプション -Xmx…m を設定します。（例: -Xmx512m または -Xmx1536m ）
以前の古いjavaプログラムは -Xmx=512m または -Xmx 512m を受け入れました。現在ではこれらの不正な引数はエラーメッセージをスローします。
仮想マシン選択
現在の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デスクトップ上のショートカットを編集したコマンドラインの例:
javaws.exe -J-d64 -J-Xmx2048m josm.jnlp
Windowsでのjosm.exe
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はラッパーとして動作し、ポータブルです。
HWConsole.exeはJOSM.exeと似ていますが、JOSMの標準出力（ログ）を表示するWindowsコンソールを開いたまま、JOSMを起動することができます。
josm.exeは通常のJOSMプログラム引数をすべて受け付けます。例:
# OSMデータをロードする
josm.exe https://www.osm.org/way/476702262
Java VMにJavaオプションを与えるために、josm.exeはそのディレクトリにある設定ファイルJOSM.cfgを使用します。このファイルでは、各オプションは個別の行を必要とします。
macOS
brewを使用する
MacOSユーザーは、JOSMインスタンスをインストールして更新するために、homebrew パッケージマネージャを選択することができます。
ターミナルでbrew install --cask josmを実行してインストールするか、brew upgrade --cask josmを実行して現在のテスト済み版のJOSMにアップグレードします。
既知の問題
未解決の問題 …:
