Condividi tramite


Utilizzare la procedura guidata di wrapping per creare la tua app per dispositivi mobili

Usare la funzionalità di wrapping per creare un pacchetto di una o più app canvas come un unico pacchetto di app per dispositivi mobili native usando la procedura guidata.

La funzionalità di wrapping in Power Apps ti consente dicreare versioni per dispositivi mobili native delle tue app canvas come app per dispositivi mobili Android e iOS. Puoi distribuire tali app per dispositivi mobili native di cui è stato eseguito il wrapping agli utenti finali tramite Centro app Microsoft, Google Play o Responsabile aziendale Apple o altri metodi di distribuzione nativi.

La funzione di wrapping ti consente di creare app per dispositivi mobili per iOS, Android o Google Play Store:

  • iOS (Pacchetto IPA)
  • Android (Pacchetto APK)
  • Per la distribuzione tramite Google Play Store (pacchetto AAB)

La funzionalità di wrapping esegue il wrapping delle tue app canvas in una shell di app per dispositivi mobili nativa per la firma digitale e la distribuzione. Quando aggiorni la tua app e la ripubblichi, l'app viene aggiornata automaticamente.

Crea app per dispositivi mobili native per iOS e Android utilizzando la procedura guidata

  1. Accedere a Power Apps.

  2. Seleziona Esegui il wrapping dal riquadro di spostamento sinistra. Se l'elemento non si trova nel riquadro del pannello laterale, seleziona …Altro, quindi l'elemento desiderato.

  3. Seleziona l'app di cui eseguire il wrapping, quindi sulla barra dei comandi, seleziona Esegui il wrapping.

Passaggio 1: seleziona app

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

    • Applicazione principale: seleziona l'app visualizzata dagli utenti finali all'avvio dell'app per dispositivi mobili.

    • App secondarie: altre app facoltative che puoi raggruppare nella stessa build per il pacchetto di app per dispositivi mobili insieme all'app principale.

      Scegli le app di cui desideri eseguire il wrapping.

      Nota

      • Puoi utilizzare la stessa app principale in più progetti di wrapping.
      • Nella procedura guidata di wrapping, se il nome dell'app principale non è corretto, procedi al passaggio successivo e quindi torna a vedere il nome corretto.
  2. Seleziona Avanti.

Passaggio 2: registrare l'app

Nella schermata Registra app, registra manualmente l'applicazione in Azure per stabilire una relazione di trust tra l'app e la piattaforma di identità Microsoft. Ulteriori informazioni: Registrazione manuale dell'app sul portale di Azure.

La tua app deve essere registrata in Microsoft Entra in modo che gli utenti della tua app possano accedere. Se ti sei già registrato, trova la tua registrazione nel campo di registrazione di proprietà.

Creare una nuova registrazione app.

Se non vedi il nome dell'app registrata nel menu a discesa Registrazioni possedute, segui questi passaggi.

  • Seleziona Nuova registrazione app per creare automaticamente una nuova registrazione per la tua app.

  • Dovrai fornire il nome dell'applicazione e l'hash della firma Android, in quanto sono campi obbligatori. Il nome applicazione è obbligatorio perché è il nome dell'applicazione per i clienti. L'hash della firma Android è necessario se hai selezionato Android come una delle piattaforme mentre crei e costruisci il tuo progetto di wrapping.

    Nota

    Il formato della chiave hash è un numero hash alfanumerico di Android 28 cifre, ad esempio –ga0RGNYHvNM5d0SLGQfpQWAPGJ8=. Se la chiave hash della firma esiste già, non è necessario crearne una nuova. Puoi riutilizzare la chiave hash della firma generata in precedenza durante la creazione di una nuova registrazione dell'app.

    Aggiungi app dei dettagli di registrazione.

Configurare le app di terze parti consentite dall'amministratore

La procedura guidata di wrapping configura automaticamente tutte le autorizzazioni API richieste per la tua app. Puoi anche configurare manualmente le autorizzazioni API se hai bisogno di eseguire la risoluzione dei problemi di questo passaggio. Ulteriori informazioni: Configurare le autorizzazioni API per la tua app manualmente.

Quando registri l'app, l'amministratore di Azure deve fornire l'accesso per continuare. Per autorizzare l'accesso, segui questi passaggi:

  • Apri Windows PowerShell ed eseguilo come amministratore.
  • Esegui il comando Install-Module -Name Microsoft.PowerApps.Administration.PowerShell -AllowClobber -Force.
  • Imposta i criteri di esecuzione con: Set-ExecutionPolicy -ExecutionPolicy RemoteSigned.
  • Importa il modulo usando: Import-Module -Name Microsoft.PowerApps.Administration.PowerShell.
  • Esegui Add-AdminAllowedThirdPartyApps e fornisci l'ID app per il quale è necessario l'accesso amministratore.
  • Esegui Get-AdminAllowedThirdPartyApps per verificare se il nome dell'app è presente nell'elenco.

Una volta completati i passaggi precedenti, la schermata di registrazione somiglierà allo screenshot seguente.

