OnLaunch

[アーティクル]
07/20/2023

この要素は、アプリの起動時に、デプロイサービスがアプリインストーラーファイルの更新を確認します。

要素の階層

<UpdateSettings>: <OnLaunch>

構文

<OnLaunch HoursBetweenUpdateChecks? = String with numeric values between 0 and 255 inclusive. />

キー

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

属性および要素

属性

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

親要素

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

注釈

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

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

例

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

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

HoursBetweenUpdateChecks の要件

	値
Namespace	`http://schemas.microsoft.com/appx/appinstaller/2017/2`

ShowPrompt と UpdateBlocksActivation の要件

	値
Namespace	`http://schemas.microsoft.com/appx/appinstaller/2018`