將 Firebase 新增至您的 C++ 專案

運用提供 C++ 的 Firebase C++ SDK 強化 C++ 遊戲 Firebase SDK 的頂端介面

完全可從 C++ 程式碼存取 Firebase,不必編寫任何程式碼 平台原生程式碼Firebase SDK 也可以翻譯許多特定語言的內容 Firebase 使用的慣用語產生 C++ 開發人員較熟悉的介面。

進一步瞭解如何運用 Firebase 強化遊戲成效, Firebase 遊戲頁面

已將 Firebase 新增至 C++ 專案了嗎?請確認您使用 最新版的 Firebase C++ SDK


事前準備

  • 安裝下列項目:

    • Xcode 13.3.1 以上版本
    • CocoaPods 1.12.0 以上版本
  • 請確認您的專案指定下列平台版本或更新版本:

    • iOS 13
    • tvOS 13
  • 設定實體裝置或使用模擬器執行應用程式。

  • 使用 Google 帳戶。

步驟 2:建立 Firebase 專案

將 Firebase 新增至 C++ 專案前,請先建立 Firebase 連線至 C++ 專案。前往 如要進一步瞭解 Firebase 專案,請參閱這篇文章 Firebase 專案。

步驟 3:向 Firebase 註冊應用程式

如要在 Apple 應用程式中使用 Firebase,請向以下應用程式註冊應用程式: Firebase 專案。註冊應用程式通常稱為「新增」將應用程式 專案。

  1. 前往 Firebase 控制台

  2. 按一下專案總覽頁面中央的「iOS+」圖示 啟動設定工作流程

    如果您已在 Firebase 專案中加入應用程式,請按一下「新增應用程式」 顯示平台選項

  3. 在「bundle ID」欄位中輸入應用程式的軟體包 ID。

    ,瞭解如何調查及移除這項存取權。
  4. (選用) 輸入其他應用程式資訊: 「應用程式暱稱」和「App Store ID」

  5. 按一下 [Register app] (註冊應用程式)

步驟 4:新增 Firebase 設定檔

  1. 點選「Download GoogleService-Info.plist」,取得 Firebase Apple 平台設定檔

  2. 在 IDE 中開啟 C++ 專案,然後將設定檔拖曳到根目錄 C++ 專案中的資源

  3. 如果出現提示,請選擇將設定檔新增至所有目標。

您已完成 Firebase 控制台中的工作設定。前往 請在下方新增 Firebase C++ SDK

步驟 5:新增 Firebase C++ SDK

