Risolvere i problemi con la funzione di esecuzione del wrapping in Power Apps

Questo articolo illustra come risolvere i problemi più comuni relativi alla funzionalità di wrapping in Microsoft Power Apps.

Problema 1 - Il wrapping della compilazione ha esito negativo

Se la compilazione a capo non riesce, è possibile eseguire i passaggi seguenti per risolvere il problema.

Passaggio 1: Verificare che le immagini siano in formato PNG

Assicurarsi che le immagini usate per il wrapping siano in formato PNG. L'uso di immagini in qualsiasi formato diverso da PNG a capo causerà l'esito negativo della compilazione. Usare un convertitore di immagini per salvare le immagini come file .png o assicurarsi che i file di immagine originali siano in formato PNG.

Passaggio 2: Verificare che App Center sia configurato correttamente

Il collegamento di App Center deve essere creato come app all'interno di un'organizzazione e non come app autonoma. Lo screenshot seguente mostra come creare una nuova organizzazione nella procedura guidata di wrapping.

Per altre informazioni su come creare automaticamente una nuova posizione nella procedura guidata di wrapping, vedere Passaggio 5: Gestire l'output nella sezione "Creare app per dispositivi mobili native per iOS e Android usando la procedura guidata".

Passaggio 3: Verificare che la configurazione dell'insieme di credenziali delle chiavi sia corretta

Assicurarsi che venga creata un'entità servizio di Azure e che il ruolo dell'entità servizio venga aggiunto correttamente. Per altre informazioni, vedere i passaggi 1 e 2 in Creare app per dispositivi mobili native per iOS e Android usando la procedura guidata.

Assicurarsi che l'insieme di credenziali delle chiavi contenga tutti i certificati, i segreti e i tag necessari per iOS, Android o entrambi:

• iOS: due tag, un certificato e un segreto
• Android: un tag e un certificato

Per altre informazioni, vedere Creare l'insieme di credenziali delle chiavi di Azure per eseguire il wrapping in Power Apps.

Passaggio 4: Riprovare se sono presenti tutte le configurazioni appropriate

Se la compilazione a capo ha ancora esito negativo dopo aver verificato che il progetto di wrapping ha tutte le configurazioni appropriate, vedere la sezione Altri problemi nel wrapping di questo articolo.

Problema 2- Il pulsante a capo è disabilitato per l'app

È possibile eseguire il wrapping delle app solo con autorizzazioni di modifica. Assicurarsi di disporre delle autorizzazioni di modifica per l'app di cui si vuole eseguire il wrapping e riprovare.

Problema 3 - Non è possibile salvare il progetto o attivare una compilazione a capo

Per risolvere questo problema, è possibile:

• Eseguire l'aggiornamento alla versione più recente della soluzione di wrapping e riprovare.
• Assicurarsi che nessun errore di convalida dell'interfaccia utente blocchi l'invio di salvataggio o compilazione .

Problema 4- Non è possibile installare un'app per dispositivi mobili incapsulata in un dispositivo

Assicurarsi di aver firmato l'applicazione di output. È possibile firmarlo configurando un insieme di credenziali delle chiavi e fornendolo in fase di trigger di compilazione o firmando manualmente. Per altre informazioni sulla firma del codice, vedere:

• Configurare l'insieme di credenziali delle chiavi per la firma automatica
• Firmare il codice per iOS
• Firmare il codice per Android

Verificare che il dispositivo mobile soddisfi questi requisiti minimi.

Problema 5- Non è possibile accedere a un'app per dispositivi mobili con wrapping o non è possibile visualizzare i dati

Se non è possibile accedere all'app per dispositivi mobili incapsulata, verificare che:

• L'app Microsoft Entra è configurata correttamente.

• Tutte le autorizzazioni API per l'app sono state aggiunte correttamente. Per altre informazioni su come visualizzare e configurare le autorizzazioni API per l'app, vedere lo screenshot seguente e Configurare le autorizzazioni API.

  

• Lo Add-AdminAllowedThirdPartyApps script è stato eseguito correttamente. Per altre informazioni, vedere Consentire le app registrate nell'ambiente in uso.

• Il tipo di app Microsoft Entra è Multitenant. Nella scheda Autenticazione dell'app Microsoft Entra il tipo di account supportato deve essere Account in qualsiasi directory organizzativa (qualsiasi directory Microsoft Entra - Multitenant).

• Gli URI di reindirizzamento appropriati sono stati creati per iOS e Android. Per Android, verificare che l'hash sia fornito correttamente. Per altre informazioni sulla configurazione di un URI di reindirizzamento, vedere Configurare le impostazioni della piattaforma.

Problema 6 - Errori nell'insieme di credenziali delle chiavi di Azure a capo per Power Apps

Gli errori seguenti dell'insieme di credenziali delle chiavi di Azure potrebbero essere visualizzati incapsulamento per Power Apps e possono essere rettificati.

Codice di errore 1000118

1. Assicurarsi che l'insieme di credenziali delle chiavi di Azure sia nella sottoscrizione predefinita del tenant.

2. Eseguire questi comandi in PowerShell come amministratore:

   Connect-AzureAD -TenantId <your tenant ID>
   

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