Screenshot che mostra la schermata di registrazione con segni di spunta verdi per i passaggi completati

Autorizzazioni API

Quando registri l'app, l'amministratore di Azure deve anche concedere l'accesso alle autorizzazioni API per l'app. Fai riferimento allo screenshot seguente per istruzioni su come concedere l'accesso e sui motivi per cui sono necessarie le autorizzazioni API.

Screenshot che mostra le autorizzazioni API per l'app.

Nota

In questo passaggio, a volte per i nuovi clienti, è visibile solo il campo Nome applicazione. Il campo per aggiungere l'hash della firma Android non viene visualizzato. Per risolvere questo problema, continua con i passaggi successivi e seleziona le piattaforme di destinazione come Android nel passaggio Piattaforme di destinazione.

Passaggio 3: Configurare la personalizzazione

  1. In Passaggio di configurazione della personalizzazione, imposta le seguenti opzioni di aspetto e design per la tua app:

    Nota

    Tutte le immagini devono essere in formato .png. Verrà utilizzata un'immagine predefinita se non vengono selezionate immagini personalizzate.

    • Icone App: carica le icone da utilizzare per l'app. Dimensioni consigliate per iOS: 1.024 px per 1.024 px immagine .png o superiore. Dimensioni immagini consigliate per Android: 432 px per 432 px immagine .png o superiore.
    • Immagine della schermata iniziale: immagine che verrà utilizzata nella schermata iniziale dell'app per dispositivi mobili durante il caricamento. Immagine predefinita utilizzata quando non fornita.
    • Immagine della schermata iniziale: Immagine che verrà utilizzata nella schermata di benvenuto (accesso) dell'app per dispositivi mobili durante il caricamento. Immagine predefinita utilizzata quando non fornita.
    • Colore di sfondo: codice colore esadecimale utilizzato per lo sfondo della schermata di benvenuto.
    • Colore riempimento pulsante: codice colore esadecimale utilizzato per riempire il colore del pulsante.
    • Tema del testo della barra di stato: colore per il testo della barra di stato nella parte superiore dell'app.
  2. Seleziona Avanti.

Passaggio 4: piattaforma di destinazione

  1. Nella schermata Scegli le piattaforme per dispositivi mobili da utilizzare come destinazione, inserisci un ID aggregazione desiderato.

    Nota

    L'ID aggregazione è un identificatore univoco che crei per la tua app. Un ID aggregazione deve contenere un punto (.) e nessuno spazio.

  2. In Piattaforme di destinazione, seleziona tutte le piattaforme per dispositivi mobili che i tuoi utenti finali utilizzano sui loro dispositivi mobili.

  3. Impostare l'interruttore Firma l'app su ON per firmare con codice l'app per dispositivi mobili, quindi seleziona l'URI Azure Key Vault dall'elenco e seleziona Avanti. Se non sono presenti voci nell'elenco URI Azure Key Vault, è necessario creare prima Azure Key Vault. Ulteriori informazioni: Creare Azure Key Vault per eseguire il wrapping per Power Apps.

    Scegli le app di cui desideri eseguire il wrapping.

Puoi anche codificare manualmente il pacchetto dell'app per dispositivi mobili invece di utilizzare la firma automatica del codice disponibile nella procedura guidata di wrapping. Per ulteriori informazioni su come codificare manualmente la firma dell'app, vedere:

Nota

La procedura guidata Esegui il wrapping fornisce un processo di accesso automatico. Tuttavia, gli sviluppatori che hanno familiarità con i processi per dispositivi mobili possono firmare manualmente le applicazioni Android e iOS utilizzando meccanismi diversi per ciascuna piattaforma. Se firmi tramite il processo manuale, non è necessario creare un Azure Key Vault.

  1. Seleziona Avanti.

Passaggio 5: archiviazione BLOB di Azure

  1. Se non è già stato fatto, crea un insieme di credenziali delle chiavi di Azure. Altre informazioni: Creare Azure Key Vault per il wrapping usando la sottoscrizione predefinita
  2. Creare un account di archiviazione BLOB Azure e un nome del contenitore. Altre informazioni: Creare un account di archiviazione di Azure
  3. Aggiungi l'URI dell'insieme di credenziali delle chiavi Azure facendo clic sull'elenco a discesa.
  4. Aggiungere il nome dell'account di archiviazione BLOB Azure e il nome del contenitore creato durante il passaggio di creazione dell'account di archiviazione BLOB Azure.
  5. Scaricare l'APK/IPA compilato dalla posizione di archiviazione BLOB Azure creata in precedenza dopo il completamento dei passaggi di compilazione.

Passaggio 6: conclusione

Nella schermata Conclusione, esamina i dettagli dell'app e seleziona Crea. A compilazione riuscita, l'app per dispositivi mobili verrà visualizzata nella posizione di Archiviazione BLOB di Azure selezionata nel passaggio precedente.

Testare e distribuire pacchetti di app per dispositivi mobili

