Partilhar via

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. Inicie sessão no 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 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.

    Captura de ecrã que mostra o primeiro passo para selecionar a aplicação.

    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 que os seus utilizadores finais utilizam nos respetivos dispositivos móveis.

  3. Precisa de 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. Para mais informações, consulte Criar um Azure Key Vault. Adicionar as etiquetas, segredos e certificados necessários. Adicione a variável de ambiente se ainda não tiver sido criada.

    a. 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". Captura de ecrã que mostra o ecrã para adicionar a nova variável de ambiente. 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. Captura de ecrã que mostra o ecrã com o prefixo b. 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. Captura de ecrã que mostra o ID do recurso a ser copiado.

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

    d. 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 deseja adicionar o cofre.

    Nota

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

    e. 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. Precisa de ter uma conta de Armazenamento de blobs do Azure e um contentor para carregar a sua compilação para o Armazenamento de blobs do Azure. Se ainda não criou, crie um.

    1. No seu cofre de chaves no portal do Azure, vá aceda a Segredos para criar um segredo para a chave de acesso ao Armazenamento de blobs do Azure. Mais informações: Adicionar um segredo ao cofre de chaves. Captura de ecrã que mostra como criar segredos do Azure

    2. Para ver e copiar a sua chave de acesso: Ver chaves de acesso da contaCaptura de ecrã que mostra a chave de acesso

    3. Introduza a chave de acesso de armazenamento de blobs do Azure no campo Valor do segredo. Captura de ecrã que mostra segredos do Azure

    4. No seu cofre de chaves, aceda a Etiquetas e crie uma nova etiqueta com o mesmo valor do segredo que acima. Captura de ecrã que mostra etiquetas do Azure

  5. ATIVE a assinatura automática da aplicação (Opcional). Captura de ecrã que mostra o segundo passo para escolher a plataforma de destino.

    Nota

    Opções de assinatura manual:

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

  6. Selecione Seguinte.

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 "nova", edite-o para definir o prefixo como "nova".
  5. Guarde as alterações.

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 Captura de ecrã que mostra o ecrã de registo da nova aplicação

    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). Captura de ecrã que mostra o ecrã de registo 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:

Captura de ecrã que mostra o ecrã de registo com marcas de verificação verdes para os passos concluídos

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. Captura de ecrã que mostra as permissões da API para a aplicação.

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.

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

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 ID do Grupo. Para Android, introduza o ID do Grupo e a Chave de hash de assinatura. Captura de ecrã que mostra URIs de redirecionamento para a aplicação.

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

Captura de ecrã que mostra o quinto passo sobre como gerir a saída usando o armazenamento de blobs 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

Captura de ecrã que mostra como ver compilações.

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

Registo de aplicações - tipos de conta suportados para encapsulamento.

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

  • Last updated on