Compartilhar via

Usar o assistente de encapsulamento para criar o aplicativo móvel

  • Artigo

Use o recurso de encapsulamento para empacotar um ou mais aplicativos de tela como um único pacote de aplicativo móvel nativo usando o assistente passo a passo.

O recurso Empacotar no Power Apps permite criar versões móveis nativas dos aplicativos de tela como aplicativos móveis Android e iOS de marca personalizada. Você pode distribuir esses aplicativos móveis nativos empacotados para os usuários finais por meio do Microsoft app center, Google Play ou Apple Business Manager ou outros métodos de distribuição nativos.

O recurso Empacotar permite criar aplicativos móveis para iOS, Android ou Google Play Store:

  • iOS (pacote IPA)
  • Android (pacote APK)
  • Para distribuição do Google Play Store (pacote AAB)

O recurso empacota os aplicativos de tela em um shell de aplicativo móvel nativo que é possível assinar e distribuir digitalmente. Quando você atualiza o aplicativo e o republica, o aplicativo é atualizado automaticamente.

Criar aplicativos móveis nativos para iOS e Android usando o assistente

  1. Entre no Power Apps.

  2. Selecione Empacotar, no painel de navegação esquerdo. Se o item não estiver no painel lateral, selecione …Mais e selecione o item desejado.

  3. Selecione o aplicativo que você deseja empacotar e Empacotar na barra de comandos.

Etapa 1: selecionar aplicativos

  1. Na tela Selecione o(s) aplicativo(s) a ser(em) empacotado(s), selecione os aplicativos principal e secundário.

    • Aplicativo principal: selecione o aplicativo que os usuários finais vão ver quando o aplicativo móvel for iniciado.

    • Aplicativo(s) secundário(s): outros aplicativos opcionais que é possível colocar na mesma compilação do aplicativo móvel com o aplicativo principal.

      Escolha os aplicativos que você deseja empacotar.

      Observação

      • Você pode usar o mesmo aplicativo principal em vários projetos de encapsulamento.
      • No assistente de empacotamento, se o nome do aplicativo principal aparecer incorreto, avance à próxima etapa e retorne para ver o nome correto.

  2. Selecione Avançar.

Etapa 2: registrar o aplicativo

Na tela Registrar o aplicativo, registre manualmente o aplicativo no Azure para estabelecer um relacionamento de confiança entre o aplicativo e a plataforma de identidade Microsoft. Mais informações: Registro manual do aplicativo no portal do Azure.

O aplicativo deve estar registrado no Microsoft Entra para que os usuários possam entrar. Se você já tiver se registrado, encontre o registro no campo de registro próprio.

Crie um novo registro de aplicativo.

Se você não vir o nome do aplicativo registrado na lista suspensa Registros de propriedade, siga estas etapas.

  • Selecione Novo registro de aplicativo a fim de criar automaticamente um novo registro para o aplicativo.

  • Você vai precisar fornecer o Nome do aplicativo e o hash da assinatura Android, pois eles são campos obrigatórios. O nome do aplicativo é obrigatório por ser o nome voltado para o cliente do aplicativo. O hash da assinatura do Android será necessário se você tiver selecionado Android como uma de suas plataformas ao criar e compilar o projeto de empacotamento.

    Observação

    O formato da chave de hash Android é um número de hash alfanumérico de 28 dígitos, como –ga0RGNYHvNM5d0SLGQfpQWAPGJ8=. Se a chave de hash de assinatura já existir, não será necessário criar uma nova. Você pode reutilizar a chave de hash de assinatura gerada anteriormente ao criar um novo registro de aplicativo.

    Adicione detalhes de registro do aplicativo.

Configurar aplicativos de terceiros permitidos pelo administrador

O assistente de encapsulamento configura automaticamente todas as permissões de API necessárias para o aplicativo. Você também pode configurar manualmente as permissões de API se precisar solucionar problemas nessa etapa. Mais informações: Configurar manualmente as permissões de API para o aplicativo.

Quando você registra o aplicativo, o administrador do Azure precisa fornecer acesso para continuar. Siga estas etapas para conceder o 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.
  • Importe o módulo usando: Import-Module -Name Microsoft.PowerApps.Administration.PowerShell.
  • Execute Add-AdminAllowedThirdPartyApps e forneça a ID do aplicativo para a qual o acesso de administrador é necessário.
  • Execute Get-AdminAllowedThirdPartyApps para verificar se o nome do aplicativo aparece na lista.

