Assistente de encapsulamento: o guia passo a passo para criar a sua aplicação móvel nativa

Use este guia para converter uma ou mais aplicações Canvas em um único pacote de aplicações com marca personalizada que pode disponibilizar na Google Play e na App Store da iOS.

A funcionalidade de encapsulamento no Power Apps permite criar versões móveis nativas dos seus apps canvas como aplicações móveis Android e iOS com marca personalizada (pacotes IPA, APK, AAB). Pode distribuir estas aplicações móveis nativas encapsuladas para os utilizadores finais através do Google Play, Apple Business Manager ou outros métodos de distribuição nativos.

Quando atualiza e volta a publicar a sua aplicação, a aplicação encapsulada é automaticamente atualizada para os utilizadores.

Passos para criar uma aplicação nativa de marca personalizada usando o assistente de encapsulamento

Siga estes passos para configurar, compilar, assinar e distribuir um pacote de aplicação móvel nativa personalizada (APK, AAB ou IPA) a partir das suas aplicações canvas usando o assistente de empacotamento no Power Apps.

1. Inicie sessão e comece um projeto de encapsulamento

1. Inicie sessão no portal Power Apps maker.
2. Selecione Encapsular no painel de navegação esquerdo. Se o item não estiver no painel lateral, selecione ...Mais e, em seguida, selecione o item pretendido.
3. Selecione a aplicação que pretende encapsular e, em seguida, selecione Encapsular na barra de comando.

2. Selecione aplicações

1. No ecrã Selecionar as aplicações a encapsular, selecione a aplicação primária e secundária.

   • Aplicação primária: a aplicação principal que os utilizadores finais veem quando a aplicação móvel é iniciada.
   • Aplicações secundárias: outras aplicações opcionais agrupadas no mesmo pacote de aplicação móvel.

   Observação

   • Pode utilizar a mesma aplicação primária em vários projetos de encapsulamento.
   • Se o nome da aplicação primária parecer incorreto, prossiga para o passo seguinte e regresse para atualizar o nome.

2. Selecione Seguinte.

3. Escolha a plataformas de destino

1. No ecrã Escolher a plataforma móvel a visar, introduza um ID de Conjunto.

   Observação

   O ID de Bundle é um identificador exclusivo para a sua aplicação. Tem de conter um ponto (.) e nenhum espaço. Utilize este mesmo ID do grupo quando criar o cofre de chaves do Azure depois de gerar e carregar os seus certificados iOS ou Android. Se já criou o Cofre de Chaves do Azure, verifique o ID do grupo na secção Etiquetas do portal do Azure.

2. Em Plataformas de destino, selecione todas as plataformas móveis que os seus utilizadores finais utilizam nos respetivos dispositivos móveis.

3. É necessário ter um Azure Key Vault para carregar a sua compilação para o armazenamento de blobs do Azure. Se ainda não criou, crie um. Crie um cofre de chaves do Azure diretamente dentro do assistente do Wrap, ou siga as instruções manualmente.

4. Ativa a opção de autoassinatura para automatizar o processo de assinatura.

   Observação

   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 Tens de assinar manualmente ficheiros AAB, independentemente da opção de assinatura selecionada no assistente.

