Bu sayfa, Cloud Translation API ile çevrilmiştir.

Firebase'i C++ projenize ekleyin

Firebase SDK'larının üzerinde C++ arayüzü sağlayan Firebase C++ SDK'larımızla C++ oyunlarınıza güç katın.

Platforma özgü kod yazmanıza gerek kalmadan Firebase'e tamamen C++ kodunuzdan erişin. Firebase SDK, Firebase tarafından kullanılan dile özgü birçok deyimi de C++ geliştiricilerinin daha aşina olduğu bir arayüze çevirir.

Oyunlarınıza Firebase ile güç katma hakkında daha fazla bilgi edinmek için Firebase oyunları sayfamızı ziyaret edin.

Firebase'i C++ projenize eklediniz mi? 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'yı edinin.
Projenizin aşağıdaki koşulları karşıladığından emin olun:
- API düzeyi 21 (Lollipop) veya üstünü hedeflemelidir.
- Gradle kullanır ve CMake ile yapılandırılır
Uygulamanızı çalıştırmak için fiziksel bir cihaz kurun veya emülatör kullanın.
- Emülatörler Google Play'in bulunduğu bir emülatör resmi kullanmalıdır.
- Bazı C++ kitaplıkları için istemci cihazda Google Play Hizmetleri'nin yüklü olması 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 ekleyebilmeniz için 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.

Firebase projesi oluşturma

Firebase konsolunda Proje ekle'yi tıklayın.
- Firebase kaynaklarını mevcut bir Google Cloud projeye eklemek için projenin adını girin veya açılır menüden projeyi seçin.
- Yeni bir proje oluşturmak için proje adı girin. İsterseniz proje adının altında gösterilen proje kimliğini de düzenleyebilirsiniz.
  
  Firebase, Firebase projeniz için verdiğiniz ada göre benzersiz bir kimlik oluşturur. Bu proje kimliğini düzenlemek istiyorsanız Firebase, projeniz için kaynak sağladıktan sonra değiştirilemeyeceğinden işlemi şimdi yapmanız gerekir. Firebase'in proje kimliğini nasıl kullandığı hakkında bilgi edinmek için Firebase Projelerini Anlama başlıklı makaleyi ziyaret edin.
İstenirse Firebase şartlarını inceleyip kabul edin.
Devam'ı tıklayın.
(İsteğe bağlı) Projeniz için Google Analytics'ı ayarlayın. Bu, aşağıdaki Firebase ürünlerini kullanarak optimum bir deneyim sağlar: Firebase A/B Testing, Cloud Messaging, Crashlytics, In-App Messaging ve Remote Config (kişiselleştirme dahil).

Mevcut bir Google Analytics hesabı seçin veya yeni bir hesap oluşturun. Yeni bir hesap oluşturursanız Analytics raporlama konumunuzu seçin, ardından projeniz için veri paylaşım ayarlarını ve Google Analytics şartlarını kabul edin.

Google Analytics'ı daha sonra istediğiniz zaman Proje ayarlarınızın Entegrasyonlar sekmesinden kurabilirsiniz.
Proje oluştur'u (veya Firebase'i mevcut bir Google Cloud projesine ekliyorsanız Firebase ekle'yi) tıklayın.

Firebase, Firebase projeniz için kaynakları otomatik olarak sağlar. İşlem tamamlandığında Firebase konsolunda Firebase projenizin genel bakış sayfasına yönlendirilirsiniz.

3. adım: Uygulamanızı Firebase'e kaydedin

Android uygulamanızda Firebase'i kullanmak için uygulamanızı Firebase projenize kaydetmeniz gerekir. Uygulamanızı kaydetme işlemi genellikle uygulamanızı projenize "ekleme" olarak adlandırılır.

