Guida passo-passo al wrapping: guida dettagliata per creare un'app nativa per dispositivi mobili

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 personalizzata utilizzando la procedura guidata di involucro

Seguire questi passaggi per configurare, creare, firmare e distribuire un pacchetto app mobile nativo personalizzato (APK, AAB o IPA) dalle Canvas Apps utilizzando l'assistente di packaging 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.

   Nota

   • 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. Seleziona 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.

   Nota

   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. Creare un insieme di credenziali di Azure 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.

   Nota

   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. Configurare 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.

      Nota

      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.

      Nota

      Solo gli amministratori di Azure possono creare un Key Vault dalla procedura guidata di creazione. 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 (Key Vault). Se vengono visualizzati errori, correggerli. Dopo aver superato tutti i controlli, selezionare Avanti.

   5. Nella schermata successiva immettere il nome del certificato nell'archivio 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 nel portale di Azure. Carica il certificato generato nel repository di chiavi configurato.

      Nota

      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 la cassaforte, è 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 l'ID della 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.

      Nota

      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

Per caricare la tua build nell'archiviazione BLOB di Azure, è necessario un account di archiviazione BLOB di Azure e un contenitore. Se non ne hai uno, crearne uno.

1. Nel Gestisci output selezionare Configura per aggiungere il Key Vault, l'account di archiviazione e il contenitore.
2. Nel pannello laterale Configura key vault, seleziona il key vault che archivia le credenziali di accesso al tuo archiviazione BLOB di Azure e quindi seleziona Avanti.
3. Nella schermata Configura archiviazione selezionare il nome di archiviazione e il nome del contenitore e quindi immettere il nome del segreto che contiene l'accesso all'archiviazione. Per creare un nuovo segreto, seguire le istruzioni nella sezione "Come creare un segreto" nella stessa schermata.
4. Selezionare Fine.

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. Specificare:
     • Nome dell'applicazione: il nome dell'app visualizzabile dai clienti
     • hash della firma di Android (per Android): una stringa alfanumerica di 28 caratteri
  3. Salva 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 wrapping controlla e contrassegna le autorizzazioni che non sono supportate dall'app. In qualità di amministratore di Azure, selezionare l'accesso con un clic nella procedura guidata di wrap 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. Seleziona 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. Salva 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 organizzativa (qualsiasi directory di Microsoft Entra - Multitenant) 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.

Vedi anche

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