Problemas conhecidos e dicas de solução de problemas para a MSIX Packaging Tool

Este artigo descreve problemas conhecidos e fornece dicas de solução de problemas a serem consideradas ao converter seus aplicativos para MSIX usando a MSIX Packaging Tool. Consulte os nossos outros documentos se necessitar adquirir a MSIX Packaging Tool ou o driver em um ambiente desconectado.

Problemas conhecidos

Obtendo a versão mais recente do Insider Preview da MSIX Packaging Tool

Se você optou por participar do nosso Programa Insider, certifique-se de ter a versão correta da MSIX Packaging Tool:

• Vá para a seção Sobre na MSIX Packaging Tool para ver em qual versão você está.
• Vá aqui para determinar a versão mais recente do Insider Preview e confirme que você tem essa versão da MSIX Packaging Tool instalada.
• Verifique se o MSA que está registrado para voo é a conta que está conectada à Microsoft Store.
• Atualize manualmente a MSIX Packaging Tool através da Microsoft Store no seu computador. Se essa opção estiver disponível para você, abra a Loja, vá para Downloads e atualizações e clique em Obter atualizações. Como alternativa, procure a ferramenta MSIX Packaging Tool e, na página do produto, poderá pedir uma atualização.
• Para instalar a MSIX Packaging Tool para uso offline, siga estas instruções para garantir que você obtenha o aplicativo mais recente através do nosso processo offline.

Se estiver interessado em juntar-se ao nosso Programa Insider, vá a Junte-se ao MSIX Packaging Tool Insiders!.

Controlador da Ferramenta de Empacotamento MSIX

O driver MSIX Packaging Tool é fornecido como um pacote de recurso sob demanda (FOD) do Windows Update. Ele não será instalado se o serviço Windows Update estiver desativado no computador ou se as configurações do anel de voo do Windows Insider não corresponderem à compilação do sistema operacional do computador.

Se você está tendo problemas para adquirir o driver, ou você está trabalhando em um ambiente offline, você pode encontrar links para baixar o driver aqui.

Se você baixou o driver e está tendo problemas durante a conversão do pacote, pode ser um dos seguintes problemas.

Problemas de conectividade de rede

Os códigos de erro a seguir podem indicar que você está encontrando problemas de conexão:

• -2145107924 (0x8024402c)
• -2145107945 (0x80244017)
• -2145123272 (0x80240438)

Windows Server Update Service (WSUS), Configuration Manager ou políticas de grupo que afetam a conectividade do Windows Update

O código de erro a seguir pode indicar que as políticas no seu computador estão afetando a conectividade do Windows Update: -2145124306 (0x8024002e).

Se você receber esse código de erro, talvez seja necessário verificar as configurações e políticas do ambiente.

O driver requer uma reinstalação

Nesse cenário, o MSIX Packaging Tool irá informá-lo na mensagem de erro e nos registos de que o driver precisa de uma reinicialização. Reinicie o computador e inicie a conversão novamente para corrigir esse problema.

Erro ao iniciar o driver da ferramenta de empacotamento MSIX 0x80131500

Se você receber esse erro durante a conversão, quando você verificar o arquivo de log, você deve encontrar uma entrada como a seguinte:

[Error] Error monitoring: Insufficient system resources exist to complete the requested service

Este erro acontece quando a ferramenta inicia uma nova sessão de rastreamento de eventos do sistema, mas você excedeu o número máximo de sessões que o Windows pode criar em todo o sistema. Se ultrapassares o limite padrão (64), irás encontrar um erro ERROR_NO_SYSTEM_RESOURCES, o que provoca a falha do driver.

A solução é interromper algumas das sessões de Rastreamento de Eventos existentes seguindo estas etapas:

1. Abra o menu Iniciar e procure Monitor de Desempenho.
2. Clique com o botão direito do mouse nele e escolha Mais -> Executar como administrador.
3. No menu de árvore, escolha Conjuntos de coletores de dados -> Sessões de rastreamento de eventos.
4. Clique com o botão direito do mouse em algumas das sessões existentes na lista e escolha Parar.

