Google 致力于为黑人社区推动种族平等。查看具体举措

將 Firebase 添加到您的 Android 項目

先決條件

  • 安裝或更新Android Studio到其最新版本。

  • 確保您的項目滿足以下要求:

    • 目標 API 級別 16 (Jelly Bean) 或更高版本
    • 使用 Gradle 4.1 或更高版本
    • 使用Jetpack (AndroidX) ,其中包括滿足以下版本要求:
      • com.android.tools.build:gradle v3.2.1 或更高版本
      • compileSdkVersion 28 或更高版本
  • 設置物理設備或使用模擬器來運行您的應用程序。
    請注意,依賴於 Google Play 服務的 Firebase SDK需要設備或模擬器安裝 Google Play 服務。

  • 使用您的 Google 帳戶登錄 Firebase

如果您還沒有 Android 項目並且只想試用 Firebase 產品,您可以下載我們的快速入門示例之一


您可以使用以下選項之一將您的 Android 應用連接到 Firebase:

  • 選項 1 :(推薦)使用 Firebase 控制台設置工作流程。
  • 選項 2 :使用 Android Studio Firebase 助手(可能需要額外配置)。



選項 1 :使用 Firebase 控制台添加 Firebase

將 Firebase 添加到您的應用程序涉及Firebase 控制台和打開的 Android 項目中的任務(例如,您從控制台下載 Firebase 配置文件,然後將它們移動到您的 Android 項目中)。

第 1 步:創建 Firebase 項目

在將 Firebase 添加到您的 Android 應用之前,您需要創建一個 Firebase 項目以連接到您的 Android 應用。訪問了解 Firebase 項目以了解有關 Firebase 項目的更多信息。

第 2 步:向 Firebase 註冊您的應用

要在您的 Android 應用中使用 Firebase,您需要向您的 Firebase 項目註冊您的應用。註冊您的應用程序通常稱為“添加”您的應用程序到您的項目。

  1. 轉到Firebase 控制台

  2. 在項目概覽頁面的中心,單擊Android圖標 ( ) 或添加應用程序以啟動設置工作流。

  3. Android 程序包名稱字段中輸入您的應用程序的程序包名稱

  4. (可選)輸入其他應用信息:應用暱稱調試簽名證書 SHA-1

  5. 點擊註冊應用程序

第 3 步:添加 Firebase 配置文件

  1. 將 Firebase Android 配置文件添加到您的應用:

    1. 單擊下載 google-services.json以獲取您的 Firebase Android 配置文件 ( google-services.json )。

    2. 將您的配置文件移動到您的應用程序的模塊(應用程序級)目錄中。

  2. 要在您的應用中啟用 Firebase 產品,請將google-services 插件添加到您的 Gradle 文件中。

    1. 在您的根級(項目級)Gradle 文件 ( build.gradle ) 中,添加規則以包含 Google Services Gradle 插件。檢查您是否也擁有 Google 的 Maven 存儲庫。

      buildscript {
      
        repositories {
          // Check that you have the following line (if not, add it):
          google()  // Google's Maven repository
        }
      
        dependencies {
          // ...
      
          // Add the following line:
          classpath 'com.google.gms:google-services:4.3.8'  // Google Services plugin
        }
      }
      
      allprojects {
        // ...
      
        repositories {
          // Check that you have the following line (if not, add it):
          google()  // Google's Maven repository
          // ...
        }
      }
      
    2. 在您的模塊(應用級)Gradle 文件(通常是app/build.gradle )中,應用 Google Services Gradle 插件:

      apply plugin: 'com.android.application'
      // Add the following line:
      apply plugin: 'com.google.gms.google-services'  // Google Services plugin
      
      android {
        // ...
      }
      

第 4 步:將 Firebase SDK 添加到您的應用

  1. 使用Firebase Android BoM聲明要在應用中使用的Firebase 產品的依賴項。在你的模塊(應用級)Gradle 文件(通常是app/build.gradle )中聲明它們。

    啟用分析

    爪哇

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:28.1.0')
    
      // When using the BoM, you don't specify versions in Firebase library dependencies
    
      // Declare the dependency for the Firebase SDK for Google Analytics
      implementation 'com.google.firebase:firebase-analytics'
    
      // Declare the dependencies for any other desired Firebase products
      // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
      implementation 'com.google.firebase:firebase-auth'
      implementation 'com.google.firebase:firebase-firestore'
    }
    

    科特林+KTX

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:28.1.0')
    
      // When using the BoM, you don't specify versions in Firebase library dependencies
    
      // Declare the dependency for the Firebase SDK for Google Analytics
      implementation 'com.google.firebase:firebase-analytics-ktx'
    
      // Declare the dependencies for any other desired Firebase products
      // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
      implementation 'com.google.firebase:firebase-auth-ktx'
      implementation 'com.google.firebase:firebase-firestore-ktx'
    }
    

    通過使用Firebase Android BoM ,您的應用將始終使用 Firebase Android 庫的兼容版本。

    未啟用分析

    爪哇

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:28.1.0')
    
      // When using the BoM, you don't specify versions in Firebase library dependencies
    
      // Declare the dependencies for the desired Firebase products
      // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
      implementation 'com.google.firebase:firebase-auth'
      implementation 'com.google.firebase:firebase-firestore'
    }
    

    科特林+KTX

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:28.1.0')
    
      // When using the BoM, you don't specify versions in Firebase library dependencies
    
      // Declare the dependencies for the desired Firebase products
      // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
      implementation 'com.google.firebase:firebase-auth-ktx'
      implementation 'com.google.firebase:firebase-firestore-ktx'
    }
    

    通過使用Firebase Android BoM ,您的應用將始終使用 Firebase Android 庫的兼容版本。

  2. 同步您的應用程序以確保所有依賴項都具有必要的版本。

