Google is committed to advancing racial equity for Black communities. See how.
Bu sayfa, Cloud Translation API ile çevrilmiştir.
Switch to English

C ++ projenize

İOS ve Android için Firebase'in yanı sıra C ++ arabirimi sunan Firebase C ++ SDK'larımızla C ++ oyunlarınızı güçlendirin.

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

Oyunlarınızı Firebase ile güçlendirmek hakkında daha fazla bilgiyi Firebase oyunları sayfamızda bulabilirsiniz .

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

Ön şartlar

  • Aşağıdakileri kurun:

    • Xcode 10.3.0 veya üzeri
    • CocoaPods 1.4.0 veya üstü
  • Projenizin iOS 8 veya üzerini hedeflediğinden emin olun.

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

2. Adım : Firebase projesi oluşturun

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

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

Bir Firebase projeniz olduktan sonra, iOS uygulamanızı buna ekleyebilirsiniz.

Birden çok derleme varyantının nasıl işleneceği de dahil olmak üzere, bir Firebase projesine uygulama eklemeye yönelik en iyi uygulamalar ve dikkat edilmesi gereken noktalar hakkında daha fazla bilgi edinmek için Firebase Projelerini Anlama sayfasını ziyaret edin.

  1. Firebase konsoluna gidin .

  2. Projeye genel bakış sayfasının , kurulum iş akışını başlatmak için 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. İOS 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 App Store Kimliği .

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

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

  1. Firebase iOS yapılandırma dosyanızı almak 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üne sürükleyin.

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

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

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

Bu bölümdeki adımlar, Firebase C ++ projenize desteklenen Firebase ürünlerinin nasıl ekleneceğinin bir örneğidir.

  1. Firebase C ++ SDK'yı indirin, ardından SDK'yı uygun bir yerde açın.

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

  2. Sıkıştırılmamış SDK'dan Firebase kapsülleri ekleyin.

    1. Zaten 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.

      Analytics etkinleştirildi

      # Add the Firebase pod for Google Analytics
      pod 'Firebase/Analytics'
      # 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 'Firebase/Auth' pod 'Firebase/Database'

      Analytics etkinleştirilmedi

      # 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 'Firebase/Auth'
      pod 'Firebase/Database'
    3. Bölmeleri yükleyin, ardından .xcworkspace dosyasını .xcworkspace açın.

      pod install
      open your-app.xcworkspace

  3. Açılmış SDK'dan Firebase çerçevelerini ekleyin.

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

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

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

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

  5. Analytics eklediyseniz, Firebase'e 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ığına dair Firebase doğrulamasını gösterecektir. 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ı size bildirir.

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

Mevcut kitaplıklar

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

İOS için mevcut 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. Podfile ve C ++ projenize istenen Firebase ürünü için listelenen tüm bağımlılıkları eklediğinizden emin olun.

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

pod 'Firebase/AdMob', '6.24.0'
(gerekli) pod 'Firebase/Analytics', '6.24.0'
analitik (gerekli) firebase.framework
firebase_analytics.framework

pod 'Firebase/Analytics', '6.24.0'
Kimlik Doğrulama (gerekli) firebase.framework
firebase_auth.framework

pod 'Firebase/Auth', '6.24.0'
Cloud Firestore (alfa) (gerekli) firebase.framework
firebase_firestore.framework
firebase_auth.framework

pod 'Firebase/Firestore', '6.24.0'
pod 'Firebase/Auth', '6.24.0'
Bulut İşlevleri (gerekli) firebase.framework
firebase_functions.framework

pod 'Firebase/Functions', '6.24.0'
Bulut Mesajlaşma (gerekli) firebase.framework
firebase_messaging.framework
(önerilen) firebase_analytics.framework

pod 'Firebase/Messaging', '6.24.0'
(önerilen) pod 'Firebase/Analytics', '6.24.0'
Bulut depolama (gerekli) firebase.framework
firebase_storage.framework

pod 'Firebase/Storage', '6.24.0'
Dinamik Bağlantılar (gerekli) firebase.framework
firebase_dynamic_links.framework
(önerilen) firebase_analytics.framework

pod 'Firebase/DynamicLinks', '6.24.0'
(önerilen) pod 'Firebase/Analytics', '6.24.0'
Gerçek Zamanlı Veritabanı (gerekli) firebase.framework
firebase_database.framework

pod 'Firebase/Database', '6.24.0'
Uzaktan Yapılandırma (gerekli) firebase.framework
firebase_remote_config.framework
(önerilen) firebase_analytics.framework

pod 'Firebase/RemoteConfig', '6.24.0'
(önerilen) pod 'Firebase/Analytics', '6.24.0'