Agora você pode tentar novamente executar a conversão com a MSIX Packaging Tool.

Versão mínima

Existem algumas funcionalidades a ter em conta que alteram automaticamente o suporte à versão mínima no seu pacote MSIX.

Impor requisitos de controle de versão da Microsoft Store

Se converter o seu instalador existente usando uma versão da MSIX Packaging Tool anterior a 1.2019.701.0, a ferramenta estava com os requisitos de versão da Microsoft Store ativados ou utilizou outra ferramenta para criar o seu pacote, que não definiu a versão mínima como 10.0.16299.0 (Windows 10, versão 1709). Isso causará uma mensagem de erro ao implantar seu aplicativo no Windows 10, versão 1709 ou uma versão posterior.

Para corrigir esse problema, abra a MSIX Packaging Tool e edite seu aplicativo por meio do Editor de pacotes. Abra o manifesto e defina o MinVersionTargetDeviceFamily atributo do elemento como "10.0.16299.0".

<Dependencies>
    <TargetDeviceFamily> Name="Windows.Desktop" MinVersion="10.0.16299.0" MaxVersionTested = "10.0.17763.0" />
</Dependencies>

MSIX com serviços

Na versão 1.2019.1220.0 da MSIX Packaging Tool, adicionamos suporte para a criação de um pacote MSIX com Serviços. Devido às restrições do sistema operacional com suporte a serviços, a MSIX Packaging Tool altera automaticamente a versão min suportada em um pacote MSIX com serviços para 10.0.19025.0. Isso significa que você não pode instalar um MSIX com serviços em um sistema operacional inferior ao Windows 10 versão 2004, mas você pode criar esse MSIX usando a MSIX Packaging Tool até o Windows 10 1809. Se você precisar instalar este aplicativo em um sistema operacional inferior, atualize a versão min apropriadamente, mas observe que o suporte para serviços não funcionará.

Estruturas e controladores

Se o aplicativo exigir uma estrutura, verifique se ela está instalada durante a fase de monitoramento da conversão. Percorra os logs para garantir que isso está acontecendo. Se o seu aplicativo requer um driver para ser instalado, você precisa avaliar se isso é necessário para que seu aplicativo seja executado corretamente. MSIX atualmente não suporta a instalação de driver.

Máquina remota

Se você estiver tendo problemas com o uso de uma VM remota para suas conversões, consulte Instruções de configuração para conversões de máquina remota.

Problemas durante a conversão

• Alguns instaladores podem falhar ao converter com o código de saída 259. Isso indica que o instalador gerou um thread e não esperou que ele fosse concluído. Em outras palavras, o thread principal terminou de instalar, mas saiu com o erro 259 porque gerou um thread que ainda está em execução. Recomendamos que você use a opção de instalação apropriada para setup.exe.

Problemas durante a assinatura

Certificado PE incorreto (0x800700C1)

Esse problema ocorre quando o pacote contém um arquivo binário que tem um certificado corrompido. Para resolver esse problema, use o dumpbin.exe /headers comando para despejar os cabeçalhos de arquivo e inspecionar elementos defeituosos. Reescreva manualmente os cabeçalhos para corrigir o problema. Em geral, a ferramenta MSIX Packaging deteta automaticamente cabeçalhos defeituosos. Se o problema persistir, envie feedback. Mais informações podem ser encontradas aqui.

Assinatura do Device Guard

Certifique-se de seguir estas etapas e de que você está atribuindo as funções apropriadas na Microsoft Store para Empresas.

Certificado expirado

• Use um carimbo de data/hora ao assinar seu pacote.
• Pode demitir-se com um sinal válido ou um certificado de carimbo de data/hora.