5. Configura a assinatura automática através do feiticeiro.

   1. No passo da plataforma alvo, ativa a assinatura automática. O serviço verifica se o cofre de chaves e o certificado já estão ligados.

      Observação

      O Azure Key Vault é utilizado para armazenar e gerir de forma segura segredos e certificados de aplicação, com acesso centralizado e registo completo de auditoria.

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

      Observação

      Só os administradores do Azure podem criar um cofre de chaves a partir do assistente de wrap. Outros utilizadores precisam de seguir o processo manual de criação do cofre de chaves.

      

   3. No painel lateral, selecione a subscrição e o grupo de recursos, e escolha o cofre de chaves. Para criar um novo cofre de chaves, selecione Criar um novo cofre de chaves. Depois de selecionares o cofre das chaves, seleciona Seguinte.

      

   4. O serviço verifica se o principal do serviço, o papel do leitor, as políticas de acesso e as variáveis de ambiente apropriadas estão configurados para o cofre de chaves. Se surgirem erros, corrige-os. Depois de todas as verificações passarem, selecione Próximo.

   5. No ecrã seguinte, insira o nome do certificado no cofre de chaves.

   6. Se não existir certificado ou quiser alterar o certificado, consulte Gerar hash de chave e assinatura para criar um novo certificado. Depois seleciona Criar um certificado neste ecrã. Esta ação leva-o ao local do cofre de chaves do portal Azure. Carregue o certificado gerado para o cofre de chaves configurado.

      Observação

      Os utilizadores são responsáveis por criar o certificado.

      

   7. Selecione Acabar.

   8. No ecrã principal, o Azure Key Vault e o certificado aparecem conforme confirmado.

   9. No ecrã principal, selecione Próximo.

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

   1. Consulte as instruções de criar um cofre de chaves Azure para criar um cofre de chaves Azure. Uma vez criado o cofre, precisa de adicionar as etiquetas, segredos e certificados necessários. Adicione a variável de ambiente se ainda não tiver sido criada.
   2. Para criar a variável de ambiente, aceda a Power Apps>Soluções>Solução predefinida. Em seguida, selecione Nova>Mais>Variável de ambiente, adicione o nome a apresentar como "PA_Wrap_KV_ResourceID". O nome da nova variável de ambiente tem de ter o prefixo "nova". Caso contrário, consulte Definir Prefixo da Variável de Ambiente para obter os passos detalhadas.
   3. Para adicionar informações do cofre às suas variáveis de ambiente, aceda ao portal do Azure como administrador. Navegue até Todos os Recursos>o seu cofre de chaves>Propriedades e, em seguida, copie o ID do Recurso.
   4. Para adicionar a entrada à variável de ambiente, aceda a Power Apps>ApplicationName>Todas>Variável de ambiente. Clique nos três pontos, selecione Editar, adicione o valor copiado para o Valor predefinido e guarde.
   5. Para verificar se o valor da tabela foi atualizado, aceda a Power Apps>Tabelas>Definição da variável de ambiente>new_PA_Wrap_KV_ResourceID. O valor em Valor predefinido tem de ser igual ao do ID do recurso para o qual você quer adicionar o cofre.

      Observação

      Diretrizes para adicionar a entrada por detrás das variáveis de ambiente para as informações do Cofre de chaves.

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

4. Gerir a saída

Para carregar a tua build para o armazenamento de blobs do Azure, precisas de uma conta e um contentor de armazenamento de blobs Azure. Se você não tiver um, crie um.

1. Na opção Gerir saída, selecione Configurar para adicionar a informação do seu cofre de chaves, conta de armazenamento e contentor.
2. No painel lateral Configurar Keyvault, selecione o cofre de chaves que armazena as credenciais de acesso ao seu armazenamento de blob Azure e depois selecione Seguinte.
3. No ecrã Configurar armazenamento , selecione o nome do armazenamento e o nome do contentor, e depois introduza o nome do segredo que contém acesso ao armazenamento. Para criar um novo segredo, siga as instruções na secção "Como criar um segredo" no mesmo ecrã.
4. Selecione Acabar.

5. Registe a sua aplicação

No ecrã Registar a sua aplicação, registe a sua aplicação no Azure para estabelecer confiança com a plataforma de identidade da Microsoft.

• Se já registou uma aplicação:

  • Encontre o seu registo no campo de registo de propriedade.

• Se não vir a sua aplicação registada:

  1. Selecione Novo registo de aplicação para criar um novo registo.
  2. Fornecer:
     • Nome da aplicação: o nome da sua aplicação voltado para o cliente
     • Hash de assinatura Android (se estiver a direcionar para Android): uma cadeia alfanumérica de 28 carateres
  3. Guarde as alterações.

Configurar aplicações de terceiros permitidas pelo administrador como administrador de inquilinos do Azure