Mobil kurulum için ek bilgiler

Yöntem çevirme

İOS'ta, bazı uygulama olayları (URL'leri açma ve bildirim alma gibi) uygulamanızın belirli yöntemleri uygulaması için temsilci gerektirir. Örneğin, bir bildirim almanız, uygulama temsilcinizin uygulamayı gerçekleştirmesini gerektirebilir application:didReceiveRemoteNotification: Her iOS uygulamasının kendi uygulama temsilcisi olduğu için Firebase , uyguladığınız yönteme ek olarak kendi işleyicilerini eklemek için bir yöntemin diğeriyle değiştirilmesine izin veren yöntem değiştirme özelliğini kullanır.

Dynamic Links ve Cloud Messaging kitaplıklarının, yöntem geçişini kullanarak uygulama temsilcisine işleyiciler eklemesi gerekir. Bu Firebase ürünlerinden herhangi birini kullanıyorsanız, yükleme anında AppDelegate , AppDelegate sınıfınızı tanımlar ve gerekli yöntemleri bunun üzerine AppDelegate mevcut yöntem uygulamanıza bir geri arama zinciri uygular.

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

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

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

    1. CMake için C ++ projenizi yapılandırın.
    2. Firebase projesi oluşturun
    3. Uygulamanızı (iOS veya Android) Firebase'e kaydedin
    4. 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.

    • GoogleService-Info.plist dosyasını GoogleService-Info.plist - 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ı GoogleService-Info.plist 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 konsolu 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 sayfasını ziyaret edin.

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

    Aşağıdaki adımlar, desteklenen herhangi bir Firebase ürününün C ++ projenize nasıl ekleneceğinin bir örneğidir. Bu örnekte, Firebase Authentication ve Firebase Realtime Database'i eklemenin üzerinden geçeceğiz.

    1. FIREBASE_CPP_SDK_DIR ortam değişkeninizi, FIREBASE_CPP_SDK_DIR C ++ SDK'sının konumuna ayarlayın.

    2. Projenizin CMakeLists.txt dosyasına, kullanmak istediğiniz Firebase ürünleri için kitaplıklar 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}")
      
  4. C ++ uygulamanızı çalıştırın.

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

Firebase C ++ SDK, bir özellik alt kümesi 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ü derlemelerinde kullanılmasını sağlar.

Firebase ürünü Kitaplık referansları (CMake kullanarak)
Kimlik Doğrulama firebase_auth
(gerekli) firebase_app
Cloud Firestore (alfa) 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
Uzaktan Yapılandırma 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 kodu koşullu olarak derlemenize gerek yoktur.

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 Query::OrderByChild() ile kullandığınız dizinleri masaüstünde bildirmeniz 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) - 64 bit (x64) modu
  • Windows çalışma zamanı ortamı: Multithreaded / MT vs Multithreaded DLL / MD
  • Hedef: Yayın - Hata Ayıklama

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

Windows üzerinde C ++ masaüstü uygulamaları oluştururken, aşağıdaki Windows SDK kitaplıklarını projenize bağlayın. Daha fazla bilgi için derleyicinizin belgelerine bakın.

Firebase C ++ Kitaplığı Windows SDK kitaplığı bağımlılıkları
Kimlik Doğrulama advapi32, ws2_32, crypt32
Cloud Firestore advapi32, ws2_32, crypt32, rpcrt4, ole32, shell32
Bulut İşlevleri advapi32, ws2_32, crypt32, rpcrt4, ole32
Bulut depolama advapi32, ws2_32, crypt32
Gerçek Zamanlı Veritabanı advapi32, ws2_32, crypt32, iphlpapi, psapi, userenv
Uzaktan Yapılandırma advapi32, ws2_32, crypt32, rpcrt4, ole32

macOS kitaplıkları

MacOS (Darwin) için, kitaplık sürümleri 64 bit (x86_64) platformu için sağlanmıştır. Size kolaylık sağlamak için çerçeveler de sağlanmıştır.

MacOS kitaplıklarının Xcode 10.3.0 kullanılarak test edildiğini unutmayın.

MacOS'ta C ++ masaüstü uygulamaları oluştururken aşağıdakileri projenize 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 derleyicinizin belgelerine bakın.

Linux kitaplıkları

Linux için, kütüphane sürümleri 32 bit (i386) ve 64 bit (x86_64) platformları için sağlanır.

Linux kitaplıklarının Ubuntu üzerinde 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 derleyicinizin belgelerine bakın. GCC 5 veya üstü ile oluşturuyorsanız, -D_GLIBCXX_USE_CXX11_ABI=0 tanımlayın.

Sonraki adımlar