拡張機能 (アプリケーション/拡張機能) (Windows 10)

パッケージの拡張ポイントを宣言します。

要素の階層

<パッケージ>

    <アプリケーション>

         <Application>

              <拡張機能>

                   <拡張子>

構文

<Extension
  Category = 'One of the following values: "windows.backgroundTasks", "windows.preInstalledConfigTask", "windows.updateTask", or "windows.restrictedLaunch".'
  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.'
/>

  <!-- Child elements -->
  BackgroundTasks?

</Extension>

キー

? 省略可能 (0 または 1)

属性と要素

属性

属性 説明 データ型 必須 既定値
カテゴリ パッケージ拡張ポイントの種類。 指定できる値は、 windows.backgroundTaskswindows.preInstalledConfigTaskwindows.updateTaskまたは windows.restrictedLaunch のいずれかです 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 拡張機能のランタイム動作を指定します。

詳細と要件については、Application (Windows 10) 要素のトピックを参照してくださいuap10:RuntimeBehavior
省略可能な文字列値。 指定した場合、"packagedClassicApp"、"win32App"、または "windowsApp" のいずれかの値を指定できます。 いいえ
uap10:HostId 拡張機能のホスト ランタイムの ID を指定します。 1 ~ 255 文字の長さの省略可能な値を持つ英数字文字列。 文字で始まる必要があります。 いいえ
uap10:Parameters 拡張機能に渡すコマンド ライン パラメーターが含まれています。 デスクトップ アプリでのみサポートされます。 長さが 1 ~ 32767 文字の文字列で、先頭と末尾に空白以外の文字が含まれます。 いいえ

子要素

子要素 説明
BackgroundTasks windows.backgroundTasks 型のアプリ拡張ポイントを定義します。 バックグラウンド タスクは、専用のバックグラウンド ホストで実行されます。つまり、UI がありません。

親要素

親要素 説明
拡張機能 (種類: CT_ApplicationExtensions) アプリの 1 つ以上の拡張ポイントを定義します。

次の要素の名前はこれと同じですが、コンテンツまたは属性が異なります:

注釈

アクティブ化情報属性が 拡張機能で指定されていない場合は、親 アプリケーションから継承されます。 Application 要素については、「解説」セクションを参照してください。

機能拡張ポイントは、パッケージがオペレーティング システムによって定義された方法で機能を追加できるメカニズムです。 機能拡張ポイントは、アプリがコードを実行したり、現在のパッケージのリソースを使用したりするために登録できる場所です。 特定のアプリの機能を追加するには、 Applications 要素の Application 子要素を使用します。

windows.certificates 拡張ポイントをマニフェストで複数回宣言することはできません。

注意

Category 属性が の場合、またはバージョン 1607 より前のバージョンのWindows 10の場合はwindows.UpdateTaskEntryPoint 属性または windows.preInstalledConfigTaskStartPage 属性 Windows 10が必要です。 Windows 10 バージョン 1607 以降では、Categorywindows.UseUpdateTask の場合に EntryPoint または StartPage の値を指定したりwindows.preInstalledConfigTask、バージョン 1607 以降Windows 10実行するデバイスのみを対象にしたりする必要がなくなります。

こちらもご覧ください

概念アプリコントラクトと拡張機能

要件

Item
名前空間 http://schemas.microsoft.com/appx/manifest/foundation/windows10
uap10 http://schemas.microsoft.com/appx/manifest/uap/windows10/10