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 idiomi 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 l'editor o l'IDE che preferisci, ad esempio Android Studio, IntelliJ o VS Code.

  • Ottieni l'SDK Android.

  • Assicurati che il tuo progetto soddisfi i seguenti requisiti:

    • Ha come target il livello API 21 (Lollipop) o versioni successive

    • Utilizza Gradle ed è configurato con CMake

  • Configura un dispositivo fisico o utilizza un emulatore per eseguire l'app.

    • Emulatori devono utilizzare un'immagine dell'emulatore con Google Play.

    • Per alcune librerie C++, Google Play Services è necessario sul dispositivo client. Consulta l'elenco in questa pagina.

  • 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 per Android, devi registrare l'app con il 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 Android () o su Aggiungi app per avviare il flusso di lavoro della configurazione.

  3. Inserisci il nome del pacchetto della tua app nel campo Nome del pacchetto Android.

  4. (Facoltativo) Inserisci altre informazioni sull'app: Nickname dell'app e Certificato SHA-1 per la firma di debug.

  5. Fai clic su Registra app.

Passaggio 4: aggiungi il file di configurazione di Firebase

  1. Fai clic su Scarica google-services.json per ottenere il file di configurazione Firebase Android.

  2. Apri il progetto C++ in un IDE, quindi aggiungi il file di configurazione al progetto:

  3. (Solo build Gradle) Per attivare i servizi Firebase nel tuo progetto C++, aggiungi il plug-in google-services al file build.gradle di primo livello.

    1. Aggiungi regole per includere il plug-in Gradle dei servizi Google. Verifica di avere anche il repository Maven di Google.

        buildscript {

    repositories {
      // Check that you have the following line (if not, add it):
      google()  // Google's Maven repository
    }

    dependencies {
      // ...

      // Add the following lines:
      classpath 'com.google.gms:google-services:4.4.3'  // Google Services plugin
      implementation 'com.google.android.gms:18.7.2'
    }
  }

  allprojects {
    // ...

    repositories {
      // Check that you have the following line (if not, add it):
      google()  // Google's Maven repository
      // ...
    }
  }

    2. Applica il plug-in Gradle dei servizi Google:

        apply plugin: 'com.android.application'
  // Add the following line:
  apply plugin: 'com.google.gms.google-services'  // Google Services plugin

  android {
    // ...
  }

  4. 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. Nel file gradle.properties del progetto, specifica la posizione dell'SDK decompresso:

    systemProp.firebase_cpp_sdk.dir=full-path-to-SDK

  3. Aggiungi i seguenti contenuti al file settings.gradle del progetto:

    def firebase_cpp_sdk_dir = System.getProperty('firebase_cpp_sdk.dir')

gradle.ext.firebase_cpp_sdk_dir = "$firebase_cpp_sdk_dir"
includeBuild "$firebase_cpp_sdk_dir"

  4. Al file Gradle del modulo (a livello di app, di solito app/build.gradle), aggiungi i seguenti contenuti.
    Includi le dipendenze delle librerie per i prodotti Firebase che vuoi utilizzare nella tua app.

    Analytics abilitato 

    android.defaultConfig.externalNativeBuild.cmake {
arguments "-DFIREBASE_CPP_SDK_DIR=$gradle.firebase_cpp_sdk_dir"
}

# Add the dependencies for the Firebase products you want to use in your app
# For example, to use Analytics, Firebase Authentication, and Firebase Realtime Database
apply from: "$gradle.firebase_cpp_sdk_dir/Android/firebase_dependencies.gradle"
firebaseCpp.dependencies {
  analytics
  auth
  database
}

    Analytics non abilitato 

    android.defaultConfig.externalNativeBuild.cmake {
arguments "-DFIREBASE_CPP_SDK_DIR=$gradle.firebase_cpp_sdk_dir"
}

# Add the dependencies for the Firebase products you want to use in your app
# For example, to use Firebase Authentication and Firebase Realtime Database
apply from: "$gradle.firebase_cpp_sdk_dir/Android/firebase_dependencies.gradle"
firebaseCpp.dependencies {
  auth
  database
}

  5. Aggiungi i seguenti contenuti al file CMakeLists.txt del progetto.
    Includi le librerie per i prodotti Firebase che vuoi utilizzare nella tua app.

    Analytics abilitato 

    # Add Firebase libraries to the target using the function from the SDK.
add_subdirectory(${FIREBASE_CPP_SDK_DIR} bin/ EXCLUDE_FROM_ALL)

# The Firebase C++ library `firebase_app` is required,
# and it must always be listed last.

# Add the Firebase SDKs for the products you want to use in your app
# For example, to use Analytics, Firebase Authentication, and Firebase Realtime Database
set(firebase_libs
  firebase_analytics
  firebase_auth
  firebase_database
  firebase_app
)
target_link_libraries(${target_name} "${firebase_libs}")

    Analytics non abilitato 

    # Add Firebase libraries to the target using the function from the SDK.
add_subdirectory(${FIREBASE_CPP_SDK_DIR} bin/ EXCLUDE_FROM_ALL)

# The Firebase C++ library `firebase_app` is required,
# and it must always be listed last.

# Add the Firebase SDKs for the products you want to use in your app
# For example, to use Firebase Authentication and Firebase Realtime Database
set(firebase_libs
  firebase_auth
  firebase_database
  firebase_app
)
target_link_libraries(${target_name} "${firebase_libs}")

  6. Sincronizza la tua app per assicurarti che tutte le dipendenze abbiano le versioni necessarie.

  7. Se hai aggiunto Analytics, esegui l'app per inviare la verifica a Firebase che hai integrato correttamente Firebase. In caso contrario, puoi saltare il 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.

È tutto pronto. La tua app C++ è registrata e configurata per utilizzare i servizi 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 Android (utilizzando CMake)

Tieni presente che le librerie C++ per le piattaforme Apple sono elencate nella versione per piattaforme Apple (iOS+) di questa pagina di configurazione.

Prodotto Firebase Riferimenti alla libreria
(firebaseCpp.dependencies
per il file build.gradle)		 Riferimenti alla libreria
(firebase_libs
per il file CMakeLists.txt)
AdMob admob firebase_admob
(obbligatorio) firebase_analytics
(obbligatorio) firebase_app
Analytics analytics firebase_analytics
(obbligatorio) firebase_app
App Check appCheck firebase_app_check
(obbligatorio) firebase_app
Authentication auth firebase_auth
(obbligatorio) firebase_app
Cloud Firestore firestore firebase_firestore
(obbligatorio) firebase_auth
(obbligatorio) firebase_app
Cloud Functions functions firebase_functions
(obbligatorio) firebase_app
Cloud Messaging messaging firebase_messaging
(consigliato) firebase_analytics
(obbligatorio) firebase_app
Cloud Storage storage firebase_storage
(obbligatorio) firebase_app
Dynamic Links dynamicLinks firebase_dynamic_links
(consigliato) firebase_analytics
(obbligatorio) firebase_app
Realtime Database database firebase_database
(obbligatorio) firebase_app
Remote Config remoteConfig firebase_remote_config
(consigliato) firebase_analytics
(obbligatorio) firebase_app

Informazioni aggiuntive per la configurazione mobile

Ottenere report sugli arresti anomali dell'NDK

Firebase Crashlytics supporta la segnalazione degli arresti anomali per le app che utilizzano le librerie native di Android. Per saperne di più, consulta Ricevere report sugli arresti anomali dell'NDK Android.

Sistemi di compilazione personalizzati

Firebase fornisce lo script generate_xml_from_google_services_json.py per convertire le risorse google-services.json in risorse .xml che puoi includere nel tuo progetto. Questo script applica la stessa trasformazione eseguita dal plug-in Gradle dei servizi Google Play durante la creazione di applicazioni Android.

Se non esegui la build utilizzando Gradle (ad esempio, utilizzi ndk-build, makefile, Visual Studio e così via), puoi utilizzare questo script per automatizzare la generazione di risorse stringa Android.

ProGuard

Molti sistemi di build Android utilizzano ProGuard per le build in modalità di rilascio per ridurre le dimensioni delle applicazioni e proteggere il codice sorgente Java.

