Assistente de empacotamento: seu guia passo a passo para criar seu aplicativo móvel nativo

Use este guia para converter um ou mais aplicativos de tela em um único pacote de aplicativo de marca personalizada que você pode implantar no Google Play e na App Store do iOS.

O recurso de empacotamento no Power Apps permite que você crie versões móveis nativas de seus aplicativos de tela como aplicativos móveis personalizados do Android e do iOS (pacotes IPA, APK, AAB). Você pode distribuir esses aplicativos móveis nativos empacotados para os usuários finais por meio do Google Play, Apple Business Manager ou outros métodos de distribuição nativos.

Quando você atualiza e republica seu aplicativo, o aplicativo empacotado é atualizado automaticamente para os usuários.

Etapas para criar um aplicativo nativo com marca personalizada usando o assistente de empacotamento

Siga estas etapas para configurar, compilar, assinar e distribuir um pacote de aplicativo móvel nativo de marca personalizada (APK, AAB ou IPA) de seus aplicativos de tela usando o assistente de encapsulamento no Power Apps.

1. Entrar e iniciar um projeto de empacotamento

1. Entre no portal do Power Apps maker.
2. Selecione Empacotar no painel de navegação esquerdo. Se o item não estiver no painel lateral, selecione …Mais e selecione o item desejado.
3. Selecione o aplicativo que deseja empacotar, em seguida, selecione Empacotar na barra de comandos.

2. Selecione aplicativos

1. Na tela Selecione o(s) aplicativo(s) a ser(em) empacotado(s), selecione os aplicativos principal e secundário.

   • Aplicativo principal: os usuários finais veem o aplicativo principal quando o aplicativo móvel é iniciado.
   • Aplicativos secundários: outros aplicativos opcionais incluídos no mesmo pacote de aplicativos móveis.

   Note

   • Você pode usar o mesmo aplicativo principal em vários projetos de empacotamento.
   • Se o nome do aplicativo principal parecer incorreto, vá para a próxima etapa e retorne para atualizar o nome.

2. Selecione Avançar.

3. Escolha a plataforma de destino

1. Na tela Escolher plataforma móvel de destino, insira uma ID do Pacote.

   Note

   A ID do Pacote é um identificador exclusivo para seu aplicativo. Deve conter um ponto (.) e não pode ter espaços. Use essa mesma ID de pacote ao criar o Azure Key Vault depois de gerar e carregar seus certificados do iOS ou do Android. Se você já criou o Azure key vault, verifique a ID do pacote na seção Marcas do portal do Azure.

2. Em Plataformas de destino, selecione todas as plataformas móveis que seus usuários finais usam em seus dispositivos móveis.

3. Você precisa ter o Azure Key Vault para carregar sua compilação no armazenamento de blobs do Azure. Se você ainda não criou um, crie um. Crie um cofre de chaves do Azure no assistente Wrap, ou então siga as instruções manualmente.

4. Ative a Assinatura Automática para automatizar o processo de assinatura.

   Note

   Opções de assinatura manual:

   • Assinatura de código para iOS
   • Assinatura de código para Android
   • Assinatura de código para a Google Play Store Você deve assinar manualmente arquivos AAB, independentemente da opção de assinatura selecionada no assistente.

5. Configure a atribuição automática por meio do assistente.

   1. Na etapa de plataforma de destino, ative a Assinatura Automática. O serviço verifica se o cofre de chaves e o certificado já estão anexados.

      Note

      O Azure Key Vault é usado para armazenar e gerenciar com segurança os segredos e certificados do aplicativo, com acesso centralizado e log de auditoria completo.

   2. Se você não tiver o cofre de chaves e o certificado ou quiser alterá-los, selecione Configurar.

      Note

      Somente os administradores do Azure podem criar um cofre de chaves a partir do assistente de encapsulamento. Outros usuários precisam seguir o processo manual de criação do cofre de chaves.

      

   3. No painel lateral, selecione a assinatura e o grupo de recursos e escolha o cofre de chaves. Para criar um novo cofre de chaves, selecione Criar um novo conjunto de chaves. Depois de selecionar o cofre de chaves, selecione Avançar.

      

   4. O serviço verifica se a entidade de serviço apropriada, a função de leitor, as políticas de acesso e as variáveis de ambiente estão configuradas para o cofre de chaves. Se forem exibidos erros, corrija-os. Depois que todas as verificações passarem, selecione Avançar.

   5. Na próxima tela, insira o nome do certificado no cofre de chaves.

   6. Se nenhum certificado existir ou você quiser alterar o certificado, consulte Gerar chave e hash de assinatura para criar um novo certificado. Em seguida, selecione Criar um certificado nesta tela. Esta ação leva você ao local do cofre de chaves no Portal do Azure. Carregue o certificado gerado no cofre de chaves configurado.

      Note

      Os usuários são responsáveis por criar o certificado.

      

   7. Selecione Concluir.

   8. Na tela principal, o Azure Key Vault e o certificado aparecem como confirmados.

   9. Na tela principal, selecione Avançar.