Testa e distribuisci l'applicazione. In caso di problemi durante il test, controlla la pagina di risoluzione dei problemi.

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

Puoi creare automaticamente la registrazione dell'app nella procedura guidata di wrapping come indicato nel passaggio 4. In alternativa, puoi creare manualmente una nuova registrazione per la tua app nel portale di Azure. Maggiori informazioni: Avvio rapido: registrare un'applicazione con la piattaforma di identità Microsoft.

Nota

Sia i clienti singolo tenant che multi-tenant possono utilizzare il wrapping per creare app per dispositivi mobili native basate sulle relative app canvas Power Apps.

Che tu sia un creatore singolo tenant o multi-tenant, seleziona una delle opzioni che contengono Qualsiasi directory Microsoft Entra - Multi-tenant quando scegli il tipo di account supportato per la tua app per abilitarla per il wrapping. Scegli uno dei tipi di account seguenti:

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

Importante

  • Wrapping supporta solo tipi di account Multitenant attualmente. Il tipo di account Singolo tenant non è ancora supportato. Maggiori informazioni sui tipi di account: Tipi di account nella piattaforma Microsoft Identity
  • Devi creare un URI di Reindirizzamento separato per ogni piattaforma (iOS, Android) che vuoi scegliere come target.

Configurare le autorizzazioni API per la tua app manualmente (facoltativo)

Quando completi il passaggio 4 la procedura guidata di wrapping configurerà automaticamente tutte le autorizzazioni API richieste per la tua app.

Se ricevi errori nella procedura guidata di wrapping, puoi configurare manualmente le autorizzazioni API. Ulteriori informazioni: Aggiungere e configurare

Le seguenti autorizzazioni API sono necessarie quando si configurano manualmente le autorizzazioni API:

  • API Microsoft
    • Dynamics CRM
  • API utilizzate dalla mia organizzazione
    • Connessioni API Azure
    • Servizio PowerApps
    • Power BI (richiesto solo se le tue app canvas utilizzano dati Power BI)
    • Gestione delle applicazioni mobili Microsoft (richiesto solo se si desidera utilizzare Microsoft Intune per la distribuzione delle app per dispositivi mobili)

Nota

Se non trovi i permessi sotto API utilizzate dalla mia organizzazione, esegui i seguenti comandi di PowerShell come appropriato e riprova:

  • Assicurati che il modulo Microsoft Graph sia disponibile o installalo utilizzando il comando seguente:
    Install-Module -Name Microsoft.Graph
    
  • Autorizzazione Connessioni API di Azure mancante:
    Connect-MgGraph -TenantId <your tenant ID>
    New-MgServicePrincipal -AppId fe053c5f-3692-4f14-aef2-ee34fc081cae -DisplayName "Azure API Connections"
    
  • Autorizzazione PowerApps Servizio mancante:
    Connect-MgGraph -TenantId <your tenant ID>
    New-MgServicePrincipal -AppId 475226c6-020e-4fb2-8a90-7a972cbfc1d4 -DisplayName "PowerApps Service"
    

Per i passaggi dettagliati, fai riferimento a Richiedere le autorizzazioni nel portale di registrazione dell'app.

Creare una posizione dell'App Center per la tua app per dispositivi mobili manualmente (facoltativamente)

Puoi creare manualmente una posizione dell'app center per la tua app per dispositivi mobili direttamente nell'app center. Maggiori informazioni: Posizione App Center

Suggerimento

Per ulteriori informazioni su App Center, vai a Documentazione dell'App Center Visual Studio.

  1. Vai ad App Center.

  2. Accedi con il tuo account aziendale o dell'istituto di istruzione.

  3. Se non disponi di alcuna organizzazione esistente, seleziona Aggiungi nuova>Aggiungi nuova organizzazione per creare una nuova organizzazione.

  4. Seleziona l'organizzazione nell'elenco del riquadro a sinistra.

  5. Seleziona App>Aggiungi app.

  6. Immetti il nome dell'app.

  7. Seleziona il tipo di rilascio dell'app.

  8. Seleziona sistema operativo Personalizzato per le app iOS o sistema operativo Android per le app Android.

    Nota

    È necessario creare contenitori App Center separati per ciascuna piattaforma.

  9. Per il sistema operativo Android seleziona piattaforma come React Native.

    Nota

    La Piattaforma deve essere React Native per tutte le app in App Center.

    Configurazione dell'app dell'App Center.

  10. Seleziona Aggiungi nuova app.

  11. Copia l'URL dell'App Center dell'app. Ne avrai bisogno in seguito, per configurare il progetto di wrapping in Power Apps.

    Ad esempio, https://appcenter.ms/orgs/Contoso-sales/apps/Sample-canvas-app-for-Android-OS/

    URL dell'App Center.

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

Puoi firmare automaticamente il pacchetto dell'app per dispositivi mobili durante il processo di wrapping nel Passaggio 2, ma puoi anche farlo manualmente dopo la creazione del pacchetto dell'app per dispositivi mobili. Il processo Firma del codice è diverso per dispositivi Android e iOS.

Vedi anche