Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

Firebase'i C++ projenize ekleyin

C++ oyunlarınızı iOS ve Android için Firebase'in üzerinde bir C++ arabirimi sağlayan Firebase C++ SDK'larımızla güçlendirin.

Platforma özgü herhangi bir kod yazmak zorunda kalmadan Firebase'e tamamen C++ kodunuzdan erişin. Firebase SDK ayrıca Firebase tarafından kullanılan dile özgü birçok deyimi C++ geliştiricilerinin daha aşina olduğu bir arayüze çevirir.

Firebase oyunları sayfamızda oyunlarınızı Firebase ile güçlendirme hakkında daha fazla bilgi edinin.

Firebase'i zaten C++ projenize eklediniz mi? Firebase C++ SDK'nın en son sürümünü kullandığınızdan emin olun.

Önkoşullar

  • Aşağıdakileri yükleyin:

    • Xcode 13.3.1 veya üstü
    • CocoaPods 1.10.0 veya üstü
  • Projenizin aşağıdaki platform sürümlerini veya sonraki sürümleri hedeflediğinden emin olun:

    • iOS 11
  • Uygulamanızı çalıştırmak için fiziksel bir iOS cihazı kurun veya iOS simülatörünü kullanın.

  • Google hesabınızı kullanarak Firebase'de oturum açın.

Adım 2 : Bir Firebase projesi oluşturun

Firebase'i C++ projenize ekleyebilmeniz için önce C++ projenize bağlanmak üzere bir Firebase projesi oluşturmanız gerekir. Firebase projeleri hakkında daha fazla bilgi edinmek için Firebase Projelerini Anlayın sayfasını ziyaret edin.

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

Firebase'i Apple uygulamanızda kullanmak için uygulamanızı Firebase projenize kaydetmeniz gerekir. Uygulamanızı kaydettirmek genellikle uygulamanızı projenize "eklemek" olarak adlandırılır.

  1. Firebase konsoluna gidin.

  2. Kurulum iş akışını başlatmak için projeye genel bakış sayfasının ortasındaki iOS+ simgesine tıklayın.

    Firebase projenize zaten bir uygulama eklediyseniz platform seçeneklerini görüntülemek için Uygulama ekle'yi tıklayın.

  3. Paket kimliği alanına uygulamanızın paket kimliğini girin.

  4. (İsteğe bağlı) Diğer uygulama bilgilerini girin: Uygulama takma adı ve Uygulama Mağazası Kimliği .

  5. Uygulamayı kaydet'i tıklayın.

Adım 4 : Firebase yapılandırma dosyasını ekleyin

  1. Firebase Apple platformları yapılandırma dosyanızı edinmek için GoogleService-Info.plist'i İndir'i tıklayın.

  2. C++ projenizi bir IDE'de açın, ardından yapılandırma dosyanızı C++ projenizin kök dizinine sürükleyin.

  3. İstenirse, yapılandırma dosyasını tüm hedeflere eklemek için seçin.

Firebase konsolunda kurulum görevlerini tamamladınız. Aşağıdaki Firebase C++ SDK'lerini Ekleme ile devam edin.

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

Bu bölümdeki adımlar, desteklenen Firebase ürünlerini Firebase C++ projenize nasıl ekleyeceğinize bir örnektir.

  1. Firebase C++ SDK'yı indirin, ardından SDK'yı uygun bir yere sıkıştırın.

    Firebase C++ SDK, platforma özgü değildir ancak platforma özgü kitaplıklar içerir.

  2. Sıkıştırılmış SDK'dan Firebase bölmeleri ekleyin.

    1. Henüz sahip değilseniz bir Pod dosyası oluşturun:

      cd your-app-directory
      pod init

    2. Pod dosyanıza, uygulamanızda kullanmak istediğiniz Firebase bölmelerini ekleyin.

      Analitik etkinleştirildi

      # Add the Firebase pod for Google Analytics
      pod 'FirebaseAnalytics'
      # Add the pods for any other Firebase products you want to use in your app # For example, to use Firebase Authentication and Firebase Realtime Database pod 'FirebaseAuth' pod 'FirebaseDatabase'

      Analitik etkin değil

      # Add the pods for the Firebase products you want to use in your app
      # For example, to use Firebase Authentication and Firebase Realtime Database
      pod 'FirebaseAuth'
      pod 'FirebaseDatabase'
    3. Bölmeleri yükleyin, ardından .xcworkspace dosyasını Xcode'da açın.

      pod install
      tutucu17 l10n-yer
      open your-app.xcworkspace

  3. Sıkıştırılmış SDK'dan Firebase çerçeveleri ekleyin.

    Bu çerçeveleri eklemenin en kolay yolu, genellikle onları bir Finder penceresinden doğrudan Xcode'un Proje Gezgini bölmesine sürüklemektir (varsayılan olarak en soldaki bölme veya Xcode'un sol üst tarafındaki dosya simgesine tıklayın).

    1. Herhangi bir Firebase ürününü kullanmak için gerekli olan Firebase C++ çerçevesini firebase.framework ekleyin.

    2. Kullanmak istediğiniz her Firebase ürünü için çerçeveyi ekleyin. Örneğin, Firebase Authentication'ı kullanmak için firebase_auth.framework ekleyin.

  4. Firebase konsolunda, kurulum iş akışında İleri 'yi tıklayın.

  5. Analytics'i 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, bu doğrulama adımını atlayabilirsiniz.

    Cihaz günlükleriniz, başlatmanın tamamlandığını gösteren Firebase doğrulamasını görüntüler. Uygulamanızı ağ erişimi olan bir öykünücüde çalıştırdıysanız Firebase konsolu , uygulama bağlantınızın tamamlandığını size bildirir.

Hazırsınız! C++ uygulamanız kaydedildi ve Firebase ürünlerini kullanacak şekilde yapılandırıldı.

Kullanılabilir kitaplıklar

Başvuru belgelerinde ve GitHub'daki açık kaynaklı SDK sürümümüzde C++ Firebase kitaplıkları hakkında daha fazla bilgi edinin.

iOS için kullanılabilir kitaplıklar

Android için C++ kitaplıklarının bu kurulum sayfasının Android sürümünde listelendiğini unutmayın.

Her Firebase ürününün farklı bağımlılıkları vardır. İstediğiniz Firebase ürünü için listelenen tüm bağımlılıkları Podfile ve C++ projenize eklediğinizden emin olun.

Firebase ürünü Çerçeveler ve Bölmeler
adMob (gerekli) firebase.framework
firebase_admob.framework
(gerekli) firebase_analytics.framework

pod 'FirebaseAdMob', '10.2.0'
(gerekli) pod 'FirebaseAnalytics', '10.2.0'
Analitik (gerekli) firebase.framework
firebase_analytics.framework

pod 'FirebaseAnalytics', '10.2.0'
kimlik doğrulama (gerekli) firebase.framework
firebase_auth.framework

pod 'FirebaseAuth', '10.2.0'
Bulut Firestore (gerekli) firebase.framework
firebase_firestore.framework
firebase_auth.framework

pod 'FirebaseFirestore', '10.2.0'
pod 'FirebaseAuth', '10.2.0'
Bulut İşlevleri (gerekli) firebase.framework
firebase_functions.framework

pod 'FirebaseFunctions', '10.2.0'
Bulut Mesajlaşma (gerekli) firebase.framework
firebase_messaging.framework
(önerilen) firebase_analytics.framework

pod 'FirebaseMessaging', '10.2.0'
(önerilen) pod 'FirebaseAnalytics', '10.2.0'
Bulut depolama (gerekli) firebase.framework
firebase_storage.framework

pod 'FirebaseStorage', '10.2.0'
Dinamik Bağlantılar (gerekli) firebase.framework
firebase_dynamic_links.framework
(önerilen) firebase_analytics.framework

pod 'FirebaseDynamicLinks', '10.2.0'
(önerilen) pod 'FirebaseAnalytics', '10.2.0'
Gerçek Zamanlı Veritabanı (gerekli) firebase.framework
firebase_database.framework

pod 'FirebaseDatabase', '10.2.0'
Uzak Yapılandırma (gerekli) firebase.framework
firebase_remote_config.framework
(önerilen) firebase_analytics.framework

pod 'FirebaseRemoteConfig', '10.2.0'
(önerilen) pod 'FirebaseAnalytics', '10.2.0'

Mobil kurulum için ek bilgiler

yöntem swizzling

iOS'ta, bazı uygulama olayları (URL'lerin açılması ve bildirimlerin alınması gibi), uygulama temsilcinizin belirli yöntemleri uygulamasını gerektirir. Örneğin, bir bildirim almak, uygulama temsilcinizin application:didReceiveRemoteNotification: gerektirebilir. Her iOS uygulamasının kendi uygulama temsilcisi olduğundan Firebase, uygulamış olabileceklerinize ek olarak kendi işleyicilerini eklemek için bir yöntemin diğeriyle değiştirilmesine izin veren swizzling yöntemini kullanır.

Dynamic Links ve Cloud Messaging kitaplıklarının, swizzling yöntemini kullanarak uygulama temsilcisine işleyiciler eklemesi gerekir. Bu Firebase ürünlerinden herhangi birini kullanıyorsanız, yükleme sırasında Firebase, AppDelegate sınıfınızı tanımlayacak ve mevcut yöntem uygulamanıza bir geri çağrı zinciri oluşturarak gerekli yöntemleri sınıfa aktaracaktır.

Bir masaüstü iş akışı kurun ( beta )

