Introduzione

Il presente articolo illustra la procedura per configurare un progetto Firebase per la propria applicazione mobile di marca. Tale operazione è necessaria qualora si desideri utilizzare una delle seguenti funzionalità nell'applicazione di marca:

• Notifiche push
• Google Analytics
• Accesso con Google

Suggerimento: in questo PDF ec co ulteriori informazioni relative a ciascuno degli eventi ricevuti in Firebase Analytics.

Prerequisiti: ID app e link agli store

Prima di procedere con le configurazioni Firebase descritte nel presente documento, è necessario aver completato i seguenti passaggi:

• Selezionare un ID per la propria app mobile di marca. Si raccomanda di adottare la notazione a dominio inverso (ad esempio, com.docebo.mobile). Tale ID corrisponderà al packageId per Android e al bundleID per iOS. L'ID deve essere univoco e non deve essere già presente nei rispettivi store. Preferibilmente, dovrebbe essere identico per entrambi gli store, anche se ciò non è obbligatorio.

• Per ciascuno store, tramite la Google Play Console o App Store Connect, seguire la procedura per la creazione dell'app (non è necessario caricare una build in questa fase). Durante tale processo, verrà richiesto di fornire l'ID selezionato e la creazione dell'app genererà un Link allo store simile ai seguenti esempi:

  https://play.google.com/store/apps/details?id=com.yourcompany.mobile

  oppure

  https://apps.apple.com/us/app/go-learn/id3141592653

La creazione preliminare delle app in questo modo consente di garantire l'unicità dell'ID scelto.

Migliori pratiche: annotare l'ID app e i link agli store, in quanto saranno necessari per le configurazioni successive.

Creare un progetto Firebase

Qualora non si disponga già di un progetto Firebase, procedere come segue per crearne uno:

1. Accedere alla console Firebase e selezionare Creare un progetto.
2. Inserire un nome per il progetto e cliccare su Continua.
3. Nel passaggio Google Analytics per il tuo progetto, qualora si desideri utilizzare le funzionalità di analytics nell'applicazione:
   • Attivare l'opzione Abilita Google Analytics per questo progetto e cliccare su Continua.
   • Nella sezione Configura Google Analytics, selezionare la posizione dell'organizzazione e definire le modalità di condivisione dei dati di analytics con Google.
     (qualora non si desideri utilizzare le funzionalità di analytics, è possibile lasciare il toggle disattivato)
4. Cliccare su Crea progetto.

Ottenere l'ID progetto Firebase e il file chiave account di servizio

All'interno della pagina del progetto Firebase, nella barra laterale accanto a Panoramica progetto, cliccare sull'icona ingranaggio e selezionare impostazioni progetto.

Suggerimento: annotare l'ID progetto Firebase, poiché sarà necessario durante la configurazione dell'app di marca sulla piattaforma.

Selezionare quindi la scheda Account di servizio e, nella parte inferiore della schermata, cliccare su Genera una nuova chiave privata. Nella finestra di dialogo, confermare cliccando su Genera chiave.

Suggerimento: conservare il file .json scaricato (ad esempio, acnard-test-firebase-adminsdk-33ipy-4cf9aa3e78.json) in un luogo accessibile per la configurazione successiva dell'app di marca sulla piattaforma.

Collegare la propria app Android a Firebase

Nel progetto Firebase, selezionare icona ingranaggio > impostazioni progetto e nella scheda Generale, sotto Le tue app, cliccare su Aggiungi app e successivamente sull'icona Android.

Nel passo 1 - Registra app, inserire nel campo Nome pacchetto Android il packageID della propria app di marca (ad esempio, com.yourcompany.mobile). (Questo valore è reperibile nella Google Play Console. Si rimanda anche al capitolo prerequisiti del presente articolo.)

Cliccare quindi su Registra app.

Nel passo 2 - Scarica e aggiungi il file di configurazione: cliccare su Scarica google-services.json.

Suggerimento: conservare il file in una posizione accessibile per le configurazioni successive.

Cliccare quindi su Avanti.

Nel passo 3 cliccare su Avanti, e nel passo 4 su Continua alla console. La nuova app Android sarà visibile nella sezione Le tue app della console Firebase.

Collegare la propria app iOS a Firebase

Nel progetto Firebase, selezionare icona ingranaggio > impostazioni progetto e nella scheda Generale, sotto Le tue app, cliccare su Aggiungi app e successivamente sull'icona iOS.

Nel passo 1 - Registra app:

