本頁面由 Cloud Translation API 翻譯而成。
Switch to English

將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中使用模擬器圖像。

  • 使用您的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中註冊您的應用

在擁有Firebase項目之後,可以將您的Android應用添加到其中。

訪問“ 了解Firebase項目”以了解有關將應用程序添加到Firebase項目的最佳實踐和注意事項的更多信息,包括如何處理多個構建變體。

  1. 轉到Firebase控制台

  2. 在項目概述頁面的中心,單擊Android圖標( )以啟動設置工作流程。

    如果您已經將應用程序添加到Firebase項目中,請單擊“ 添加應用程序”以顯示平台選項。

  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.3'  // 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. 在模塊(應用程序級)Gradle文件(通常為app/build.gradle )中,添加要在應用程序中使用的Firebase產品的依賴項。

    啟用分析

    dependencies {
      // ...
    
      // Add the Firebase SDK for Google Analytics
      implementation 'com.google.firebase:firebase-analytics:17.4.4'
    
      // Add the dependencies for any other Firebase products you want to use in your app
      // For example, to also use Firebase Authentication
      implementation 'com.google.firebase:firebase-auth:19.3.2'
    
      // Getting a "Could not find" error? Make sure that you've added
      // Google's Maven repository to your root-level build.gradle file
    }
    

    未啟用分析

    dependencies {
      // ...
    
      // Add the dependencies for the Firebase products you want to use in your app
      // For example, to use Firebase Authentication
      implementation 'com.google.firebase:firebase-auth:19.3.2'
    
      // Getting a "Could not find" error? Make sure that you've added
      // Google's Maven repository to your root-level build.gradle file
    }
    
  2. 同步您的應用程序,以確保所有依賴項都具有必需的版本。

  3. 如果您添加了Analytics(分析),請運行您的應用以將已成功集成Firebase的驗證發送到Firebase。否則,您可以跳過驗證步驟。

    您的設備日誌將顯示Firebase驗證已完成初始化。如果您在具有網絡訪問權限的仿真器上運行應用程序,則Firebase控制台會通知您應用程序連接已完成。

而已!您可以跳到下一步

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

Firebase助手將您的應用程序註冊到Firebase項目中,並將必需的Firebase文件和代碼添加到您的Android項目中-所有這些操作都在Android Studio中進行。

請注意,將應用程序連接到Firebase的推薦選項是使用Firebase控制台設置工作流

  1. 在Android Studio中打開您的Android項目。

  2. 選擇“ 工具”>“ Firebase”以打開“ 助手”窗格。

  3. 選擇一個Firebase產品添加到您的應用程序。展開其部分,然後單擊教程鏈接(例如, Analytics(分析) > Log Analytics Analytics event )。

  4. 單擊“ 連接到Firebase”以將您的Android項目與Firebase連接。

  5. 在Firebase助手窗格中,單擊按鈕以添加所選Firebase產品的庫依賴關係(例如, 將Analytics添加到您的應用程序 )。

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

  7. 如果您添加了Google Analytics(分析),請運行您的應用以將已成功集成Firebase的驗證發送到Firebase。否則,您可以跳過此驗證步驟。

    您的設備日誌將顯示Firebase驗證已完成初始化。如果您在具有網絡訪問權限的仿真器上運行應用程序,則Firebase控制台會通知您應用程序連接已完成。

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

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

而已!確保檢查出建議的後續步驟

使用Firebase物料清單(BoM)進行控制庫版本控制

為了簡化庫版本管理,請考慮導入Firebase物料清單(BoM)。

可用庫

本部分列出了Android支持的Firebase產品及其Gradle依賴性。了解有關這些Firebase Android庫的更多信息:

爪哇

服務或產品 Gradle依賴 添加分析?
AdMob com.google.android.gms:play-services-ads:19.3.0
分析工具 com.google.firebase:firebase-analytics:17.4.4
應用索引 com.google.firebase:firebase-appindexing:19.1.0
認證方式 com.google.firebase:firebase-auth:19.3.2
Cloud Firestore com.google.firebase:firebase-firestore:21.5.0
Firebase Client SDK的雲功能 com.google.firebase:firebase-functions:19.0.2
雲消息傳遞 com.google.firebase:firebase-messaging:20.2.4
雲儲存 com.google.firebase:firebase-storage:19.1.1
速溶藥 com.google.firebase:firebase-crashlytics:17.1.1
動態鏈接 com.google.firebase:firebase-dynamic-links:19.1.0
Firebase ML Vision API com.google.firebase:firebase-ml-vision:24.0.3
Firebase ML自定義模型API com.google.firebase:firebase-ml-model-interpreter:22.0.3
應用內消息傳遞 com.google.firebase:firebase-inappmessaging:19.1.0
(需要)
應用內消息顯示 com.google.firebase:firebase-inappmessaging-display:19.1.0
(需要)
性能監控 com.google.firebase:firebase-perf:19.0.8
實時數據庫 com.google.firebase:firebase-database:19.3.1
遠程配置 com.google.firebase:firebase-config:19.2.0
Firebase材料清單(BoM) com.google.firebase:firebase-bom:25.7.0

