Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
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
- Aceda ao Power Apps Maker Portal.
- 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.
- Selecione a aplicação que pretende encapsular e, em seguida, selecione Encapsular na barra de comando.
2. Selecione aplicações
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.
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.
Selecione Seguinte.
3. Escolha a plataformas de destino
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.
Em Plataformas de destino, selecione todas as plataformas móveis de que os seus utilizadores precisam.
Selecione o URI do Azure Key Vault na lista.
Se não vir nenhuma entrada, crie um cofre de chaves do Azure.Crie uma conta de armazenamento de blobs do Azure e um contentor se ainda não o fez:
- Mais informações: Criar uma conta de armazenamento do Azure
- Tutorial em vídeo: Como criar uma conta de armazenamento
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.
- Mais informações: Adicionar um segredo ao Key Vault
- Para ver e copiar a sua chave de acesso: Ver chaves de acesso da conta
b. Introduza a chave de acesso de armazenamento de blobs do Azure no campo Valor do segredo.
- Mais informações: Adicionar um segredo ao Key Vault
No seu cofre de chaves, aceda a Etiquetas e crie uma nova etiqueta com o mesmo valor do segredo que acima.
Defina o comutador Assinar a minha aplicação como Ativado ou Desativado:
- Se Ativado: siga os passos em Passos para assinatura de código automatizada
- Se Desativado: precisará de realizar a assinatura manual mais tarde
Nota
Opções de assinatura manual:
Tem de assinar manualmente os ficheiros AAB, independentemente da opção de assinatura selecionada no assistente.
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:
Selecione Novo registo de aplicação para criar um novo registo.
Forneça:
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).
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:
- Abra o Windows PowerShell como administrador.
- 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
- Forneça o ID de Aplicação quando pedido.
Depois de concluir estes passos, o ecrã de registo terá esta aparência:
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.
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
Verifique se o módulo Microsoft Graph está disponível ou instale-o:
Install-Module -Name Microsoft.Graph
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"
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
- No Portal do Azure, aceda ao seu registo de aplicação >Autenticação.
- Selecione Adicionar uma plataforma e escolha iOS ou Android.
- Para iOS, introduza o ID do Grupo.
Para Android, introduza o ID do Grupo e a Chave de hash de assinatura.
5. Configure a imagem corporativa
- 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 |
- Selecione Seguinte.
6. Efetue a gestão da saída
- Introduza o nome da conta de armazenamento de blobs do Azure e nome do contentor.
- 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.
7. Encapsule e compile
- No ecrã Encapsular, reveja os detalhes da aplicação e selecione Compilar.
- 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
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
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 |