本節中的步驟舉例說明 支援的 Firebase 產品至您的 Firebase C++ 專案。

  1. 下載 Firebase C++ SDK,然後將 SDK 解壓縮。

    Firebase C++ SDK 不限於特定平台,但包含 特定平台專用的程式庫

  2. 從已解壓縮的 SDK 新增 Firebase Pod

    1. 如果您尚未建立 Podfile,請建立一個:

      cd your-app-directory
      pod init

    2. 在 Podfile 中新增要用於 應用程式。

      已啟用 Analytics

      # 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

      # 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. 安裝 Pod,然後在 Xcode 中開啟 .xcworkspace 檔案。

      pod install
      open your-app.xcworkspace

  3. 從解壓縮後新增 Firebase 架構 將機器學習工作流程自動化

    想要新增這些架構,最簡單的方法通常是從 Finder 視窗直接進入 Xcode 的「Project Navigator」窗格 ( 最左側的窗格;或按一下 Xcode 左上角的檔案圖示。

    1. 新增 Firebase C++ 架構 firebase.framework, 此為必填屬性,以使用任何 Firebase 產品。

    2. 為您要使用的每項 Firebase 產品新增架構。適用對象 例如,如要使用 Firebase Authentication,請加上 firebase_auth.framework

    ,瞭解如何調查及移除這項存取權。
  4. 返回 Firebase 控制台,在設定工作流程中點選「下一步」

  5. 如已新增「Analytics」,請執行應用程式,以便將驗證傳送至 Firebase 您已成功整合 Firebase。如果不是,可以略過這個步驟 驗證步驟

    您的裝置記錄會顯示初始化的 Firebase 驗證資訊 。如果您是在具備網路存取權的模擬器上執行應用程式, Firebase 控制台會通知您應用程式連線已完成。

大功告成!C++ 應用程式已註冊並設為使用 Firebase 很少直接解答該如何打造產品

可用的程式庫

如要進一步瞭解 C++ Firebase 程式庫,請前往 參考說明文件和我們的開放原始碼 SDK 發布。

Apple 平台可用的程式庫

請注意,Android 的 C++ 程式庫列於 設定頁面

每項 Firebase 產品都有不同的依附元件。請務必加入 將所需 Firebase 產品的依附元件列在 Podfile 中 C++ 專案。

每項 Firebase 產品可能僅支援部分 Apple OS 平台 (iOS、 tvOS 等)。查看 Google Cloud 中每個程式庫支援的平台 進一步瞭解 C++ 和 Firebase

Firebase 產品 架構和 Pod
AdMob (必填) firebase.framework
firebase_admob.framework
(必填) firebase_analytics.framework

pod 'FirebaseAdMob', '11.0.0'
(必填) pod 'FirebaseAnalytics', '11.0.0'
Analytics (必填) firebase.framework


firebase_analytics.framework pod 'FirebaseAnalytics', '11.0.0'
App Check (必填) firebase.framework


firebase_app_check.framework pod 'FirebaseAppCheck', '11.0.0'
Authentication (必填) firebase.framework


firebase_auth.framework pod 'FirebaseAuth', '11.0.0'
Cloud Firestore (必填) firebase.framework
firebase_firestore.framework
firebase_auth.framework

pod 'FirebaseFirestore', '11.0.0'
pod 'FirebaseAuth', '11.0.0'
Cloud Functions (必填) firebase.framework


firebase_functions.framework pod 'FirebaseFunctions', '11.0.0'
Cloud Messaging (必填) firebase.framework
firebase_messaging.framework
(建議採用) firebase_analytics.framework

pod 'FirebaseMessaging', '11.0.0'
(建議採用) pod 'FirebaseAnalytics', '11.0.0'
Cloud Storage (必填) firebase.framework


firebase_storage.framework pod 'FirebaseStorage', '11.0.0'
Dynamic Links (必填) firebase.framework
firebase_dynamic_links.framework
(建議採用) firebase_analytics.framework

pod 'FirebaseDynamicLinks', '11.0.0'
(建議採用) pod 'FirebaseAnalytics', '11.0.0'
Realtime Database (必填) firebase.framework


firebase_database.framework pod 'FirebaseDatabase', '11.0.0'
Remote Config (必填) firebase.framework
firebase_remote_config.framework
(建議採用) firebase_analytics.framework

pod 'FirebaseRemoteConfig', '11.0.0'
(建議採用) pod 'FirebaseAnalytics', '11.0.0'

行動裝置設定的其他資訊

方法滑動

在 iOS 上,部分應用程式事件 (例如開啟網址和接收 通知),需要應用程式委派來實作 方法。舉例來說,如要接收通知,可能需要您的應用程式 委派用來實作 application:didReceiveRemoteNotification:。由於 每個 iOS 應用程式都有專屬的應用程式委派項目,Firebase 會使用 方法滑動,可取代其中一種方法。 附加專屬的處理常式,以及您已實作的任何處理常式。

Dynamic LinksCloud Messaging 程式庫需要 ,使用方法滑動,將處理常式附加至應用程式委派。如果 您之後使用任一項 Firebase 產品時,Firebase 會以 識別 AppDelegate 類別,並靈活調整其必要方法。 將呼叫鏈結至現有方法實作。

設定電腦工作流程 (Beta 版)

建立遊戲時,在電腦上測試遊戲通常會簡單許多 ,然後在行動裝置上部署及測試目的地: 支援這項工作流程 可執行應用程式的 Firebase C++ SDK 子集 Windows、macOS、Linux 和 C++ 編輯器中。

  1. 如要採用電腦工作流程,您必須完成下列步驟:

    1. 為 CMake 設定 C++ 專案。
    2. 建立 Firebase 專案
    3. 使用 Firebase 註冊應用程式 (iOS 或 Android)
    4. 新增行動平台 Firebase 設定檔
  2. 建立 Firebase 設定檔的電腦版版本:

    • 如果您已新增 Android google-services.json 檔案 - 執行 您的應用程式,Firebase 會自動找到這個行動裝置檔案 產生電腦 Firebase 設定檔 (google-services-desktop.json)。

    • 如果您已新增 iOS GoogleService-Info.plist 檔案:執行前 則需要將這個行動檔案轉換成電腦 Firebase 設定檔。如要轉換檔案,請在 將其視為 GoogleService-Info.plist 檔案:

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

    這個桌面設定檔含有您輸入的 C++ 專案 ID Firebase 控制台設定工作流程。前往 瞭解 Firebase 專案 ,進一步瞭解設定檔。

  3. 將 Firebase SDK 新增至您的 C++ 專案。

    下列步驟只是示範, 支援的 Firebase 產品 C++ 專案中的資源。本例會逐步說明如何 《Firebase Authentication》和《Firebase Realtime Database》。

    1. FIREBASE_CPP_SDK_DIR 環境變數設為 解壓縮後的 Firebase C++ SDK

    2. 在專案的 CMakeLists.txt 檔案中,新增以下內容: 包括以下項目的程式庫 要使用的 Firebase 產品舉例來說 Firebase AuthenticationFirebase 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. 執行 C++ 應用程式。

可用程式庫 (電腦)

Firebase C++ SDK 包含電腦工作流程支援 且能透過 Firebase 的特定部分 獨立桌面版本,適用於 Windows、macOS 和 Linux。

Firebase 產品 程式庫參考資料 (使用 CMake)
App Check firebase_app_check
(必要) firebase_app
Authentication firebase_auth
(必要) firebase_app
Cloud Firestore firebase_firestore
firebase_auth
firebase_app
Cloud Functions firebase_functions
(必要) firebase_app
Cloud Storage firebase_storage
(必要) firebase_app
Realtime Database firebase_database
(必要) firebase_app
Remote Config firebase_remote_config
(必要) firebase_app

Firebase 提供其餘的電腦版程式庫做為虛設常式 (無法運作) 方便在 Windows、macOS 和 Linux 上進行建構。 因此,您不需要條件式編譯程式碼即可指定電腦。

Realtime Database 電腦

電腦 Realtime Database SDK 使用 REST 存取您的資料庫,因此您必須 宣告 您在電腦上搭配 Query::OrderByChild() 使用,否則事件監聽器將會失敗。

有關電腦設定的其他資訊

Windows 程式庫

針對 Windows,提供程式庫版本的基本需求如下:

  • 建構平台:32 位元 (x86) 與 64 位元 (x64) 模式
  • Windows 執行階段環境:多執行緒 / MT 與多執行緒 DLL /MD
  • 目標:版本與偵錯

請注意,下列程式庫已使用 Visual Studio 2015 和 2017 進行測試。

在 Windows 中建構 C++ 電腦版應用程式時,請連結下列 Windows SDK 新增至專案詳情請參閱編譯器說明文件 可能不準確或不適當

Firebase C++ 程式庫 Windows SDK 程式庫依附元件
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 程式庫

如為 macOS (Darwin),則提供 64 位元 (x86_64) 的程式庫版本 平台。此外,我們提供了架構,方便您使用。

請注意,已使用 Xcode 測試 macOS 程式庫 13.3.1。

在 macOS 上建構 C++ 電腦版應用程式時,請將以下連結連結至您的專案:

  • pthread 系統程式庫
  • CoreFoundation 個 macOS 系統架構
  • Foundation 個 macOS 系統架構
  • Security 個 macOS 系統架構
  • GSS 個 macOS 系統架構
  • Kerberos 個 macOS 系統架構
  • SystemConfiguration 個 macOS 系統架構

詳情請參閱編譯器說明文件。

Linux 程式庫

Linux 系統為 32 位元 (i386) 和 64 位元 (x86_64) 提供程式庫版本。 平台。

請注意,Linux 程式庫使用 GCC 4.8.0、GCC 7.2.0 和 Ubuntu 的 Clang 5.0。

在 Linux 上建構 C++ 電腦版應用程式時,請將 pthread 系統程式庫連結至 。詳情請參閱編譯器說明文件。如果 您才使用 GCC 5 以上版本進行建構,請定義 -D_GLIBCXX_USE_CXX11_ABI=0

後續步驟