Aggiungere notifiche push a un'app per iOS

1. Introduzione

Ultimo aggiornamento: 2020-1-6

Firebase Cloud Messaging (FCM) è una soluzione di messaggistica multipiattaforma che ti consente di inviare messaggi in modo affidabile e senza costi.

Utilizzando FCM, puoi comunicare a un'app client che sono disponibili nuove email o altri dati da sincronizzare. Puoi inviare messaggi di notifica per favorire il coinvolgimento e la fidelizzazione degli utenti. Per casi d'uso come la messaggistica istantanea, un messaggio può trasferire un payload fino a 4 KB a un'app client.

Come funziona?

Un'implementazione di FCM include due componenti principali per l'invio e la ricezione:

1. Un ambiente attendibile come Cloud Functions for Firebase o un server delle app su cui creare, scegliere come target e inviare messaggi.
2. Un'app client iOS, Android o web (JavaScript) che riceve messaggi tramite il servizio di trasporto specifico della piattaforma corrispondente.

Panoramica dell'architettura di FCM

FCM si basa sul seguente insieme di componenti che creano, trasportano e ricevono i messaggi:

1. Strumenti per comporre o creare richieste di messaggi. Notifications Composer offre un'opzione basata su GUI per la creazione di richieste di notifica. Per l'automazione completa e il supporto di tutti i tipi di messaggi, devi creare richieste di messaggi in un ambiente server attendibile che supporti l'SDK Firebase Admin o i protocolli server FCM. Questo ambiente potrebbe essere Cloud Functions for Firebase, Google App Engine o il tuo server delle app.
2. Il backend FCM, che (tra le altre funzioni) accetta le richieste di messaggi, esegue la distribuzione dei messaggi tramite argomenti e genera metadati dei messaggi come l'ID messaggio.
3. Un livello di trasporto a livello di piattaforma, che indirizza il messaggio al dispositivo di destinazione, gestisce la consegna dei messaggi e applica la configurazione specifica della piattaforma, se appropriato. Questo livello di trasporto include:

• Livello di trasporto Android (ATL) per dispositivi Android con Google Play Services
• Servizio di notifiche push di Apple (APNS) per i dispositivi iOS
• Protocollo web push per le app web

Nota:i livelli di trasporto a livello di piattaforma non fanno parte del servizio FCM. I messaggi FCM indirizzati a un livello di trasporto a livello di piattaforma potrebbero essere soggetti a termini specifici per quella piattaforma anziché ai Termini di servizio di FCM. Il routing dei messaggi Android tramite ATL è soggetto ai Termini di servizio delle API di Google.

4. L'SDK FCM sul dispositivo dell'utente, in cui viene visualizzata la notifica o il messaggio viene gestito in base allo stato di primo piano/background dell'app e a qualsiasi logica dell'applicazione pertinente.

Cosa creerai

In questo codelab, aggiungerai le notifiche push a un'app per iOS di esempio con FCM.

Cosa imparerai a fare

• Come iscrivere e annullare l'iscrizione di un utente ai messaggi push
• Come gestire i messaggi push in arrivo
• Come visualizzare una notifica
• Come rispondere ai clic sulle notifiche

Che cosa ti serve

• Xcode 11.0 o versioni successive
• CocoaPods 1.9.0 o versioni successive
• Account sviluppatore Apple
• Un dispositivo iOS fisico su cui eseguire l'app
• Conoscenza di base di Swift

2. Preparazione

Scaricare il codice campione

In questo codelab creerai la tua app di test, ma se vuoi visualizzare ed eseguire l'app di esempio esistente, puoi scaricare il codice di esempio della guida rapida.

Esistono due modi per ottenere il campione:

• Clona il repository Git:

$ git clone https://github.com/firebase/quickstart-ios.git

• Scarica il file ZIP:

Se scarichi l'origine come file ZIP, quando lo decomprimi ottieni una cartella principale quickstart-ios.

Scarica il codice sorgente

Creare una nuova app

Crea la tua app di test seguendo questi passaggi (i passaggi riportati di seguito sono in XCode 12.3):

