Procedura guidata per il wrapping: la tua guida dettagliata per creare la tua app per dispositivi mobili nativa

Utilizza questa guida per convertire una o più app canvas in un unico pacchetto di app personalizzato che puoi distribuire su Google Play e iOS App Store.

La funzionalità di wrapping in Power Apps consente di creare versioni native per dispositivi mobili delle tue app canvas come app mobili personalizzate con marchi Android e iOS (pacchetti IPA, APK, AAB). Puoi distribuire tali app per dispositivi mobili native di cui è stato eseguito il wrapping agli utenti finali tramite Google Play, Responsabile aziendale Apple o altri metodi di distribuzione nativi.

Quando aggiorni e ripubblichi l'app, l'app incapsulata viene aggiornata automaticamente per gli utenti.

Passaggi per creare un'app nativa personalizzato utilizzando la procedura guidata per l'esecuzione del wrapping

Segui questi passaggi per configurare, creare, firmare e distribuire un pacchetto per app per dispositivi mobili nativi personalizzati (APK, AAB o IPA) dalle app canvas utilizzando la procedura guidata per l'esecuzione del wrapping in Power Apps.

1. Effettua l'accesso e avvia un progetto di wrap

1. Accedi a Power Apps Maker Portal.
2. Seleziona Avvolgi dal riquadro di spostamento a sinistra. Se l'elemento non si trova nel riquadro del pannello laterale, seleziona …Altro, quindi l'elemento desiderato.
3. Seleziona l'app di cui desideri eseguire il wrapping, quindi sulla barra dei comandi, seleziona Wrapping.

2. Seleziona app

1. Nella schermata Seleziona le app di cui desideri eseguire il wrapping, seleziona l'app principale e quella secondaria.

   • App principale: l'app principale che gli utenti finali vedono all'avvio dell'app per dispositivi mobili.
   • App secondarie: altre app facoltative incluse nello stesso pacchetto di app per dispositivi mobili.

   Note

   • Puoi utilizzare la stessa app principale in più progetti di wrapping.
   • Se il nome dell'app principale non è corretto, vai al passaggio successivo e torna ad aggiornare il nome.

2. Selezionare Avanti.

3. Scegli la piattaforma di destinazione

1. Nella schermata Scegli piattaforma per dispositivi mobili da utilizzare come destinazione, inserisci un ID per il bundle.

   Note

   L'Bundle ID è un identificatore univoco per la tua app. Deve contenere un punto (.) e nessun spazio. Usa lo stesso ID bundle quando crei Azure Key Vault dopo aver generato e caricato i certificati iOS e Android. Se hai già creato Azure Key Vault, verifica l'ID aggregazione nella sezione Tag del portale di Azure.

2. In Piattaforme di destinazione, seleziona tutte le piattaforme per dispositivi mobili che gli utenti finali utilizzano sui propri dispositivi mobili.

3. È necessario disporre di Azure Key Vault per caricare la compilazione in Azure Blob Storage. Se non l'hai già creato, creane uno. Crea un Azure Key Vault direttamente all'interno della procedura guidata di wrapping oppure seguire le istruzioni manualmente.

4. Attivare il toggle di firma automatica per automatizzare il processo di firma.

   Note

   Opzioni di firma manuale:

   • Firma del codice per iOS
   • Firma del codice per Android
   • Firma del codice per Google Play Store È necessario firmare manualmente i file AAB indipendentemente dall'opzione di firma selezionata nella procedura guidata.