Firebase konsoluna gidin.
Kurulum iş akışını başlatmak için projeye genel bakış sayfasının ortasındaki Android simgesini () veya Uygulama ekle'yi tıklayın.
Uygulamanızın paket adını Android paket adı alanına girin.
Paket adı nedir ve nerede bulunur?
- Paket adı, uygulamanızı cihazda ve Google Play Store'da benzersiz bir şekilde tanımlar.
- Paket adı genellikle uygulama kimliği olarak da adlandırılır.
- Uygulamanızın paket adını modülünüzde (uygulama düzeyinde) Gradle dosyanızda bulun. Bu dosya genellikle app/build.gradle olur (örnek paket adı: com.yourcompany.yourproject).
- Paket adı değerinin büyük/küçük harfe duyarlı olduğunu ve Firebase projenize kaydedildikten sonra bu Firebase Android uygulaması için değiştirilemeyeceğini unutmayın.
Uygulamanızın kullandığı paket adını girdiğinizden emin olun. Paket adı değeri büyük/küçük harfe duyarlıdır ve Firebase projenize kaydedildikten sonra bu Firebase Android uygulaması için değiştirilemez.
(İsteğe bağlı) Diğer uygulama bilgilerini girin: Uygulama takma adı ve Hata ayıklama imzalama sertifikası SHA-1.
Uygulama takma adı ve Hata ayıklama imzalama sertifikası SHA-1, Firebase'de nasıl kullanılır?
- Uygulama takma adı: Yalnızca Firebase konsolunda size görünen dahili ve kolaylık sağlayan bir tanımlayıcı
- Hata ayıklama imza sertifikası SHA-1: Firebase Authentication (Google ile oturum açma veya telefon numarasıyla oturum açma kullanılırken) ve Firebase Dynamic Links için SHA-1 karma gerekir.
Uygulamayı kaydet'i tıklayın.

4. adım: Firebase yapılandırma dosyasını ekleyin

Firebase Android yapılandırma dosyanızı edinmek için google-services.json dosyasını indir'i tıklayın.
Bu yapılandırma dosyası hakkında bilmeniz gerekenler nelerdir?
- Firebase yapılandırma dosyasında projeniz ve uygulamanız için benzersiz ancak gizli olmayan tanımlayıcılar bulunur. Bu yapılandırma dosyası hakkında daha fazla bilgi edinmek için Firebase projelerini anlama başlıklı makaleyi inceleyin.
- Firebase yapılandırma dosyanızı istediğiniz zaman tekrar indirebilirsiniz.
- Yapılandırma dosyası adına (2) gibi ek karakterler eklenmediğinden emin olun.
C++ projenizi bir IDE'de açın, ardından 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 String Resources 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 google-services eklentisini en üst düzeydeki build.gradle dosyanıza 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.3'  // Google Services plugin
      implementation 'com.google.android.gms:18.7.2'
    }
  }

  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 görevlerini 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 ve 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ünleri için 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 etkinleştirilmedi

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 etkinleştirilmedi

# 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'e Firebase'i başarıyla entegre ettiğinizi doğrulayan bir mesaj göndermek için uygulamanızı çalıştırın. Aksi takdirde doğrulama adımını atlayabilirsiniz.

Cihaz günlüklerinizde, başlatma işleminin tamamlandığına dair 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 kaydedilmiş ve yapılandırılmış olmalıdır.

(isteğe bağlı alternatif) SDK'ları eklemek için ndk-build'i kullanma

Android NDK v10d veya sonraki bir sürümünün yüklü olduğundan emin olun.
Firebase C++ SDK'sını indirin ve SDK'yı uygun bir konumda arşivden çıkarın.

Firebase C++ SDK'sı platforma özgü değildir ancak platforma özgü kitaplıklar içerir.
local.properties dosyanızı açın ve:
- firebase_cpp_sdk.dir değişkenini, sıkıştırılmamış Firebase C++ SDK'sının konumuna ayarlayın.
- ndk.dir değişkenini Android NDK'nın konumuna ayarlayın.

Gradle'ın yerleşik ndkBuild desteğini kullanmak için üst düzey dizininizde bir jni dizini oluşturun, ardından aşağıdaki make dosyalarını oluşturun.