6. Configurar a assinatura automática no portal do Azure.

   1. Consulte as instruções para criar um cofre de chaves do Azure para criar um cofre de chaves do Azure. Depois que o cofre for criado, você precisará adicionar os tags, segredos e certificados necessários. Adicione a variável de ambiente, se ela ainda não tiver sido criada.
   2. Para criar a variável de ambiente, vá para Power Apps>Soluções>Solução padrão. Em seguida, selecione Novo>Mais>Variável do ambiente, adicione o nome de exibição como "PA_Wrap_KV_ResourceID". O nome da nova variável de ambiente deve ter o prefixo "new". Caso contrário, consulte Definir prefixo de variável de ambiente para obter etapas detalhadas.
   3. Para adicionar informações do cofre às variáveis de ambiente, acesse o portal do Azure como administrador. Navegue até Todos os Recursos>Seu Cofre de Chaves>Propriedades e copie a ID do Recurso.
   4. Para adicionar a entrada à variável de ambiente, vá para Power Apps>ApplicationName>Todas>Variável de ambiente. Clique nos três pontos, selecione Editar, adicione o valor copiado ao Valor padrão e salve.
   5. Para verificar se o valor da tabela foi atualizado, vá para Power Apps>Tabelas>Definição da variável de ambiente>new_PA_Wrap_KV_ResourceID. O valor em Valor padrão deve ser igual ao do resourceID para o qual você deseja adicionar o cofre.

      Note

      Diretrizes para adicionar a entrada nas variáveis de ambiente para as informações do Cofre de Chaves:

      • As variáveis de ambiente não devem estar vazias e podem conter várias entradas.
      • Verifique se o resourceID adicionado está correto (verifique a ortografia).
      • Certifique-se de que o resourceID adicionado tenha marcas não vazias e inclua todas as marcas esperadas com o ID do pacote usado no assistente de empacotamento.
   6. Siga as etapas em Etapas para assinatura de código automatizada para criar as marcas, segredos e certificados necessários durante o processo de assinatura automática.

4. Gerenciar saída

Para carregar seu build no armazenamento de blobs do Azure, você precisa de uma conta de armazenamento de blobs do Azure e um contêiner. Se você não tiver um, crie um.

1. Em Gerenciar saída, selecione Configurar para adicionar o cofre de chaves, a conta de armazenamento e as informações do contêiner.
2. No painel lateral Configurar cofre de chaves, selecione o cofre de chaves que armazena as credenciais de acesso ao armazenamento de blobs do Azure e, em seguida, selecione Avançar.
3. Na tela Configurar armazenamento, selecione o nome de armazenamento e o nome do contêiner e insira o nome do segredo que contém acesso ao armazenamento. Para criar um novo segredo, siga as instruções na seção "Como criar um segredo" na mesma tela.
4. Selecione Concluir.

5. Registrar seu aplicativo

Na tela Registrar o aplicativo, registre o aplicativo no Azure para estabelecer confiança com a plataforma de identidade da Microsoft.

• Se você já registrou um aplicativo:

  • Encontre seu registro no campo de registros próprios.

• Se você não vir seu aplicativo registrado:

  1. Selecione Novo registro de aplicativo para criar um novo registro.
  2. Fornecer:
     • Nome do aplicativo: o nome voltado para o cliente de seu aplicativo
     • Hash de assinatura do Android (se direcionado para o Android): uma cadeia de caracteres alfanumérica de 28 caracteres
  3. Salve as alterações.

Configure aplicativos de terceiros permitidos pelo administrador como um administrador de locatário do Azure

O aplicativo registrado deve ser configurado como um aplicativo de terceiros. Para configurar o aplicativo, o administrador de locatários do Azure segue estas etapas.

Depois de concluir essas etapas, a tela de registro ficará assim:

Conceder permissões de API como administrador de locatário do Azure

O aplicativo requer as seguintes permissões de API para funcionar corretamente.

Permissões de API obrigatórias

Configurar permissões a partir do Assistente de Wrap

O assistente de encapsulamento verifica e sinaliza permissões que não estão disponíveis com o aplicativo. Como administrador do Azure, selecione a opção de acesso com um clique no assistente de configuração para conceder as permissões pendentes. Como alternativa, você pode configurar permissões por meio dos comandos do Powershell abaixo.

