Como criar uma experiência personalizada do Instalador de Aplicativo

  • Artigo

Observação

Esse recurso do Instalador de Aplicativo foi temporariamente revertido e não funcionará no momento. Volte mais tarde para obter mais atualizações, pois planejamos trazer esse recurso de volta.

O Instalador de Aplicativo é usado para todas as instalações MSIX, proporcionando uma experiência consistente a todos os usuários que instalam um aplicativo MSIX. Embora essa consistência seja boa, também queremos fornecer aos desenvolvedores a capacidade de personalizar a experiência de instalação que fornecem aos usuários. Este recurso está disponível no Windows 10 1709 e posterior.

Criar seu arquivo MSIXAppInstallerData.xml personalizado

O primeiro item de que você precisará para personalizar sua experiência com o Instalador de Aplicativo é o arquivo xml de personalização. Você pode personalizar vários recursos de UX do Instalador de Aplicativo para criar sua própria experiência de instalação exclusiva. Salve o nome do arquivo como MSIXAppInstallerData.xml

Aqui está uma lista de parâmetros disponíveis para personalização:

Configuração de UX do Instalador de Aplicativo Descrição
UX::AccentColor Um código hexadecimal para alterar a cor de realce do Instalador de Aplicativo
UX::FontFamily Família de fontes
UX::AllowUserInteraction Booliano. Se verdadeiro, o usuário poderá ver a caixa de seleção 'iniciar quando estiver pronto' (marcada por padrão) e terá a opção de cancelar a instalação
UX: BackgroundColor Um código hexadecimal para alterar a cor da tela de fundo do Instalador de Aplicativo
UX::AppNameInTitle Booliano. Se verdadeiro, o nome do aplicativo será exibido no título da janela do instalador.
HyperLinkFontSize Tamanho da fonte do hiperlink.
Icon::HorizontalAlignment Alinhamento do ícone na janela. Esquerda, centro, direita
Icon::Logo Link para localização do ícone
Icon::TopMarging Margem da parte superior do ícone até a parte superior da janela do aplicativo.
Buttons::HorizontalAlignment Alinhamento dos botões na janela. Esquerda, centro, direita
Buttons::Text Texto adicional para adicionar a Install buttonIs
Buttons::IsSecondaryButtonAccent Booliano.
LaunchWhenReady::HorizontalAlignment Alinhamento da caixa de seleção 'Iniciar quando estiver pronto'. Centro, esquerda.
AppInformation::Mode Informações adicionais mostram o tipo. Normal, submenu
Hyperlinks::TopMargin Especifica a margem entre o hiperlink e os botões.
Hiperlink::Texto Texto a ser exibido como hiperlink
Hiperlink::Url Link
Hyperlink:: HorizontalAlignment Alinhamento do hiperlink na janela. Esquerda, centro, direita

xml de exemplo:


<?xml version="1.0" encoding="utf-8"?> 

<AppInstallerUX xmlns="http://schemas.microsoft.com/msix/appinstallerux"  

xmlns:ux="http://schemas.microsoft.com/msix/appinstallerux" 

xmlns:ux2="http://schemas.microsoft.com/msix/appinstallerux/2" 

IgnorableNamespaces="ux ux2" Version="1.0.0"> 

  <UX AccentColor="#DE781F" FontFamily="Segoe UI" AllowUserInteraction="false" BackgroundColor="#F3F3F3"  

  AppNameInTitle="true"  

  HyperLinkFontSize="12"> 

    <Icon HorizontalAlignment="center" Logo="Images\Contoso96x96.png" TopMargin="70"/> 

    <Buttons HorizontalAlignment="center" Text="Contoso" IsSecondaryButtonAccent="false"/> 

    <LaunchWhenReady HorizontalAlignment="center"/> 

    <AppInformation Mode="flyout" /> 

    <HyperLinks TopMargin="30"> 

      <HyperLink  Text="Terms &amp; conditions" Url="https://support.microsoft.com/" HorizontalAlignment="center"/> 

    </HyperLinks> 

  </UX> 

</AppInstallerUX>

Salve seu arquivo como 'MsixAppInstallerData.xml'

Adicione o arquivo xml a seu aplicativo MSIX

Usar a ferramenta de empacotamento MSIX — Editor de Pacotes

  1. Abra seu aplicativo MSIX com o Editor de Pacote na ferramenta de empacotamento MSIX

  2. Vá para os arquivos do pacote e adicione uma nova pasta na raiz do pacote chamada 'Msix.AppInstaller.Data'

  3. Adicione o arquivo MSIXAppInstallerData.xml à pasta recém-criada.

  4. Salve seu pacote MSI: incremente a versão e assine o pacote

Solução de problemas

  • O arquivo deve ser chamado MSIXAppInstallerData.xml
  • O arquivo deve estar na pasta chamada MSIXAppInstallerData
  • A pasta deve estar abaixo da raiz do pacote dos arquivos do pacote
  • Verifique a versão do sistema operacional e a versão do Instalador de Aplicativo
  • Verifique novamente a validade do arquivo xml

Envie comentários se tiver outros problemas ou entre em contato com a equipe MSIX em nossa Comunidade Técnica.