Solucionar problemas com o recurso de encapsulamento no Power Apps

Este artigo ajuda você a resolver os problemas mais comuns com o recurso de encapsulamento no Microsoft Power Apps.

Problema 1 - A compilação de encapsulamento está falhando

Se a compilação de encapsulamento falhar, você poderá executar as etapas a seguir para resolver o problema.

Etapa 1: verifique se suas imagens estão no formato PNG

Certifique-se de que as imagens que você usa no wrap estejam no formato PNG. O uso de imagens em qualquer formato diferente de PNG em wrap fará com que a compilação falhe. Use um conversor de imagens para salvar suas imagens como arquivos .png ou certifique-se de que seus arquivos de imagem originais estejam no formato PNG.

Importante

Alterar manualmente a extensão do arquivo de imagem de .jpeg ou qualquer outro formato para .png não reformata automaticamente a imagem para o formato PNG.

Etapa 2: Verificar se o App Center está configurado corretamente

Seu link do App Center deve ser criado como um aplicativo dentro de uma organização e não como um aplicativo autônomo. A captura de tela a seguir mostra como criar uma nova organização no assistente de encapsulamento.

Para obter mais informações sobre como criar automaticamente um novo local no assistente de encapsulamento, consulte Etapa 5: gerenciar a saída na seção "Criar aplicativos móveis nativos para iOS e Android usando o assistente".

Etapa 3: Verificar se a configuração do cofre de chaves está correta

Verifique se uma entidade de serviço do Azure foi criada e se a função de entidade de serviço foi adicionada corretamente. Para obter mais informações, consulte as etapas 1 e 2 em Criar aplicativos móveis nativos para iOS e Android usando o assistente.

Verifique se o cofre de chaves contém todos os certificados, segredos e marcas necessários para iOS, Android ou ambos:

• iOS: duas tags, um certificado e um segredo
• Android: uma tag e um certificado

Para obter mais informações, consulte Criar o cofre de chaves do Azure para encapsulamento no Power Apps.

Etapa 4: tente novamente se você tiver todas as configurações adequadas

Se o build de encapsulamento ainda falhar depois de verificar se o projeto de encapsulamento tem todas as configurações adequadas, consulte a seção Outros problemas no encapsulamento deste artigo.

Problema 2 - O botão Encapsular está desabilitado para meu aplicativo

Você só pode encapsular aplicativos com permissões de edição. Verifique se você tem permissões de edição para o aplicativo que deseja encapsular e tente novamente.

Problema 3 - Não é possível salvar meu projeto ou disparar uma compilação de encapsulamento

Para resolver esse problema, é possível:

• Atualize para a versão mais recente da solução de encapsulamento e tente novamente.
• Certifique-se de que nenhum erro de validação da interface do usuário bloqueie o envio Salvar ou Compilar.

Problema 4 - Não é possível instalar um aplicativo móvel encapsulado em um dispositivo

Verifique se você assinou o aplicativo de saída. Você pode assiná-lo configurando um cofre de chaves e fornecendo-o no momento do gatilho de build ou assinando manualmente. Para obter mais informações sobre assinatura de código, consulte:

• Configurar o cofre de chaves para assinatura automatizada
• Assinatura de código para iOS
• Assinatura de código para Android

Verifique se o seu dispositivo móvel atende a esses requisitos mínimos.

Problema 5 - Não é possível entrar em um aplicativo móvel encapsulado ou não é possível ver os dados

Se você não conseguir entrar no seu aplicativo móvel encapsulado, verifique se:

• Seu aplicativo Microsoft Entra está configurado corretamente.

• Todas as permissões de API para o aplicativo foram adicionadas corretamente. Para obter mais informações sobre como ver e configurar permissões de API para o aplicativo, consulte a captura de tela a seguir e Configurar permissões de API.

  

• O Add-AdminAllowedThirdPartyApps script foi executado com êxito. Para obter mais informações, consulte Permitir aplicativos registrados em seu ambiente.

