OnLaunch

Artigo
02/07/2025

Esse elemento significa que o serviço de implantação verificará uma atualização para o arquivo do Instalador de Aplicativo quando o aplicativo for iniciado.

Hierarquia de elementos

> <AppInstaller

> <UpdateSettings: < > OnLaunch

Sintaxe

<OnLaunch s4:HoursBetweenUpdateChecks? = String with numeric values between 0 and 255 inclusive.
    s4:ShowPrompt? = Boolean
    s4:UpdateBlocksActivation? = Boolean />

Chave

? opcional (zero ou um)

Atributos e elementos

Atributos

Atributo	Descrição	Tipo de dado	Necessário
s4:HoursBetweenUpdateChecks	HoursBetweenUpdateChecks especifica a frequência com que o serviço de implantação verificará uma atualização para o arquivo do Instalador de Aplicativo. Quando HoursBetweenUpdateChecks estiver definido como 0, o serviço de implantação verificará se há atualizações sempre que o aplicativo for iniciado. Para outros valores, o serviço de implantação verificará se há atualizações quando o aplicativo for iniciado somente se ele não tiver verificado anteriormente no último número de horas especificado por HoursBetweenUpdateChecks. Por exemplo, se HoursBetweenUpdateChecks estiver definido como 12, o serviço de implantações verificará se há atualizações quando o aplicativo for iniciado somente se ele ainda não tiver verificado se há atualizações nas 12 horas anteriores.	Valores numéricos entre 0 e 255 inclusive. O padrão é 24.	Não
s4:ShowPrompt	Indica se a implantação mostrará um prompt, informando o usuário sobre a atualização. Para obter mais informações sobre o comportamento desse atributo, consulte as observações. Disponível no Windows 10, versão 1903 e posterior.	Booleano	Não
s4:UpdateBlocksActivation	Só deve ser usado se ShowPrompt="true". Indica se a implantação impedirá o usuário de iniciar o aplicativo até que a atualização seja aplicada. "UpdateBlocksActivation" = true significa que a interface do usuário que o usuário verá permite que o usuário faça a atualização ou feche o aplicativo. "UpdateBlocksActivation" = false significa que a interface do usuário que o usuário verá permite que o usuário faça a atualização ou inicie o aplicativo sem atualizar. No último caso, a atualização será aplicada silenciosamente em um momento oportuno. Para obter mais informações sobre o comportamento desse atributo, consulte as observações. Disponível no Windows 10, versão 1903 e posterior.	Booleano	Não

Elementos pai

Elementos pai	Descrição
UpdateSettings	Um elemento opcional do arquivo appinstaller. UpdateSettings significa se uma atualização deve ou não ser verificada durante a inicialização do aplicativo.

Observações

A configuração do atributo ShowPrompt="true" atualmente mostra um prompt para aplicativos UWP, mas não para aplicativos da área de trabalho que foram empacotados em um pacote de aplicativos do Windows (ou seja, aplicativos da área de trabalho que usam a Ponte da Área de Trabalho). Para aplicativos da área de trabalho, essa funcionalidade fornece uma atualização silenciosa; a mesma funcionalidade padrão fornecida pelo elemento OnLaunch.

Os atributos ShowPrompt e UpdateBlocksActivation têm efeito somente quando o usuário inicia o aplicativo a partir de um item de menu, um bloco no menu Iniciar, um alias de aplicativo ou um manipulador de protocolo. Esses atributos não terão efeito se o usuário iniciar o aplicativo a partir de um atalho da área de trabalho ou da barra de tarefas.

Exemplos

Neste exemplo, a implantação verificará se há atualizações sempre que o aplicativo for iniciado. Se as atualizações forem encontradas, a implantação mostrará um prompt informando ao usuário que ele deve fazer a atualização antes de iniciar o aplicativo. Além disso, a versão do aplicativo pode ser incrementada ou decremente decremente.

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

Requisitos

Requisito	Descrição
`xmlns=http://schemas.microsoft.com/appx/appinstaller/2017`	Esse namespace é necessário para recursos introduzidos no Windows 10, versão 1709.
`xmlns:s4=http://schemas.microsoft.com/appx/appinstaller/2021`	Esse namespace é necessário para recursos introduzidos na versão 21H2 do Windows build 22000
Versão mínima do sistema operacional	Windows 10, versão 1709

Compartilhar via