OnLaunch

Статья
02/07/2025

Этот элемент означает, что служба развертывания будет проверять обновление до файла установщика приложений при запуске приложения.

Иерархия элементов

<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 включительно. Значение по умолчанию — 24.	Нет
s4:ShowPrompt	Указывает, будет ли развертывание отображать запрос, информируя пользователя об обновлении. Дополнительные сведения о поведении этого атрибута см. в примечаниях. Доступно в Windows 10 версии 1903 и более поздних версий.	Булев	Нет
s4:UpdateBlocksActivation	Следует использовать только в том случае, если ShowPrompt="true". Указывает, остановит ли развертывание пользователя от запуска приложения до тех пор, пока обновление не будет применено. UpdateBlocksActivation = true означает, что пользовательский интерфейс, который пользователь увидит, позволяет пользователю принимать обновление или закрывать приложение. UpdateBlocksActivation = false означает, что пользовательский интерфейс, который пользователь увидит, позволяет пользователю принимать обновление или запускать приложение без обновления. В последнем случае обновление будет применяться автоматически во время оппортуна. Дополнительные сведения о поведении этого атрибута см. в примечаниях. Доступно в 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

Поделиться через