3. Nella portale di Azure passare alla sottoscrizione predefinita. Nella pagina Controllo di accesso (IAM) aggiungere un'assegnazione di ruolo Lettore all'entità servizio che rappresenta l'app, ad esempio Eseguire il wrapping dell'app KeyVault Access. Assicurarsi che si tratti di IAM della sottoscrizione e dell'IAM dell'insieme di credenziali delle chiavi. Di seguito sono riportati i passaggi:

   1. Passare alla scheda Controllo di accesso (IAM) e selezionare l'opzione Aggiungi assegnazione di ruolo sotto il pulsante Aggiungi menu.

      

   2. Selezionare la scheda Ruoli funzione processo e assicurarsi che sia selezionato il ruolo Lettore . Selezionare quindi la scheda Membri nel menu in alto.

      

   3. Cercare Wrap KeyVault Access App (Wrap KeyVault Access App) nella scheda Members (Membri).

      

   4. Selezionare Wrap KeyVault Access App e quindi selezionare il pulsante Rivedi e assegna nella parte inferiore della scheda per assegnarlo al ruolo Lettore .

      

Codice di errore 1000119

1. Verificare che l'insieme di credenziali delle chiavi di Azure sia nella sottoscrizione predefinita del tenant.

2. Assicurarsi che l'opzione Criteri di accesso all'insieme di credenziali sia selezionata quando si crea l'insieme di credenziali delle chiavi.

   

3. Eseguire questi comandi in PowerShell come amministratore:

    Connect-AzureAD -TenantId <your tenant ID>
   

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

4. Nella portale di Azure passare alla sottoscrizione predefinita. Nella pagina Controllo di accesso (IAM) aggiungere un'assegnazione di ruolo Lettore all'entità servizio che rappresenta l'app, ad esempio Eseguire il wrapping dell'app KeyVault Access. Assicurarsi che si tratti di IAM della sottoscrizione e dell'IAM dell'insieme di credenziali delle chiavi. Di seguito sono riportati i passaggi:

   1. Passare alla scheda Controllo di accesso (IAM) e selezionare l'opzione Aggiungi assegnazione di ruolo sotto il pulsante Aggiungi menu.

      

   2. Selezionare la scheda Ruoli funzione processo e assicurarsi che sia selezionato il ruolo Lettore . Selezionare quindi la scheda Membri nel menu in alto.

      

   3. Cercare Wrap KeyVault Access App (Wrap KeyVault Access App) nella scheda Members (Membri).

      

   4. Selezionare Wrap KeyVault Access App e quindi selezionare il pulsante Rivedi e assegna nella parte inferiore della scheda per assegnarlo al ruolo Lettore .

      

5. Aggiungere criteri di accesso all'insieme di credenziali delle chiavi di Azure.

   

   

Codice di errore 1000120

1. Passare all'interfaccia di amministrazione di Power Platform, selezionare Ambienti e quindi selezionare l'ambiente in cui si trova il progetto di wrapping.

   

2. Copiare l'ID organizzazione.

   

3. Nell'insieme di credenziali delle chiavi nella portale di Azure passare a Tag, creare un nuovo tag denominato organization-id e aggiungere l'ID organizzazione a questo tag.

   

Codice di errore 1000121

1. Importare il certificato Android.

   

   

2. Aggiungere un nuovo tag per il certificato.

   • Il nome del tag deve essere basato sull'ID bundle usato nel progetto di wrapping. Ad esempio, se l'ID bundle per l'app di cui è stato eseguito il wrapping è com.testApp.wrap, il nuovo nome tag deve essere com.testApp.wrap.keystore.

   • Il valore tag deve corrispondere al nome scelto per il certificato durante il caricamento del file di certificato nel passaggio precedente. Ad esempio, se il certificato è denominato AndroidWrapCertificate, anche il valore del valore tag deve essere AndroidWrapCertificate.

   

Codice di errore 1000122

1. Importare il certificato iOS.

   

   

2. Aggiungere un nuovo tag per il certificato.

   • Il nome del tag deve essere basato sull'ID bundle usato nel progetto di wrapping. Ad esempio, se l'ID bundle per l'app di cui è stato eseguito il wrapping è com.testApp.wrap, il nuovo nome tag deve essere com.testApp.wrap.cert.

   • Il valore tag deve corrispondere al nome scelto per il certificato durante il caricamento del file di certificato nel passaggio precedente. Ad esempio, se il certificato è denominato iOSCertificate1, anche il valore del valore tag deve essere iOSCertificate1.

   

Codice di errore 1000123

1. Importare il profilo di provisioning come segreto.

2. Aggiungere un nuovo tag per il profilo di provisioning.

   • Il nome del tag deve essere basato sull'ID bundle usato nel progetto di wrapping. Ad esempio, se l'ID bundle per l'app di cui è stato eseguito il wrapping è com.testApp.wrap, il nuovo nome tag deve essere com.testApp.wrap.profile.

   • Il valore Tag deve corrispondere al nome scelto per il segreto durante il caricamento del profilo di povisioning nel passaggio precedente. Ad esempio, se il segreto è denominato iOSProvisioningProfileSecret, il valore del valore tag deve essere anche iOSProvisioningProfileSecret.

   

Altri problemi incapsulamento per Power Apps

Per tutti gli altri problemi o se il problema persiste dopo aver seguito questi passaggi, vedere Passaggi successivi più avanti in questo articolo per segnalare il problema tramite una richiesta di supporto. È necessario fornire un video di riproduzione, screenshot o entrambi e un ID sessione che può essere visualizzato nei modi seguenti:

• Nella schermata di accesso passare all'angolo in basso a destra per selezionare l'icona a forma di ingranaggio e quindi selezionare Dettagli sessione.
• Dopo aver aperto l'app, toccare e tenere premuto lo schermo e quindi selezionare Dettagli sessione.

Passaggi successivi

Se il problema non è elencato in questo articolo, è possibile cercare altre risorse di supporto o contattare il supporto tecnico Microsoft. Per altre informazioni, vedere Ottenere assistenza e supporto tecnico.