Registra altri dispositivi iOS

Se vuoi distribuire build iOS ad hoc utilizzando App Distribution, devi seguire questa guida per registrare i dispositivi dei tester. Una build ad hoc è una build non firmata con un profilo Enterprise. Un dispositivo può installare una build ad hoc solo se l'identificatore univoco del dispositivo (UDID) è incluso nel profilo di provisioning della build.

Quando un tester accetta un invito a testare la tua app, App Distribution richiede l'autorizzazione a condividere l'identificatore del dispositivo del tester con te, lo sviluppatore. Prima di scaricare una build ad hoc, App Distribution chiede al tester di registrare il proprio dispositivo. Se il tester registra il proprio dispositivo, App Distribution raccoglie l' UDID dal dispositivo e ti invia una notifica via email.

Quando ricevi un'email contenente un UDID, aggiorna il profilo di provisioning con l'UDID e distribuisci una nuova build ai tester. Puoi esportare manualmente gli UDID utilizzando la Firebase console o l'interfaccia a riga di comando di Firebase oppure puoi esportarli a livello di programmazione utilizzando fastlane.

Esportare manualmente gli UDID

  1. Aggiungi i dispositivi al portale Apple Developer.
    • Opzione 1: importa gli UDID dei dispositivi come file CSV.

      Nella scheda Tester e gruppi della dashboard App Distribution, seleziona Tutti i tester, quindi fai clic su Esporta UDID Apple per scaricare un file CSV. Poi, importa il file nel tuo account sviluppatore Apple utilizzando l'opzione Registra più dispositivi. Per saperne di più, consulta Distribuire l'app ai dispositivi registrati.

      Tieni presente che il tuo account sviluppatore Apple potrebbe consentirti di importare solo un numero limitato di dispositivi all'anno.

    • Opzione 2: raccogli e inserisci gli UDID via email.

      Nella pagina Aggiungi dispositivi del portale Apple Developer, registra il nuovo UDID specificato nell' email che hai ricevuto.

  2. Aggiungi i dispositivi registrati al tuo profilo di provisioning.
  3. Scarica il profilo di provisioning e utilizzalo per ricompilare l'app. Se stai ricompilando solo per aggiornare i dispositivi registrati, non aggiornare il numero di build o la versione.
  4. Ridistribuisci l'app dalla Firebase console o dall'interfaccia a riga di comando. Se non modifichi la versione, il numero build o il codice dell'app, App Distribution non crea una nuova release e non invia notifiche ai tester. Se hai già distribuito una build con lo stesso numero di build e la stessa versione, solo gli utenti dei dispositivi appena registrati riceveranno email di notifica.

Esportare gli UDID a livello di programmazione utilizzando fastlane

  1. Esporta tutti gli UDID dei dispositivi dei tester come file CSV da fastlane. Ad esempio, crea ed esegui una nuova corsia download_udids:

    lane :download_udids do
    firebase_app_distribution_get_udids(
        app: "<your Firebase app ID>",
        output_file: "<path to output file>",
    )
end

  2. Importa gli UDID nel tuo account sviluppatore Apple utilizzando l'opzione Registra più dispositivi. Per saperne di più, consulta la documentazione di Apple's. Tieni presente che il tuo account sviluppatore Apple potrebbe consentirti di importare solo un numero limitato di dispositivi all'anno.

  3. Aggiungi i dispositivi registrati al tuo profilo di provisioning.

  4. Scarica il profilo di provisioning e utilizzalo per ricompilare l'app. Se stai ricompilando solo per aggiornare i dispositivi registrati, non aggiornare il numero di build o la versione.

  5. Ridistribuisci l' app. Se non modifichi la versione, il numero build o il codice dell'app, App Distribution non crea una nuova uscita e non invia notifiche ai tester. Se hai già distribuito una build con lo stesso numero di build e la stessa versione, solo gli utenti dei dispositivi appena registrati riceveranno email di notifica.

Ricevere avvisi

Ricevere avvisi predefiniti

Per impostazione predefinita, Firebase può inviare App Distribution avvisi per le nuove registrazioni di dispositivi iOS via email.

Per ricevere gli avvisi App Distribution tramite questo meccanismo predefinito, devi disporre dell'autorizzazione firebase.projects.update. I seguenti ruoli includono questa autorizzazione obbligatoria per impostazione predefinita: Amministratore Firebase o Proprietario o Editor del progetto.

Per impostazione predefinita, ogni membro del progetto (che dispone delle autorizzazioni necessarie per ricevere avvisi) riceverà un'email quando viene registrato un nuovo dispositivo iOS.

Attivare/disattivare gli avvisi per il proprio account

Per il tuo account, puoi attivare/disattivare gli avvisi App Distribution senza influire sugli altri membri del progetto. Tieni presente che devi comunque disporre delle autorizzazioni necessarie per ricevere gli avvisi.

Per attivare o disattivare gli avvisi App Distribution:

  1. Nella console Firebase, nell'angolo in alto a destra, vai a Avvisi Firebase.
  2. Poi, vai a Impostazioni e imposta la preferenza dell'account per gli App Distribution avvisi.

Configurare gli avvisi avanzati per i servizi di terze parti

Puoi anche inviare gli avvisi App Distribution al canale di notifica preferito del tuo team utilizzando Cloud Functions for Firebase. Ad esempio, puoi scrivere una funzione che acquisisce un evento di avviso per la registrazione di un nuovo dispositivo iOS e pubblica le informazioni sull'avviso in un servizio di terze parti, come Discord, Slack o Jira.

Per automatizzare completamente l'onboarding dei nuovi tester iOS, puoi scrivere una funzione che aggiunge l'UDID di un nuovo dispositivo iOS al profilo di provisioning dell'app, ricompila l'app e la ridistribuisce con il profilo di provisioning aggiornato.

Per configurare le funzionalità di avviso avanzate utilizzando Cloud Functions for Firebase:

  1. Configura Cloud Functions for Firebase, che include le seguenti attività:

    1. Configura un ambiente di sviluppo per Node.js o Python.
    2. Installa l'interfaccia a riga di comando Firebase ed esegui l'accesso.
    3. Inizializza Cloud Functions for Firebase utilizzando l'Firebase CLI.

  2. Scrivi e implementa una funzione che acquisisce un evento di avviso da App Distribution e gestisce il payload dell'evento (ad esempio, pubblica le informazioni sull'avviso in un messaggio su Discord).

Per scoprire tutti gli eventi di avviso che puoi acquisire, consulta la documentazione di riferimento per App Distribution gli avvisi.

Passaggi successivi