應用程式 (Windows 10)

  • 發行項

代表包含套件中所提供之部分或所有功能的應用程式。

元素階層

<套件>
<應用程式>
<應用>

語法

<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.
             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?          = Any valid URI or IRI (the non-ASCII version of a URI). See below for more details. 
             ResourceGroup?      = An alphanumeric string between 1 and 255 characters in length. Must begin with an alphabetic character.
             desktop4:Subsystem? = String value. Can be one of the following: "console", "windows"
             uap10:Subsystem?    = String value. Can be one of the following: "console", "windows"
             desktop4:SupportsMultipleInstances? = Boolean.
             uap10:SupportsMultipleInstances? = Boolean.
             uap10:TrustLevel?   = String value. Can be one of the following: "appContainer", "mediumIL".
             uap10:RuntimeBehavior?  = String value. Can be one of the following: "windowsApp", "packagedClassicApp", "win32App".
             uap10:HostId?       = An alphanumeric string between 1 and 255 characters in length. Must begin with an alphabetic character.
             uap10:Parameters?   = A string between 1 and 32767 characters in length with a non-whitespace character at its beginning and end. >

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

</Application>

答案

? 選擇性 (零或一個) & 交錯連接器 (可能會以任何順序出現)

屬性和項目

屬性

屬性 描述 資料類型 必要 預設值
EntryPoint

啟動的類別識別碼，例如 "" Office。Winword 類別」。

如果您指定這個屬性，您也必須指定 可執行 的屬性。 如果您指定這個屬性，就不能指定 StartPage 屬性。

 長度介於1到256個字元之間的字串，代表處理延伸模組的工作。 這必須符合 Windows 執行階段類型的完整命名空間名稱。 如果未指定 EntryPoint，則會改用為應用程式定義的進入點。 No
可執行檔

應用程式的預設啟動可執行檔。 此檔案必須存在於封裝中。

如果您指定這個屬性，就必須指定 EntryPoint 屬性。 如果您指定這個屬性，就不能指定 StartPage 屬性。

 介於1到256個字元之間的字串，其長度必須以 ".exe" 結尾，且不能包含下列字元： < 、 > 、：、"、|、？或 *。 它會指定擴充功能的預設可執行檔。 如果未指定，則會使用為應用程式定義的可執行檔。 如果指定的話，也會使用 EntryPoint 屬性。 如果未指定該 EntryPoint 屬性，則會使用為應用程式定義的進入點。 No
識別碼

封裝內應用程式的唯一識別碼。 此值有時稱為「套件相關應用程式識別碼 (PRAID)」。

識別碼在封裝內是唯一的，但不是全域的。 系統上可能有另一個套件使用相同的識別碼。 相同的識別碼無法在相同的封裝中使用一次以上。

此字串包含以英文句點分隔的英數欄位。 每個欄位的開頭必須為 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 字串。 Yes
ResourceGroup

ResourceGroup 是一種標記，可用來將延伸模組啟用群組在一起以進行資源 (管理，例如，CPU 和記憶體) 。 請參閱 Extension@ResourceGroup。

 長度介於1到255個字元之間的英數位元字串。 開頭必須是字母字元。 No
StartPage

應用程式的預設啟動 HTML 頁面。 這可以是參考應用程式套件中檔的相對 Windows 檔案路徑，也可以是 (的絕對 URL，以便讓網站可以發佈為存放區) 中的應用程式。 URL 只能以 HTTP://、HTTPs://或 ms-chap （web：//）開頭。 這是啟動該應用程式的 WWA 時，Wwahost.exe 會載入的進入點檔。

技術上來說，這個值可能是 URL 或 IRI （URI 的非 ASCII 版本）。 IRI 必須支援最多2084個字元，而且必須允許包含% 和保留和非保留字元（如 RFC 3986 附錄 A所述）。

如果您指定這個屬性，就不能指定 EntryPoint 屬性或 可執行 的屬性。

 任何有效的 URI 或 IRI (非 ASCII 版本的 URI) 。 No
