埋め込みアプリ インストーラー ファイルを使用したアプリの更新

重要

embedded アプリのインストーラーファイルの使用は、現在、Windows 10 の Windows Insider ビルドで利用できます。

アプリインストーラーファイルは、Windows アプリが更新プログラムの検索を走査し、修復するための更新パスを提供します。

Visual Studio を使用して、埋め込みアプリインストーラーファイルで Windows アプリをビルドして発行する場合、Windows 10 SDK 2104 (以降) がインストールされていること、およびプロジェクトプロパティの対象バージョン Windows 10 が 21h1 (またはそれ以降) であることを確認する必要があります。 これが構成されていない場合、Windows アプリのインストール時に、Windows アプリによって埋め込み AppInstaller 構成がデバイスに設定されません。

方法-MSIX パッケージ化ツール

次の手順では、msix パッケージ化ツールを使用して、既存の Windows アプリを編集し、埋め込みアプリインストーラーアプリを含める方法を説明します。

注意

次のガイダンスでは、既に Visual Studio を使用してアプリインストーラーファイルを作成し、msix Toolkit を使用して、または手動でアプリインストーラーファイルを作成したことを前提としています。 アプリのインストーラーファイルの作成に関するガイダンスについては、次のドキュメントの記事のいずれかを参照してください。

Windows アプリを開いて編集する

次の手順では、Microsoft msix パッケージングツールアプリを使用して、Windows アプリの編集を開始する方法を説明します。

  1. Microsoft msix パッケージ化ツールを起動します (Microsoft Store: msix パッケージ化ツールで入手できます)。
  2. 既存のパッケージを編集するには、[ パッケージエディター ] ボタンを選択します。
  3. [参照] ボタンを選択し、メッセージが表示されたら Windows アプリを見つけて、[開く] ボタンを選択します。
  4. [ パッケージを開く ] ボタンを選択します。

アプリのインストーラーファイルを Windows アプリにインポートする

次の手順では、Microsoft msix パッケージングツールアプリを使用して、既存の Windows アプリにアプリインストーラーファイルを埋め込む方法について説明します。 これらの手順は、Microsoft msix パッケージングツールアプリを使用して編集するために Windows アプリを既に開いていることを前提としています。

  1. Msix パッケージ化ツール の左側で、[パッケージファイル] を選択します。
  2. ツリービュー内の パッケージ エントリを展開します。
  3. パッケージ を右クリックし、ドロップダウンメニューから [ファイルの追加] を選択します。
  4. プロンプトウィンドウ内の [ 参照 ] ボタンを選択し、に移動してアプリのインストーラーファイルを選択し、[ 開く ] ボタンを選択します。
  5. [保存] を選択します。

Package.appxmanifest を更新する

次の手順では、Windows アプリに以前に追加したアプリインストーラーファイルを指すように package.appxmanifest を更新します。

  1. Msix パッケージ化ツール の左側で、[パッケージ情報] を選択します。
  2. [ パッケージ情報 ] セクションの一番下までスクロールします。
  3. [ファイルを開く] ボタンを選択して、メモ帳ウィンドウで package.appxmanifest を開きます。
  4. プロパティに次の名前空間と無視できる名前空間が含まれていることを確認し <Package> ます。
    <Package xmlns="http://schemas.microsoft.com/appx/manifest/foundation/windows10"
        xmlns:mp="http://schemas.microsoft.com/appx/2014/phone/manifest"
        xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
        xmlns:uap13="http://schemas.microsoft.com/appx/manifest/uap/windows10/13" 
        xmlns:build="http://schemas.microsoft.com/developer/appx/2015/build"
        IgnorableNamespaces="uap mp uap13 build">
    
  5. の内部には、 <Properties> 次の <uap13:AutoUpdate> および子パラメーターがあります。
    <Properties>
        ...
        <uap13:AutoUpdate>
            <uap13:AppInstaller File="Update.appinstaller" />
        </uap13:AutoUpdate>
    </Properties>
    
  6. Package.appxmanifest に対して行った変更を保存します。
  7. package.appxmanifest メモ帳ウィンドウを閉じ、 msix パッケージ化ツール に戻ります。

注意

上記の手順では、アプリインストーラーのファイル名が "appinstaller" であることを前提としています。

Windows アプリを閉じてパッケージ化する

