Visual Studio でデスクトップアプリや UWP アプリをパッケージ化する

[アーティクル]
03/16/2023

アプリは、配布する前にパッケージ化する必要があります。この記事では、Visual Studio を使って MSIX パッケージを構成、作成、テストする方法について説明します。

アプリパッケージの種類

アプリパッケージ (.msix または .appx)
アプリケーションとそのリソースを含む単一のパッケージで、単一のデバイスアーキテクチャを対象とします。たとえば、x64 や x86 のアプリケーションパッケージです。アプリバンドルにより複数のアーキテクチャを対象とするには、アーキテクチャそれぞれに対してパッケージを 1 つずつ作成する必要があります。
アプリバンドル (.msixbundle または .appxbundle)
アプリバンドルは、複数のアプリパッケージを含めることができるパッケージの一種であり、それぞれが特定のデバイスアーキテクチャをサポートするように構築されています。たとえば、アプリバンドルには、x86、x64、ARM 構成用の 3 つの個別のアプリパッケージを含めることができます。アプリバンドルは、可能な限り幅広いデバイスでアプリを使用できるため、可能な限り生成する必要があります。
アプリパッケージのアップロードファイル (.msixupload または .appxupload) - Microsoft Store 申請のみ
複数のアプリパッケージを含めることができる 1 つのファイル、またはさまざまなプロセッサアーキテクチャをサポートするアプリバンドル。アプリパッケージのアップロードファイルには、アプリが Microsoft Store に公開された後にアプリのパフォーマンスを分析するためのシンボルファイルも含められます。 Microsoft Store で公開するためにパートナーセンターに提出する目的で、Visual Studio を使ってアプリをパッケージングする際、このファイルは自動的に作成されます。

アプリパッケージを準備して作成する手順の概要を次に示します。

アプリをパッケージ化する前に。次の手順に従って、アプリのパッケージ化の準備ができていることを確認します。
プロジェクトを構成する。 Visual Studio マニフェストデザイナーを使用してパッケージを構成します。たとえば、タイル画像を追加し、アプリでサポートされている向きを選択します。
アプリパッケージを生成する。 Visual Studio のパッケージ化ウィザードを使用して、アプリパッケージを作成します。
パッケージ化されたアプリケーションを実行、デバッグ、テストする。アプリパッケージの実行とデバッグは、Visual Studio から、あるいはパッケージを直接インストールして行います。

アプリをパッケージ化する前に