Aşağıdaki bilgileri içeren bir jni/Application.mk dosyası oluşturun:

APP_PLATFORM:=android-14
NDK_TOOLCHAIN_VERSION=clang
APP_ABI:=armeabi-v7a arm64-v8a x86 x86_64
APP_STL:=c++_static
APP_MODULES:=android_main
APP_CPPFLAGS+=-std=c++11

Aşağıdaki içeriğe sahip bir jni/Android.mk dosyası oluşturun.

Kullanmak istediğiniz Firebase ürününün kitaplıklarını ekleyin. Örneğin, Analytics kullanmak için:

LOCAL_PATH:=$(call my-dir)/..

ifeq ($(FIREBASE_CPP_SDK_DIR),)
$(error FIREBASE_CPP_SDK_DIR must specify the Firebase package location.)
endif

# With Firebase libraries for the selected build configuration (ABI + STL)
STL:=$(firstword $(subst _, ,$(APP_STL)))
FIREBASE_LIBRARY_PATH:=\
$(FIREBASE_CPP_SDK_DIR)/libs/android/$(TARGET_ARCH_ABI)/$(STL)

# The Firebase C++ library `libfirebase_app.a` is required for all Firebase products.
include $(CLEAR_VARS)
LOCAL_MODULE:=firebase_app
LOCAL_SRC_FILES:=$(FIREBASE_LIBRARY_PATH)/libfirebase_app.a
LOCAL_EXPORT_C_INCLUDES:=$(FIREBASE_CPP_SDK_DIR)/include
include $(PREBUILT_STATIC_LIBRARY)

# Include the Firebase library for Google Analytics.
# Note: Duplicate this block for each Firebase product that you want
# to use in your app, and replace variable values as appropriate.
include $(CLEAR_VARS)
LOCAL_MODULE:=firebase_analytics
LOCAL_SRC_FILES:=$(FIREBASE_LIBRARY_PATH)/libfirebase_analytics.a
LOCAL_EXPORT_C_INCLUDES:=$(FIREBASE_CPP_SDK_DIR)/include
include $(PREBUILT_STATIC_LIBRARY)

include $(CLEAR_VARS)
LOCAL_MODULE:=android_main
# Reference your project's C++ source files
LOCAL_SRC_FILES:=\
  $(LOCAL_PATH)/src/common_main.cc \
  $(LOCAL_PATH)/src/android/android_main.cc
LOCAL_STATIC_LIBRARIES:=\
  firebase_analytics \
  firebase_app  # this library reference must always be listed last
LOCAL_WHOLE_STATIC_LIBRARIES:=\
  android_native_app_glue
LOCAL_C_INCLUDES:=\
  $(NDK_ROOT)/sources/android/native_app_glue \
  $(LOCAL_PATH)/src
LOCAL_LDLIBS:=-llog -landroid -latomic
LOCAL_ARM_MODE:=arm
LOCAL_LDFLAGS:=-Wl,-z,defs -Wl,--no-undefined
include $(BUILD_SHARED_LIBRARY)

$(call import-add-path,$(NDK_ROOT)/sources/android)
$(call import-module,android/native_app_glue)

Üst düzey build.gradle dosyanızı açın ve aşağıdaki adımları tamamlayın:

Kullanmak istediğiniz Firebase ürünleri için bağımlılıkları ekleyin. Örneğin, Analytics kullanmak için:
```
dependencies {
  implementation 'com.google.firebase:firebase-analytics:21.0.0'
}
```

Projenizin, jni/Android.mk dosyanızda belirtilen Firebase kitaplıklarını dahil etmek için Gradle'ın yerleşik ndk-build desteğini kullanması amacıyla aşağıdaki satırları ekleyin.

android {
// ...
    defaultConfig {
        // ...
        externalNativeBuild.ndkBuild {
            arguments "FIREBASE_CPP_SDK_DIR=${project.ext.firebase_cpp_sdk_dir}",
                      "NDK_APPLICTION_MK=jni/Application.mk",
                      sprintf("APP_PLATFORM=android-%d",
                      android.defaultConfig.minSdkVersion.mApiLevel)
        }
    }
}