A aplicação registada deve ser configurada como uma aplicação de terceiros. Para configurar a aplicação, o administrador do tenant Azure segue estes passos.

Depois de concluir estes passos, o ecrã de registo terá esta aparência:

Conceder permissões de API como administrador de inquilinos do Azure

A aplicação requer as seguintes permissões da API para funcionar corretamente.

Permissões de API necessárias

Configurar permissões a partir do assistente Wrap

O assistente de configuração verifica e marca permissões que não estão disponíveis com a aplicação. Como administrador do Azure, selecione a opção de acesso com um clique no assistente de configuração para conceder as permissões pendentes. Alternativamente, pode configurar permissões através dos comandos Powershell abaixo.

Configurar permissões através de comandos Powershell:

Certifique-se de que DeviceManagementManagedApplication está definido como Sim quando conceder consentimento de administrador à sua aplicação.

Execute os seguintes comandos do PowerShell como administrador do Azure se não vir as permissões em APIs que a minha organização utiliza.

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

   Install-Module -Name Microsoft.Graph
   

2. Conceda permissão de Ligações de 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 ao 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 obtiver erros, configure manualmente as permissões da API. Para obter mais informações, consulte Adicionar e configurar.

Adicionar URIs de Redirecionamento como administrador de aplicações

1. No Portal do Azure, aceda ao registo da sua aplicação >Autenticação.
2. Selecione Adicionar uma plataforma e escolha iOS ou Android.
3. Para iOS, introduza o Bundle ID. Para Android, introduza tanto o ID do Pacote como a Chave de hash de assinatura.

6. Configurar a marca

1. No passo Configurar Imagem Corporativa, defina as seguintes opções para a sua aplicação:

2. Selecione Seguinte.

7. Conclua e compile

1. No ecrã Conclusão, reveja os detalhes da aplicação e selecione Compilar.
2. Depois de uma compilação bem-sucedida, o seu pacote de aplicações estará disponível no armazenamento de blobs do Azure que especificou.

Ver a sua compilação

Pode ver o seu build de várias formas.

• Após a compilação, selecione Ver Compilações
• Aceda a Encapsular projetos no painel lateral, paire o cursor sobre o projeto necessário e selecione-o.
• Selecione a opção Ver compilações no cabeçalho superior

Teste e distribua a sua aplicação

Teste a aplicação e distribua-a conforme necessário. Se encontrar problemas, consulte a página de resolução de problemas.

Definir o prefixo da variável de ambiente

O nome da nova variável de ambiente tem de ter o prefixo "nova". Caso contrário, siga estes passos:

1. Aceda a Solução>Nova solução.
2. Selecione um Editor ou crie um.
3. Selecione o ícone de edição junto do Editor para ver ou alterar o prefixo.
4. Se o prefixo não for "new", muda-o para "new".
5. Guarde as alterações.

Registar a sua aplicação no portal do Azure manualmente (opcional)

Pode criar o registo da sua aplicação automaticamente no assistente ou manualmente no Azure. Para mais informações: Início Rápido: Registar uma aplicação com a plataforma de identidade da Microsoft

Ao registar-se, selecione um tipo de conta que contenha Qualquer diretório Microsoft Entra - Multicliente:

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

Assinar o pacote da aplicação móvel manualmente (opcional)

Pode assinar automaticamente a sua aplicação no Passo 2 ou manualmente após a compilação. A assinatura de código é diferente para dispositivos Android e iOS.

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

• Não precisa de repetir o processo de assinatura durante o reencapsulamento.
• Não precisa de esperar para que os programadores da aplicação concluam o processo.
• Não precisa de configurar o Android Studio nem de se lembrar de palavras-passe.
• Não precisa de um dispositivo Mac para assinatura iOS.

Ver também

• Resolver problemas com a funcionalidade de encapsulamento no Power Apps
• Visão geral do envolvimento
• Assinar por código manual para iOS
• Assinatura manual de código para Android
• Criar o seu Azure Key Vault para assinatura de código automatizada
• Perguntas mais frequentes sobre embalagem