OnLaunch

此元素表示部署服務會在應用程式啟動時檢查應用程式安裝程式檔案的更新。

元素階層

<AppInstaller>
<UpdateSettings>
<OnLaunch>

語法

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

答案

? 選擇性 (零或一)

屬性和項目

屬性

屬性 描述 資料類型 必要
HoursBetweenUpdateChecks HoursBetweenUpdateChecks 會指定部署服務檢查應用程式安裝程式檔案更新的頻率。 當 HoursBetweenUpdateChecks 設定為0時,部署服務會在每次啟動應用程式時檢查更新。 若為其他值,部署服務會在應用程式啟動時檢查是否有更新,只有在其先前未在 HoursBetweenUpdateChecks 指定的最後小時數內檢查。 例如,如果 HoursBetweenUpdateChecks 設為12,當應用程式啟動時,只有在先前的12小時內尚未檢查是否有更新時,部署服務就會檢查是否有更新。 介於0與255(含)之間的數值。 預設值為24。 No
ShowPrompt 指出部署是否會顯示提示,通知使用者有關更新。 如需此屬性行為的詳細資訊,請參閱備註。 可在 Windows 10 1903 版和更新版本中使用。 Boolean No
UpdateBlocksActivation 只有在 ShowPrompt = "true" 時才應該使用。 指出部署是否會在套用更新之前,阻止使用者啟動應用程式。 "UpdateBlocksActivation" = true 表示使用者將看到的 UI 可讓使用者進行更新或關閉應用程式。 "UpdateBlocksActivation" = false 表示使用者將看到的 UI 可讓使用者進行更新或啟動應用程式,而不需更新。 在後者的情況下,更新會在時機階段以無訊息模式套用。 如需此屬性行為的詳細資訊,請參閱備註。 可在 Windows 10 1903 版和更新版本中使用。 Boolean No

父項目

父項目 描述
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