Perguntas mais frequentes sobre encapsulamento

Yes. Tanto clientes de inquilino único como clientes multi-inquilino podem utilizar o encapsulamento. Ao registar a sua aplicação manualmente no Azure, certifique-se de que seleciona o tipo de conta correto. Consulte o Registo de aplicação para instruções.

N.º A função de encapsulamento no Power Apps não suporta as Chaves Geridas pelo Cliente (CMK) ou o Lockbox. O encapsulamento utiliza pipelines de compilação do Azure DevOps e os ativos do cliente podem ficar expostos aos operadores de serviços da Microsoft durante o processo de compilação.

Yes. Consulte Criar aplicações móveis com o Power Apps.

N.º A Microsoft encapsula a sua aplicação numa shell nativa de aplicação móvel para que a assine e distribua digitalmente.

Pode assinar automaticamente o seu pacote de aplicação móvel no Passo 2 do assistente de encapsulamento se tiver configurado o Azure Key Vault. Para assinatura manual, consulte Android, iOS e Google Play Store.

N.º A assinatura da aplicação móvel com Xcode não é suportada no encapsulamento. Para assinar digitalmente o seu pacote de aplicações móveis compilado para iOS, consulte Assinatura de código para iOS.

Pode usar o Microsoft Intune, Google Play ou Apple Business Manager.

O assistente de encapsulamento configura automaticamente a aplicação para distribuição com o Microsoft Intune. Para resolver problemas, pode conceder manualmente permissões da API a todas as aplicações de canvas que pretende encapsular na Gestão de Aplicações Móveis do Microsoft. Mais informações: Configure manualmente as permissões da API para a sua aplicação.

A Power Apps Mobile é atualizada periodicamente. Para garantir a compatibilidade e beneficiar de correções de erros e novas caraterísticas, recomendamos que volte a encapsular e a distribuir a sua aplicação móvel, pelo menos, numa base mensal.

N.º As alterações publicadas às aplicações de tela incluídas são automaticamente transferidas pelas versões existentes da sua aplicação móvel. No entanto, recomendamos que reencapsule e redistribua a sua aplicação móvel numa base mensal para beneficiar das correções de erros da plataforma, atualizações e novas caraterísticas.

Atualize ícones e cores reempacotando as suas aplicações com novos recursos gráficos e redistribua o pacote atualizado da aplicação móvel.

Adicione ou remova aplicações de tela ao voltar a encapsular o seu pacote da aplicação móvel com o conjunto pretendido de aplicações e redistribuindo o pacote móvel.

A aplicação Primária proporciona a experiência principal para a sua aplicação móvel. As aplicações secundárias são agrupadas por motivos de desempenho e devem ser associadas à sua aplicação primária. Consulte Encapsular várias aplicações de tela em conjunto.

Incluir as aplicações Secundárias no grupo proporciona melhor desempenho de inicialização ao abri-las pela primeira vez. No entanto, é opcional. Se tiver muitas aplicações Secundárias, pode escolher não as agrupar para reduzir o tamanho total da aplicação.

Yes. O assistente de encapsulamento configura automaticamente a sua aplicação móvel para poder utilizar o Power BI. Para resolver problemas, pode conceder manualmente permissão de API ao Power BI a todas as aplicações que utilizam dados do Power BI. Mais informações: Configure manualmente as permissões da API para a sua aplicação.

Yes. Pode utilizar o esquema ms-mobile-apps:///providers/Microsoft.PowerApps/apps/<appID>?tenantId=<tenantId> para criar uma ligação avançada para as suas aplicações móveis encapsuladas. Consulte Utilizar ligações avançadas com aplicações móveis encapsuladas para obter mais informações.

A sua organização pode ter uma política de acesso condicional Requer Aplicação de Cliente Aprovada que restringe o acesso a aplicações móveis. Para corrigir este problema, consulte Editar a sua política de acesso condicional.

N.º O Power Apps é uma plataforma para aplicações empresariais e utiliza autenticação do Microsoft Entra. A funcionalidade de encapsulamento encapsula as aplicações de tela existentes para o mesmo conjunto de utilizadores finais.