1. Apri Xcode e seleziona Create a new Xcode project (Crea un nuovo progetto Xcode).
2. Seleziona App e fai clic su Avanti.

3. Inserisci il Nome prodotto (ad es. MessagingExample)
4. Seleziona Team (se non hai creato un team, configuralo nell'account sviluppatore Apple).
5. Inserisci l'identificatore organizzazione (ad es. com.your-name)
6. Inserisci l'identificatore bundle (ad es. com.your-name.MessagingExample, deve essere univoco tra tutte le app per iOS).
7. Seleziona Storyboard nel menu a discesa Interfaccia.
8. Seleziona Delegato app UIKit nel menu a discesa Ciclo di vita.
9. Seleziona Swift in Lingua.
10. Fai clic su Avanti.

Avrai bisogno dell'identificatore bundle quando crei una chiave APN e registri la tua app nel progetto Firebase.

3. Configurazione di APN

Creare la chiave di autenticazione

Questa sezione descrive come generare una chiave di autenticazione per un ID app abilitato per le notifiche push. Se hai una chiave esistente, puoi utilizzarla anziché generarne una nuova.

Per creare una chiave di autenticazione:

1. Nel tuo account sviluppatore, vai a Certificates, Identifiers & Profiles (Certificati, identificatori e profili) e poi a Keys (Chiavi).

2. Fai clic sul pulsante Aggiungi (+) nell'angolo in alto a destra.

3. Inserisci una descrizione per la chiave di autenticazione del servizio APN
4. In Servizi chiavi, seleziona la casella di controllo APN e fai clic su Continua.

5. Fai clic su Registrati e poi su Scarica. Salva la chiave in un luogo sicuro. Si tratta di un download una tantum e la chiave non può essere recuperata in un secondo momento.

Creare un ID app

Un ID app è un identificatore che identifica in modo univoco un'app. Per convenzione, è rappresentato da un dominio invertito.

1. Vai al Centro membri di Apple Developer e accedi.
2. Vai a Certificati, identificatori e profili.
3. Vai a Identificatori.
4. Fai clic sul pulsante + per creare un nuovo ID app.
5. Seleziona il pulsante di opzione ID app e fai clic su Continua.

6. Seleziona App e fai clic su Continua.

7. Per creare il nuovo ID app:
8. Inserisci un nome per l'ID app.
9. Inserisci un ID team. Questo valore deve corrispondere all'ID team nella scheda Abbonamento.
10. Nella sezione Suffisso ID app, seleziona ID app esplicito, quindi inserisci l'ID bundle.
11. Nella sezione Servizi app, assicurati che l'opzione Notifiche push sia selezionata.
12. Fai clic su Continua e verifica che l'input sia corretto:
13. Il valore di Identifier deve corrispondere alla concatenazione dei valori di Team ID e Bundle ID
14. Le notifiche push devono essere configurabili
15. Fai clic su Registra per creare l'ID app.

Creare il profilo

Per testare l'app durante lo sviluppo, devi disporre di un profilo per lo sviluppo per autorizzare i tuoi dispositivi a eseguire un'app non ancora pubblicata sull'App Store.

1. Vai al Centro membri di Apple Developer e accedi.
2. Vai a Certificati, identificatori e profili.
3. Nel menu a discesa nell'angolo in alto a sinistra, seleziona iOS, tvOS, watchOS se non è già selezionato, poi vai a Profili.
4. Fai clic sul pulsante + per creare un nuovo profilo.
5. Seleziona Sviluppo di app per iOS come tipo di profilo di provisioning, poi fai clic su Continua.

6. Nel menu a discesa, seleziona l'ID app che vuoi utilizzare, poi fai clic su Continua.
7. Seleziona il certificato di sviluppo iOS dell'ID app che hai scelto nel passaggio precedente, quindi fai clic su Continua.
8. Seleziona i dispositivi iOS da includere nel profilo di provisioning, quindi fai clic su Continua. Assicurati di selezionare tutti i dispositivi che vuoi utilizzare per i test.
9. Inserisci un nome per questo profilo di provisioning (ad es. MessagingExampleProfile), quindi fai clic su Genera.

10. Fai clic su Scarica per salvare il profilo di provisioning sul tuo Mac.

11. Fai doppio clic sul file del profilo di provisioning per installarlo.

4. Aggiungere Firebase al tuo progetto iOS

Crea un progetto Firebase

Prima di poter aggiungere Firebase alla tua app per iOS, devi creare un progetto Firebase a cui connetterti. Visita la pagina Informazioni sui progetti Firebase per saperne di più.

1. Nella console Firebase, fai clic su Aggiungi progetto, quindi seleziona o inserisci un nome progetto.

Se hai un progetto Google Cloud Platform (GCP) esistente, puoi selezionarlo dal menu a discesa per aggiungere risorse Firebase.

2. (Facoltativo) Se stai creando un nuovo progetto, puoi modificare l'ID progetto.

Firebase assegna automaticamente un ID univoco al tuo progetto Firebase. Visita la pagina Informazioni sui progetti Firebase per scoprire come Firebase utilizza l'ID progetto.

Nota:dopo che Firebase ha eseguito il provisioning delle risorse per il tuo progetto Firebase, non puoi modificare l'ID progetto. Per utilizzare un identificatore specifico, devi modificare l'ID progetto durante questo passaggio di configurazione.

3. Fai clic su Continua.
4. Configura Google Analytics per il tuo progetto, in modo da avere un'esperienza ottimale utilizzando uno dei seguenti prodotti Firebase:

• Firebase Crashlytics
• Firebase Predictions
• Firebase Cloud Messaging
• Messaggistica in-app Firebase
• Firebase Remote Config
• Firebase A/B Testing

Quando ti viene chiesto, seleziona l'opzione per utilizzare un account Google Analytics esistente o per crearne uno nuovo. Se scegli di creare un nuovo account, seleziona la posizione dei report di Analytics, quindi accetta le impostazioni di condivisione dei dati e i termini di Google Analytics per il tuo progetto.

5. Fai clic su Crea progetto (o Aggiungi Firebase, se utilizzi un progetto Google Cloud esistente).

Firebase esegue automaticamente il provisioning delle risorse per il tuo progetto Firebase. Al termine della procedura, verrà visualizzata la pagina Panoramica del progetto Firebase nella console Firebase.

Registrare l'app con Firebase

Non appena disponi di un progetto Firebase, puoi aggiungervi la tua app iOS.

Visita la pagina Informazioni sui progetti Firebase per scoprire di più sulle best practice e sulle considerazioni da fare per aggiungere app a un progetto Firebase, incluso come gestire più varianti di build.

1. Vai alla console Firebase.
2. Al centro della pagina di riepilogo del progetto, fai clic sull'icona iOS per avviare il flusso di lavoro della configurazione.

Se hai già aggiunto un'app al tuo progetto Firebase, fai clic su Aggiungi app per visualizzare le opzioni della piattaforma.

3. Inserisci l'ID gruppo della tua app nel campo ID gruppo iOS.
4. (Facoltativo) Inserisci altre informazioni sull'app: Nickname dell'app e ID App Store.
5. Fai clic su Registra app.

Aggiungere un file di configurazione di Firebase

1. Fai clic su Scarica GoogleService-Info.plist per ottenere il file di configurazione Firebase iOS (GoogleService-Info.plist).
2. Sposta il file di configurazione nella root del progetto Xcode. Se richiesto, seleziona l'opzione per aggiungere il file di configurazione a tutti i target.

Se nel tuo progetto sono presenti più ID bundle, devi associare ogni ID bundle a un'app registrata nella console Firebase in modo che ogni app possa avere il proprio file GoogleService-Info.plist.

Chiudi Xcode.

Aggiungi gli SDK Firebase alla tua app

Ti consigliamo di utilizzare CocoaPods per installare le librerie Firebase. Tuttavia, se preferisci non utilizzare CocoaPods, puoi integrare direttamente i framework dell'SDK o utilizzare la versione beta di Swift Package Manager.

1. Crea un Podfile se non ne hai già uno. Se utilizzi l'esempio di avvio rapido, il progetto Xcode e il Podfile (con i pod) sono già presenti.

$ cd MessagingExample
$ pod init

2. Al podfile, aggiungi i pod Firebase che vuoi utilizzare nella tua app.

Puoi aggiungere uno qualsiasi dei prodotti Firebase supportati alla tua app per iOS.

Nell'esempio di avvio rapido sono stati aggiunti gli SDK Google Analytics e Firebase Cloud Messaging.

# Add the Firebase pod for Google Analytics
pod 'Firebase/Analytics'

# Add the pod for Firebase Cloud Messaging
pod 'Firebase/Messaging'

3. Installa i pod, quindi apri il file .xcworkspace per visualizzare il progetto in Xcode:

$ pod install

4. Apri MessagingExample.xcworkspace e fai clic su Avanti nella console Firebase.

Inizializza Firebase nella tua app

Dovrai aggiungere il codice di inizializzazione di Firebase alla tua applicazione.

Importa il modulo Firebase e configura un'istanza condivisa (nell'esempio di avvio rapido, il modulo Firebase è già importato).

