Firebase SDK'larının üzerine C++ arayüzü sağlayan Firebase C++ SDK'larımızla C++ oyunlarınızı güçlendirin.
Platforma özgü kod yazmak zorunda kalmadan Firebase'e tamamen C++ kodunuzdan erişin. Firebase SDK'sı, Firebase tarafından kullanılan birçok dile özgü deyimi C++ geliştiricilerine daha aşina bir arayüze de çevirir.
Oyunlarınızı Firebase ile güçlendirme hakkında daha fazla bilgi edinmek için Firebase oyunlar sayfamızı ziyaret edin.
Firebase C++ SDK'sının hangi Firebase ürünlerini desteklediğiniFirebase'i C++ projenize zaten eklediyseniz Firebase C++ SDK'sının en yeni sürümünü kullandığınızdan emin olun.
Ön koşullar
Android Studio, IntelliJ veya VS Code gibi tercih ettiğiniz düzenleyiciyi ya da IDE'yi yükleyin.
Android SDK'sını edinin.
Projenizin aşağıdaki koşulları karşıladığından emin olun:
API düzeyi 21'i (Lollipop) veya üstünü hedefliyor
Gradle'i kullanır ve CMake ile yapılandırılır.
Uygulamanızı çalıştırmak için fiziksel bir cihaz kurun veya bir emülatör kullanın.
Emülatörler, Google Play ile bir emülatör resmi kullanmalıdır.
Bazı C++ kitaplıkları için istemci cihazda Google Play Hizmetleri gerekir. Bu sayfadaki listeyi inceleyin.
Google Hesabınızı kullanarak Firebase'de oturum açın.
2. Adım: Firebase projesi oluşturun
Firebase'i C++ projenize eklemeden önce, C++ projenize bağlanacak bir Firebase projesi oluşturmanız gerekir. Firebase projeleri hakkında daha fazla bilgi edinmek için Firebase Projelerini Anlama başlıklı makaleyi inceleyin.
3. Adım: Uygulamanızı Firebase'e kaydedin
Firebase'i Android uygulamanızda kullanmak için uygulamanızı Firebase projenize kaydetmeniz gerekir. Uygulamanızı kaydetme işlemine genellikle uygulamanızı projenize "ekleme" denir.
Firebase konsoluna gidin.
Kurulum iş akışını başlatmak için projeye genel bakış sayfasının ortasından Android simgesini (
) veya Uygulama ekle'yi tıklayın.Android paketi adı alanına uygulamanızın paket adını girin.
(İsteğe bağlı) Diğer uygulama bilgilerini girin: Uygulama takma adı ve Hata ayıklama imzalama sertifikası SHA-1.
Uygulamayı kaydet'i tıklayın.
4. Adım: Firebase yapılandırma dosyasını ekleyin
Firebase Android yapılandırma dosyanızı almak için google-services.json dosyasını indir'i tıklayın.
C++ projenizi bir IDE'de açın ve yapılandırma dosyanızı projenize ekleyin:
Gradle derlemeleri: Yapılandırma dosyanızı üst düzey
build.gradle
dosyanızla aynı dizine ekleyin.Diğer derleme sistemleri: Android dize kaynaklarını oluşturmak için aşağıdaki Özel derleme sistemleri bölümüne bakın.
(Yalnızca Gradle derlemeleri) C++ projenizde Firebase hizmetlerini etkinleştirmek için üst düzey
build.gradle
dosyanıza google-services eklentisini ekleyin.Google Hizmetleri Gradle eklentisini içerecek kurallar ekleyin. Google'ın Maven deposuna da sahip olduğunuzdan emin olun.
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 // ... } }
Google Hizmetleri Gradle eklentisini uygulayın:
apply plugin: 'com.android.application' // Add the following line: apply plugin: 'com.google.gms.google-services' // Google Services plugin android { // ... }
Firebase konsolunda kurulum işlemlerini tamamladınız. Aşağıdaki Firebase C++ SDK'larını ekleme bölümüne geçin.
5. Adım: Firebase C++ SDK'larını ekleyin
Bu bölümdeki adımlar, desteklenen Firebase ürünlerini Firebase C++ projenize ekleme örneğidir.
Firebase C++ SDK'sını indirin, ardından SDK'yı uygun bir konumda arşivden çıkarın.
Firebase C++ SDK'sı platforma özgü değildir ancak platforma özgü kitaplıklar içerir.
Projenizin
gradle.properties
dosyasında, sıkıştırılmamış SDK'nın konumunu belirtin:systemProp.firebase_cpp_sdk.dir=full-path-to-SDK
Projenizin
settings.gradle
dosyasına aşağıdaki içeriği ekleyin: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"
Modül (uygulama düzeyi) Gradle dosyanıza (genellikle
app/build.gradle
) aşağıdaki içeriği ekleyin.
Uygulamanızda kullanmak istediğiniz Firebase ürünlerinin kitaplık bağımlılıklarını ekleyin.Analytics etkin
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 etkin değil
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 }
Projenizin
CMakeLists.txt
dosyasına aşağıdaki içeriği ekleyin.
Uygulamanızda kullanmak istediğiniz Firebase ürünlerinin kitaplıklarını ekleyin.Analytics etkin
# 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 etkin değil
# 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}")
Tüm bağımlılarda gerekli sürümlerin bulunduğundan emin olmak için uygulamanızı senkronize edin.
Analytics eklediyseniz Firebase'i başarıyla entegre ettiğinize dair doğrulamayı Firebase'e göndermek için uygulamanızı çalıştırın. Aksi takdirde doğrulama adımını atlayabilirsiniz.
Cihaz günlüklerinizde, ilklendirmenin tamamlandığını belirten Firebase doğrulaması gösterilir. Uygulamanızı ağ erişimi olan bir emülatörde çalıştırdıysanız Firebase konsolu, uygulama bağlantınızın tamamlandığını bildirir.
Artık hazırsınız. C++ uygulamanız, Firebase hizmetlerini kullanacak şekilde kayıtlı ve yapılandırılmış olmalıdır.
Kullanılabilen kitaplıklar
C++ Firebase kitaplıkları hakkında daha fazla bilgiyi referans dokümanlarından ve GitHub'daki açık kaynak SDK sürümümüzden edinebilirsiniz.
Android için kullanılabilen kitaplıklar (CMake kullanılarak)
Apple platformları için C++ kitaplıklarının, bu kurulum sayfasının Apple platformları (iOS+) sürümünde listelendiğini unutmayın.
Firebase ürünü | Kitaplık referansları ( build.gradle dosyası için firebaseCpp.dependencies ) |
Kitaplık referansları ( CMakeLists.txt dosyası için firebase_libs ) |
---|---|---|
AdMob | admob |
firebase_admob (zorunlu) firebase_analytics (zorunlu) firebase_app
|
Analytics | analytics |
firebase_analytics (zorunlu) firebase_app
|
App Check | appCheck |
firebase_app_check (zorunlu) firebase_app
|
Authentication | auth |
firebase_auth (zorunlu) firebase_app
|
Cloud Firestore | firestore |
firebase_firestore (zorunlu) firebase_auth (zorunlu) firebase_app
|
Cloud Functions | functions |
firebase_functions (zorunlu) firebase_app
|
Cloud Messaging | messaging |
firebase_messaging (önerilen) firebase_analytics (zorunlu) firebase_app
|
Cloud Storage | storage |
firebase_storage (zorunlu) firebase_app
|
Dynamic Links | dynamicLinks |
firebase_dynamic_links (önerilen) firebase_analytics (zorunlu) firebase_app
|
Realtime Database | database |
firebase_database (zorunlu) firebase_app
|
Remote Config | remoteConfig |
firebase_remote_config (önerilen) firebase_analytics (zorunlu) firebase_app
|
Mobil kurulum için ek bilgiler
NDK kilitlenme raporlarını alma
Firebase Crashlytics, Android yerel kitaplıklarını kullanan uygulamalar için kilitlenme raporlamasını destekler. Daha fazla bilgi edinmek için Android NDK kilitlenme raporlarını alma başlıklı makaleyi inceleyin.
Özel derleme sistemleri
Firebase, google-services.json
'yi projenize dahil edebileceğiniz .xml
kaynaklarına dönüştürmek için generate_xml_from_google_services_json.py
komut dosyasını sağlar. Bu komut dosyası, Google Play Hizmetleri Gradle eklentisinin Android uygulamaları oluştururken gerçekleştirdiği aynı dönüşümü uygular.
Gradle'i kullanarak derleme yapmıyorsanız (örneğin, ndk-build, makefiles, Visual Studio vb. kullanıyorsanız) Android dize kaynaklarının oluşturulmasını otomatikleştirmek için bu komut dosyasını kullanabilirsiniz.
ProGuard
Birçok Android derleme sistemi, uygulama boyutlarını küçültmek ve Java kaynak kodunu korumak için Yayın modunda derlemelerde ProGuard'ı kullanır.
ProGuard kullanıyorsanız ProGuard yapılandırmanızda kullandığınız Firebase C++ kitaplıklarına karşılık gelen dosyaları libs/android/*.pro
içine eklemeniz gerekir.
Örneğin, Gradle ile Google Analytics kullanıyorsanız build.gradle
dosyanız şu şekilde görünür:
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 } } }
Google Play Hizmetleri şartı
Çoğu Firebase C++ kitaplığı, istemcinin Android cihazında Google Play Hizmetleri'nin bulunmasını gerektirir. Bir Firebase C++ kitaplığı ilk başlatılırken kInitResultFailedMissingDependency
döndürüyorsa Google Play Hizmetleri istemci cihazda kullanılamıyor demektir (yani güncellenmesi, yeniden etkinleştirilmesi, izinlerinin düzeltilmesi vb. gerekir). İstemci cihazdaki durum düzeltilene kadar Firebase kitaplığı kullanılamaz.
google_play_services/availability.h
içindeki işlevleri kullanarak Google Play Hizmetleri'nin istemci cihazda neden kullanılamadığını öğrenebilir (ve sorunu düzeltmeye çalışabilirsiniz).
Aşağıdaki tabloda, desteklenen her Firebase ürünü için istemci cihazda Google Play Hizmetleri'nin gerekli olup olmadığı listelenmektedir.
Firebase C++ Kitaplığı | İstemci cihazda Google Play Hizmetleri gerekli mi? |
---|---|
AdMob | Zorunlu değil (genellikle) |
Analytics | Zorunlu değil |
Authentication | Zorunlu |
Cloud Firestore | Zorunlu |
Cloud Functions | Zorunlu |
Cloud Messaging | Zorunlu |
Cloud Storage | Zorunlu |
Dynamic Links | Zorunlu |
Realtime Database | Zorunlu |
Remote Config | Zorunlu |
AdMob ve Google Play Hizmetleri
Android için Google Mobile Ads SDK'sının çoğu sürümü, istemci cihazda Google Play Hizmetleri olmadan düzgün şekilde çalışabilir. Ancak yukarıda listelenen standart com.google.firebase:firebase-ads
bağımlılığı yerine com.google.android.gms:play-services-ads-lite
bağımlılığını kullanıyorsanız Google Play Hizmetleri gereklidir.
AdMob başlatma işlemi yalnızca aşağıdakilerin ikisi de doğru olduğunda kInitResultFailedMissingDependency
döndürür:
- Google Play Hizmetleri istemci cihazda kullanılamıyor.
com.google.android.gms:play-services-ads-lite
kullanıyorsanız
Masaüstü iş akışı oluşturma (beta)
Oyun oluştururken genellikle oyununuzu önce masaüstü platformlarda test etmek, ardından geliştirmenin ilerleyen aşamalarında mobil cihazlarda dağıtıp test etmek çok daha kolaydır. Bu iş akışını desteklemek için Windows, macOS, Linux ve C++ düzenleyicisinde çalışabilen Firebase C++ SDK'larının bir alt kümesini sunuyoruz.
Masaüstü iş akışları için aşağıdakileri tamamlamanız gerekir:
- C++ projenizi CMake için yapılandırın.
- Firebase projesi oluşturma
- Uygulamanızı (iOS veya Android) Firebase'e kaydetme
- Mobil platform Firebase yapılandırma dosyası ekleme
Firebase yapılandırma dosyasının masaüstü sürümünü oluşturun:
Android
google-services.json
dosyasını eklediyseniz: Uygulamanızı çalıştırdığınızda Firebase bu mobil dosyayı bulur ve ardından otomatik olarak bir masaüstü Firebase yapılandırma dosyası (google-services-desktop.json
) oluşturur.iOS
GoogleService-Info.plist
dosyasını eklediyseniz: Uygulamanızı çalıştırmadan önce bu mobil dosyayı masaüstü Firebase yapılandırma dosyasına dönüştürmeniz gerekir. Dosyayı dönüştürmek içinGoogleService-Info.plist
dosyanızla aynı dizinden aşağıdaki komutu çalıştırın:generate_xml_from_google_services_json.py --plist -i GoogleService-Info.plist
Bu masaüstü yapılandırma dosyası, Firebase konsol kurulum iş akışına girdiğiniz C++ proje kimliğini içerir. Yapılandırma dosyaları hakkında daha fazla bilgi edinmek için Firebase Projelerini Anlama başlıklı makaleyi inceleyin.
C++ projenize Firebase SDK'larını ekleyin.
Aşağıdaki adımlar, desteklenen Firebase ürünlerinin C++ projenize nasıl ekleneceğine dair bir örnektir. Bu örnekte, Firebase Authentication ve Firebase Realtime Database ekleme işlemini adım adım açıklıyoruz.
FIREBASE_CPP_SDK_DIR
ortam değişkeninizi, sıkıştırılmış Firebase C++ SDK'sının konumuna ayarlayın.Projenizin
CMakeLists.txt
dosyasına, kullanmak istediğiniz Firebase ürünlerinin kitaplıkları da dahil olmak üzere aşağıdaki içeriği ekleyin. Örneğin, Firebase Authentication ve Firebase Realtime Database'ü kullanmak için:# 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}")
C++ uygulamanızı çalıştırın.
Kullanılabilir kütüphaneler (masaüstü)
Firebase C++ SDK'sı, bir özellik alt kümesi için masaüstü iş akışı desteği içerir. Bu sayede Firebase'in belirli bölümleri Windows, macOS ve Linux'ta bağımsız masaüstü derlemelerinde kullanılabilir.
Firebase ürünü | Kitaplık referansları (CMake kullanılarak) |
---|---|
App Check |
firebase_app_check (zorunlu) firebase_app
|
Authentication |
firebase_auth (zorunlu) firebase_app
|
Cloud Firestore |
firebase_firestore firebase_auth firebase_app
|
Cloud Functions |
firebase_functions (zorunlu) firebase_app
|
Cloud Storage |
firebase_storage (zorunlu) firebase_app
|
Realtime Database |
firebase_database (zorunlu) firebase_app
|
Remote Config |
firebase_remote_config (zorunlu) firebase_app
|
Firebase, Windows, macOS ve Linux için derleme yaparken kolaylık sağlamak amacıyla kalan masaüstü kitaplıklarını stub (işlevsel olmayan) uygulamalar olarak sağlar. Bu nedenle, masaüstü sürümünü hedeflemek için kodu koşullu olarak derlemeniz gerekmez.
Realtime Database masaüstü
Masaüstü için Realtime Database SDK'sı, veritabanınıza erişmek için REST'i kullanır. Bu nedenle, masaüstünde Query::OrderByChild()
ile kullandığınız dizinleri belirtmeniz gerekir. Aksi takdirde dinleyicileriniz başarısız olur.
Masaüstü kurulumu için ek bilgiler
Windows kitaplıkları
Windows için kitaplık sürümleri aşağıdakilere göre sağlanır:
- Derleme platformu: 32 bit (x86) ve 64 bit (x64) modu
- Windows çalışma zamanı ortamı: Çok iş parçacıklı / MT ve çok iş parçacıklı DLL /MD karşılaştırması
- Hedef: Yayınlama ve hata ayıklama
Aşağıdaki kitaplıkların Visual Studio 2015 ve 2017 kullanılarak test edildiğini unutmayın.
Windows'ta C++ masaüstü uygulamaları oluştururken aşağıdaki Windows SDK kitaplıklarını projenize bağlayın. Daha fazla bilgi için derleyici dokümanlarınızı inceleyin.
Firebase C++ Kitaplığı | Windows SDK kitaplık bağımlılıkları |
---|---|
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 |
macOS kütüphaneleri
macOS (Darwin) için kitaplık sürümleri 64 bit (x86_64) platform için sağlanır. Size kolaylık sağlamak için çerçeveler de sağlanmıştır.
macOS kitaplıklarının Xcode 13.3.1 kullanılarak test edildiğini unutmayın.
macOS'te C++ masaüstü uygulamaları oluştururken aşağıdakileri projenize bağlayın:
pthread
sistem kitaplığıCoreFoundation
macOS sistem çerçevesiFoundation
macOS sistem çerçevesiSecurity
macOS sistem çerçevesiGSS
macOS sistem çerçevesiKerberos
macOS sistem çerçevesiSystemConfiguration
macOS sistem çerçevesi
Daha fazla bilgi için derleyici dokümanlarınızı inceleyin.
Linux kitaplıkları
Linux için kitaplık sürümleri 32 bit (i386) ve 64 bit (x86_64) platformlar için sağlanır.
Linux kitaplıklarının Ubuntu'da GCC 4.8.0, GCC 7.2.0 ve Clang 5.0 kullanılarak test edildiğini unutmayın.
Linux'da C++ masaüstü uygulamaları oluştururken pthread
sistem kitaplığını projenize bağlayın. Daha fazla bilgi için derleyici dokümanlarınızı inceleyin. GCC 5 veya sonraki bir sürümle derliyorsanız -D_GLIBCXX_USE_CXX11_ABI=0
değerini tanımlayın.
Sonraki adımlar
Örnek Firebase uygulamalarını inceleyin.
GitHub'daki açık kaynak SDK'yı keşfedin.
Uygulamanızı kullanıma sunmaya hazırlanın:
- Google Cloud konsolunda projeniz için bütçe uyarıları ayarlayın.
- Projenizin birden fazla Firebase hizmetindeki kullanımına dair genel bir fikir edinmek için Firebase konsolundaki Kullanım ve faturalandırma kontrol panelini izleyin.
- Firebase lansman kontrol listesini inceleyin.