s4:OnLaunch

Descrição

Especifica se o serviço de implantação marcar uma atualização para o arquivo do Instalador de Aplicativo na inicialização do aplicativo. (s4:OnLaunch)

Hierarquia de elementos

s4:AppInstaller

     s4:UpdateSettings;

          <s4:OnLaunch>

Syntax

<s4:OnLaunch     ShowPrompt? = Boolean.
    UpdateBlocksActivation? = Boolean.
    HoursBetweenUpdateChecks? = Unsigned byte.
></s4:OnLaunch>

Chave

? opcional (zero ou um)

Atributos

Atributo	Descrição	Tipo de dados	Necessária
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.	Booliano.	No
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.	Booliano.	No
HoursBetweenUpdateChecks	Especifica a frequência com que o serviço de implantação marcar 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

Elementos pai

Elementos pai	Descrição
s4:UpdateSettings	Especifica as configurações relacionadas às atualizações 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.

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

Requisitos

Requisito	Valor
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 versão 21H2 build 22000