アプリケーション (Windows 8 のパッケージスキーマ)

パッケージで提供される機能の一部またはすべてを構成するアプリを表します。

要素の階層

<Package>
<アプリケーション>
<適用>

構文

<Application Id          = An ASCII string between 1 and 64 characters in length. See the Attributes table for more information on character restrictions.
             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.

             StartPage?  = A string between 1 and 256 characters in length that cannot contain these characters: <, >, :, %, ", |, ?, or *. >

  <!-- Child elements -->
  ( VisualElements
  & ApplicationContentUriRules?
  & Extensions?
  )

</Application>

Key

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

& インターリーブコネクタ (任意の順序で発生する可能性があります)

属性および要素

属性

属性 説明 データ型 必須 既定値
EntryPoint

"" Office など、アクティブ化可能なクラス ID。Winword.exe. クラス "。

デスクトップアプリの場合、この値は実行可能ファイルの実際のエントリポイント ("main"、"WinMain"、"wWinMain" など) である必要があります。

この属性を指定する場合は、 Executable 属性も指定する必要があります。 この属性を指定する場合は、 StartPage 属性を指定しないでください。

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

アプリの既定の起動実行可能ファイル。 このファイルはパッケージ内に存在する必要があります。

この属性を指定する場合は、 EntryPoint 属性を指定する必要があります。 この属性を指定する場合は、 StartPage 属性を指定しないでください。

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

パッケージ内のアプリケーションの一意識別子です。 この値は、パッケージ相対アプリ識別子 (PRAID) とも呼ばれます。

ID はパッケージ内で一意ですが、グローバルには一意ではありません。 システム上には、同じ ID が使用されている別のパッケージが存在してもかまいません。 同じパッケージ内で同じ ID を複数回使用することはできません。

この文字列には、ピリオドで区切られた英数字フィールドが含まれています。 各フィールドは、ASCII アルファベット文字で始まる必要があります。 以下はフィールドの値として使用できません。"CON"、"PRN"、"AUX"、"NUL"、"COM1"、"COM2"、"COM3"、"COM4"、"COM5"、"COM6"、"COM7"、"COM8"、"COM9"、"LPT1"、"LPT2"、"LPT3"、"LPT4"、"LPT5"、"LPT6"、"LPT7"、"LPT8"、"LPT9"。

Visual Studio テンプレートを使用する場合、この属性の既定値は "App" です。 開発者は、マニフェストでこれを手動で変更する必要があります。

アプリが Microsoft Store に発行された後でアプリの識別子を変更することはできません。これを行うと、スタート画面のタイルの位置が混乱します。

1 ~ 64 文字の長さの ASCII 文字列。 はい
StartPage

アプリの既定の起動 HTML ページ。 このファイルはパッケージ内に存在する必要があります。

この属性を指定する場合は、 EntryPoint 属性も Executable 属性も指定できません。

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

 

子要素

子要素 説明
ApplicationContentUriRules

Web コンテキスト内のどのページがシステムの位置情報デバイス (この機能にアクセスするためのアクセス許可を持っている場合) にアクセスし、クリップボードにアクセスできるかを指定します。

拡張機能 (型: CT_ApplicationExtensions)

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

VisualElements

UWP アプリのビジュアルな側面 (既定のタイル、ロゴ画像、テキストと背景の色、初期画面の向き、スプラッシュスクリーン、ロック画面のタイルの外観) について説明します。

 

親要素

Parent 要素 説明
アプリケーション

パッケージを構成する1つ以上のアプリを表します。

 

注釈

Application要素には、アプリに関連する機能拡張ポイントに共通する属性が含まれています。 この情報は、アプリに関する情報を取得するために、他の拡張ポイントによって使用されます。 また、 アプリケーション の属性は、アプリのインスタンスの開始と管理にも使用されます。

StartPage属性が指定されている場合は、JavaScript を使用した Windows アプリです。 StartPageが指定されていない場合は、 Executable属性とEntryPoint属性の両方を指定する必要があります。これは、C# または VB および XAML を使用する UWP アプリです。

次の例は、いずれかの 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