Solucionar problemas de instalação com o arquivo do App Installer

Se você encontrar algum problema ao instalar um aplicativo a partir do arquivo do App Installer, este tópico fornecerá algumas diretrizes de solução de problemas que podem ajudar.

Pré-requisitos

Para poder instalar aplicações de fontes externas no Windows 10, o dispositivo do utilizador tem que satisfazer os seguintes requisitos:

Windows 10:

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

Windows 10 1909 e anteriores:

• O dispositivo deve estar configurado para o Modo de Desenvolvedor ou para o carregamento lateral de aplicações. Consulte Habilitar seu dispositivo para desenvolvimento para saber mais.

Problemas comuns

Existem alguns problemas comuns ao carregar um programa pela primeira vez na máquina do utilizador. As próximas seções descrevem os problemas mais frequentes e suas soluções.

Versão Windows

Cada versão do Windows 10 melhora a experiência de carregamento lateral; na tabela abaixo encontrará quais as funcionalidades disponíveis em cada lançamento principal. Se tentares instalar uma aplicação manualmente usando um método não suportado na tua versão do Windows 10, vais receber um erro de implementação.

Certificados confiáveis

Os pacotes de aplicativos devem ser assinados com um certificado confiável para o dispositivo. Os certificados fornecidos pelas Entidades Certificadoras comuns são confiáveis automaticamente no sistema operativo 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:

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 recomendado)

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

Depois que o certificado de assinatura for importado com êxito, a nova execução do instalador do aplicativo mostrará que o pacote é confiável e pode ser instalado:

Dependências não instaladas

As aplicações do Windows 10 podem ter dependências de framework com base na plataforma de aplicação utilizada para gerar a aplicação. Se estiveres a usar C# ou VB, a aplicação vai precisar dos pacotes .NET Runtime e framework .NET. Os aplicativos C++ exigem o VCLibs.

Arquivos não acessíveis

Ao instalar a partir de um ponto de extremidade HTTP, é importante verificar se todos os arquivos necessários estão acessíveis. O método mais fácil para verificar isto é seguir os links fornecidos na página HTML gerada pelo Visual Studio. Deve verificar estes ficheiros:

• um ficheiro .appinstaller, encontrado em Additional Links > App Installer File na página gerada Visual Studio
• um ficheiro .appx, .appxbundle, .misx ou msixbundle, encontrado em Additional Links > Package Bundle na página gerada por Visual Studio

Arquivos servidos com tipo MIME errado

Ao instalar a partir de um endpoint HTTP, todos os arquivos devem ser servidos com seu tipo MIME correto incluído no cabeçalho pelo servidor web.

Arquivos servidos sem o cabeçalho Content-Length

Ao efetuar a instalação a partir de um ponto de extremidade HTTP, todas as respostas precisam incluir um cabeçalho correto Content-Length. Isso inclui GET, bem como HEAD solicitações. Certifique-se de que todos eles especificam corretamente Content-Length . Não o fazer pode levar a erros como App installation failed with error message: Appinstaller operation failed with error code 0x80072F76. Detail: Unknown error (0x80072f76) ou outros.

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

Uma vez que URLs personalizados não são suportados no momento, ao usar o protocolo ms-appinstaller, o parâmetro origem DEVE terminar em .appinstaller. Não importa se você redireciona para um arquivo que termina com .appinstaller. Isso também falhará da mesma forma. A única maneira de corrigir isso é certificar-se de que o url original termina com .appinstaller.

Isolar problemas do aplicativo App Installer

Se o App Installer não conseguir instalar a aplicação, estes passos ajudarão a identificar o problema de instalação.

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

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

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

Logs de eventos do App Installer

A infraestrutura de implementação da aplicação emite logs que são frequentemente úteis para depurar problemas de instalação através do Windows Visualizador de Eventos: Application and Services Logs -> Microsoft -> Windows -> AppxDeployment-Server. Ficheiros de registo adicionais são criados nesta pasta: %LocalAppData%\Packages\Microsoft.DesktopAppInstaller_8wekyb3d8bbwe\LocalState\DiagOutputDir