5. Configura la firma automatica tramite la procedura guidata.

   1. Nel passaggio della piattaforma di destinazione, attivare la firma automatica. Il servizio verifica se l'archivio di chiavi e il certificato sono già associati.

      Note

      Azure Key Vault viene usato per archiviare e gestire in modo sicuro i segreti e i certificati dell'applicazione, con accesso centralizzato e registrazione di controllo completa.

   2. Se non si dispone di un insieme di credenziali e di un certificato o si desidera modificarli, selezionare Configura.

      Note

      Solo gli amministratori di Azure possono creare un insieme di credenziali delle chiavi dalla procedura guidata di esecuzione del wrapping. Altri utenti devono seguire il processo di creazione manuale dell'archivio chiavi.

      

   3. Nel pannello laterale, selezionare la sottoscrizione e il gruppo di risorse, quindi scegliere il Key Vault. Per creare un nuovo Key Vault, selezionare Crea un nuovo Key Vault. Dopo aver selezionato il Key Vault, selezionare Avanti.

      

   4. Il servizio verifica se l'entità servizio, il ruolo lettore, i criteri di accesso e le variabili di ambiente appropriati sono configurati per l'insieme di credenziali delle chiavi. Se vengono visualizzati errori, correggerli. Dopo aver superato tutti i controlli, selezionare Avanti.

   5. Nella schermata successiva, immetti il nome del certificato nell'insieme di credenziali delle chiavi.

   6. Se non esiste alcun certificato o si vuole modificare il certificato, vedere Generare l'hash della chiave e della firma per creare un nuovo certificato. Selezionare quindi Crea un certificato in questa schermata. Questa azione consente di passare all'insieme di credenziali delle chiavi nel portale di Azure. Carica il certificato generato nel repository di chiavi configurato.

      Note

      Gli utenti sono responsabili della creazione del certificato.

      

   7. Selezionare Fine.

   8. Nella schermata principale, Azure Key Vault e il certificato appaiono come confermati.

   9. Nella schermata principale selezionare Avanti.

6. Configurare la firma automatica dal portale di Azure.

   1. Per creare un Azure Key Vault, fare riferimento alle istruzioni in creare un Azure Key Vault. Dopo aver creato l'insieme di credenziali, è necessario aggiungere i tag, i segreti e i certificati richiesti. Aggiungi la variabile di ambiente, se non l'hai già creata.
   2. Per creare la variabile di ambiente, vai a Power Apps>Soluzioni>Soluzione predefinita. Quindi seleziona Nuovo>Altro>Variabile di ambiente, aggiungi il nome visualizzato come "PA_Wrap_KV_ResourceID". Il nome della nuova variabile di ambiente deve avere il prefisso "new". In caso contrario, vedi Impostare il prefisso della variabile di ambiente per i passaggi dettagliati.
   3. Per aggiungere informazioni sull'insieme di credenziali alle variabili di ambiente, accedi al portale Azure come amministratore. Vai a Tutte le risorse>Insieme di credenziali delle chiavi>Proprietà, quindi copia ID risorsa.
   4. Per aggiungere l'input alla variabile di ambiente, vai a Power Apps>ApplicationName>Tutte>Variabili di ambiente. Fai clic sui tre puntini, seleziona Modifica, aggiungi il valore copiato al Valore predefinito e salva.
   5. Per verificare se il valore della tabella è stato aggiornato, vai a Power Apps>Tabelle>Definizione variabile di ambiente>new_PA_Wrap_KV_ResourceID. Il valore in Valore predefinito deve essere lo stesso di quello del resourceID a cui si vuole aggiungere il vault.

      Note

      Linee guida per l'aggiunta dell'input dietro le variabili di ambiente per le informazioni sul Key Vault:

      • Le variabili di ambiente non devono essere vuote né contenere più voci.
      • Assicurarsi che l'ID risorsa aggiunto sia corretto (verificare l'ortografia).
      • Assicurati che il resourceID aggiunto contenga tag non vuoti e includa tutti i tag previsti con l'ID pacchetto utilizzato nella procedura guidata di impacchettamento.
   6. Segui la procedura descritta in Passaggi per la firma automatica del codice per creare i tag, i segreti e i certificati richiesti durante il processo di firma automatica.

4. Gestire l'output

Configurare la posizione in cui verranno archiviati i file binari dell'app (FILE APK e IPA). Scegliere una delle opzioni seguenti in base ai requisiti di archiviazione e accesso.

Dataverse (scelta consigliata)

L'archiviazione dataverse è l'opzione più semplice ed è consigliata per il test e la valutazione delle distribuzioni.