就是這樣!您可以跳過以查看推薦的後續步驟

但是,如果您在設置時遇到問題,請訪問Android 故障排除和常見問題解答



選項 2 :使用 Firebase 助手添加 Firebase

Firebase 助手將您的應用註冊到 Firebase 項目,並將必要的 Firebase 文件、插件和依賴項添加到您的 Android 項目 - 全部來自 Android Studio!

  1. 在 Android Studio 中打開您的 Android 項目,然後確保您使用的是最新版本的 Android Studio 和 Firebase Assistant:

    • Windows / Linux:幫助 > 檢查更新
    • macOS: Android Studio > 檢查更新
  2. 打開 Firebase 助手:工具 > Firebase

  3. 在“助理”窗格中,選擇要添加到您的應用的 Firebase 產品。展開其部分,然後單擊教程鏈接(例如,分析 > 記錄分析事件)。

    1. 單擊連接到 Firebase將您的 Android 項目與 Firebase 連接。

    2. 點擊按鈕添加所需的 Firebase 產品(例如,將分析添加到您的應用)。

  4. 同步您的應用程序以確保所有依賴項都具有必要的版本。

  5. 在“助理”窗格中,按照所選 Firebase 產品的其餘設置說明進行操作。

  6. 通過 Firebase 助手添加任意數量的其他 Firebase 產品!

就是這樣!請務必查看推薦的後續步驟

但是,如果您在設置時遇到問題,請訪問Android 故障排除和常見問題解答



可用庫

本部分列出了 Android 支持的 Firebase 產品及其 Gradle 依賴項。詳細了解這些 Firebase Android 庫:

請注意,在使用Firebase Android BoM 時,在build.gradle聲明 Firebase 庫依賴項時不要指定單個庫版本。

爪哇

服務或產品Gradle依賴最新的
版本
添加分析?
Firebase Android 物料清單
(材料清單)
com.google.firebase:firebase-bom

最新的 Firebase BoM 版本包含每個 Firebase Android 庫的最新版本。要了解哪些庫版本映射到特定 BoM 版本,請查看該 BoM 版本的發行說明。

28.1.0
廣告com.google.android.gms:play-services-ads 20.2.0
分析com.google.firebase:firebase-analytics 19.0.0
應用分發插件com.google.firebase:firebase-appdistribution-gradle 2.1.2
應用索引com.google.firebase:firebase-appindexing 20.0.0
驗證com.google.firebase:firebase-auth 21.0.1
雲防火牆com.google.firebase:firebase-firestore 23.0.1
Firebase 客戶端 SDK 的雲函數com.google.firebase:firebase-functions 20.0.0
雲消息com.google.firebase:firebase 消息22.0.0
雲儲存com.google.firebase:firebase-storage 20.0.0
Crashlytics com.google.firebase:firebase-crashlytics 18.0.1
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.0.1
Crashlytics 插件com.google.firebase:firebase-crashlytics-gradle 2.7.0
動態功能模塊支持com.google.firebase:firebase-dynamic-module-support 16.0.0-beta01
動態鏈接com.google.firebase:firebase-dynamic-links 20.1.0
應用內消息com.google.firebase:firebase-inappmessaging 20.0.0
(必需的)
應用內消息顯示com.google.firebase:firebase-inappmessaging-display 20.0.0
(必需的)
Firebase 安裝com.google.firebase:firebase-installations 17.0.0
Firebase ML 模型下載器 API com.google.firebase:firebase-ml-modeldownloader 24.0.0
性能監控com.google.firebase:firebase-perf 20.0.1
性能監控插件com.google.firebase:perf-plugin 1.4.0
實時數據庫com.google.firebase:firebase 數據庫20.0.0
遠程配置com.google.firebase:firebase-config 21.0.0
Google Play 服務插件com.google.gms:google-services 4.3.8
已棄用的庫
Firebase ML 自定義模型 API com.google.firebase:firebase-ml-model-interpreter 22.0.4
Firebase ML Vision API com.google.firebase:firebase-ml-vision 24.1.0
Firebase ML:圖像標記模型com.google.firebase:firebase-ml-vision-image-label-model 20.0.2
Firebase ML:對象檢測和跟踪模型com.google.firebase:firebase-ml-vision-object-detection-model 19.0.6
Firebase ML:人臉檢測模型com.google.firebase:firebase-ml-vision-face-model 20.0.2
Firebase ML:條碼掃描模型com.google.firebase:firebase-ml-vision-barcode-model 16.1.2
Firebase ML:AutoML Vision Edge API com.google.firebase:firebase-ml-vision-automl 18.0.6
Firebase ML:自然語言 API com.google.firebase:firebase-ml-natural-language 22.0.1
Firebase ML:語言識別模型com.google.firebase:firebase-ml-natural-language-language-id-model 20.0.8
Firebase ML:翻譯模型com.google.firebase:firebase-ml-natural-language-translate-model 20.0.9
Firebase ML:智能回复模型com.google.firebase:firebase-ml-natural-language-smart-reply-model 20.0.8

