Dodaj Firebase do projektu C++

Ulepsz swoje gry w C++ dzięki naszym pakietom Firebase C++ SDK, które zapewniają interfejs C++ na bazie pakietów Firebase SDK.

Uzyskaj dostęp do Firebase całkowicie z poziomu kodu C++, bez konieczności pisania kodu natywnego dla platformy. Pakiet SDK Firebase tłumaczy też wiele idiomów językowych używanych przez Firebase na interfejs bardziej znany programistom C++.

Więcej informacji o ulepszaniu gier za pomocą Firebase znajdziesz na stronie Firebase poświęconej grom.

Masz już Firebase w projekcie C++? Upewnij się, że używasz najnowszej wersji pakietu SDK Firebase C++.


Wymagania wstępne

  • Zainstaluj te elementy:

    • Xcode 26.2 lub nowszy,
    • CocoaPods w wersji 1.12.0 lub nowszej,

  • Upewnij się, że Twój projekt jest kierowany na te wersje platformy lub nowsze:

    • iOS 15
    • tvOS 15

  • Skonfiguruj urządzenie fizyczne lub użyj symulatora, aby uruchomić aplikację.

  • Zaloguj się w Firebase za pomocą konta Google.

Krok 2. Utwórz projekt w Firebase

Zanim dodasz Firebase do projektu C++, musisz utworzyć projekt Firebase, aby połączyć go z projektem C++. Więcej informacji o projektach w Firebase znajdziesz w artykule Informacje o projektach w Firebase.

Krok 3. Zarejestruj aplikację w Firebase

Aby używać Firebase w aplikacji na urządzenia Apple, musisz zarejestrować aplikację w projekcie w Firebase. Rejestrowanie aplikacji jest często nazywane „dodawaniem” aplikacji do projektu.

  1. Otwórz konsolę Firebase.

  2. Na środku strony Przegląd projektu kliknij ikonę iOS+, aby uruchomić proces konfiguracji.

    Jeśli masz już aplikację dodaną do projektu w Firebase, kliknij Dodaj aplikację, aby wyświetlić opcje platformy.

  3. Wpisz identyfikator pakietu aplikacji w polu Identyfikator pakietu.

  4. (Opcjonalnie) Wpisz inne informacje o aplikacji: Nazwa aplikacji i Identyfikator sklepu z aplikacjami.

  5. Kliknij Zarejestruj aplikację.

Krok 4. Dodaj plik konfiguracji Firebase

  1. Kliknij Pobierz GoogleService-Info.plist, aby uzyskać plik konfiguracji Firebase na platformy Apple.

  2. Otwórz projekt C++ w środowisku IDE, a następnie przeciągnij plik konfiguracji do katalogu głównego projektu C++.

  3. Jeśli pojawi się taka prośba, wybierz opcję dodania pliku konfiguracji do wszystkich środowisk docelowych.

Zadania konfiguracyjne w konsoli Firebase zostały zakończone. Przejdź do sekcji Dodawanie pakietów Firebase C++ SDK poniżej.

Krok 5. Dodaj pakiety Firebase C++ SDK

Czynności opisane w tej sekcji pokazują, jak dodać obsługiwane usługi Firebase do projektu Firebase w C++.

  1. Pobierz pakiet SDK Firebase C++, a następnie rozpakuj go w dogodnym miejscu.

    Pakiet SDK Firebase C++ nie jest przeznaczony na konkretną platformę, ale zawiera biblioteki dla konkretnych platform.

  2. Dodaj pody Firebase z rozpakowanego pakietu SDK.

    1. Utwórz plik Podfile, jeśli jeszcze go nie masz: 

      cd your-app-directory
       
      pod init

    2. Do pliku Podfile dodaj pody Firebase, których chcesz używać w aplikacji.

      Model Analytics został włączony 

      # 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 nie jest włączony 

      # 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. Zainstaluj pody, a następnie otwórz plik .xcworkspace w Xcode. 

      pod install
       
      open your-app.xcworkspace

  3. Dodaj platformy Firebase z rozpakowanego pakietu SDK.

    Najłatwiejszym sposobem dodania tych platform jest zwykle przeciągnięcie ich z okna Finder bezpośrednio do panelu Nawigator projektu w Xcode (domyślnie jest to panel po lewej stronie; możesz też kliknąć ikonę pliku w lewym górnym rogu Xcode).

    1. Dodaj platformę Firebase C++ firebase.framework, która jest wymagana do korzystania z dowolnej usługi Firebase.

    2. Dodaj platformę dla każdej usługi Firebase, której chcesz używać. Na przykład, aby użyć właściwości Firebase Authentication, dodaj firebase_auth.framework.

  4. Wróć do konsoli Firebase i w procesie konfiguracji kliknij Dalej.

  5. Jeśli dodano Analytics, uruchom aplikację, aby wysłać do Firebase potwierdzenie, że integracja z Firebase została przeprowadzona prawidłowo. W przeciwnym razie możesz pominąć ten krok weryfikacji.

    W dziennikach urządzenia pojawi się informacja o zakończeniu inicjalizacji Firebase. Jeśli aplikacja została uruchomiona w emulatorze z dostępem do sieci, w konsoli Firebase pojawi się powiadomienie, że połączenie z aplikacją zostało nawiązane.