Quando si seleziona Dataverse, i file binari della compilazione vengono archiviati automaticamente nella tabella msdyn_PowerAppsWrapBuild dell'ambiente corrente. Le build vengono conteggiate ai fini della capacità di archiviazione di Dataverse.

Archiviazione BLOB di Azure (Servizio di archiviazione Blob di Azure)

Archiviazione BLOB di Azure richiede la configurazione.

Prerequisiti

Prima di configurare Archiviazione BLOB di Azure, assicurarsi di disporre di:

• Un account e un contenitore di Archiviazione BLOB di Azure. Se non ne hai uno, scopri come creare un account di archiviazione.

• Un Azure Key Vault che contiene le credenziali di accesso per l'account di archiviazione. Se non ne hai una, scopri come creare un insieme di credenziali.

• Autorizzazioni sufficienti per leggere i segreti dal Key Vault.

Configurare Archiviazione BLOB di Azure

Per configurare l'archiviazione BLOB di Azure, seguire questi passaggi:

1. Nella pagina Gestisci output selezionare Configura.
2. Nel pannello laterale Configura Key Vault, seleziona il Key Vault che contiene le credenziali di Archiviazione BLOB di Azure, quindi seleziona Avanti.
3. Immetti i dettagli seguenti:
   • Nome account di archiviazione: nome dell'account Archiviazione BLOB di Azure.
   • Nome del contenitore: Il contenitore in cui verranno caricati gli artefatti di compilazione.
4. Seleziona Salva.

Dopo il salvataggio, la configurazione viene applicata alle compilazioni successive. Per verificare, eseguire una compilazione e verificare che il file APK o IPA venga visualizzato nel contenitore specificato.

5. Registrare l'app

Nella schermata Registra app, registra l'applicazione in Azure per stabilire una relazione di fiducia tra la piattaforma di identità Microsoft.

• Se hai già registrato un'app:

  • Trova la tua registrazione nel campo di registrazione di proprietà.

• Se non vedi la tua app registrata:

  1. Seleziona Nuova registrazione app per creare una nuova registrazione.
  2. Fornire:
     • Nome dell'applicazione: il nome dell'app visualizzabile dai clienti
     • hash della firma di Android (per Android): una stringa alfanumerica di 28 caratteri
  3. Salvare le modifiche.

Configurare le app di terze parti consentite dall'amministratore come amministratore del tenant di Azure

L'app registrata deve essere configurata come app di terze parti. Per configurare l'app, l'amministratore del tenant di Azure segue questa procedura.

Dopo aver completato questo passaggio, la schermata di registrazione sarà simile a questa:

Concedi autorizzazioni API come amministratore del tenant Azure

L'app richiede le autorizzazioni API seguenti per funzionare correttamente.

Autorizzazioni API richieste

Configurare le autorizzazioni all'interno della procedura guidata di Wrap

La procedura guidata di esecuzione del wrapping controlla e contrassegna le autorizzazioni che non sono supportate dall'app. In qualità di amministratore di Azure, seleziona l'accesso con un clic nella procedura guidata di wrapping per concedere le autorizzazioni in sospeso. In alternativa, è possibile configurare le autorizzazioni tramite i comandi di PowerShell seguenti.

Configurare le autorizzazioni tramite i comandi di PowerShell:

Assicurati che DeviceManagementManagedApplication sia impostato su Sì quando concedi il consenso dell'amministratore per la tua app.

Se non trovi le autorizzazioni in API utilizzate dalla mia organizzazione, esegui i seguenti comandi di PowerShell come amministratore di Azure:

1. Assicurarsi che il modulo Microsoft Graph sia disponibile o installalo:

   Install-Module -Name Microsoft.Graph
   

2. Concedi l'autorizzazione Connessioni API Azure per l'AppId fe053c5f-3692-4f14-aef2-ee34fc081cae statico:

   Connect-MgGraph -TenantId <your tenant ID>
   New-MgServicePrincipal -AppId fe053c5f-3692-4f14-aef2-ee34fc081cae -DisplayName "Azure API Connections"
   

