Partilhar via

OnLaunch

  • Artigo

Esse elemento significa que o serviço de implantação verificará se há uma atualização para o arquivo do App Installer 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 dados Necessário
s4:HorasEntreAtualizaçõesVerificações HoursBetweenUpdateChecks especifica a frequência com que o serviço de implantação verificará se há uma atualização para o arquivo do App Installer. 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 dentro do ú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 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:UpdateBlocksAtivação Só deve ser usado se ShowPrompt="true". Indica se a implantação interromperá o usuário de iniciar o aplicativo até que a atualização tenha sido 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. Neste último caso, a atualização será aplicada silenciosamente em 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 verificar ou não se há uma atualização durante a inicialização do aplicativo.

Comentários

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 o Desktop Bridge). Para aplicações de ambiente de trabalho, esta funcionalidade fornece uma atualização silenciosa; a mesma funcionalidade padrão fornecida pelo elemento OnLaunch.

Os atributos ShowPrompt e UpdateBlocksActivation só têm efeito 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 forem encontradas atualizações, 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 diminuída.

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

Requerimentos

Exigência 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 Este namespace é necessário para recursos introduzidos no Windows versão 21H2 build 22000
Versão mínima do SO Windows 10, versão 1709