Não, não precisa de uma licença premium para o encapsulamento. No entanto, se o seu APK usa certos conectores, terá de pagar de acordo com os requisitos desses conectores.

Não, os projetos de encapsulamento não podem ser eliminados, mas pode eliminar os ficheiros APK do projeto da sua localização de armazenamento.

Os utilizadores fora do inquilino base não podem aceder a projetos de encapsulamento, a menos que o administrador do Azure e o criador partilhem explicitamente a aplicação com o utilizador. A aplicação garante a separação adequada dos dados entre organizações ao incorporar o identificador do inquilino no token de autenticação.

A Aplicação de Encapsulamento suporta vários inquilinos. Para ativar esta caraterística, o administrador do Azure tem de:

1. Adicione utilizadores externos ao inquilino principal como convidados no Azure.
2. Inclua estes convidados no processo de Acesso Condicional do Azure.
3. O criador tem de partilhar a aplicação com estes IDs de convidado no Power Apps.

1. Verifique se o utilizador tem acesso à aplicação PowerApps. Mais informações: Partilhar uma aplicação canvas com a sua organização
2. Se o acesso for confirmado, verifique as políticas condicionais do Azure para a app. O acesso de administrador é necessário para rever estas políticas. Mais informações: Ver detalhes do Acesso Condicional aplicado aos registos de atividades do Microsoft Entra
3. Para resolver erros de início de sessão, copie o ID de correlação do ecrã móvel onde o início de sessão está a falhar e consulte Como resolver erros de início de sessão do Microsoft Entra para compreender o erro e as políticas com falha.
4. Verifique os códigos de erro de autenticação e autorização do Microsoft Entra.
5. Um código de erro comum é 50194 (etiqueta- 9n555). Durante a fase de registo da aplicação, o tipo de conta suportado não está configurado para vários inquilinos. Configure-o para suportar vários inquilinos.

• Se for um cliente existente que já criou e distribuiu com êxito uma aplicação encapsulada, não terá de passar pelo processo de encapsulamento novamente. Para garantir que os utilizadores recebam as alterações publicadas mais recentes, siga os passos mencionados em Power Apps para Criadores: Obter versões da aplicação.
• Para novos clientes, recomendamos o novo encapsulamento se tiver concluído todas as etapas de registo mencionadas em Usar o assistente de encapsulamento para criar a sua aplicação móvel: Registe a aplicação e tenha concluído manual ou automaticamente o processo de início de sessão mencionado em Utilizar o assistente de encapsulamento para criar a sua aplicação móvel: assine o pacote da aplicação móvel manualmente.
• Para garantir que as alterações na plataforma beneficiem os utilizadores finais, recomendamos voltar a encapsular mensalmente e distribuir a aplicação atualizada para os utilizadores.

• Aceda ao portal de funções e administração do Microsoft Entra Mais informações: Centro de Administração do Microsoft Entra
• Pesquise administração global na barra de pesquisa.
• Selecione o separador Atribuições ativas.
• Reveja a lista de proprietários das atribuições ativas.

O Azure Key Vault armazena com segurança a chave de acesso necessária para o armazenamento de blobs do Azure.

Yes. Consulte Preços do Key Vault.

Contacte o seu administrador de inquilinos do Azure para criar um cofre de chaves para si ou peça permissão.

1. Adicione utilizadores externos ao inquilino principal como convidados no Azure. Consulte Início Rápido: Adicionar um utilizador convidado e enviar um convite.
2. Inclua estes convidados no processo de Acesso Condicional do Azure. Partilhar a aplicação com estes IDs de convidado nos Power Apps. Consulte Partilhar uma aplicação canvas com a sua organização.
3. Substitua o ID da aplicação e a conta de utilizador na seguinte ligação: ms-mobile-apps:///providers/Microsoft.PowerApps/apps/<appID>?tenantId=<tenantID>
4. Partilhar a ligação com o seu cliente.
5. Instale o APK no Android e o IPA no iOS.
6. Abra a ligação Web e insira os IDs externos para iniciar sessão.

Quando configuras Power Apps Wrap para usar armazenamento Dataverse, os teus binários de build (ficheiros APK, AAB e IPA) são armazenados como anexos de ficheiros na tabela msdyn_powerappswrapbuild do teu ambiente. Podes aceder aos anexos de três formas, dependendo do teu cenário.

