次の方法で共有

アプリ機能マニフェスト

  • [アーティクル]

アプリ機能マニフェストは、イメージに含めるアプリのファイルの場所を定義します。 他の機能マニフェストと同様に、アプリ FM で定義されたアプリをイメージに含めるには、アプリ機能マニフェストをイメージの OEMInput.xml ファイルにある <AdditionalFMs> 要素に含める必要があります。

最初のイメージでは、CreateWSKAppsFM と UpdateWSKAppsFM を使用して、ワークスペースのアプリ フォルダ内のすべてのアプリを一度にイメージに追加できます。

サンプル OEMAppsFM.xml マニフェスト

<?xml version="1.0" encoding="utf-8"?>
<FeatureManifest 
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
  xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
  xmlns="http://schemas.microsoft.com/embedded/2004/10/ImageUpdate" Revision="1" SchemaVersion="1.2">
  <AppX>
    <AppXPackages>
      <PackageFile Path="%WSKWorkspaceRoot%\Apps\Calculator" Name="Microsoft.WindowsCalculator_8wekyb3d8bbwe.appxbundle" LicenseFile="Microsoft.WindowsCalculator_8wekyb3d8bbwe.xml" ID="Microsoft.WindowsCalculator_8wekyb3d8bbwe" Optional="false" />
      <PackageFile Path="%WSKWorkspaceRoot%\Apps\Frameworks" CPUType="x86" Name="Microsoft.VCLibs.x86.14.00.appx" ID="Microsoft.VCLibs.140.00_8wekyb3d8bbwe" Optional="false" />
      <PackageFile Path="%WSKWorkspaceRoot%\Apps\Frameworks" CPUType="amd64" Name="Microsoft.VCLibs.x64.14.00.appx" ID="Microsoft.VCLibs.140.00_8wekyb3d8bbwe" Optional="false" />
      <PackageFile Path="%WSKWorkspaceRoot%\Apps\Frameworks" CPUType="arm" Name="Microsoft.VCLibs.arm.14.00.appx" ID="Microsoft.VCLibs.140.00_8wekyb3d8bbwe" Optional="false" />
      <PackageFile Path="%WSKWorkspaceRoot%\Apps\ContosoApp" Name="Contoso.Sampleapp_8wekyb3d8bbwe.appxbundle" LicenseFile="Contoso.Sampleapp_8wekyb3d8bbwe.xml" ID="Contoso.Sampleapp_8wekyb3d8bbwe" Optional="false" />
    </AppXPackages>
  </AppX>
</FeatureManifest>

オプションのアプリ

Windows システム キットのスクリプトは、アプリ FM 内のすべてのアプリを構成して、イメージに含まれるようにします。 アプリ FM を変更して、イメージに含める OEMInput.xml にアプリを具体的に追加する必要があります。

アプリ FM に含まれる各アプリには、アプリをイメージに自動的に含めるかどうか、またはその ID を OEMInput.xml に追加してアプリを手動でイメージに含める必要があるかどうかを制御する Optional 属性があります。

複数のイメージに対して 1 つの資料セットを使用している場合、アプリをオプションとしてマークすると、アプリを特定のイメージ構成に含めることができます。 このシナリオのアプリ FM には、以下を指定しながらすべてのアプリを資料セットに含めることができます。

  • すべてのイメージに含めるアプリの基本セット
  • 特定の OEMInput.xml ファイルに手動で追加できるオプションのアプリのセット

オプションとマークされたアプリは、イメージ デザインに具体的に含めない限り、どのイメージにも含まれません。 これにより、アプリ機能マニフェストを複数のイメージに再利用できます。

オプションのアプリを操作する

アプリをオプションとして指定し、イメージに手動で追加するには:

  1. オプションとしてマークするアプリを選択します。

  2. アプリ FM でアプリの Optional 属性を "true" に変更します。 これにより、アプリがオプションとしてマークされ、アプリはすべてのイメージに含まれなくなります。

    <PackageFile Path="%WSKWorkspaceRoot%\Apps\ContosoApp" Name="Contoso.Sampleapp_8wekyb3d8bbwe.appxbundle" LicenseFile="Contoso.Sampleapp_8wekyb3d8bbwe.xml" ID="Contoso.Sampleapp_8wekyb3d8bbwe" Optional="true" />

  3. アプリ ID (ID="Contoso.Sampleapp_8wekyb3d8bbwe" など) に注意してください。 この ID を変更しないでください。変更すると、イメージのビルドに失敗します。

    Microsoft Store からアプリを入手した場合は、アプリのライセンスにパッケージ ファミリ名が記載されています。 テキスト エディターでライセンス ファイルを開き、PFM タグの間の値を使用します。

  4. OEMInput.xml に <AppXID> 値として ID を追加することにより、オプションのアプリをイメージに追加します。

    <AppXOptionalPackages> 
  <AppXID>Contoso.Sampleapp_8wekyb3d8bbwe</AppXID>
</AppXOptionalPackages>

CPUType="(arch)" を追加して、アプリをアーキテクチャ固有として指定することもできます。 イメージをビルドする場合、アーキテクチャの種類と一致しないファイルは除外されます。

SetAppsRegion コマンド ライン構文

SetAppsRegion -AppName <AppName> -Region <Region> [-OEMAppsFMPath <path>]
SetAppsRegion -AppName HelloWorld_1.0.0.0_x64.appx -Region en-us,de-de
パラメーター 説明
-AppName アプリのファイル名。 アプリの <PackageFile> 要素で Name 属性を使用します。
-Region アプリを使用できるようにする 1 つまたは複数のリージョン。 複数のリージョンを指定する場合は、リージョンを ,：-Region en-us,de-de で区切ります。
-OEMAppsFMPath アプリ FM へのパス。 既定値は %WSKWorkspaceRoot%\FMFiles\OEMAppsFM.xml です

関連項目

ドライバー機能マニフェスト