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

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

  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.

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

    Captura de ecrã que mostra segredos do Azure

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

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

    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.

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

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