desktop6：Extension (package/Extensions)

宣告傳統型應用程式的擴充點。

元素階層

<套件>

    <擴充功能>

         <desktop6:Extension>

Syntax

<desktop6:Extension
  Category = 'A string that can have one of the following values: "windows.mutablePackageDirectories" or "windows.customInstall".'
  Executable = 'An optional string with a value 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 isnt specified, the EntryPoint defined for the app is used.'
  EntryPoint = 'An optional string with a value 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.'
  RuntimeType = 'An optional string with a value between 1 and 255 characters in length that cannot start or end with a period or contain these characters: <, >, :, ", /, \, |, ?, or *.'
  StartPage = 'An optional string with a value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.'
  uap10:TrustLevel = 'An optional string that can have one of the following values: "appContainer" or "mediumIL".'
  uap10:RuntimeBehavior = 'An optional string that can have one of the following values: "windowsApp", "packagedClassicApp", or "win32App".'
  uap10:HostId = 'An alphanumeric string with a value between 1 and 255 characters in length. Must begin with a letter.'
  uap10:Parameters = 'An optional string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.' >

  <!-- Child elements -->
  ( desktop6:MutablePackageDirectories
  | desktop6:CustomInstall )?

</desktop6:Extension>

答案

? 選擇性 (零或一個)

屬性和元素

屬性

屬性	描述	資料類型	必要	預設值
類別	延伸模組的類別。	可以具有下列其中一個值的字串： windows.mutablePackageDirectories 或 windows.customInstall。	Yes
可執行檔	預設啟動可執行檔。	長度介於 1 到 256 個字元之間的選擇性字串，其長度必須以 .exe 結尾，且不能包含下列字元： < 、、 ":|>? 或 。 * 它會指定延伸模組的預設可執行檔。 如果未指定，則會使用為應用程式定義的可執行檔。 如果指定，也會使用 EntryPoint 屬性。 如果未指定 EntryPoint 屬性，則會使用為應用程式定義的 EntryPoint。	No
EntryPoint	可啟用的類別識別碼。	長度介於 1 到 256 個字元之間的選擇性字串，代表處理延伸的工作。 這必須符合 Windows 執行階段類型的完整命名空間名稱。 如果未指定 EntryPoint，則會改用為應用程式定義的 EntryPoint。	No
RuntimeType	執行時間提供者。 當應用程式中有混合架構時，通常會使用這個屬性。	長度介於 1 到 255 個字元之間的選擇性字串，長度不能以句號開頭或結尾，或包含下列字元： < 、、 /:>\|"? 或 。 *	No
StartPage	處理擴充點的網頁	長度介於 1 到 256 個字元之間的選擇性字串，不能包含下列字元： < 、、 > 、 :|" 、、 ? 或 。 *	No
uap10：TrustLevel	指定延伸模組的信任層級。	可具有下列其中一個值的選擇性字串： appContainer 或 mediumIL。	No
uap10：RuntimeBehavior	指定延伸模組的執行時間行為。	可具有下列其中一個值的選擇性字串： windowsApp、 packagedClassicApp或 win32App。	No
uap10：HostId	指定擴充功能的主機執行時間識別碼。	長度介於 1 到 255 個字元之間的英數位元字串。 必須以字母開頭。	No
uap10：Parameters	包含要傳遞至延伸模組的命令列參數。 僅支援具有套件身分識別的桌面應用程式。	長度介於 1 到 32767 個字元的選擇性字串，其開頭和結尾為非空白字元。	No

子元素

子項目	描述
MutablePackageDirectories	可讓您的桌面應用程式指定一或多個資料夾，例如，使用者可以修改應用程式的安裝檔案 (，以安裝 mods) 。
CustomInstall	可讓傳統型應用程式指定隨桌面應用程式一起安裝的一或多個其他安裝程式檔案 (.exe 或 .msi) 。 例如，這適用於搭售協力廠商可轉散發元件的應用程式。

父元素

父元素	描述
延伸模組 (類型：CT_PackageExtensions)	定義封裝的一或多個擴充點。

規格需求

Item	值
命名空間	http://schemas.microsoft.com/appx/manifest/desktop/windows10/6
uap10	http://schemas.microsoft.com/appx/manifest/uap/windows10/10
OS 最低版本	Windows 10版本 1903 (組建 18362)