1. Importa il modulo Firebase nel tuo UIApplicationDelegate:

AppDelegate.swift

import UIKit
import Firebase // Add this line

2. Configura un'istanza condivisa di FirebaseApp, in genere nel metodo application:didFinishLaunchingWithOptions: della tua app:

AppDelegate.swift

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
  FirebaseApp.configure() // Add this line
  return true
}

3. Fai clic su Avanti nella console Firebase.
4. Gli SDK Firebase vengono aggiunti alla tua app. Fai clic su Continua alla console.

5. Configurazione del client FCM

Caricare la chiave di autenticazione del servizio APN

Carica la chiave di autenticazione del servizio APN su Firebase.

1. All'interno del progetto nella console Firebase, seleziona l'icona a forma di ingranaggio, seleziona Impostazioni progetto e poi la scheda Cloud Messaging.

2. In Chiave di autenticazione del servizio APN nella sezione Configurazione dell'app Apple, fai clic sul pulsante Carica per caricare la chiave di autenticazione di sviluppo, la chiave di autenticazione di produzione o entrambe. È obbligatorio indicarne almeno uno.

3. Sfoglia fino alla posizione in cui hai salvato la chiave, selezionala e fai clic su Apri. Aggiungi l'ID chiave (disponibile in Certificati, identificatori e profili nel Member Center di Apple Developer) e fai clic su Carica.

