Partilhar via

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

  • Artigo

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 estas aplicações móveis nativas encapsuladas para os utilizadores finais através do App Center da Microsoft, Google Play ou Apple Business Manager ou outros métodos de distribuição nativos.

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

  • iOS (pacote IPA)
  • Android (pacote APK)
  • Para a distribuição através da 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.

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

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

      Escolha as aplicações que pretende encapsular.

      Nota

      • Pode utilizar a mesma aplicação Primária em vários projetos de encapsulamento.
      • No assistente de encapsulamento, se o nome da Aplicação primária parecer incorreto, prossiga para o passo seguinte e regresse para ver o nome correto.

  2. Selecione Seguinte.

Passo 2: Registar a aplicação

No ecrã Registar a sua aplicação, registe a sua aplicação manualmente no Azure para estabelecer uma relação de confiança entre a sua aplicação e a plataforma de identidade da Microsoft. Mais informações: Registar a aplicação manualmente no portal do Azure.

A aplicação tem de estar regisda no Microsoft Entra para que os utilizadores da aplicação possam iniciar sessão. Se já se registou, encontre o seu registo no campo de registo próprio.

Criar um novo registo de aplicações.

Se não vir o nome da aplicação registada na lista pendente Registos próprios, siga estes passos.

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

  • Precisará de fornecer o Nome da aplicação e o hash da assinatura do Android, pois são campos obrigatórios. O Nome da aplicação é obrigatório porque é o nome da aplicação voltado para o cliente. O hash da assinatura do Android é necessário se selecionou o Android como uma das suas plataformas, quando criou e compilou o seu projeto de encapsulamento.

    Nota

    O formato da chave de hash do Android é um número de hash alfanumérico de 28 dígitos, como –ga0RGNYHvNM5d0SLGQfpQWAPGJ8=. Se a chave de hash da assinatura já existir, não há necessidade de criar uma nova. Pode reutilizar a chave de hash da assinatura gerada anteriormente ao criar um novo registo de aplicação.

    Adicionar detalhes do registo da aplicação.

Configurar aplicações de terceiros permitidas pelo administrador

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.

Quando regista a aplicação, o administrador do Azure precisa de fornecer acesso para continuar. Siga estes passos para conceder acesso:

  • Abra o Windows PowerShell e execute-o como administrador.
  • Execute o comando- Install-Module -Name Microsoft.PowerApps.Administration.PowerShell -AllowClobber -Force.
  • Defina a política de execução com: Set-ExecutionPolicy -ExecutionPolicy RemoteSigned.
  • Importar o módulo com: Import-Module -Name Microsoft.PowerApps.Administration.PowerShell.
  • Execute Add-AdminAllowedThirdPartyApps e forneça o ID da Aplicação para o qual o acesso de administrador é necessário.
  • Execute Get-AdminAllowedThirdPartyApps para verificar se o nome da aplicação aparece na lista.

Depois de concluir os passos anteriores, o ecrã de registo parece-se com a captura de ecrã a seguir.

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

Permissões de API

Quando regista a aplicação, o administrador do Azure também precisa de conceder acesso às permissões da API para a aplicação. Consulte a captura de ecrã a seguir para obter instruções sobre como conceder acesso e os motivos pelos quais as permissões da API são necessárias.

Captura de ecrã que mostra as permissões da API para a aplicação.

Nota

Por vezes, neste passo, para os novos clientes, apenas o campo Nome da aplicação está visível. O campo a adicionar à assinatura hash do Android não é apresentado. Para resolver isto, continue para os passos seguintes e selecione as Plataformas de destino como Android no Passo de Plataformas de Destino.

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 1024 px por 1024 px ou maior. Tamanho de imagem recomendado para Android: imagem .png de 432 px por 432 px 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: 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 botão Assinar a minha aplicação como ATIVADO para assinar automaticamente o código da sua aplicação móvel e, em seguida, selecione o URI do Azure Key Vault na lista e selecione 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.

    Escolha as aplicações que pretende encapsular.

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:

Nota

O assistente de Encapsular fornece um processo de início de sessão automático. No entanto, os programadores familiarizados com processos móveis podem iniciar sessão manualmente nas respetivas aplicações Android ou iOS usando mecanismos diferentes para cada plataforma. Se iniciar sessão através do processo manual, não precisa de criar um Azure Key Vault.

  1. Selecione Seguinte.

Passo 5: Armazenamento de blobs do Azure

  1. Crie um Azure Key Vault, caso ainda não o tenha feito. Mais informações: Criar o Azure Key Vault para encapsulamento utilizando a subscrição predefinida
  2. Crie uma conta de armazenamento de blobs do Azure e um nome de contentor. Mais informações: Criar uma conta de armazenamento do Azure
  3. Adicione o URI do Azure Key Vault ao clicar na lista pendente.
  4. Adicione a conta de armazenamento de blobs do Azure e o nome do contentor criados durante o passo de criação de conta de armazenamento de blobs do Azure.
  5. Transfira a APK/IPA criada a partir da localização de armazenamento de blobs do Azure criado acima após a conclusão dos passos de compilação.

Passo 6: Concluir

No ecrã Concluir consulte os detalhes da aplicação e, em seguida, selecione Criar. Após uma compilação bem-sucedida, verá a sua aplicação móvel na localização de armazenamento de blobs do Azure selecionado no passo anterior.

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

Teste e distribua a sua aplicação. Se enfrentar algum problema durante o teste, verifique a página de resolução de problemas.

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.

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

Pode criar manualmente uma localização do centro de aplicações para a sua aplicação móvel diretamente no App Center. Para mais informações: Localização do App Center

Sugestão

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

    Configuração de aplicação 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/

    URL do App Center.

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.

Veja também