Utilizar o assistente de encapsulamento para criar a sua aplicação móvel

Utilize a funcionalidade de encapsulamento para criar um pacote de uma ou mais aplicações de tela num único pacote nativo de uma aplicação móvel utilizando o assistente passo a passo.

A funcionalidade de encapsulamento no Power Apps permite-lhe criar versões móveis nativas dasaplicações de tela como aplicações móveis personalizadas de marca para Android e iOS. Pode distribuir essas aplicações móveis nativas encapsuladas para os utilizadores finais através do Microsoft Intune, App Center da Microsoft, Google Play ou Apple Business Manager ou outros métodos de distribuição nativas.

A funcionalidade de encapsulamento permite-lhe criar aplicações móveis para iOS Android ou Google Play Store:

• iOS (pacote IPA)
• Android (pacote APK)
• Google Play Store (pacote AAB)

A funcionalidade de encapsulamento encapsula as suas aplicações de tela numa shell de aplicação móvel nativa que pode assinar e distribuir digitalmente. Quando atualiza a aplicação e a publica novamente, a aplicação é automaticamente atualizada.

Pré-requisitos

Precisa de acesso ao:

• Portal do Azure para registar a sua aplicação.
• App center para adicionar uma nova organização e aplicações.
• Esta funcionalidade requer que as aplicações façam parte de uma solução gerida ou não gerida. Se as suas aplicações ainda não fizerem parte de uma solução, adicione-as a uma solução nova ou existente. Mais informações: Criar uma aplicação de tela a partir de uma solução. 

Se estiver a criar um pacote da aplicação móvel para a plataforma Android e planeia fazer a assinatura de código manualmente, assegure-se de que gera chaves e, em seguida, gera hash de assinatura assinatura antes de começar. Precisa do hash de assinatura gerado para configurar o URL de redirecionamento.

Adicionar a aplicação de tela à solução

Encapsular para Power Apps necessita que as aplicações fazem parte de uma solução. Se as suas aplicações de tela ainda não fizerem parte de uma solução, adicione-as a uma solução nova ou existente. No painel de navegação esquerdo, selecione Soluções. Se o item não estiver no painel lateral, selecione ...Mais e, em seguida, selecione o item pretendido. Selecione uma solução e, em seguida, selecione Editar.

Escolha a opção + Adicionar existente no menu superior e seleccione Aplicação > Aplicação de tela na lista pendente.

Selecione o separador Fora do Dataverse e escolha a aplicação na lista. Prima o botão Adicionar para adicionar esta aplicação a uma solução.

Para mais informações: Adicionar uma aplicação à solução

Criar aplicações móveis nativas para iOS e Android utilizando o assistente

1. Inicie sessão no Power Apps.

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.

Passo 1: Selecionar aplicações

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

   • Aplicação primária: selecione a aplicação que os seus utilizadores finais vêem quando a aplicação móvel é lançada.

   • Aplicações secundárias: outras aplicações opcionais que pode agrupar na mesma compilação para empacotar a aplicação móvel juntamente com a aplicação Primária.

     

     Nota

     Pode utilizar a mesma aplicação Primária em vários projetos de encapsulamento.

2. Selecione Seguinte.

Passo 2: Plataforma de destino

1. No ecrã Escolher plataforma móvel de destino, insira um ID do Grupo à escolha.

   Nota

   O ID do Grupo é um identificador exclusivo que cria para a sua aplicação. Um ID do grupo tem de conter um ponto (.) e nenhum espaço.

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

3. Defina o comutador Assinar a minha aplicação como LIGADO para assinar de código automaticamente a sua aplicação móvel e, em seguida, selecione o ULT do Azure Key Vault na lista e clique em Seguinte. Se não tiver entradas na lista do URL Azure Key Vault, tem primeiro de criar o Azure Key Vault. Mais informações: Criar Azure Key Vault para encapsulamento para o Power Apps.

   

Também pode assinar de código o seu pacote da aplicação móvel manualmente em vez de utilizar a assinatura de código automática disponível no assistente de encapsulamento. Para mais informações sobre como assinar de código a aplicação, consulte:

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

4. Selecione Seguinte.

Passo 3: Configurar imagem corporativa

1. No Passo Configuração de Imagem de marca, defina as seguintes opções de aparência para a aplicação:

   Nota

   Todas as imagens têm de estar no formato .png. Será utilizada uma imagem predefinida se não forem selecionadas imagens personalizadas.

   • Ícones de aplicações: Carregue ícones para utilizar na sua aplicação. Tamanho recomendado para iOS: imagem .png de 1024px por 1024px ou maior. Tamanho de imagem recomendado para Android: imagem .png de 432px por 432px ou maior.
   • Imagem de ecrã inicial: imagem que é utilizada no ecrã inicial da sua aplicação móvel, enquanto a mesma carrega. Imagem predefinida usada quando não tiver sido indicada uma.
   • Imagem do ecrã de boas-vindas: imagem que é utilizada no ecrã de boas-vindas (início de sessão) da sua aplicação móvel, enquanto a mesma carrega. Imagem predefinida usada quando não tiver sido indicada uma.
   • Cor de preenchimento de fundo: Código de cores hexadecimal usado para o fundo do ecrã de boas-vindas.
   • Cor de preenchimento dos botões: Código de cores hexadecimal usado para preencher a cor dos botões.
   • Tema de texto da barra de estado: Cor do texto da barra de estado no topo da aplicação.

2. Selecione Seguinte.

Passo 4: Registar a aplicação

No ecrã Registar a aplicação, registe a aplicação no Azure para estabelecer uma relação de confiança entre a aplicação e a plataforma de identidade da Microsoft. A aplicação tem de estar regisda no Microsoft Entra para que os utilizadores da aplicação possam iniciar sessão.

