Assistente de encapsulamento: 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 plataforma móvel a visar, introduza um ID de Grupo.

   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 de grupo ao 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. Configure a assinatura automática através do assistente.

   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 associados.

      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 de serviço, a função de leitor, as políticas de acesso e as variáveis de ambiente apropriados 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 para a localização do cofre de chaves do portal do 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, tem de adicionar as etiquetas, os segredos e os certificados obrigató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 para 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 resourceID para o qual pretende adicionar o cofre.

      Observação

      Diretrizes para adicionar a entrada subjacente às variáveis de ambiente para as informações do Key Vault:

      • 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 de grupo utilizado no assistente de encapsulamento.
   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

Configura onde os binários da tua aplicação (ficheiros APK e IPA) serão armazenados. Escolha uma das seguintes opções com base nas suas necessidades de armazenamento e acesso.

Dataverse (Recomendado)

O armazenamento Dataverse é a opção mais simples e é recomendado para testes e avaliação de implementações.

Quando seleciona Dataverse, os binários de compilação são automaticamente armazenados na msdyn_PowerAppsWrapBuild tabela do seu ambiente atual. As compilações contam para a sua capacidade de armazenamento do Dataverse.

Armazenamento de Blobs do Azure

Armazenamento de Blobs do Azure requer configuração.

Pré-requisitos

Antes de configurar o Armazenamento de Blobs do Azure, certifique-se de que tem:

• Uma conta e contentor do Armazenamento de Blobs do Azure. Se não os tiveres, aprende a criar uma conta de armazenamento.

• Um Azure Key Vault que contém as credenciais de acesso para a sua conta de armazenamento. Se não tiveres um, aprende a criar um cofre de chaves.

• Permissões suficientes para ler segredos do cofre de chaves.

Configurar o Armazenamento de Blobs do Azure

Para configurar o armazenamento de blobs do Azure, siga estes passos:

1. Na página de Gestão de saída , selecione Configurar.
2. No painel lateral Configure keyvault, selecione o cofre de chaves que armazena as suas credenciais de armazenamento de Azure blobs e depois selecione Próximo.
3. Introduza os detalhes seguintes:
   • Nome da conta de armazenamento: O nome da sua conta Armazenamento de Blobs do Azure.
   • Nome do contentor: O contentor onde os artefactos de construção serão carregados.
4. Selecione Guardar.

Depois de gravar, a configuração é aplicada às versões seguintes. Para verificar, executa uma compilação e confirma que o ficheiro APK ou IPA aparece no contentor especificado.

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 o destino for Android): uma cadeia alfanumérica de 28 carateres
  3. Guarde as alterações.

Configurar aplicações de terceiros permitidas pelo administrador como administrador de inquilino 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 de encapsulamento

O assistente de encapsulamento verifica e sinaliza 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 encapsulamento 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 o ID de Grupo e 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 - Multi-inquilino)
• 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