將 Firebase 添加到您的 Android 項目

先決條件

• 安裝或更新的Android工作室它的最新版本。

• 確保您的項目滿足以下要求：

  • 目標 API 級別 16 (Jelly Bean) 或更高版本
  • 使用 Gradle 4.1 或更高版本
  • 使用Jetpack的（AndroidX） ，其中包括滿足這些版本要求：
    • com.android.tools.build:gradle V3.2.1或更高版本
    • compileSdkVersion 28或更高版本

• 建立一個物理設備或使用模擬器來運行你的應用程序。
  需要注意的是與谷歌Play服務的依賴火力地堡的SDK所需要的設備或模擬器安裝了谷歌Play服務。

• 登錄到火力地堡使用您的谷歌帳戶。

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

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

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

---

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

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

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

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

創建 Firebase 項目

1. 在火力地堡控制台，單擊添加項目，然後選擇或輸入項目名稱。

   如果您有現有的 GCP 項目，則可以從下拉菜單中選擇該項目以將 Firebase 資源添加到該項目。

2. （可選）如果要創建一個新的項目，你可以編輯項目ID。

   Firebase 會自動為您的 Firebase 項目分配一個唯一 ID。參觀了解火力地堡項目，了解火力地堡如何使用項目ID。

3. 點擊繼續。

4. （可選）設置谷歌分析為您的項目，它使您能夠使用下列任何火力地堡產品的最佳體驗：

   Firebase Crashlytics Firebase 預測

   Firebase 雲消息傳遞 Firebase 應用內消息傳遞

   Firebase 遠程配置 Firebase A/B 測試

   當系統提示，選擇要使用現有的谷歌Analytics帳戶或創建一個新帳戶。
   如果您選擇創建一個新帳戶，選擇您的分析報告位置，然後接受你的項目中的數據共享設置和谷歌Analytics（分析）條款。

5. 單擊創建項目（或添加火力地堡，如果您使用的是谷歌現有的雲項目）。

Firebase 會自動為您的 Firebase 項目配置資源。該過程完成後，您將轉到 Firebase 控制台中 Firebase 項目的概覽​​頁面。

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

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

1. 轉至火力地堡控制台。

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

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

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

   • 一包名唯一地標識在設備上，並在谷歌Play商店您的應用程序。

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

   • 尋找你的模塊（應用級）搖籃文件應用程式的套件名稱，一般app/build.gradle （例如包名稱： com.yourcompany.yourproject ）。

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

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

   如何在App暱稱和SHA-1中火力地堡使用調試簽名證書？

   • 應用暱稱：內部，方便標識符，只有你可以看到在火力地堡控制台

   • 調試簽名的證書SHA-1： SHA-1散列（當使用由火力地堡需要驗證谷歌登錄或在電話數字符號）和火力地堡的動態鏈接。

5. 點擊註冊應用。

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

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

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

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

   關於這個配置文件，你需要知道什麼？

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

   • 您可以下載你的火力地堡的配置文件在任何時候再次。

   • 確保配置文件名不與其他字符附加，如(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 Gradle 插件 (AGP) v4.2 或更早版本的 Gradle 構建需要啟用 Java 8 支持。否則，這些 Android 項目在添加 Firebase SDK 時會出現構建失敗。

   要修復此構建失敗，您可以遵循以下兩個選項之一：

   • 上市添加compileOptions從錯誤信息到您的應用一級build.gradle文件。
   • 增加minSdkVersion為您的Android項目26個以上。

   了解更多關於在此建立失敗這個常見問題。

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

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

---

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

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

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

   • 在Windows / Linux的：幫助>檢查更新
   • Mac系統：Android的工作室>檢查更新

2. 打開火力地堡助理：工具>火力地堡。

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

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

      這個工作流程有什麼作用？

      • 該工作流自動創建一個使用你的應用程序的一個新的火力地堡Android應用包名稱。您可以在現有 Firebase 項目或新項目中創建這個新的 Firebase Android 應用。

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

        • 參觀了解火力地堡項目，詳細了解最佳實踐和注意事項添加應用到火力地堡項目，包括如何處理多個構建變種。

        • 如果您創建新項目，我們強烈建議您為您的項目設置 Google Analytics，這樣您就可以在使用許多 Firebase 產品時獲得最佳體驗。

      • 該工作流也增加了你的火力地堡項目的Android配置文件（ google-services.json ）到您的應用程序的模塊（應用級）的目錄。

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

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

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

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

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

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

---

可用庫

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

• 參考文檔（ Java的|科特林+ KTX ）

• 火力地堡的Android SDK GitHub庫

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

---

下一步

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

• 獲得與用戶的行為分析。

• 建立與用戶認證流程認證。

• 存儲數據，如用戶信息，與雲計算公司的FireStore或實時數據庫。

• 存儲文件，如照片和視頻，與雲存儲。

• 觸發後端代碼是在安全的環境中運行的雲功能。

• 發送通知與雲端通訊。

• 了解何時以及為什麼您的應用程序與崩潰Crashlytics 。

了解 Firebase：

• 參觀了解火力地堡項目了解更多有關火力地堡項目和項目的最佳實踐。

• 參觀了解更多關於Android和火力地堡，如果您有不熟悉或特定於火力地堡和Android開發理念的問題。

• 探索樣本火力地堡的應用程序。

• 獲取實踐與經驗火力地堡的Android程式碼實驗室。

• 了解更多與火力地堡在一個週末課程。

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

  • 設立預算警報在谷歌雲端控制台項目。
  • 監控使用和計費儀表盤在火力地堡控制台獲得跨多個火力地堡服務項目的使用情況的全貌。
  • 查看火力地堡發布清單。

• Firebase 和您的 Android 項目有問題嗎？訪問Android的故障排除和常見問題解答。