C++ sağlayan Firebase C++ SDK'larımızla C++ oyunlarınızı güçlendirin. en üst düzeye çıktı.
Firebase'e hiçbir şey yazmak zorunda kalmadan tamamen C++ kodunuzdan erişin platformda yerel kod. Firebase SDK'sı ayrıca dile özgü birçok dili, Firebase tarafından kullanılan deyimler, C++ geliştiricilerine daha tanıdık gelecektir.
Firebase ile oyunlarınızı güçlendirme hakkında daha fazla bilgi için Firebase oyunları sayfası.
Firebase'i C++ projenize zaten eklediniz mi? Şunu kullandığınızdan emin olun: Firebase C++ SDK'sının en son sürümü.
Ön koşullar
Aşağıdakileri yükleyin:
- Xcode 13.3.1 veya sonraki sürümler
- CocoaPods 1.12.0 veya sonraki sürümler
Projenizin aşağıdaki platform sürümlerini veya sonraki sürümleri hedeflediğinden emin olun:
- iOS 13
- tvOS 13
Uygulamanızı çalıştırmak için fiziksel bir cihaz kurun veya simülatörü kullanın.
Firebase'de oturum açın. Google hesabı.
2. Adım: Firebase projesi oluşturun
Firebase'i C++ projenize ekleyebilmek için öncelikle bir Firebase oluşturmanız gerekir projenize bağlayacağınızdan emin olun. Ziyaret edin: Şu konular hakkında daha fazla bilgi edinmek için Firebase Projelerini Anlama: Firebase projeleri.
3. adım: Uygulamanızı Firebase'e kaydedin
Firebase'i Apple uygulamanızda kullanmak için uygulamanızı Firebase projesi. Uygulamanızı kaydetme işlemi genellikle "ekleme" olarak adlandırılır uygulamanızı belirler.
Firebase konsoluna gidin.
Projeye genel bakış sayfasının ortasındaki iOS+ simgesini tıklayın. kurulum iş akışını başlatın.
Firebase projenize daha önce uygulama eklediyseniz Uygulama ekle'yi tıklayın tıklayın.
Uygulamanızın paket kimliğini paket kimliği alanına girin.
(İsteğe bağlı) Diğer uygulama bilgilerini girin: Uygulama takma adı ve App Store kimliği.
Uygulamayı kaydet'i tıklayın.
4. Adım: Firebase yapılandırma dosyasını ekleyin
Firebase Apple'ınızı edinmek için GoogleService-Info.plist dosyasını indir'i tıklayın platform yapılandırma dosyası.
C++ projenizi IDE'de açın, ardından yapılandırma dosyanızı kök klasöre sürükleyin C++ projenizin ayrılmaz bir parçasıdır.
İstenirse yapılandırma dosyasını tüm hedeflere eklemeyi seçin.
Firebase konsolunda görevleri ayarlama işlemini tamamladınız. Şuna devam edin: Aşağıda Firebase C++ SDK'larını ekleyin.
5. Adım: Firebase C++ SDK'larını ekleyin
Bu bölümdeki adımlar, Firebase'inize desteklenen Firebase ürünlerini ekleyin. C++ projesi.
Firebase C++ SDK'sını indirin, ardından SDK'yı uygun bir yerde sıkıştırılmış dosyayı açın.
Firebase C++ SDK'sı platforma özel değildir ancak aşağıdakileri içerir: kullanabilirsiniz.
Sıkıştırılmamış SDK'dan Firebase kapsüllerini ekleyin.
Henüz yoksa bir Podfile oluşturun:
cd your-app-directory
.pod init
Podfile dosyanıza, uygulamasını indirin.
Analytics etkin
# 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'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 'FirebaseAuth' pod 'FirebaseDatabase'
Kapsülleri yükleyin, ardından
.xcworkspace
dosyasını Xcode'da açın.pod install
open your-app.xcworkspace
Açılmış dosyadan Firebase frameworks (çerçeveleri) ekleyin SDK'dır.
Bu çerçeveleri eklemenin en kolay yolu genellikle bir
Finder
penceresini doğrudan Xcode'un Project Navigator bölmesine ( varsayılan olarak en soldaki bölmede veya Xcode'un sol üst tarafındaki dosya simgesini tıklayın).firebase.framework
Firebase C++ çerçevesini ekleyin. herhangi bir Firebase ürününü kullanmanız gereklidir.Kullanmak istediğiniz her Firebase ürünü için çerçeve ekleyin. Örneğin, Örneğin, Firebase Authentication özelliğini kullanmak için
firebase_auth.framework
ekleyin.
Firebase konsolunda, kurulum iş akışında İleri'yi tıklayın.
Analytics eklentisini eklediyseniz Firebase'e doğrulama göndermek için uygulamanızı çalıştırın Firebase'i başarıyla entegre ettiğinizden emin olun. Aksi halde bu adımı atlayabilirsiniz. doğrulama adımını ele alalım.
Cihaz günlüklerinizde, başlatma işleminin gerçekleştirildiği Firebase doğrulaması gösterilir tamamlandı. Uygulamanızı ağ erişimi olan bir emülatörde çalıştırdıysanız Firebase konsolunda, uygulama bağlantınızın tamamlandığı bildirilir.
Hepsi bu kadar. C++ uygulamanız Firebase'i kullanacak şekilde kaydedildi ve yapılandırıldı ürünler.
Kullanılabilen kitaplıklar
C++ Firebase kitaplıkları hakkında daha fazla bilgiyi şurada bulabilirsiniz: referans belgeleri ve açık kaynak SDK'mızda GitHub'da sürüm oluşturabilirsiniz.
Apple platformları için kullanılabilen kitaplıklar
Android için C++ kitaplıklarının bu Android sürümünde kurulum sayfasını ziyaret edin.
Her Firebase ürününün farklı bağımlılıkları vardır. Tüm istediğiniz Firebase ürününün bağımlılıklarını Podfile'ınıza listelemiş ve C++ projesi.
Her Firebase ürünü yalnızca belirli Apple OS platformlarını destekleyebilir (iOS, tvOS vb.). Her kitaplığın hangi platformları desteklediğini kontrol edin C++ ve Firebase hakkında daha fazla bilgi edinin.
Firebase ürünü | Çerçeveler ve Kapsüller |
---|---|
AdMob |
(zorunlu) firebase.framework firebase_admob.framework (zorunlu) firebase_analytics.framework pod 'FirebaseAdMob', '11.0.0' (zorunlu) pod 'FirebaseAnalytics', '11.0.0'
|
Analytics |
(zorunlu) firebase.framework firebase_analytics.framework pod 'FirebaseAnalytics', '11.0.0'
|
App Check |
(zorunlu) firebase.framework firebase_app_check.framework pod 'FirebaseAppCheck', '11.0.0'
|
Authentication |
(zorunlu) firebase.framework firebase_auth.framework pod 'FirebaseAuth', '11.0.0'
|
Cloud Firestore |
(zorunlu) firebase.framework firebase_firestore.framework firebase_auth.framework pod 'FirebaseFirestore', '11.0.0' pod 'FirebaseAuth', '11.0.0'
|
Cloud Functions |
(zorunlu) firebase.framework firebase_functions.framework pod 'FirebaseFunctions', '11.0.0'
|
Cloud Messaging |
(zorunlu) firebase.framework firebase_messaging.framework (önerilen) firebase_analytics.framework pod 'FirebaseMessaging', '11.0.0' (önerilen) pod 'FirebaseAnalytics', '11.0.0'
|
Cloud Storage |
(zorunlu) firebase.framework firebase_storage.framework pod 'FirebaseStorage', '11.0.0'
|
Dynamic Links |
(zorunlu) firebase.framework firebase_dynamic_links.framework (önerilen) firebase_analytics.framework pod 'FirebaseDynamicLinks', '11.0.0' (önerilen) pod 'FirebaseAnalytics', '11.0.0'
|
Realtime Database |
(zorunlu) firebase.framework firebase_database.framework pod 'FirebaseDatabase', '11.0.0'
|
Remote Config |
(zorunlu) firebase.framework firebase_remote_config.framework (önerilen) firebase_analytics.framework pod 'FirebaseRemoteConfig', '11.0.0' (önerilen) pod 'FirebaseAnalytics', '11.0.0'
|
Mobil cihaz kurulumu için ek bilgiler
Yöntem değiştirme
iOS'te, bazı uygulama etkinlikleri (URL'leri açma ve alma gibi)
bildirimleri) uygulama yetkinizin belirli uygulamaları
yöntemlerine göz atın. Örneğin, bildirim almak için başvurunuzun olması gerekebilir.
application:didReceiveRemoteNotification:
uygulamak için yetki verin. Çünkü
Her iOS uygulamasının kendine ait bir uygulama temsilcisi vardır, Firebase ise
yöntem kaydırma, bir yöntemin diğeriyle değiştirilmesine olanak tanır.
işleyicisini eklemesi gerekir.
Dynamic Links ve Cloud Messaging kitaplıkları için gerekenler
uygulama temsilcisine, kaydırma yöntemini kullanarak işleyici eklemek için kullanılır. Eğer
Bu Firebase ürünlerinden herhangi birini kullanıyorsanız Firebase, yükleme sırasında
AppDelegate
sınıfınızı belirleyin ve gerekli yöntemleri buna göre karıştırın,
mevcut yöntem uygulamanıza geri çağrı
zincirlemesidir.
Masaüstü iş akışı oluşturma (beta)
Oyun geliştirirken oyununuzu masaüstünde test etmek genellikle çok daha kolaydır önce mobil cihazlarda dağıtıp test etmek, daha sonra geliştirme aşamasında bunları mobil cihazlara dağıtmak ve test etmektir. Alıcı: yardımcı oluyorum. şurada çalışabilen Firebase C++ SDK'sının alt kümesidir: Windows, macOS, Linux ve C++ düzenleyicisinden yararlanabilirsiniz.
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ş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: Firebase bu mobil dosyayı bulur ve daha sonra masaüstü Firebase yapılandırma dosyası oluşturur (google-services-desktop.json
).iOS
GoogleService-Info.plist
dosyasını eklediyseniz - Çalıştırmadan önce uygulamanız gerekiyorsa bu mobil dosyayı bir masaüstü Firebase'e dönüştürmeniz gerekir yapılandırma dosyası. Dosyayı dönüştürmek için aynı dizininiGoogleService-Info.plist
dosyanız olarak kullanın:generate_xml_from_google_services_json.py --plist -i GoogleService-Info.plist
Bu masaüstü yapılandırma dosyası, girdiğiniz C++ proje kimliğini içerir Firebase konsolu kurulum iş akışını uygulayın. Ziyaret edin: Firebase Projelerini Anlama inceleyebilirsiniz.
Firebase SDK'larını C++ projenize ekleyin.
Aşağıdaki adımlar, destekleyen Firebase ürününü adımları uygulayın. Bu örnekte, Firebase Authentication ve Firebase Realtime Database.
FIREBASE_CPP_SDK_DIR
ortam değişkeninizi şu konuma ayarlayın: çıkartılmış Firebase C++ SDK'sı.Projenizin
CMakeLists.txt
dosyasına aşağıdaki içeriği ekleyin: Bu kitapla ilgili kitaplıklar da dahil olmak üzere Firebase ürünlerini seçin. Örneğin, Firebase Authentication ve Firebase Realtime Database:# 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ı masaüstü iş akışı desteği içeriyor kullanarak Firebase'in belirli kısımlarının kullanılabilmesini sağlar. .
Firebase ürünü | Kitaplık referansları (CMake kullanarak) |
---|---|
App Check |
firebase_app_check
(gerekli) firebase_app
|
Authentication |
firebase_auth
(gerekli) firebase_app
|
Cloud Firestore |
firebase_firestore firebase_auth firebase_app
|
Cloud Functions |
firebase_functions
(gerekli) firebase_app
|
Cloud Storage |
firebase_storage
(gerekli) firebase_app
|
Realtime Database |
firebase_database
(gerekli) firebase_app
|
Remote Config |
firebase_remote_config
(gerekli) firebase_app
|
Firebase, kalan masaüstü kitaplıklarını taslak olarak sağlar (işlevsel değildir) uygulamaları geliştiriyoruz. 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 kullandığından
aşağıdaki kriterlere uyan endeksleri tanımlayın:
Query::OrderByChild()
ile birlikte kullanmayın. 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) mod
- Windows çalışma zamanı ortamı: Çok iş parçacıklı / MT - Çok iş parçacıklı DLL /MD
- Hedef: Sürüm 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'sını bağlayın kullanabilirsiniz. Daha fazla bilgi için derleyici dokümanlarınıza bakın. ekleyebilirsiniz.
Firebase C++ Kitaplığı | Windows SDK kitaplığı 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) için kitaplık sürümleri sağlanır platformu. Size kolaylık sağlamak için çerçeveler de sunulur.
macOS kitaplıklarının Xcode kullanılarak test edildiğini unutmayın 13.3.1.
macOS'te C++ masaüstü uygulamaları oluştururken aşağıdakini 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ıza bakın.
Linux kitaplıkları
Linux için 32 bit (i386) ve 64 bit (x86_64) için kitaplık sürümleri sağlanır. platformlar.
Linux kitaplıklarının GCC 4.8.0, GCC 7.2.0 ve Ubuntu'da Clang 5.0.
Linux'ta C++ masaüstü uygulamaları oluştururken pthread
sistem kitaplığını şuraya bağlayın:
akılda kalıcı bir yolunu sunar. Daha fazla bilgi için derleyici dokümanlarınıza bakın. Eğer
GCC 5 veya sonraki bir sürümle derlerseniz -D_GLIBCXX_USE_CXX11_ABI=0
değerini tanımlayın.
Sonraki adımlar
Örnek Firebase uygulamalarını keşfedin.
Açık kaynak SDK'yı şurada keşfedin: GitHub'ı tıklayın.
Uygulamanızı kullanıma sunmaya hazırlanma:
- Bütçe ayarlama uyarılar Google Cloud konsolunda projeniz için.
- Kullanımı ve faturalandırmayı izleme kontrol paneli projenizin genel durumunu görmek için Firebase konsolunda birden fazla Firebase hizmetinde nasıl kullanıldığını gösterir.
- Firebase lansmanı kontrol listesini inceleyin.