Aggiungere Firebase al progetto C++

Potenzia i tuoi giochi C++ con i nostri SDK Firebase C++, che forniscono un'interfaccia C++ oltre agli 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 del linguaggio utilizzati da Firebase in un'interfaccia più familiare agli sviluppatori C++.

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

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

Prerequisiti

• Installa l'editor o l'IDE che preferisci, ad esempio Android Studio, IntelliJ o VS Code.

• Scarica l'SDK Android.

• Assicurati che il tuo progetto soddisfi questi requisiti:

  • Livello API target 24 (Nougat) 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 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 da connettere al progetto C++. Consulta 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 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 Android (plat_android) o su Aggiungi app per avviare il flusso di lavoro della configurazione.

3. Inserisci il nome del pacchetto dell'app nel campo Nome pacchetto Android.

   Che cos'è un nome del pacchetto e dove si trova?

   • Un nome del pacchetto identifica in modo univoco la tua app sul dispositivo e nel Google Play Store.

   • Un nome del pacchetto viene spesso definito ID applicazione.

   • Trova il nome del pacchetto della tua app nel file Gradle del modulo (a livello di app), di solito app/build.gradle (nome del pacchetto di esempio: com.yourcompany.yourproject).

   • Tieni presente che il valore del nome del pacchetto è sensibile alle maiuscole e non può essere modificato per questa app Firebase per Android dopo la registrazione al progetto Firebase.

4. (Facoltativo) Inserisci un Nickname app, ovvero un identificatore interno di convenienza visibile solo a te nella console Firebase.

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.

   Cosa devi sapere su questo file di configurazione?

   • Il file di configurazione di Firebase contiene identificatori univoci, ma non segreti, per il tuo progetto e la tua app. Per scoprire di più su questo file di configurazione, consulta Informazioni sui progetti Firebase.

   • Puoi scaricare di nuovo il file di configurazione Firebase in qualsiasi momento.

   • Assicurati che al nome del file di configurazione non vengano aggiunti caratteri aggiuntivi, ad esempio (2).

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

   • Build Gradle: aggiungi il file di configurazione alla stessa directory del file build.gradle di primo livello.

   • Altri sistemi di build: consulta la sezione Sistemi di build personalizzati di seguito per generare risorse stringa Android.

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

   1. Aggiungi regole per includere il plug-in Gradle di Google Services. Controlla anche di avere 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.5.0'  // Google services Gradle plugin
            implementation 'com.google.android.gms:18.11.1'
          }
        }
      
        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 Gradle plugin
      
        android {
          // ...
        }
      

4. Hai completato le attività di configurazione nella console Firebase. Continua con Aggiungi 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 C++ Firebase, quindi decomprimilo in un percorso semplice da raggiungere.

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

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. Aggiungi i seguenti contenuti al file Gradle del modulo (a livello di app, di solito app/build.gradle).
   Includi le dipendenze della libreria 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 abilitata

   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 abilitata

   # 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 richieste.

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 di 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 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.

Informazioni aggiuntive per la configurazione mobile

Ricevi report sugli arresti anomali di NDK

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

Sistemi di build 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 di Google Play Services durante la creazione di app per Android.

Se non utilizzi Gradle per la creazione (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 sarà simile al seguente:

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 presente 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.

Configura un workflow desktop (beta)

Quando crei un gioco, spesso è molto più facile testarlo prima su piattaforme desktop, poi eseguirne il deployment e testarlo su dispositivi mobili in un secondo momento 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 flussi di lavoro desktop, devi completare i seguenti passaggi:

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

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

   • Se hai aggiunto il file Android google-services.json: 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 iOS GoogleService-Info.plist: 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 desktop contiene l'ID progetto C++ che hai inserito nel flusso di lavoro di configurazione della console Firebase. Consulta Informazioni sui progetti Firebase per scoprire di più sui file di configurazione.

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

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

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

   2. Al file CMakeLists.txt del 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 alcune parti di Firebase in build desktop autonome su Windows, macOS e Linux.

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

Realtime Database desktop

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 i listener non funzioneranno.

Informazioni aggiuntive per la configurazione su computer

Librerie Windows

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

• Piattaforma di build: modalità a 32 bit (x86) o a 64 bit (x64)
• Ambiente di runtime Windows: Multithreaded / MT vs Multithreaded DLL /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 saperne di più, consulta la documentazione del compilatore.

Librerie macOS

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

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

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

• pthread libreria di sistema
• CoreFoundation Framework di sistema macOS
• 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

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 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

• Esplora le app Firebase di esempio.

• Esplora l'SDK open source in GitHub.

• Preparati a lanciare la tua app:

  • Configura gli avvisi relativi al budget per il tuo progetto nella console Google Cloud.
  • Monitora la dashboard Utilizzo e fatturazione nella console Firebase per avere un quadro generale dell'utilizzo del progetto in più servizi Firebase.
  • Consulta l'elenco di controllo per il lancio di Firebase.