Compartilhar via


Executar, depurar e testar um pacote MSIX

Execute o aplicativo empacotado e veja a aparência dele sem precisar autenticá-lo. Em seguida, defina pontos de interrupção e percorra o código. Quando estiver pronto para testar o aplicativo em um ambiente de produção, autentique o aplicativo e instale-o. Este tópico mostra como executar cada um desses itens.

Execute seu aplicativo.

Você pode executar o aplicativo para testá-lo de forma local sem precisar obter um certificado e assiná-lo. A forma como você executa o aplicativo depende da ferramenta usada para criar o pacote.

Você criou o pacote usando o Visual Studio

Defina o projeto de empacotamento como projeto de inicialização e pressione F5 para iniciar o aplicativo.

Você criou o pacote usando uma ferramenta diferente

Abra um prompt de comando do Windows PowerShell e pelo diretório raiz dos arquivos do pacote execute este cmdlet:

Add-AppxPackage –Register AppxManifest.xml

Para iniciar o aplicativo, encontre-o no menu Iniciar do Windows.

Aplicativo empacotado no menu Iniciar

Observação

Um aplicativo empacotado sempre é executado como um usuário interativo e qualquer unidade na qual você instale o aplicativo empacotado deve estar formatada em NTFS.

Depurar seu aplicativo

A forma como você depura o aplicativo depende da ferramenta usada para criar o pacote.

Se tiver criado o pacote usando o novo projeto de empacotamento disponível no Visual Studio 2017 versão 15.4 e posteriores (incluindo o Visual Studio 2019), basta definir o projeto de empacotamento como o projeto de inicialização e pressione F5 para depurar o aplicativo.

Se tiver criado o pacote usando qualquer outra ferramenta, siga estas etapas:

  1. Assegure-se de iniciar o aplicativo empacotado pelo menos uma vez para que ele seja instalado no computador local.

    Consulte a seção Executar o aplicativo acima.

  2. Inicie o Visual Studio.

    Se quiser depurar o aplicativo com permissões elevadas, inicie o Visual Studio usando a opção Executar como Administrador.

  3. No Visual Studio, escolha Depurar->Outros Destinos de Depuração->Depurar Pacote de Aplicativo Instalado.

  4. Na lista Pacotes de Aplicativo Instalados, selecione o pacote de aplicativo e escolha o botão Anexar.

Modificar o aplicativo entre sessões de depuração

Se você fizer alterações no aplicativo para corrigir bugs, reempacote-o e use a ferramenta MakeAppx. Consulte Executar a ferramenta MakeAppx.

Depurar todo o ciclo de vida do aplicativo

Em alguns casos, você poderá querer um controle mais refinado do processo de depuração incluindo a capacidade de depurar o aplicativo antes que ele seja iniciado.

Você pode usar o PLMDebug para obter controle total do ciclo de vida do aplicativo, incluindo suspensão, retomada e encerramento.

O PLMDebug está incluído no SDK do Windows.

Testar seu aplicativo

Para implantar o aplicativo empacotado em um teste completo do aplicativo empacotado durante a preparação para distribuição, é necessário autenticar o pacote com um certificado que seja confiável no computador em que você está implantando o aplicativo.

Testar um aplicativo empacotado usando o Visual Studio

O Visual Studio autentica o aplicativo usando um certificado de teste. Você encontrará o certificado na pasta de saída gerada pelo assistente Criar Pacotes de Aplicativo. O arquivo de certificado tem a extensão .cer e você precisará instalar o certificado no armazenamento de certificados Pessoas Confiáveis no computador em que deseja testar o aplicativo. Veja Empacotar um aplicativo UWP ou de área de trabalho no Visual Studio.

Testar um aplicativo empacotado usando uma ferramenta diferente

Se tiver empacotado o aplicativo fora do Visual Studio será possível autenticar o pacote do aplicativo usando uma Ferramenta de Assinatura. Se o certificado usado para autenticar não for confiável no computador em que está sendo testado, será necessário instalá-lo no armazenamento de certificados Pessoas Confiáveis antes de instalar o pacote de aplicativo.

Assinar o pacote do aplicativo

Para autenticar manualmente o pacote do aplicativo:

  1. Criar um certificado. Veja Criar um certificado.

  2. Instale o certificado no armazenamento de certificados Pessoas Confiáveis no sistema.

  3. Autentique o aplicativo usando o certificado, consulte Autenticar um pacote de aplicativo usando a SignTool.

Importante

Assegure-se de que o nome do editor no certificado corresponda ao nome do editor no aplicativo.

Exemplo relacionado

SigningCerts

Testar o aplicativo com ComparePackage.exe

ComparePackage.exe é uma ferramenta no SDK do Windows que mostra um relatório indicando os arquivos que foram alterados, adicionados e excluídos, bem como o que não foi alterado, após a atualização de um aplicativo para outra versão.

Testar seu aplicativo usando a Anexação de Aplicativo Local

A Anexação de Aplicativo Local permite que você execute aplicativos MSIX sem instalá-los no dispositivo. As APIs que alimentam a Anexação de Aplicativo Local são totalmente compatíveis no Windows 11 Enterprise e no Windows 10 Enterprise, incorporadas ao sistema operacional para montar e desmontar os aplicativos. Você também pode usar cmdlets ou scripts do PowerShell para automatizar o processo. Para obter mais informações, consulte Testar pacotes MSIX para anexação de aplicativo.

Testar o aplicativo no Windows 10 S

Antes de publicar o aplicativo, assegure-se de que ele funcionará corretamente em dispositivos com o Windows 10 S. Na verdade, se estiver planejando publicar o aplicativo na Microsoft Store será necessário fazer isso, já que é um requisito da loja. Os aplicativos que não funcionam corretamente em dispositivos com o Windows 10 S não serão certificados.

Veja Testar o aplicativo Windows para Windows 10 S.

Executar outro processo dentro do contêiner de confiança total

Você pode invocar processos personalizados dentro do contêiner de um pacote de aplicativo especificado. Isso pode ser útil para cenários de teste (por exemplo, se você tiver um conjunto de testes personalizado e quiser testar a saída do aplicativo). Para fazer isso, use o cmdlet Invoke-CommandInDesktopPackage do PowerShell:

Invoke-CommandInDesktopPackage [-PackageFamilyName] <string> [-AppId] <string> [-Command] <string> [[-Args]
    <string>]  [<CommonParameters>]

Próximas etapas

Tem dúvidas? Pergunte-nos na MSIX Tech Community.