desktop4：子系統

指出應用程式是標準 UWP 應用程式或 UWP 主控台應用程式。

字串值。 可以是下列其中一項： "console"、"windows"。 No
uap10：子系統

指出應用程式是標準 UWP 應用程式或 UWP 主控台應用程式。

字串值。 可以是下列其中一項： "console"、"windows"。 No
desktop4:SupportsMultipleInstances

指出支援多個 UWP 應用程式的個別實例。 如需詳細資訊，請參閱「備註」一節。 命名 空間。

 布林值。 No
uap10:SupportsMultipleInstances

指出支援多個 UWP 應用程式的個別實例。 如需詳細資訊，請參閱「備註」一節。 命名 空間。

 布林值。 No
uap10： TrustLevel

指定應用程式的信任層級。

 字串值。 可以是下列其中一項： "appContainer"、"mediumIL"。 No
uap10:RuntimeBehavior

指定應用程式的執行時間行為。

 字串值。 可以是下列其中一項： ">windowsapp"、"packagedClassicApp"、"win32App"。 No
uap10： HostId

此值會指定目前應用程式之主應用程式的應用程式識別碼。 裝載的 應用程式會使用此屬性。

 長度介於1到255個字元之間的英數位元字串。 開頭必須是字母字元。 No
uap10：參數

包含要傳遞至應用程式的命令列參數。 僅支援具有套件身分識別的桌面應用程式。

 長度介於1到32767個字元之間，且開頭和結尾有非空白字元的字串。 No

 

子元素

子元素 描述
延伸模組 (類型： CT_ApplicationExtensions)

定義應用程式的一個或多個擴充點。
uap:ApplicationContentUriRules

指定 web 內容中的哪些頁面可以存取系統的地理位置裝置 (如果應用程式有權存取此功能) 和存取剪貼簿。
uap:VisualElements

描述應用程式的視覺層面：其預設磚、標誌影像、文字和背景色彩、初始螢幕方向、啟動顯示畫面，以及鎖定畫面磚外觀。
uap7:Properties

指定應用程式的屬性。

 

父項目

Parent 項目 描述
應用程式

代表組成封裝的一或多個應用程式。

 

備註

應用程式元素包含適用于應用程式之擴充點的通用屬性。 其他擴充點會使用這項資訊來取得應用程式的相關資訊。 此外， 應用程式 屬性也可用於啟動和管理應用程式的實例。

StartPage只適用于 JavaScript 應用程式。 如果未指定StartPage ，則必須指定可執行檔和EntryPoint屬性，而且這只適用于 c #、c + + 或 VB 應用程式。

關於多實例應用程式的重要注意事項：

  • 如果應用程式在應用程式專案內宣告SupportsMultipleInstances ，則所有前景延伸模組也會是多重實例。
  • 如果應用程式在應用程式專案內宣告SupportsMultipleInstances ，則不需要在擴充層級宣告 (例如，在BackgroundTasks或AppService元素中) 。
  • 應用程式應該只在背景工作、背景音訊或應用程式服務上宣告 SupportsMultipleInstances 。
  • 主控台應用程式一律會有多重具現化，而且必須明確宣告 SupportsMultipleInstances。
  • 應用程式可以使用資訊清單中的 ResourceGroup 宣告，將多個背景工作群組至相同的主控制項。 這會與多重執行個體衝突，其中的每個啟用都會分別進入不同的主機。 因此，應用程式無法在資訊清單中宣告 SupportsMultipleInstances 和 ResourceGroup 。

如需使用SupportsMultipleInstances屬性支援多個個別 UWP 應用程式實例的詳細資訊，請參閱建立多個實例的通用 Windows 應用程式。

需求

值
Namespace http://schemas.microsoft.com/appx/manifest/uap/windows10

desktop4 屬性： http://schemas.microsoft.com/appx/manifest/desktop/windows10/4

uap10 屬性： http://schemas.microsoft.com/appx/manifest/uap/windows10/10