• O tipo de aplicativo do Microsoft Entra é Multilocatário. Na guia Autenticação do aplicativo Microsoft Entra, o tipo de conta com suporte deve ser Contas em qualquer diretório organizacional (Qualquer diretório do Microsoft Entra – Multilocatário).

• Os URIs de redirecionamento adequados foram criados para iOS e Android. Para Android, confirme se o hash foi fornecido corretamente. Para obter mais informações sobre como configurar um URI de redirecionamento, consulte Definir configurações de plataforma.

Problema 6 – Erros no cofre de chaves do Azure encapsulado para o Power Apps

Os seguintes erros do cofre de chaves do Azure podem aparecer em wrap para o Power Apps e podem ser corrigidos.

Código de erro 1000118

Código do erro	Descrição
1000118	Assinatura padrão não encontrada ou permissões de acesso ausentes

Observação

Os módulos Azure AD e MSOnline PowerShell estão preteridos desde 30 de março de 2024. Para saber mais, leia a atualização de preterição. Após essa data, o suporte a esses módulos se limitará à assistência à migração para o SDK do Microsoft Graph PowerShell e às correções de segurança. Os módulos preteridos continuarão funcionando até 30 de março de 2025.

Recomendamos migrar para o Microsoft Graph PowerShell para interagir com o Microsoft Entra ID (antigo Azure AD). Para perguntas comuns sobre migração, consulte as Perguntas Frequentes sobre Migração. Observação: as versões 1.0.x do MSOnline poderão sofrer interrupções após 30 de junho de 2024.

1. Verifique se o cofre de chaves do Azure está na assinatura padrão do locatário.

2. Execute estes comandos no PowerShell como administrador:

   Connect-AzureAD -TenantId <your tenant ID>
   

   New-AzureADServicePrincipal -AppId 4e1f8dc5-5a42-45ce-a096-700fa485ba20 -DisplayName "Wrap KeyVault Access App"
   

3. No portal do Azure, acesse sua assinatura padrão. Na página Controle de Acesso (IAM), adicione uma atribuição de função de Leitor à Entidade de Serviço que representa seu aplicativo, por exemplo, Encapsular Aplicativo de Acesso do KeyVault. Verifique se ele está no IAM da Assinatura e no IAM do Keyvault. Aqui estão as etapas para fazer isso:

   1. Vá para a guia Controle de acesso (IAM) e selecione a opção Adicionar atribuição de função no botão de menu Adicionar .

      

   2. Selecione a guia Funções de função de trabalho e verifique se a função Leitor está selecionada. Em seguida, selecione a guia Membros no menu superior.

      

   3. Pesquise Encapsular aplicativo de acesso ao KeyVault na guia Membros.

      

   4. Selecione Encapsular aplicativo de acesso ao KeyVault e, em seguida, selecione o botão Revisar + atribuir na parte inferior da guia para atribuir a ele a função Leitor .

      

Código de erro 1000119

Código do erro	Descrição
1000119	O Keyvault não existe ou o Keyvault não tem privilégios de acesso

1. Verifique se o cofre de chaves do Azure está na assinatura padrão do locatário.

2. Verifique se a opção de política de acesso ao cofre está selecionada ao criar o cofre de chaves.

   

3. Execute estes comandos no PowerShell como administrador:

    Connect-AzureAD -TenantId <your tenant ID>
   

   New-AzureADServicePrincipal -AppId 4e1f8dc5-5a42-45ce-a096-700fa485ba20 -DisplayName "Wrap KeyVault Access App"
   

4. No portal do Azure, acesse sua assinatura padrão. Na página Controle de Acesso (IAM), adicione uma atribuição de função de Leitor à Entidade de Serviço que representa seu aplicativo, por exemplo, Encapsular Aplicativo de Acesso do KeyVault. Verifique se ele está no IAM da Assinatura e no IAM do Keyvault. Aqui estão as etapas para fazer isso:

   1. Vá para a guia Controle de acesso (IAM) e selecione a opção Adicionar atribuição de função no botão de menu Adicionar .

      

   2. Selecione a guia Funções de função de trabalho e verifique se a função Leitor está selecionada. Em seguida, selecione a guia Membros no menu superior.

      

   3. Pesquise Encapsular aplicativo de acesso ao KeyVault na guia Membros.

      

   4. Selecione Encapsular aplicativo de acesso ao KeyVault e, em seguida, selecione o botão Revisar + atribuir na parte inferior da guia para atribuir a ele a função Leitor .

      

