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 |