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 |