应用程序的 (包架构Windows 8)

项目
07/20/2023

表示一个应用，该应用包含包中提供的一部分或所有功能。

元素层次结构

<应用程序>: <应用程序>

语法

<Application Id          = An ASCII string between 1 and 64 characters in length. See the Attributes table for more information on character restrictions.
             Executable? = A string between 1 and 256 characters in length that must end with ".exe" and cannot contain these characters: <, >, :, %, ", |, ?, or *. It specifies the default executable for the extension. If not specified, the executable defined for the app is used.  If specified, the EntryPoint property is also used. If that EntryPoint property isn't specified, the EntryPoint defined for the app is used.
             EntryPoint? = A string between 1 and 256 characters in length, representing the task  handling the extension. This is normally the fully namespace-qualified name of a Windows Runtime type.
If EntryPoint is not specified, the EntryPoint defined for the app is used instead.

             StartPage?  = A string between 1 and 256 characters in length that cannot contain these characters: <, >, :, %, ", |, ?, or *. >

  <!-- Child elements -->
  ( VisualElements
  & ApplicationContentUriRules?
  & Extensions?
  )

</Application>

键

? 可选 (零个或一)

& 交错连接器 (可能按任何顺序)

特性和元素

特性

属性	说明	数据类型	必须
EntryPoint	可激活类 ID，例如""Office。Winword.Class"。对于桌面应用，此值应为可执行文件的实际入口点，例如"main"、"WinMain"或"wWinMain"。如果指定此属性，则还必须指定 Executable 属性。如果指定此属性，则不得指定 StartPage 属性。	长度介于 1 到 256 个字符之间的字符串，表示处理扩展的任务。这通常是 Windows 运行时类型的完全命名空间限定名称。如果未指定 EntryPoint，则改为使用为应用定义的 EntryPoint。	否
可执行文件	应用的默认启动可执行文件。此文件必须存在于包中。如果指定此属性，则必须指定 EntryPoint 属性。如果指定此属性，则不得指定 StartPage 属性。	长度介于 1 到 256 个字符之间的字符串，必须以".exe"结尾，并且不能包含以下字符：<>、、：、%"、"、\|、？或 *。它指定扩展的默认可执行文件。如果未指定，则使用为应用定义的可执行文件。如果指定，则还使用 EntryPoint 属性。如果未指定 EntryPoint 属性，则使用为应用定义的 EntryPoint。	否
Id	包中应用程序的唯一标识符。此值有时称作“包相对应用标识符”(PRAID)。 ID 在包中是唯一的，但不是全局的。系统中可以有另一个包使用相同的 ID。同一个包中不能多次使用同一 ID。此字符串包含句点分隔的字母数字字段。每个字段必须以 ASCII 字母字符开头。不能将这些值用作字段值："CON"、"PRN"、"AUX"、 "NUL"、"COM1"、"COM2"、"COM3"、"COM4"、"COM5"、"COM6"、"COM7"、"COM8"、"COM9"、"LPT1"、"LPT2"、"LPT3"、"LPT4"、"LPT5"、"LPT6"、"LPT7"、"LPT8"和"LPT9"。使用 Visual Studio模板时，此属性的默认值为"App"。开发人员应在清单中手动更改此设置。应用发布到应用后，不应更改应用的标识符Microsoft Store这样做会中断磁贴在磁贴上“开始”屏幕。	长度介于 1 到 64 个字符之间的 ASCII 字符串。	是
StartPage	应用的默认启动 HTML 页。此文件必须存在于包中。如果指定此属性，则不能指定 EntryPoint 属性或 Executable 属性。	长度介于 1 到 256 个字符之间的字符串，不能包含以下字符：<>、、：、%、"、"\|、？或 *。	否

子元素

子元素	说明
ApplicationContentUriRules	指定 Web 上下文中哪些页面有权访问系统的地理位置设备 (如果应用有权访问此功能，) 访问剪贴板。
扩展 (类型：CT_ApplicationExtensions)	定义应用的一个或多个扩展点。
VisualElements	描述 UWP 应用的视觉方面：其默认磁贴、徽标图像、文本和背景颜色、初始屏幕方向、初始屏幕和锁屏磁贴外观。

父元素

父元素	说明
应用程序	表示组成包的一个或多个应用。

备注

Application 元素包含与应用相关的扩展点通用的属性。其他扩展点使用此信息获取有关应用的信息。此外，应用程序属性用于应用实例的启动和管理。

如果指定了 StartPage 属性，则它是使用 JavaScript Windows应用。如果未指定 StartPage，则必须同时指定 Executable 和 EntryPoint 属性，并且它是使用 C# 或 VB XAML 的 UWP 应用。

示例

以下示例取自其中一个 SDK 示例的包清单。

                    
<Applications>
  <Application Id="App" StartPage="default.html">

    <VisualElements DisplayName="Assocation launching sample" 
         Logo="images\squareTile-sdk.png" SmallLogo="images\smallTile-sdk.png" 
         Description="SDK sample" 
         ForegroundText="dark" BackgroundColor="#FFFFFF" ToastCapable="false">
      <DefaultTile ShowName="allLogos" />
      <SplashScreen BackgroundColor="white" Image="images\splash-sdk.png" />
    </VisualElements>

    <Extensions>
      <Extension Category="windows.fileTypeAssociation">
        <FileTypeAssociation Name=".alsdkjs">
          <SupportedFileTypes>
            <FileType>.alsdkjs</FileType>
          </SupportedFileTypes>
        </FileTypeAssociation>
      </Extension>

      <Extension Category="windows.protocol">
        <Protocol Name="alsdkjs" />
      </Extension>
    </Extensions>
  </Application>
</Applications>

要求

	值
Namespace	`http://schemas.microsoft.com/appx/2010/manifest`

应用程序的 (包架构Windows 8)

元素层次结构

语法

键

特性和元素

特性

子元素

父元素

备注

示例

要求

反馈

反馈

其他资源