3. Concedi l'autorizzazione Servizio PowerApps per l'AppId 475226c6-020e-4fb2-8a90-7a972cbfc1d4 statico:

   Connect-MgGraph -TenantId <your tenant ID>
   New-MgServicePrincipal -AppId 475226c6-020e-4fb2-8a90-7a972cbfc1d4 -DisplayName "PowerApps Service"
   

Configurare le autorizzazioni API manualmente (facoltativo)

Se ricevi errori, configura manualmente le autorizzazioni API. Per ulteriori informazioni, vedi Aggiungi e configura.

Aggiungi URI di reindirizzamento come amministratore dell'app

1. Nel portale di Azure, vai alla sezione >Autenticazione della registrazione della tua app.
2. Seleziona Aggiungi una piattaforma e scegli iOS o Android.
3. Per iOS, immetti il Bundle ID. Per Android, immetti l'ID pacchetto e la chiave hash della firma.

6. Configurare il branding

1. Nel passaggio Configurare la personalizzazione, imposta le seguenti opzioni per la tua app:

2. Selezionare Avanti.

7. Completare e costruire

1. Nella schermata Conclusione, rivedi i dettagli dell'app e seleziona Crea.
2. Una volta riuscita la compilazione, il pacchetto dell'app sarà disponibile nell'Archiviazione BLOB di Azure specificata.

Visualizzare la compilazione

Puoi visualizzare la tua creazione in svariati modi:

• Dopo la compilazione, seleziona Visualizza compilazioni
• Vai a Wrap projects nel riquadro laterale, passa il cursore sopra il progetto richiesto e selezionalo
• Seleziona l'opzione Visualizza compilazioni nell'intestazione superiore

Testa e distribuisci la tua app

Testa la tua app e distribuiscila in base alle esigenze. In caso di problemi, consulta la pagina della risoluzione dei problemi.

Imposta il prefisso delle variabili di ambiente

Il nome della nuova variabile di ambiente deve avere il prefisso "new". In caso contrario, procedi nel seguente modo:

1. Vai a Soluzioni>Nuova soluzione.
2. Seleziona un Editore o creane uno nuovo.
3. Seleziona l'icona di modifica accanto all'Editore per visualizzare o modificare il prefisso.
4. Se il prefisso non è "nuovo", modificarlo in "new".
5. Salvare le modifiche.

Registra la tua app nel portale di Azure manualmente (facoltativo)

È possibile creare la registrazione dell'app automaticamente nella procedura guidata o manualmente in Azure. Maggiori informazioni: Avvio rapido: registrare un'applicazione con la piattaforma di identità Microsoft.

Durante la registrazione, seleziona una tipologia di account contenente Qualsiasi directory Microsoft Entra - Multitenant:

• Account in qualsiasi directory dell'organizzazione (qualsiasi directory Microsoft Entra - Multi-tenant)
• Account in qualsiasi directory dell'organizzazione (qualsiasi directory Microsoft Entra - Multi-tenant) e account Microsoft personali, ad esempio Skype o Xbox

Registrazione dell'app - Tipi di account supportati per il wrap.

Firma manualmente il pacchetto dell'app per dispositivi mobili (facoltativo)

Puoi firmare l'app automaticamente nel passaggio 2 o manualmente dopo la creazione. La firma del codice è diversa per Android e iOS.

Vantaggi della firma automatica per iOS e Android (APK):

• Non è necessario ripetere il processo di firma durante il rewrapping.
• Non devi aspettare che gli sviluppatori di app completino il processo.
• Non occorre configurare Android Studio o ricordare le password.
• Non è necessario un dispositivo Mac per l'accesso a iOS.

Vedere anche

• Risolvere i problemi con la funzione di avvolgimento in Power Apps
• Panoramica del wrapping
• Firma manuale del codice per iOS
• Firmare il codice manuale per Android
• Creare Azure Key Vault per la firma automatica del codice
• Domande frequenti per il wrapping