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

[アーティクル]
10/29/2023

Note

このアプリインストーラー機能は一時的にロールバックされており、今は機能しません。この機能は復活する予定ですので、後ほど更新プログラムをチェックしてください。

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

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

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

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

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

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

    <LaunchWhenReady HorizontalAlignment="center"/> 

    <AppInformation Mode="flyout" /> 

    <HyperLinks TopMargin="30"> 

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

    </HyperLinks> 

  </UX> 

</AppInstallerUX>

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

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

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

MSIX パッケージ作成ツールでパッケージエディターを使用して MSIX アプリケーションを開きます
パッケージファイルにアクセスし、”Msix.AppInstaller.Data” という名前のパッケージルートの下に新しいフォルダーを追加します
新しく作成したフォルダーに MSIXAppInstallerData.xml ファイルを追加します。
MSIX パッケージを保存します。バージョンの番号を増やしてパッケージに署名してください

トラブルシューティング

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

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

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