每個 PackageContents.xml 檔案必須包含一個 ApplicationPackage 元素。ApplicationPackage 元素 (XML 屬性形式) 包含與外掛程式相關的一般資訊。此檔案也壓縮能協助定義外掛程式內容的其他元素類型。
ApplicationPackage 元素可以貼附下列任何屬性:
屬性 |
描述 |
---|---|
SchemaVersion |
PackageContents.xml 格式版本號碼。此值一律為 1.0,直到引入架構的新版本為止。 |
AppVersion |
應用程式版本號碼。AutoCAD 系列產品使用此值來判斷安裝的版本是否為最新版本。如果有更新版本可用,使用者會收到通知,並且能夠下載和安裝最新版本。建議使用包含主要和次要值的應用程式版本,如 1.0.0.0。 |
Author |
應用程式作者的名稱。 |
Name |
外掛程式名稱。 您可將 Name 與區域設定代碼結合,指定本土化的外掛程式名稱。請參閱〈支援的區域設定程式碼參考〉取得支援的區域設定程式碼完整清單。 |
Description |
外掛程式的簡短描述。 您可以將 Description 與地區設定代碼結合,指定本土化的描述。請參閱〈支援的區域設定程式碼參考〉取得支援的區域設定程式碼完整清單。 |
Icon |
外掛程式的圖示;用於安裝程式和 Autodesk App Store 網站。圖示大小應為 32x32 像素,並且支援 32 位元 (全彩) 顏色深度。建議使用 BMP 或 ICO 檔案格式。 註: 所有檔案指定元皆為 '/' 而非 '\',並且為相對於 .bundle 根資料夾的路徑。
|
HelpFile |
說明檔會說明如何使用外掛程式,並提供與外掛程式相關的其他資訊。 建議建立一個說明如何使用外掛程式的「使用方法」區段。此檔案可以是 ASCII 文字檔、HTML 文件或 PDF 檔,這些檔案含有外掛程式的完整文件,或是含有一組轉接至內容線上位置的重新導向。 您可以將 Helpfile 與地區設定代碼結合,指定本土化的說明檔。請參閱〈支援的區域設定程式碼參考〉取得支援的區域設定程式碼完整清單。 註: 所有檔案指定元皆為 '/' 而非 '\',並且為相對於 .bundle 根資料夾的路徑。
|
ProductCode |
外掛程式的唯一 GUID。每個唯一的外掛程式都必須產生 GUID,並且在第一次執行通知時使用,當從 Autodesk App Store 網站進行安裝時,GUID 可做為 Windows 中「新增/移除程式」的安裝程式 ID。 若 AppVersion 已改變,則應更新 ProductCode。這樣更新安裝才能正常運作,並且外掛程式在載入 AutoCAD 系列產品時,系統會顯示通知。 在 Windows 中,您可以使用 MSI 安裝程式 ProductCode,或使用應用程式 (GuidGen.exe) 來產生 GUID。您也可以透過某些網站來產生 GUID。 |
UpgradeCode |
外掛程式的唯一 GUID 不可變更。GUID 是供 Autodesk App Store 網站使用,能在無需先解除安裝外掛程式的情況下,讓舊版的外掛程式升級為新版。 註: 您必須將 AppVersion 增量才能允許外掛程式適當升級。
|
ApplicationPackage 元素可包含或壓縮下列元素: