Google is committed to advancing racial equity for Black communities. See how.
本頁面由 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中註冊您的應用

要在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.4'  // 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:26.0.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'
    }
    

    Kotlin + KTX

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:26.0.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:26.0.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'
    }
    

    Kotlin + KTX

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:26.0.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. 同步您的應用程序,以確保所有依賴項都具有必需的版本。

而已!您可以跳過以檢查建議的後續步驟



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

Firebase助手將您的應用程序註冊到Firebase項目,並將必需的Firebase文件,插件和依賴項添加到您的Android項目中-全部從Android Studio中進行!

  1. 在Android Studio中打開您的Android項目並訪問Firebase助手:

    1. 轉到“文件”>“檢查更新” ,以確保您使用的是最新版本的Android Studio和Firebase助手。

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

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

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

    2. 單擊按鈕添加所需的Firebase產品(例如,將Analytics添加到您的應用程序)。

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

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

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

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



可用庫

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

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

爪哇

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

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

26.0.0
AdMob com.google.android.gms:play-services-ads 19.5.0
分析工具com.google.firebase:firebase-analytics 18.0.0
應用索引com.google.firebase:firebase-appindexing 19.1.0
認證方式com.google.firebase:firebase-auth 20.0.0
Cloud Firestore com.google.firebase:firebase-firestore 22.0.0
Firebase Client SDK的雲功能com.google.firebase:firebase-functions 19.1.0
雲消息傳遞com.google.firebase:firebase-messaging 21.0.0
雲儲存com.google.firebase:firebase-storage 19.2.0
速溶藥com.google.firebase:firebase-crashlytics 17.2.2
動態鏈接com.google.firebase:firebase-dynamic-links 19.1.1
Firebase ML Vision API com.google.firebase:firebase-ml-vision 24.1.0
Firebase ML自定義模型API com.google.firebase:firebase-ml-model-interpreter 22.0.4
應用內消息傳遞com.google.firebase:firebase-inappmessaging 19.1.2
(需要)
應用內消息顯示com.google.firebase:firebase-inappmessaging-display 19.1.2
(需要)
性能監控com.google.firebase:firebase-perf 19.0.9
實時數據庫com.google.firebase:firebase數據庫19.5.1
遠程配置com.google.firebase:firebase-config 20.0.0
Google Play服務插件com.google.gms:google-services 4.3.4
棄用的程式庫
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

Kotlin + KTX

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

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

26.0.0
AdMob com.google.android.gms:play-services-ads 19.5.0
分析工具com.google.firebase:firebase-analytics-ktx 18.0.0
應用索引com.google.firebase:firebase-appindexing 19.1.0
認證方式com.google.firebase:firebase-auth-ktx 20.0.0
Cloud Firestore com.google.firebase:firebase-firestore-ktx 22.0.0
Firebase Client SDK的雲功能com.google.firebase:firebase-functions-ktx 19.1.0
雲消息傳遞com.google.firebase:firebase-messaging-ktx 21.0.0
雲儲存com.google.firebase:firebase-storage-ktx 19.2.0
速溶藥com.google.firebase:firebase-crashlytics-ktx 17.2.2
動態鏈接com.google.firebase:firebase-dynamic-links-ktx 19.1.1
Firebase ML Vision API com.google.firebase:firebase-ml-vision 24.1.0
Firebase ML自定義模型API com.google.firebase:firebase-ml-model-interpreter 22.0.4
應用內消息傳遞com.google.firebase:firebase-inappmessaging-ktx 19.1.2
(需要)
應用內消息顯示com.google.firebase:firebase-inappmessaging-display-ktx 19.1.2
(需要)
性能監控com.google.firebase:firebase-perf-ktx 19.0.9
實時數據庫com.google.firebase:firebase-database-ktx 19.5.1
遠程配置com.google.firebase:firebase-config-ktx 20.0.0
Google Play服務插件com.google.gms:google-services 4.3.4
棄用的程式庫
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的信息: