Aggiungere Firebase al progetto C++

Migliora i tuoi giochi C++ con i nostri SDK Firebase C++, che forniscono un'interfaccia C++ sopra gli SDK Firebase.

Accedi a Firebase interamente dal tuo codice C++, senza dover scrivere codice nativo della piattaforma. L'SDK Firebase traduce anche molti modi di dire specifici della lingua utilizzati da Firebase in un'interfaccia più familiare agli sviluppatori C++.

Scopri di più su come migliorare i tuoi giochi con Firebase nella nostra pagina dei giochi di Firebase.

Hai già aggiunto Firebase al tuo progetto C++? Assicurati di utilizzare l'ultima versione dell'SDK Firebase C++.


Prerequisiti

  • Installa quanto segue:

    • Xcode 26.2 o versioni successive
    • CocoaPods 1.12.0 o versioni successive

  • Assicurati che il tuo progetto abbia come target le seguenti versioni della piattaforma o versioni successive:

    • iOS 15
    • tvOS 15

  • Configura un dispositivo fisico o usa il simulatore per eseguire l'app.

  • Accedi a Firebase utilizzando il tuo Account Google.

Passaggio 2: crea un progetto Firebase

Prima di poter aggiungere Firebase al tuo progetto C++, devi creare un progetto Firebase a cui connetterti. Visita la pagina Informazioni sui progetti Firebase per scoprire di più sui progetti Firebase.

Passaggio 3: registra la tua app con Firebase

Per utilizzare Firebase nella tua app Apple, devi registrarla nel tuo progetto Firebase. La registrazione dell'app viene spesso chiamata "aggiunta" dell'app al progetto.

  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 pacchetto della tua app nel campo ID pacchetto.

  4. (Facoltativo) Inserisci altre informazioni sull'app: Nickname dell'app e ID App Store.

  5. Fai clic su Registra app.

Passaggio 4: aggiungi il file di configurazione di Firebase

  1. Fai clic su Scarica GoogleService-Info.plist per ottenere il file di configurazione delle piattaforme Apple di Firebase.

  2. Apri il progetto C++ in un IDE, quindi trascina il file di configurazione nella radice del progetto C++.

  3. Se richiesto, seleziona l'opzione per aggiungere il file di configurazione a tutti i target.

Hai completato le attività di configurazione nella console Firebase. Continua ad aggiungere gli SDK Firebase C++ di seguito.

Passaggio 5: aggiungi gli SDK Firebase C++

I passaggi descritti in questa sezione sono un esempio di come aggiungere prodotti Firebase supportati al tuo progetto Firebase C++.

  1. Scarica l'SDK Firebase C++, quindi decomprimilo in un percorso semplice da raggiungere.

    L'SDK Firebase C++ non è specifico per la piattaforma, ma contiene librerie specifiche per la piattaforma.

  2. Aggiungi i pod di Firebase dall'SDK decompresso.

    1. Crea un Podfile se non ne hai già uno: 

      cd your-app-directory
       
      pod init

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

      Analytics abilitato 

      # Add the Firebase pod for Google Analytics
pod 'FirebaseAnalytics'
      
# Add the pods for any other Firebase products you want to use in your app
# For example, to use Firebase Authentication and Firebase Realtime Database
pod 'FirebaseAuth'
pod 'FirebaseDatabase'

      Analytics non abilitato 

      # Add the pods for the Firebase products you want to use in your app
# For example, to use Firebase Authentication and Firebase Realtime Database
pod 'FirebaseAuth'
pod 'FirebaseDatabase'

    3. Installa i pod, quindi apri il file .xcworkspace in Xcode. 

      pod install
       
      open your-app.xcworkspace

  3. Aggiungi i framework Firebase dall'SDK decompresso.

    Il modo più semplice per aggiungere questi framework è in genere trascinarli da una finestra Finder direttamente nel riquadro Project Navigator di Xcode (il riquadro all'estrema sinistra per impostazione predefinita; in alternativa, fai clic sull'icona del file in alto a sinistra di Xcode).

    1. Aggiungi il framework Firebase C++ firebase.framework, che è obbligatorio per utilizzare qualsiasi prodotto Firebase.

    2. Aggiungi il framework per ogni prodotto Firebase che vuoi utilizzare. Ad esempio, per utilizzare Firebase Authentication, aggiungi firebase_auth.framework.

  4. Nella console Firebase, nel flusso di lavoro di configurazione, fai clic su Avanti.

  5. Se hai aggiunto Analytics, esegui l'app per inviare la verifica a Firebase che hai integrato correttamente Firebase. In caso contrario, puoi saltare questo passaggio di verifica.

    I log del dispositivo mostreranno la verifica Firebase che l'inizializzazione è stata completata. Se hai eseguito l'app su un emulatore con accesso alla rete, la console Firebase ti avvisa che la connessione dell'app è stata completata.

Ecco fatto! La tua app C++ è registrata e configurata per utilizzare i prodotti Firebase.

Librerie disponibili

Scopri di più sulle librerie Firebase C++ nella documentazione di riferimento e nella nostra release dell'SDK open source su GitHub.

Librerie disponibili per le piattaforme Apple

Tieni presente che le librerie C++ per Android sono elencate nella versione Android di questa pagina di configurazione.

Ogni prodotto Firebase ha dipendenze diverse. Assicurati di aggiungere tutte le dipendenze elencate per il prodotto Firebase desiderato al tuo podfile e al tuo progetto C++.

Ogni prodotto Firebase potrebbe supportare solo una selezione di piattaforme OS Apple (iOS, tvOS e così via). Controlla quali piattaforme sono supportate da ogni libreria in Scopri di più su C++ e Firebase.

Prodotto Firebase Framework e pod
Analytics (obbligatorio) firebase.framework
firebase_analytics.framework

pod 'FirebaseAnalytics', '12.19.0'
App Check (obbligatorio) firebase.framework
firebase_app_check.framework

pod 'FirebaseAppCheck', '12.19.0'
Authentication (obbligatorio) firebase.framework
firebase_auth.framework

pod 'FirebaseAuth', '12.19.0'
Cloud Firestore (obbligatorio) firebase.framework
firebase_firestore.framework
firebase_auth.framework

pod 'FirebaseFirestore', '12.19.0'