5. Adicione políticas de acesso ao cofre de chaves do Azure.

   

   

Código de erro 1000120

Código do erro	Descrição
1000120	Nenhuma marca de ID da organização encontrada no cofre de chaves

1. Vá para o centro de administração do Power Platform, selecione Ambientes e, em seguida, selecione o ambiente em que está o projeto de encapsulamento.

   

2. Copie a ID da organização.

   

3. No cofre de chaves no portal do Azure, acesse Marcas, crie uma nova marca chamada organization-id e adicione a ID da organização a essa marca.

   

Código de erro 1000121

Código do erro	Descrição
1000121	O armazenamento de chaves do Android não é válido. Tag e/ou certificado ausente

1. Importe seu certificado Android.

   

   

2. Adicione uma nova Tag para o seu Certificado.

   • O nome da tag deve ser baseado no ID do pacote que você usou em seu projeto de encapsulamento. Por exemplo, se a ID do pacote para seu aplicativo encapsulado for com.testApp.wrap, o novo nome da marca deverá ser com.testApp.wrap.keystore.

   • O valor da marca deve corresponder ao nome que você escolheu para o certificado ao carregar o arquivo de certificado na etapa anterior. Por exemplo, se o Certificado for chamado AndroidWrapCertificate, o valor do valor da Marca também deverá ser AndroidWrapCertificate.

   

Código de erro 1000122

Código do erro	Descrição
1000122	O certificado iOS não é válido

1. Importe seu certificado iOS.

   

   

2. Adicione uma nova Tag para o seu Certificado.

   • O nome da tag deve ser baseado no ID do pacote que você usou em seu projeto de encapsulamento. Por exemplo, se a ID do pacote para seu aplicativo encapsulado for com.testApp.wrap, o novo nome da marca deverá ser com.testApp.wrap.cert.

   • O valor da marca deve corresponder ao nome que você escolheu para o certificado ao carregar o arquivo de certificado na etapa anterior. Por exemplo, se o Certificado for chamado iOSCertificate1, o valor do valor da Marca também deverá ser iOSCertificate1.

   

Código de erro 1000123

Código do erro	Descrição
1000123	O perfil do iOS não é válido

1. Importe seu perfil de provisionamento como um segredo.

2. Adicione uma nova Tag para seu perfil de provisionamento.

   • O nome da tag deve ser baseado no ID do pacote que você usou em seu projeto de encapsulamento. Por exemplo, se a ID do pacote do aplicativo encapsulado for com.testApp.wrap, o novo nome da marca deverá ser com.testApp.wrap.profile.

   • O valor da Tag deve corresponder ao nome que você escolheu para o seu Segredo ao carregar o perfil de previsão na etapa anterior. Por exemplo, se o Segredo for chamado iOSProvisioningProfileSecret, o valor do valor da Marca também deverá ser iOSProvisioningProfileSecret.

   

Outros problemas em resumo para o Power Apps

Para todos os outros problemas, ou se o problema persistir após seguir essas etapas, consulte Próximas etapas mais adiante neste artigo para relatar o problema por meio de uma solicitação de suporte. Você precisa fornecer um vídeo de reprodução, capturas de tela ou ambos, e um ID de sessão que pode ser obtido das seguintes maneiras:

• Na tela de entrada, vá para o canto inferior direito para selecionar o ícone de engrenagem e, em seguida, selecione Detalhes da sessão.
• Depois de abrir o aplicativo, toque e segure na tela e selecione Detalhes da Sessão.

Próximas etapas

Se o problema não estiver listado neste artigo, você poderá pesquisar mais recursos de suporte ou entrar em contato com o suporte da Microsoft. Para obter mais informações, consulte Obter Ajuda + Suporte.