次の手順では、Windows アプリを新しいバージョンとしてパッケージ化する方法について説明します。 これらの手順では、組織またはクライアントの要件を満たすように 署名設定 を構成していることを前提としています。

  1. Msix パッケージツール で、[保存] ボタンを選択します。
  2. メッセージが表示されたら、[ はい]、[インクリメント ] ボタンを選択します。
  3. 新しく更新された Windows アプリを保存する場所に移動し、[保存] ボタンを選択します。
  4. [閉じる] ボタンを選択します。
  5. Msix パッケージ化ツール ウィンドウを閉じます。

方法-Visual Studio

開始する前に、Windows 10 SDK 2104 以降がインストールされている Windows 10 デバイスで作業していることを確認します。 この SDK は、ターゲットバージョンと最小バージョンプロパティが、アプリのビルド時に適切な値で設定されるようにするために必要です。

アプリのインストーラーファイルを埋め込む

次の手順では、アプリインストーラーファイルを Windows app (UWP) Visual Studio プロジェクトに埋め込む方法について説明します。

  1. Visual Studio プロジェクト で、Windows アプリ名を右クリックし ソリューションエクスプローラー ます。
  2. ドロップダウンメニューから [既存項目 の追加] を選択します。

  3. アプリのインストーラーファイルに移動して選択し、[ 追加 ] ボタンを選択します。
  4. ソリューションエクスプローラーで、 appinstaller をダブルクリックしてファイルを開き、確認します。
  5. アプリのインストーラーファイルが正しいことを確認し、ファイルを閉じます。

Package.appxmanifest を更新しています

次の手順では、Visual Studio プロジェクトの package.appxmanifest を更新して、新しく埋め込まれたアプリのインストーラーファイルを対象にする方法について説明します。

このガイドは以下を前提としています。

  • Windows 10 SDK 2104 以降がインストールされています
  • プロジェクトのプロパティは、Windows 10 バージョン2104以降に設定されています。
  • アプリケーションのインストーラーファイルの名前は appinstaller です。
  1. Visual Studio プロジェクト で、上部のメニューから [ビルド] を選択します。
  2. ドロップダウンメニューから [ ソリューションのビルド ] を選択します。 Windows アプリのビルドが成功したことを確認します。
  3. リボンから [ローカルコンピューター ] を選択して、Windows アプリの機能をテストします。
  4. 起動後すぐに Windows アプリを閉じ、デバッグを停止します。
  5. ソリューションエクスプローラーで、package.appxmanifest を右クリックし ます。
  6. ドロップダウンメニューから [ コードの表示 ] を選択します。
  7. プロパティに次の名前空間と無視できる名前空間が含まれていることを確認し <Package> ます。
    <Package xmlns="http://schemas.microsoft.com/appx/manifest/foundation/windows10"
        xmlns:mp="http://schemas.microsoft.com/appx/2014/phone/manifest"
        xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
        xmlns:uap13="http://schemas.microsoft.com/appx/manifest/uap/windows10/13" 
        xmlns:build="http://schemas.microsoft.com/developer/appx/2015/build"
        IgnorableNamespaces="uap mp uap13 build">
    
  8. の内部には、 <Properties> 次の <uap13:AutoUpdate> および子パラメーターがあります。
    <Properties>
        ...
        <uap13:AutoUpdate>
            <uap13:AppInstaller File="Update.appinstaller" />
        </uap13:AutoUpdate>
    </Properties>
    
  9. 変更内容をファイルに保存し、を閉じます。

Windows アプリのビルド

次の手順では、サポートされているオペレーティングシステムを使用するための Windows アプリケーションパッケージを作成する方法について説明します。

  1. Visual Studio プロジェクト で Windows アプリ名を右クリックします。
  2. ドロップダウンメニューから [発行] [ >> アプリパッケージの作成... ] の順に選択します。
  3. [アプリパッケージ の新規作成] ダイアログウィンドウで、サイドローディング オプションボタンを選択します。
  4. [次へ] ボタンを選択します。
  5. [ はい、現在の証明書を使用します ] オプションボタンを選択します。
  6. 既存の証明書をインポートするか、Windows アプリに署名するための証明書を自動生成します。
  7. [次へ] ボタンを選択します。
  8. Windows アプリの Windows アプリバンドルのソリューション構成、バージョン、およびオプションのビルドを指定します。
  9. [作成] ボタンを選択します。