ApplicationPackage 元素參考

每個 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 元素可包含或壓縮下列元素: