MSIX パッケージコンポーネントの生成

[アーティクル]
11/01/2022

この記事では、コマンドラインツールを使用して (Visual Studio または MSIX パッケージ化ツールを使用せずに) アプリケーションをパッケージ化するための MSIX パッケージコンポーネントを生成する方法について説明します。

アプリを手動でパッケージ化するには、パッケージマニフェストファイルを作成し、パッケージコンポーネントを追加してから、MakeAppx.exe コマンドラインツールを実行して MSIX パッケージを生成する必要があります。

最初にパッケージ化の準備をする

まだ確認していない場合は、アプリケーションをパッケージ化する前に理解しておく必要があることに関するセクションを確認してください。

パッケージマニフェストを作成する

ファイルを作成し、appxmanifest.xml という名前を付けて、以下の XML を追加します。

これは、パッケージに必要な要素や属性が含まれた基本テンプレートです。次のセクションで、これらに値を追加します。

<?xml version="1.0" encoding="utf-8"?>
<Package
  xmlns="http://schemas.microsoft.com/appx/manifest/foundation/windows10"
  xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
  xmlns:rescap="http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities">
  <Identity Name="" Version="" Publisher="" ProcessorArchitecture="" />
  <Properties>
    <DisplayName></DisplayName>
    <PublisherDisplayName></PublisherDisplayName>
    <Description></Description>
    <Logo></Logo>
  </Properties>
  <Resources>
    <Resource Language="" />
  </Resources>
  <Dependencies>
    <TargetDeviceFamily Name="Windows.Desktop" MinVersion="" MaxVersionTested="" />
  </Dependencies>
  <Capabilities>
    <rescap:Capability Name="runFullTrust"/>
  </Capabilities>
  <Applications>
    <Application Id="" Executable="" EntryPoint="Windows.FullTrustApplication">
      <uap:VisualElements DisplayName="" Description=""	Square150x150Logo=""
        Square44x44Logo="" BackgroundColor="" />
    </Application>
  </Applications>
</Package>

ファイルのパッケージレベル要素に値を設定する

このテンプレートに、パッケージを説明する情報を設定します。

ID 情報

Identity 要素の例を以下に示します。各属性にはプレースホルダーテキストが指定されています。 ProcessorArchitecture 属性は、x64、x86、arm (つまり 32 ビット ARM)、arm64、または neutral に設定できます。

<Identity Name="MyCompany.MySuite.MyApp"
          Version="1.0.0.0"
          Publisher="CN=MyCompany, O=MyCompany, L=MyCity, S=MyState, C=MyCountry"
			    ProcessorArchitecture="x64">

注意

Microsoft Store でアプリケーション名を予約済みの場合は、パートナーセンターを使用して、名前と発行元を取得できます。アプリケーションを他のシステムにサイドロードすることを計画している場合は、独自の名前を指定することができます。ただし、選択する発行元名は、アプリへの署名に使用する証明書の名前と一致する必要があります。

プロパティ

Properties 要素には、必須の子要素が 3 つあります。次に示すのは、Properties ノードの例です。要素はプレースホルダーテキストが指定されています。 DisplayName は、Microsoft Store にアップロードするアプリ用に、Microsoft Store で予約するアプリケーションの名前です。

<Properties>
  <DisplayName>MyApp</DisplayName>
  <PublisherDisplayName>MyCompany</PublisherDisplayName>
  <Logo>images\icon.png</Logo>
</Properties>

リソース

次に Resources ノードの例を示します。

<Resources>
  <Resource Language="en-us" />
</Resources>

依存関係

パッケージを作成する対象のデスクトップアプリに対して、常に Name 属性を Windows.Desktop に設定します。

<Dependencies>
<TargetDeviceFamily Name="Windows.Desktop" MinVersion="10.0.14316.0" MaxVersionTested="10.0.15063.0" />
</Dependencies>

機能

パッケージを作成する対象のデスクトップアプリに対して、runFullTrust 機能を追加する必要があります。

<Capabilities>
  <rescap:Capability Name="runFullTrust"/>
</Capabilities>

アプリケーションレベル要素に値を設定する

このテンプレートに、アプリを説明する情報を指定します。

Application 要素

パッケージを作成する対象のデスクトップアプリに対して、Application 要素の EntryPoint 属性は常に Windows.FullTrustApplication です。

<Applications>
  <Application Id="MyApp"     
		Executable="MyApp.exe" EntryPoint="Windows.FullTrustApplication">
   </Application>
