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 carregar aplicativos no Windows 10, o dispositivo do usuário deve atender aos seguintes requisitos:

Janelas 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 do Windows 10 deve suportar o .appinstaller esquema de arquivo 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 do Windows

Cada versão do Windows 10 melhora a experiência de carregamento lateral. Na tabela abaixo, encontrará quais funcionalidades estão disponíveis em cada versão principal. Se você tentar fazer sideload de um aplicativo usando um método não suportado em sua versão do Windows 10, você receberá um erro de implantação.

Certificados confiáveis

Os pacotes de aplicativos devem ser assinados com um certificado confiável para o dispositivo. Os certificados fornecidos por Autoridades de Certificação 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:

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

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 exigirá os pacotes .NET Runtime e .NET framework. 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 isso é seguindo os links fornecidos na página HTML gerada pelo Visual Studio. Deve verificar estes ficheiros:

• um .appinstaller arquivo, encontrado na Additional Links > App Installer File página gerada pelo Visual Studio
• um .appx, .appxbundle, .misx ou msixbundle arquivo, encontrado na Additional Links > Package Bundle página gerada pelo 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 implantação do 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. Arquivos de log adicionais são criados nesta pasta: %LocalAppData%\Packages\Microsoft.DesktopAppInstaller_8wekyb3d8bbwe\LocalState\DiagOutputDir