C ++ projenize
İOS ve Android için Firebase'in yanı sıra C ++ arabirimi sağlayan 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 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.
Önkoşullar
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.
Bulut Mesajlaşma kullanmak istiyor musunuz?
İOS'ta Bulut Mesajlaşma için ön koşullar şunlardır:
- Fiziksel bir iOS cihazı kurun.
- Apple Geliştirici hesabınız için bir Apple Push Bildirimi Kimlik Doğrulama Anahtarı edinin.
- Xcode'da Uygulama> Yetenekler altında Push Bildirimleri etkinleştirin.
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 bölümünü ziyaret edin.
Firebase projesi oluşturun
Firebase konsolunda Proje ekle'yi tıklayın, ardından bir Proje adı seçin veya girin.
Mevcut bir Google Cloud Platform (GCP) projeniz varsa, o projeye Firebase kaynakları eklemek için açılır menüden projeyi seçebilirsiniz.
(İsteğe bağlı) Yeni bir proje oluşturuyorsanız, Proje Kimliğini düzenleyebilirsiniz.
Devam et'i tıklayın.
(İsteğe bağlı) Projeniz için aşağıdaki Firebase ürünlerinden herhangi birini kullanarak en iyi deneyimi yaşamanızı sağlayan Google Analytics'i kurun:
İstendiğinde, mevcut bir Google Analytics hesabını kullanmayı veya yeni bir hesap oluşturmayı seçin.
Yeni bir hesap oluşturmayı seçerseniz, Analytics raporlama konumunuzu seçin, ardından projeniz için veri paylaşım ayarlarını ve Google Analytics şartlarını kabul edin.
Proje oluştur'u (veya mevcut bir GCP projesini kullanıyorsanız Firebase Ekle'yi ) tıklayın.
Firebase, Firebase projeniz için kaynakları otomatik olarak sağlar. İşlem tamamlandığında, Firebase konsolundaki Firebase projenizin genel bakış sayfasına yönlendirileceksiniz.
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 dikkate alınması gereken noktalar hakkında daha fazla bilgi edinmek için Firebase Projelerini Anlama bölümünü ziyaret edin.
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.
İOS paket kimliği alanına uygulamanızın paket kimliğini girin.
Paket kimliği nedir ve nerede buluyorsunuz?
Paket kimliği , Apple'ın ekosistemindeki bir uygulamayı benzersiz şekilde tanımlar.
Paket kimliğinizi bulun: iOS projenizi Xcode'da açın, proje gezgininde en üst düzey uygulamayı seçin, ardından Genel sekmesini seçin.
Paket Tanımlayıcı alanının değeri, iOS paket kimliğidir (örneğin,
com.yourcompany.yourproject).
Paket kimliği değerinin büyük / küçük harfe duyarlı olduğunu ve Firebase projenize kaydolduktan sonra bu Firebase iOS uygulaması için değiştirilemeyeceğini unutmayın.
(İsteğe bağlı) Diğer uygulama bilgilerini girin: Uygulama takma adı ve App Store Kimliği .
Firebase'de Uygulama takma adı ve App Store Kimliği nasıl kullanılır?
Uygulama takma adı : Yalnızca Firebase konsolunda görebileceğiniz dahili, kullanışlı bir tanımlayıcı
App Store Kimliği : Firebase Dynamic Links tarafından kullanıcıları App Store sayfanıza yönlendirmek için ve Google Analytics tarafından dönüşüm etkinliklerini Google Ads'e aktarmak için kullanılır . Uygulamanızın henüz bir App Store Kimliği yoksa kimliği daha sonra Proje ayarlarınızdan ekleyebilirsiniz.
Uygulamayı kaydet'i tıklayın.
4. Adım : Firebase yapılandırma dosyasını ekleyin
Firebase iOS yapılandırma dosyanızı almak için GoogleService-Info.plist'i İndir'i tıklayın.
Bu yapılandırma dosyası hakkında bilmeniz gerekenler nelerdir?
Firebase yapılandırma dosyası, projeniz için benzersiz, ancak gizli olmayan tanımlayıcılar içerir. Bu yapılandırma dosyası hakkında daha fazla bilgi edinmek için Firebase Projelerini Anlama sayfasını ziyaret edin.
Firebase yapılandırma dosyanızı istediğiniz zaman tekrar indirebilirsiniz.
Yapılandırma dosyası adına
(2)gibi ek karakterlerin eklenmediğinden emin olun.
C ++ projenizi bir IDE'de açın, ardından yapılandırma dosyanızı C ++ projenizin köküne sürükleyin.
İstenirse, yapılandırma dosyasını tüm hedeflere eklemeyi seçin.
Firebase konsolunda kurulum görevleri 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.
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.
Sıkıştırılmamış SDK'dan Firebase kapsülleri ekleyin.
Zaten sahip değilseniz bir Pod dosyası oluşturun:
cd your-app-directory
pod init
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'
Bölmeleri yükleyin, ardından
.xcworkspacedosyasını
.xcworkspaceaçın.
pod install
open your-app.xcworkspace
Açılmış SDK'dan Firebase çerçevelerini ekleyin.
Bu çerçeveleri eklemenin en kolay yolu genellikle onları bir
Finderpenceresinden 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.
Herhangi bir Firebase ürününü kullanmak için gerekli olan
firebase.frameworkC ++ çerçevesini
firebase.frameworkekleyin.
Kullanmak istediğiniz her Firebase ürünü için çerçeveyi ekleyin. Örneğin,
firebase_auth.frameworkAuthentication'ı kullanmak için
firebase_auth.frameworkekleyin.
Geri Firebase konsolunda, kurulum iş akışında, İleri'yi tıklayın.
Analytics eklediyseniz, Firebase'e Firebase'i başarıyla entegre ettiğinize dair doğrulama 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
İ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) |
(gerekli)
(gerekli)
|Analitik|| (gerekli) |
|Doğrulama|| (gerekli) |
|Cloud Firestore (alfa)|| (gerekli) |
|Bulut İşlevleri|| (gerekli) |
|Bulut Mesajlaşma|| (gerekli) |
(önerilen)
(önerilen)
|Bulut depolama|| (gerekli) |
|Dinamik Bağlantılar|| (gerekli) |
(önerilen)
(önerilen)
|Gerçek Zamanlı Veritabanı|| (gerekli) |
|Uzaktan Yapılandırma|| (gerekli) |
(önerilen)
(önerilen)
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ını gerektirir. Örneğin, bir bildirim almak, 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 değiştirme 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 sınıfın üzerine
AppDelegate mevcut yöntem uygulamanıza bir geri arama zinciri uygular.
Bir masaüstü iş akışı ( beta ) ayarlayın
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 ve C ++ düzenleyicisinin içinden çalışabilen Firebase C ++ SDK'larının bir alt kümesini sağlıyoruz.
Masaüstü iş akışları için aşağıdakileri tamamlamanız gerekir:
- CMake için C ++ projenizi yapılandırın.
- Firebase projesi oluşturun
- Uygulamanızı (iOS veya Android) Firebase'e kaydedin
- Mobil platform Firebase yapılandırma dosyası ekleyin
Firebase yapılandırma dosyasının bir masaüstü sürümünü oluşturun:
Android
google-services.jsondosyası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.plistdosyası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.plistdosyanızla aynı
GoogleService-Info.plistaş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.
Firebase SDK'larını C ++ projenize ekleyin.
FIREBASE_CPP_SDK_DIRortam değişkeninizi,
FIREBASE_CPP_SDK_DIRC ++ SDK'sının konumuna ayarlayın.
Projenizin
CMakeLists.txtdosyası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}")
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)|
|Doğrulama|| |
(gerekli)
|Cloud Firestore (alfa)|| |
|Bulut İşlevleri|| |
(gerekli)
|Bulut depolama|| |
(gerekli)
|Gerçek Zamanlı Veritabanı|| |
(gerekli)
|Uzaktan Yapılandırma|| |
(gerekli)
Firebase, Windows, macOS ve Linux için derlerken 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ı: Çok iş parçacıklı / MT ve Çok iş parçacıklı 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ı|
|Doğrulama|| |
|Cloud Firestore|| |
|Bulut İşlevleri|| |
|Bulut depolama|| |
|Gerçek Zamanlı Veritabanı|| |
|Uzaktan Yapılandırma|| |
macOS kitaplıkları
MacOS (Darwin) için, kitaplık sürümleri 64 bit (x86_64) platformu için sağlanmıştır. Rahatınız 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:
-
pthreadsistem kitaplığı
-
CoreFoundationmacOS sistem çerçevesi
-
FoundationmacOS sistem çerçevesi
-
SecuritymacOS sistem çerçevesi
-
GSSmacOS sistem çerçevesi
-
KerberosmacOS sistem çerçevesi
-
SystemConfigurationmacOS 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.