Registrarsi per le notifiche da remoto

All'avvio o nel punto desiderato del flusso dell'applicazione, registra l'app per le notifiche remote.

Nell'esempio di guida rapida, registerForRemoteNotifications è già stato aggiunto.

AppDelegate.swift

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
  FirebaseApp.configure()
  // [START register for remote notifications]
  if #available(iOS 10.0, *) {
    // For iOS 10 display notification (sent via APNS)
    UNUserNotificationCenter.current().delegate = self
        
    let authOptions: UNAuthorizationOptions = [.alert, .badge, .sound]
    UNUserNotificationCenter.current().requestAuthorization(options: authOptions, completionHandler: {_, _ in })
  } else {
    let settings: UIUserNotificationSettings = UIUserNotificationSettings(types: [.alert, .badge, .sound], categories: nil)
    application.registerUserNotificationSettings(settings)
  }

  application.registerForRemoteNotifications()
  // [END register for remote notifications]
  return true
}

Assegna la proprietà del delegato di UNUserNotificationCenter aggiungendo queste righe alla fine di AppDelegate.swift.

AppDelegate.swift

@available(iOS 10, *)
extension AppDelegate : UNUserNotificationCenterDelegate {

  // Receive displayed notifications for iOS 10 devices.
  func userNotificationCenter(_ center: UNUserNotificationCenter,
                              willPresent notification: UNNotification,
    withCompletionHandler completionHandler: @escaping (UNNotificationPresentationOptions) -> Void) {
    let userInfo = notification.request.content.userInfo

    // Print full message.
    print(userInfo)

    // Change this to your preferred presentation option
    completionHandler([[.alert, .sound]])
  }

  func userNotificationCenter(_ center: UNUserNotificationCenter,
                              didReceive response: UNNotificationResponse,
                              withCompletionHandler completionHandler: @escaping () -> Void) {
    let userInfo = response.notification.request.content.userInfo

    // Print full message.
    print(userInfo)

    completionHandler()
  }
}