アプリをテストする。 アプリケーションをパッケージ化する前に、サポート予定のすべてのデバイスファミリで想定どおりに動作することを確認します。これらのデバイスファミリには、デスクトップ、モバイル、Surface Hub、Xbox、IoT デバイスなどが含まれます。 Visual Studio を使用してアプリをデプロイおよびテストする方法の詳細については、「UWP アプリの展開とデバッグ」を参照してください (パッケージ化されたデスクトップアプリにも適用できます)。
アプリを最適化する。 Visual Studio のプロファイリングおよびデバッグツールを使って、パッケージ化されたアプリケーションのパフォーマンスを最適化できます。たとえば、UI の応答性のタイムラインツール、メモリ使用量ツール、CPU 使用率ツールなどです。これらのツールの詳細については、「プロファイリング機能ツアー」トピックを参照してください。
.NET ネイティブ互換性を確認する (VB と C# のアプリの場合)。 ユニバーサル Windows プラットフォームには、アプリのランタイムパフォーマンスを向上させるネイティブコンパイラがあります。この変更により、このコンパイル環境でアプリをテストする必要があります。既定では、リリース ビルド構成により、.NET ネイティブツールチェーンが可能であるため、重要なのは、このリリース構成でアプリをテストし、想定どおりにアプリが動作することを確認することです。

プロジェクトを構成する

アプリマニフェストファイル (Package.appxmanifest) は、アプリパッケージの作成に必要なプロパティと設定を含む XML ファイルです。たとえば、アプリマニフェストファイルのプロパティは、アプリのタイルとして使用するイメージと、ユーザーがデバイスを回転するときにアプリがサポートする向きを示します。

Visual Studio マニフェストデザイナーを使用すると、ファイルの生の XML を編集せずにマニフェストファイルを更新できます。

マニフェストデザイナーを使用してパッケージを構成する

ソリューションエクスプローラーで、アプリケーションプロジェクトのプロジェクトノードを展開します。
Package.appxmanifest ファイルをダブルクリックします。マニフェストファイルが XML コードビューで既に開いている場合は、ファイルを閉じるよう Visual Studio から求められます。
これで、アプリの構成方法を決定できます。各タブには、アプリに関して構成できる情報と、必要に応じて詳細情報へのリンクが含まれています。

[ビジュアル資産] タブで、アプリに必要なすべての画像があることを確認します。ここで、アプリのアイコンとロゴを指定します。

[パッケージ化] タブでは、発行データを入力できます。ここで、アプリの署名に使用する証明書を選択できます。すべての MSIX アプリは証明書で署名する必要があります。

Note

Visual Studio 2019 以降では、パッケージ化されたデスクトップまたは UWP プロジェクトで一時的な証明書が生成されなくなりました。証明書を作成またはエクスポートするには、こちらの記事に記載されている PowerShell コマンドレットを使用します。 Visual Studio の最近のバージョンでは、開発とテストのシナリオで Azure Key Vault に格納されている証明書を使用してアプリに署名することもできます。

重要

Microsoft Store でアプリを発行する場合、アプリは信頼できる証明書で署名されます。これにより、ユーザーは、関連付けられているアプリ署名証明書をインストールせずにアプリをインストールして実行できます。

アプリパッケージをデバイスにインストールする場合、まずパッケージを信頼する必要があります。パッケージを信頼するには、証明書をユーザーのデバイスにインストールする必要があります。
アプリに必要な編集を 行った後、Package.appxmanifest ファイルを保存します。

Microsoft Store を使ってアプリを配布する場合、Visual Studio は Microsoft Store とパッケージを関連付けることができます。これを行うには、ソリューションエクスプローラーでプロジェクト名を右クリックして、[発行]->[アプリケーションをストアと関連付ける] を選択します (Visual Studio 2019 バージョン 16.3 より前の場合、[発行] メニューの名前は [ストア] です)。また、これはアプリパッケージの作成ウィザードで実行することもできます。続くセクションで説明します。アプリを関連付けると、マニフェストデザイナーの [パッケージ化] タブの一部のフィールドが自動的に更新されます。

アプリパッケージを生成する

Microsoft Intune や Configuration Manager などのアプリケーション管理ツールを使用して自分の Web サイトでアプリを公開すれば、Microsoft Store で公開しなくてもアプリをインストールすることができます。ローカルコンピューターまたはリモートコンピューターで、テスト用の MSIX パッケージを直接インストールすることもできます。

パッケージ化ウィザードを使用してアプリパッケージを作成する

Note

次の手順とスクリーンショットは、Visual Studio 2019 バージョン 16.3 時点での説明です。それより前のバージョンを使用している場合、UI の外観が異なることがあります。デスクトップアプリケーションをパッケージ化する場合、Windows アプリケーションパッケージプロジェクトノードを右クリックします。

ソリューションエクスプローラーで、アプリケーションプロジェクトのソリューションを開きます。
プロジェクトを右クリックし、[発行]->[アプリパッケージの作成] を選択します (Visual Studio 2019 バージョン 16.3 より前の場合、[発行] メニューの名前は [ストア] です)。
ウィザードの最初のページで [サイドローディング] を選択し、[次へ] をクリックします。
[署名方法の選択] ページで、パッケージの署名をスキップするか、署名用の証明書を選択します。ローカルの証明書ストアから証明書を選択するか、証明書ファイルを選択するか、新しい証明書を作成できます。エンドユーザーのコンピューターにインストールされる MSIX パッケージの場合、そのコンピューター上で信頼されている証明書で署名されている必要があります。
「Visual Studio を使用してアプリパッケージのアップロードファイルを作成する」セクションで説明するように、[パッケージの選択と構成] ページを完成させます。

ダブルクリックでアプリパッケージをインストールする

アプリパッケージは、アプリパッケージファイルをダブルクリックするだけでインストールできます。そうするには、アプリパッケージまたはアプリバンドルファイルに移動し、それをダブルクリックします。アプリインストーラーが起動し、アプリの基本情報と、インストールボタン、インストール進行状況バー、関連するエラーメッセージが表示されます。

Note

アプリインストーラーは、パッケージがデバイス上で信頼されている証明書で署名されていることを前提としています。署名されていない場合は、デバイス上の信頼されたユーザーストアまたは信頼された発行元証明機関ストアに署名証明書をインストールする必要があります。これを行う方法がわからない場合は、「テスト証明書のインストール」を参照してください。

インストールスクリプトを使用してアプリパッケージをインストールする

*_Test フォルダーを開きます。
Add-AppDevPackage.ps1 ファイルを右クリックします。 [PowerShell で実行] を選択し、画面の指示に従います。

アプリパッケージがインストールされると、PowerShell ウィンドウに次のメッセージが表示されます。 アプリが正常にインストールされました。
[スタート] ボタンをクリックしてアプリを名前で検索し、起動します。

次の手順: アプリパッケージをデバッグおよびテストする

Visual Studio で、または Windows デバッグツールを使用してアプリケーションをデバッグする方法については、アプリパッケージの実行、デバッグ、テストに関するページを参照してください。

Microsoft Store 申請のためのアプリパッケージのアップロードファイルを生成する

アプリを Microsoft Store に配布するには、アプリパッケージのアップロードファイル (.msixupload または .appxupload) を生成して、このファイルをパートナーセンターに提出することをお勧めします。アプリパッケージまたはアプリバンドルのみをパートナーセンターに提出することも可能ですが、アプリパッケージのアップロードファイルを提出することをお勧めします。

アプリパッケージのアップロードファイルは、Visual Studio で [アプリパッケージの作成] ウィザードを使用して作成するか、既存のアプリパッケージまたはアプリバンドルから手動で作成することができます。

Note

アプリパッケージ (.msix または .appx) またはアプリバンドル (.msixbundle または .appxbundle) を手動で作成する場合、MakeAppx.exe ツールを使ったアプリパッケージの作成についての記事を参照してください。

Visual Studio を使用してアプリパッケージのアップロードファイルを作成する

Note

次の手順とスクリーンショットは、Visual Studio 2019 バージョン 16.3 時点での説明です。それより前のバージョンを使用している場合、UI の外観が異なることがあります。

ソリューションエクスプローラーで、UWP アプリプロジェクトのソリューションを開きます。
プロジェクトを右クリックし、[発行]->[アプリパッケージの作成] を選択します (Visual Studio 2019 バージョン 16.3 より前の場合、[発行] メニューの名前は [ストア] です)。このオプションが無効になっているか、まったく表示されない場合は、プロジェクトがユニバーサル Windows プロジェクトであることをチェックします。

アプリパッケージの作成 ウィザードが表示されます。
最初のダイアログで [新しいアプリ名で Microsoft Store に] を選択し、[次へ] をクリックします。

プロジェクトがすでに Microsoft Store 内のアプリに関連付けられている場合、関連付けられている Microsoft Store アプリのパッケージを作成するオプションも表示されます。 [サイドローディング] を選択すると、Visual Studio では、パートナーセンターへの申請のためのアプリパッケージのアップロードファイル (.msixupload または .appxupload) は生成されません。 Microsoft Store での配布以外の目的で MSIX パッケージまたはバンドルを作成したいだけの場合、このオプションを選択します。
次のページで、開発者アカウントを使用してパートナーセンターにサインインします。開発者アカウントがまだない場合は、ウィザードを使用して作成できます。
アカウントに現在登録されているアプリのリストから、パッケージのアプリ名を選択するか、パートナーセンターでまだ名前を予約していない場合は、新しく予約します。
[パッケージの選択と構成] ダイアログで 3 つのアーキテクチャ構成 (x86、x64、ARM) をすべて選択して、アプリを最も幅広いデバイスに展開できることを確認します。 [アプリバンドルの生成] リストボックスで、[常に] を選択します。アプリバンドル (.appxbundle または .msixbundle) は、プロセッサアーキテクチャの種類ごとに構成されているアプリパッケージのコレクションが含まれているため、単一のアプリパッケージファイルよりも優先されます。アプリバンドルの生成を選ぶと、デバッグおよびクラッシュ分析情報と共に、アプリバンドルが最終的なアプリパッケージアップロード (.appxupload または .msixupload) ファイルに含められます。どのアーキテクチャを選択すべきかわからない場合や、さまざまなデバイスで使用されるアーキテクチャの詳細については、アプリパッケージのアーキテクチャに関するページをご参照ください。
アプリが公開された後にパートナーセンターからアプリのパフォーマンスを分析するために、パブリックシンボルファイルを含めます。バージョン番号やパッケージの出力場所などの追加の詳細を構成します。
[作成] をクリックしてアプリパッケージを生成します。手順 3 で [Microsoft Store にアップロードするパッケージを作成します] のオプションのうちの 1 つを選択し、パートナーセンターへの申請のためのパッケージを作成している場合、ウィザードではパッケージのアップロードファイル (.appxupload または .msixupload) が作成されます。手順 3 で[サイドロード用のパッケージを作成します] を選択した場合、ウィザードでは手順 6 の選択内容に基づいて、単一のアプリパッケージまたはアプリバンドルが作成されます。
アプリのパッケージ化が成功すると、このダイアログが表示され、指定された出力場所からアプリパッケージのアップロードファイルを取得できます。この時点で、ローカルコンピューターまたはリモートコンピューター上でアプリパッケージを検証し、Microsoft Store 申請を自動化できます。

アプリパッケージのアップロードファイルを手動で作成する

フォルダー内に次のファイルを配置します。
- 1 つまたは複数のアプリパッケージ (.msix または .appx) またはアプリバンドル (.msixbundle または .appxbundle)。
- .appxsym ファイル。これは、アプリのパブリックシンボルが格納された圧縮 .pdb ファイルです。これらのパブリックシンボルは、パートナーセンターでのクラッシュ分析に使われます。このファイルは省略できますが、アプリのクラッシュ分析やデバッグ情報は利用できなくなります。
フォルダー内のすべてのファイルを選択して、ファイルを右クリックし、[送信]->[圧縮 (zip 形式) フォルダー] を選択します。
新しい zip ファイルの拡張子の名前を、.zip から .msixupload または .appxupload に変更します。

アプリパッケージを検証する

認定のためにパートナーセンターに提出する前に、ローカルコンピューターまたはリモートコンピューターでアプリを検証します。デバッグビルドではなく、アプリパッケージのリリースビルドのみを検証できます。パートナーセンターへのアプリの申請について詳しくは、「アプリの申請」を参照してください。

アプリパッケージをローカルで検証する

アプリパッケージの作成ウィザードの最後の [パッケージの作成が完了しました] ページで、[ローカルコンピューター] オプションを選択した状態で [Windows アプリ認定キットを起動する] をクリックします。 Windows アプリ認定キットを使用したアプリのテストの詳細については、「Windows アプリ認定キット」を参照してください。

Windows アプリ認定キット (WACK) はさまざまなテストを実行し、結果を返します。詳細については、 Windows アプリ認定キットのテストを参照してください。

リモート Windows 10 デバイスを使ってテストする場合は、そのデバイスに Windows アプリ認定キットを手動でインストールする必要があります。次のセクションでは、これらの手順について説明します。これを完了したら、リモートコンピューターを選択し、[Windows アプリ認定キットの起動] をクリックしてリモートデバイスに接続し、検証テストを実行できます。
WACK の完了後、アプリが認定に合格したら、パートナーセンターにアプリを提出できるようになります。正しいファイルをアップロードしてください。ファイルは既定の位置は、ソリューションのルートフォルダー \[AppName]\AppPackages にあり、.appxupload または .msixupload というファイル拡張子が付いています。パッケージアーキテクチャがすべて選択されたアプリバンドルを選んだ場合、名前は [AppName]_[AppVersion]_x86_x64_arm_bundle.appxupload または [AppName]_[AppVersion]_x86_x64_arm_bundle.msixupload の形式になります。

リモート Windows 10 デバイスでアプリパッケージを検証する

「デバイスを開発用に有効にする」の手順に従って、開発用に Windows 10 デバイスを有効にします。

重要

Windows 10 のリモート ARM デバイスでアプリパッケージを検証することはできません。
Visual Studio 用のリモートツールをダウンロードしてインストールします。これらのツールは、Windows アプリ認定キットをリモートで実行するために使用されます。これらのツールのダウンロード場所などの詳細については、リモートコンピューターでの MSIX アプリケーションの実行に関するページをご覧ください。
必要な Windows アプリ認定キットをダウンロードし、リモート Windows 10 デバイスにインストールします。
ウィザードの [パッケージの作成が完了しました] ページで、[リモートコンピューター] オプションボタンを選択し、[テスト接続] ボタンの横にある省略記号ボタンを選択します。

Note

[リモートコンピューター] オプションボタンは、検証をサポートする 1 つ以上のソリューション構成を選択した場合にのみ使用できます。 WACK を使用したアプリのテストの詳細については、「Windows アプリ認定キット」を参照してください。
サブネット内のデバイスフォームを指定するか、サブネットの外部にあるデバイスの Doメインネームサーバー (DNS) 名または IP アドレスを指定します。
デバイスで Windows 資格情報を使用してログオンする必要がない場合は、[認証モード] の一覧で [なし] を選択します。
[選択] ボタンを選択し、[Windows アプリ認定キットの起動] ボタンを選択します。リモートツールがそのデバイスで実行されている場合、Visual Studio はデバイスに接続し、検証テストを実行します。 Windows アプリ認定キットのテストを参照してください。

Microsoft Store 申請の自動化

Visual Studio 2019 以降では、アプリパッケージの作成ウィザードの最後にある [Windows アプリ認定キットの検証後に自動的に Microsoft Store に送信します] オプションを選択すれば、生成した .appxupload ファイルを IDE から直接 Microsoft Store に提出できます。この機能は、アプリの公開に必要なパートナーセンターアカウントの情報にアクセスするために、Azure Active Directory を利用します。この機能を使用するには、Azure Active Directory をパートナーセンターアカウントに関連付けて、申請に必要ないくつかの認証情報を取得する必要があります。

Azure Active Directory とパートナーセンターアカウントとの関連付け

自動 Microsoft Store 申請に必要な認証情報を取得する前に、まだしていなければ、パートナーセンターダッシュボードで次の手順を実行する必要があります。

パートナーセンターアカウントと組織の Azure Active Directory を関連付けます。組織で既に Office 365 または Microsoft の他のビジネスサービスを使用している場合は、Azure AD が既にあります。それ以外の場合は、パートナーセンター内から新しい Azure AD テナントを追加料金なしで作成できます。
Azure AD アプリケーションをパートナーセンターアカウントに追加します。この Azure AD アプリケーションは、デベロッパーセンターアカウントへの申請のために使用するアプリまたはサービスのことです。このアプリケーションをマネージャー ロールに割り当てる必要があります。このアプリケーションが Azure AD ディレクトリに既に存在する場合は、[Azure AD アプリケーションの追加] ページでアプリケーションを選択して、デベロッパーセンターアカウントに追加できます。それ以外の場合は、[Azure AD アプリケーションの追加] ページで新しい Azure AD アプリケーションを 作成できます。

申請に必要な認証情報を取得する

次に、申請に必要なパートナーセンターの認証情報を取得します。Azure テナント ID、クライアント ID、クライアントキーです。

パートナーセンターダッシュボードに移動し、Azure AD の認証情報でサインインします。
パートナーセンターダッシュボードで、歯車アイコン (ダッシュボードの右上隅の近く) を選択し、[開発者向け設定] を選択します。
左側ペインの [設定] メニューで、[ユーザー] をクリックします。
Azure AD アプリケーションの名前をクリックして、アプリケーションの設定に移動します。このページで、[テナント ID] と [クライアント ID] の値をコピーします。
[キー] セクションで、[新しいキーを追加] をクリックします。次の画面で、クライアントシークレットに対応する [キー] の値をコピーします。このページを離れるとこの情報には二度とアクセスできなくなるため、なくさないようにしてください。詳細については、「Azure AD アプリケーションのキーを管理する」を参照してください。

Visual Studio で自動 Microsoft Store 申請を構成する

ここまでの手順を終えたら、Visual Studio 2019 で自動 Microsoft Store 申請を構成できます。

アプリパッケージの作成ウィザードの最後で、[Windows アプリ認定キットの検証後に自動的に Microsoft Store に送信します] を選択して、[再構成] をクリックします。
[Microsoft Store 送信設定の構成] ダイアログで、Azure テナント ID、クライアント ID、クライアントキーを入力します。

重要

将来の申請で使用できるように、認証情報をプロファイルに保存することができます
OK をクリックします。

WACK テストが完了すると、申請が開始します。 [確認と発行] ウィンドウで、申請の進行状況を追跡できます。

Verify and Publish progress

Visual Studio でデスクトップアプリや UWP アプリをパッケージ化する

アプリパッケージの種類

アプリをパッケージ化する前に