Executar, depurar e testar um pacote MSIXRun, debug, and test an MSIX package

Execute o aplicativo empacotado e veja a aparência dele sem precisar autenticá-lo.Run your packaged application and see how it looks without having to sign it. Em seguida, defina pontos de interrupção e percorra o código.Then, set breakpoints and step through code. Quando estiver pronto para testar o aplicativo em um ambiente de produção, autentique o aplicativo e instale-o.When you're ready to test your application in a production environment, sign your application and then install it. Este tópico mostra como executar cada um desses itens.This topic shows you how to do each of these things.

Executar o aplicativoRun your application

Você pode executar o aplicativo para testá-lo de forma local sem precisar obter um certificado e assiná-lo.You can run your application to test it out locally without having to obtain a certificate and sign it. A forma como você executa o aplicativo depende da ferramenta usada para criar o pacote.How you run the application depends on what tool you used to create the package.

Você criou o pacote usando o Visual StudioYou created the package by using Visual Studio

Defina o projeto de empacotamento como projeto de inicialização e pressione F5 para iniciar o aplicativo.Set the packaging project as the startup project, and then press F5 to start your app.

Você criou o pacote usando uma ferramenta diferenteYou created the package using a different tool

Abra um prompt de comando do Windows PowerShell e pelo diretório raiz dos arquivos do pacote execute este cmdlet:Open a Windows PowerShell command prompt, and from the root directory of your package files, run this cmdlet:

Add-AppxPackage –Register AppxManifest.xml

Para iniciar o aplicativo, encontre-o no menu Iniciar do Windows.To start your app, find it in the Windows Start menu.

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.A packaged application always runs as an interactive user, and any drive that you install your packaged application on to must be formatted to NTFS format.

Depurar o aplicativoDebug your app

A forma como você depura o aplicativo depende da ferramenta usada para criar o pacote.How you debug the application depends on what tool you used to create the package.

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.If you created your package by using the new packaging project available in Visual Studio 2017 version 15.4 and later (including Visual Studio 2019), just set the packaging project as the startup project, and then press F5 to debug your app.

Se tiver criado o pacote usando qualquer outra ferramenta, siga estas etapas:If you created your package using any other tool, follow these steps:

  1. Assegure-se de iniciar o aplicativo empacotado pelo menos uma vez para que ele seja instalado no computador local.Make sure that you start your packaged application at least one time so that it's installed on your local machine.

    Consulte a seção Executar o aplicativo acima.See the Run your app section above.

  2. Inicie o Visual Studio.Start Visual Studio.

    Se quiser depurar o aplicativo com permissões elevadas, inicie o Visual Studio usando a opção Executar como Administrador.If you want to debug your application with elevated permissions, start Visual Studio by using the Run as Administrator option.

  3. No Visual Studio, escolhaDepurar->Outros Destinos de Depuração->Depurar Pacote de Aplicativo Instalado.In Visual Studio, choose Debug->Other Debug Targets->Debug Installed App Package.

  4. Na lista Pacotes de Aplicativo Instalados, selecione o pacote de aplicativo e escolha o botão Anexar.In the Installed App Packages list, select your app package, and then choose the Attach button.

Modificar o aplicativo entre sessões de depuraçãoModify your application in between debug sessions

Se você fizer alterações no aplicativo para corrigir bugs, reempacote-o e use a ferramenta MakeAppx.If you make your changes to your application to fix bugs, repackage it by using the MakeAppx tool. Consulte Executar a ferramenta MakeAppx.See Run the MakeAppx tool.

Depurar todo o ciclo de vida do aplicativoDebug the entire application lifecycle

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.In some cases, you might want finer-grained control over the debugging process, including the ability to debug your application before it starts.

Você pode usar o PLMDebug para obter controle total do ciclo de vida do aplicativo, incluindo suspensão, retomada e encerramento.You can use PLMDebug to get full control over application lifecycle including suspending, resuming, and termination.

O PLMDebug está incluído no SDK do Windows.PLMDebug is included with the Windows SDK.

Teste seu aplicativoTest your app

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.To deploy your packaged application for end-to-end production testing as you prepare for distribution, you need to sign your package with a certificate that is trusted on the machine you're deploying the app.

Testar um aplicativo empacotado usando o Visual StudioTest an application that you packaged by using Visual Studio

O Visual Studio autentica o aplicativo usando um certificado de teste.Visual Studio signs your application by using a test certificate. Você encontrará o certificado na pasta de saída gerada pelo assistente Criar Pacotes de Aplicativo.You'll find that certificate in the output folder that the Create App Packages wizard generates. 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.The certificate file has the .cer extension and you'll have to install that certificate into the Trusted People certificate store on the PC that you want to test your application on. Veja Empacotar um aplicativo UWP ou de área de trabalho no Visual Studio.See Package a desktop or UWP app in Visual Studio.

Testar um aplicativo empacotado usando uma ferramenta diferenteTest an application that you packaged using a different tool

Se tiver empacotado o aplicativo fora do Visual Studio será possível autenticar o pacote do aplicativo usando uma Ferramenta de Assinatura.If you package your application outside of Visual Studio you can sign your application package using the Sign Tool. 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.If the cert you used for signing is not trusted on the machine you're testing on, you'll need to install the cert to Trusted People certificate store before installing the app package.

Assinar o pacote do aplicativoSign your application package

Para autenticar manualmente o pacote do aplicativo:To manually sign your application package:

  1. Crie um certificado.Create a certificate. Veja Criar um certificado.See Create a certificate.

  2. Instale o certificado no armazenamento de certificados Pessoas Confiáveis no sistema.Install that certificate into the Trusted People certificate store on your system.

  3. Autentique o aplicativo usando o certificado, consulte Autenticar um pacote de aplicativo usando a SignTool.Sign your application by using that certificate, see Sign an app package using SignTool.

Importante

Assegure-se de que o nome do editor no certificado corresponda ao nome do editor no aplicativo.Make sure that the publisher name on your certificate matches the publisher name of your app.

Exemplo relacionadoRelated sample

SigningCertsSigningCerts

Testar o aplicativo no Windows 10 STest your application for 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.Before you publish your app, make sure that it will operate correctly on devices that run Windows 10 S. In fact, if you plan to publish your application to the Microsoft Store, you must do this because it is a store requirement. Os aplicativos que não funcionam corretamente em dispositivos com o Windows 10 S não serão certificados.Apps that don't operate correctly on devices that run Windows 10 S won't be certified.

Veja Testar o aplicativo Windows para Windows 10 S.See Test your Windows application for Windows 10 S.

Executar outro processo dentro do contêiner de confiança totalRun another process inside the full trust container

Você pode chamar processos personalizados dentro do contêiner de um pacote do aplicativo especificado.You can invoke custom processes inside the container of a specified app package. Isso pode ser útil para testar os cenários (por exemplo, se você tiver um utilitário de teste personalizado e deseja testar a saída do aplicativo).This can be useful for testing scenarios (for example, if you have a custom test harness and want to test output of the app). Para fazer isso, use o cmdlet do PowerShell Invoke-CommandInDesktopPackage:To do so, use the Invoke-CommandInDesktopPackage PowerShell cmdlet:

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

Próximas etapasNext steps

Tem dúvidas?Have questions? Pergunte-nos na MSIX Tech Community.Ask us on the MSIX Tech Community.