先決條件
將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控制台添加Firebase
將Firebase添加到您的應用程序涉及Firebase控制台和打開的Android項目中的任務(例如,您從控制台下載Firebase配置文件,然後將其移至Android項目)。
步驟1 :建立Firebase專案
在將Firebase添加到Android應用之前,您需要創建一個Firebase項目以連接到Android應用。訪問了解Firebase項目以了解有關Firebase項目的更多信息。
第2步:在Firebase中註冊您的應用
要在Android應用中使用Firebase,您需要在Firebase項目中註冊您的應用。註冊您的應用程序通常被稱為“將您的應用程序添加到您的項目中”。
轉到Firebase控制台。
在項目概述頁面的中心,單擊Android圖標(
)或添加應用程序以啟動設置工作流程。在“ Android包名稱”字段中輸入您應用的包名稱。
程序包名稱在設備上和Google Play商店中唯一標識您的應用。
程序包名稱通常稱為應用程序ID 。
在模塊(應用程序級)Gradle文件中找到應用程序的軟件包名稱,通常是
app/build.gradle
(示例軟件包名稱:com.yourcompany.yourproject
)。請注意,程序包名稱值區分大小寫,並且在您的Firebase項目中註冊後,此Firebase Android應用程序無法更改它。
(可選)輸入其他應用程序信息:應用程序暱稱和調試簽名證書SHA-1 。
應用暱稱:內部便捷標識符,僅在Firebase控制台中對您可見
調試簽名證書SHA-1 :Firebase身份驗證(使用Google登錄或電話號碼登錄時)和Firebase動態鏈接需要SHA-1哈希。
點擊註冊應用。
第3步:添加Firebase配置文件
將Firebase Android配置文件添加到您的應用中:
點擊下載google-services.json以獲取您的Firebase Android配置文件(
)。google-services.json 將您的配置文件移動到應用程序的模塊(應用程序級)目錄中。
Firebase配置文件包含項目的唯一但非秘密的標識符。要了解有關此配置文件的更多信息,請訪問了解Firebase項目。
您可以隨時再次下載Firebase配置文件。
確保配置文件名未附加其他字符,例如
(2)
。
要在您的應用中啟用Firebase產品,請將google-services插件添加到您的Gradle文件中。
在您的根級別(項目級別)的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 // ... } }
在您的模塊(應用程序級)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添加到您的應用中
使用Firebase Android BoM ,聲明要在應用程序中使用的Firebase產品的依賴項。在模塊(應用程序級)Gradle文件(通常是
app/build.gradle
)中聲明它們。啟用分析
爪哇
dependencies { // ... // Import the Firebase BoM implementation platform('com.google.firebase:firebase-bom:26.6.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.6.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.6.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.6.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 :使用Firebase助手添加Firebase
Firebase助手將您的應用程序註冊到Firebase項目,並將必需的Firebase文件,插件和依賴項添加到您的Android項目中-所有這些操作都在Android Studio中進行!
在Android Studio中打開您的Android項目並訪問Firebase助手:
轉到文件>檢查更新,以確保您使用的是最新版本的Android Studio和Firebase助手。
轉到“工具”>“ Firebase”以打開“助手”窗格。
選擇一個Firebase產品添加到您的應用程序。展開其部分,然後單擊教程鏈接(例如,
Analytics(分析)> Log a Analytics event )。單擊“連接到Firebase”以將您的Android項目與Firebase連接。
此工作流程會使用您的應用程序的包名稱自動創建一個新的Firebase Android應用程序。您可以在現有Firebase項目或新項目中創建此新的Firebase Android應用程序。
以下是有關設置Firebase項目的一些提示:
訪問“了解Firebase項目”以了解有關向Firebase項目添加應用程序的最佳實踐和注意事項的更多信息,包括如何處理多個構建變體。
如果您創建一個新項目,我們強烈建議您為該項目設置Google Analytics(分析),這使您可以使用許多Firebase產品獲得最佳體驗。
此工作流程還將Firebase項目的Android配置文件(
)添加到應用程序的模塊(應用程序級)目錄中。google-services.json
單擊按鈕添加所需的Firebase產品(例如,
將Analytics添加到您的應用程序 )。
同步您的應用程序,以確保所有依賴項都具有必需的版本。
在“ Firebase助手”窗格中,按照所選Firebase產品的其餘設置說明進行操作。
通過Firebase助手添加任意數量的其他Firebase產品!
而已!確保檢查出建議的後續步驟。
可用庫
本部分列出了Android支持的Firebase產品及其Gradle依賴性。了解有關這些Firebase Android庫的更多信息:
參考文檔( Java | Kotlin + KTX )
Firebase Android SDK GitHub存儲庫
請注意,在使用Firebase Android BoM時,在build.gradle
聲明Firebase庫依賴項時,無需指定單個庫版本。
爪哇
服務或產品 | 搖籃依賴 | 最新的 版本 | 添加分析? |
---|---|---|---|
Firebase Android BoM (材料清單) | com.google.firebase:firebase-bom 最新的Firebase BoM版本包含每個Firebase Android庫的最新版本。要了解哪些庫版本已映射到特定的BoM版本,請查看該BoM版本的發行說明。 | 26.6.0 | |
AdMob | com.google.android.gms:play-services-ads | 19.7.0 | |
分析工具 | com.google.firebase:firebase-analytics | 18.0.2 | |
應用索引 | com.google.firebase:firebase-appindexing | 19.2.0 | |
驗證 | com.google.firebase:firebase-auth | 20.0.3 | |
Cloud Firestore | com.google.firebase:firebase-firestore | 22.1.1 | |
Firebase Client SDK的雲功能 | com.google.firebase:firebase-functions | 19.2.0 | |
雲消息傳遞 | com.google.firebase:firebase-messaging | 21.0.1 | |
雲儲存 | com.google.firebase:firebase-storage | 19.2.1 | |
速溶藥 | com.google.firebase:firebase-crashlytics | 17.3.1 | |
動態鏈接 | com.google.firebase:firebase-dynamic-links | 19.1.1 | |
Firebase ML模型下載器API | com.google.firebase:firebase-ml-modeldownloader | 23.0.0 | |
應用內消息傳遞 | com.google.firebase:firebase-inappmessaging | 19.1.5 | (必需的) |
應用內消息顯示 | com.google.firebase:firebase-inappmessaging-display | 19.1.5 | (必需的) |
性能監控 | com.google.firebase:firebase-perf | 19.1.1 | |
實時數據庫 | com.google.firebase:firebase數據庫 | 19.6.0 | |
遠程配置 | com.google.firebase:firebase-config | 20.0.4 | |
Google Play服務插件 | com.google.gms:google-services | 4.3.5 | |
棄用的程式庫 | |||
Firebase ML自定義模型API | com.google.firebase:firebase-ml-model-解釋器 | 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 |
Kotlin + KTX
服務或產品 | 搖籃依賴 | 最新的 版本 | 添加分析? |
---|---|---|---|
Firebase Android BoM (材料清單) | com.google.firebase:firebase-bom 最新的Firebase BoM版本包含每個Firebase Android庫的最新版本。要了解哪些庫版本已映射到特定的BoM版本,請查看該BoM版本的發行說明。 | 26.6.0 | |
AdMob | com.google.android.gms:play-services-ads | 19.7.0 | |
分析工具 | com.google.firebase:firebase-analytics-ktx | 18.0.2 | |
應用索引 | com.google.firebase:firebase-appindexing | 19.2.0 | |
驗證 | com.google.firebase:firebase-auth-ktx | 20.0.3 | |
雲消防站 | com.google.firebase:firebase-firestore-ktx | 22.1.1 | |
Firebase Client SDK的雲功能 | com.google.firebase:firebase-functions-ktx | 19.2.0 | |
雲消息傳遞 | com.google.firebase:firebase-messaging-ktx | 21.0.1 | |
雲儲存 | com.google.firebase:firebase-storage-ktx | 19.2.1 | |
速溶藥 | com.google.firebase:firebase-crashlytics-ktx | 17.3.1 | |
動態鏈接 | com.google.firebase:firebase-dynamic-links-ktx | 19.1.1 | |
應用內消息傳遞 | com.google.firebase:firebase-inappmessaging-ktx | 19.1.5 | (必需的) |
應用內消息顯示 | com.google.firebase:firebase-inappmessaging-display-ktx | 19.1.5 | (必需的) |
性能監控 | com.google.firebase:firebase-perf-ktx | 19.1.1 | |
實時數據庫 | com.google.firebase:firebase-database-ktx | 19.6.0 | |
遠程配置 | com.google.firebase:firebase-config-ktx | 20.0.4 | |
Google Play服務插件 | com.google.gms:google-services | 4.3.5 | |
棄用的程式庫 | |||
Firebase ML自定義模型API | com.google.firebase:firebase-ml-model-解釋器 | 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服務添加到您的應用程序:
通過Analytics(分析)獲得有關用戶行為的見解。
使用Authentication設置用戶身份驗證流程。
使用Cloud Firestore或實時數據庫存儲數據,例如用戶信息。
使用Cloud Storage存儲文件,例如照片和視頻。
使用Cloud Functions觸發在安全環境中運行的後端代碼。
使用Cloud Messaging發送通知。
使用Crashlytics找出何時以及為什麼您的應用程序崩潰。
了解有關Firebase的信息:
訪問了解Firebase項目以了解有關Firebase項目和項目最佳實踐的更多信息。
如果您對Firebase和Android開發不熟悉或不熟悉的概念有疑問,請訪問了解有關Android和Firebase的更多信息。
獲得Firebase Android Codelab的動手經驗。
準備啟動您的應用程序:
- 在Google Cloud Console中為您的項目設置預算警報。
- 在Firebase控制台中監控您的使用情況和結算信息中心。
- 查看Firebase啟動核對錶。