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

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

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

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

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

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

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

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.5'  // 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:27.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'
   }
   

   Kotlin + KTX

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

   Kotlin + KTX

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

就是這樣！您可以跳過以檢查建議的後續步驟。

選項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產品。展開其部分，然後單擊教程鏈接（例如， Analytics（分析）> Log a Analytics event ）。

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

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

      • 此工作流程會使用您的應用程序的包名稱自動創建一個新的Firebase Android應用程序。您可以在現有Firebase項目或新項目中創建此新的Firebase Android應用程序。

        以下是有關設置Firebase項目的一些提示：

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

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

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

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

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

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

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

就是這樣！確保檢查出建議的後續步驟。

可用庫

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

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

• Firebase Android SDK GitHub存儲庫

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

下一步

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

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

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

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

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

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

• 使用Cloud Messaging發送通知。

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

了解有關Firebase的信息：

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

• 如果您對Firebase和Android開發不熟悉或不熟悉的概念有疑問，請訪問了解有關Android和Firebase的更多信息。

• 探索示例Firebase應用程序。

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

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

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

  • 在Google Cloud Console中為您的項目設置預算警報。
  • 在Firebase控制台中監控“使用情況”和“計費”儀表板，以全面了解項目在多個Firebase服務中的使用情況。
  • 查看Firebase啟動核對錶。