瞭解 Android 版 Firebase

使用 Firebase 開發 Android 專案時，您可能會發現一些不熟悉或 Firebase 專屬的概念。這個頁面旨在回答這些問題，或提供相關資源供您進一步瞭解。

如果對本頁面未提及的主題有疑問，歡迎前往我們的線上社群。我們也會定期更新這個頁面，新增主題，歡迎隨時返回查看是否有您想瞭解的主題！

Android Studio 專用 Firebase Assistant 外掛程式

Firebase Assistant 是 Android Studio 外掛程式，可讓您使用 Firebase 專案註冊 Android 應用程式，並在 Android 專案中新增必要的 Firebase 設定檔、外掛程式和依附元件，所有操作都能在 Android Studio 中完成！

按照 Android 入門頁面中的操作說明，使用 Firebase Assistant。請確認您使用的 Android Studio 和 Firebase Assistant 都是最新版本 (依序前往「File」>「Check for updates」)。

選取要新增至應用程式的特定 Firebase 產品時，Firebase Assistant 會自動在 app/build.gradle 檔案中宣告必要依附元件。請注意，如要使用 Firebase Android BoM (建議)，請更新模組 (應用程式層級) Gradle 檔案 (通常為 app/build.gradle) 中的依附元件，匯入 BoM 平台。您也需要從每個 Firebase 程式庫依附元件行中移除版本。

此外，如要使用部分 Firebase 產品，您必須在 Android Studio 以外啟用 API 或佈建資源。Firebase 助理的各項產品說明會列出您需要執行的其他動作。舉例來說，如要使用 Cloud Firestore，您必須在 Firebase 控制台中設定資料庫和規則。

Google 服務 - 外掛程式和設定檔

將 Firebase 新增至 Android 專案時，您需要在專案中新增 google-services 外掛程式和 google-services.json 設定檔。

如果您透過 Firebase 控制台、Management REST API 或 Firebase CLI 將 Firebase 新增至 Android 專案，則必須手動將外掛程式和設定檔新增至專案。不過，如果您使用 Firebase Assistant，系統會在設定期間自動為您完成這些工作。

請參閱 Android 說明文件，瞭解 Google 服務外掛程式和設定檔如何搭配運作。

Firebase Android BoM (Bill of Materials)

只要指定一個版本 (即 BoM 的版本)，即可利用 Firebase Android BoM (Bill of Materials) 管理所有 Firebase 程式庫版本。

在應用程式中使用 Firebase BoM 時，BoM 會自動提取對應至 BoM 版本的個別程式庫版本。所有個別程式庫版本都會相容。在應用程式中更新 BoM 的版本時，應用程式中使用的所有 Firebase 程式庫都會更新至對應的 BoM 版本。

如要瞭解哪些 Firebase 程式庫版本對應至特定 BoM 版本，請參閱該 BoM 版本的版本資訊。如要比較對應至某個 BoM 版本的程式庫版本與另一個 BoM 版本，請使用下方的比較小工具。

進一步瞭解 Gradle 對 BoM 平台的支援。

以下說明如何使用 Firebase Android BoM，在模組 (應用程式層級) Gradle 檔案 (通常為 app/build.gradle) 中宣告依附元件。使用 BoM 時，您不需要在依附元件行中指定個別程式庫版本。

dependencies {
  // Import the BoM for the Firebase platform
  implementation platform('com.google.firebase:firebase-bom:34.0.0')

  // Declare the dependencies for the desired Firebase products without specifying versions
  // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
  implementation 'com.google.firebase:firebase-auth'
  implementation 'com.google.firebase:firebase-firestore'
}

以下是使用 Firebase Android BoM 的常見問題：

比較 Firebase BoM 版本

Kotlin 擴充功能 (KTX) 程式庫模組

功能模組和 Play Feature Delivery

自 2021 年 5 月起 (Firebase BoM v28.0.0)，Firebase Android SDK 可用於動態功能模組，這類模組與基礎應用程式模組分開安裝。

