Eclipse SDK를 디렉토리에 설치한 후 릴리스에 포함된 Eclipse 실행 파일을
실행하여 워크벤치를 시작할 수 있습니다(Java SE 5 JRE도 필요하지만 Eclipse SDK에는
포함되지 않습니다). Windows의 경우, 실행 파일은 eclipse.exe이며
설치 eclipse 서브디렉토리에 있습니다. c:\eclipse-SDK-4.1-win32에 설치하는 경우,
실행 파일은 c:\eclipse-SDK-4.1-win32\eclipse\eclipse.exe입니다.
참고: 대부분의 다른 운영 환경에서의 설정도 유사합니다. Mac OS X에 대한 특수 지시사항은
아래에 나열되어 있습니다.
Eclipse는 기본적으로 최대 384MB의 Java 힙 메모리를 할당합니다. 이
메모리는 모든 일반 개발 태스크에 충분해야 합니다. 그러나
실행하는 JRE, 사용하는 추가 플러그인 수 및 작업할 파일
수에 따라 이 크기를 크게 늘려야 하는 경우도 있습니다.
Eclipse에서는 -vmargs 명령행 인수를 사용하여 Java VM으로 직접 인수를
전달할 수 있습니다. 이 명령행 인수는 다른 모든 Eclipse 특정 인수 다음에 표시되어야 합니다.
따라서 사용 가능한 힙 메모리를 늘리려면 일반적으로 다음을 사용해야 하며
eclipse -vmargs -Xmx<memory size>
<memory size> 값은 "384M"(384MB -- 기본값)보다 크게 설정합니다.
Oracle(Sun) VM을 사용하는 경우, 영구 생성 메모리의 크기도 늘려야 합니다. 기본 최대값은 64MB이지만 플러그인 구성 및 사용에 따라 추가 메모리가 필요합니다. VM에서 영구 생성 메모리가 부족한 경우 클래스 로드 중에 충돌하거나 정지될 수도 있습니다. Sun JRE 버전 1.5.0_07 이상을 사용하는 경우 이 문제의 발생 빈도가 줄어듭니다. 최대 영구 생성 크기는 다음과 같이 -XX:MaxPermSize=<memory size> 인수를 사용하여 늘립니다.
eclipse -vmargs -XX:MaxPermSize=<memory size>
이 인수는 일부 VM 버전 및 플랫폼에는 사용할 수 없습니다. 세부사항은 VM 문서를 참조하십시오.
메모리 크기를 시스템에서 실제로 사용 가능한 메모리보다 크게 설정하면 오브젝트를 가상 메모리에 복사할 때 Java에서 "비우기" 작업을 수행하여 성능이 현저히 저하됩니다.
워크벤치가 실행되면 먼저 작업공간이 있는 위치를 선택할 수 있는 대화 상자가 표시됩니다. 작업공간은
작업이 저장될 디렉토리입니다. 별도로 지정하지 않은 경우, Eclipse는 사용자 디렉토리에 작업공간을 작성합니다.
이 작업공간 디렉토리는 프로젝트 및 필요한 모든 메타데이터를 보관하는
기본 컨텐츠 영역으로 사용됩니다. 공유 또는 다중 작업공간 설치의
경우 대화 상자를 사용하거나 "-data"
명령행 인수를 통해 작업공간의 위치를 명시적으로 지정해야 합니다.
다음은 일반 Eclipse 명령행입니다.
eclipse -vm c:\jdk5u22\jre\bin\javaw
팁: 일반적으로 Eclipse를 실행할 때 사용할 Java VM을 명시적으로 지정하는 것이 좋습니다. 위에서 설명한 대로
"-vm" 명령행 인수를 사용하여 수행됩니다. "-vm"을 사용하지 않을 경우,
Eclipse는 O/S 경로에 있을 수 있습니다. 다른 Java 기반 제품을 설치할 경우, 사용자 경로를 변경하여 다음에 Eclipse를 실행할 때
다른 Java VM이 사용되도록 합니다.
설치된 Eclipse에 Windows 바로 가기를 작성하려면 다음을 수행하십시오.
eclipse.exe를
탐색하고 컨텐츠 메뉴에서 바로 가기 작성을 사용하십시오.이 바로 가기를 열면 Eclipse가 실행됩니다. 바로 가기를 Windows 바탕화면에 끌어 놓으면 쉽게 사용할 수 있습니다.
Mac OS X의 경우, Eclipse 애플리케이션을 두 번 클릭하여 Eclipse를 시작합니다.
Eclipse로 인수를 전달해야 하는 경우, Eclipse 애플리케이션 번들
내부에서 eclipse.ini 파일을 편집해야 합니다. Ctrl 키를
누른 상태에서 Eclipse 애플리케이션 번들 아이콘을 선택하십시오. 아이콘을 선택하면 팝업 메뉴가
표시됩니다. 팝업 메뉴에서 "패키지 컨텐츠 표시"를 선택하십시오. Contents/MacOS 서브폴더에서 eclipse.ini 파일을 찾고 자주 사용하는 문서 편집기에서 파일을 열어 명령행 옵션을 편집하십시오.
MacOS X에서는 디스크에 프로그램의 독립된 사본이 있는 경우에만 UI 프로그램을 두 번 이상 실행할 수 있습니다. 이는 Mac의 모든 UI 애플리케이션이 다중 문서를 열 수 있기 때문에 일반적으로 프로그램을 두 번 열 필요가 없기 때문입니다. Eclipse에서는 작업공간을 두 번 이상 열 수 없기 때문에 즉 한 번에 둘 이상의 작업공간을 열려면 Eclipse 설치 사본을 작성해야 합니다(버그 139319).
명령행에서 Eclipse를 실행해야 하는 경우, 최상위 레벨 Eclipse 폴더에서 기호 링크 "eclipse"를 사용할 수 있습니다. 이 링크는 애플리케이션 번들 내부의 Eclipse 실행 파일을 참조하며 다른 플랫폼의 "eclipse.exe"와 동일한 인수를 사용합니다.
Mac OS X 10.4 이상의 경우, 대용량 자원 작업을 수행하면 작업 속도가 저하됩니다(Spotlight에서 작업공간을 색인화할 수 있는 경우). 이러한 문제를 막으려면 시스템 환경 설정을 시작하고 Spotlight 아이콘과 개인 정보 탭을 차례로 선택한 후 추가 단추("+")를 클릭하십시오. 대화 상자가 열리면 작업공간 디렉토리를 검색하십시오.
공유 설치 영역에 올바른 캐시 정보를 저장하면 공유 설치의 시작 속도를 향상시킬 수 있습니다. 이를 수행하려면 Eclipse 분배 압축을 푼 후 설치 디렉토리에 대한 쓰기 액세스 권한이 있는 계정에서 "-initialize" 옵션을 사용하여 Eclipse를 한 번 실행하십시오.
Eclipse 실행 파일과 플랫폼 자체에서는 Eclipse의 파트를 개발하거나 디버그하는 사람에게 유용한 여러 가지 실행 옵션을 제공합니다. 이는 공통으로 사용되는 옵션 목록이며, 전체 목록은 플랫폼 플러그인 개발자 안내서의 Eclipse 런타임 옵션 페이지를 참조하십시오. 다음은 Eclipse 실행 파일을 실행하는 일반적인 양식입니다.
eclipse [platform options] [-vmargs [Java VM arguments]]
| 명령 | 설명 | 이후 |
|---|---|---|
-arch architecture |
Eclipse 플랫폼이 실행되는 프로세서 아키텍처를 정의합니다. Eclipse 플랫폼은 일반적으로 Java os.arch 특성의 일반적인 값을 사용하여
최적 설정을 계산합니다. 여기에 값을 지정하면 Eclipse 플랫폼에서 사용합니다. 여기에 지정한 값은 플러그인에 Platform.getOSArch()로 사용할 수 있습니다.
예제 값은 "x86", "sparc", "PA-RISC" 및 "ppc"입니다. |
2.0 |
-application applicationId |
실행할 애플리케이션. 애플리케이션은 org.eclipse.core.runtime.applications 확장점에 확장을 제공하는 플러그인에 의해 선언됩니다. 이 인수는 일반적으로 필요하지 않습니다. 이 인수를 지정하면 구성에서 제공한 값을 대체합니다. 인수를 지정하지 않으면 Eclipse 워크벤치가 실행됩니다. | 1.0 |
-clean |
OSGi 프레임워크 및 Eclipse 런타임에서 사용하는 캐시된 데이터를 정리합니다. 공유 구성을 설치, 업데이트 또는 사용한 후 시작 오류가 발생하는 경우 이 옵션을 사용하여 Eclipse를 한 번 실행하십시오. | 3.0 |
-configuration configURL |
Eclipse 플랫폼 구성 파일이 있는 위치(URL로 표시). 구성 파일은 Eclipse 플랫폼의 위치, 사용 가능한 플러그인 세트 및 기본 기능을 판별합니다. 상대 URL은 허용되지 않습니다. Eclipse 플랫폼을 설치하거나 업데이트할 때 구성 파일이 이 위치에 기록됩니다. | 2.0 |
-consolelog |
Eclipse 플랫폼의 오류 로그를 Eclipse를 실행하는 데 사용되는 콘솔에 이중복사합니다.
-debug와 함께 결합하면 유용합니다. |
1.0 |
-data workspacePath |
Eclipse 플랫폼을 실행할 작업공간의 경로. 작업공간 위치는 프로젝트의 기본 위치이기도 합니다. 상대 경로는 Eclipse를 시작한 디렉토리에 따라 다르게 해석됩니다. | 1.0 |
-debug [optionsFile] |
플랫폼을 디버그 모드에 놓고 위치를 지정한 경우 지정한 위치의 파일에서 디버그 옵션을 로드합니다. 이 파일은 플러그인에 사용 가능한 디버그 점과 해당 디버그 점의 사용 여부를 표시합니다. 파일 위치가 지정되어 있지 않으면 플랫폼은 Eclipse를 시작한 디렉토리에서 ".options"라는 파일을 찾습니다. URL 및 파일 시스템 경로 모두 파일 위치로 허용됩니다. | 1.0 |
-dev [classpathEntries] |
플랫폼을 개발 모드에 놓습니다. 선택적 클래스 경로 항목(쉼표로 구분된 목록)이
각 플러그인의 런타임 클래스 경로에 추가됩니다. 예를 들어, 작업공간에 개발 중인 플러그인이 들어 있을 경우, -dev bin을 지정하면
이름이 bin인 각 플러그인 프로젝트의 디렉토리가 추가되므로 새로 생성된 클래스 파일을
이 디렉토리에서 찾을 수 있습니다. 중복되거나 없는 클래스 경로 항목은 제거됩니다. |
1.0 |
-initialize |
실행 중인 구성을 초기화합니다. 모든 런타임 관련 데이터 구조 및 캐시를 새로 고칩니다. 편리한 공유 설치: 쓰기 특권이 있는 계정에서 이 옵션을 사용하여 Eclipse를 한 번 실행하면 시작 성능이 향상됩니다. | 3.0 |
-keyring keyringFilePath |
디스크의 권한 데이터베이스(또는 "키 링" 파일)의 위치. 이 인수는 -password 옵션과 함께 사용해야 합니다.
상대 경로는 Eclipse를 시작한 디렉토리에 따라 다르게 해석됩니다. |
1.0 |
-nl locale |
Eclipse 플랫폼이 실행되는 로케일의 이름을 정의합니다. Eclipse 플랫폼은 일반적으로 최적 설정을 자동으로 계산합니다. 여기에 값을 지정하면 Eclipse 플랫폼에서 사용합니다. 여기에 지정한 값은 플러그인에 Platform.getNL()로 사용할 수 있습니다. 예제 값은 "en_US" 및 "fr_FR_EURO"입니다. | 2.0 |
-nosplash |
스플래시 화면을 표시하지 않고 플랫폼을 실행합니다. | 1.0 |
-os operatingSystem |
Eclipse 플랫폼이 실행되는 운영 체제를 정의합니다. Eclipse 플랫폼은 일반적으로 Java os.name 특성의 일반적인 값을 사용하여
최적 설정을 계산합니다. 여기에 값을 지정하면 Eclipse 플랫폼에서 사용합니다. 여기에 지정한 값은 플러그인에 Platform.getOS()로 사용할 수 있으며,
플러그인 Manifest 파일의 언급된 경로에 $os$ 변수가 있는지 분석하는 데 사용됩니다. 예제 값은 "win32", "linux",
"hpux", "solaris" 및 "aix"입니다. |
1.0 |
-password password |
권한 데이터베이스의 비밀번호. -keyring 옵션과 함께 사용합니다. |
1.0 |
-perspective perspectiveId |
시작 시 활성 워크벤치 창에서 열 퍼스펙티브. 이 매개변수를 지정하지 않으면 시스템 종료 시 활성 상태였던 퍼스펙티브가 열립니다. | 1.0 |
-plugincustomization propertiesFile |
플러그인 환경 설정에 대한 기본 설정이 들어 있는 특성 파일의 위치. 이 기본 설정은 기본 기능에 지정된 기본 설정을 대체합니다. 상대 경로는 Eclipse를 시작한 디렉토리에 따라 다르게 해석됩니다. | 2.0 |
-product productId |
실행할 제품의 ID. 제품은 실행된 Eclipse 인스턴스에 제품 특성을 부여하고 사용된 제품 사용자 정의 정보를 판별합니다. 이 ID는 -feature를 대체하며 호환되도록 계속 지원됩니다. | 3.0 |
-refresh |
시작 시 작업공간의 글로벌 새로 고치기를 수행하기 위한 옵션. 이 옵션은 플랫폼이 마지막으로 실행된 이후 파일 시스템에서 작성된 모든 변경사항을 조정합니다. | 1.0 |
-showlocation [workspaceName] |
창 제목 표시줄에 작업공간의 위치를 표시하기 위한 옵션. 릴리스 2.0에서 이 옵션은 -data 명령행 인수와 함께 사용하는 경우에만 작동했습니다. 3.2의 경우, 작업공간 위치 대신 창 제목 표시줄에 제공된 이름을 표시하는 선택적 작업영역 이름 인수가 추가되었습니다. | 2.0 |
-vm vmPath |
Eclipse 플랫폼을 실행하는 데 사용할 JRE(Java Runtime Environment)의 위치. 값이 지정되지 않으면, 실행기가
JRE을 찾으려고 합니다. 먼저 Eclipse 실행 파일의 동위로 jre 디렉토리를
찾은 다음 운영 체제 경로를 살펴봅니다. 상대 경로는 Eclipse를 시작한 디렉토리에 따라
다르게 해석됩니다. |
1.0 |
-vmargs args |
Eclipse로 전달될 때 이 옵션은 Eclipse를 실행하는 데 사용되는 Java VM에 대한 조작을 사용자 정의하는 데 사용됩니다. 위치를 지정하는 경우 이 옵션은 명령행의 끝에 와야 합니다. 제공되는 인수는 실행 중인 VM에 따라 다릅니다. | 1.0 |
-vmargs 항목 다음에 나오는 모든 인수는 표시된 Java VM에 가상 시스템 인수(즉, 실행할 클래스 앞에 있는 인수)로 직접 전달됩니다. 참고: Java vm 인수(-vmargs) 다음에 Eclipse 시작 인수(예: -data)를 제공하는 경우, Eclipse는 시작하지 않으며 "JVM 종료됨. 종료 코드=1" 오류를 수신합니다.