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

Firebase C++ SDK 提供以 Firebase SDK 為基礎的 C++ 介面，可提升 C++ 遊戲的工作效率。

完全可從 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 帳戶登入 Firebase。

步驟 2：建立 Firebase 專案

您需要先建立 Firebase 專案並連結至 C++ 專案，才能將 Firebase 新增至您的 C++ 專案。請參閱「瞭解 Firebase 專案」一文，進一步瞭解 Firebase 專案。

步驟 3：將應用程式註冊至 Firebase

如要在 Apple 應用程式中使用 Firebase，您必須透過 Firebase 專案註冊應用程式。註冊應用程式通常稱為將應用程式「新增」至專案。

  1. 前往 Firebase 控制台。

  2. 在專案總覽頁面的中間，按一下 iOS+ 圖示，啟動設定工作流程。

    如果您已將應用程式新增至 Firebase 專案，請按一下「Add app」，顯示平台選項。

  3. 在「bundle ID」欄位中輸入應用程式的 bundle 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，請先建立 Podfile：

      cd your-app-directory
       
      pod init

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

      已啟用 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. 從解壓縮的 SDK 中新增 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 程式庫，請參閱參考說明文件，以及 GitHub 上的開放原始碼 SDK 版本。

適用於 Apple 平台的可用程式庫

請注意，Android 適用的 C++ 程式庫會列於這個設定頁面的 Android 版本中。

每項 Firebase 產品都有不同的依附元件。請務必將所需 Firebase 產品的所有列出依附元件新增至 Podfile 和 C++ 專案。

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

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

pod 'FirebaseAdMob', '11.4.2'
(必填) pod 'FirebaseAnalytics', '11.4.2'
Analytics (必要) firebase.framework
firebase_analytics.framework

pod 'FirebaseAnalytics', '11.4.2'
App Check (必要) firebase.framework
firebase_app_check.framework

pod 'FirebaseAppCheck', '11.4.2'
Authentication (必要) firebase.framework
firebase_auth.framework

pod 'FirebaseAuth', '11.4.2'
Cloud Firestore (必要) firebase.framework
firebase_firestore.framework
firebase_auth.framework

pod 'FirebaseFirestore', '11.4.2'
pod 'FirebaseAuth', '11.4.2'
Cloud Functions (必要) firebase.framework
firebase_functions.framework

pod 'FirebaseFunctions', '11.4.2'
Cloud Messaging (必要) firebase.framework
firebase_messaging.framework
(建議) firebase_analytics.framework

pod 'FirebaseMessaging', '11.4.2'
(建議) pod 'FirebaseAnalytics', '11.4.2'
Cloud Storage (必要) firebase.framework
firebase_storage.framework

pod 'FirebaseStorage', '11.4.2'
Dynamic Links (必要) firebase.framework
firebase_dynamic_links.framework
(建議) firebase_analytics.framework

pod 'FirebaseDynamicLinks', '11.4.2'
(建議) pod 'FirebaseAnalytics', '11.4.2'
Realtime Database (必要) firebase.framework
firebase_database.framework

pod 'FirebaseDatabase', '11.4.2'
Remote Config (必要) firebase.framework
firebase_remote_config.framework
(建議) firebase_analytics.framework

pod 'FirebaseRemoteConfig', '11.4.2'
(建議) pod 'FirebaseAnalytics', '11.4.2'

行動版設定的其他資訊

方法交換

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

Dynamic Links 和 Cloud 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

    這個電腦設定檔包含您在 Firebase 控制台設定工作流程中輸入的 C++ 專案 ID。請參閱「瞭解 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 Authentication 和 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. 執行 C++ 應用程式。

可用的程式庫 (電腦版)

Firebase C++ SDK 包含部分功能的電腦工作流程支援，可在 Windows、macOS 和 Linux 的獨立電腦版本中使用 Firebase 的部分功能。

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 13.3.1 測試 macOS 程式庫。

在 macOS 上建構 C++ 電腦版應用程式時，請將下列項目連結至專案：

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

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

Linux 程式庫

針對 Linux，我們提供 32 位元 (i386) 和 64 位元 (x86_64) 平台的程式庫版本。

請注意，Linux 程式庫是在 Ubuntu 上使用 GCC 4.8.0、GCC 7.2.0 和 Clang 5.0 進行測試。

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

後續步驟