</Applications>

視覚要素

次に VisualElements ノードの例を示します。

<uap:VisualElements
	BackgroundColor="#464646"
	DisplayName="My App"
	Square150x150Logo="images\icon.png"
	Square44x44Logo="images\small_icon.png"
	Description="A useful description" />

(省略可能) ターゲットベースのプレートなしのアセットを追加する

ターゲットベースのアセットは、Windows タスクバー、タスクビュー、スナップアシスト、Alt + Tab キーを押したとき、およびスタート画面のタイルの右下に表示されるアイコンおよびタイルで使用されます。これらについて詳しくは、こちらをご覧ください。

正しい 44 x 44 画像を取得して、画像保存用のフォルダー (Assets) にコピーします。
各 44 x 44 画像のコピーを同じフォルダーに作成し、ファイル名の末尾に .targetsize-44_altform-unplated を追加します。これにより、同じ画像で異なる名前のアイコンが、2 つずつフォルダーに保存されます。たとえば、プロセスの完了後には、assets フォルダーに MYAPP_44x44.png と MYAPP_44x44.targetsize-44_altform-unplated.png のようなファイルが含まれています。

注意

この例では、MYAPP_44x44.png という名前のアイコンは、MSIX パッケージの Square44x44Logo ロゴ属性で参照されるアイコンです。
マニフェストファイルで、透明にするすべてのアイコンについて BackgroundColor を設定します。
次のサブセクションに進み、新しいパッケージリソースインデックスファイルを生成します。

MakePri を使用してパッケージリソースインデックス (PRI) ファイルを生成する

前のセクションで説明したようにターゲットベースのアセットを作成する場合や、パッケージを作成した後、アプリケーションのビジュアルアセットのいずれかを変更する場合は、新しい PRI ファイルを生成する必要があります。

SDK のインストールパスに基づき、MakePri.exe は Windows 10 PC の以下の場所にあります。

x86: C:\Program Files (x86)\Windows Kits\10\bin\<ビルド番号>\x86\makepri.exe
x64: C:\Program Files (x86)\Windows Kits\10\bin\<ビルド番号>\x64\makepri.exe

このツールの ARM バージョンはありません。

コマンドプロンプトまたは PowerShell ウィンドウを開きます。
パッケージのルートフォルダーにディレクトリを変更した後、<path>\makepri.exe createconfig /cf priconfig.xml /dq en-US コマンドを実行して priconfig.xml ファイルを作成します。
コマンド <path>\makepri.exe new /pr <PHYSICAL_PATH_TO_FOLDER> /cf <PHYSICAL_PATH_TO_FOLDER>\priconfig.xml を使用して、resources.pri ファイルを作成します。

たとえば、アプリケーション用のコマンドは、<path>\makepri.exe new /pr c:\MYAPP /cf c:\MYAPP\priconfig.xml のようになります。
次の手順の説明に従ってアプリケーションをパッケージ化します。

パッケージ化する前にアプリケーションをテストする

パッケージ化または署名する前に、パッケージ化されていないアプリケーションを展開してテストすることができます。これを行うには、PowerShell ウィンドウから次のコマンドレットを実行します。パッケージディレクトリのルートにあるアプリケーションのマニフェストファイルを、他のすべてのパッケージコンポーネントと共に必ず渡すようにしてください。

Add-AppxPackage –Register AppxManifest.xml

これが完了すると、アプリはシステム上に展開され、パッケージ化する前に、すべてが機能することを確認するためにアプリをテストできます。アプリの .exe または .dll ファイルを更新するには、パッケージ内の既存のファイルを新しいファイルに置き換え、AppxManifest.xml のバージョン番号を繰り上げて、上記のコマンドをもう一度実行します。

コンポーネントを MSIX にパッケージ化する

次の手順では、MakeAppx.exe を使用して、アプリケーションの MSIX パッケージを生成します。 MakeAppx.exe は Windows 10 SDK に含まれています。Visual Studio がインストールされている場合は、Visual Studio の開発者コマンドプロンプトから簡単にアクセスできます。

MakeAppx.exe ツールで MSIX パッケージまたはバンドルを作成する方法に関するページを参照してください。

注意

パッケージ化したアプリケーションは、常に対話ユーザーとして実行されます。パッケージ化したアプリケーションをインストールするドライブは、NTFS 形式にフォーマットされている必要があります。

MSIX パッケージ コンポーネントの生成