最新的Firebase BoM版本包含BoM發行版中可用的每個Firebase Android庫的最新版本。對於映射到先前BoM版本的庫版本,請查看該版本的發行說明。

Google Play服務插件 com.google.gms:google-services:4.3.3
棄用的程式庫
Firebase ML:圖像標籤模型 com.google.firebase:firebase-ml-vision-image-label-model:20.0.1
Firebase ML:對象檢測和跟踪模型 com.google.firebase:firebase-ml-vision-object-detection-model:19.0.5
Firebase ML:人臉檢測模型 com.google.firebase:firebase-ml-vision-face-model:20.0.1
Firebase ML:條形碼掃描模型 com.google.firebase:firebase-ml-vision-barcode-model:16.1.1
Firebase ML:AutoML Vision Edge API com.google.firebase:firebase-ml-vision-automl:18.0.5
Firebase ML:自然語言API com.google.firebase:firebase-ml-natural-language:22.0.0
Firebase ML:語言識別模型 com.google.firebase:firebase-ml-natural-language-language-id-model:20.0.7
Firebase ML:轉換模型 com.google.firebase:firebase-ml-natural-language-translate-model:20.0.8
Firebase ML:智能回复模型 com.google.firebase:firebase-ml-natural-language-smart-reply-model:20.0.7

Kotlin + KTX

服務或產品 Gradle依賴 添加分析?
AdMob com.google.android.gms:play-services-ads:19.3.0
分析工具 com.google.firebase:firebase-analytics-ktx:17.4.4
應用索引 com.google.firebase:firebase-appindexing:19.1.0
認證方式 com.google.firebase:firebase-auth-ktx:19.3.2
Cloud Firestore com.google.firebase:firebase-firestore-ktx:21.5.0
Firebase Client SDK的雲功能 com.google.firebase:firebase-functions-ktx:19.0.2
雲消息傳遞 com.google.firebase:firebase-messaging:20.2.4
雲儲存 com.google.firebase:firebase-storage-ktx:19.1.1
速溶藥 com.google.firebase:firebase-crashlytics:17.1.1
動態鏈接 com.google.firebase:firebase-dynamic-links-ktx:19.1.0
Firebase ML Vision API com.google.firebase:firebase-ml-vision:24.0.3
Firebase ML自定義模型API com.google.firebase:firebase-ml-model-interpreter:22.0.3
應用內消息傳遞 com.google.firebase:firebase-inappmessaging-ktx:19.1.0
(需要)
應用內消息顯示 com.google.firebase:firebase-inappmessaging-display-ktx:19.1.0
(需要)
性能監控 com.google.firebase:firebase-perf:19.0.8
實時數據庫 com.google.firebase:firebase-database-ktx:19.3.1
遠程配置 com.google.firebase:firebase-config-ktx:19.2.0
Firebase材料清單(BoM) com.google.firebase:firebase-bom:25.7.0

最新的Firebase BoM版本包含BoM發行版中可用的每個Firebase Android庫的最新版本。對於映射到先前BoM版本的庫版本,請查看該版本的發行說明。

Google Play服務插件 com.google.gms:google-services:4.3.3
棄用的程式庫
Firebase ML:圖像標籤模型 com.google.firebase:firebase-ml-vision-image-label-model:20.0.1
Firebase ML:對象檢測和跟踪模型 com.google.firebase:firebase-ml-vision-object-detection-model:19.0.5
Firebase ML:人臉檢測模型 com.google.firebase:firebase-ml-vision-face-model:20.0.1
Firebase ML:條形碼掃描模型 com.google.firebase:firebase-ml-vision-barcode-model:16.1.1
Firebase ML:AutoML Vision Edge API com.google.firebase:firebase-ml-vision-automl:18.0.5
Firebase ML:自然語言API com.google.firebase:firebase-ml-natural-language:22.0.0
Firebase ML:語言識別模型 com.google.firebase:firebase-ml-natural-language-language-id-model:20.0.7
Firebase ML:轉換模型 com.google.firebase:firebase-ml-natural-language-translate-model:20.0.8
Firebase ML:智能回复模型 com.google.firebase:firebase-ml-natural-language-smart-reply-model:20.0.7

下一步

了解有關Firebase的信息:

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