Se utilizzi ProGuard, devi aggiungere i file in libs/android/*.pro corrispondenti alle librerie Firebase C++ che utilizzi nella configurazione di ProGuard.

Ad esempio, con Gradle, se utilizzi Google Analytics, il file build.gradle avrà il seguente aspetto:

android {
  // ...
  buildTypes {
    release {
      minifyEnabled true
      proguardFile getDefaultProguardFile('your-project-proguard-config.txt')
      proguardFile file(project.ext.your_local_firebase_sdk_dir + "/libs/android/app.pro")
      proguardFile file(project.ext.your_local_firebase_sdk_dir + "/libs/android/analytics.pro")
      // ...  and so on, for each Firebase C++ library that you're using
    }
  }
}

Requisito di Google Play Services

La maggior parte delle librerie Firebase C++ richiede Google Play Services sul dispositivo Android del client. Se una libreria Firebase C++ restituisce kInitResultFailedMissingDependency durante l'inizializzazione, significa che Google Play Services non è disponibile sul dispositivo client (il che significa che deve essere aggiornato, riattivato, le autorizzazioni corrette e così via). La libreria Firebase non può essere utilizzata finché la situazione sul dispositivo client non viene corretta.

Puoi scoprire perché Google Play Services non è disponibile sul dispositivo client (e provare a risolvere il problema) utilizzando le funzioni in google_play_services/availability.h.

La tabella seguente indica se Google Play Services è necessario su un dispositivo client per ogni prodotto Firebase supportato.

Libreria Firebase C++ Google Play Services è necessario sul dispositivo client?
AdMob Non obbligatorio (di solito)
Analytics Non obbligatorio
Authentication Obbligatorio
Cloud Firestore Obbligatorio
Cloud Functions Obbligatorio
Cloud Messaging Obbligatorio
Cloud Storage Obbligatorio
Dynamic Links Obbligatorio
Realtime Database Obbligatorio
Remote Config Obbligatorio

AdMob e Google Play Services

La maggior parte delle versioni dell'SDK Google Mobile Ads per Android può funzionare correttamente senza Google Play Services sul dispositivo client. Tuttavia, se utilizzi la dipendenza com.google.android.gms:play-services-ads-lite anziché la dipendenza standard com.google.firebase:firebase-ads elencata sopra, Google Play Services è obbligatorio.

L'inizializzazione di AdMob restituirà kInitResultFailedMissingDependency solo se entrambe le seguenti condizioni sono vere:

  • Google Play Services non è disponibile sul dispositivo client.
  • Stai utilizzando com.google.android.gms:play-services-ads-lite.

Configurare un flusso di lavoro desktop (beta)

Quando crei un gioco, spesso è molto più facile testarlo prima sulle piattaforme desktop e poi eseguirne il deployment e il test sui dispositivi mobili in una fase successiva dello sviluppo. Per supportare questo flusso di lavoro, forniamo un sottoinsieme degli SDK Firebase C++ che possono essere eseguiti su Windows, macOS, Linux e dall'editor C++.

  1. Per i workflow desktop, devi completare le seguenti operazioni:

    1. Configura il progetto C++ per CMake.
    2. Crea un progetto Firebase
    3. Registrare l'app (iOS o Android) con Firebase
    4. Aggiungere un file di configurazione Firebase per la piattaforma mobile

  2. Crea una versione desktop del file di configurazione di Firebase:

    • Se hai aggiunto il file google-services.json Android: quando esegui l'app, Firebase individua questo file mobile, quindi genera automaticamente un file di configurazione Firebase desktop (google-services-desktop.json).

    • Se hai aggiunto il file GoogleService-Info.plist iOS: prima di eseguire l'app, devi convertire questo file mobile in un file di configurazione Firebase desktop. Per convertire il file, esegui questo comando dalla stessa directory del file GoogleService-Info.plist:

      generate_xml_from_google_services_json.py --plist -i GoogleService-Info.plist

    Questo file di configurazione del desktop contiene l'ID progetto C++ che hai inserito nel flusso di lavoro di configurazione della console Firebase. Visita la pagina Informazioni sui progetti Firebase per saperne di più sui file di configurazione.

  3. Aggiungi gli SDK Firebase al tuo progetto C++.

    I passaggi riportati di seguito fungono da esempio di come aggiungere qualsiasi prodotto Firebase supportato al tuo progetto C++. In questo esempio, ti mostriamo come aggiungere Firebase Authentication e Firebase Realtime Database.

    1. Imposta la variabile di ambiente FIREBASE_CPP_SDK_DIR sulla posizione dell'SDK Firebase C++ decompresso.

    2. Al file CMakeLists.txt del tuo progetto, aggiungi i seguenti contenuti, incluse le librerie per i prodotti Firebase che vuoi utilizzare. Ad esempio, per utilizzare Firebase Authentication e Firebase Realtime Database:

      # Add Firebase libraries to the target using the function from the SDK.
add_subdirectory(${FIREBASE_CPP_SDK_DIR} bin/ EXCLUDE_FROM_ALL)

# The Firebase C++ library `firebase_app` is required,
# and it must always be listed last.

# Add the Firebase SDKs for the products you want to use in your app
# For example, to use Firebase Authentication and Firebase Realtime Database
set(firebase_libs firebase_auth firebase_database firebase_app)
target_link_libraries(${target_name} "${firebase_libs}")

  4. Esegui l'app C++.

Librerie disponibili (computer)

L'SDK Firebase C++ include il supporto del flusso di lavoro desktop per un sottoinsieme di funzionalità, consentendo l'utilizzo di determinate parti di Firebase in build desktop autonome su Windows, macOS e Linux.

Prodotto Firebase Riferimenti alla libreria (utilizzo di CMake)
App Check firebase_app_check
(obbligatorio) firebase_app
Authentication firebase_auth
(obbligatorio) firebase_app
Cloud Firestore firebase_firestore
firebase_auth
firebase_app
Cloud Functions firebase_functions
(obbligatorio) firebase_app
Cloud Storage firebase_storage
(obbligatorio) firebase_app
Realtime Database firebase_database
(obbligatorio) firebase_app
Remote Config firebase_remote_config
(obbligatorio) firebase_app

Firebase fornisce le librerie desktop rimanenti come implementazioni stub (non funzionali) per comodità durante la creazione per Windows, macOS e Linux. Pertanto, non è necessario compilare codice in modo condizionale per il targeting del desktop.

Realtime Database desktop

L'SDK Realtime Database per computer utilizza REST per accedere al database, pertanto devi dichiarare gli indici che utilizzi con Query::OrderByChild() sul computer o i listener non funzioneranno.

Informazioni aggiuntive per la configurazione del computer

Librerie Windows

Per Windows, le versioni della libreria vengono fornite in base a quanto segue:

  • Piattaforma di compilazione: modalità a 32 bit (x86) e a 64 bit (x64)
  • Ambiente di runtime Windows: multithread / MT vs DLL multithread /MD
  • Target: Release vs Debug

Tieni presente che le seguenti librerie sono state testate utilizzando Visual Studio 2015 e 2017.

Quando crei app desktop C++ su Windows, collega le seguenti librerie dell'SDK Windows al tuo progetto. Per ulteriori informazioni, consulta la documentazione del compilatore.

Libreria Firebase C++ Dipendenze della libreria Windows SDK
App Check advapi32, ws2_32, crypt32
Authentication advapi32, ws2_32, crypt32
Cloud Firestore advapi32, ws2_32, crypt32, rpcrt4, ole32, shell32
Cloud Functions advapi32, ws2_32, crypt32, rpcrt4, ole32
Cloud Storage advapi32, ws2_32, crypt32
Realtime Database advapi32, ws2_32, crypt32, iphlpapi, psapi, userenv
Remote Config advapi32, ws2_32, crypt32, rpcrt4, ole32

Librerie macOS

Per macOS (Darwin), le versioni della libreria sono fornite per la piattaforma a 64 bit (x86_64). Per comodità, sono disponibili anche framework.

Tieni presente che le librerie macOS sono state testate utilizzando Xcode 16.2.

Quando crei app desktop C++ su macOS, collega al tuo progetto quanto segue:

  • Libreria di sistema pthread
  • CoreFoundation Framework di sistema macOS
  • Foundation Framework di sistema macOS
  • Security Framework di sistema macOS
  • GSS Framework di sistema macOS
  • Kerberos Framework di sistema macOS
  • SystemConfiguration Framework di sistema macOS

Per saperne di più, consulta la documentazione del compilatore.

Librerie Linux

Per Linux, le versioni della libreria sono fornite per le piattaforme a 32 bit (i386) e a 64 bit (x86_64).

Tieni presente che le librerie Linux sono state testate utilizzando GCC 4.8.0, GCC 7.2.0 e Clang 5.0 su Ubuntu.

Quando crei app desktop C++ su Linux, collega la libreria di sistema pthread al tuo progetto. Per saperne di più, consulta la documentazione del compilatore. Se esegui la build con GCC 5 o versioni successive, definisci -D_GLIBCXX_USE_CXX11_ABI=0.

Passaggi successivi