OnLaunch

Статья
07/20/2023

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

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

<AppInstaller>

<UpdateSettings>: <OnLaunch>

Синтаксис

<OnLaunch HoursBetweenUpdateChecks? = String with numeric values between 0 and 255 inclusive. />

Ключ

? необязательно (ноль или один)

Атрибуты и элементы

Атрибуты

Атрибут	Описание	Тип данных	Обязательно
хаурсбетвинупдатечеккс	Хаурсбетвинупдатечеккс указывает частоту, с которой служба развертывания будет проверять наличие обновления файла установщика приложения. Если Хаурсбетвинупдатечеккс имеет значение 0, служба развертывания будет проверять наличие обновлений при каждом запуске приложения. Для других значений служба развертывания проверяет наличие обновлений при запуске приложения, только если оно ранее не проверялось в течение последнего времени, заданного параметром Хаурсбетвинупдатечеккс. Например, если для Хаурсбетвинупдатечеккс задано значение 12, служба развертывания будет проверять наличие обновлений при запуске приложения, только если оно еще не проверяло обновления за предыдущие 12 часов.	Числовые значения от 0 до 255 включительно. Значение по умолчанию — 24.	Нет
шовпромпт	Указывает, будет ли при развертывании отображаться приглашение, информирующее пользователя об обновлении. Дополнительные сведения о поведении этого атрибута см. в разделе Примечания. доступно в Windows 10 версии 1903 и более поздних.	Логическое	Нет
упдатеблокксактиватион	Следует использовать, только если Шовпромпт = "true". Указывает, будет ли запуск приложения остановлен пользователем до применения обновления. "Упдатеблокксактиватион" = true означает, что пользовательский интерфейс, отображаемый пользователем, позволяет пользователю выполнить обновление или закрыть приложение. "Упдатеблокксактиватион" = false означает, что пользовательский интерфейс, отображаемый пользователем, позволяет пользователю выполнить обновление или запустить приложение без обновления. В последнем случае обновление будет применено автоматически во время оппортуне. Дополнительные сведения о поведении этого атрибута см. в разделе Примечания. доступно в Windows 10 версии 1903 и более поздних.	Логическое	Нет

Родительские элементы

Родительские элементы	Описание
UpdateSettings	Необязательный элемент файла appinstaller. Упдатесеттингс указывает, следует ли проверять наличие обновления во время запуска приложения.

Remarks

ShowPrompt="true"установка атрибута в настоящее время отображает запрос для приложений UWP, но не для настольных приложений, упакованных в пакет приложения Windows (то есть настольные приложения, использующие мост для классических приложений). Для настольных приложений эта функция обеспечивает автоматическое обновление; те же функциональные возможности по умолчанию, которые предоставляются элементом OnLaunch.

ShowPromptатрибуты и UpdateBlocksActivation действуют, только когда пользователь запускает приложение из пункта меню или плитки в меню. Эти атрибуты не действуют, если пользователь запускает приложение с ярлыка на рабочем столе или с панели задач.

Примеры

В этом примере развертывание будет проверять наличие обновлений при каждом запуске приложения. Если обновления найдены, при развертывании отобразится запрос, сообщающий пользователю, что необходимо выполнить обновление перед запуском приложения. Кроме того, можно увеличить или уменьшить версию приложения.

<UpdateSettings> 
    <OnLaunch HoursBetweenUpdateChecks="0" ShowPrompt="true" UpdateBlocksActivation="true"/>
    <ForceUpdateFromAnyVersion>true</ForceUpdateFromAnyVersion>
</UpdateSettings>

Требования для Хаурсбетвинупдатечеккс

	Значение
Пространство имен	`http://schemas.microsoft.com/appx/appinstaller/2017/2`

Требования для Шовпромпт и Упдатеблокксактиватион

	Значение
Пространство имен	`http://schemas.microsoft.com/appx/appinstaller/2018`