OnLaunch

發行項
05/07/2024

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

元素階層

<UpdateSettings>: <OnLaunch>

Syntax

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

答案

? 選擇性 (零或一個)

屬性和項目

屬性

屬性	描述	資料類型	必要
s4：HoursBetweenUpdateChecks	HoursBetweenUpdateChecks 會指定部署服務檢查應用程式安裝程式檔案更新的頻率。當 HoursBetweenUpdateChecks 設定為 0 時，部署服務會在每次啟動應用程式時檢查更新。針對其他值，部署服務只會在應用程式之前未在 HoursBetweenUpdateChecks 所指定的最後幾小時內檢查更新時，才會檢查更新。例如，如果 HoursBetweenUpdateChecks 設定為 12，則只有當應用程式在前 12 小時內尚未檢查更新時，部署服務才會檢查是否有更新。	包含 0 到 255 之間的數值。預設值為 24。	No
s4：ShowPrompt	指出部署是否會顯示提示，通知使用者更新。如需此屬性行為的詳細資訊，請參閱備註。 Windows 10 1903 版和更新版本提供。	Boolean	No
s4：UpdateBlocksActivation	只有在 ShowPrompt=“true” 時才應該使用。指出部署是否會阻止使用者啟動應用程式，直到套用更新為止。 “UpdateBlocksActivation” = true 表示使用者會看到的 UI 可讓使用者取得更新或關閉應用程式。 “UpdateBlocksActivation” = false 表示使用者會看到的 UI 可讓使用者取得更新或啟動應用程式，而不需更新。在後者的情況下，更新會在作業時間以無訊息方式套用。如需此屬性行為的詳細資訊，請參閱備註。 Windows 10 1903 版和更新版本提供。	Boolean	No

父項目

父項目	Description
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)

共用方式為