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 de tela num único pacote de aplicações personalizado que pode implementar na Google Play e na iOS App Store.

A caraterística de encapsulamento no Power Apps permite-lhe criar versões móveis nativas das suas aplicações de tela como aplicações móveis Android e iOS de 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

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

1. Aceda ao Power Apps Maker Portal.
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 sua aplicação primária (a aplicação primária que os utilizadores veem no início) e quaisquer aplicações secundárias opcionais a agrupar.

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

   

   Nota

   • 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 do Grupo.

   Nota

   O ID do Grupo é 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 de que os seus utilizadores precisam.

3. Selecione o URI do Azure Key Vault na lista.
   Se não vir nenhuma entrada, crie um cofre de chaves do Azure.

4. Crie uma conta de armazenamento de blobs do Azure e um contentor se ainda não o fez:

   • Mais informações: Criar uma conta de armazenamento do Azure
   • Tutorial em vídeo: Como criar uma conta de armazenamento

5. No seu cofre de chaves no portal do Azure:

   a. Aceda a Segredos para criar um segredo para a sua chave de acesso do armazenamento de blobs do Azure.

   • Mais informações: Adicionar um segredo ao Key Vault
   • Para ver e copiar a sua chave de acesso: Ver chaves de acesso da conta

   b. Introduza a chave de acesso de armazenamento de blobs do Azure no campo Valor do segredo.

   

6. No seu cofre de chaves, aceda a Etiquetas e crie uma nova etiqueta com o mesmo valor do segredo que acima.

   

7. Defina o comutador Assinar a minha aplicação como Ativado ou Desativado:

   • Se Ativado: siga os passos em Passos para assinatura de código automatizada
   • Se Desativado: precisará de realizar a assinatura manual mais tarde

   

   Nota

   Opções de assinatura manual:

   • Assinar código iOS
   • Assinar código Android
   • Assinatura de código para a Google Play Store

   Tem de assinar manualmente os ficheiros AAB, independentemente da opção de assinatura selecionada no assistente.

8. Selecione Seguinte.

4. 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. Forneça:

     • Nome da aplicação: o nome da sua aplicação voltado para o cliente
     • Hash de assinatura do Android (se visar o Android): uma cadeia alfanumérica de 28 carateres

  3. No centro de administração do Microsoft Entra, aceda a Registos de aplicações e selecione a sua aplicação. Na secção Essentials, localize Tipos de conta suportados, defina-o como Contas em qualquer diretório organizacional (Qualquer diretório do Microsoft Entra — Multi-inquilino).

  4. Guardar as suas alterações.

     Nota

     Se a chave de hash de assinatura já existir, poderá reutilizá-la.

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

O assistente de encapsulamento configura automaticamente as permissões de API necessárias. Para conceder acesso de administrador:

1. Abra o Windows PowerShell como administrador.
2. Execute estes comandos:

   Install-Module -Name Microsoft.PowerApps.Administration.PowerShell -AllowClobber -Force
   Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
   Import-Module -Name Microsoft.PowerApps.Administration.PowerShell
   Add-AdminAllowedThirdPartyApps
   Get-AdminAllowedThirdPartyApps
   

3. Forneça o ID de Aplicação quando pedido.

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

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

O administrador do Azure concede permissões de API durante o registo. Certifique-se de que DeviceManagementManagedApplication está definido como Sim quando conceder consentimento de administrador à sua aplicação. Para mais informações, consulte Conceder consentimento do administrador em todo o inquilino no painel de aplicações Enterprise.

Execute estes comandos do PowerShell como um administrador do Azure. Se não vir as permissões sob 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. Conceder 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. Conceder permissão de 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"
   

Nota

Se apenas o campo Nome da aplicação estiver visível, continue para os passos seguintes e selecione Android como uma plataforma de destino para apresentar o campo de hash de assinatura.

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.

Permissões de API necessárias

Tipo de API	API específica	Razão
APIs da Microsoft	Dynamics CRM	A aplicação precisa que user_impersonation chame o Dataverse para o utilizador.
APIs que a minha organização utiliza	Ligações da API do Azure	A aplicação precisa que Runtime.All chame qualquer conector do Power Platform.
APIs que a minha organização utiliza	Serviço do PowerApps	A aplicação precisa da permissão User para contactar os serviços de back-end do Power Apps do Power Platform.
APIs que a minha organização utiliza	Power BI	A aplicação precisa de permissões do Power BI para aceder ou incorporar o conteúdo do Power BI.
APIs que a minha organização utiliza	Gestão de Aplicações Móveis da Microsoft	A aplicação precisa desta permissão porque o Power Apps usa o SDK do Intune internamente.

Para passos detalhados, consulte Pedir as permissões no portal de registo da aplicação.

Adicionar URIs de Redirecionamento como administrador de aplicações

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

5. Configure a imagem corporativa

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

Nota

Todas as imagens têm de estar no formato .png. As imagens predefinidas serão usadas se nenhuma imagem personalizada for selecionada.

Definição	Description	Requisitos
Ícones de aplicações	Ícones para a sua aplicação	iOS: 1024x1024 px ou maior Android: 432x432 px ou maior
Imagem do ecrã inicial	Imagem mostrada enquanto a aplicação é carregada	Formato .png
Imagem do ecrã de boas-vindas	Imagem mostrada no ecrã de início de sessão	Formato .png
Cor de preenchimento de fundo	Cor de fundo do ecrã de boas-vindas	Código de cor hexadecimal
Cor de preenchimento dos botões	Cor para botões	Código de cor hexadecimal
Tema de texto da barra de estado	Cor do texto da barra de estado	Claro ou Escuro

2. Selecione Seguinte.

6. Efetue a gestão da saída

1. Introduza o nome da conta de armazenamento de blobs do Azure e nome do contentor.
2. Após a conclusão da compilação, transfirar o seu APK ou IPA a partir da localização do armazenamento de blobs do Azure.

7. Encapsule e compile

1. No ecrã Encapsular, 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 a sua compilação 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

Nota

Para assinar manualmente uma aplicação iOS com código, deszipe o ficheiro IPA usando um dispositivo Mac.

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.

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

Nota

Tanto o inquilino individual como os clientes multi-inquilino podem utilizar o encapsulamento para criar aplicações móveis nativas com base nas suas aplicações de tela do Power Apps.

Ao registar-se, selecione um tipo de conta que contenha Qualquer diretório do Microsoft Entra — Multi-inquilino:

• 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 – Multi-inquilino) e contas pessoais da Microsoft, como Skype ou Xbox

Importante

• Atualmente, o encapsulamento só suporta tipos de conta Multi-inquilino. O tipo de conta único inquilino ainda não é suportado. Mais informações: Tipos de conta na plataforma de identidade da Microsoft.
• Tem de criar um URI de Redirecionamento separado para cada plataforma (iOS, Android).

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 a repetição do encapsulamento.
• 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.

Plataforma	Método de Assinatura
iOS	Assinar por código manual para iOS
Android	Assinar por código manual para Android
Google Play Store	Assinatura de código para o Google Play Store

Veja também

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