將 Firebase 添加到您的 Android 項目

先決條件

如果你不已經有一個Android項目,只是想嘗試一個火力地堡的產品,你可以下載我們的一個入門示例


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

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



方法1:使用火力地堡控制台添加火力地堡

添加火力地堡到您的應用程序既包括在任務火力地堡控制台並在開放的Android項目(例如,您從控制台下載火力地堡的配置文件,然後將其移動到您的Android項目)。

第1步:創建一個火力地堡項目

在將 Firebase 添加到您的 Android 應用之前,您需要創建一個 Firebase 項目以連接到您的 Android 應用。參觀了解火力地堡項目,詳細了解項目的火力地堡。

第2步:註冊與火力地堡您的應用程序

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

  1. 轉至火力地堡控制台

  2. 在項目概述頁面的中心,點擊圖標的Android( )或添加應用程序來啟動安裝工作流程。

  3. Android包名稱字段中輸入您的應用程式套件名稱。

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

  5. 點擊註冊應用

第3步:添加火力地堡配置文件

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

    1. 點擊下載谷歌,services.json獲得你的火力地堡的Android配置文件( google-services.json )。

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

  2. 為使火力地堡的產品在你的應用程序,添加了谷歌的服務插件到您的搖籃文件。

    1. 在你的根級別(項目級別)搖籃文件( build.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. 在你的模塊(應用程序級)搖籃文件(通常是app/build.gradle ),應用谷歌服務搖籃插件:

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

第4步:添加火力地堡的SDK到您的應用

  1. 使用火力地堡Android的物料清單,申報依賴的火力地堡產品要在您的應用程序使用。聲明它們的模塊(應用程序級)搖籃文件(通常在app/build.gradle )。

    啟用分析

    爪哇

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

    通過使用火力地堡Android的物料清單,您的應用程序將始終使用火力地堡的Android庫的兼容版本。

    未啟用分析

    爪哇

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

    通過使用火力地堡Android的物料清單,您的應用程序將始終使用火力地堡的Android庫的兼容版本。

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

而已!您可以直接跳到檢查出的推薦下一個步驟

如果你在設置時遇到問題,雖然有,請訪問Android的故障排除和常見問題解答



選項2:使用火力地堡火力地堡的助理添加

火力地堡助理用火力地堡項目註冊您的應用程序,並增加了必要的火力地堡的文件,插件和依賴關係到你的Android項目-所有在Android Studio中!

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

    • 在Windows / Linux的:幫助>檢查更新
    • Mac系統:Android的工作室>檢查更新
  2. 打開火力地堡助理:工具>火力地堡

  3. 助手窗格中,選擇一個火力地堡產品添加到您的應用程序。擴大部分,然後點擊教程鏈接(例如,分析>日誌的分析事件)。

    1. 單擊連接到火力地堡連接你與火力地堡的Android項目。

    2. 點擊按鈕添加所需的火力地堡的產品(例如,添加數據分析,你的應用程序)。

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

  5. 助手窗格,請根據您選擇的火力地堡產品剩餘的安裝說明。

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

而已!確保檢查出推薦的下一個步驟

如果你在設置時遇到問題,雖然有,請訪問Android的故障排除和常見問題解答



可用庫

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

請注意,使用時火力地堡Android的物料清單,你不要當你在聲明火力地堡依賴庫指定單個庫版本build.gradle

爪哇

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

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

28.3.0
廣告com.google.android.gms:play-services-ads 20.2.0
分析com.google.firebase:firebase-analytics 19.0.0
應用檢查自定義提供程序com.google.firebase:firebase-appcheck 16.0.0-beta02
應用檢查調試提供程序com.google.firebase:firebase-appcheck-debug 16.0.0-beta02
應用檢查 SafetyNet 提供商com.google.firebase:firebase-appcheck-safetynet 16.0.0-beta02
應用分發插件com.google.firebase:firebase-appdistribution-gradle 2.1.3
應用索引com.google.firebase:firebase-appindexing 20.0.0
驗證com.google.firebase:firebase-auth 21.0.1
雲防火牆com.google.firebase:firebase-firestore 23.0.3
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.2.0
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.2.0
Crashlytics 插件com.google.firebase:firebase-crashlytics-gradle 2.7.1
動態功能模塊支持com.google.firebase:firebase-dynamic-module-support 16.0.0-beta01
動態鏈接com.google.firebase:firebase-dynamic-links 20.1.1
應用內消息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.2
性能監控插件com.google.firebase:perf-plugin 1.4.0
實時數據庫com.google.firebase:firebase-database 20.0.1
遠程配置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.3.0
廣告com.google.android.gms:play-services-ads 20.2.0
分析com.google.firebase:firebase-analytics-ktx 19.0.0
應用檢查自定義提供程序com.google.firebase:firebase-appcheck 16.0.0-beta02
應用檢查調試提供程序com.google.firebase:firebase-appcheck-debug 16.0.0-beta02
應用檢查 SafetyNet 提供商com.google.firebase:firebase-appcheck-safetynet 16.0.0-beta02
應用分發插件com.google.firebase:firebase-appdistribution-gradle 2.1.3
應用索引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.3
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.2.0
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.2.0
Crashlytics 插件com.google.firebase:firebase-crashlytics-gradle 2.7.1
動態功能模塊支持com.google.firebase:firebase-dynamic-module-support 16.0.0-beta01
動態鏈接com.google.firebase:firebase-dynamic-links-ktx 20.1.1
應用內消息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.2
性能監控插件com.google.firebase:perf-plugin 1.4.0
實時數據庫com.google.firebase:firebase-database-ktx 20.0.1
遠程配置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: