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

步驟 3：透過 Firebase 註冊應用程式

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

1. 前往 Firebase 控制台。

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

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

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

   什麼是軟體包 ID？如何找出軟體包 ID？

   • 軟體包 ID 可用來識別 Apple 生態系統中的應用程式。

   • 找出軟體包 ID：在 Xcode 中開啟專案，選取專案導覽器中的頂層應用程式，然後選取「General」分頁。

     「Bundle Identifier」欄位的值為軟體包 ID (例如 com.yourcompany.yourproject)。

   • 請注意，套件 ID 值會區分大小寫，且在 Firebase 專案註冊此 Firebase 應用程式後，就無法變更。

4. (選用) 輸入其他應用程式資訊：應用程式暱稱和 App Store ID。

   如何在 Firebase 中使用應用程式暱稱和應用程式商店 ID？

   • 應用程式暱稱：內部方便使用識別碼，僅會在 Firebase 控制台中顯示

   • App Store ID：Firebase Dynamic Links 會使用此 ID 將使用者重新導向至您的 App Store 頁面，Google Analytics 則會使用此 ID 將轉換事件匯入 Google Ads。如果應用程式尚未有 App Store ID，您可以稍後在專案設定中新增 ID。

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

步驟 4：新增 Firebase 設定檔

1. 按一下「Download GoogleService-Info.plist」，取得 Firebase Apple 平台設定檔。

   您需要瞭解這個設定檔的哪些資訊？

   • Firebase 設定檔包含專案的非祕密專屬 ID。如要進一步瞭解這個設定檔，請參閱「瞭解 Firebase 專案」。

   • 您隨時可以重新下載 Firebase 設定檔。

   • 請確認設定檔名稱未附加額外的字元，例如 (2)。

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」。

行動版設定的其他資訊

方法交換

在 iOS 上，部分應用程式事件 (例如開啟網址和接收通知) 需要應用程式委派程式實作特定方法。舉例來說，接收通知可能需要應用程式委派程式實作 application:didReceiveRemoteNotification:。由於每個 iOS 應用程式都有自己的應用程式委派程式，因此 Firebase 會使用方法 swizzling，讓您可以將一個方法替換為另一個方法，藉此附加自己的處理程序，以及您可能已實作的任何處理程序。

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 會提供其他桌面程式庫做為暫置 (非功能性) 實作，方便您建構 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 程式庫連結至專案。詳情請參閱編譯器說明文件。

macOS 程式庫

針對 macOS (Darwin)，我們提供 64 位元 (x86_64) 平台的程式庫版本。我們也提供架構，方便您使用。

請注意，我們已使用 Xcode 16.2 測試 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。

後續步驟

• 探索 Firebase 應用程式範例。

• 探索 GitHub 中的開放原始碼 SDK。

• 準備發布應用程式：

  • 在 Google Cloud 控制台中為專案設定預算快訊。
  • 請在 Firebase 控制台中監控使用量和帳單資訊主頁，全面掌握專案在多項 Firebase 服務中的用量。
  • 詳閱 Firebase 上市檢查清單。