Android için kullanılabilen kitaplıklar (ndk-build kullanılarak)

Her Firebase ürününün farklı bağımlılıkları vardır. Kullanmak istediğiniz Firebase ürünleri için listelenen tüm bağımlılıkları eklediğinizden emin olun.

Firebase C++ kitaplıklarını (ör. libfirebase_app.a) üst düzey jni/Android.mk dosyasına ekleyerek kullanın. Diğer bağımlılıklar (ör. com.google.firebase:firebase-auth) için bunları üst düzey build.gradle dosyanıza ekleyin.

Önemli: Firebase C++ SDK'sının her sürümü, her modül için belirli Firebase Android SDK sürümlerine sabitlenir. Firebase C++ SDK sürümünüzü güncellerseniz build.gradle dosyanızda referans verilen Firebase Android SDK sürümlerini de aşağıdaki sürüm numaralarıyla eşleşecek şekilde güncellediğinizden emin olun.

Artık Android kitaplığını eklemeniz gerekmiyor com.google.firebase:firebase-core. Bu SDK, Google Analytics için Firebase SDK'sını içeriyordu. Artık Analytics (veya Analytics kullanımını gerektiren ya da öneren Firebase ürünlerinden herhangi birini) kullanmak için Analytics bağımlılığını açıkça eklemeniz gerekir: com.google.firebase:firebase-analytics:21.0.0.

Firebase ürünü	Kitaplıklar ve Bağımlılıklar
AdMob	`libfirebase_admob.a` (zorunlu) `libfirebase_analytics.a` (zorunlu) `libfirebase_app.a` `implementation 'com.google.firebase:firebase-ads:19.8.0'` (zorunlu) `implementation 'com.google.firebase:firebase-analytics:21.0.0'`
Analytics	`libfirebase_analytics.a` (zorunlu) `libfirebase_app.a` `implementation 'com.google.firebase:firebase-analytics:21.0.0'`
App Check	`libfirebase_app_check.a` (zorunlu) `libfirebase_app.a` `implementation 'com.google.firebase:firebase-appcheck:17.0.0'`
Authentication	`libfirebase_auth.a` (zorunlu) `libfirebase_app.a` `implementation 'com.google.firebase:firebase-auth:21.0.5'`
Cloud Firestore	`libfirebase_firestore.a` (zorunlu) `libfirebase_app.a` `implementation 'com.google.firebase:firebase-firestore:24.1.2'`
Cloud Functions	`libfirebase_functions.a` (zorunlu) `libfirebase_app.a` `implementation 'com.google.firebase:firebase-functions:20.1.0'`
Cloud Messaging	`libfirebase_messaging.a` (önerilir) `libfirebase_analytics.a` (zorunlu) `libfirebase_app.a` `implementation 'com.google.firebase:firebase-messaging:23.0.5'` (önerilir) `implementation 'com.google.firebase:firebase-analytics:21.0.0'`
Cloud Storage	`libfirebase_storage.a` (zorunlu) `libfirebase_app.a` `implementation 'com.google.firebase:firebase-storage:20.0.1'`
Dynamic Links	`ibfirebase_dynamic_links.a` (önerilir) `libfirebase_analytics.a` (zorunlu) `libfirebase_app.a` `implementation 'com.google.firebase:firebase-dynamic-links:21.0.1'` (önerilir) `implementation 'com.google.firebase:firebase-analytics:21.0.0'`
Realtime Database	`libfirebase_database.a` (zorunlu) `libfirebase_app.a` `implementation 'com.google.firebase:firebase-database:20.0.5'`
Remote Config	`libfirebase_remote_config.a` (önerilir) `libfirebase_analytics.a` (zorunlu) `libfirebase_app.a` `implementation 'com.google.firebase:firebase-config:21.1.0'` (önerilir) `implementation 'com.google.firebase:firebase-analytics:21.0.0'`

Kullanılabilen kitaplıklar

