OnLaunch

  • [アーティクル]

この要素は、アプリの起動時に、アプリ インストーラー ファイルの更新に対してデプロイ サービスがチェックされることを示します。

要素の階層

<AppInstaller>
<UpdateSettings>
<OnLaunch>

構文

<OnLaunch s4:HoursBetweenUpdateChecks? = String with numeric values between 0 and 255 inclusive.
    s4:ShowPrompt? = Boolean
    s4:UpdateBlocksActivation? = Boolean />

キー

? 省略可能 (0 または 1)

属性および要素

属性

属性 説明 データ型 必須
s4:HoursBetweenUpdateChecks HoursBetweenUpdateChecks は、アプリ インストーラー ファイルの更新に対してデプロイ サービスがチェックする頻度を指定します。 HoursBetweenUpdateChecks が 0 に設定されている場合、アプリケーションが起動されるたびに、デプロイ サービスによって更新プログラムがチェックされます。 その他の値の場合、展開サービスは、HoursBetweenUpdateChecks で指定された過去数時間以内に確認されていない場合にのみ、アプリケーションが起動されたときに更新プログラムをチェックします。 たとえば、HoursBetweenUpdateChecks が 12 に設定されている場合、アプリケーションが起動された時点で、過去 12 時間以内に更新プログラムがチェックされていない場合にのみ、デプロイ サービスは更新プログラムをチェックします。 0 ~ 255 の範囲の数値。 既定値は 24 です。 いいえ
s4:ShowPrompt 更新プログラムについてユーザーに通知するプロンプトが展開に表示されるかどうかを示します。 この属性の動作の詳細については、解説を参照してください。 Windows 10 バージョン 1903 以降で使用できます。 ブール型 いいえ
s4:UpdateBlocksActivation ShowPrompt="true" の場合にのみ使用する必要があります。 更新プログラムが適用されるまで、展開によってユーザーがアプリケーションの起動を停止するかどうかを示します。 "UpdateBlocksActivation" = true は、ユーザーが表示する UI を使用して、ユーザーが更新プログラムを取得したり、アプリを閉じるしたりできます。 "UpdateBlocksActivation" = false は、ユーザーに表示される UI によって、ユーザーが更新を行うか、更新せずにアプリを起動することを許可することを意味します。 後者の場合、更新プログラムは適切なタイミングでサイレントに適用されます。 この属性の動作の詳細については、解説を参照してください。 Windows 10 バージョン 1903 以降で使用できます。 ブール型 いいえ

親要素

親要素 説明
UpdateSettings appinstaller ファイルの省略可能な要素。 UpdateSettings は、アプリの起動時に更新プログラムをチェックするかどうかを示します。

注釈

属性をShowPrompt="true"設定すると、現在、UWP アプリケーションのプロンプトが表示されますが、Windows アプリ パッケージにパッケージ化されたデスクトップ アプリケーション (つまり、デスクトップ ブリッジを使用するデスクトップ アプリケーション) に対してはプロンプトが表示されません。 デスクトップ アプリケーションの場合、この機能はサイレント更新を提供します。OnLaunch 要素によって提供されるのと同じ既定の機能。

ShowPrompt属性と UpdateBlocksActivation 属性は、ユーザーが [スタート] メニューのメニュー項目またはタイルからアプリを起動した場合にのみ有効です。 ユーザーがデスクトップ ショートカットまたはタスク バーからアプリを起動した場合、これらの属性は効果がありません。

例

この例では、アプリが起動されるたびに更新プログラムのデプロイがチェックされます。 更新プログラムが見つかった場合、アプリを起動する前に更新プログラムを取得する必要があることをユーザーに通知するプロンプトがデプロイに表示されます。 また、アプリのバージョンをインクリメントまたはデクリメントすることもできます。

<UpdateSettings> 
    <OnLaunch s4:HoursBetweenUpdateChecks="0" s4:ShowPrompt="true" s4:UpdateBlocksActivation="true"/>
    <s4:ForceUpdateFromAnyVersion>true</s4:ForceUpdateFromAnyVersion>
</UpdateSettings>

要件

要件 説明
xmlns=http://schemas.microsoft.com/appx/appinstaller/2017 この名前空間は、Windows 10 バージョン 1709 で導入された機能に必要です。
xmlns:s4=http://schemas.microsoft.com/appx/appinstaller/2021 この名前空間は、Windows バージョン 21H2 ビルド 22000 で導入された機能に必要です
最小 OS バージョン Windows 10 バージョン 1709