Impostare il delegato per i messaggi

Per ricevere i token di registrazione, implementa il protocollo di delega dei messaggi e imposta la proprietà delegate di FIRMessaging dopo aver chiamato [FIRApp configure]. Ad esempio, se il delegato dell'applicazione è conforme al protocollo del delegato di messaggistica, puoi impostare il delegato su application:didFinishLaunchingWithOptions: (nell'esempio di avvio rapido è già impostato).

AppDelegate.swift

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
  FirebaseApp.configure()
  Messaging.messaging().delegate = self // Add this line
  // [START register for remote notifications]
  if #available(iOS 10.0, *) {
    // For iOS 10 display notification (sent via APNS)
    UNUserNotificationCenter.current().delegate = self
        
    let authOptions: UNAuthorizationOptions = [.alert, .badge, .sound]
    UNUserNotificationCenter.current().requestAuthorization(options: authOptions, completionHandler: {_, _ in })
  } else {
    let settings: UIUserNotificationSettings = UIUserNotificationSettings(types: [.alert, .badge, .sound], categories: nil)
    application.registerUserNotificationSettings(settings)
  }

  application.registerForRemoteNotifications()
  // [END register for remote notifications]
  return true
}

Assegna la proprietà del delegato di FIRMessaging aggiungendo queste righe alla fine di AppDelegate.swift.

AppDelegate.swift

extension AppDelegate : MessagingDelegate {
  func messaging(_ messaging: Messaging, didReceiveRegistrationToken fcmToken: String?) {
    print("Firebase registration token: \(String(describing: fcmToken))")
    
    let dataDict:[String: String] = ["token": fcmToken ?? ""]
    NotificationCenter.default.post(name: Notification.Name("FCMToken"), object: nil, userInfo: dataDict)
  }
}

Aggiungere funzionalità

Hai aggiunto la funzionalità Notifiche push nella sezione Crea un ID app, ma devi aggiungerla anche in Xcode seguendo questi passaggi (i passaggi riportati di seguito sono in Xcode 12.3):

1. Fai clic sul nome del progetto nell'area di navigazione.
2. Fai clic su Signing & Capabilities (Firma e funzionalità).
3. Fai clic su + Funzionalità.

4. Fai doppio clic su Modalità in background.
5. Fai di nuovo clic su + Funzionalità.
6. Fai doppio clic su Notifiche push.
7. Controlla Notifiche da remoto nelle sezioni Modalità in background.

6. Inviare un messaggio di notifica

Per inviare un messaggio di prova, segui questi passaggi:

1. Installa ed esegui l'app sul dispositivo di destinazione. Dovrai accettare la richiesta di autorizzazione per ricevere notifiche da remoto.
2. Ottieni il token di registrazione nel log di Xcode.

3. Assicurati che l'app sia in background sul dispositivo.
4. Apri lo strumento di composizione delle notifiche e seleziona Nuova notifica.
5. Inserisci il testo del messaggio.
6. Seleziona Invia messaggio di prova.
7. Nel campo etichettato Aggiungi un token di registrazione FCM, inserisci il token di registrazione ottenuto nel passaggio 2.
8. Fai clic su Testa.

Dopo aver fatto clic su Test, il dispositivo client di destinazione (con l'app in background) dovrebbe ricevere la notifica nel centro notifiche.

Per informazioni sulla distribuzione dei messaggi alla tua app, consulta la dashboard dei report FCM, che registra il numero di messaggi inviati e aperti su dispositivi iOS e Android.

7. Complimenti

Congratulazioni, hai inviato correttamente un messaggio di test.

In FCM sono disponibili molte altre funzioni e configurazioni, ad esempio l'iscrizione agli argomenti.

Se ti interessano, consulta la documentazione ufficiale per sviluppatori.

Passaggi successivi

Dai un'occhiata ad alcuni di questi codelab.

• Advanced Android in Kotlin 01.2:Android Firebase Cloud Messaging

Further reading

• Documento ufficiale di Firebase Cloud Messaging