Depois de concluir as etapas anteriores, a tela de registro se parece com a captura de tela a seguir.

Captura de tela que mostra a tela de registro com ticks verdes para as etapas concluídas

Permissões da API

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

Captura de tela que mostra as permissões de API para o aplicativo.

Observação

Nesta etapa, às vezes, para os novos clientes, somente o campo Nome do aplicativo permanece visível. O campo para adicionar o hash da assinatura Android não é exibido. Para resolver isso, avance às próximas etapas e selecione a(s) plataforma(s) de destino como Android na Etapa das Plataformas de Destino.

Etapa 3: configurar identidade visual

  1. Na etapa Configurar Identidade Visual, defina as seguintes opções de aparência para o aplicativo:

    Observação

    Todas as imagens devem estar em formato .png. Uma imagem padrão será usada caso nenhuma imagem personalizada seja selecionada.

    • Ícones de Aplicativo: carregue ícones a serem usados para o aplicativo. Tamanho recomendado para iOS: imagem .png de 1024 px por 1024 px ou maior. Tamanho recomendado da imagem para Android: imagem .png de 432 px por 432 px ou maior.
    • Imagem da tela inicial: imagem que será usada na tela inicial do aplicativo móvel enquanto ele for carregado. Imagem padrão usada quando não fornecida.
    • Imagem da tela de boas-vindas: imagem que será usada na tela de boas-vindas (logon) do aplicativo móvel enquanto ele for carregado. Imagem padrão usada quando não fornecida.
    • Cor de preenchimento do plano de fundo: código de cor hexadecimal usado no plano de fundo da tela de boas-vindas.
    • Cor de preenchimento do botão: código de cor hexadecimal usado para preencher a cor do botão.
    • Tema do texto da barra de status: cor do texto da barra de status na parte superior do aplicativo.

  2. Selecione Avançar.

Etapa 4: plataforma de destino

  1. Na tela Escolher plataforma móvel de destino, insira um ID do Pacote de nossa escolha.

    Observação

    O ID do Pacote é um identificador exclusivo criado para o aplicativo. Um ID do pacote deve conter um ponto (.) e nenhum espaço.

  2. Em Plataforma(s) de destino, selecione todas as plataformas móveis que os usuários finais utilizam nos dispositivos móveis.

  3. Defina a opção Assinar meu aplicativo como ON para assinar automaticamente o código do aplicativo móvel, selecione o URI do Azure Key Vault na lista e Avançar. Se não tiver nenhuma entrada na lista URI do Azure Key Vault, você precisará criar Azure Key Vault primeiro. Mais informações: Criar o Azure Key Vault para encapsular no Power Apps.

    Escolha os aplicativos que você deseja empacotar.

Também é possível assinar manualmente o pacote do aplicativo móvel, em vez de usar a assinatura de código automática disponível no assistente de encapsulamento. Para obter mais informações sobre como codificar manualmente a assinatura do aplicativo, consulte:

Observação

O assistente de Empacotamento fornece um processo de entrada automático. No entanto, os desenvolvedores familiarizados com processos móveis podem fazer login manualmente para seus aplicativos Android ou iOS usando mecanismos diferentes para cada plataforma. Se você fizer login por meio do processo manual, não precisará criar um cofre de chaves Azure.

  1. Selecione Avançar.

Etapa 5: armazenamento de Blobs do Azure

  1. Crie um cofre de chaves Azure, se ainda não o tiver feito. Mais informações: Criar Azure Key Vault para empacotamento usando assinatura padrão
  2. Crie uma conta de armazenamento de blob Azure e um nome de contêiner. Mais informações: Criar uma conta de armazenamento do Azure
  3. Adicione o URI do cofre de chaves Azure clicando na lista suspensa.
  4. Adicione o nome da conta de armazenamento de blob Azure e o nome do contêiner criado durante a etapa de criação da conta de armazenamento de blob Azure.
  5. Baixe o APK/IPA compilado do local de armazenamento de blob Azure criado acima após a conclusão das etapas de compilação.

Etapa 6: empacotar

Na tela Empacotar, revise os detalhes do aplicativo e selecione Compilar. Após uma compilação bem-sucedida, você verá seu aplicativo móvel no local de armazenamento de blobs do Azure que você selecionou na etapa anterior.

Testar e distribuir o pacote de aplicativos móveis

Testar e distribuir seu aplicativo. Se você enfrentar qualquer problema durante o teste, verifique a página de solução de problemas.

Registrar manualmente o aplicativo no portal do Azure (opcional)