• Inserire nel campo ID bundle app il bundleID della propria app di marca (ad esempio, com.yourcompany.mobile).
• Nel campo ID App Store, inserire il codice numerico finale presente nel link del proprio App Store.

(Entrambi i valori sono reperibili su App Store Connect. Si rimanda anche al capitolo prerequisiti del presente articolo.)

Cliccare quindi su Registra app.

Nel passo 2 - Scarica file di configurazione: cliccare su Scarica GoogleService-Info.plist.

Suggerimento: conservare il file in una posizione accessibile per le configurazioni successive.

Cliccare quindi su Avanti.

Nei passaggi 3 e 4 cliccare su Avanti, quindi nel passaggio 5 su Continua alla console. La nuova app iOS sarà visibile nella sezione Le tue app della console Firebase.

Abilitare l'accesso con Google

Procedere con i seguenti passaggi esclusivamente se si desidera abilitare l'accesso tramite Google (utilizzando Gmail o Google Apps) nell'app mobile di marca. In caso contrario, è possibile saltare questo capitolo.

I passaggi da completare per l'accesso con Google includono: ID client Web, ID client iOS (solo per app iOS), impronte digitali del certificato SHA (solo per app Android) e scaricare i file di configurazione più recenti.

ID client Web

Questo passaggio è necessario per abilitare l'accesso con Google sia su app iOS che Android.

Nel progetto Firebase:

1. Dalla barra laterale, selezionare Autenticazione, accedere alla scheda Metodo di accesso e cliccare sull'icona Google.
2. Attivare il toggle su Abilita e inserire un indirizzo email di supporto nel campo Email di supporto per il progetto.
3. Cliccare su Salva.
4. Chiudere la finestra di dialogo Scarica il file di configurazione più recente, poiché i file saranno scaricati in un passaggio successivo.
5. Google sarà ora elencato come provider abilitato. Cliccare sull'icona matita per modificare e espandere la sezione Configurazione SDK Web.

Suggerimento: copiare e conservare il valore presente nel campo ID client Web, poiché sarà necessario durante la configurazione dell'app di marca sulla piattaforma.

ID client iOS

Per abilitare l'accesso con Google sull'app iOS, eseguire i seguenti passaggi aggiuntivi:

1. Cliccare sul link presente nel suggerimento accanto a Configurazione SDK Web per aprire la sezione Credenziali della console API Google.

2. Nella console API Google, sotto la sezione OAuth 2.0 Client IDs:

    

   Suggerimenti:

   • Copiare e conservare il valore dell'ID client relativo all'app iOS, poiché sarà necessario per la configurazione dell'app di marca sulla piattaforma.
   • L'ID client Web è lo stesso precedentemente copiato.

   

Impronte digitali del certificato SHA

Per abilitare l'accesso con Google sull'app Android, è necessario fornire l'impronta digitale SHA-1 del certificato di firma e inserirla nella console Firebase. Si consiglia di consultare anche le istruzioni presenti nella guida per sviluppatori Google su Autenticazione del client (si apre in una nuova scheda).

Metodo 1: Ottenere l'impronta SHA-1 dalla Google Play Console

Se l'app è stata pubblicata utilizzando Play App Signing – metodo raccomandato e obbligatorio per l'utilizzo di Android App Bundle – è possibile ottenere l'impronta SHA-1 dalla Google Play Console come segue:

Accedere alla Google Play Console, selezionare l'app desiderata e visualizzare la pagina Play App Signing sotto Release > Setup > App signing. Copiare l'impronta digitale certificato SHA-1 da questa sezione.

Metodo 2: Ottenere l'impronta SHA-1 tramite keytool

Per ottenere l'impronta digitale SHA-1 del certificato, aprire un terminale ed eseguire l'utility keytool fornita con Java.

keytool -list -v -keystore ./yourcompany.keystore

L'utility keytool richiederà l'inserimento della password del keystore, impostata al momento della sua creazione. Successivamente, l'impronta digitale verrà visualizzata nel terminale.

1. Copiare l'impronta digitale ottenuta tramite keytool.
2. Nella Google Play Console:
   • Selezionare Setup > App signing e accedere alla scheda Firma app.
   • Nella sezione Certificato chiave firma app, incollare l'impronta digitale precedentemente copiata nel campo Impronta digitale certificato SHA-1.

Inserire l'impronta digitale SHA-1 nella console Firebase:

Una volta ottenuta l'impronta digitale SHA-1 con uno dei metodi descritti, il passaggio finale consiste nell'inserirla nella console Firebase.

