s4：OnLaunch

说明

指定部署服务在应用启动时是否检查更新应用安装程序文件。 (s4：OnLaunch)

元素层次结构

s4：AppInstaller

     s4：UpdateSettings;

          <s4：OnLaunch>

语法

<s4:OnLaunch     ShowPrompt? = Boolean.
    UpdateBlocksActivation? = Boolean.
    HoursBetweenUpdateChecks? = Unsigned byte.
></s4:OnLaunch>

密钥

? 可选 (零个或一个)

属性

属性	说明	数据类型	必需
ShowPrompt	指示部署是否会显示提示，通知用户有关更新的信息。 有关此属性的行为的详细信息，请参阅备注。 在 Windows 10 版本 1903 及更高版本中可用。	布尔值。	否
UpdateBlocksActivation	仅当 ShowPrompt=“true”时才应使用。 指示部署是否会在应用更新之前停止用户启动应用程序。 “UpdateBlocksActivation” = true 表示用户看到的 UI 允许用户执行更新或关闭应用。 “UpdateBlocksActivation” = false 表示用户看到的 UI 允许用户在不更新的情况下进行更新或启动应用。 在后一种情况下，更新将在适时以无提示方式应用。 有关此属性的行为的详细信息，请参阅备注。 在 Windows 10 版本 1903 及更高版本中可用。	布尔值。	否
HoursBetweenUpdateChecks	指定部署服务检查应用安装程序文件更新的频率。 当 HoursBetweenUpdateChecks 设置为 0 时，部署服务将在每次启动应用程序时检查更新。 对于其他值，仅当应用程序启动时，部署服务才会检查更新，前提是它之前未在 HoursBetweenUpdateChecks 指定的最后小时数内进行检查。 例如，如果 HoursBetweenUpdateChecks 设置为 12，则仅当应用程序启动时，部署服务将检查更新，前提是它尚未检查过去 12 小时内的更新。	介于 0 和 255（含 0 和 255）之间的数值。 默认值为 24。	否

父元素

父元素	说明
s4：UpdateSettings	指定与应用更新相关的设置。

注解

ShowPrompt="true"设置 属性当前会显示 UWP 应用程序的提示，但对于已在 Windows 应用包中打包的桌面应用程序， (即使用桌面桥) 的桌面应用程序，则不会提示。 对于桌面应用程序，此功能提供无提示更新;OnLaunch 元素提供的相同默认功能。

ShowPrompt仅当用户从“开始”菜单中的菜单项或磁贴启动应用时，和 UpdateBlocksActivation 属性才有效。 如果用户从桌面快捷方式或任务栏启动应用，则这些属性不起作用。

示例

在此示例中，每次启动应用时，部署都会检查更新。 如果找到更新，部署将显示提示，告知用户在启动应用之前必须进行更新。 此外，应用版本可以递增或递减。

<s4:UpdateSettings> 
    <s4OnLaunch s4:HoursBetweenUpdateChecks="0" s4:ShowPrompt="true" s4:UpdateBlocksActivation="true"/>
    <s4:ForceUpdateFromAnyVersion>true</s4:ForceUpdateFromAnyVersion>
</s4UpdateSettings>

要求

要求	值
xmlns:s4=http://schemas.microsoft.com/appx/appinstaller/2021	此命名空间是 Windows 版本 21H2 内部版本 22000 中引入的功能所必需的
最低操作系统版本	Windows 版本 21H2 内部版本 22000