アプリの機能拡張ポイントを宣言します。
要素の階層
<Package>
└─ <Extensions>
└─ <desktop6:Extension>
└─ <Applications>
└─ <Application>
└─ <Extensions>
└─ <desktop6:Extension>
構文
<desktop6:Extension
Category = 'A required string that can have one of the following values: "windows.service", "windows.mutablePackageDirectories", or "windows.customInstall".'
desktop11:AppLifecycleBehavior = 'An optional string that can have one of the following values: "systemManaged", or "unmanaged".'
Executable = 'An optional string between 1 and 256 characters in length that must end with ".exe" and cannot contain these characters: <, >, :, ", |, ?, or *.'
EntryPoint = 'An optional string between 1 and 256 characters in length that cannot start or end with a whitespace character.'
RuntimeType = 'An optional string between 1 and 255 characters in length that cannot start or end with a period or contain these characters: <, >, :, ", /, \, |, ?, or *.'
StartPage = 'An optional string between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.'
ResourceGroup = 'An optional alphanumeric string between 1 and 255 characters in length. Must begin with an alphabetic character.'
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 optional alphanumeric string between 1 and 255 characters in length. Must begin with an alphabetic character.'
uap10:Parameters = 'An optional string between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
uap11:Id = 'An optional string 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 between 1 and 255 characters in length. Must begin with an alphabetic character.'
uap11:CurrentDirectoryPath = 'An optional string that cannot contain these characters: <, >, |, ?, or *.'
uap11:Parameters = 'An optional string between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
desktop7:CompatMode = 'An optional string that 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 -->
desktop6:Service?
desktop6:MutablePackageDirectories?
desktop6:CustomInstall?
</desktop6:Extension>
鍵
? 省略可能 (ゼロまたは 1)
属性
| 特性 |
説明 |
データの種類 |
必須 |
既定値 |
|
カテゴリ |
拡張機能のカテゴリ。 |
次のいずれかの値である必要がある文字列: windows.service ( Application内)。 windows.mutablePackageDirectories、 windows.customInstall ( Package内)。 |
イエス |
|
|
desktop11:AppLifecycleBehavior |
|
systemManaged、unmanaged のいずれかの値を持つ省略可能な文字列。 |
いいえ |
|
|
[実行可能ファイル] |
既定の起動実行可能ファイル。 |
".exe" で終わる必要がある 1 ~ 256 文字の省略可能な文字列。 <、 >、:、"、|、?、または *) を含めることはできません。 |
いいえ |
|
|
EntryPoint |
アクティブ化可能なクラス ID。 |
空白文字で開始または終了できない 1 ~ 256 文字の省略可能な文字列。 |
いいえ |
|
|
RuntimeType |
ランタイム プロバイダー。 この属性は、通常、アプリにフレームワークが混在している場合に使用されます。 |
1 から 255 文字の長さの省略可能な文字列。ピリオドで開始または終了できないか、または次の文字を含みます: <、 >、:、"、/、|、|、?、または *。 |
いいえ |
|
|
StartPage |
機能拡張ポイントを処理する Web ページ。 |
<、>、:、"、|、?、または *) を含むことができない、1 ~ 256 文字の省略可能な文字列。 |
いいえ |
|
|
ResourceGroup |
リソース管理のために拡張機能のアクティブ化をグループ化するために使用できるタグ (CPU やメモリなど)。 |
1 ~ 255 文字の長さの英数字文字列 (省略可能)。 英字で始まる必要があります。 |
いいえ |
|
|
uap10:TrustLevel |
拡張機能の信頼レベルを指定します。 |
appContainer、mediumIL のいずれかの値を持つ省略可能な文字列。 |
いいえ |
|
|
uap10:RuntimeBehavior |
拡張機能の実行時の動作を指定します。 |
windowsApp、packagedClassicApp、win32App のいずれかの値を持つ省略可能な文字列。 |
いいえ |
|
|
uap10:HostId |
拡張機能のホスト ランタイムの ID を指定します。 |
1 ~ 255 文字の長さの英数字文字列 (省略可能)。 英字で始まる必要があります。 |
いいえ |
|
|
uap10:Parameters |
拡張機能に渡すコマンド ライン パラメーターが含まれています。 パッケージ ID を持つデスクトップ アプリでのみサポートされます。 |
先頭と末尾に空白以外の文字を含む、1 ~ 32767 文字の省略可能な文字列。 |
いいえ |
|
|
uap11:Id |
拡張機能の識別子。 ID は、パッケージ内のすべての拡張機能に対して一意である必要があります。 |
先頭と末尾に空白以外の文字を含む、1 ~ 255 文字の長さの省略可能な文字列。 |
いいえ |
|
|
uap11:Subsystem |
拡張機能の対象となるサブシステム。 |
コンソール、ウィンドウのいずれかの値を指定できる省略可能な文字列。 |
いいえ |
|
|
uap11:SupportsMultipleInstances |
インスタンスを異なるプロセスで実行するかどうかを指定します。 既定値は false です。 |
省略可能なブール値。 |
いいえ |
|
|
uap11:ResourceGroup |
リソース管理のために拡張機能のアクティブ化をグループ化するために使用できるタグ (CPU やメモリなど)。 ResourceGroup に設定できる値は自由形式で柔軟です。
Application@ResourceGroupを参照してください。 |
1 ~ 255 文字の長さの英数字文字列 (省略可能)。 英字で始まる必要があります。 |
いいえ |
|
|
uap11:CurrentDirectoryPath |
アプリケーション プロセスの起動時の初期ディレクトリを指定します。 この属性はマクロをサポートします。 詳細については、「 パッケージ マニフェスト スキーマのマクロ」を参照してください。 |
<、>、| 、?、または *の文字を含めることができない省略可能な文字列。 |
いいえ |
|
|
uap11:Parameters |
拡張機能の対象となるサブシステム。 この属性はマクロをサポートします。 詳細については、「 パッケージ マニフェスト スキーマのマクロ」を参照してください。 |
先頭と末尾に空白以外の文字を含む、1 ~ 32767 文字の省略可能な文字列。 |
いいえ |
|
|
desktop7:CompatMode |
この拡張機能の情報を従来の方法 (たとえば、パッケージ化されていないアプリがレジストリを介して COM に型を登録する) でWindowsに登録するか、新しいスコープの新しい方法で登録するかを指定します。 既定値は "modern" です。 CompatMode="classic" には 、Microsoft.classicAppCompat_8wekyb3d8bbwe 機能が必要です。 |
次のいずれかの値を持つ省略可能な文字列: クラシック、 モダン。 |
いいえ |
|
|
desktop7:Scope |
登録が、このパッケージが登録されているユーザー (ユーザー) として実行されている他のアプリケーションにのみ表示されるかどうか、またはマシン (マシン) 上のすべてのユーザーとサービスに表示されるかどうかを指定します。 既定値は "user" です。 Scope="machine" には 、Microsoft.classicAppCompatElevated_8wekyb3d8bbwe 機能が必要です。 |
machine、user のいずれかの値を持つ省略可能な文字列。 |
いいえ |
|
子要素
| 子要素 |
説明 |
|
desktop6:Service |
アプリと共にインストールおよび登録されるサービスを指定します。 これらのサービスは、ローカル サービス、ネットワーク サービス、またはローカル システム アカウントのいずれかで実行するように構成できます。 |
|
desktop6:MutablePackageDirectories |
デスクトップ アプリケーションで、ユーザーがアプリケーションのインストール ファイルを変更できる 1 つ以上のフォルダーを指定できるようにします (mod のインストールなど)。 |
|
desktop6:CustomInstall |
デスクトップ アプリケーションで、デスクトップ アプリケーションと共にインストールされる 1 つ以上の追加のインストーラー ファイル (.exe または .msi) を指定できるようにします。 たとえば、これはサード パーティの再頒布可能コンポーネントをバンドルするアプリに役立ちます。 |
親要素
Requirements
| 品目 |
価値 |
|
Namespace |
http://schemas.microsoft.com/appx/manifest/desktop/windows10/6 |
|
desktop11 |
http://schemas.microsoft.com/appx/manifest/desktop/windows10/11 |
|
desktop7 |
http://schemas.microsoft.com/appx/manifest/desktop/windows10/7 |
|
uap10 |
http://schemas.microsoft.com/appx/manifest/uap/windows10/10 |
|
uap11 |
http://schemas.microsoft.com/appx/manifest/uap/windows10/11 |
|
最小 OS バージョン |
Windows 10 バージョン 1903 (ビルド 18362) |
Examples