OnLaunch
この要素は、アプリの起動時に、デプロイ サービスがアプリ インストーラー ファイルの更新を確認することを示します。
要素階層
- AppInstaller>の<
-
- <UpdateSettings>
- <OnLaunch>
構文
<OnLaunch s4:HoursBetweenUpdateChecks? = String with numeric values between 0 and 255 inclusive.
s4:ShowPrompt? = Boolean
s4:UpdateBlocksActivation? = Boolean />
鍵
? 省略可能 (ゼロまたは 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 |