Windows 8 应用包清单架构
此参考提供每个元素、属性和数据类型的详细信息,用于定义 UWP 应用的应用程序包清单的架构。 架构定义文件为 AppxManifestSchema。
下表列出了此架构中的所有元素,并按名称的字母顺序排序。
元素 | 说明 |
---|---|
ActivatableClass (类型: CT_InProcessActivatableClass) | 声明与扩展点相关联的运行时类。 |
ActivatableClass (类型: CT_OutOfProcessActivatableClass) | 声明与扩展点相关联的运行时类。 |
ActivatableClassAttribute | 定义存储在 Windows 运行时属性存储中的类的属性。 |
应用程序 | 表示一个应用,该应用包含包中的部分或所有功能。 |
ApplicationContentUriRules | 如果应用有权访问此功能) 和访问剪贴板,则指定 web 上下文中的哪些页面有权访问系统的地理位置设备 (。 |
应用程序 | 表示构成包的一个或多个应用。 |
参数 | 指定要传递到可执行文件的以逗号分隔的参数列表。 |
AutoPlayContent | 声明 autoPlayContent类型的应用可扩展性点。 应用提供指定的自动播放内容操作。 |
AutoPlayDevice | 声明 autoPlayDevice类型的应用可扩展性点。 应用提供指定的自动播放设备操作。 |
BackgroundTasks | 定义 backgroundTasks类型的应用可扩展性点。 后台任务在专用的后台主机上运行;也就是说,无需用户界面。 |
功能 | 声明对包所需的受保护用户资源的访问权限。 |
功能 | 声明包所需的功能。 |
证书 | 用于包并放置在系统证书存储区中的证书。 |
Certificates | 声明类型为 windows 证书的包扩展点。 应用需要指定的证书存储中的一个或多个证书。 |
DataFormat | 指定应用可共享的数据包格式,如文本或 HTML 格式。 它对于包中的每个应用程序都是唯一的,并区分大小写。 |
DefaultTile | 在 "开始" 屏幕上表示应用的默认磁贴。 第一次安装应用程序时,会显示此磁贴,然后再接收任何更新通知。 如果磁贴没有要显示的通知,磁贴会恢复为此默认值。 |
依赖项 | 声明包依赖于完成其软件的其他包。 |
说明 | 可向用户显示的友好说明。 |
DeviceCapability | 声明包所需的设备功能。 |
DisplayName | 可向用户显示的友好名称。 |
EditFlags | 指定在打开与扩展点关联的文件时用户看到的信息类型。 |
类型中的扩展 (: CT_ApplicationExtensions) | 声明应用的扩展点。 |
类型中的扩展 (: CT_PackageExtensions) | 声明包的扩展点。 |
扩展 (类型: CT_ApplicationExtensions) | 定义应用程序的一个或多个扩展点。 |
扩展 (类型: CT_PackageExtensions) | 定义包的一个或多个扩展点。 |
FileOpenPicker | 声明 fileOpenPicker类型的应用可扩展性点。 应用使用户可以选择并打开指定类型的文件。 |
FileSavePicker | 声明 fileSavePicker类型的应用可扩展性点。 应用允许用户为指定的文件类型选择文件名、扩展名和存储位置。 |
类型中的类型 (: CT_FTASupportedFileTypes) | 指定为其文件类型扩展名的受支持的文件类型。 |
类型类型 (类型: ST_FileType) | 指定为其文件类型扩展名的文件类型。 它对于包中的每个应用程序都是唯一的,并区分大小写。 |
FileTypeAssociation | 声明 fileTypeAssociation类型的应用可扩展性点。 文件类型关联指示已注册应用程序以处理指定类型的文件。 |
框架 | 指示包是否为框架包;即,其他包可以使用的包。 默认情况下,其值为 false 。 除非要创建框架,否则不应为其指定值。 |
GameExplorer | 声明 gameExplorer类型的包扩展点。 |
标识 | 定义包的全局唯一标识符。 包标识表示为包的特性元组。 |
InProcessServer | 声明类型为 activatableClass. inProcessServer的包扩展点。 应用使用动态链接库 (DLL) 公开一个或多个可激活的类。 |
提示 | 定义一个字符串,该字符串向用户提供有关文件类型的其他信息。 |
InitialRotationPreference | 描述应用希望为获得最佳用户体验而显示的方向。 在可以旋转的设备上(如平板电脑),将不会为此处未指定的方向重绘应用。 例如,如果应用仅指定横向和 LandscapeFlipped 方向,并且设备旋转到纵向方向,则应用将不会旋转。 请注意,在无法旋转的设备上,应用程序可能会显示在该设备的默认方向上,并且将忽略应用程序的首选方向。 但是,在激活旋转锁定的设备上,应用的首选旋转仍会生效。 当为应用启动新会话时,这些方向首选项 (element-splashscreen.md) [初始屏幕]应用和应用 UI。 可以通过 [AutoRotationPreferences] (/uwp/api/WindowsGraphics.Display.DisplayProperties) 属性。 |
实例化 | 指定可执行文件是作为单个实例运行,还是可以作为多个实例运行。 |
Interface | 声明与代理关联的接口。 |
LaunchAction (类型:CT_AutoPlayContent) | 描述 AutoPlay 内容操作。 |
LaunchAction (类型:CT_AutoPlayDevice) | 描述 AutoPlay 设备操作。 |
LockScreen | 定义锁屏界面上表示应用的锁屏提醒和通知,锁定系统时会显示这些锁屏提醒和通知。 |
徽标 | 包含图像的文件的路径。 |
OSMaxVersionTested | 这应该由开发人员使用测试包Windows版本进行填充。 此字段为必需字段。 Windows不会阻止在高于此字段中提供的值的操作系统版本上安装包。 执行应用时,Windows将此字段与实际 OS 版本进行比较。 如果此字段中提供的值小于当前 OS 版本,Windows可能会为某些或所有 API 提供与经过最高测试的 OS 版本兼容的行为。 如果此字段中提供的值大于或等于当前 OS 版本,Windows不会对 API 应用任何兼容性更改。 |
OSMinVersion | 包所需的操作系统的最低版本。 |
OutOfProcessServer | 声明 windows.activatableClass.outOfProcessServer 类型的包扩展点。 应用使用可执行 (EXE) 公开一个或多个可激活类。 |
包 | 定义应用包清单的根元素。 清单描述了软件的结构和功能。 |
PackageDependency | 声明另一个标记为框架包的包的依赖项。 |
路径 (类型:ST_Executable) | 可执行文件的路径。 |
路径 (类型:ST_FileName) | DLL 的路径。 |
先决条件 | 声明包必须满足的最低操作系统和软件要求,以适用于系统。 |
属性 | 定义有关包的其他元数据,包括描述包如何向用户显示的属性。
注意如果清单元素 DisplayName 或 Description 包含 Windows 防火墙不允许的字符(即"|"和"all",则可能会收到错误,因为 Windows 无法为包 创建 AppContainer 配置文件。 如果收到错误,请使用此参考 (/windows/win32/appxpkg/troubleshooting) 。)
|
协议 | 声明 windows.protocol 类型的应用扩展点。 URI 关联指示应用已注册以处理具有指定方案的 URI。 |
ProxyStub | 声明 windows.activatableClass.proxyStub 类型的包扩展点。 代理可以由一个或多个接口组成。 |
PublisherDisplayName | 发布者的友好名称,可显示给用户。 |
资源 | 声明包中包含的资源的语言。 |
资源 | 声明包包含的资源的语言。 每个包都必须为资源声明至少一种语言。 |
旋转 | 指定应用将在其中显示的单个旋转方向。 |
规则 | 指定 Web 上下文中哪些页面有权访问系统的地理位置设备 (如果应用有权访问此功能,) 访问剪贴板。 |
SelectionCriteria | 定义为包定义的证书的选择条件。 |
ShareTarget | 声明 windows.shareTarget 类型的应用扩展点。 应用可以共享指定类型的文件。 |
SplashScreen | 定义初始屏幕的外观,该屏幕在启动期间由应用显示。 |
SupportedFileTypes (类型:CT_CharmsSupportedFileTypes) | 定义应用可以共享的文件类型。 |
SupportedFileTypes (类型:CT_FTASupportedFileTypes) | 定义与应用关联的文件类型。 它们每个包都是唯一的,并且区分大小写。 |
SupportsAnyFileType | 指示是否支持共享所有文件类型。 |
任务 | 与应用扩展点关联的后台任务。 |
TrustFlags | 指示包的证书是否专用于包。 |
VisualElements | 描述 UWP 应用的视觉方面:其默认磁贴、徽标图像、文本和背景颜色、初始屏幕方向、初始屏幕和锁屏磁贴外观。 |