É possível criar automaticamente o registro do aplicativo no assistente de encapsulamento, conforme mencionado na etapa 4. Ou é possível criar manualmente um novo registro para o aplicativo no portal do Azure. Mais informações: Início Rápido: Registrar um aplicativo na plataforma de identidade da Microsoft.

Observação

Os clientes de locatário único e multilocatário podem usar o encapsulamento para criar aplicativos móveis nativos com base em seus aplicativos de tela do Power Apps.

Se for um criador único ou multilocatário, você deverá selecionar qualquer uma das opções que contenham Algum diretório do Microsoft Entra – Multilocatário ao escolher o tipo de conta compatível com o aplicativo a fim de habilitá-lo para o encapsulamento. Escolha um dos seguintes tipos de conta:

  • Contas em qualquer diretório organizacional (qualquer diretório do Microsoft Entra – Multilocatário)
  • Contas em qualquer diretório organizacional (qualquer diretório do Microsoft Entra – vários locatários) e contas Microsoft pessoais, como Skype ou Xbox.

Registro do aplicativo – tipos de conta com suporte ao encapsulamento.

Importante

  • Atualmente, o recurso Empacotar é compatível apenas com os tipos de conta Multilocatário. O tipo de conta Locatário único ainda não é compatível. Mais informações sobre os tipos de conta: Tipos de conta na plataforma de identidade da Microsoft.
  • Você deve criar um URI de Redirecionamento à parte para cada plataforma (iOS, Android) que deseja segmentar.

Configurar manualmente as permissões de API para o aplicativo (opcional)

Ao concluir a etapa 4, o assistente de encapsulamento vai configurar automaticamente todas as permissões de API necessárias para o aplicativo.

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

As seguintes permissões de API são necessárias durante a configuração manual das permissões de API:

  • APIs da Microsoft
    • Dynamics CRM
  • APIs que minha organização usa
    • Conexões de API do Azure
    • Serviço do PowerApps
    • Power BI (necessário somente se seus aplicativos de tela usarem dados do Power BI)
    • Gerenciamento de Aplicativos Móveis da Microsoft (necessário somente se você quiser usar o Microsoft Intune para distribuição de aplicativos móveis)

Observação

Se você não encontrar as permissões em APIs que minha organização usa, execute os seguintes comandos do PowerShell conforme apropriado 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 Conexões de API do Azure ausente:
    Connect-MgGraph -TenantId <your tenant ID>
New-MgServicePrincipal -AppId fe053c5f-3692-4f14-aef2-ee34fc081cae -DisplayName "Azure API Connections"
  • Permissão Serviço do PowerApps ausente:
    Connect-MgGraph -TenantId <your tenant ID>
New-MgServicePrincipal -AppId 475226c6-020e-4fb2-8a90-7a972cbfc1d4 -DisplayName "PowerApps Service"

Para etapas detalhadas, consulte Solicitar as permissões no portal de registro do aplicativo.

Criar manualmente um local do App Center para o aplicativo móvel (opcional)

Você pode criar manualmente um local do centro de aplicativos para seu aplicativo móvel diretamente no centro de aplicativos. Mais informações: Local do App Center

Dica

Para obter mais informações sobre o App Center, vá até Documentação do App Center do Visual Studio.

  1. Vá até App Center.

  2. Entre com sua conta corporativa ou de estudante.

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

  4. Selecione a organização na lista no painel esquerdo.

  5. Selecione Aplicativos>Adicionar aplicativo.

  6. Insira o nome do aplicativo.

  7. Selecione o tipo de versão do aplicativo.

  8. Selecione SO Personalizado para aplicativos iOS ou SO Android para aplicativos Android.

    Observação

    Você deve criar contêineres à parte do App Center para cada plataforma.

  9. Para SO Android, selecione Plataforma como React Native.

    Observação

    A Plataforma deve ser React Native para todos os aplicativos no App Center.

    Configuração de aplicativos do App Center.

  10. Selecione Adicionar novo aplicativo.

  11. Copie a URL do App Center. Você precisará dela posteriormente para configurar o projeto de encapsulamento no Power Apps.

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

    URL do App Center.

Assinar manualmente o pacote do aplicativo móvel (opcional)

É possível assinar automaticamente o pacote do aplicativo móvel durante o processo de encapsulamento na Etapa 2, mas também fazer isso manualmente após a compilação do pacote do aplicativo móvel. O processo de assinatura de código é diferente para dispositivos Android e iOS.

Consultar também