針對新功能或協力廠商 Eclipse 功能自訂 Notes® 安裝資訊清單

如果您已建立或另行取得自訂或協力廠商 Eclipse 功能，來新增至 Notes® 安裝，您必須使用與描述檔中其他功能 (installfeature) 相同的慣例，在 Notes® 安裝資訊清單 (install.xml) 中建立功能 (installfeature)。

您也必須將新功能或協力廠商功能適當地新增至安裝套件中。

注意：所有功能必須正確簽署，才能安裝成為 Notes® 安裝或升級的一部分。

如需簽署的相關資訊，請參閱相關主題。

Notes® 安裝資訊清單「文件類型定義 (DTD)」與標準 Eclipse 或 Expeditor 安裝或供應資訊清單 DTD 不同。例如，Notes® 安裝資訊清單至少包含四個唯一的屬性：「required」、「default」、「show」及「description」。

如需供應的相關資訊，請參閱相關主題。

installfeature 元素

決定「installfeature」名稱是否出現在 Notes® 功能安裝畫面上的屬性為「default」、「required」及「show」。

下面清單說明每個 "installfeature" 元素的必要屬性：

default：指定 "installfeature" 名稱是否在安裝時顯示為已選取。如果設為 true，則 "installfeature" 名稱在功能安裝畫面上會顯示為已選取。如果設為 false，則 "installfeature" 名稱在功能安裝畫面上不會顯示為已選取。
註：重新執行安裝程式時，會略過 "default" 屬性，在升級時也會略過此屬性，除非 "installfeature" 已不存在於先前安裝的提供項目中。如此可以使安裝程式顯示可於先前安裝程式取得之 "installfeature" 的狀態（已安裝或未安裝）。
id：指定要安裝之功能的唯一 ID。目前不會對 ID 欄位唯一性進行驗證檢查。
名稱：指定「installfeature」名稱，它將出現在 Notes® 功能安裝畫面上。
required：指定是否必須安裝 "installfeature"。如果設為 true，則安裝功能。如果設為 false，而 show 設為 true，則該功能名稱會出現在 Notes® 功能安裝畫面上，而且使用者可選取該選項。
show：指定「installfeature」名稱是否出現在 Notes® 功能安裝畫面上。如果設為 true，則使用者可以看見 "installfeature" 名稱。如果設為 false，則看不見 "installfeature" 名稱。
version：指定安裝版本 "installfeature" 的數值字尾。

功能元素

下面清單說明每個 "feature" 元素的必要屬性：

download size：指定安裝此功能所需的暫時磁碟空間。
id：指定唯一 ID，以識別此特定功能並為該功能比對 features.xml 中所使用的 ID 命名慣例。
match：指定版本屬性值上的功能動作相依關係，並用來指定所需的比對規則。
註：版本值包括四部分：major.minor.service.qualifier.
選項是：
- GreaterOrEqual：版本所有部分均必須大於零。相依版本必須至少符合指定的版本，或在較高的 service、minor 或 major 層次。
- compatible：Major 必須相符，而其他部分必須大於或等於。相依外掛程式版本必須至少符合指定的版本，或在較高的 service 層次或 minor 層次（major 版本層次必須等於指定版本）。
- equivalent：Major 及 minor 必須相符，且必須大於或等於後面的部分（例如 service.qualifier）。相依版本必須至少符合指定的版本，或在較高的 service 層次 (major 及 minor 版本層次必須等於指定版本)。
- perfect：所有版本部分必須相符。相依版本必須完全符合指定版本。
  例如，唯有當更新網站及 site.xml 檔案中的版本值為 3.0.0 時，才容許安裝下列屬性。
  version="version="3.0.0" match="perfect"
size：指定安裝此功能所需的磁碟空間。
url：指定安裝及初始供應期間，取得 "installfeature" 的來源位置。
version：指定要安裝並供應的功能版本。
這是要安裝之功能相關的三或四部分值。決定是否要安裝功能時，它與 "match" 值具有相依關係。當決定是否更新已安裝的功能時，它與 "match" 值也具有未來相依關係。
版本屬性保留這些主要值：major.minor.service release.qualifier。以下範例顯示具有 "20100309-1700" 限定元的版本 3.0.0，代表已命名建置或其他限定元值：
```
version="3.0.0.20100300-1700"
```

自訂或協力廠商功能的範例功能

下列為範例自訂功能。

<installfeature default="false" id="ISVExample1" name="YourToolA" required="false" show="true" version "3.0.0.20100309-1700">

                                      <requirements>

			<feature

download-size="72457"id="com.abx.yourtoolabxz.tools.feature" match="perfect" size="227855" url="${installer.root}/updateSite.zip"version="3.0.0.20100309-1700"/>