ApplicationPackage 元素参考

每个 PackageContents.xml 文件都必须包含一个 ApplicationPackage 元素。形式为 XML 属性的 ApplicationPackage 元素包含关于插件的常规信息。还包含其他元素类型,用以帮助定义插件的内容。

ApplicationPackage 元素可以有以下任一附着属性:

属性

说明

模式版本

PackageContents.xml 格式版本号。该值应始终为 1.0,直到引入更新版本的模式。

应用程序版本

应用程序版本号。基于 AutoCAD 的产品使用此值来确定安装的版本是否为最新版本。如果有更新的版本可用,用户会收到通知,并能够下载和安装最新的版本。建议使用包括主值和次值的应用程序版本,例如“1.0.0.0”。

作者

插件作者的名字。

名称

插件名称。

本地化的插件名称可以通过将“名称”与区域设置代码组合在一起来指定。请参见“支持的区域设置代码参考”,以获取支持的区域设置代码的完整列表。

说明

插件的简短说明。

本地化的说明可以通过将“说明”与区域设置代码组合在一起来指定。请参见“支持的区域设置代码参考”,以获取支持的区域设置代码的完整列表。

图标

插件的图标;用于安装程序和 Autodesk App Store 网站。图标大小应为 32x32 像素并支持 32 位(真彩色)颜色深度。建议使用 BMP 或 ICO 文件格式。

注: 所有路径指定符为“/”和“\”,路径相对于根 .bundle 文件夹。

帮助文件

帮助文件,其中介绍了如何使用插件,并提供了有关插件的附加信息。

建议创建介绍如何使用插件的“如何”部分。文件可以是 ASCII 文本、HTML 文档或 PDF 文件,它包含插件的完整文档或包含一组重定向(指向内容可能所在的联机位置)。

本地化的帮助文件可以通过将“帮助文件”与区域设置代码组合在一起来指定。请参见“支持的区域设置代码参考”,以获取支持的区域设置代码的完整列表。

注: 所有路径指定符为“/”和“\”,路径相对于根 .bundle 文件夹。

产品代码

插件的唯一 GUID。必须为每个唯一插件生成 GUID,用于第一次运行通知,以及在从 Autodesk App Store 网站安装时作为 Windows 中“添加/删除程序”的安装程序 ID。

如果 AppVersion 发生了更改,则应更新 ProductCode。这样,升级安装才可以正常工作,并且在加载到基于 AutoCAD 的产品时会显示需要进行升级的通知。

在 Windows 中,您可以使用 MSI 安装程序 ProductCode 或使用诸如 GuidGen.exe 的应用程序生成 GUID。还有一些网站也可以使用户生成 GUID。

UpgradeCode

插件的唯一 GUID,永远不会被更改。Autodesk App Store 网站使用 GUID 实现从插件的旧版本升级到较新版本,而无需先卸载插件。

注: AppVersion 必须为增量值,才能允许用户进行适当的插件升级。

ApplicationPackage 元素可以包含或封装以下元素: