[[TranslatedPages(revision=135)]]
[[PageOutline(2-3,Table of Contents)]]

= 다운로드 =

이 페이지는 기본적인 JOSM 설치 단계와 문제 해결에 도움이 되는 정보를 제공합니다.
JOSM으로 작업을 시작하려면 [wikitr:/Introduction]과 [wikitr:/Help] 페이지를 보세요.
그리고 설치 중에 생기는 다양한 문제를 해결하려 한다면 [wikitr:/InstallNotes 설치 참고]를 보세요.

== 권장 옵션 ==

[[JOSMImage(openlocation, valign=middle, link=[download/josm.jnlp])]] **[/download/josm.jnlp josm.jnlp] 시작**(안정적인 최신 버전) [[br]]
권장하는 버전, 모든 플랫폼, 매달 ''안정적인 버전''으로 자동으로 업데이트([#Webstart 시작하려면]). [[br]]
[[br]]

[[JOSMImage(download, valign=middle, link=[/josm-tested.jar])]] **[/josm-tested.jar josm-tested.jar] 다운로드**(안정적인 버전 [[Version(tested)]]) [[br]]
모든 플랫폼([#Java 구동하려면]). [[br]]
[[br]]

== 모든 다운로드 옵션 ==#Moredownloadoptions

[/roadmap 매달] JOSM 팀은 **안정적인 버전**을 다운로드 파일로 [wikitr:/Releases 출시]합니다.
이 안정적인 버전은 MS Windows와 Apple Mac에서 구동할 수 있도록 빌드됩니다.
JOSM을 구동하기 위해 josm.jnlp를 클릭했을 때마다 항상 안정적인 최신 버전을 받아올 것입니다. 이를 구현하기 위해서 Java [wikitr:/InstallNotes#Webstart Web Start]를 사용합니다.

[=#DevelopmentVersion]
매일 [/log/josm/?verbose=on&limit=20 밤마다] 빌드 시스템이 **최신 개발 버전**을 생성합니다.
이 버전은 약간의 오류가 있을 수 있지만, 보통은 잘 작동합니다.
최신 개발 버전도 Java Web Start로 사용할 수 있습니다.


||= =||||=모든 운영체제용 =||||||||||
||=버전 =||=  Web Start  =||= 다운로드 =||= Windows =||= Apple Mac =||= Ubuntu, Debian…  =||= openSUSE =||
||안정적인 버전 [[Version(tested)]] ||   \
||   [/download/josm.jnlp josm.jnlp] ||  \
||   [/josm-tested.jar] ||           \
||   [[br]] [/download/windows/josm-setup.exe setup.exe] [[br]]''([#Mswindowswrapper 아래 참조])'' ||  \
||   [[br]] [/download/macosx/josm-macosx.zip package.zip] [[br]]''([#Macoserrors 아래 참조])'' ||  \
||   ''[#Ubuntu 아래 참조]'' ||          \
||   ''[#Opensuse 아래 참조]'' ||
||최신 버전 [[Version(latest)]] || \
||   [/download/josm-latest.jnlp latest.jnlp] ||  \
||   [/josm-latest.jar] || \
||   || || ''[#Ubuntu 아래 참조]'' || ||
||=오래된 버전 =|| || [/download/ download/] || || || [/apt/dists/ dists/] || ||

스크립트를 실행할 때는 다운로드 대역폭을 줄이기 위해 먼저 [/latest 안정적인 버전], [/tested 최신 버전] 또는 [/version 둘 다]에서 확인해 주세요.

** 번역본 조각 **[=#Striptranslations]  \\
다운로드 용량에서 문제가 생길 경우에는 더 작은 안정적인 버전 파일을 사용할 수 있습니다. 영어만 포함해서 다운로드하고 싶다면 URL에 [/josm-tested.jar?lang=en ?lang=en]을 추가하세요. 다른 번역본을 포함하고 싶다면 'en'을 원하는 [wikitr:/TracLanguages 언어 코드](첫 글자는 소문자, 지원되는 언어만 해당)로 대체하세요. 더 나아가 [/josm-tested.jar?lang=en&unsigned=1 ?unsigned=1]를 추가하면 다운로드 파일에서 서명 정보를 제거해서 파일 크기를 줄일 수 있습니다.

== 레포지토리 ==

=== openSUSE  ===#Opensuse
[=#openSUSE]
JOSM의 안정적인 버전을 Application:Geo 레포지토리에서 사용할 수 있습니다.

먼저 레포지토리에서 yast나 zypper에 루트 유저를 추가하세요(현재 사용하고 있는 URL의 버전을 대체하세요).
{{{
zypper ar -f https://download.opensuse.org/repositories/Application:/Geo/openSUSE_Leap_15.0 Application:Geo
}}}

그러고 난 후 단순히 ''josm''과 ''josm-fonts'' 패키지를 설치하세요.

=== Ubuntu ===#Ubuntu

이는 Ubuntu에서 주로 사용하는 패키지 레포지토리입니다. 이 패키지는 다른 Debian 기반(특히 Ubuntu 기반) 배포판에서도 작동하겠지만, 우리는 그 외 배포판을 활발하게 테스트하고 유지보수하지 않습니다.

이 레포지토리는 2개의 패키지를 포함합니다.
* ''josm''  – 안정적인 버전을 제공합니다. 이 패키지를 Ubuntu 공식 레포지토리에서 교체하세요.
* ''josm-latest'' – 가장 최신 버전(매일 밤마다 업데이트). josm 패키지와 같이 설치할 수 있습니다. 기본 설정 폴더는 {{{~/.josm-latest}}}입니다.

정상적인 설치 절차는 아래에 설명되어 있으며, 더 오래된 DEB는 [/apt/pool/universe/j/ 아카이브]에서 수동으로 다운로드할 수 있습니다.

==== 설치 ====

패키지 리소스 목록 {{{/etc/apt/sources.list}}}를 편집하세요.

{{{
#!sh
sudo editor /etc/apt/sources.list
}}}

현재 사용하는 Ubuntu 버전에 따라 다음 줄 중 하나를 추가하세요.

{{{
#!sh
deb https://josm.openstreetmap.de/apt trusty universe
deb https://josm.openstreetmap.de/apt xenial universe
deb https://josm.openstreetmap.de/apt artful universe
# 다른 Debian 기반 배포판을 사용하는 경우 추가
deb https://josm.openstreetmap.de/apt alldist universe
}}}

대신, Ubuntu에서 다음 한 줄을 추가해서 작업을 끝낼 수 있습니다.
{{{
echo deb https://josm.openstreetmap.de/apt $(lsb_release -sc) universe | ↩
↪sudo tee /etc/apt/sources.list.d/josm.list > /dev/null
}}}

{{{#!comment
### 아래는 모든 시스템에서 작동하지 않습니다.

그런 후 다음 줄을 추가하세요.
`
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
}}}

== 문제 해결 ==
=== Java ===#Java
[=#Doubleclickonafiledoesnothing jar 파일을 더블 클릭했을 때 아무 일도 일어나지 않는다면] 대부분은 Java가 설치되지 않은 경우입니다. 

JOSM은 Oracle에서 배포판 프로그램에서 검사받았기 때문에, Oracle 홈페이지에서 [https://www.java.com/download/manual.jsp 수동으로]Java를 다운로드하거나 [http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html Java SE]를 다운로드하는 것을 권장합니다. 하지만 처음에는 운영 체제가 배포한 Java([https://en.wikipedia.org/wiki/OpenJDK 예시])가 이미 주어집니다.

다운로드할 때 다음을 명심하세요.
 * 웹 브라우저용 Java 플러그인은 JOSM을 구동하는 데 필요하지 **않습니다.** 그러므로 [https://www.java.com/ko/download/installed8.jsp www.java.com/ko/download/installed8.jsp] 같은 페이지의 결과와는 아무런 관련이 없습니다.
 * JOSM을 구동하는 데에는 64비트 Java를 권장합니다. 32비트/64비트 java를 선택할 때는 운영 체제 아키텍처가 중요합니다. 왜나하면 JOSM은 웹 브라우저 아키텍처에 영향을 받지 **않기** 때문입니다. 그러므로 [https://www.java.com/ko/download/faq/java_win64bit.xml www.java.com/ko/download/faq/java_win64bit.xml] 페이지에서 가장 추천하는 결과와는 아무런 관련이 없습니다.
 * 웹 브라우저용 Java 플러그인에 집중하는 [https://www.java.com/ko/download www.java.com/ko/download] 같은 페이지는 피하세요. 이는 JOSM에 중요하지 **않습니다.**

더 많은 정보는[InstallNotes 설치 참고]와 [https://www.java.com/ko/download/help/troubleshoot_java.xml 문제 해결] 페이지를 참조하세요.
이 단락에서 ''Java''는  JOSM을 구동하기 위한 JVM(Java Virtual Machine, Java 가상 머신)이 포함된 JRE(Java Runtime Engine, Java 런타임 엔진)을 의미하며, JDK(Java Development Kit, Java 개발 도구)를 사용해 개발되었으면서 때때로 JNLP(Java Network Launch Protocol, Web Start나 Java 플러그인의 대체재와 같은 Java 네트워크 구동 프로토콜)로 구동되는 Java 프로그램을 의미하기도 합니다.

==== Java 검사 ====#Javatest 
[=#Troubleshootingjarfile] Java가 설치되었는데 JOSM이 시작하지 않을 경우 검사하세요(예시는 주로 MS Windows).
1. [/josm-tested.jar josm-tested.jar]를 바탕화면에 다운로드하세요.
1. 터미널 같은 명령 프롬프트를 여세요.
1. `cd %homepath%`⏎를 치고 나서 `cd Desktop`⏎을 치세요. 
1. `java -version `⏎을 치세요. Java 버전과 관련된 세 줄이 나타나야 합니다. 만약 다른 게 나타났다면 Java가 적절히 설치되지 않은 것입니다.
1. `java -jar josm-tested.jar`⏎를 치세요. [wikitr:/Help/CommandLineOptions 명령 줄]에서 바로 JOSM이 실행되어야 합니다.
1. JOSM을 닫으세요.
1. `josm-tested.jar`⏎를 치세요. JOSM이 다시 시작한다면, Windows 탐색기가 jar 파일을 더블 클릭할 준비가 된 것입니다.


=== Web Start ===#Webstart
[=#Troubleshootingjhlplink]
Web Start로 JOSM을 구동하는 것은 jar 파일을 다운로드한 뒤 jar 파일을 실행하는 전통적 방식으로 구동하는 것보다 오류를 일으킬 더 많은 원인을 가지고 있습니다.
그렇기 때문에 [#JavaTest Java]를 먼저 검사한 후 아래에 설명된(또는 다른 곳에 설명된 [https://www.java.com/en/download/faq/java_webstart.xml Web Start 문제]) 검사를 해 주세요.

==== Web Start 검사 ====#Webstarttest
1. [/josm-tested.jar josm.jnlp]를 바탕화면에 다운로드하세요.
1. 명령 프롬프트를 열고 위처럼 바탕화면으로 이동하세요.
1. `javaws josm.jnlp`⏎를 입력하세요. 먼저 JOSM을 다운로드해야 하며, 보안 대화 상자를 띄운 후 JOSM이 켜져야 합니다.

=== 가상 머신 ===#Troubleshootingjvm

==== 메모리 초과 ====

오늘날에는 수동으로 Java 메모리를 조정하는 일은 거의 필요하지 않습니다. 컴퓨터에서 사용 가능한 메모리의 용량이 커졌기 때문입니다.
잘못 지정한 값은 JOSM 성능을 떨어뜨릴 수 있습니다. 

몇몇 작업에서 JOSM은 메모리를 많이 차지합니다. 한편으로는 더 많은 플러그인과 지물을 지원하도록 메모리 크기를 설정할 필요가 있을 수도 있습니다. 다른 한편으로는 Java 메모리 사용량을 제한해서 컴퓨터를 안정시킬 수 있습니다.
만약 필요하다면, [https://docs.oracle.com/javase/8/docs/technotes/tools/unix/java.html#BABHDABI Java 옵션] -Xmx…m(예를 들어 `-Xmx512m`이나 `-Xmx1536m`)을 설정하기 위해 [wikitr:Help/CommandLineOptions 명령 줄]을 사용하세요.
이전의 더 오래된 Java 프로그램은 `-Xmx=512m`이나 심지어 `-Xmx 512m`도 받아들였습니다. 오늘날 그러한 잘못된 인수는 오류 메시지를 출력합니다.


==== 가상 머신 선택 ====#VMselectiononWindowsx64

MS Windows의 현재 버전에서는 기본적으로 Java가 `C:\Program Files\Java\` 디렉토리에 주로 설치되어 있습니다. 추가 파일은 `C:\Program Files\Oracle\Java\`에 위치해 있습니다. PATH 환경 변수의 대상으로 `.\javapath\` 디렉토리가 있습니다. 이는 세 가상 머신 파일 `java.exe`, `javaw.exe`, `javaws.exe`의 기본 위치입니다. 이 파일들은 현재 Java 설치를 구성하는 상징적인 연결 고리입니다.

64비트 Windows의 더 오래된 버전에서는 때때로 32비트 모드 JRE가 추가로 설치됩니다. 또한 몇몇 브라우저는 제한된 기능만 탑재된 브라우저용 JVM을 가져옵니다. 이 경우에서 브라우저에서 Web Start는 브라우저용 JVM을 사용하고 사용자가 설치한 Java를 사용하지 않을 수 있습니다.

{{{\Windows\SysWow64}}}에 다른 javawebstart가 없는지 확인하세요. Java 제어판은 다른 javawebstart를 감지하지 못하기 때문에 다른 javawebstart 파일을 안전하게 삭제할 수 있습니다. 각각(32비트/64비트) JRE의 최신 버전만 남겨 두고 지우세요.

바탕화면에 생성된 JNLP 바로가기와 Javawebstart 실행기의 구동을 위해, 확실하게 VM 옵션 앞에 공백이 없으면서 -J 접두사를 붙인 VM 파라미터를 전달하세요. 만약 32비트/64비트 버전을 둘 다 설치했고, 선호받는 64비트 VM을 선택하고 싶다면 "{{{-d64}}}" 옵션을 전달해야 합니다. 몇몇 Oracle 페이지는 "-D64"라는 잘못된 대문자 표기를 가리키고 있다는 점을 명심하세요!

바탕화면에 있는 바로가기를 위한 명령 줄의 예시
{{{
#!sh
javaws.exe -J-d64 -J-Xmx2048m  josm.jnlp 
}}}

=== Windows josm.exe ===#Mswindowswrapper

Microsoft Windows에서 josm-setup.exe를 사용해서 설치하는 것은 다음의 행동을 하는 것과 같습니다. 
 * `josm-tested.jar`와 `josm.exe` 파일을 사용자가 선택한 디렉토리(기본 값은 `C:\Program Files (86)\JOSM\`)에 넣습니다.
 * josm.exe를  `*.osm`과 `*.gpx` 확장자를 가진 파일의 연결 프로그램으로 등록하도록 제안합니다.
 * JOSM 바로가기 아이콘을 바탕화면과 시작 메뉴에(현재는 바로가기가 관리자 전용 계정에 위치해 있으며 위치한 곳에서 복사할 수 있습니다, #11398) 추가하도록 제안합니다.
 * 플러그인 이미지 오프셋 데이터베이스와 회전 제한을 제공해야 하는지 물어봅니다.
 * 적절한 위치에 제거 파일을 추가합니다.

시작할 때, josm.exe는 자신의 디렉토리에서 jar 파일을 검색한 뒤, 명령어 `\path\to\javaw.exe -Xms128m -Xmx1024m -jar \path\to\josm-tested.jar`를 실행합니다.
josm.exe는 ''포장지''처럼 행동하며, [wikitr:/USB_Stick 포터블] 파일입니다.

josm.exe가 인수 `--l4j-debug`를 찾았을 때, josm.exe는 현재 디렉토리에(쓰기 가능하다면) 로그 파일 `launch4j.log`를 작성합니다. 몇몇 다른 [http://launch4j.sourceforge.net/docs.html#Runtime_options 옵션]을 덧붙여 사용할 수 있으며, 통상적인 모든 [wikitr:/Help/CommandLineOptions#Programarguments JOSM 프로그램 인수]들도 덧붙여 사용할 수 있습니다.

예시:
{{{
#!sh
# JOSM을 시작하는 동안 로그를 작성하고 OSM 데이터를 불러오기
josm.exe --l4j-debug https://www.osm.org/way/476702262
}}}

Java VM에 주어진 [wikitr:Help/CommandLineOptions#Javaoptions Java 옵션]을 위해 josm.exe는 자신의 디렉토리에 있는 부수적인 파일 `josm.l4j.ini`를 사용합니다. 이 파일에서 각각 옵션은 독립된 줄을 필요로 하며, 주석을 사용할 수 있습니다. [http://launch4j.sourceforge.net/docs.html#Additional_jvm_options 추가 JVM 옵션]을 참조하세요.

josm.exe가 32비트 프로그램이라 하더라도, 64비트 Windows에서 josm.exe는 64비트 Java를 필요로 합니다.

=== MacOS 오류 ===#Macoserrors
[=#MacOSErrors][=#MacOSXMountainLionErrors]
{{{
#!comment
오래된 링크의 앵커로 유지하는 오래된 단락 제목.
}}}

Apple은 JOSM을 사용하면서 사용자를 ''보호''하기 위해 두 가지 기술([https://support.apple.com//HT201940 파일 격리]와 [https://support.apple.com//HT202491 Gatekeeper])을 가지고 있습니다.

==== 인터넷에서 다운로드 ====
만약 "'JOSM.app'은 인터넷에서 다운로드된 앱입니다."라는 오류를 보았다면 **JOSM.app이나 josm.jnlp를 우클릭해서** '열기'를 선택해 이를 우회할 수 있습니다. 그런 다음에 동일한 메시지가 표시되지만 이번에는 "열기" 옵션이 표시됩니다. 이 행동은 JOSM을 처음 실행할 때만 필요합니다.

==== 손상됨 ====
[[Image(#8787:damaged_josm_app.png,width=300,align=left,margin-top=-50,margin-left=30)]]
만약 "'JOSM.app'은 손상되었기 때문에 열 수 없습니다. 휴지통으로 옮겨야 합니다."라는 오류를 보았다면 임시로 Gatekeeper를 비활성화해야 합니다.

시스템 환경 설정을 열고 '보안&개인정보' 옵션을 여세요. '앱이 다음 위치에서 다운로드하도록 허락:'을 '모든 곳'으로 설정하세요. 

[[Image(Download:SecurityPrivacy.png,align=right,float=left,width=300)]]

만약 보안&개인정보 환경 설정에 버튼이 없다면 터미널 창을 여세요. 다음 명령어를 입력하면 버튼이 나타날 수 있습니다.
{{{
sudo spctl --master-disable
}}}

==== brew를 사용 ====#brew
MacOS 사용자는 JOSM 인스턴스를 설치하고 업데이트할 일반적인 방법으로 [https://brew.sh/ homebrew] 패키지 관리자를 고를 수 있습니다.

`brew cask`를 사용하는 것은 위에 언급된 문제의 대부분을 없앱니다([https://caskroom.github.io/] 참조).

JOSM을 설치하거나 현재의 안정적인 버전으로 업데이트하기 위해 터미널을 열고 다음 명령어를 각각 작동시키세요.

{{{
 brew cask install josm
}}}
{{{
brew cask upgrade josm
}}}

=== 알려진 문제 ===

닫히지 않은 문제
* [/query?status=!closed&type=defect&keywords=~java Java 문제] - 몇몇 버그는 Oracle JVM을 방해하는 요소로 이어집니다.([[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]