Registo de nova aplicação

Selecione Novo registo na aplicação para criar automaticamente um novo registo na aplicação.

Também pode criar um novo registo de aplicação manualmente. Mais informações: Registar a aplicação manualmente no portal do Azure.

O assistente de encapsulamento configura automaticamente todas as permissões de API necessárias para a aplicação. Também pode configurar as permissões da API manualmente se for necessário resolver problemas neste passo. Mais informações: Configure manualmente as permissões da API para a sua aplicação.

Passo 5: Gerir saída

No ecrã Gerir saída, crie ou selecione uma localização do App Center existente para onde enviar a aplicação móvel depois de concluída a compilação. Para criar automaticamente uma nova localização no assistente de encapsulamento, selecione Nova localização na parte superior do ecrã e, em seguida, selecione Android ou iOS.

• Android: Escolher uma localização existente ou criar uma nova localização.

• iOS: Escolher uma localização existente ou criar uma nova localização.

Também pode optar por criar a sua localização do App Center manualmente no App Center. Mais informações: Criar manualmente uma localização do App Center para a sua aplicação móvel.

Passo 6: Concluir

No ecrã Concluir consulte os detalhes da aplicação e, em seguida, selecione Criar. Depois de uma complicação bem sucedida, irá ver a sua aplicação móvel na localização do App Center que selecionou no passo anterior.

Testar e distribuir o pacote da aplicação móvel

Para testes e distribuição, consulte Teste do App Center e Distribuição.

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

Pode criar automaticamente o seu registo na aplicação no assistente de encapsulamento, conforme mencionado no passo 4. Também pode criar manualmente um novo registo para a aplicação no portal do 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.

Quer seja um criador de inquilino individual ou multi-inquilino, deve selecionar qualquer uma das opções que contêm Qualquer diretório do Microsoft Entra - Multi-inquilino quando escolhe o tipo de conta suportada para a sua aplicação para o ativar para encapsulamento. Escolha um dos seguintes tipos de conta:

• 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 sobre os tipos de conta: Tipos de conta na plataforma de identidade da Microsoft.
• Tem de criar um URI de redirecionamento separado para cada plataforma (iOS, Android) de destino.

Configure manualmente as permissões da API para a sua aplicação (opcional)

Quando concluir o passo 4, o assistente de encapsulamento irá configurar automaticamente todas as permissões de API necessárias para a aplicação.

Se obter erros no assistente de encapsulamento, poderá configurar manualmente as permissões da API. Mais informações: Adicionar e configurar

São necessárias as seguintes permissões da API quando configurar manualmente as permissões da API:

• APIs da Microsoft
  • Dynamics CRM
• APIs que a minha organização utiliza
  • Ligações da API do Azure
  • Serviço PowerApps
  • Power BI (só é necessário se as suas aplicações de tela utilizarem dados do Power BI)
  • Gestão de Aplicações Móveis da Microsoft (só é necessário se quiser utilizar o Microsoft Intune para a distribuição de aplicações móveis)

Nota

Se não encontrar as permissões sob APIs que a minha organização utiliza, execute os seguintes comandos PowerShell, conforme adequado e tente novamente:

• Verifique se o módulo Microsoft Graph está disponível ou instale-o usando o seguinte comando:

  Install-Module -Name Microsoft.Graph
  

• Permissão Ligações de API do Azure em falta:

  Connect-MgGraph -TenantId <your tenant ID>
  New-MgServicePrincipal -AppId fe053c5f-3692-4f14-aef2-ee34fc081cae -DisplayName "Azure API Connections"
  

• Permissão Serviço PowerApps em falta:

  Connect-MgGraph -TenantId <your tenant ID>
  New-MgServicePrincipal -AppId 475226c6-020e-4fb2-8a90-7a972cbfc1d4 -DisplayName "PowerApps Service"
  

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

Criar manualmente uma localização do App Center para a sua aplicação móvel (opcional)

Tem a opção de criar automaticamente uma nova localização do App Center para armazenar as suas aplicações móveis conforme mencionado no passo 5 no assistente de encapsulamento, mas também pode criar manualmente a nova localização diretamente no App Center. Para mais informações: Localização do App Center

Dica

Para mais informações sobre o App Center, aceda a Documentação do App Center do Visual Studio.

1. Aceda a App Center.

2. Inicie sessão com a sua conta profissional ou escolar.

3. Se não nenhuma organização existente, selecione Adicionar nova > Adicionar nova organização para criar uma nova organização.

4. Selecione a organização a partir da lista no painel à esquerda.

5. Selecione Aplicações > Adicionar aplicação.

6. Introduza o nome da aplicação.

7. Selecione o tipo de versão da aplicação.

8. Selecione Personalizar SO para aplicações iOS ou Android SO para aplicações Android.

   Nota

   Deve criar contentores do App Center separados para cada plataforma.

9. Para o SO Android, selecione a Plataforma como Nativa React.

   Nota

   A Plataforma deve ser Nativa React para todas as aplicações no App Center.

   

10. Selecione Adicionar nova aplicação.

11. Copie o URL do App Center da aplicação. Vai precisar dele mais tarde, para configurar o projeto de encapsulamento do Power Apps.

    Por exemplo, https://appcenter.ms/orgs/Contoso-sales/apps/Sample-canvas-app-for-Android-OS/

    

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

Pode assinar automaticamente o pacote da aplicação móvel durante o processo de encapsulamento no Passo 2, mas também o pode fazer manualmente após o pacote da aplicação móvel ser construído. O processo de Assinatura de código é diferente para dispositivos Android e iOS.

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

Consulte também

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