1. Utilizar a página Ver compilações (recomendado):

   A forma mais simples de descarregar uma build é diretamente da interface do Power Apps Wrap:

   1. Abra o seu projeto de encapsulamento e selecione Ver compilações.
   2. Localize a compilação pretendida na lista.
   3. Selecione Download ao lado da build.

2. Consultar compilações com a API Web do Dataverse

   Para automatização, pipelines CI/CD ou portais personalizados, pode consultar a tabela msdyn_powerappswrapbuild através de OData no ponto final da API Web do seu ambiente: https://{your-environment}.crm.dynamics.com/api/data/v9.2/. O utilizador que efetua a chamada ou o utilizador da aplicação deve ter privilégios de Leitura na msdyn_powerappswrapbuild tabela.

• Recupere todas as builds, as mais recentes primeiro: GET /msdyn_powerappswrapbuilds?$select=msdyn_powerappswrapbuildid,name,msdyn_buildid,msdyn_platformtype,msdyn_apptype,createdon&$orderby=createdon desc
• Obter compilações de uma aplicação móvel específica: GET /msdyn_powerappswrapbuilds?$filter=_msdyn_mobileappid_value eq{mobileAppId}&$orderby=createdon desc
• Filtrar por tipo de artefacto (APK, AAB ou IPA): GET /msdyn_powerappswrapbuilds?$filter=msdyn_apptype eq 'APK'
• Filtrar por ID de build: GET /msdyn_powerappswrapbuilds?$filter=msdyn_buildid eq '{buildId}'
• Obter uma única compilação por chave alternativa: GET /msdyn_powerappswrapbuilds(msdyn_buildid='{buildId}', msdyn_mobileappid={mobileAppId})

3. Descarregar artefactos programaticamente usando uma URL SAS

   Os ficheiros binários reais não são devolvidos nos resultados das consultas OData — são armazenados como dados de colunas de ficheiro. Para descarregar um binário programaticamente, chame a mensagem padrão Dataverse GetFileSasUrl para gerar um URL de download com limite de tempo e depois obtenha o ficheiro a partir desse URL.

   Coisas importantes a saber:

     - The SAS URL is valid for one hour from the time it's generated. 
   
     - The URL provides anonymous access — anyone with the URL can download the file during the valid window, so generate URLs on demand rather than storing them. 
   
     - The user or application user calling GetFileSasUrl must have Read access to the wrap build record. 
   
     - GetFileSasUrl isn't supported in environments using self-managed database encryption keys (BYOK). If your environment uses BYOK, migrate to customer-managed keys (CMK) first.              
   

   Pedido de API Web:

   POST [Organization URI]/api/data/v9.2/GetFileSasUrl            
     Content-Type: application/json 
     Accept: application/json  
   {
     "Target": 
       { 
         "@odata.type": "Microsoft.Dynamics.CRM.msdyn_powerappswrapbuild",             
         "msdyn_powerappswrapbuildid": "{recordId}"        
       }, 
     "FileAttributeName": "msdyn_artifact" 
     } 
   

   Resposta:

   { 
   
     "FileName": "build-2026-05-17.apk", 
   
     "FileSizeInBytes": 24576000, 
   
     "MimeType": "application/vnd.android.package-archive", 
   
     "SasUrl": "https://{storageaccount}.blob.core.windows.net/{container}/{blob}?sv=..." 
   
   } 
   

   SDK para exemplo de .NET:

   using Microsoft.Xrm.Sdk; 
   
   using Microsoft.Crm.Sdk.Messages; 
   
   
   
   var request = new GetFileSasUrlRequest 
   
     { 
   
       Target = new EntityReference("msdyn_powerappswrapbuild", recordId), 
   
       FileAttributeName = "msdyn_artifact" 
   
     }; 
   
   
   
   var response = (GetFileSasUrlResponse)orgService.Execute(request); 
   
   var sasUrl = response.Result.SasUrl; 
   
   var fileName = response.Result.FileName; 
   

Resolver problemas com a funcionalidade de encapsulamento no Power Apps