科特林+KTX

服務或產品Gradle依賴最新的
版本
添加分析?
Firebase Android 物料清單
(材料清單)
com.google.firebase:firebase-bom

最新的 Firebase BoM 版本包含每個 Firebase Android 庫的最新版本。要了解哪些庫版本映射到特定 BoM 版本,請查看該 BoM 版本的發行說明。

28.1.0
廣告com.google.android.gms:play-services-ads 20.2.0
分析com.google.firebase:firebase-analytics-ktx 19.0.0
應用分發插件com.google.firebase:firebase-appdistribution-gradle 2.1.2
應用索引com.google.firebase:firebase-appindexing 20.0.0
驗證com.google.firebase:firebase-auth-ktx 21.0.1
雲防火牆com.google.firebase:firebase-firestore-ktx 23.0.1
Firebase 客戶端 SDK 的雲函數com.google.firebase:firebase-functions-ktx 20.0.0
雲消息com.google.firebase:firebase-messaging-ktx 22.0.0
雲儲存com.google.firebase:firebase-storage-ktx 20.0.0
Crashlytics com.google.firebase:firebase-crashlytics-ktx 18.0.1
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.0.1
Crashlytics 插件com.google.firebase:firebase-crashlytics-gradle 2.7.0
動態功能模塊支持com.google.firebase:firebase-dynamic-module-support 16.0.0-beta01
動態鏈接com.google.firebase:firebase-dynamic-links-ktx 20.1.0
應用內消息com.google.firebase:firebase-inappmessaging-ktx 20.0.0
(必需的)
應用內消息顯示com.google.firebase:firebase-inappmessaging-display-ktx 20.0.0
(必需的)
Firebase 安裝com.google.firebase:firebase-installations-ktx 17.0.0
Firebase ML 模型下載器 API com.google.firebase:firebase-ml-modeldownloader-ktx 24.0.0
性能監控com.google.firebase:firebase-perf-ktx 20.0.1
性能監控插件com.google.firebase:perf-plugin 1.4.0
實時數據庫com.google.firebase:firebase-database-ktx 20.0.0
遠程配置com.google.firebase:firebase-config-ktx 21.0.0
Google Play 服務插件com.google.gms:google-services 4.3.8
已棄用的庫
Firebase ML 自定義模型 API com.google.firebase:firebase-ml-model-interpreter 22.0.4
Firebase ML Vision API com.google.firebase:firebase-ml-vision 24.1.0
Firebase ML:圖像標記模型com.google.firebase:firebase-ml-vision-image-label-model 20.0.2
Firebase ML:對象檢測和跟踪模型com.google.firebase:firebase-ml-vision-object-detection-model 19.0.6
Firebase ML:人臉檢測模型com.google.firebase:firebase-ml-vision-face-model 20.0.2
Firebase ML:條碼掃描模型com.google.firebase:firebase-ml-vision-barcode-model 16.1.2
Firebase ML:AutoML Vision Edge API com.google.firebase:firebase-ml-vision-automl 18.0.6
Firebase ML:自然語言 API com.google.firebase:firebase-ml-natural-language 22.0.1
Firebase ML:語言識別模型com.google.firebase:firebase-ml-natural-language-language-id-model 20.0.8
Firebase ML:翻譯模型com.google.firebase:firebase-ml-natural-language-translate-model 20.0.9
Firebase ML:智能回复模型com.google.firebase:firebase-ml-natural-language-smart-reply-model 20.0.8



下一步

將 Firebase 服務添加到您的應用:

了解 Firebase: