Compartilhar via

OnLaunch

  • Artigo

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

Hierarquia de elementos

<AppInstaller>
<UpdateSettings>
<OnLaunch>

Syntax

<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ária
s4:HoursBetweenUpdateChecks HoursBetweenUpdateChecks especifica a frequência com que o serviço de implantação marcar para uma atualização para o arquivo do Instalador de Aplicativo. Quando HoursBetweenUpdateChecks estiver definido como 0, o serviço de implantação marcar para atualizações sempre que o aplicativo for iniciado. Para outros valores, o serviço de implantação marcar para atualizações quando o aplicativo for iniciado somente se ele não tiver sido 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 marcar para 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. No
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 os comentários. Disponível em Windows 10, versão 1903 e posterior. Boolean No
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 os comentários. Disponível em Windows 10, versão 1903 e posterior. Boolean No

Elementos pai

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

Comentários

A configuração do ShowPrompt="true" atributo 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 Ponte de Desktop). Para aplicativos da área de trabalho, essa funcionalidade fornece uma atualização silenciosa; a mesma funcionalidade padrão fornecida pelo elemento OnLaunch.

Os ShowPrompt atributos e UpdateBlocksActivation têm efeito somente quando o usuário inicia o aplicativo a partir de um item de menu ou bloco no menu Iniciar. 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 marcar para 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 decrementada.

<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 no Windows versão 21H2 build 22000
Versão mínima do SO Windows 10, versão 1709