OnLaunch

此元素表示部署服务将在应用启动时检查更新应用安装程序文件。

元素层次结构

<AppInstaller>

<UpdateSettings>

<OnLaunch>

语法

<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（含 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 中引入的功能所必需的
最低操作系统版本	Windows 10 版本 1709