將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圖標（ plat_android ）以啟動設置工作流程。

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

3. 在Android包名稱字段中輸入您應用的包名稱。

   包名稱是什麼，您在哪裡找到它？

   • 軟件包名稱在設備上和Google Play商店中唯一標識您的應用。

   • 軟件包名稱通常稱為應用程序ID 。

   • 在模塊（應用程序級）Gradle文件中找到應用程序的軟件包名稱，通常是app/build.gradle （示例軟件包名稱： com.yourcompany.yourproject ）。

   • 請注意，程序包名稱值區分大小寫，並且此Firebase Android應用程序在Firebase項目中註冊後無法更改。

4. （可選）輸入其他應用程序信息： 應用程序暱稱和調試簽名證書SHA-1 。

   在Firebase中如何使用應用程序暱稱和調試簽名證書SHA-1 ？

   • 應用暱稱 ：內部便捷標識符，僅在Firebase控制台中對您可見

   • 調試簽名證書SHA-1 ：Firebase身份驗證（使用Google登錄或電話號碼登錄時 ）和Firebase動態鏈接需要SHA-1哈希 。

5. 點擊註冊應用 。

第3步 ：添加Firebase配置文件

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

   1. 點擊下載google-services.json以獲取您的Firebase Android配置文件（ google-services.json ）。

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

   您需要了解什麼有關此配置文件？

   • Firebase配置文件包含項目的唯一但非秘密的標識符。要了解有關此配置文件的更多信息，請訪問了解Firebase項目 。

   • 您可以隨時再次下載Firebase配置文件 。

   • 確保配置文件名未附加其他字符，例如(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 dependency for the Firebase SDK for Google Analytics
     implementation 'com.google.firebase:firebase-analytics:17.5.0'
   
     // Add the dependencies for any other desired Firebase products
     // For example, to use Firebase Authentication and Cloud Firestore
     implementation 'com.google.firebase:firebase-auth:19.4.0'
     implementation 'com.google.firebase:firebase-firestore:21.6.0'
   }
   
   // Getting a "Could not find" error? Make sure that you've added
   // Google's Maven repository to your project-level build.gradle file
   

   Kotlin + KTX

   dependencies {
     // ...
   
     // Add the dependency for the Firebase SDK for Google Analytics
     implementation 'com.google.firebase:firebase-analytics-ktx:17.5.0'
   
     // Add the dependencies for any other desired Firebase products
     // For example, to use Firebase Authentication and Cloud Firestore
     implementation 'com.google.firebase:firebase-auth-ktx:19.4.0'
     implementation 'com.google.firebase:firebase-firestore-ktx:21.6.0'
   }
   
   // Getting a "Could not find" error? Make sure that you've added
   // Google's Maven repository to your project-level build.gradle file
   

   未啟用分析

   爪哇

   dependencies {
     // ...
   
     // Add the dependencies for the desired Firebase products
     // For example, to use Firebase Authentication and Cloud Firestore
     implementation 'com.google.firebase:firebase-auth:19.4.0'
     implementation 'com.google.firebase:firebase-firestore:21.6.0'
   }
   
   // Getting a "Could not find" error? Make sure that you've added
   // Google's Maven repository to your project-level build.gradle file
   

   Kotlin + KTX

   dependencies {
     // ...
   
     // Add the dependencies for the desired Firebase products
     // For example, to use Firebase Authentication and Cloud Firestore
     implementation 'com.google.firebase:firebase-auth-ktx:19.4.0'
     implementation 'com.google.firebase:firebase-firestore-ktx:21.6.0'
   }
   
   // Getting a "Could not find" error? Make sure that you've added
   // Google's Maven repository to your project-level build.gradle file
   

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

而已！您可以跳到下一步 。

選項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連接。

   這個工作流程是做什麼的？

   • 此工作流程會使用您的應用的程序包名稱自動創建一個新的Firebase Android應用。

     您可以在現有Firebase項目或新項目中創建此新Firebase Android應用。

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

     • 如果您創建一個新項目，我們強烈建議您為該項目設置Google Analytics（分析），這使您可以使用許多Firebase產品獲得最佳體驗。

   • 此工作流程還將Firebase項目的Android配置文件（ google-services.json ）添加到應用程序的模塊（應用程序級）目錄中。

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

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

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

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

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

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

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

使用Firebase物料清單（BoM）進行控制庫版本控制

為了簡化庫版本管理，請考慮導入Firebase物料清單（BoM）。

可用庫

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

• 參考文檔（ Java | Kotlin + KTX ）

• Firebase Android SDK GitHub存儲庫

下一步

了解有關Firebase的信息：

• 訪問了解Firebase項目以了解有關Firebase項目和項目最佳實踐的更多信息。

• 探索示例Firebase應用程序 。

• 獲得Firebase Android Codelab的動手經驗。

• 在周末課程中了解有關Firebase的更多信息。

• 準備啟動您的應用程序：

  • 在GCP控制台中為您的項目設置預算警報 。
  • 在Firebase控制台中監控您的使用情況和結算信息中心 。
  • 查看Firebase啟動核對錶 。

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

• 通過Analytics（分析）獲得有關用戶行為的見解。

• 使用Authentication設置用戶身份驗證流程。

• 使用Cloud Firestore或實時數據庫存儲數據，例如用戶信息。

• 使用Cloud Storage存儲文件，如照片和視頻。

• 使用Cloud Functions觸發在安全環境中運行的後端代碼。

• 使用Cloud Messaging發送通知。

• 使用Crashlytics找出何時以及為什麼您的應用程序崩潰。