OnLaunch

Esse elemento significa que o serviço de implantação verificará se há uma atualização no arquivo Instalador de Aplicativo quando o aplicativo for lançado.

Hierarquia de elementos

<AppInstaller>
<UpdateSettings>
<OnLaunch>

Syntax

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

Chave

? opcional (zero ou um)

Atributos e elementos

Atributos

Atributo Descrição Tipo de dados Necessária
HoursBetweenUpdateChecks HoursBetweenUpdateChecks especifica a frequência com a qual o serviço de implantação verificará se há uma atualização no arquivo 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 lançado. Para outros valores, o serviço de implantação verificará se há atualizações quando o aplicativo for lançado 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 verificará se há atualizações quando o aplicativo for lançado 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
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 no Windows 10, versão 1903 e posterior. Boolean Não
UpdateBlocksActivation Só deverá ser usado se ShowPrompt="true". Indica se a implantação impedirá que o usuário inicialize 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 pegue 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 pegue a atualização ou inicie o aplicativo sem atualizar. No último caso, a atualização será aplicada silenciosamente em um momento oportuna. Para obter mais informações sobre o comportamento desse atributo, consulte os comentários. Disponível no Windows 10, versão 1903 e posterior. Boolean Não

Elementos pai

Elementos pai Descrição
UpdateSettings Um elemento opcional do arquivo appinstaller. UpdateSettings significa se é preciso verificar se há ou não uma atualização durante o lançamento do aplicativo.

Comentários

ShowPrompt="true" Definir o 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 Windows (ou seja, aplicativos de á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 UpdateBlocksActivation e têm efeito somente quando o usuário inicia o aplicativo de um item de menu ou um peça no menu Iniciar. Esses atributos não terão efeito se o usuário iniciar o aplicativo 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 lançado. Se as atualizações são encontradas, a implantação mostrará um prompt dizendo 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 HoursBetweenUpdateChecks="0" ShowPrompt="true" UpdateBlocksActivation="true"/>
    <ForceUpdateFromAnyVersion>true</ForceUpdateFromAnyVersion>
</UpdateSettings>

Requisitos para HoursBetweenUpdateChecks

Valor
Namespace http://schemas.microsoft.com/appx/appinstaller/2017/2

Requisitos para ShowPrompt e UpdateBlocksActivation

Valor
Namespace http://schemas.microsoft.com/appx/appinstaller/2018