Aggiungere Firebase al progetto C++

Migliora 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 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 il livello API target 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 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 collegare al progetto. Consulta Informazioni sui progetti Firebase per saperne di più su questi progetti.

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

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

   Che cos'è un nome del pacchetto e dove trovarlo?

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

   • Un nome pacchetto viene spesso definito ID applicazione.

   • Trova il nome del pacchetto della tua app nel file Gradle del modulo (a livello di app), solitamente 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 altre informazioni sull'app: Nickname dell'app e Certificato SHA-1 per la firma di debug.

   Come vengono utilizzati il Nickname app e il certificato SHA-1 per la firma di debug in Firebase?

   • Nickname dell'app: un identificatore interno di praticità visibile solo per te nella console Firebase

   • Certificato SHA-1 per la firma di debug: Firebase Authentication (se utilizzi Accedi con Google o Accedi con il numero di telefono) e Firebase Dynamic Links richiedono un hash SHA-1.

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. Per saperne di più su questo file di configurazione, consulta Informazioni sui progetti Firebase.

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

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

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

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

   • Altri sistemi di compilazione: consulta Sistemi di compilazione personalizzati di seguito per generare Android String Resources.

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. Vai 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 decomprimi l'SDK in un percorso semplice da raggiungere.

   L'SDK Firebase C++ non è specifico della piattaforma, ma contiene librerie specifiche della 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 nell'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 che dispone di accesso alla rete, la console di 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 di 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 delle piattaforme Apple (iOS+) di questa pagina di configurazione.

Informazioni aggiuntive per la configurazione sui dispositivi mobili

Ricevi report sugli arresti anomali NDK

Firebase Crashlytics supporta i report sugli arresti anomali per le app che utilizzano librerie native di Android. Per scoprire di più, visita la pagina Scaricare i 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 .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 crei utilizzando Gradle (ad esempio, utilizzi ndk-build, makefiles, 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à 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 (quindi deve essere aggiornato, riattivato, corrette le autorizzazioni 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.

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 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 si crea un gioco, spesso è molto più facile testarlo prima sulle piattaforme desktop, per 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 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. Per saperne di più sui file di configurazione, consulta Informazioni sui progetti Firebase.

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. 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 di utilizzare determinate parti di Firebase nelle compilazioni desktop autonome su Windows, macOS e Linux.

Per comodità, Firebase fornisce le restanti librerie desktop come implementazioni stub (non funzionali) per 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 della libreria 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 /MD multithread
• Target: release o debug

Tieni presente che le librerie seguenti 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.

Biblioteche macOS

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

Tieni presente che le librerie per 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 creando 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 su GitHub.

• Preparati a lanciare l'app:

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