Empacotar um aplicativo da área de trabalho ou UWP no Visual Studio

Antes de distribuir seu aplicativo, você precisa empacotá-lo. Este artigo descreve o processo de configuração, criação e teste de um pacote MSIX usando o Visual Studio.

Tipos de pacotes de aplicativos

• Pacote de aplicativos (.msix ou .appx)
  Um único pacote que contém seu aplicativo e seus recursos, direcionado a uma arquitetura de dispositivo único. Por exemplo, um pacote de aplicativo x64 ou x86. Para direcionar várias arquiteturas com um pacote de aplicativos, você precisa gerar uma para cada arquitetura.

• Pacote de aplicativos (.msixbundle ou .appxbundle)
  Um pacote de aplicativos é um tipo de pacote que pode conter vários pacotes de aplicativos, cada um dos quais é criado para dar suporte a uma arquitetura de dispositivo específica. Por exemplo, um pacote de aplicativos pode conter três pacotes de aplicativos separados para as configurações x86, x64 e ARM. Os pacotes de aplicativos devem ser gerados sempre que possível, pois permitem que seu aplicativo esteja disponível na maior variedade possível de dispositivos.

• Arquivo de Upload de Pacote de Aplicativo (.msixupload ou .appxupload) - apenas para Envio na Loja
  Um único arquivo que pode conter vários pacotes de aplicativos ou um pacote de aplicativos para suportar várias arquiteturas de processador. O arquivo de carregamento do pacote do aplicativo também contém um arquivo de símbolo para Analisar o desempenho do aplicativo após a publicação do aplicativo na Microsoft Store. Esse arquivo será criado automaticamente para você se você estiver empacotando seu aplicativo com o Visual Studio com a intenção de enviá-lo ao Partner Center para publicação na Microsoft Store.

Aqui está uma visão geral das etapas para preparar e criar um pacote de aplicativo:

1. Antes de empacotar seu aplicativo. Siga estas etapas para garantir que seu aplicativo esteja pronto para ser empacotado.

2. Configure seu projeto. Use o designer de manifesto do Visual Studio para configurar o pacote. Por exemplo, adicione imagens de mosaico e escolha as orientações suportadas pela sua aplicação.

3. Gere um pacote de aplicativo. Use o assistente de empacotamento do Visual Studio para criar um pacote de aplicativo.

4. Execute, depure e teste um aplicativo empacotado. Execute e depure o pacote do aplicativo a partir do Visual Studio ou instalando o pacote diretamente.

Antes de empacotar seu aplicativo

1. Testar a aplicação. Antes de empacotar seu aplicativo, verifique se ele funciona como esperado em todas as famílias de dispositivos que você planeja suportar. Essas famílias de dispositivos podem incluir desktop, dispositivos móveis, Surface Hub, Xbox, dispositivos IoT ou outros. Para obter mais informações sobre como implantar e testar seu aplicativo usando o Visual Studio, consulte Implantando e depurando aplicativos UWP (também se aplica a aplicativos de área de trabalho empacotados).

2. Otimize seu aplicativo. Você pode usar as ferramentas de criação de perfil e depuração do Visual Studio para otimizar o desempenho do seu aplicativo empacotado. Por exemplo, a ferramenta Linha do tempo para a capacidade de resposta da interface do usuário, a ferramenta Uso da memória, a ferramenta Uso da CPU e muito mais. Para obter mais informações sobre essas ferramentas, consulte o tópico Profiling Feature Tour .

