アプリ インストーラー ファイルの更新設定を構成するConfigure update settings in the App Installer file

「アプリインストーラーファイルの概要」で説明したように、アプリインストーラーファイルでアプリの更新動作を構成できます。As mentioned in App Installer file overview, you can configure the update behavior of the app in the App Installer file. この記事では、更新オプションとそれぞれのトレードオフについて説明します。This article explores the update options and their respective trade-offs.

Updatesettings要素を使用して、アプリの更新動作を構成できます。You can configure the update behavior of the app by using the UpdateSettings element. ここでは、更新オプションとそれぞれのトレードオフについて説明します。Here we explore the update options and their respective trade-offs.

つまり、更新プログラムの確認は、次の2つの方法で行うことができます。In short, you can choose to check for updates two different ways:

  1. アプリを起動するユーザーとは独立して。Independently of the user launching the app.
  2. ユーザーがアプリを起動した場合のみ。Only when the user launches the app.

また、次の2つの方法で更新プログラムを適用することもできます。Additionally, you can choose to apply updates in two different ways:

  1. プロンプトをユーザーに通知します。By informing the user with a prompt.
  2. ユーザーに通知することなく、サイレントモードで実行します。Silently, without informing the user.

最後に、更新プログラムをユーザーに通知するときに、アプリの起動を許可する前に更新プログラムを取得するように強制することも、アプリを起動して更新プログラムをいえる時に適用することもできます。Finally, when you inform the user of an update, you can either force them to take the update before allowing them to launch the app, or you can allow them to launch the app and apply the update at an opportune time.

Updatesettings要素には、次の子要素を含めることができます。The UpdateSettings element can have the following child elements:

アプリインストーラーファイルの更新設定App Installer file update setting Windows 10 の最小バージョンMin Windows 10 Version
OnLaunchOnLaunch 17091709
HoursBetweenUpdateChecksHoursBetweenUpdateChecks 18031803
AutomaticBackgroundTaskAutomaticBackgroundTask 18031803
UpdateBlocksActivationUpdateBlocksActivation 19031903
ShowPromptShowPrompt 19031903
ForceUpdateFromAnyVersionForceUpdateFromAnyVersion 19031903
  • Onlaunch: 起動時に更新プログラムがあるかどうかを確認します。OnLaunch: Checks for updates on launch. この種類の更新では、UI を表示し、次の属性を持つことができます。This type of update can show UI and has the following attributes:

    • HoursBetweenUpdateChecks: システムがアプリの更新プログラムをチェックする頻度 (数時間) を示す整数。HoursBetweenUpdateChecks: An integer that indicates how often (in how many hours) the system will check for updates to the app. "0" を "255" に含めます。“0” to “255” inclusive. 既定値は24です (この値が指定されていない場合)。The default value is 24 (if this value is not specified). たとえば、HoursBetweenUpdateChecks = 3 の場合、ユーザーがアプリを起動すると、過去3時間以内にシステムで更新プログラムがチェックされていない場合は、更新プログラムのチェックが開始されます。For example if HoursBetweenUpdateChecks = 3 then when the user launches the app, if the system has not checked for updates within the past 3 hours, it will check for updates now.

    • Showprompt: UI をユーザーに表示するかどうかを決定するブール値。ShowPrompt: A boolean that determines if UI will be shown to the user. この値は、Windows 10 バージョン1903以降でサポートされています。This value is supported on Windows 10, version 1903 and later.

    • Updateblocksactivation: ユーザーに表示される UI で、ユーザーが更新を行わずにアプリを起動できるようにするかどうか、またはアプリを起動する前にユーザーが更新を実行する必要があるかどうかを決定するブール値。UpdateBlocksActivation: A boolean that determines if the UI shown to the user allows the user to launch the app without taking the update, or if the user must take the update before launching the app. Showpromptが "true" に設定されている場合にのみ、この属性を "true" に設定できます。This attribute can be set to “true” only if ShowPrompt is set to “true”. Updateblocksactivation= "true" は、ユーザーに表示される UI を意味し、ユーザーが更新を行ったり、アプリを閉じたりできるようにします。UpdateBlocksActivation=“true” means the UI the user will see, allows the user to take the update or close the app. Updateblocksactivation= "false" はユーザーに表示される UI を意味し、ユーザーは更新を実行したり、アプリを更新せずに起動したりできます。UpdateBlocksActivation="false" means the UI the user will see, allows the user to take the update or start the app without updating. 後者の場合、更新プログラムはいえる時にサイレントモードで適用されます。In the latter case, the update will be applied silently at an opportune time. この値は、Windows 10 バージョン1903以降でサポートされています。This value is supported on Windows 10, version 1903 and later.

      注意

      UpdateBlocksActivation が true に設定されている場合は、ShowPrompt を true に設定する必要があります。ShowPrompt needs to be set to true if UpdateBlocksActivation is set to true.

  • 自動Backgroundtask: ユーザーがアプリを起動したかどうかに関係なく、8時間ごとにバックグラウンドで更新を確認します。AutomaticBackgroundTask: Checks for updates in the background every 8 hours independently of whether the user launched the app. この種類の更新プログラムでは、UI を表示できません。This type of update cannot show UI.

  • ForceUpdateFromAnyVersion: アプリをバージョン x からバージョン x + + に更新したり、バージョン x からバージョン x にダウングレードしたりすることができ--.ForceUpdateFromAnyVersion: Allows the app to update from version x to version x++ or to downgrade from version x to version x--. この要素がないと、アプリは上位バージョンにのみ移動できます。Without this element, the app can only move to a higher version.