Solucionar problemas de instalação com o arquivo do Instalador de Aplicativo

Se você encontrar problemas ao instalar um aplicativo do arquivo do Instalador de Aplicativo, este tópico fornecerá algumas diretrizes de solução de problemas que poderão ajudar.

Pré-requisitos

Para poder fazer sideload de aplicativos no Windows 10, o dispositivo do usuário deve satisfazer os seguintes requisitos:

Windows 10:

  • O certificado usado para assinar o pacote deve ser confiável pelo dispositivo. Consulte a seção Certificados confiáveis abaixo para obter mais detalhes.
  • A versão do Windows 10 deve dar suporte ao esquema de arquivo .appinstaller e ao protocolo de distribuição.

Windows 10 1909 e anterior:

Problemas comuns

Há alguns problemas comuns ao fazer sideload um aplicativo pela primeira vez na máquina do usuário. As próximas seções descrevem os problemas mais comuns e suas soluções.

Versão do Windows

Cada versão do Windows 10 aprimora a experiência de sideload, na tabela a seguir você vai encontrar quais recursos estão disponíveis em cada versão principal. Se você tentar fazer o sideload de um aplicativo usando um método que não possui suporte na sua versão do Windows 10, você receberá um erro de implantação.

Versão Notas de sideload
Build 17134 (Atualização de abril de 2018, versão 1803) O arquivo .appinstaller pode ser acessado pela pastas UNC/compartilhadas. As verificações de atualização configuráveis também estão disponíveis.
Build 16299 (Fall Creators Update, versão 1709) Introduziu o arquivo .appinstaller para fornecer atualizações automáticas ao seu aplicativo. Esta versão só possui suporte a pontos de extremidade HTTP. Verificações de atualização não são configuráveis e ocorrem a cada 24 horas.
Build 15063 (Creators Update, versão 1703) O aplicativo do Instalador de Aplicativo pode baixar dependências do aplicativo (somente no modo versão) da Store.
Build 14393 (Atualização de Aniversário, versão 1607) Não há suporte para o aplicativo do Instalador de Aplicativo para instalar os arquivos .appx e arquivos .appxbundle, e o arquivo .appinstaller não é suportado.
Build 10586 (Atualização de novembro, versão 1511) Fazer o sideload só está disponível por meio do PowerShell usando o Add-AppxPackage comando.
Build 10240 (Windows 10, versão 1507) Fazer o sideload só está disponível por meio do PowerShell usando o Add-AppxPackage comando.

Certificados confiáveis

Os pacotes de aplicativos devem ser assinados com um certificado confiável pelo dispositivo. Os certificados fornecidos pelas Autoridades de Certificado comuns são confiáveis por padrão no sistema operacional Windows.

No entanto, se o certificado usado para assinar um pacote de aplicativo não for confiável ou for um certificado gerado localmente/autoassinado usado durante o desenvolvimento, o instalador do aplicativo poderá informar que o pacote não é confiável e impedirá que ele seja instalado:

MSIX signed with missing or untrusted Cert

Para resolver esse problema, um usuário com direitos de administrador local para o dispositivo deve usar a ferramenta Certificados de Computador para importar o certificado para um dos seguintes contêineres:

  1. Computador Local: Pessoas Confiáveis
  2. Computador Local: Autoridades Raiz Confiáveis (não recomendadas)

Importante

Não importe certificados de assinatura de pacote para o repositório de Certificados do Usuário. O Instalador de Aplicativo não pesquisa certificados de usuário ao verificar a identidade do pacote.

A ferramenta de gerenciamento de Certificados de Computador pode ser facilmente encontrada pesquisando no Menu Iniciar:

Find the local Computer Certificates tool via the Start Menu

Depois que o certificado de assinatura for importado com êxito, executar novamente o instalador do aplicativo mostrará que o pacote é confiável e pode ser instalado:

MSIX signed with a trusted Cert

Dependências não instaladas

Os aplicativos do Windows 10 podem ter dependências de estrutura com base na plataforma de aplicativo usada para gerar o aplicativo. Se você estiver usando C# ou VB, o aplicativo precisará usar o .NET Runtime e os pacotes do .NET Framework. Aplicativos C++ exigem o VCLibs.

Importante

Se o pacote de aplicativo é compilado na configuração de modo Versão, as dependências de estrutura serão obtidas da Microsoft Store. No entanto, se o aplicativo é compilado na configuração de modo Depuração, as dependências serão obtidas a partir do local especificado no arquivo .appinstaller.

Os arquivos não estão acessíveis

Ao instalar em um ponto de extremidade HTTP, é importante verificar que todos os arquivos estejam acessíveis com o tipo MIME correto. O método mais fácil de verificar esses arquivos é seguindo os links fornecidos na página HTML gerada pelo Visual Studio. Você deve verificar esses arquivos:

  • .appinstaller arquivo, disponível como um application/xml
  • .appx e .appxbundle arquivos, disponíveis como application/vns.ms-appx

Falha na instalação do aplicativo com a mensagem de erro: o parâmetro está incorreto

Como não há suporte para URLs de vaidade no momento, ao usar o ms-appinstaller protocolo, o parâmetro de origem DEVE terminar em .appinstaller. Não importa se você redirecionar para um arquivo que termina com .appinstaller. Isso também falhará da mesma maneira. A única maneira de corrigir isso é verificar se a URL original termina com .appinstaller.

Isolar problemas de aplicativo do Instalador de Aplicativo

Se o Instalador de Aplicativos não puder instalar o aplicativo, essas etapas ajudarão a identificar o problema de instalação.

Verificar a instalação do arquivo de pacote do aplicativo

  • Baixe o arquivo do pacote do aplicativo em uma pasta local e tente instalá-lo usando o comando Add-AppxPackage PowerShell.

  • Baixe o arquivo .appinstaller para uma pasta local e tentar instalá-lo usando o comando Add-AppxPackage -Appinstaller do PowerShell.

Logs de eventos do Instalador de Aplicativo

A infraestrutura de implantação de aplicativo emite logs que geralmente são úteis para depurar problemas de instalação por meio do Visualizador de Eventos do Windows: Application and Services Logs -> Microsoft -> Windows -> AppxDeployment-Server