Você pode cancelar seu aplicativo usando o script de conversão em lote no MSIX Toolkit - Scripts.

Solução de problemas

Ficheiros de registo

Independentemente de sua conversão ter sido bem-sucedida ou não, os arquivos de log são gerados para cada conversão. Podem ser consultados aqui:

%localappdata%\packages\Microsoft.MsixPackagingTool_8wekyb3d8bbwe\LocalState\DiagOutputDir\

Os códigos de falha são escritos e indicam qualquer ponto de falha durante o processo de conversão. Os códigos de erro destinam-se a ser fáceis de usar.

Arquivos de log de dispositivos remotos ou VMs

Se a conversão for realizada em um dispositivo remoto ou em uma VM, recomendamos que você copie os arquivos de log desse dispositivo e anexe-os como parte do item de feedback. Isso nos ajudará a diagnosticar e resolver problemas de forma mais eficiente.

Você encontrará os logs das conversões remotas aqui: %localappdata%\packages\Microsoft.MsixPackagingTool_8wekyb3d8bbwe\LocalState\DiagOutputDir\<Logs_#>\RemoteServer\Log.txt

Seria ainda mais benéfico se você pudesse compartilhar toda a pasta Logs que incluirá as operações que ocorrem no cliente local, bem como no servidor remoto.

Problemas comuns

Erros de tradução do MakePri/Manifest

Este erro ocorre quando há um problema com o manifesto do pacote. Para identificar o problema, vá para o Editor de Pacotes e abra o manifesto. Ao abrir o manifesto, você pode identificar o problema e fornecer a correção adequada.

Arquivo não encontrado

O arquivo pode estar aberto ou inexistente. Para resolver esse problema, adicione o arquivo apropriado ou feche o arquivo que está em uso no momento. Observe que você não receberá um File not Found erro se ele estiver aberto. Em vez disso, você receberá um Access Denied ou File in Use erro.

Associações de tipo de arquivo

Os problemas relacionados às associações de tipo de arquivo (FTA) variam de pacote para pacote. MSIX Packaging Tool suporta associações de arquivos para instalações de clique duplo. Por exemplo, se seu aplicativo tiver menu de contexto, ele não será adicionado automaticamente, portanto, você precisará adicioná-lo manualmente ao manifesto. Consulte o elemento de manifesto desktop4:FileExplorerContextMenus para obter um exemplo.

Atalhos com argumentos

A ferramenta MSIX Packaging irá capturar todos os atalhos de nível de usuário, juntamente com argumentos. Caso esses atalhos não sejam detetados corretamente, você pode adicioná-los manualmente ao manifesto. Consulte desktop7:Shortcut para obter mais detalhes.

Diretório de instalação

Isso é mais comum para aqueles que usam uma unidade secundária para realizar conversões de aplicativos. Se você optar por alterar o local de instalação, ele alterará a raiz de onde todos os arquivos vão. Isso significa que a ferramenta MSIX Packaging precisará saber para onde vão todos esses arquivos e será capturada durante a conversão.

Você pode corrigir isso usando a gravação do Package Support Framework para instalar a correção de diretório. Nós adicionamos isso como um recurso por padrão na ferramenta MSIX, que permite isso até 1809. Se o seu aplicativo não estiver funcionando em 1709 e estiver em 1809, esse é provavelmente o problema.

Enviar comentários

A melhor maneira de enviar seus comentários é através do Hub de Feedback.

1. Abra o Hub de Comentários ou digite Windows + F.
2. Forneça um título e as etapas necessárias para reproduzir a edição.
3. Em Categoria, selecione Aplicativos e selecione MSIX Packaging Tool.
4. Anexe todos os arquivos de log associados à conversão. Você pode encontrar os logs na pasta fornecida acima.
5. Anexe o pacote MSIX convertido (se possível).
6. Clique em Enviar.

Você também pode nos enviar comentários diretamente da MSIX Packaging Tool indo para a guia Comentários em Configurações.