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 (UDID) del dispositivo è 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 suo 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 tuo profilo di provisioning con l'UDID e distribuisci una nuova build ai tester. Puoi esportare manualmente gli UDID utilizzando la console Firebase o Firebase CLI oppure puoi esportarli tramite programmazione utilizzando fastlane.

Esportare manualmente gli UDID

  1. Aggiungi i dispositivi al tuo portale per sviluppatori Apple.
    • Opzione 1: importa gli UDID del dispositivo come file CSV.

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

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

    • Opzione 2: raccogliere e inserire gli UDID via email.

      Nella pagina Add Devices (Aggiungi dispositivi) del portale per gli sviluppatori Apple, registra il nuovo UDID specificato nell'email che hai ricevuto.

  2. Aggiungi i dispositivi registrati al profilo di provisioning.
  3. Scarica il profilo di provisioning e utilizzalo per ricostruire l'app. Se la ricostruisci solo per aggiornare i dispositivi registrati, non aggiornare il numero o la versione della build.
  4. Ridistribuisci l'app dalla console Firebase o dall'interfaccia a riga di comando. Se non modifichi la versione, il numero di 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 ricevono email di notifica.

Esportare UDID in modo programmatico utilizzando fastlane

  1. Esporta tutti gli UDID del dispositivo 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. 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 ricostruire l'app. Se la ricostruisci solo per aggiornare i dispositivi registrati, non aggiornare il numero o la versione della build.

  5. Ridistribuisci l'app. Se non modifichi la versione, il numero di build o il codice dell'app, App Distribution non crea una nuova release e non invia una notifica ai tester. Se hai già distribuito una build con lo stesso numero 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 avvisi App Distribution per le registrazioni di nuovi 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 gli avvisi) riceverà un'email quando viene registrato un nuovo dispositivo iOS.

Attivare/disattivare gli avvisi per il tuo 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 richieste 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 avvisi App Distribution.

Configurare avvisi avanzati per i servizi di terze parti

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

Per automatizzare completamente l'onboarding dei nuovi tester iOS, puoi scrivere una funzione che aggiunga l'UDID di un nuovo dispositivo iOS al profilo di provisioning della tua app, ricostruisca l'app e la ridistribuisca con il profilo di provisioning aggiornato.

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

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

    1. Configurare un ambiente di sviluppo per Node.js o Python.
    2. Installa e accedi all'interfaccia a riga di comando Firebase.
    3. Inizializza Cloud Functions for Firebase utilizzando l'interfaccia a riga di comando Firebase.

  2. Scrivere ed eseguire il deployment di una funzione che acquisisca un evento di avviso da App Distribution e gestisca il relativo payload (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 gli App Distribution avvisi.

Passaggi successivi