To już wszystko Twoja aplikacja w C++ jest zarejestrowana i skonfigurowana do korzystania z usług Firebase.

Dostępne biblioteki

Więcej informacji o bibliotekach Firebase w C++ znajdziesz w dokumentacji referencyjnej i w naszym pakiecie SDK open source na GitHubie.

Dostępne biblioteki na platformy Apple

Pamiętaj, że biblioteki C++ na Androida są wymienione w wersji tej strony konfiguracji na Androida.

Każda usługa Firebase ma inne zależności. Pamiętaj, aby dodać do pliku Podfile i projektu C++ wszystkie wymienione zależności dla wybranej usługi Firebase.

Każda usługa Firebase może obsługiwać tylko wybrane platformy systemów operacyjnych Apple (iOS, tvOS itp.). Sprawdź, które platformy są obsługiwane przez poszczególne biblioteki, w artykule Więcej informacji o C++ i Firebase.

Usługa Firebase Frameworks and Pods
Analytics (wymagane) firebase.framework
firebase_analytics.framework

pod 'FirebaseAnalytics', '13.0.0'
App Check (wymagane) firebase.framework
firebase_app_check.framework

pod 'FirebaseAppCheck', '13.0.0'
Authentication (wymagane) firebase.framework
firebase_auth.framework

pod 'FirebaseAuth', '13.0.0'
Cloud Firestore (wymagane) firebase.framework
firebase_firestore.framework
firebase_auth.framework

pod 'FirebaseFirestore', '13.0.0'
pod 'FirebaseAuth', '13.0.0'
Cloud Functions (wymagane) firebase.framework
firebase_functions.framework

pod 'FirebaseFunctions', '13.0.0'
Cloud Messaging (wymagane) firebase.framework
firebase_messaging.framework
(zalecane) firebase_analytics.framework

pod 'FirebaseMessaging', '13.0.0'
(zalecane) pod 'FirebaseAnalytics', '13.0.0'
Cloud Storage (wymagane) firebase.framework
firebase_storage.framework

pod 'FirebaseStorage', '13.0.0'
Realtime Database (wymagane) firebase.framework
firebase_database.framework

pod 'FirebaseDatabase', '13.0.0'
Remote Config (wymagane) firebase.framework
firebase_remote_config.framework
(zalecane) firebase_analytics.framework

pod 'FirebaseRemoteConfig', '13.0.0'
(zalecane) pod 'FirebaseAnalytics', '13.0.0'
WYCOFANE LUB NIEOBSŁUGIWANE BIBLIOTEKI
Dynamic Links (wymagane) firebase.framework
firebase_dynamic_links.framework
(zalecane) firebase_analytics.framework

pod 'FirebaseDynamicLinks', '13.0.0'
(zalecane) pod 'FirebaseAnalytics', '13.0.0'

Dodatkowe informacje dotyczące konfiguracji na urządzeniach mobilnych

Podmiana metody

W systemie iOS niektóre zdarzenia aplikacji (takie jak otwieranie adresów URL i otrzymywanie powiadomień) wymagają, aby delegat aplikacji implementował określone metody. Na przykład odbieranie powiadomień może wymagać od delegata aplikacji zaimplementowania metody application:didReceiveRemoteNotification:. Każda aplikacja na iOS ma własny obiekt delegowany, dlatego Firebase używa podmiany metody, która umożliwia zastąpienie jednej metody inną, aby dołączyć własne moduły obsługi oprócz tych, które zostały przez Ciebie zaimplementowane.

Biblioteki Dynamic Links i Cloud Messaging muszą dołączać moduły obsługi do delegata aplikacji za pomocą podmiany metody. Jeśli używasz któregoś z tych usług Firebase, podczas wczytywania Firebase zidentyfikuje klasę AppDelegate i podmieni w niej wymagane metody, łącząc wywołanie zwrotne z istniejącą implementacją metody.

Konfigurowanie przepływu pracy na komputerze (beta)

