Como criar uma experiência personalizada do Instalador de Aplicativos

Observação

Esse recurso do Instalador de Aplicativos foi temporariamente revertido e não funcionará no momento. Verifique novamente mais tarde se há mais atualizações, pois planejamos trazer esse recurso de volta.

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

Criar seu arquivo de MSIXAppInstallerData.xml personalizado

A primeira coisa que você precisará para personalizar sua experiência do Instalador de Aplicativos é o arquivo xml de personalização. Você pode personalizar vários recursos da UX do Instalador de Aplicativo para tornar sua própria experiência de instalador 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 hex para alterar a cor de ênfase do Instalador de Aplicativo
UX::FontFamily Família de fontes
UX::AllowUserInteraction Booliano. Se for true, o usuário poderá ver a caixa de seleção "iniciar quando estiver pronto" (marcada por padrão) e tem a opção de cancelar a instalação
UX::BackgroundColor Um código hex para alterar a cor da tela de fundo do Instalador de Aplicativo
UX::AppNameInTitle Booliano. Se for verdadeiro, o nome do aplicativo aparecerá no título da janela do instalador.
HyperLinkFontSize Tamanho da fonte do hiper link.
Ícone::HorizontalAlignment Alinhamento de ícone dentro da janela. Esquerda, centro, direita
Ícone::Logotipo Link para o local do ícone
Ícone::TopMarging Margem da parte superior do ícone até a parte superior da janela do aplicativo.
Botões::HorizontalAlignment Alinhamento de botão dentro da janela. Esquerda, centro, direita
Botões::Texto Texto adicional a ser adicionado aos botões Instalar
Buttons::IsSecondaryButtonAccent Booliano.
LaunchWhenReady::HorizontalAlignment Alinhamento da caixa de seleção para "Iniciar quando estiver pronto". Centro, esquerda.
AppInformation::Mode Informações adicionais mostram tipo. Normal, submenu
Hiperlinks::TopMarging Especifica a margem entre o hiperlink e os botões.
Hyperlink::Text Texto a ser exibido como hiperlink
Hyperlink::Url Link
Hiperlink:: HorizontalAlignment Alinhamento do hiperlink dentro da 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" TopMarging="70"/> 

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

    <LaunchWhenReady HorizontalAlignment="center"/> 

    <AppInformation Mode="flyout" /> 

    <HyperLinks TopMarging="30"> 

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

    </HyperLinks> 

  </UX> 

</AppInstallerUX> 

Salvar seu arquivo como 'MsixAppInstallerData.xml'

Adicionar o arquivo xml ao aplicativo MSIX

Usando a Ferramenta de Empacotamento MSIX – Editor de Pacotes

  1. Abra seu aplicativo MSIX com o Editor de Pacotes na Ferramenta de Empacotamento MSIX

  2. Acesse seus Arquivos de Pacote e adicione uma nova pasta na raiz do pacote chamada 'Msix.AppInstaller.Data'

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

  4. Salvar o pacote MSIX – não deixe de incrementar a versão e assinar o pacote

Solução de problemas

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

Registre comentários se você tiver outros problemas ou entrar em contato com a equipe do MSIX em nossa Comunidade Técnica.