Configurar permissões por meio de comandos do PowerShell:

Verifique se DeviceManagementManagedApplication está definido como Sim quando você concede consentimento do administrador para seu aplicativo.

Execute estes comandos do PowerShell como um administrador do Azure, se não visualizar permissões em APIs que minha organização usa:

1. Verifique se o módulo Microsoft Graph está disponível ou instale-o:

   Install-Module -Name Microsoft.Graph
   

2. Conceda permissão de Conexões da API do Azure para o AppId estático fe053c5f-3692-4f14-aef2-ee34fc081cae:

   Connect-MgGraph -TenantId <your tenant ID>
   New-MgServicePrincipal -AppId fe053c5f-3692-4f14-aef2-ee34fc081cae -DisplayName "Azure API Connections"
   

3. Conceda permissão do Serviço do PowerApps para o AppId estático 475226c6-020e-4fb2-8a90-7a972cbfc1d4:

   Connect-MgGraph -TenantId <your tenant ID>
   New-MgServicePrincipal -AppId 475226c6-020e-4fb2-8a90-7a972cbfc1d4 -DisplayName "PowerApps Service"
   

Configurar permissões de API manualmente (opcional)

Se você receber erros, configure manualmente as permissões da API. Para obter mais informações, consulte Adicionar e configurar.

Adicionar URIs de redirecionamento como administrador de aplicativo

1. No Portal do Azure, acesse o registro do aplicativo >Autenticação.
2. Selecione Adicionar uma plataforma e escolha iOS ou Android.
3. Para iOS, insira a ID do pacote. Para Android, insira a ID do pacote e a Chave de hash de assinatura.

6. Configurar a identidade visual

1. Na etapa Configurar Identidade Visual, defina as seguintes opções para seu aplicativo:

2. Selecione Avançar.

7. Finalização e compilação

1. Na tela Finalizar, revise os detalhes do aplicativo e selecione Compilar.
2. Após uma compilação bem-sucedida, o pacote do aplicativo estará disponível no Armazenamento de Blobs do Azure que você especificou.

Exibir sua compilação

É possível exibir sua compilação de várias maneiras:

• Depois de compilar, selecione Exibir Compilações
• Vá para Empacotar projetos no painel lateral, passe o mouse sobre o projeto necessário e selecione-o.
• Selecione a opção Exibir compilações no cabeçalho superior

Testar e distribuir seu aplicativo

Teste seu aplicativo e o distribua conforme necessário. Se você encontrar problemas, consulte a página de solução de problemas.

Definir prefixo de variável de ambiente

O nome da nova variável de ambiente deve ter o prefixo "new". Caso contrário, siga estas etapas:

1. Vá para Soluções>Nova solução.
2. Selecione um Publicador ou crie um.
3. Selecione o ícone de edição ao lado do Publicador para exibir ou alterar o prefixo.
4. Se o prefixo não for "novo", altere-o para "novo".
5. Salve as alterações.

Registrar manualmente o aplicativo no portal do Azure (opcional)

Você pode criar seu registro de aplicativo automaticamente no assistente ou manualmente no Azure. Mais informações: Início Rápido: Registrar um aplicativo na plataforma de identidade da Microsoft.

Ao se registrar, selecione um tipo de conta contendo Qualquer diretório do Microsoft Entra - Multilocatário:

• Contas em qualquer diretório organizacional (Qualquer diretório do Microsoft Entra – Multilocatário)
• Contas em qualquer diretório organizacional (qualquer diretório do Microsoft Entra – Multilocatário) e contas Microsoft pessoais, como Skype ou Xbox

Assinar manualmente o pacote do aplicativo móvel (opcional)

Você pode assinar seu aplicativo automaticamente na Etapa 2 ou manualmente após a criação. A assinatura de código é diferente para Android e iOS.

Vantagens da assinatura automática para iOS e Android (APK):

• Você não precisa repetir o processo de assinatura durante o reempacotamento.
• Você não precisa esperar que os desenvolvedores de aplicativos concluam o processo.
• Não é necessário configurar o Android Studio nem lembrar as senhas.
• Você não precisa de um dispositivo Mac para assinatura do iOS.

Consulte também

• Solucionar problemas com o recurso de empacotamento no Power Apps
• Visão geral do Empacotar
• Assinatura de código manual no iOS
• Assinatura manual de código para Android
• Criar seu Azure Key Vault para assinatura de código automatizada
• Perguntas frequentes sobre o wrap