uap4:Extension
宣告應用程式的擴充點。
元素階層
<uap4:Extension>
Syntax
<uap4:Extension
Category = 'A string that can have one of the following values: "windows.sharedFonts", "windows.userDataTaskDataProvider", "windows.mediaCodec", "windows.contactPanel", "windows.loopbackAccessRules", "windows.devicePortalProvider", "windows.printWorkflowBackgroundTask", or "windows.printWorkflowForegroundTask".'
Executable = 'A string with an optional value between 1 and 256 characters in length, that must end with ".exe", and cannot contain the following characters: <, >, :, ", |, ?, or *. 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 the EntryPoint property is not specified, the EntryPoint defined for the app is used.'
EntryPoint = 'A string with an optional value between 1 and 256 characters in length. Represents the task handling the extension (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 = 'A string with an optional value between 1 and 255 characters in length that cannot start or end with a period or contain these characters: <, >, :, ", /, \, |, ?, or *.'
StartPage = 'A string with an optional value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.'
ResourceGroup = 'An alphanumeric string with an optional value between 1 and 255 characters in length. Must begin with a letter.'
uap10:TrustLevel = 'An optional string value. If specified, it must be either "appContainer" or "mediumIL".'
uap10:RuntimeBehavior = 'An optional string value. If specified, it must be one of the following values: "windowsApp", "packagedClassicApp", or "win32App".'
uap10:HostId = 'An alphanumeric string with an optional value between 1 and 255 characters in length. Must begin with an letter.'
uap10:Parameters = 'A string with an optional value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
uap11:Id = 'An optional string with a value between 1 and 255 characters in length with a non-whitespace character at its beginning and end.'
uap11:Subsystem = 'An optional string that can have one of the following values: "console" or "windows".'
uap11:SupportsMultipleInstances = 'An optional boolean value.'
uap11:ResourceGroup = 'An optional alphanumeric string with a value between 1 and 255 characters in length. Must begin with a letter.'
uap11:CurrentDirectoryPath = 'An optional string that cannot contain these characters: <, >, |, ?, or *. >'
uap11:Parameters = 'An optional string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
desktop7:CompatMode = 'An optional string the can have one of the following values: "classic" or "modern".'
desktop7:Scope = 'An optional string that can have one of the following values: "machine" or "user".' >
<!-- Child elements -->
uap4:SharedFonts
uap4:UserDataTaskDataProvider
uap4:MediaCodec
uap4:ContactPanel
uap4:LoopbackAccessRules
uap4:DevicePortalProvider?
</uap4:Extension>
答案
? 選擇性 (零或一個)
屬性和元素
屬性
| 屬性 | 描述 | 資料類型 | 必要 | 預設值 |
|---|---|---|---|---|
| 類別 | 套件擴充點的類型。 | 可具有下列其中一個值的字串： windows.sharedFonts、 windows.userDataTaskDataProvider、 windows.mediaCodec、 windows.contactPanel、 windows.loopbackAccessRules、 windows.devicePortalProvider、 windows.printWorkflowBackgroundTask 或 windows.printWorkflowForegroundTask。 | Yes | |
| EntryPoint | 可啟用的類別識別碼。 | 長度介於 1 到 256 個字元之間的字串。 表示處理延伸模組的工作 (通常是 Windows 執行階段 類型的完整命名空間限定名稱) 。 如果未指定 EntryPoint，則會改用為應用程式定義的 EntryPoint。 | No | |
| 可執行檔 | 默認啟動可執行檔。 | 長度介於 1 到 256 個字元之間的字串，必須以 .exe結尾，且不能包含下列字元：<、、、>、、:、 ?"|或 。 * 指定延伸模組的預設可執行檔。 如果未指定，則會使用為應用程式定義的可執行檔。 如果指定，也會使用 EntryPoint 屬性。 如果未指定 EntryPoint 屬性，則會使用為應用程式定義的 EntryPoint。 |
No | |
| RuntimeType | 運行時間提供者。 通常會在應用程式中混合架構時使用。 | 長度介於 1 到 255 個字元之間的字串，長度不能以 . 或 包含 字元開頭或結尾：<、、、>、、:、"|、 ?或 *。 |
No | |
| StartPage | 處理擴充點的網頁 | 長度介於 1 到 256 個字元之間的字串，不能包含下列字元：<、、、:>、"、|、 ?或 *。 |
No | |
| ResourceGroup | 選擇性標記，用來將擴充功能啟用分組在一起，以供資源管理之用 (，例如 CPU 和記憶體) 。 請參閱Application@ResourceGroup中的一節。 | 長度介於 1 到 255 個字元之間的英數位元。 必須以字母開頭。 | No | |
| uap10：TrustLevel | 指定延伸模組的信任層級。 | 選擇性字串值。 如果指定，它可以是下列其中一個值： appContainer 或 mediumIL。 | No | |
| uap10：RuntimeBehavior | 指定延伸模組的運行時間行為。 | 選擇性字串值。 如果指定，它可以是下列其中一個值： windowsApp、 packagedClassicApp 或 win32App。 | No | |
| uap10：HostId | 指定擴充功能的主機運行時間標識碼。 | 長度介於 1 到 255 個字元之間的選擇性值英數位元。 必須以字母開頭。 | No | |
| uap10：Parameters | 包含要傳遞至延伸模組的命令行參數。 僅支援傳統型應用程式。 | 長度介於 1 到 32767 個字元之間的字串，其開頭和結尾具有非空格符。 | No | |
| uap11：Id | 延伸模組的標識碼。 套件中所有延伸模組的標識碼都必須是唯一的。 | 長度介於 1 到 255 個字元的選擇性字串，其開頭和結尾具有非空格符。 | No | |
| uap11：子系統 | 此屬性繼承自基底延伸模組語法，不適用於 com4 延伸模組。 除了語法驗證之外，也會忽略此值。 | 可具有下列其中一個值的選擇性字串： 控制台 或 視窗。 | No | |
| uap11：SupportsMultipleInstances | 指定實例是否應該在不同的進程中執行。 預設值為 false。 | 選擇性布爾值。 | No | |
| uap11：ResourceGroup | 標記，可用來將擴充功能啟用群組在一起，以供資源管理之用 (，例如 CPU 和記憶體) 。 您可以設定 ResourceGroup 的值是自由格式且有彈性。 請參閱 Application@ResourceGroup。 | 長度介於 1 到 255 個字元之間的選擇性英數位元字串。 必須以字母開頭。 | No | |
| uap11：CurrentDirectoryPath | 指定應用程式進程啟動時的初始目錄。 此屬性支持宏。 如需詳細資訊，請參閱 套件指令清單架構中的宏。 | 無法包含下列字元的選擇性字串：<、、、>|、 ?或 *。 > |
No | |
| uap11：Parameters | 此屬性繼承自基底延伸模組語法，不適用於 com4 延伸模組。 除了語法驗證之外，也會忽略此值。 此屬性支持宏。 如需詳細資訊，請參閱 套件指令清單架構中的宏。 | 長度介於 1 到 32767 個字元的選擇性字串，其開頭和結尾為非空格符。 | No | |
| desktop7：CompatMode | 指定此延伸模組的資訊是以傳統方式向 Windows 註冊， (例如，透過登錄) 或以更具範圍的方式向 COM 註冊未封裝的應用程式註冊類型。 預設值為 「modern」。 CompatMode=“classic” 需要 Microsoft.classicAppCompat_8wekyb3d8bbwe 功能。 | 的選擇性字串可以有下列其中一個值： 傳統 或 新式。 | No | |
| desktop7：Scope | 指定註冊是否只有以使用者身分註冊 (使用者) 執行的其他應用程式，或是否對 (計算機上的所有使用者和服務顯示註冊) 。 預設值為 「user」。 Scope=“machine” 需要 Microsoft.classicAppCompatElevated_8wekyb3d8bbwe 功能。 | 可具有下列其中一個值的選擇性字串： 計算機 或 使用者。 | No |
子元素
| 子項目 | 描述 |
|---|---|
| SharedFonts | 包含要與應用程式搭配使用的共用字型位置。 |
| UserDataTaskDataProvider | 讓應用程式成為工作的 DataProvider。 |
| MediaCodec | 定義可讓應用程式從 Microsoft Store 安裝媒體編解碼器的延伸模組。 |
| ContactPanel | 在 Windows 應用程式中啟用聯繫人面板。 |
| LoopbackAccessRules | 包含回送篩選規則，可啟用應用程式與服務之間的通訊。 |
| DevicePortalProvider | 定義用於部署的裝置入口網站提供者。 |
父元素
| 父元素 | 描述 |
|---|---|
| 延伸模組 | 定義封裝的一或多個擴充點。 |
備註
windows.printWorkflowBackgroundTask 和 windows.printWorkflowForegroundTask 是空的延伸模組宣告，可提供列印案例的支援。 背景工作進入點一開始會由列印系統呼叫，以開始處理列印數據，並在向使用者要求詳細資訊時啟動前景工作。 背景進入點必須是實作 IBackgroundTask的類別。
規格需求
| Item | 值 |
|---|---|
| Namespace | http://schemas.microsoft.com/appx/manifest/uap/windows10/4 |
| uap10 | http://schemas.microsoft.com/appx/manifest/uap/windows10/10 |
| OS 最低版本 | Windows 10 版本 1703 (組建 15063) |