C++ Firebase kitaplıkları hakkında daha fazla bilgiyi referans belgelerinde ve GitHub'daki açık kaynak SDK sürümümüzde bulabilirsiniz.

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ı (`firebaseCpp.dependencies` for `build.gradle` dosyası için)	Kitaplık referansları (`firebase_libs` for `CMakeLists.txt` dosyası için)
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` (önerilir) `firebase_analytics` (zorunlu) `firebase_app`
Cloud Storage	`storage`	`firebase_storage` (zorunlu) `firebase_app`
Dynamic Links	`dynamicLinks`	`firebase_dynamic_links` (önerilir) `firebase_analytics` (zorunlu) `firebase_app`
Realtime Database	`database`	`firebase_database` (zorunlu) `firebase_app`
Remote Config	`remoteConfig`	`firebase_remote_config` (önerilir) `firebase_analytics` (zorunlu) `firebase_app`

Mobil kurulum hakkında 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, projenize ekleyebileceğiniz google-services.json kaynaklarını .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 dönüşümün aynısını uygular.

Gradle kullanarak derleme yapmıyorsanız (örneğin, ndk-build, makefile'lar, Visual Studio vb. kullanıyorsanız) Android String Kaynakları oluşturma işlemini 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 modundaki derlemelerde ProGuard'ı kullanır.

ProGuard kullanıyorsanız libs/android/*.pro ProGuard yapılandırmanızda kullandığınız Firebase C++ kitaplıklarına karşılık gelen dosyaları 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ığı başlatma sırasında kInitResultFailedMissingDependency değerini döndürüyorsa Google Play Hizmetleri'nin istemci cihazda kullanılamadığı (güncellenmesi, yeniden etkinleştirilmesi, izinlerin düzeltilmesi vb. gerektiği) anlamına gelir. İstemci cihazdaki durum düzeltilene kadar Firebase kitaplığı kullanılamaz.

Google Play Hizmetleri'nin neden istemci cihazda kullanılamadığını google_play_services/availability.h bölümündeki işlevleri kullanarak öğrenebilir (ve sorunu düzeltmeyi deneyebilirsiniz).

Not: Bazı Firebase kitaplıkları Google Play Hizmetleri gerektirmez. Bu nedenle, başlatma durumu döndürmez ve istemci cihazda Google Play Hizmetleri olmadan kullanılabilir.

Aşağıdaki tabloda, desteklenen her Firebase ürünü için Google Play Hizmetleri'nin istemci cihazda gerekli olup olmadığı listelenmektedir.

Firebase C++ Kitaplığı	İstemci cihazda Google Play Hizmetleri gerekli mi?
AdMob	Gerekli 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

Google Mobile AdsAndroid için SDK'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ğıdaki koşulların her ikisi de geçerliyse kInitResultFailedMissingDependency değerini döndürür:

Google Play Hizmetleri, istemci cihazda kullanılamıyor.
com.google.android.gms:play-services-ads-lite kullanıyorsunuz.

Masaüstü iş akışı oluşturma (beta)

Oyun oluştururken oyununuzu önce masaüstü platformlarda test etmek, ardından geliştirme sürecinin ilerleyen aşamalarında mobil cihazlarda dağıtıp test etmek genellikle çok daha kolaydır. Bu iş akışını desteklemek için Windows, macOS, Linux ve C++ düzenleyicisinde çalıştırılabilen Firebase C++ SDK'larının bir alt kümesini sunuyoruz.

Masaüstü iş akışları için aşağıdakileri tamamlamanız gerekir:
1. C++ projenizi CMake için yapılandırın.
2. Firebase projesi oluşturma
3. Uygulamanızı (iOS veya Android) Firebase'e kaydetme
4. 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çin GoogleService-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 kurulumu iş akışında 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.
Firebase SDK'larını C++ projenize ekleyin.

Aşağıdaki adımlar, desteklenen herhangi bir Firebase ürününü C++ projenize nasıl ekleyeceğinize dair bir örnek olarak verilmiştir. Bu örnekte, Firebase Authentication ve Firebase Realtime Database ekleme adımları açıklanmaktadır.
1. FIREBASE_CPP_SDK_DIR ortam değişkeninizi, sıkıştırılmamış Firebase C++ SDK'sının konumuna ayarlayın.
2. 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 kitaplıklar (masaüstü)

Firebase C++ SDK'sı, özelliklerin bir 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 geliştirme yaparken kolaylık sağlamak amacıyla kalan masaüstü kitaplıklarını stub (işlevsel olmayan) uygulamalar olarak sunar. Bu nedenle, masaüstü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 beyan etmeniz gerekir. Aksi takdirde dinleyicileriniz başarısız olur.

Masaüstü kurulumuyla ilgili 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
Hedef: Yayın ve Hata Ayıklama

Aşağıdaki kitaplıkların Visual Studio 2015 ve 2017 kullanılarak test edildiğini unutmayın.

Windows'da C++ masaüstü uygulamaları oluştururken aşağıdaki Windows SDK kitaplıklarını projenize bağlayın. Daha fazla bilgi için derleyici belgelerinize bakın.

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 kitaplıkları

macOS (Darwin) için 64 bit (x86_64) platformunda kitaplık sürümleri sağlanır. Size kolaylık sağlamak için çerçeveler de sunulur.

macOS kitaplıklarının Xcode 16.2 kullanılarak test edildiğini unutmayın.

macOS'te C++ masaüstü uygulamaları oluştururken projenize aşağıdakileri bağlayın:

pthread sistem kitaplığı
CoreFoundation macOS sistem çerçevesi
Foundation macOS sistem çerçevesi
Security macOS sistem çerçevesi
GSS macOS sistem çerçevesi
Kerberos macOS sistem çerçevesi
SystemConfiguration macOS sistem çerçevesi

Daha fazla bilgi için derleyici belgelerinize bakın.

Linux kitaplıkları

Linux için 32 bit (i386) ve 64 bit (x86_64) platformlarda kitaplık sürümleri 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'ta C++ masaüstü uygulamaları oluştururken pthread sistem kitaplığını projenize bağlayın. Daha fazla bilgi için derleyici belgelerinize bakın. GCC 5 veya sonraki bir sürümle derleme yapıyorsanız -D_GLIBCXX_USE_CXX11_ABI=0 öğesini 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ırlanma:
- Google Cloud konsolunda projeniz için bütçe uyarıları ayarlayın.
- Projenizin birden fazla Firebase hizmetindeki kullanımına dair genel bir görünüm elde etmek için Firebase konsolundaki Kullanım ve faturalandırma kontrol panelini izleyin.
- Firebase lansman kontrol listesini inceleyin.

Firebase'i C++ projenize ekleyin Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Ön koşullar

2. adım: Firebase projesi oluşturun

3. adım: Uygulamanızı Firebase'e kaydedin

4. adım: Firebase yapılandırma dosyasını ekleyin

5. adım: Firebase C++ SDK'larını ekleyin

Analytics etkin

Analytics etkinleştirilmedi

Analytics etkin

Analytics etkinleştirilmedi

(isteğe bağlı alternatif) SDK'ları eklemek için ndk-build'i kullanma

Android için kullanılabilen kitaplıklar (ndk-build kullanılarak)

Kullanılabilen kitaplıklar

Android için kullanılabilen kitaplıklar (CMake kullanılarak)

Mobil kurulum hakkında ek bilgiler

NDK kilitlenme raporlarını alma

Özel derleme sistemleri

ProGuard

Google Play Hizmetleri şartı

AdMob ve Google Play Hizmetleri

Masaüstü iş akışı oluşturma (beta)

Kullanılabilir kitaplıklar (masaüstü)

Realtime Database masaüstü

Masaüstü kurulumuyla ilgili ek bilgiler

Windows kitaplıkları

macOS kitaplıkları

Linux kitaplıkları

Sonraki adımlar

Firebase'i C++ projenize ekleyin