Bir oyun oluştururken, oyununuzu önce masaüstü platformlarda test etmek, ardından geliştirme aşamasında mobil cihazlarda dağıtmak ve test etmek genellikle çok daha kolaydır. Bu iş akışını desteklemek için Windows, macOS, Linux üzerinde ve C++ düzenleyici içinden çalışabilen Firebase C++ SDK'lerinin bir alt kümesini sağlıyoruz.

  1. Masaüstü iş akışları için aşağıdakileri tamamlamanız gerekir:

    1. C++ projenizi CMake için yapılandırın.
    2. Bir Firebase projesi oluşturun
    3. Uygulamanızı (iOS veya Android) Firebase'e kaydedin
    4. Bir mobil platform Firebase yapılandırma dosyası ekleyin
  2. Firebase yapılandırma dosyasının bir 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ı bir 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 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 Anlayın sayfasını ziyaret edin.

  3. C++ projenize Firebase SDK'ları ekleyin.

    Aşağıdaki adımlar, desteklenen herhangi bir Firebase ürününü C++ projenize nasıl ekleyeceğiniz konusunda örnek niteliğindedir. Bu örnekte, Firebase Authentication ve Firebase Realtime Database ekleme adımlarını inceleyeceğiz.

    1. FIREBASE_CPP_SDK_DIR ortam değişkeninizi sıkıştırılmış Firebase C++ SDK'nın konumuna ayarlayın.

    2. Projenizin CMakeLists.txt dosyasına, kullanmak istediğiniz Firebase ürünlerine ait kitaplıklar da dahil olmak üzere aşağıdaki içeriği ekleyin. Örneğin, Firebase Authentication ve Firebase Realtime Database'i 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}")
      
  4. Run your C++ app.

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

Firebase C++ SDK, bir dizi özellik için masaüstü iş akışı desteği içerir ve Firebase'in belirli bölümlerinin Windows, macOS ve Linux'ta bağımsız masaüstü yapılarında kullanılmasını sağlar.

Firebase ürünü Kitaplık referansları (CMake kullanılarak)
kimlik doğrulama firebase_auth
(required) firebase_app
Bulut Firestore firebase_firestore
firebase_auth
firebase_app
Bulut İşlevleri firebase_functions
(gerekli) firebase_app
Bulut depolama firebase_storage
(gerekli) firebase_app
Gerçek Zamanlı Veritabanı firebase_database
(gerekli) firebase_app
Remote Config firebase_remote_config
(gerekli) firebase_app

Firebase, Windows, macOS ve Linux için derleme yaparken kolaylık sağlamak için kalan masaüstü kitaplıklarını saplama (işlevsel olmayan) uygulamalar olarak sağlar. Bu nedenle, masaüstünü hedeflemek için koşullu olarak kod derlemeniz gerekmez.

Gerçek Zamanlı Veritabanı masaüstü

Masaüstü için Realtime Database SDK, veritabanınıza erişmek için REST kullanır, bu nedenle masaüstünde Query::OrderByChild() ile kullandığınız dizinleri bildirmeniz gerekir, aksi takdirde dinleyicileriniz başarısız olur.

Masaüstü kurulumu için ek bilgiler

Windows kitaplıkları

For Windows, library versions are provided based on the following:

  • Build platform: 32-bit (x86) vs 64-bit (x64) mode
  • Windows runtime environment: Multithreaded / MT vs Multithreaded DLL /MD
  • Hedef: Sürüm ve Hata Ayıklama

Note that the following libraries were tested using Visual Studio 2015 and 2017.

When building C++ desktop apps on Windows, link the following Windows SDK libraries to your project. Consult your compiler documentation for more information.

Firebase C++ Kitaplığı Windows SDK kitaplığı bağımlılıkları
Authentication advapi32, ws2_32, crypt32
Bulut Firestore advapi32, ws2_32, crypt32, rpcrt4, ole32, shell32
Bulut İşlevleri advapi32, ws2_32, crypt32, rpcrt4, ole32
Bulut depolama advapi32, ws2_32, crypt32
Realtime Database advapi32, ws2_32, crypt32, iphlpapi, psapi, userenv
Uzak Yapılandırma advapi32, ws2_32, crypt32, rpcrt4, ole32

macOS kitaplıkları

For macOS (Darwin), library versions are provided for the 64-bit (x86_64) platform. Frameworks are also provided for your convenience.

Note that the macOS libraries have been tested using Xcode 13.3.1.

When building C++ desktop apps on macOS, link the following to your project:

  • pthread system library
  • 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
  • Sistem SystemConfiguration macOS sistem çerçevesi

Consult your compiler documentation for more information.

Linux libraries

For Linux, library versions are provided for 32-bit (i386) and 64-bit (x86_64) platforms.

Note that the Linux libraries were tested using GCC 4.8.0, GCC 7.2.0, and Clang 5.0 on Ubuntu.

When building C++ desktop apps on Linux, link the pthread system library to your project. Consult your compiler documentation for more information. GCC 5 veya üstü ile oluşturuyorsanız, -D_GLIBCXX_USE_CXX11_ABI=0 tanımlayın.

Sonraki adımlar