3. Verifique a compatibilidade nativa do .NET (para aplicativos VB e C#). Na Plataforma Universal do Windows, há um compilador nativo que melhorará o desempenho do tempo de execução do seu aplicativo. Com essa alteração, você deve testar seu aplicativo neste ambiente de compilação. Por padrão, a configuração de compilação de versão habilita a cadeia de ferramentas nativa do .NET , portanto, é importante testar seu aplicativo com essa configuração de versão e verificar se seu aplicativo se comporta conforme o esperado.

Configure seu projeto

O arquivo de manifesto do aplicativo (Package.appxmanifest) é um arquivo XML que contém as propriedades e as configurações necessárias para criar o pacote do aplicativo. Por exemplo, as propriedades no arquivo de manifesto do aplicativo descrevem a imagem a ser usada como o bloco do seu aplicativo e as orientações que seu aplicativo suporta quando um usuário gira o dispositivo.

O designer de manifesto do Visual Studio permite que você atualize o arquivo de manifesto sem editar o XML bruto do arquivo.

Configurar um pacote com o editor de manifesto

1. No Explorador de Soluções, expanda o nó do projeto da sua aplicação.

2. Dê um duplo clique no ficheiro Package.appxmanifest. Se o arquivo de manifesto já estiver aberto na exibição de código XML, o Visual Studio solicitará que você feche o arquivo.

3. Agora você pode decidir como configurar seu aplicativo. Cada guia contém informações que você pode configurar sobre seu aplicativo e links para mais informações, se necessário.

   

   Verifique se você tem todas as imagens necessárias para um aplicativo na guia Ativos Visuais . É aqui que você forneceria ícones e logotipos de aplicativos.

   Na guia Embalagem , você pode inserir dados de publicação. É aqui que você pode escolher qual certificado usar para assinar seu aplicativo. Todos os aplicativos MSIX devem ser assinados com um certificado.

   Observação

   A partir do Visual Studio 2019, um certificado temporário não volta a ser gerado em projetos de desktop ou UWP empacotados. Para criar ou exportar certificados, use os cmdlets do PowerShell descritos no artigo. Em versões recentes do Visual Studio, você também pode assinar seu aplicativo com um certificado armazenado no Cofre da Chave do Azure para cenários de desenvolvimento e teste.

   Importante

   Se você estiver publicando seu aplicativo na Microsoft Store, seu aplicativo será assinado com um certificado confiável para você. Isso permite que o usuário instale e execute seu aplicativo sem instalar o certificado de assinatura de aplicativo associado.

   Se estiver a instalar o pacote da aplicação no seu dispositivo, primeiro tem de confiar no pacote. Para confiar no pacote, o certificado deve ser instalado no dispositivo do usuário.

4. Salve seu arquivo Package.appxmanifest depois de fazer as edições necessárias para seu aplicativo.

Se você estiver distribuindo seu aplicativo por meio da Microsoft Store, o Visual Studio poderá associar seu pacote à Loja. Para fazer isso, clique com o botão direito do mouse no nome do projeto no Gerenciador de Soluções e escolha Publicar>Aplicativo Associado à Loja (antes do Visual Studio 2019 versão 16.3, o menu Publicar é chamado Loja). Você também pode fazer isso no assistente Criar pacotes de aplicativos , que é descrito na seção a seguir. Quando você associa seu aplicativo, alguns dos campos na guia Empacotamento do designer de manifesto são atualizados automaticamente.

Gerar um pacote de aplicativo

As aplicações podem ser instaladas sem serem publicadas na Loja, publicando-as no seu Website, utilizando ferramentas de gestão de aplicações como o Microsoft Intune e o Configuration Manager, etc. Você também pode instalar diretamente um pacote MSIX para teste em sua máquina local ou remota.

Criar um pacote de aplicativo usando o assistente de empacotamento

1. No Gerenciador de Soluções, abra a solução para seu projeto de aplicativo.

2. Clique com o botão direito do rato no projeto e escolha Publicar-> (antes da versão 16.3 do Visual Studio 2019, o menu Publicar é chamado Loja).

   

3. Selecione Carregamento Lateral na primeira página do assistente e clique em Avançar.

   

4. Na página Selecionar método de assinatura , selecione se deseja ignorar a assinatura de empacotamento ou selecionar um certificado para assinatura. Você pode selecionar um certificado do armazenamento de certificados local, selecionar um arquivo de certificado ou criar um novo certificado. Para que um pacote MSIX seja instalado na máquina de um usuário final, ele deve ser assinado com um certificado confiável na máquina.

   

5. Conclua a página Selecionar e configurar pacotes conforme descrito na seção Criar seu arquivo de carregamento de pacote de aplicativo usando o Visual Studio .

Instale o pacote do aplicativo clicando duas vezes

Os pacotes de aplicativos podem ser instalados simplesmente clicando duas vezes no arquivo de pacote do aplicativo. Para fazer isso, navegue até o pacote do aplicativo ou o arquivo do pacote do aplicativo e clique duas vezes nele. O App Installer é iniciado e fornece as informações básicas do aplicativo, bem como um botão de instalação, barra de progresso da instalação e quaisquer mensagens de erro relevantes.

Instalar o pacote do aplicativo usando um script de instalação

1. Abra a pasta *_Test.

2. Clique com o botão direito do rato no ficheiro Add-AppDevPackage.ps1 . Escolha Executar com PowerShell e siga os prompts.
   

   Quando o pacote do aplicativo tiver sido instalado, a janela do PowerShell exibirá esta mensagem: Seu aplicativo foi instalado com êxito.

3. Clique no botão Iniciar para procurar a aplicação pelo nome e, em seguida, inicie-a.

Próximas etapas: Depurar e testar o pacote do aplicativo

Consulte Executar, depurar e testar um pacote de aplicativo para saber como você pode depurar seu aplicativo no Visual Studio ou usando ferramentas de depuração do Windows.

Gerar um ficheiro de upload de pacote de aplicação para envio na Loja

Para distribuir seu aplicativo para a Microsoft Store, recomendamos que você gere um arquivo de carregamento de pacote de aplicativo (.msixupload ou .appxupload) e envie esse arquivo para o Partner Center. Embora seja possível enviar um pacote ou conjunto de aplicativos diretamente no Partner Center, recomendamos que envie, em vez disso, um ficheiro de carregamento de pacote de aplicativo.

Você pode criar um arquivo de carregamento de pacote de aplicativo usando o assistente Criar Pacotes de Aplicativo no Visual Studio, ou pode criar um manualmente a partir de pacotes de aplicativos ou pacotes de aplicativos existentes.

Criar o arquivo de carregamento do pacote do aplicativo usando o Visual Studio

1. No Gerenciador de Soluções, abra a solução para seu projeto de aplicativo UWP.

2. Clique com o botão direito do rato no projeto e escolha Publicar-> (antes da versão 16.3 do Visual Studio 2019, o menu Publicar é chamado Loja). Se essa opção estiver desabilitada ou não aparecer, verifique se o projeto é um projeto Universal do Windows.

   

   O assistente Criar Pacotes de Aplicativos é exibido.

3. Selecione Microsoft Store usando um novo nome de aplicativo na primeira caixa de diálogo e clique em Avançar.

   

   Se já tiver associado o seu projeto a uma aplicação na Loja, também tem uma opção para criar pacotes para a aplicação da Loja associada. Se você escolher Sideloading, o Visual Studio não gerará o arquivo de carregamento do pacote do aplicativo (.msixupload ou .appxupload) para envios do Partner Center. Se quiseres apenas criar um pacote MSIX ou bundle para distribuição fora da Microsoft Store, podes selecionar esta opção.

4. Na página seguinte, inicie sessão com a sua conta de programador no Partner Center. Se ainda não tiver uma conta de programador, o assistente ajudá-lo-á a criar uma.

   

5. Selecione o nome do aplicativo para seu pacote na lista de aplicativos atualmente registrados em sua conta ou reserve um novo se ainda não tiver reservado um no Partner Center.

   Observação

   Se você estiver usando o Visual Studio 2017, não poderá listar aplicativos atualmente registrados em sua conta ou reservar novos nomes de aplicativos ao usar uma conta da Microsoft (MSA), somente as contas do Azure Ative Directory (AAD) funcionarão. As contas MSA são suportadas a partir do Visual Studio 2019.

6. Certifique-se de selecionar todas as três configurações de arquitetura (x86, x64 e ARM) na caixa de diálogo Selecionar e Configurar Pacotes para garantir que seu aplicativo possa ser implantado na maior variedade de dispositivos. Na caixa de listagem Gerar pacote de aplicativos , selecione Sempre. Um pacote de aplicativos (.appxbundle ou .msixbundle) é preferível a um único arquivo de pacote de aplicativo porque contém uma coleção de pacotes de aplicativos configurados para cada tipo de arquitetura de processador. Quando você optar por gerar o pacote de aplicativos, o pacote de aplicativos será incluído no arquivo final de upload do pacote de aplicativos (.appxupload ou .msixupload), juntamente com informações analíticas de depuração e falhas. Se não tiver certeza de quais arquiteturas escolher, ou quiser saber mais sobre quais arquiteturas são usadas por vários dispositivos, consulte Arquiteturas de pacotes de aplicativos.

   

7. Inclua arquivos de símbolos públicos para Analisar o desempenho do aplicativo do Partner Center após a publicação do aplicativo. Configure quaisquer detalhes adicionais, como numeração de versão ou o local de saída do pacote.

8. Clique em Criar para gerar o pacote do aplicativo. Se você selecionou uma das opções Quero criar pacotes para carregar na Microsoft Store na etapa 3 e estiver criando um pacote para envio do Partner Center, o assistente criará um arquivo de carregamento de pacote (.appxupload ou .msixupload). Caso tenha selecionado Quero criar pacotes para carregamento lateral na etapa 3, o assistente criará um único pacote de aplicação ou um pacote de múltiplas aplicações com base nas suas seleções na etapa 6.

9. Quando o aplicativo tiver sido empacotado com êxito, você verá essa caixa de diálogo e poderá recuperar o arquivo de carregamento do pacote do aplicativo do local de saída especificado. Neste ponto, você pode validar o pacote do aplicativo na máquina local ou em uma máquina remota e automatizar os envios da loja.

   

Crie o arquivo de upload do pacote do aplicativo manualmente

1. Coloque os seguintes arquivos em uma pasta:

   • Um ou mais pacotes de aplicativos (.msix ou .appx) ou um pacote de aplicativos (.msixbundle ou .appxbundle).
   • Um arquivo .appxsym. Este é um arquivo .pdb compactado que contém símbolos públicos do seu aplicativo usado para análise de falhas no Partner Center. Você pode omitir esse arquivo, mas se fizer isso, nenhuma informação analítica ou de depuração de falhas estará disponível para seu aplicativo.

2. Selecione todos os arquivos dentro da pasta, clique com o botão direito do mouse nos arquivos e selecione Enviar para a> (zipada).

3. Altere o nome da extensão do novo arquivo zip de .zip para .msixupload ou .appxupload.

Validar o pacote do aplicativo

Valide seu aplicativo antes de enviá-lo ao Partner Center para certificação em uma máquina local ou remota. Você pode validar apenas compilações de versão para o seu pacote de aplicações, não compilações de depuração. Para obter mais informações sobre como enviar seu aplicativo para o Partner Center, consulte Envios de aplicativos.

Valide o pacote do aplicativo localmente

1. Na página final Criação de Pacote Concluída do assistente Criar Pacotes de Aplicativos , deixe a opção Máquina local selecionada e clique em Iniciar Kit de Certificação de Aplicativos Windows. Para obter mais informações sobre como testar seu aplicativo com o Kit de Certificação de Aplicativos Windows, consulte Kit de Certificação de Aplicativos Windows.

   O Kit de Certificação de Aplicativos Windows (WACK) executa vários testes e retorna os resultados. Consulte Testes do Kit de Certificação de Aplicativos Windows para obter informações mais específicas.

   Se tiver um dispositivo Windows 10 remoto que pretende utilizar para testes, terá de instalar manualmente o Kit de Certificação de Aplicações Windows nesse dispositivo. A próxima secção irá guiá-lo através destes passos. Depois de fazer isso, você pode selecionar Máquina remota e clicar em Iniciar Kit de Certificação de Aplicativos Windows para se conectar ao dispositivo remoto e executar os testes de validação.

2. Depois que o WACK for concluído e seu aplicativo for aprovado na certificação, você estará pronto para enviar seu aplicativo ao Partner Center. Certifique-se de carregar o arquivo correto. O local padrão do arquivo pode ser encontrado na pasta raiz da sua solução \[AppName]\AppPackages e terminará com a extensão de arquivo .appxupload ou .msixupload. O nome terá a forma [AppName]_[AppVersion]_x86_x64_arm_bundle.appxupload ou [AppName]_[AppVersion]_x86_x64_arm_bundle.msixupload se optares por um conjunto de apps com toda a arquitetura de pacotes selecionada.

Validar o pacote da aplicação num dispositivo Windows 10 remoto

1. Habilite seu dispositivo Windows 10 para desenvolvimento seguindo as instruções Habilitar seu dispositivo para desenvolvimento .

   Importante

   Não é possível validar o pacote do aplicativo em um dispositivo ARM remoto para Windows 10.

2. Baixe e instale as ferramentas remotas para Visual Studio. Essas ferramentas são usadas para executar o Kit de Certificação de Aplicativos Windows remotamente. Você pode obter mais informações sobre essas ferramentas, incluindo onde baixá-las visitando Executar aplicativos MSIX em uma máquina remota.

3. Transfira o Kit de Certificação de Aplicações Windows necessário e, em seguida, instale-o no seu dispositivo remoto Windows 10.

4. Na página Criação de Pacote Concluída do assistente, escolha o botão de opção Máquina Remota e, em seguida, escolha o botão de reticência ao lado do botão Testar Ligação.

   Observação

   O botão de opção Máquina Remota só estará disponível se você tiver selecionado pelo menos uma configuração de solução que ofereça suporte à validação. Para obter mais informações sobre como testar seu aplicativo com o WACK, consulte Kit de Certificação de Aplicativos Windows.

5. Especifique um formulário de dispositivo dentro da sub-rede ou forneça o nome DNS (Servidor de Nomes de Domínio) ou o endereço IP de um dispositivo que esteja fora da sub-rede.

6. Na lista Modo de autenticação , escolha Nenhum se o dispositivo não exigir que você faça logon usando suas credenciais do Windows.

7. Escolha o botão Selecionar e, em seguida, escolha o botão Iniciar Kit de Certificação de Aplicativos Windows . Se as ferramentas remotas estiverem sendo executadas nesse dispositivo, o Visual Studio se conectará ao dispositivo e executará os testes de validação. Consulte Testes do Kit de Certificação de Aplicativos Windows.

Automatize os envios da Loja

A partir do Visual Studio 2019, você pode enviar o arquivo .appxupload gerado para a Microsoft Store diretamente do IDE selecionando a opção Enviar automaticamente para a Microsoft Store após a validação do Kit de Certificação de Aplicativos Windows no final do assistente Criar Pacotes de Aplicativos. Esse recurso aproveita o Ative Directory do Azure para acessar as informações da conta do Partner Center necessárias para publicar seu aplicativo. Para usar esse recurso, você precisará associar o Azure Ative Directory à sua conta do Partner Center e recuperar várias credenciais necessárias para envios.

Associar o Azure Ative Directory à sua conta do Partner Center

Antes de recuperares as credenciais necessárias para envios automáticos na Loja, deverás realizar estes passos no dashboard do Partner Center caso ainda não o tenhas feito.

1. Associe a sua conta do Partner Center ao Azure Ative Directory da sua organização. Se a sua organização já utiliza o Office 365 ou outros serviços empresariais da Microsoft, já tem o Azure AD. Caso contrário, você pode criar um novo locatário do Azure AD de dentro do Partner Center sem custo adicional.

2. Adicione um aplicativo do Azure AD à sua conta do Partner Center. Este aplicativo do Azure AD representa o aplicativo ou serviço que você usará para acessar envios para sua conta do Centro de Desenvolvimento. Você deve atribuir este aplicativo à função Gerente . Se esse aplicativo já existir em seu diretório do Azure AD, você poderá selecioná-lo na página Adicionar aplicativos do Azure AD para adicioná-lo à sua conta do Centro de Desenvolvimento. Caso contrário, você pode criar um novo aplicativo do Azure AD na página Adicionar aplicativos do Azure AD .

Recupere as credenciais necessárias para submissões

Em seguida, você pode recuperar as credenciais do Partner Center necessárias para envios: a ID do Locatário do Azure, a ID do Cliente e a chave do Cliente.

1. Vá para o painel do Partner Center e entre com suas credenciais do Azure AD.

2. No painel do Partner Center, selecione o ícone de engrenagem (próximo ao canto superior direito do painel) e selecione Configurações do desenvolvedor.

3. No menu Configurações no painel esquerdo, clique em Usuários.

4. Clique no nome do seu aplicativo do Azure AD para ir para as configurações do aplicativo. Nesta página, copie os valores ID do Locatário e ID do Cliente .

5. Na seção Chaves , clique em Adicionar nova chave. Na tela seguinte, copie o valor da chave , que corresponde ao segredo do cliente. Você não poderá acessar essas informações novamente depois de sair desta página, portanto, certifique-se de não perdê-las. Para obter mais informações, consulte Gerenciar chaves para um aplicativo do Azure AD.

Configurar envios automáticos na Microsoft Store no Visual Studio

Depois de concluir as etapas anteriores, você pode configurar envios automáticos da Loja no Visual Studio 2019.

1. No final do assistente Criar Pacotes de Aplicativos, selecione Enviar automaticamente para a Microsoft Store após a validação do Kit de Certificação de Aplicativos Windows e clique em Reconfigurar.

2. Na caixa de diálogo Configurar configurações de envio da Microsoft Store , insira a ID do locatário do Azure, a ID do cliente e a chave do cliente.

   

   Importante

   Suas credenciais podem ser salvas em seu perfil para serem usadas em envios futuros

3. Clique em OK.

A submissão começará após o teste WACK ter terminado. Você pode acompanhar o progresso do envio na janela Verificar e publicar .