カスタム アプリ インストーラー エクスペリエンスを作成する方法

注意

このアプリ インストーラー機能は一時的にロールバックされており、現在は機能しません。 この機能を取り戻す予定のため、後でさらに更新プログラムを確認してください。

アプリ インストーラー アプリは、すべての MSIX インストールに使用され、MSIX アプリケーションをインストールするすべてのユーザーに、一貫したエクスペリエンスを提供します。 この一貫性は優れていますが、同時に開発者がユーザーに提供するインストール エクスペリエンスをカスタマイズする機能も提供されています。 この機能は Windows 10 1709 以降で使用できます。

カスタム MSIXAppInstallerData.xml ファイルを作成する

アプリ インストーラーのエクスペリエンスをカスタマイズするには、まずカスタマイズ xml ファイルを使用する必要があります。 アプリ インストーラー UX のいくつかの機能をカスタマイズして、独自の固有のインストーラー エクスペリエンスを作成できます。 必ずファイル名を MSIXAppInstallerData.xml として保存してください

カスタマイズ可能なパラメーターの一覧を次に示します。

アプリ インストーラー UX の設定 説明
UX::AccentColor アプリ インストーラーのアクセント カラーを変更する 16 進コード
UX::FontFamily フォント ファミリ
UX::AllowUserInteraction Boolean です。 True の場合、[準備完了時に起動する] チェックボックス (既定ではチェック済み)、およびインストールをキャンセルするオプションがユーザーに表示されます
UX::BackgroundColor アプリ インストーラーの背景色を変更する 16 進コード
UX::AppNameInTitle Boolean です。 True の場合、アプリ名はインストーラー ウィンドウのタイトルに表示されます。
HyperLinkFontSize ハイパー リンクのフォント サイズ。
Icon::HorizontalAlignment ウィンドウ内のアイコンの配置。 左、中央、右
Icon::Logo アイコンの場所へのリンク
Icon::TopMarging アイコンの上部からアプリケーション ウィンドウの上部までの余白。
Buttons::HorizontalAlignment ウィンドウ内のボタンの配置。 左、中央、右
Buttons::Text インストール ボタンに追加する追加テキスト
Buttons::IsSecondaryButtonAccent Boolean です。
LaunchWhenReady::HorizontalAlignment [準備完了時に起動する] チェックボックスの配置。 中央、左。
AppInformation::Mode 追加情報の表示の種類。 標準、フライアウト
Hyperlinks::TopMarging ハイパーリンクとボタンの間の余白を指定します。
Hyperlink::Text ハイパーリンクとして表示するテキスト
Hyperlink::Url Link
Hyperlink:: HorizontalAlignment ウィンドウ内のハイパーリンクの配置。 左、中央、右

xml のサンプル:


<?xml version="1.0" encoding="utf-8"?> 

<AppInstallerUX xmlns="http://schemas.microsoft.com/msix/appinstallerux"  

xmlns:ux="http://schemas.microsoft.com/msix/appinstallerux" 

xmlns:ux2="http://schemas.microsoft.com/msix/appinstallerux/2" 

IgnorableNamespaces="ux ux2" Version="1.0.0"> 

  <UX AccentColor="#DE781F" FontFamily="Segoe UI" AllowUserInteraction="false" BackgroundColor="#F3F3F3"  

  AppNameInTitle="true"  

  HyperLinkFontSize="12"> 

    <Icon HorizontalAlignment="center" Logo="Images\Contoso96x96.png" TopMarging="70"/> 

    <Buttons HorizontalAlignment="center" Text="Contoso" IsSecondaryButtonAccent="false"/> 

    <LaunchWhenReady HorizontalAlignment="center"/> 

    <AppInformation Mode="flyout" /> 

    <HyperLinks TopMarging="30"> 

      <HyperLink  Text="Terms &amp; conditions" Url="https://support.microsoft.com/" HorizontalAlignment="center"/> 

    </HyperLinks> 

  </UX> 

</AppInstallerUX> 

ファイルを ”MsixAppInstallerData.xml” として保存する

MSIX アプリケーションに xml ファイルを追加する

MSIX パッケージ作成ツールの使用 – パッケージ エディター

  1. MSIX パッケージ作成ツールでパッケージ エディターを使用して MSIX アプリケーションを開きます

  2. パッケージ ファイルにアクセスし、”Msix.AppInstaller.Data” という名前のパッケージ ルートの下に新しいフォルダーを追加します

  3. 新しく作成したフォルダーに MSIXAppInstallerData.xml ファイルを追加します。

  4. MSIX パッケージを保存します。バージョンの番号を増やしてパッケージに署名してください

トラブルシューティング

  • このファイルには MSIXAppInstallerData.xml という名前を付ける必要があります
  • そのファイルは MSIXAppInstallerData という名前のフォルダー内に存在する必要があります
  • そのフォルダーは、パッケージ ファイルのパッケージ ルートの下に配置する必要があります
  • OS のバージョンとアプリ インストーラーのバージョンを確認します
  • xml ファイルの有効性をダブル チェックします

その他の問題が発生した場合、またはテクニカル コミュニティで MSIX チームに連絡する場合は、ファイルのフィードバックをお送りください。