拡張機能 (型: CT_ApplicationExtensions)

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

要素の階層

<パック>
<プログラム>
<適用>
<補助>
<拡張機能>

構文

<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>

キー

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

属性および要素

属性

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

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

この属性には、次のいずれかの値を指定できます。

  • windows. fileTypeAssociation
  • windows. プロトコル
  • windows. autoPlayContent
  • windows. autoPlayDevice
  • shareTarget
  • windows. 検索
  • windows. fileOpenPicker
  • fileSavePicker
  • windows.cachedFileUpdater
  • windows.contactPicker
  • windows.backgroundTasks
  • windows.cameraSettings
  • windows.accountPictureProvider
  • windows.printTaskSettings
はい
EntryPoint

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

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

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

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

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

長さが 1 ~ 255 文字の文字列。ピリオドで始まるか終わるか < > 、:、%、、/、|、?、 " \, または *の文字を含めることはできません。 いいえ
StartPage

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

長さが 1 ~ 256 文字の文字列 < > 。、、:、%、|、?、 " または *。 いいえ

子要素

子要素 説明
AutoPlayContent

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

AutoPlayDevice

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

BackgroundTasks

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

FileOpenPicker

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

FileSavePicker

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

Appv.filetypeassociation

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

プロトコール

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

ShareTarget

windows.shareTarget型のアプリ拡張ポイントを宣言します。 アプリは、指定された種類のファイルを共有できます。

親要素

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

アプリの 1 つ以上の機能拡張ポイントを定義します。

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

注釈

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

  • windows.accountPictureProvider
  • windows.cachedFileUpdater
  • windows.cameraSettings
  • windows.contactPicker
  • windows.fileOpenPicker
  • windows.fileSavePicker
  • windows.printTaskSettings
  • windows.search
  • windows.shareTarget

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

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

  • 空になる可能性あり
  • StartPage を指定できます
  • BackgroundTask 拡張機能でない限り、実行可能ファイルとエントリポイントの両方を指定できます (オプションで System.runtimetype が許可されます)。この場合、実行可能ファイルと既定で BackgroundTaskHost.exe 実行可能ファイルを省略できます。

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

  • 空になる可能性あり
  • StartPage のみを指定できます
  • 実行可能ファイルまたは System.runtimetype が指定されている場合は、EntryPoint を指定する必要があります。

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

<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>

参照

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

要件

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