拡張機能 (型: CT_ApplicationExtensions)

アプリの拡張ポイントを宣言します。

要素の階層

<Package>
<アプリケーション>
<適用>
<拡張機能>
<拡張子>

構文

<Extension Category     = "windows.fileTypeAssociation" | "windows.protocol" | "windows.autoPlayContent" | "windows.autoPlayDevice" | "windows.shareTarget" | ...
           Executable?  = A string 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 isn't specified, the EntryPoint defined for the app is used.
           EntryPoint?  = A string 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? = A string between 1 and 255 characters in length that cannot start or end with a period or contain these characters: <, >, :, %, ", /, \, |, ?, or *.
           StartPage?   = A string between 1 and 256 characters in length that cannot contain these characters: <, >, :, %, ", |, ?, or *. >

  <!-- Child elements -->
  ( FileTypeAssociation
  | Protocol
  | AutoPlayContent
  | AutoPlayDevice
  | ShareTarget
  | FileOpenPicker
  | FileSavePicker
  | BackgroundTasks
  )?

</Extension>

Key

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

属性および要素

属性

属性 説明 データ型 必須 既定値
カテゴリ

アプリ機能拡張ポイントの種類。

この属性は、次のいずれかの値になります。

  • windows. fileTypeAssociation
  • windows. プロトコル
  • windows. autoPlayContent
  • windows. autoPlayDevice
  • shareTarget
  • windows. 検索
  • windows. fileOpenPicker
  • fileSavePicker
  • cachedFileUpdater
  • windows. contactPicker
  • windows の backgroundTasks
  • cameraSettings
  • windows. Accountピクチャプロバイダー
  • printTaskSettings
はい
EntryPoint

アクティブ化可能クラス ID。

拡張機能を処理するタスクを表す 1 ~ 256 文字の長さの文字列。 これは、通常、Windows ランタイムの型の完全な名前空間修飾名です。 EntryPoint が指定されていない場合は、アプリに対して定義されている EntryPoint が代わりに使用されます。 いいえ
[実行可能ファイル]

既定の起動実行可能ファイル。

".exe" で終わる必要があり、次の文字 < を含めることができない長さが 1 ~ 256 文字の文字列 (、 > 、:、%、"、|、?、または *)。 拡張機能の既定の実行可能ファイルを指定します。 指定しない場合は、アプリに対して定義されている実行可能ファイルが使用されます。 指定されている場合は、EntryPoint プロパティも使用されます。 この EntryPoint プロパティが指定されていない場合は、アプリに対して定義されている EntryPoint が使用されます。 いいえ
System.runtimetype

ランタイムプロバイダー。 この属性は、アプリにフレームワークが混在している場合に一般的に使用されます。

1 ~ 255 文字の長さの文字列。先頭または末尾にピリオドを使用することはできません。 <> また、、、:、%、"、/、\、|、?、または * の文字を含めることはできません。 いいえ
StartPage

拡張ポイントを処理する Web ページです。

文字 (、 > 、:、%、"、|、?、または *) を含めることができない、長さが 1 ~ 256 文字の文字列。 < いいえ

 

子要素

子要素 説明
AutoPlayContent

種類が windows のアプリ機能拡張ポイントを宣言します。 アプリは、指定された自動再生コンテンツアクションを提供します。

AutoPlayDevice

種類が windows のアプリケーション拡張ポイントである autoPlayDeviceを宣言します。 アプリは、指定された自動再生デバイスアクションを提供します。

BackgroundTasks

種類が windows の backgroundTasksのアプリ機能拡張ポイントを定義します。 バックグラウンドタスクは専用のバックグラウンドホストで実行されるつまり、UI がありません。

FileOpenPicker

種類が windows. fileOpenPickerのアプリ拡張ポイントを宣言します。 ユーザーは、アプリを使用して、指定した種類のファイルを選択して開くことができます。

FileSavePicker

FileSavePicker型のアプリ拡張ポイントを宣言します。 ユーザーは、アプリを使用して、ファイル名、拡張子、および指定した種類のファイルの保存場所を選択できます。

FileTypeAssociation

種類が windows. fileTypeAssociationのアプリ拡張ポイントを宣言します。 ファイルの種類の関連付けは、アプリが、指定された種類のファイルを処理するように登録されていることを示します。

プロトコル

種類が windows プロトコルのアプリ拡張ポイントを宣言します。 URI の関連付けは、アプリが、指定されたスキームの Uri を処理するように登録されていることを示します。

ShareTarget

ShareTarget型のアプリの拡張点を宣言します。 アプリは、指定された種類のファイルを共有できます。

 

親要素

Parent 要素 説明
拡張機能 (型: CT_ApplicationExtensions)

アプリの1つまたは複数の拡張ポイントを定義します。

 

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

注釈

これらの拡張ポイントは、アプリごとに1回だけ宣言できます。

  • windows. Accountピクチャプロバイダー
  • windows.cachedFileUpdater
  • windows.cameraSettings
  • windows.contactPicker
  • windows.fileOpenPicker
  • windows.fileSavePicker
  • windows.printTaskSettings
  • windows.search
  • windows.shareTarget

**拡張機能のセマンティック ルールに関する注意: **Extension 要素の場合、マニフェスト API では次のセマンティック ルールが適用されます。

/Application/@StartPage指定した場合は、JavaScript Windowsアプリ拡張機能 を使用したアプリとして使用できます。

  • 空になる可能性あり
  • StartPage を指定できます
  • Executable と EntryPoint の両方を指定できます (省略可能な RuntimeType は許可されます)。BackgroundTask 拡張機能を指定しない限り、実行可能ファイルを省略し、既定で BackgroundTaskHost.exe 実行可能ファイルに設定できます。

/Application/@StartPageが指定されていない場合は、C# または VB と XAML とアプリ拡張機能 を使用する UWP アプリです。

  • 空になる可能性あり
  • StartPage を指定できます
  • Executable または RuntimeType が指定されている場合は、EntryPoint を指定する必要があります。

次の例は、SDK サンプルの 1 つのパッケージ マニフェストから取得されています。

<Applications>
  <Application Id="App" StartPage="default.html">
    <VisualElements DisplayName="Assocation launching sample" 
         Logo="images\squareTile-sdk.png" SmallLogo="images\smallTile-sdk.png" 
         Description="SDK sample" 
         ForegroundText="dark" BackgroundColor="#FFFFFF" ToastCapable="false">
      <DefaultTile ShowName="allLogos" />
      <SplashScreen BackgroundColor="white" Image="images\splash-sdk.png" />
    </VisualElements>
    <Extensions>
      <Extension Category="windows.fileTypeAssociation">
        <FileTypeAssociation Name=".alsdkjs">
          <SupportedFileTypes>
            <FileType>.alsdkjs</FileType>
          </SupportedFileTypes>
        </FileTypeAssociation>
      </Extension>
      <Extension Category="windows.protocol">
        <Protocol Name="alsdkjs" />
      </Extension>
    </Extensions>
  </Application>
</Applications>

関連項目

ConceptsAppコントラクトと拡張機能

要件

Namespace http://schemas.microsoft.com/appx/2010/manifest