Como criar uma experiência de Instalador de Aplicativo personalizada

O Instalador de Aplicativo app é usado para todas as instalações MSIX, fornecendo uma experiência consistente para todos os usuários que instalam um aplicativo MSIX. Embora essa consistência seja boa, também queremos fornecer a capacidade de os desenvolvedores personalizarem 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 MsixAppInstallerData.xml personalizado

A primeira coisa que você precisará personalizar sua experiência de Instalador de Aplicativo é o arquivo xml de personalização. Você pode personalizar vários recursos do seu Instalador de Aplicativo UX, para fazer sua própria experiência exclusiva do instalador. Salve o nome do arquivo como MsixAppInstallerData.xml

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

Instalador de Aplicativo configuração de UX Descrição
UX::AccentColor Um código hexadigo para alterar a cor de destaque Instalador de Aplicativo
UX::FontFamily Família de fontes
UX::AllowUserInteraction Booliano. Se true, o usuário poderá ver a 'quando estiver pronto' caixa de seleção (marcada por padrão) e tiver a opção de cancelar a instalação
UX::BackgroundColor Um código hexadigo para alterar a cor da tela de fundo Instalador de Aplicativo
UX::AppNameInTitle Booliano. Se true, o nome do aplicativo aparecerá no título da janela do instalador.
HyperLinkFontSize Tamanho da fonte do Hyper Link.
Icon::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.
Buttons::HorizontalAlignment Alinhamento do botão dentro da janela. Esquerda, centro, direita
Botões::Texto Texto adicional para adicionar ao botão InstalarIs
Buttons::IsSecondaryButtonAccent Booliano.
LaunchWhenReady::HorizontalAlignment Alinhamento da caixa de seleção para iniciar 'quando estiver'. Centro, esquerda.
AppInformation::Mode Tipo de show de informações adicionais. Normal, flyout
Hiperlinks::TopMarging Especifica a margem entre o hiperlink e os botões.
Hiperlink::Text Texto a ser exibido como hiperlink
Hiperlink::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> 

Salve o arquivo como 'MsixAppInstallerData.xml'

Adicionar o arquivo xml ao seu 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 os Arquivos de Pacote e adicione uma nova pasta na raiz do pacote chamada 'Msix.AppInstaller.Data'

  3. Adicione seu MsixAppInstallerData.xml de dados à pasta recém-criada.

  4. Salvar o pacote MSIX – certifique-se 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 do pacote
  • Verifique a versão do sistema operacional e sua Instalador de Aplicativo versão
  • Verifique duas vezes a validade do arquivo xml

Comentários de arquivo se você encontrar outros problemas ou entrar em contato com a equipe do MSIX em nosso tech Community.