アプリケーション (Windows 10)

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

要素階層

<パッケージの>

     <アプリケーションの>

          <アプリケーション>

構文

<Application
  EntryPoint? = 'See the Attributes table for more info.'
  Executable?
  uap10:HostId?
  Id
  uap10:Parameters?
  ResourceGroup?
  uap10:RuntimeBehavior?
  StartPage?
  desktop4:Subsystem?
  uap10:Subsystem?
  desktop4:SupportsMultipleInstances?
  uap10:SupportsMultipleInstances?
  uap10:TrustLevel?
  uap16:BaseNamedObjectsIsolation?
  uap17:BaseNamedObjectsIsolation?
  desktop11:AppLifecycleBehavior?
  uap11:CurrentDirectoryPath?
  uap11:Parameters?

  <!-- Child elements -->
  uap:ApplicationContentUriRules?
  Extensions?
  uap7:Properties
  uap:VisualElements

</Application>

鍵

? 省略可能 (ゼロまたは 1)
& インターリーブ コネクタ (任意の順序で発生する可能性があります)

属性と要素

属性

子要素

親要素

備考

Application 要素には、アプリに関連する機能拡張ポイントに共通する属性が含まれています。 この情報は、アプリに関する情報を取得するために、他の機能拡張ポイントによって使用されます。 アプリケーション 属性は、アプリのインスタンスの起動と管理に されるアクティブ化情報 としても使用されます (つまり、プロセスを開始する方法と、どのような動作を記述します)。

StartPage 属性は、JavaScript アプリにのみ適用されます。 StartPage 指定されていない場合は、Executable 属性と EntryPoint 属性の両方を指定する必要があります (C#、C++、または VB アプリにのみ適用されます)。

uap10 は Windows 10 バージョン 2004 (10.0;ビルド 19041)

uap10 名前空間 (uap10:RuntimeBehavior および uap10:TrustLevel用) は、Windows 10 バージョン 2004 (10.0;ビルド 19041)。 パッケージがそれより古いシステムにインストールされている場合は、同等の属性の組み合わせを指定する必要があります (次のセクションを参照)。そうしないと、アクティブ化情報が不完全になり、インストールは失敗します。

ただし、パッケージに <TargetDeviceFamily MinVersion="10.0.19041.0">以上の場合は、uap10 名前空間をサポートするシステムにのみインストールされます。 その場合は、古い同等の組み合わせよりも優先して、uap10:RuntimeBehavior 属性と uap10:TrustLevel 属性を使用する必要があります (次のセクションを参照)。

アクティブ化情報属性の組み合わせ

アクティブ化情報属性は、Application 要素で指定できます。また、必要に応じて、アプリ スコープの Extension 要素で指定することもできます。 拡張機能で指定されていない場合は、アプリケーション 親から継承されます。 これらの属性は組み合わせて指定します。たとえば、EntryPoint、RuntimeBehavior、および TrustLevel は重複する意味を持ち、組み合わせて指定 (継承) されます。 アクティブ化情報属性の有効な組み合わせをいくつか次に示します。

1. Executable、uap10:RuntimeBehavior="packagedClassicApp"、uap10:TrustLevel=["mediumIL"、または "appContainer" (省略した場合の既定値)]
2. Executable、uap10:RuntimeBehavior="win32App"、uap10:TrustLevel="mediumIL" (その他の要件については、uap10:RuntimeBehaviorに関するこのトピックの説明を参照してください)。
3. Executable, EntryPoint="windows.fullTrustApplication" (uap10:RuntimeBehavior="packagedClassicApp", uap10:TrustLevel="mediumIL")
4. Executable, EntryPoint="windows.partialTrustApplication" (uap10:RuntimeBehavior="packagedClassicApp", uap10:TrustLevel="appContainer")
5. 実行可能な、EntryPoint="<他の>

ご覧のように、ターゲット システムが uap10 名前空間をサポートしていない場合は、代わりに EntryPoint 属性を指定できます。 同様に、以前のシステム uap10:TrustLevel="appContainer"' に相当するものは、EntryPoint ="windows.partialTrustApplication"です。

ただし、uap10:RuntimeBehavior / と EntryPoint の両方同時に指定することは冗長です。 しかし、それを行う場合は、矛盾している場合はエラーです。

ユニバーサル Windows プラットフォーム (UWP) アプリのアクティブ化には、EntryPoint 必要があります。 したがって、実行可能 指定し、uap10:RuntimeBehavior ="windowsApp" (EntryPointを使用しない) をすると、エラーになります。 この場合も、EntryPoint では、"windows.fullTrustApplication" と "windows.partialTrustApplication" 以外のものを指定します。これら 2 つ以外の値は、既に uap10:RuntimeBehavior ="windowsApp"と同じことを言っています。 したがって、この場合は uap10:RuntimeBehavior 冗長になり、実行可能ファイル と EntryPoint 指定します。

uap10:RuntimeBehavior ="win32App" と uap10:TrustLevel="appContainer"設定はサポートされていません。

uap10:TrustLevel="mediumIL" 中に uap10:RuntimeBehavior="windowsApp" を設定するには、Microsoft.coreAppActivation_8wekyb3d8bbwe カスタム機能が必要です。

これは、uap10:TrustLevel="mediumIL" と EntryPoint が "windows.fullTrustApplication" または "windows.partialTrustApplication"以外の値である場合にも当てはまります。

このカスタム機能の詳細については、カスタム機能を参照してください。

複数インスタンス化アプリに関する重要な注意事項

• アプリが Application 要素内 SupportsMultipleInstances を宣言している場合、すべてのフォアグラウンド拡張機能もマルチインスタンス化されます。
• アプリが Application 要素内 SupportsMultipleInstances を宣言する場合は、Extensions レベルで宣言する必要はありません (たとえば、BackgroundTasks や AppService 要素)。
• アプリでは、バックグラウンド タスク、バックグラウンド オーディオ、またはアプリ サービス SupportsMultipleInstances のみを宣言する必要があります。
• コンソール アプリは常にマルチインスタンスであり、SupportsMultipleInstances 明示的に宣言する必要があります。
• アプリでは、マニフェストで ResourceGroup 宣言を使用して、複数のバックグラウンド タスクを同じホストにグループ化できます。 これはマルチインスタンス化と競合し、各アクティブ化は個別のホストに入ります。 そのため、アプリは、SupportsMultipleInstances と ResourceGroup の両方をマニフェストで宣言することはできません。

SupportsMultipleInstances 属性を使用して UWP アプリの複数の個別のインスタンスをサポートする方法の詳細については、「複数インスタンスのユニバーサル Windows アプリを作成する」を参照してください。

必要条件