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:

  • Hanno 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ù 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 è 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 del 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 dell'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 scoprire 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. 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 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 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 Analytics, Firebase Authentication, and Firebase Realtime Database
   apply from: "$gradle.firebase_cpp_sdk_dir/Android/firebase_dependencies.gradle"
   firebaseCpp.dependencies {
     analytics
     auth
     database
   }

   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 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 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}")

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

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

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 l'aggiunta di Firebase Authentication e Firebase Realtime Database.

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

   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.

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 scegliere come target il computer.

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.

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 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 eseguendo la compilazione 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.