Eclipse 플랫폼 기능 Manifest
버전 3.0 - 최종 개정: 2004년 6월 22일
기능 Manifest 형식은 다음의 dtd로 정의됩니다.
<?xml encoding="UTF-8"?>
<!ELEMENT feature (install-handler? | description? | copyright? |
license? | url? | includes* | requires? | plugin* | data*)>
<!ATTLIST feature
id
CDATA #REQUIRED
version CDATA #REQUIRED
label
CDATA #IMPLIED
provider-name CDATA #IMPLIED
image
CDATA #IMPLIED
os
CDATA #IMPLIED
arch
CDATA #IMPLIED
ws
CDATA #IMPLIED
nl
CDATA #IMPLIED
colocation-affinity
CDATA #IMPLIED
primary
(true | false) "false"
exclusive (true | false)
"false"
plugin CDATA
#IMPLIED
application CDATA #IMPLIED
>
<!ELEMENT install-handler EMPTY>
<!ATTLIST install-handler
library
CDATA #IMPLIED
handler
CDATA #IMPLIED
>
<!ELEMENT description (#PCDATA)>
<!ATTLIST description
url
CDATA #IMPLIED
>
<!ELEMENT copyright (#PCDATA)>
<!ATTLIST copyright
url
CDATA #IMPLIED
>
<!ELEMENT license (#PCDATA)>
<!ATTLIST license
url
CDATA #IMPLIED
>
<!ELEMENT url (update?, discovery*)>
<!ELEMENT update EMPTY>
<!ATTLIST update
url
CDATA #REQUIRED
label
CDATA #IMPLIED
>
<!ELEMENT discovery EMPTY>
<!ATTLIST discovery
type
(web | update) "update"
url
CDATA #REQUIRED
label
CDATA #IMPLIED
>
<!ELEMENT includes EMPTY>
<!ATTLIST includes
id CDATA #REQUIRED
version CDATA #REQUIRED
name
CDATA #IMPLIED
optional (true | false) "false"
search-location (root | self | both)
"root"
os
CDATA #IMPLIED
arch
CDATA #IMPLIED
ws
CDATA #IMPLIED
nl
CDATA #IMPLIED
>
<!ELEMENT requires (import+)>
<!ELEMENT import EMPTY>
<!ATTLIST import
plugin
CDATA #IMPLIED
feature CDATA #IMPLIED
version
CDATA #IMPLIED
match
(perfect | equivalent | compatible | greaterOrEqual) "compatible"
patch (true |
false) "false"
>
<!ELEMENT plugin EMPTY>
<!ATTLIST plugin
id
CDATA #REQUIRED
version CDATA #REQUIRED
fragment (true
| false) "false"
os
CDATA #IMPLIED
arch
CDATA #IMPLIED
ws
CDATA #IMPLIED
nl
CDATA #IMPLIED
download-size CDATA #IMPLIED
install-size CDATA #IMPLIED
unpack (true |
false) "true"
>
<!ELEMENT data EMPTY>
<!ATTLIST data
id
CDATA #REQUIRED
os
CDATA #IMPLIED
arch
CDATA #IMPLIED
ws
CDATA #IMPLIED
nl
CDATA #IMPLIED
download-size CDATA #IMPLIED
install-size CDATA #IMPLIED
>
요소 및 속성 정의는 다음과 같습니다.
- <feature> - 기능을 정의합니다.
- id - 필수 기능 ID(예: com.xyz.myfeature)
- version - 필수 컴포넌트 버전(예: 1.0.3)
- label - 선택적 표시 가능 레이블(이름). 변환 가능함.
- provider-name - 이 컴포넌트의 제공자를 식별하는 선택적 표시 레이블. 변환 가능함.
- image - 기능에 대한 정보를 표시할 때 사용할 선택적 이미지.
feature.xml과 관련하여 지정됨.
- os - 선택적 운영 체제 스펙. Eclipse에서
정의한 쉼표로 구분된 운영 체제 지정자 목록입니다(org.eclipse.core.runtime.Platform에 대한
Javadoc 참조). 지정된 OS 시스템 중 하나에만 이 기능을 설치해야 함을
표시합니다. 이 속성이 지정되지 않은 경우 기능을 모든 시스템에
설치할 수 있습니다(휴대용 구현). 이 정보는 설치 및 갱신 지원에 의해 힌트로
사용됩니다(사용자는 이 설정과 관계 없이 기능 설치를 강제 실행할
수 있음).
- arch - 선택적 시스템 아키텍처 스펙. Eclipse에서
정의한 쉼표로 구분된 아키텍처 지정자 목록입니다.
org.eclipse.core.runtime.Platform은
Javadoc을 참조하십시오. 이 속성은 이 기능이 지정된 시스템 중 하나에서만 설치되어야 함을
표시합니다. 이 속성이 지정되지 않은 경우 기능을 모든 시스템에
설치할 수 있습니다(휴대용 구현). 이 정보는 설치 및 갱신 지원에 의해 힌트로
사용됩니다(사용자는 이 설정과 관계 없이 기능 설치를 강제 실행할
수 있음).
- ws - 선택적 윈도윙 시스템 스펙. Eclipse에서
정의한 쉼표로 구분된 윈도우 시스템 지정자 목록입니다(org.eclipse.core.runtime.Platform에 대한
Javadoc 참조). 지정된 WS 시스템 중 하나에만 이 기능을 설치해야 함을
표시합니다. 이 속성이 지정되지 않은 경우 기능을 모든 시스템에
설치할 수 있습니다(휴대용 구현). 이 정보는 설치 및 갱신 지원에 의해 힌트로
사용됩니다(사용자는 이 설정과 관계 없이 기능 설치를 강제 실행할
수 있음).
- nl - 선택적 로케일 스펙. Java에 의해 정의된 로케일 지정자의 쉼표로 구분된
목록. 이 기능이 호환 가능한 로케일로 실행되는 시스템에서만 설치되어야 함을
표시합니다(Java 로케일 일치 규칙 사용). 이 속성이 지정되지 않은 경우 기능을 모든 시스템에
설치할 수 있습니다(언어 중립적 구현). 이 정보는 설치 및 갱신 지원에 의해 힌트로
사용됩니다(사용자는 이 설정과 관계 없이 기능 설치를 강제 실행할
수 있음).
- colocation-affinity - 이 기능의 기본 설치 위치를 선택하는 데 사용된
다른 기능 ID에 대한 선택적 참조. 이 기능을 새 기능으로 설치할 때(다른
버전은 설치되지 않음) 참조된 기능과 동일한 설치 위치에 설치하려고
시도했습니다.
- primary - 이 기능을 기본 기능으로 사용 여부를 지정하는
선택적 표시. false인 경우
기본값입니다(기본 기능 아님).
- application - 선언 기능이 기본 기능인 경우 시작 시 사용할
Eclipse 응용프로그램의 선택적 ID. 응용프로그램 ID는 org.eclipse.core.runtime.applications 확장점에
등록된 올바른 응용프로그램을 표시해야 합니다. 기본값은 org.eclipse.ui.ide.workbench입니다.
- plugin - 기능의 브랜딩 정보(기본 기능의 경우
스플래시 화면, 변환, 이미지 등)를 제공할 때 사용되는 기능에
나열된 플러그인 ID를 표시하는 선택적 ID 입니다. 이
ID를 지정하지 않으면 속성 플러그인 ID가 해당
기능 ID와 동일하다고 가정합니다.
- exclusive - "true"인 경우 기능을 다른
기능과 함께 하나의 그룹에 설치할 수 없음을 표시하는
선택적 플래그입니다.
- <install-handler>
- library - 설치 핸들러 클래스를 포함하는 선택적 .jar 라이브러리.
지정된 경우, 참조된 .jar가 기능 아카이브에 포함되어야 합니다.
feature.xml 항목과 관련하여 기능 아카이브 내의 경로로
지정됩니다. 지정되지 않은 경우에는 기능 아카이브 자체가 설치 핸들러 클래스를
로드하는 데 사용됩니다. 이 속성은 class 속성이 지정되어 있는 경우에만
해석됩니다.
- handler - 설치 핸들러의 선택적 ID. 이 값은 library 속성 값에 따라
해석됩니다. library가 지정되면
이 값이 지정된 library에 있는 클래스의 완전한 이름으로
해석됩니다. library가 지정되지 않으면
이 값은 org.eclipse.update.installHandlers 확장점에 등록된 확장의
확장 ID로 해석됩니다. 두 가지 경우 모두 결과 클래스가
IInstallHandler 인터페이스를 구현해야
합니다. 기능 처리 중 클래스가 동적으로 로드되고 특정 지점에서
호출됩니다. 핸들러가 클래스로 지정되면 org.eclipse.update.core
플러그인 및 해당 플러그인에 필요한 Eclipse 플러그인에서
API 클래스를 볼 수 있습니다. 그렇지 않으면 확장으로
지정된 플러그인으로 모든 클래스에 액세스합니다.
- <description> - 간단한 텍스트로 된 간략한 컴포넌트 설명. 변환 가능함.
- url - HTML로서 전체 설명에 대한 선택적 URL. URL은 상대적 경로 또는 절대적 경로로
지정할 수 있습니다. 상대적인 경우 기능 아카이브에 상대적이고 기능 아카이브에서
패키지되는 것으로 가정합니다. NL 핸들링의 경우
각각의 자국어에 대해 대체 URL을 지정할 수 있도록 URL 값이 독립적이어야 합니다.
- <Copyright> - 간단한 텍스트로 된 기능 저작권. 변환 가능함.
- url - HTML로서 전체 설명에 대한 선택적 URL. URL은 상대적 경로 또는 절대적 경로로
지정할 수 있습니다. 상대적인 경우 기능 아카이브에 상대적이고 기능 아카이브에서
패키지되는 것으로 가정합니다. NL 핸들링의 경우
각각의 자국어에 대해 대체 URL을 지정할 수 있도록 URL 값이 독립적이어야 합니다.
- <license> - 간단한 텍스트로 된 기능 "click-through" 라이센스. 변환 가능함. 다운로드/설치 처리 중 [허용] [거부] 조치와 함께
표준 대화 상자에 표시됩니다. Eclipse Update Manager를 사용하는
설치 또는 갱신 시 선택되는 모든 기능에는 click-through 라이센스를
지정해야 합니다. 중첩된 기능을 사용하는 경우 중첩된
상위 기능(예: 설치 또는 갱신 시 선택된 기능)만
click-through 라이센스 텍스트를 정의해야 합니다. 라이센스 텍스트는 선택적 url 속성이 지정된 경우에도
필요합니다.
- url - HTML로서 전체 설명에 대한 선택적 URL. URL은 상대적 경로 또는 절대적 경로로
지정할 수 있습니다. 상대적인 경우 기능 아카이브에 상대적이고 기능 아카이브에서
패키지되는 것으로 가정합니다. NL 핸들링의 경우
각각의 자국어에 대체 URL을 지정할 수 있도록 URL 값이
독립적이어야 합니다. 이 URL의 "컨텐츠"는 설치 처리 중 click-through 라이센스로 표시된 사항이
아닙니다. click-through 라이센스는 <license> 요소의 실제 값입니다(예: <license>click
through text</license>).
- <url> - 기능 갱신사항 또는 새 기능이 포함된 사이트를 지정하는 선택적 URL
- <update> - 이 기능을 갱신하기 위해 이동할 대상 URL
- url - 실제 URL
- label - 참조 사이트에 대한 표시 가능 레이블(이름)
- <discovery> - 새 기능을 위해 이동할 대상 URL. 일반적으로 제공자는 이 요소를
사용하여 자체 사이트나 보충 기능을 제공하는 협력업체 사이트를 나타냅니다. Eclipse에서는
클라이언트에 새 사이트 URL을 분배하는 방법으로만 이 요소를 사용합니다. 루트 기능에 속하는
사이트(계층 구조의 맨 위에 있는)는 일반적으로 Update Manager에서
"방문할 사이트"에 나타납니다.
- url - 실제 URL
- label - 참조 사이트에 대한 표시 가능 레이블(이름)
- type(2.1의 새로운 기능) - 기본적으로 발견 사이트는 갱신 사이트("update")인 것으로
간주합니다. 이 속성의 값을 "web"으로 설정하여,
URL을 적절한 브라우저에 직접 표시할 수 있는 일반적인 웹 하이퍼링크로 처리해야 함을
Eclipse에 표시할 수 있습니다.
- <includes> - 이 기능의 일부로 간주되는 중첩된 기능에 대한
선택적 참조사항. 중첩된 기능은 이 기능과 동일한 갱신 사이트에
위치해야 합니다.
- id - 필수 중첩된 기능 ID입니다. 기능이 패치인 경우(아래의
<requires> 섹션 참조) 해당 ID는 다른 패치 ID여야 합니다.
- version - 필수 중첩된 기능 버전
- optiona - 이 속성이 "true"인 경우 선택적으로
기능을 포함할 수 있습니다. 사용자는 선택적 기능을 설치하지 않고, 기능이 설치된 경우 사용 안함으로 설정하며, 나중에 기능을 설치할 수 있습니다.
누락된 선택적 기능은 오류로 처리되지 않습니다.
- name - 선택적 기능이 누락된 경우, Eclipse는
이름을 올바르게 렌더링할 수 없습니다. 이 속성은 '위치 표시기' 사용하여 Eclipse가
설치되지 않은 선택적 기능의 이름을 표현할 수 있게 합니다.
- search-location - 포함된 기능은 패치를 통해 갱신될 수 있습니다.
기본적으로, 검색 위치는 "root"이며, 이는
상위 요소의 "url" 요소에서 "update" 요소에 지정한 URL이 고려된다는 것을
의미합니다. 포함된 기능에 고유한
"update" 요소가 정의된 경우, 기본적으로 그 기능은 제외됩니다.
상위 기능의 하위 요소가 고유한 위치로부터 갱신될 수 있도록 하려면,
이 속성을 "both" 또는 "self"로 설정하면 됩니다.
- os - 선택적 운영 체제 스펙. Eclipse에서
정의한 쉼표로 구분된 운영 체제 지정자 목록입니다(org.eclipse.core.runtime.Platform에 대한
Javadoc 참조). 지정된 OS 시스템 중 하나에만 이 항목을 설치해야 함을
표시합니다. 이 속성이 지정되지 않은 경우 항목을 모든 시스템에
설치할 수 있습니다(휴대용 구현). 이 정보는 설치 및 갱신 지원에 의해 힌트로
사용됩니다(사용자는 이 설정과 관계 없이 항목 설치를 강제 실행할
수 있음).
- arch - 선택적 시스템 아키텍처 스펙. Eclipse에서
정의한 쉼표로 구분된 아키텍처 지정자 목록입니다.
org.eclipse.core.runtime.Platform은
Javadoc을 참조하십시오. 이 속성은 이 기능이 지정된 시스템 중 하나에서만 설치되어야 함을
표시합니다. 이 속성이 지정되지 않은 경우 기능을 모든 시스템에
설치할 수 있습니다(휴대용 구현). 이 정보는 설치 및 갱신 지원에 의해 힌트로
사용됩니다(사용자는 이 설정과 관계 없이 기능 설치를 강제 실행할
수 있음).
- ws - 선택적 윈도윙 시스템 스펙. Eclipse에서
정의한 쉼표로 구분된 윈도우 시스템 지정자 목록입니다(org.eclipse.core.runtime.Platform에 대한
Javadoc 참조). 지정된 WS 시스템 중 하나에만 이 항목을 설치해야 함을
표시합니다. 이 속성이 지정되지 않은 경우 항목을 모든 시스템에
설치할 수 있습니다(휴대용 구현). 이 정보는 설치 및 갱신 지원에 의해 힌트로
사용됩니다(사용자는 이 설정과 관계 없이 항목 설치를 강제 실행할
수 있음).
- nl - 선택적 로케일 스펙. Java에 의해 정의된 로케일 지정자의 쉼표로 구분된
목록. 이 항목이 호환 가능한 로케일로 실행되는 시스템에서만 설치되어야 함을
표시합니다(Java 로케일 일치 규칙 사용). 이 속성이 지정되지 않은 경우 항목을 모든 시스템에
설치할 수 있습니다(언어 중립적 구현). 이 정보는 설치 및 갱신 지원에 의해 힌트로
사용됩니다(사용자는 이 설정과 관계 없이 항목 설치를 강제 실행할
수 있음).
- <requires> - 선택적 기능 종속성 정보. 플러그인 종속성의
용어로 표시됩니다. 지정된 경우 설치 시 설치 및 갱신 지원에 의해
실행됩니다.
- <import> - 종속성 항목. 스펙 및 처리는 plugin.xml에 있는
<import> 스펙의 서브세트입니다.
- plugin - 종속성을 표현하는 데 플러그인을 사용할 경우 종속 플러그인의 ID.
- feature(2.1의 새로운 기능) - 종속성을 표현하는 데 기능을 사용할 경우 종속 기능의 ID. plugin이나 feature 속성 중 하나를 설정해야 하며, 둘 다 설정해서는 안됩니다. "patch"가 "true"이면, feature 속성을 사용해야 합니다.
- 버전 - 선택적 플러그인 버전 스펙. "patch"가
"true"일 경우 버전을 설정해야 합니다.
- match - 선택적 일치 규칙. 올바른 값 및 처리는 다음과 같습니다.
- 버전 속성이 지정되지 않은 경우 일치 속성(지정된 경우)이
무시됩니다.
- perfect - 종속적 플러그인 버전은 지정된 버전과 정확히
일치해야 합니다. "patch"가 "true"일 경우, "perfect"로 간주되고
다른 값은 설정할 수 없습니다.
- equivalent - 종속적 플러그인 버전은 최소한 지정된 버전 또는
그 이상의 서비스 레벨이어야 합니다(주 버전 레벨 및 부 버전 레벨은 지정된 버전과 동일해야 함).
- compatible - 종속적 플러그인 버전은 최소한 지정된 버전 또는
그 이상의 서비스 레벨이나 부 버전 레벨이어야 합니다(주 버전 레벨은 지정된 버전과 동일해야 함).
- greaterOrEqual - 종속적 플러그인 버전은 최소한 지정된 버전 또는
그 이상의 서비스 레벨이나 부 버전 레벨 또는 주 버전 레벨이어야 합니다.
- patch - "true"인 경우, 이 제한조건은
엔클로징 기능이 참조된 기능의 패치가 되도록 선언합니다. 이 속성을 설정할 경우
다음의 특정 규칙을 따라야 합니다.
- feature 속성을 패치 중인 기능 ID에서 사용해야 합니다.
- version 속성을 설정해야 합니다.
- match 속성을 설정하지 않아야 하고 "perfect" 값이 간주됩니다.
- 기타 기능이 <포함>된 경우 이 기능도 패치입니다.
패치는 패치 중인 기능의 새 버전을 제공하는 특수
기능입니다. 이 때 기능을 바꾸지는 않습니다. 또한
패치는 기타 패치를 포함하여 제공할 수 있습니다.
- <plugin> - 참조된 플러그인을 식별합니다.
- id - 필수 플러그인 ID(plugin.xml에서)
- version - 필수 플러그인 버전(plugin.xml에서)
- fragment - 이 항목이 플러그인 단편인지 표시하는 선택적 스펙. 기본값은 "false"입니다.
- os - 선택적 운영 체제 스펙. Eclipse에서
정의한 쉼표로 구분된 운영 체제 지정자 목록입니다(org.eclipse.core.runtime.Platform에 대한
Javadoc 참조). 이 속성은 이 항목이 지정된 OS 시스템 중 하나에서만 설치되어야 함을 표시합니다. 이 속성이 지정되지 않은 경우 항목을 모든 시스템에
설치할 수 있습니다(휴대용 구현). 이 정보는 설치 및 갱신 지원에 의해 힌트로
사용됩니다(사용자는 이 설정과 관계 없이 항목 설치를 강제 실행할
수 있음).
- arch - 선택적 시스템 아키텍처 스펙. Eclipse에서
정의한 쉼표로 구분된 아키텍처 지정자 목록입니다.
org.eclipse.core.runtime.Platform은
Javadoc을 참조하십시오. 이 속성은 이 기능이 지정된 시스템 중 하나에서만 설치되어야 함을
표시합니다. 이 속성이 지정되지 않은 경우 기능을 모든 시스템에
설치할 수 있습니다(휴대용 구현). 이 정보는 설치 및 갱신 지원에 의해 힌트로
사용됩니다(사용자는 이 설정과 관계 없이 기능 설치를 강제 실행할
수 있음).
- ws - 선택적 윈도윙 시스템 스펙. Eclipse에서
정의한 쉼표로 구분된 윈도우 시스템 지정자 목록입니다(org.eclipse.core.runtime.Platform에 대한
Javadoc 참조). 지정된 WS 시스템 중 하나에만 이 항목을 설치해야 함을
표시합니다. 이 속성이 지정되지 않은 경우 항목을 모든 시스템에
설치할 수 있습니다(휴대용 구현). 이 정보는 설치 및 갱신 지원에 의해 힌트로
사용됩니다(사용자는 이 설정과 관계 없이 항목 설치를 강제 실행할
수 있음).
- nl - 선택적 로케일 스펙. Java에 의해 정의된 로케일 지정자의 쉼표로 구분된
목록. 이 항목이 호환 가능한 로케일로 실행되는 시스템에서만 설치되어야 함을
표시합니다(Java 로케일 일치 규칙 사용). 이 속성이 지정되지 않은 경우 항목을 모든 시스템에
설치할 수 있습니다(언어 중립적 구현). 이 정보는 설치 및 갱신 지원에 의해 힌트로
사용됩니다(사용자는 이 설정과 관계 없이 항목 설치를 강제 실행할
수 있음).
- download-size - 기능 패키저에 의해 제공된 선택적 힌트로서 참조된 플러그인 아카이브의
다운로드 크기를 KB로 표시합니다. 지정되지 않은 경우
다운로드 크기를 알 수 없습니다(구현 시 참고 사항: 구현 시에는
"알 수 없음"과 0 크기 사이를 구별해야 합니다).
- install-size - 기능 패키저에 의해 제공된 선택적 힌트로서 참조된 플러그인 아카이브의
설치 크기를 KB로 표시합니다. 지정되지 않은 경우
설치 크기를 알 수 없습니다(구현 시 참고 사항: 구현 시에는
"알 수 없음"과 0 크기 사이를 구별해야 합니다).
- unpack(3.0의 새 기능) - 기능 패키저에서 제공하는 선택적
스팩으로 플러그인이 jar에서 실행 가능하고 jar 플러그인의
컨텐츠가 디렉토리에 압축 해제해서는 안됨을 표시합니다. 기본값은 "true"입니다.
구현 시 참고 사항: partial plug-ins - 설치
핸들러에서 압축 해제를 "false"로 설정할 수
없으므로 org.eclipse.update.core.DeltaInstallHandler를
지정하는 기능에서 제공됩니다.
- <data> - 기능의 일부인 비플러그인 데이터를 식별합니다.
- id - 상대적 경로 양식의 필수 데이터 ID.
- os - 선택적 운영 체제 스펙. Eclipse에서
정의한 쉼표로 구분된 운영 체제 지정자 목록입니다(org.eclipse.core.runtime.Platform에 대한
Javadoc 참조). 지정된 OS 시스템 중 하나에만 이 항목을 설치해야 함을
표시합니다. 이 속성이 지정되지 않은 경우 항목을 모든 시스템에
설치할 수 있습니다(휴대용 구현). 이 정보는 설치 및 갱신 지원에 의해 힌트로
사용됩니다(사용자는 이 설정과 관계 없이 항목 설치를 강제 실행할
수 있음).
- arch - 선택적 시스템 아키텍처 스펙. Eclipse에서
정의한 쉼표로 구분된 아키텍처 지정자 목록입니다.
org.eclipse.core.runtime.Platform은
Javadoc을 참조하십시오. 이 속성은 이 기능이 지정된 시스템 중 하나에서만 설치되어야 함을
표시합니다. 이 속성이 지정되지 않은 경우 기능을 모든 시스템에
설치할 수 있습니다(휴대용 구현). 이 정보는 설치 및 갱신 지원에 의해 힌트로
사용됩니다(사용자는 이 설정과 관계 없이 기능 설치를 강제 실행할
수 있음).
- ws - 선택적 윈도윙 시스템 스펙. Eclipse에서
정의한 쉼표로 구분된 윈도우 시스템 지정자 목록입니다(org.eclipse.core.runtime.Platform에 대한
Javadoc 참조). 지정된 WS 시스템 중 하나에만 이 항목을 설치해야 함을
표시합니다. 이 속성이 지정되지 않은 경우, 항목을 모든 시스템에
설치할 수 있습니다(휴대용 구현). 이 정보는 설치 및 갱신 지원에 의해 힌트로
사용됩니다(사용자는 이 설정과 관계 없이 항목 설치를 강제 실행할
수 있음).
- nl - 선택적 로케일 스펙. Java에 의해 정의된 로케일 지정자의 쉼표로 구분된
목록. 이 항목이 호환 가능한 로케일로 실행되는 시스템에서만 설치되어야 함을
표시합니다(Java 로케일 일치 규칙 사용). 이 속성이 지정되지 않은 경우 항목을 모든 시스템에
설치할 수 있습니다(언어 중립적 구현). 이 정보는 설치 및 갱신 지원에 의해 힌트로
사용됩니다(사용자는 이 설정과 관계 없이 항목 설치를 강제 실행할
수 있음).
- download-size - 기능 패키저에 의해 제공된 선택적 힌트로서 참조된 데이터 아카이브의
다운로드 크기를 KB로 표시합니다. 지정되지 않은 경우
다운로드 크기를 알 수 없습니다(구현 시 참고 사항: 구현 시에는
"알 수 없음"과 0 크기 사이를 구별해야 합니다).
- install-size - 기능 패키저에 의해 제공된 선택적 힌트로서 참조된 데이터 아카이브의
설치 크기를 KB로 표시합니다. 지정되지 않은 경우
설치 크기를 알 수 없습니다(구현 시 참고 사항: 구현 시에는
"알 수 없음"과 0 크기 사이를 구별해야 합니다).
갱신 사이트와 상호작용할 때 이 기능 구현으로 <plugin>
및 <data> 요소가 이 사이트에서 사용된 경로 ID에 맵핑되어
다운로드 및 설치할 실제 파일을 판별합니다. Eclipse에서 제공한 기본 기능 구현은
다음과 같이 경로 ID를 구성합니다.
-
<plugin> 요소의 결과는 "plugins/<pluginId>_<pluginVersion>.jar" 양식으로 된 경로
항목입니다(예: "plugins/org.eclipse.core.boot_2.0.0.jar").
-
<data> 요소의 결과는 "features/<featureId>_<featureVersion>/<dataId>" 양식으로 된 경로
항목입니다(예: "features/com.xyz.tools_1.0.3/examples.zip").
일반적으로 feature.xml Manifest 문서는
UTF-8 인코딩을 지정해야 합니다. 예를 들면 다음과 같습니다.
<?xml version="1.0" encoding="UTF-8"?>
feature.xml에 포함된 변환 가능 텍스트는 Java 특성 번들 규칙을 사용하는
feature<_locale>.properties 파일로 분리될 수 있습니다.
변환된 문자열이 설치 시 사용된다는 점에 유의하십시오.
즉, 플러그인 단편 런타임 메커니즘을 사용하지 마십시오.