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 应用的视觉方面:其默认磁贴、徽标图像、文本和背景颜色、初始屏幕方向、初始屏幕和锁屏磁贴外观。