uap:Extension (Windows 10)
アプリの拡張ポイントを宣言します。
要素の階層
<uap:Extension>
構文
<uap:Extension
Category = 'A string that can have one of the following values: "windows.fileTypeAssociation", "windows.protocol", "windows.autoPlayContent", "windows.autoPlayDevice", "windows.shareTarget", "windows.search", "windows.fileOpenPicker", "windows.fileSavePicker", "windows.cachedFileUpdater", "windows.cameraSettings", "windows.accountPictureProvider", "windows.printTaskSettings", "windows.lockScreenCall", "windows.appointmentsProvider", "windows.alarm", "windows.webAccountProvider", "windows.dialProtocol", "windows.appService", "windows.mediaPlayback", "windows.print3DWorkflow", "windows.lockScreen", "windows.aboveLockScreen", "windows.personalAssistantLaunch", or "windows.voipCall".'
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 -->
uap:FileTypeAssociation?
uap:Protocol?
uap:AutoPlayContent?
uap:AutoPlayDevice?
uap:ShareTarget?
uap:FileOpenPicker?
uap:FileSavePicker?
uap:AppointmentsProvider?
uap:WebAccountProvider?
uap:DialProtocol?
uap:AppService?
uap:MediaPlayback?
uap:VoipCall?
</uap:Extension>
キー
? 省略可能 (0 または 1)
属性と要素
属性
| 属性 | 説明 | データ型 | 必須 | 既定値 |
|---|---|---|---|---|
| カテゴリ | パッケージ拡張ポイントの種類。 | windows.fileTypeAssociation、windows.protocol、windows.autoPlayContent、windows.autoPlayDevice、windows.shareTarget、windows.search、windows.fileOpenPicker、windows.fileSavePicker、windows.cachedFileUpdater、windows.cameraSettings、windows.accountPictureProvider、windows.printTaskSettings、windows.lockScreenCall、windows.appointmentsProvider、windows.alarm、windows.webAccountProvider、windows.dialProtocol、windows.appService、windows.mediaPlayback、windows.print3DWorkflow、windows.lockScreen、windows.aboveLockScreen、windows.personalAssistantLaunch、または windows.voipCall。 | Yes | |
| EntryPoint | アクティブ化可能なクラス ID。 | 長さが 1 ~ 256 文字の値を持つ文字列。 拡張機能を処理するタスク (通常は、Windows ランタイム型の名前空間で修飾された完全名) を表します。 EntryPoint が指定されていない場合は、アプリに対して定義されている EntryPoint が代わりに使用されます。 | いいえ | |
| [実行可能ファイル] | 既定の起動実行可能ファイル。 | 長さが 1 ~ 256 文字の文字列。末尾は である必要 .exeがあり、次の文字 <(、 >、 :、 "、 |、 ?、または *) を含めることはできません。 拡張機能の既定の実行可能ファイルを指定します。 指定しない場合は、アプリに対して定義されている実行可能ファイルが使用されます。 指定した場合は、EntryPoint プロパティも使用されます。 その EntryPoint プロパティが指定されていない場合は、アプリに対して定義されている EntryPoint が使用されます。 |
いいえ | |
| RuntimeType | ランタイム プロバイダー。 通常、アプリに組み合わせたフレームワークがある場合に使用されます。 | 1 から 255 文字の長さの値を持つ文字列。先頭または末尾.に 、、または *が含まれています"<?>:|。 |
いいえ | |
| StartPage | 拡張ポイントを処理する Web ページです。 | 長さが 1 ~ 256 文字の文字列。、">:|?または *の各文字<を含めることはできません。 |
いいえ | |
| ResourceGroup | リソース管理の目的で拡張機能のアクティブ化をグループ化するために使用される省略可能なタグ (CPU やメモリなど)。 Application@ResourceGroupの「解説」セクションを参照してください。 | 長さが 1 ~ 255 文字の英数字文字列。 文字で始まる必要があります。 | いいえ | |
| uap10:TrustLevel | 拡張機能の信頼レベルを指定します。 | 省略可能な文字列値。 指定した場合は、 appContainer または mediumIL のいずれかの値を指定できます。 | いいえ | |
| uap10:RuntimeBehavior | 拡張機能のランタイム動作を指定します。 | 省略可能な文字列値。 指定する場合は、 windowsApp、 packagedClassicApp、 win32App のいずれかの値を指定できます。 | いいえ | |
| uap10:HostId | 拡張機能のホスト ランタイムの ID を指定します。 | 1 ~ 255 文字の長さの省略可能な値を持つ英数字文字列。 文字で始まる必要があります。 | いいえ | |
| uap10:Parameters | 拡張機能に渡すコマンド ライン パラメーターが含まれています。 デスクトップ アプリでのみサポートされます。 | 長さが 1 ~ 32767 文字の文字列で、先頭と末尾に空白以外の文字が含まれます。 | いいえ | |
| uap11:Id | 拡張機能の識別子。 ID は、パッケージ内のすべての拡張機能に対して一意である必要があります。 | 先頭と末尾に空白以外の文字を含む、長さが 1 ~ 255 文字の省略可能な文字列。 | いいえ | |
| uap11:Subsystem | この属性は基本拡張構文から継承され、com4 拡張機能には適用されません。 構文検証以外の値は無視されます。 | コンソールまたはウィンドウのいずれかの値を指定できる省略可能な文字列。 | いいえ | |
| uap11:SupportsMultipleInstances | インスタンスを異なるプロセスで実行するかどうかを指定します。 既定値は false です。 | 省略可能なブール値。 | いいえ | |
| uap11:ResourceGroup | リソース管理のために拡張機能のアクティブ化をグループ化するために使用できるタグ (CPU やメモリなど)。 ResourceGroup に設定できる値は自由形式で柔軟です。 「Application@ResourceGroup」を参照してください。 | 1 ~ 255 文字の長さの値を持つオプションの英数字文字列。 文字で始まる必要があります。 | いいえ | |
| uap11:CurrentDirectoryPath | アプリケーション プロセスの起動時の初期ディレクトリを指定します。 この属性はマクロをサポートしています。 詳細については、「 パッケージ マニフェスト スキーマのマクロ」を参照してください。 | 、または の文字を<?>|含めることができない省略可能な文字列。* > |
いいえ | |
| uap11:Parameters | この属性は基本拡張構文から継承され、com4 拡張機能には適用されません。 構文検証以外では、この値は無視されます。 この属性はマクロをサポートしています。 詳細については、「 パッケージ マニフェスト スキーマのマクロ」を参照してください。 | 長さが 1 ~ 32767 文字の値を持つ省略可能な文字列で、先頭と末尾に空白文字以外の文字が含まれます。 | いいえ | |
| desktop7:CompatMode | この拡張機能の情報を従来の方法で Windows に登録するか (たとえば、パッケージ化されていないアプリがレジストリを介して COM に型を登録する)、またはよりスコープが広い新しい方法で登録するかを指定します。 既定値は "modern" です。 CompatMode="classic" には 、Microsoft.classicAppCompat_8wekyb3d8bbwe 機能が必要です。 | 省略可能な文字列 は、 クラシック または モダンのいずれかの値を持つことができます。 | いいえ | |
| desktop7:Scope | このパッケージが登録されているユーザー (ユーザー) として実行されている他のアプリケーションにのみ登録を表示するか、マシン (マシン) 上のすべてのユーザーとサービスに表示するかを指定します。 既定値は "user" です。 Scope="machine" には 、Microsoft.classicAppCompatElevated_8wekyb3d8bbwe 機能が必要です。 | コンピューターまたはユーザーのいずれかの値を含めることができる省略可能な文字列。 | いいえ |
子要素
| 子要素 | 説明 |
|---|---|
| uap:AppService | windows.appService 型のアプリ拡張ポイントを宣言します。 アプリケーション コントラクトは、アプリが別のアプリに属するバックグラウンド タスクを呼び出す方法です。または、アプリ コントラクトにサービスを提供するために呼び出されたバックグラウンド タスクの場合は、呼び出し元と通信する方法を指定します。 |
| uap:AppointmentsProvider | windows.appointmentsProvider 型のアプリ拡張ポイントを宣言します。 |
| uap:AutoPlayContent | windows.autoPlayContent 型のアプリ拡張ポイントを宣言します。 アプリは、指定された自動再生コンテンツ アクションを提供します。 |
| uap:AutoPlayDevice | *windows.autoPlayDevice 型のアプリ拡張ポイントを宣言します。 アプリは、指定された自動再生デバイス アクションを提供します。 |
| uap:DialProtocol | windows.dialProtocol* 型のアプリ拡張ポイントを宣言します。 |
| uap:FileOpenPicker | windows.fileOpenPicker 型のアプリ拡張ポイントを宣言します。 アプリを使用すると、ユーザーは指定した種類のファイルを選択して開きます。 |
| uap:FileSavePicker | windows.fileSavePicker 型のアプリ拡張ポイントを宣言します。 アプリを使用すると、ユーザーは指定した種類のファイルのファイル名、拡張子、および保存場所を選択できます。 |
| uap:FileTypeAssociation | windows.fileTypeAssociation 型のアプリ拡張ポイントを宣言します。 ファイルの種類の関連付けは、指定した種類のファイルを処理するためにアプリが登録されていることを示します。 |
| uap:MediaPlayback | mediaPlayback 型のアプリ拡張ポイントを宣言して、アプリがビデオ トランスコードを実行することを宣言できるようにします。 |
| uap:Protocol | windows.protocol 型のアプリ拡張ポイントを宣言します。 URI 関連付けは、指定されたスキームで URI を処理するためにアプリが登録されていることを示します。 |
| uap:ShareTarget | windows.shareTarget 型のアプリ拡張機能ポイントを宣言します。 アプリは、指定した種類のファイルを共有できます。 |
| uap:VoipCall | windows.voipCall 型のアプリ拡張ポイントを宣言します。アプリは、携帯電話通話から VoIP ビデオ通話へのアップグレードを実行できることを宣言したり、電話番号の直接ダイヤルをサポートする VoIP アプリであるかどうかを宣言したりできます。 |
| uap:WebAccountProvider | windows.webAccountProvider 型のアプリ拡張ポイントを宣言します。 |
親要素
| 親要素 | 説明 |
|---|---|
| 拡張機能 (type:CT_ApplicationExtensions) | アプリの 1 つ以上の拡張ポイントを定義します。 |
注釈
ほとんどの種類の拡張機能では、Extension@ResourceGroup Application@ResourceGroupと一致する必要があります (Application@ResourceGroupを省略した場合は、Extension@ResourceGroupも省略する必要があります)。
UI ベースのコントラクトの場合: Extension@ResourceGroupが指定されていない場合、アプリケーションで暗黙的にグループ化されます。Extension@ResourceGroupがApplication@ResourceGroupと一致しない場合、マニフェストはスキーマの検証に失敗します。
Extension@ResourceGroupがバックグラウンド タスクに対して指定されていない場合、またはバックグラウンド タスクに基づくコントラクトの場合は、すべてのバックグラウンド タスクの既定のグループに関連付けられます。 バックグラウンド タスク コントラクトでは、Application@ResourceGroupと同じ値を指定できます。
次の拡張機能では、Extension@ResourceGroup実行されるバックグラウンド タスクを、他のグループとは別にリソースおよびライフサイクル管理されるさまざまなプロセス (windows.backgroundTasks、windows.appServices、windows.preinstalledConfigTask、windows.updateTask) にグループ化できます。
たとえば、マニフェストにこれら 3 つのエントリがある場合です。
<Extension Category="windows.backgroundTasks" EntryPoint="Fabrikam.BackgroundTask" ResourceGroup="Group1">
<BackgroundTasks>
<Task Type="timer"/>
</BackgroundTasks>
</Extension>
<Extension Category="windows.backgroundTasks" EntryPoint="Fabrikam.BackgroundTask2" ResourceGroup="Group2">
<BackgroundTasks>
<Task Type="controlChannel"/>
</BackgroundTasks>
</Extension>
<Extension Category="windows.backgroundTasks" EntryPoint="Fabrikam.BackgroundTask3" ResourceGroup="Group2">
<BackgroundTasks>
<Task Type="pushNotification"/>
</BackgroundTasks>
</Extension>
その後、最後の 2 つのバックグラウンド タスクが同時にアクティブ化された場合は、 の backgroundtaskhost.exe 同じインスタンスにアクティブ化されます。 ただし、backgroundtaskhost.exe の個別のインスタンスは、別の ResourceGroup があるため、最初のエントリに対してスピンアップされます。
拡張機能に ResourceGroup が指定されていない場合、すべてのバックグラウンド タスクが の同じインスタンス backgroundtaskhost.exeにアクティブ化されます。
さらに、これらの拡張機能 (windows.backgroundTasks、 windows.appServices、 windows.preinstalledConfigTask、または windows.updateTask) のいずれかが、親 Application 要素の ResourceGroup 属性と同じ値を指定した場合、UI と同じプロセスでアクティブ化されます。
次の拡張機能は、パッケージ デザイナー UI の [宣言] タブにあります。これらの各要素の説明を参照してください。
- Search: アプリを検索プロバイダーとして登録します。 アプリのインデックス付きコンテンツは、Searchチャームを介して起動されたグローバル検索エクスペリエンスで検索結果として表示できます。 アプリケーションごとに、この宣言の 1 つのインスタンスだけが許可されます。
- CachedFileUpdater: アプリをキャッシュされたファイル アップデーターとして登録し、アプリが他の Microsoft Store アプリからアクセスされるファイルに対する更新プログラムをプロバイダーに提供できるようにします。 アプリケーションごとに、この宣言の 1 つのインスタンスだけが許可されます。
- カメラの設定: アプリが Web カメラ デバイス用のカスタム コントロール パネルを提供できるようにします。 アプリケーションごとに、この宣言の 1 つのインスタンスだけが許可されます。
- AccountPictureProvider: アプリをアカウント画像プロバイダーとして登録し、アカウント画像モードで起動し、追加のプロンプトを表示せずにユーザーの画像を設定できるようにします。 アプリケーションごとに、この宣言の 1 つのインスタンスだけが許可されます。
- PrintTaskSettings: アプリで基本的な印刷設定エクスペリエンスを置き換えることができます。 アプリケーションごとに、この宣言の 1 つのインスタンスだけが許可されます。
- LockScreen: 電話がロックされている場合、ユーザーが実行できる操作の量は限られています。 場合によっては、ユーザーは電話のロックを解除せずに VoIP 通話に応答できるようにしたいと考えます。 このコントラクトを使用すると、それが可能になります。 アプリケーションごとに、この宣言の 1 つのインスタンスだけが許可されます。
- アラーム: アプリケーションは、システム アラーム アプリとして自身を宣言できます。 ユーザーが選択 UI を使用してシステム アラームを設定すると、システム アラーム アプリとして宣言されているアプリケーションのみを選択できます。 アプリケーションごとに、この宣言の 1 つのインスタンスだけが許可されます。
- BackgroundTasks: バックグラウンド タスクを使用すると、アプリケーションが相互に通信し、あるアプリケーションが別のアプリケーションを呼び出せるようにすることができます。 コントラクトを使用してこれらのバックグラウンド タスクを提供または起動するには、アプリケーションをアプリ サービスとして宣言する必要があります。 各アプリケーションで、この宣言の複数のインスタンスが許可されます。
- Print3DWorkFlow: 3D プリンターの製造元は、3D 印刷ダイアログで独自のエクスペリエンスを提供するユニバーサル Windows アプリを提供できます。 そうでない場合、Windows では既定の 3D 印刷エクスペリエンスが提供されます。 アプリケーションごとに、この宣言の 1 つのインスタンスだけが許可されます。
- PersonalAssistantLaunch: アプリを Cortana と統合できるようにします。 アプリケーションごとに、この宣言の 1 つのインスタンスだけが許可されます。
要件
| Item | 値 |
|---|---|
| rescap4 | http://schemas.microsoft.com/appx/manifest/uap/windows10 |
| uap10 | http://schemas.microsoft.com/appx/manifest/uap/windows10/10 |
| Minimum OS Version | Windows 10 バージョン 1511 (ビルド 10586) |
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示