Aggiungere Firebase al progetto C++

Potenzia 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 inoltre molti idiomi specifici per 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 Firebase Games.

Hai già aggiunto Firebase al tuo progetto C++? Assicurati di utilizzare la versione più recente 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 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.

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

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

  • Accedi a Firebase con il tuo Account Google.

Passaggio 2: crea un progetto Firebase

Prima di poter aggiungere Firebase al tuo progetto C++, devi creare un progetto Firebase per connetterti al progetto C++. Consulta Informazioni sui progetti Firebase per saperne di più su questi progetti.

Passaggio 3: registra la tua app su Firebase

Per utilizzare Firebase nella tua app per Android, devi registrare l'app con il tuo progetto Firebase. La registrazione dell'app è 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 di configurazione.

  3. Inserisci il nome del pacchetto dell'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 di Firebase per 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.2'  // Google Services plugin
      implementation 'com.google.android.gms:18.5.0'
    }
  }

  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 con la sezione 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 decomprimi l'SDK 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 scompattato:

    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. Aggiungi i seguenti contenuti al file Gradle del tuo modulo (a livello di app, di solito app/build.gradle).
    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 attivato 

    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 attivato 

    # 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 l'app per assicurarti che tutte le dipendenze abbiano le versioni necessarie.

  7. Se hai aggiunto Analytics, esegui l'app per inviare a Firebase la verifica dell'integrazione di Firebase. In caso contrario, puoi saltare il passaggio di verifica.

    Nei log del dispositivo verrà visualizzata la verifica di Firebase che indica che l'inizializzazione è completata. Se hai eseguito l'app su un emulatore con accesso alla rete, la console Firebase ti comunica che la connessione dell'app è stata completata.

Ecco fatto. L'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 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 le piattaforme Apple (iOS e versioni successive) di questa pagina di configurazione.

Prodotto Firebase Riferimenti alla raccolta
(firebaseCpp.dependencies
per il file build.gradle)		 Riferimenti alla raccolta
(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 sui dispositivi mobili

Ricevere report sugli arresti anomali NDK

Firebase Crashlytics supporta i report sugli arresti anomali per le app che utilizzano le librerie native di Android. Per saperne di più, consulta Generare report sugli arresti anomali di Android NDK.

Sistemi di compilazione personalizzati

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

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

ProGuard

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

Se utilizzi ProGuard, devi aggiungere i file in libs/android/*.pro corrispondente 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 che Google Play Services sia installato sul dispositivo Android del client. Se una libreria Firebase C++ restituisce kInitResultFailedMissingDependency all'inizializzazione, significa che Google Play Services non è disponibile sul dispositivo client (ovvero deve essere aggiornato, riattivato, le autorizzazioni devono essere 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 è obbligatorio su un dispositivo client per ogni prodotto Firebase supportato.

Libreria Firebase C++ Google Play Services è richiesto sul dispositivo client?
AdMob Non obbligatoria (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 com.google.firebase:firebase-ads standard elencata sopra, Google Play Services è obbligatorio.

L'inizializzazione di AdMob restituirà kInitResultFailedMissingDependency soltanto se si verificano entrambe le seguenti condizioni:

  • 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 su piattaforme desktop, per poi eseguirlo e testarlo su dispositivi mobili in un secondo momento durante lo sviluppo. Per supportare questo flusso di lavoro, forniamo un sottoinsieme di SDK Firebase C++ che può essere eseguito su Windows, macOS, Linux e dall'editor C++.

  1. Per i workflow desktop, devi completare quanto segue:

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

  2. Crea una versione per computer del file di configurazione di Firebase:

    • Se hai aggiunto il file google-services.json per Android: quando esegui la tua app, Firebase individua questo file mobile e genera automaticamente un file di configurazione Firebase per computer (google-services-desktop.json).

    • Se hai aggiunto il file GoogleService-Info.plist per iOS: prima di eseguire la tua app, devi convertire questo file mobile in un file di configurazione Firebase per computer. Per convertire il file, esegui il seguente 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. Consulta 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 sono un esempio di come aggiungere qualsiasi prodotto Firebase supportato al tuo progetto C++. In questo esempio, viene illustrata la procedura per 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. Aggiungi i seguenti contenuti al file CMakeLists.txt del progetto, 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 di utilizzare determinate parti di Firebase nelle compilazioni desktop autonome su Windows, macOS e Linux.

Prodotto Firebase Riferimenti alle librerie (con 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

Per comodità, Firebase fornisce le restanti librerie desktop come implementazioni stub (non funzionali) quando esegui la compilazione per Windows, macOS e Linux. Di conseguenza, non è necessario compilare il codice in modo condizionale per il target desktop.

Realtime Database computer

L'SDK Realtime Database per computer utilizza REST per accedere al database, quindi devi dichiarare gli indici che utilizzi con Query::OrderByChild() su computer, altrimenti gli ascoltatori non funzioneranno.

Informazioni aggiuntive per la configurazione del computer

Librerie Windows

Per Windows, le versioni delle librerie vengono fornite in base a quanto segue:

  • Piattaforma di compilazione: modalità a 32 bit (x86) o 64 bit (x64)
  • Ambiente di runtime Windows: multithread / MT e DLL multithread /MD
  • Target: release o 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 SDK Windows al tuo progetto. Per ulteriori informazioni, consulta la documentazione del compilatore.

Libreria Firebase C++ Dipendenze delle librerie dell'SDK Windows
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

Biblioteche macOS

Per macOS (Darwin), le versioni delle librerie sono fornite per la piattaforma a 64 bit (x86_64). Per praticità, sono forniti anche i framework.

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

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

  • 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 ulteriori informazioni, consulta la documentazione del compilatore.

Librerie Linux

Per Linux, le versioni delle librerie 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 ulteriori informazioni, consulta la documentazione del compilatore. Se stai eseguendo la compilazione con GCC 5 o versioni successive, definisci -D_GLIBCXX_USE_CXX11_ABI=0.

Passaggi successivi