Podczas tworzenia gry często znacznie łatwiej jest najpierw przetestować ją na platformach komputerowych, a później wdrożyć i przetestować na urządzeniach mobilnych. Aby ułatwić ten proces, udostępniamy podzbiór pakietów SDK Firebase C++, które można uruchamiać w systemach Windows, macOS i Linux oraz w edytorze C++.

  1. W przypadku przepływów pracy na komputerze musisz wykonać te czynności:

    1. Skonfiguruj projekt C++ pod kątem CMake.
    2. Tworzenie projektu w Firebase
    3. Zarejestruj aplikację (na iOS lub Androida) w Firebase
    4. Dodawanie pliku konfiguracji Firebase na platformę mobilną

  2. Utwórz komputerową wersję pliku konfiguracji Firebase:

    • Jeśli dodasz plik google-services.json na Androida – gdy uruchomisz aplikację, Firebase zlokalizuje ten plik mobilny, a następnie automatycznie wygeneruje plik konfiguracji Firebase na komputery (google-services-desktop.json).

    • Jeśli dodano plik GoogleService-Info.plist na iOS – przed uruchomieniem aplikacji musisz przekonwertować ten plik mobilny na plik konfiguracji Firebase na komputery. Aby przekonwertować plik, uruchom to polecenie w tym samym katalogu, w którym znajduje się plik GoogleService-Info.plist:

      generate_xml_from_google_services_json.py --plist -i GoogleService-Info.plist

    Ten plik konfiguracji komputera zawiera identyfikator projektu C++ wpisany w procesie konfiguracji konsoli Firebase. Więcej informacji o plikach konfiguracji znajdziesz w artykule Informacje o projektach w Firebase.

  3. Dodaj pakiety SDK Firebase do projektu w C++.

    Poniższe kroki pokazują, jak dodać dowolną obsługiwaną usługę Firebase do projektu C++. W tym przykładzie dodamy Firebase Authentication i Firebase Realtime Database.

    1. Ustaw zmienną środowiskową FIREBASE_CPP_SDK_DIR na lokalizację rozpakowanego pakietu SDK C++ Firebase.

    2. Do pliku CMakeLists.txt projektu dodaj te treści, w tym biblioteki usług Firebase, których chcesz używać. Aby na przykład użyć Firebase Authentication i 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}")

  4. Uruchom aplikację w C++.

Dostępne biblioteki (komputer)

Pakiet SDK Firebase C++ obsługuje procesy na komputerach w przypadku podzbioru funkcji, co umożliwia korzystanie z niektórych części Firebase w samodzielnych kompilacjach na komputery z systemem Windows, macOS i Linux.

Usługa Firebase Odwołania do bibliotek (za pomocą CMake)
App Check firebase_app_check
(wymagane) firebase_app
Authentication firebase_auth
(wymagane) firebase_app
Cloud Firestore firebase_firestore
firebase_auth
firebase_app
Cloud Functions firebase_functions
(wymagane) firebase_app
Cloud Storage firebase_storage
(wymagane) firebase_app
Realtime Database firebase_database
(wymagane) firebase_app
Remote Config firebase_remote_config
(wymagane) firebase_app

Firebase udostępnia pozostałe biblioteki na komputery jako implementacje zastępcze (niefunkcjonalne), aby ułatwić tworzenie aplikacji na systemy Windows, macOS i Linux. Dlatego nie musisz kompilować kodu warunkowo, aby kierować reklamy na komputery.

Realtime Database komputer

Pakiet SDK Realtime Database na komputery używa interfejsu REST do uzyskiwania dostępu do bazy danych, więc musisz zadeklarować indeksy, których używasz z Query::OrderByChild() na komputerze, bo inaczej detektory nie będą działać.

Dodatkowe informacje dotyczące konfiguracji na komputerze

Biblioteki systemu Windows

W przypadku systemu Windows wersje bibliotek są udostępniane na podstawie tych informacji:

  • Platforma kompilacji: tryb 32-bitowy (x86) lub 64-bitowy (x64)
  • Środowisko wykonawcze systemu Windows: wielowątkowe / MT a wielowątkowa biblioteka DLL /MD
  • Cel: wersja produkcyjna a wersja do debugowania

Pamiętaj, że te biblioteki zostały przetestowane w Visual Studio 2015 i 2017.

Podczas tworzenia aplikacji komputerowych w C++ na system Windows połącz z projektem te biblioteki Windows SDK. Więcej informacji znajdziesz w dokumentacji kompilatora.

Biblioteka Firebase C++ Zależności biblioteki pakietu SDK dla systemu Windows
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

Biblioteki macOS

W przypadku systemu macOS (Darwin) wersje biblioteki są dostępne na platformę 64-bitową (x86_64). Dla Twojej wygody udostępniamy też platformy.

Pamiętaj, że biblioteki macOS zostały przetestowane za pomocą Xcode 26.2.

Podczas tworzenia aplikacji komputerowych w C++ na macOS połącz z projektem te elementy:

  • pthread biblioteka systemowa
  • CoreFoundation – platforma systemowa macOS
  • Foundation – platforma systemowa macOS
  • Security – platforma systemowa macOS
  • GSS – platforma systemowa macOS
  • Kerberos – platforma systemowa macOS
  • SystemConfiguration – platforma systemowa macOS

Więcej informacji znajdziesz w dokumentacji kompilatora.

Biblioteki Linuksa

W przypadku systemu Linux wersje biblioteki są dostępne na platformy 32-bitowe (i386) i 64-bitowe (x86_64).

Pamiętaj, że biblioteki Linuksa zostały przetestowane przy użyciu GCC 4.8.0, GCC 7.2.0 i Clang 5.0 na Ubuntu.

Podczas tworzenia aplikacji komputerowych w C++ na Linuksie połącz bibliotekę systemową pthread z projektem. Więcej informacji znajdziesz w dokumentacji kompilatora. Jeśli kompilujesz za pomocą GCC 5 lub nowszego, zdefiniuj -D_GLIBCXX_USE_CXX11_ABI=0.

Dalsze kroki