Nella Console Firebase:

1. Selezionare icona ingranaggio > impostazioni progetto > scheda generale. Scorrere fino alla sezione Le tue app e selezionare l'app Android.
2. Cliccare su Aggiungi impronta digitale e incollare l'impronta digitale SHA-1 precedentemente copiata.

Nota: qualora sia stata già rilasciata una versione dell'app di marca, l'impronta digitale sarà già presente nel campo Impronta digitale certificato SHA-1. In ogni caso, è opportuno verificare che il campo sia correttamente popolato con l'impronta digitale ottenuta.

Scaricare i file di configurazione più recenti

Questo rappresenta il passaggio conclusivo per l'abilitazione dell'accesso con Google.

Nel progetto Firebase, scaricare i file di configurazione più aggiornati, i quali sostituiranno quelli precedentemente scaricati durante l'aggiunta delle app a Firebase:

1. Selezionare icona ingranaggio > impostazioni progetto > scheda generale.
2. Scorrere fino alla sezione Le tue app.
3. Selezionare l'app Android e scaricare l'ultima versione del file google-services.json.
4. Selezionare l'app iOS e scaricare l'ultima versione del file GoogleService-Info.plist.

Configurare la chiave Apple Push Notification service (APNs) per iOS

Eseguire le seguenti operazioni esclusivamente se si sta configurando il servizio di notifiche push per un'app di marca iOS. In caso contrario, è possibile saltare questo capitolo.

Per poter inviare notifiche push ai dispositivi iOS, è necessario creare una chiave di autenticazione APNs (Apple Push Notifications service) nella Apple Developer Console, associarla all'app iOS e infine caricare la chiave privata nelle impostazioni del progetto Firebase. Si precisa che la stessa chiave privata è utilizzata per tutte le app.

Ottenere il proprio Team ID:

1. Accedere alla Apple Developer Console.
2. Navigare alla sezione Membership dal menu laterale.
3. Copiare il valore Team ID dai dettagli della Membership.

Questo valore sarà necessario successivamente per la configurazione in Firebase.

Creare la chiave APNs:

1. Nella Apple Developer Console, cliccare su Certificates, Identifiers & Profiles.
2. Selezionare Keys e cliccare sul pulsante + in alto a destra per creare una nuova chiave.
3. Inserire un nome per la chiave APNS Auth e selezionare l'opzione Apple Push Notification Service (APNs).
4. Cliccare su Continua, verificare le informazioni e confermare con Conferma.
5. Cliccare su Scarica per ottenere il file della chiave di autenticazione. Annotare e conservare il Key ID, che sarà necessario in seguito.
   

Nota importante: il file della chiave può essere scaricato una sola volta. Si raccomanda di salvarlo adeguatamente e di effettuare una copia di backup. Non rinominare il file.

Abilitare la capacità di notifiche push per il proprio ID app iOS:

1. In Certificates, Identifiers & Profiles, selezionare Identifiers nella barra laterale.
2. Visualizzare i dettagli dell'app cliccando sul relativo ID app.
3. Nella scheda Capabilities, scorrere verso il basso e selezionare la capacità Push Notifications.
4. Salvare le modifiche.

Rigenerare il profilo di provisioning:

1. In Certificates, Identifiers & Profiles, selezionare Profiles nella barra laterale.
2. Nella sezione Provisioning Profiles, selezionare il profilo di provisioning non valido o scaduto e cliccare su Modifica.
3. Cliccare su Genera.

Caricare la chiave APNs su Firebase:

Accedere alla Firebase Console:

1. Cliccare su icona ingranaggio > Impostazioni progetto e selezionare la scheda Cloud Messaging.
2. Scorrere fino alla sezione Configurazione app Apple.
3. Nella sezione Chiave di autenticazione APNs, cliccare su Carica e caricare la chiave precedentemente scaricata dalla Apple Developer Console, quindi compilare i campi Key ID e Team ID.
4. Al termine, cliccare su Carica. Il progetto Firebase sarà così collegato all'app nella Apple Developer Console.

Riepilogo delle impostazioni del publisher per app mobile di marca

Il presente capitolo riassume come le configurazioni Firebase descritte vengono integrate nel publisher per app mobile di marca sulla piattaforma.

Passi successivi

Una volta completata la configurazione di tutti i servizi Firebase necessari per la propria app mobile di marca, è possibile procedere (o tornare) alla configurazione dell'app nel publisher per app mobile di marca.