如要啟用動態功能模組的支援功能，請在基本模組的 build.gradle 檔案中新增下列依附元件：

dependencies {
  implementation 'com.google.firebase:firebase-dynamic-module-support:16.0.0-beta04'
}

新增動態模組支援後，您就可以在應用程式的功能模組中新增 Firebase SDK 依附元件 (含或不含 Firebase BoM)，並照常使用。

舉例來說，如果應用程式使用 Realtime Database 為特定即時功能提供支援，您可以將 firebase-database 依附元件新增至功能模組的 build.gradle，而非基礎模組。這項變更可減少大多數使用者的下載大小。

在功能模組中使用 Firebase SDK 時，請注意下列事項：

  • 如果是在動態功能模組中使用，依賴 Analytics first_open 事件的產品 (例如 Dynamic Links 或 Firebase In-App Messaging) 可能會遺漏這個事件。

  • 同時使用 Cloud Firestore 和 Authentication 時，請務必將兩者都納入同一個模組。如果無法這麼做，請確保 Authentication「先」載入 Cloud Firestore，否則部分 Cloud Firestore 作業的驗證狀態可能不正確。

  • 將 firebase-crashlytics-ndk 做為動態功能模組的依附元件時，您需要在應用程式的 build.gradle 檔案中設定 unstrippedNativeLibsDir 屬性，詳情請參閱 Crashlytics NDK 說明文件。

如要進一步瞭解功能模組和 Play Feature Delivery，請參閱「Play Feature Delivery 總覽」。

Google 服務 Gradle 外掛程式、Google Play 服務和 Google Play 商店

Google、Firebase 和 Android 生態系統的許多部分都有類似的命名慣例。以下簡要說明各項：

Google 服務 Gradle 外掛程式
Gradle 外掛程式 (com.google.gms.google-services)：在建構時執行，確保應用程式具備存取 Firebase 和 Google API 的正確設定
雖然名稱相似，但這個外掛程式與 Google Play 服務無關 (請參閱下一個項目)，也不會影響應用程式在執行階段的功能。
這個外掛程式也會處理您在設定 Firebase 時新增至應用程式的 google-services.json 檔案。進一步瞭解 Google 服務 Gradle 外掛程式。
Google Play 服務
在 Android 裝置上執行的隱形背景服務，可為裝置上的應用程式提供多種常見的 Google API (例如 Google 地圖和 Google 登入)
將這些常見的 API 集中到單一服務中，可縮減其他應用程式的大小，並讓裝置在不更新作業系統的情況下，自動接收安全性更新和功能強化內容。進一步瞭解 Google Play 服務。
Google Play 商店
Android 裝置的應用程式、電影、書籍等內容下載商店
開發人員可透過 Google Play 管理中心管理應用程式的發行和版本等。如果裝置有 Google Play 商店，也會執行 Google Play 服務 (請參閱上一節)。進一步瞭解開發人員專用的 Google Play 商店。
Google Play Games Services
行動遊戲開發人員專用的一組 API
進一步瞭解 Google Play 遊戲服務， 以及如何將 Firebase 整合至 Google Play 遊戲服務專案。

Firebase Android SDK 的開放原始碼資源

Firebase 支援開放原始碼開發，並鼓勵社群提供貢獻和意見回饋。

Firebase Android SDK

大多數 Firebase Android SDK 都是在公開的 Firebase GitHub 存放區中，以開放原始碼程式庫的形式開發。我們正積極將其餘私下開發的 Firebase 程式庫移至公開的 GitHub，敬請期待！

快速入門範例

Firebase 會維護 Android 上大多數 Firebase API 的快速入門範例集合。您可以在公開的 Firebase GitHub 快速入門存放區中找到這些快速入門範例。

您可以將每項快速入門當做 Android Studio 專案開啟，然後在行動裝置或虛擬裝置 (AVD) 上執行。您也可以將這些快速入門導覽課程當做使用 Firebase SDK 的範例程式碼。

其他感興趣的主題