Điều kiện tiên quyết
Cài đặt hoặc cập nhật Android Studio lên phiên bản mới nhất.
Đảm bảo dự án của bạn đáp ứng các yêu cầu này (lưu ý rằng một số sản phẩm có thể có các yêu cầu nghiêm ngặt hơn):
- Nhắm đến API cấp 19 (KitKat) trở lên
- Sử dụng Android 4.4 trở lên
- Sử dụng Jetpack (AndroidX), trong đó có việc đáp ứng các yêu cầu sau đây về phiên bản:
com.android.tools.build:gradle
phiên bản 7.3.0 trở lêncompileSdkVersion
28 trở lên
Thiết lập thiết bị thực hoặc sử dụng trình mô phỏng để chạy ứng dụng.
Xin lưu ý rằng Firebase SDK có phần phụ thuộc trên Dịch vụ Google Play yêu cầu thiết bị hoặc trình mô phỏng phải cài đặt Dịch vụ Google Play.Đăng nhập vào Firebase bằng Tài khoản Google của bạn.
Nếu chưa có dự án Android và chỉ muốn dùng thử sản phẩm Firebase, bạn có thể tải một trong các mẫu bắt đầu nhanh của chúng tôi xuống.
Bạn có thể kết nối ứng dụng Android với Firebase bằng một trong các cách sau:
- Cách 1: (nên dùng) Sử dụng quy trình thiết lập bảng điều khiển của Firebase.
- Cách 2: Sử dụng Trợ lý Firebase của Android Studio (có thể yêu cầu cấu hình bổ sung).
Cách 1: Thêm Firebase bằng bảng điều khiển của Firebase
Khi thêm Firebase vào ứng dụng, bạn cần thực hiện cả các thao tác trong cả bảng điều khiển của Firebase và trong dự án Android đang mở (ví dụ: bạn tải các tệp cấu hình Firebase xuống từ bảng điều khiển, sau đó di chuyển các tệp đó vào dự án Android).
Bước 1: Tạo dự án Firebase
Trước khi có thể thêm Firebase vào ứng dụng Android, bạn cần tạo một dự án Firebase để kết nối với ứng dụng Android của mình. Hãy truy cập vào phần Tìm hiểu các dự án Firebase để tìm hiểu thêm về các dự án Firebase.
Bước 2: Đăng ký ứng dụng của bạn với Firebase
Để sử dụng Firebase trong ứng dụng Android, bạn cần đăng ký ứng dụng đó với dự án Firebase. Việc đăng ký ứng dụng thường được gọi là "thêm" ứng dụng vào dự án.
Truy cập vào bảng điều khiển của Firebase.
Ở giữa trang tổng quan của dự án, hãy nhấp vào biểu tượng Android (
) hoặc Add app (Thêm ứng dụng) để chạy quy trình thiết lập.Nhập tên gói ứng dụng vào trường Android package name (Tên gói Android).
(Không bắt buộc) Nhập các thông tin khác về ứng dụng: Biệt hiệu của ứng dụng và Chứng chỉ ký gỡ lỗi SHA-1.
Nhấp vào Đăng ký ứng dụng.
Bước 3: Thêm tệp cấu hình Firebase
Tải xuống rồi thêm tệp cấu hình Android trên Firebase (
) vào ứng dụng của bạn:google-services.json Nhấp vào Download google-services.json để lấy tệp cấu hình Firebase Android của bạn.
Di chuyển tệp cấu hình vào thư mục gốc mô-đun (cấp ứng dụng) của ứng dụng.
Để Firebase SDK có thể truy cập vào các giá trị trong tệp cấu hình
, bạn cần có Trình bổ trợ Gradle cho các dịch vụ của Google (google-services.json google-services
).Trong tệp Gradle cấp độ gốc (cấp dự án) (
<project>/build.gradle.kts
hoặc<project>/build.gradle
), hãy thêm trình bổ trợ các dịch vụ của Google làm phần phụ thuộc:Kotlin
plugins { id("com.android.application") version "7.3.0" apply false // ... // Add the dependency for the Google services Gradle plugin id("com.google.gms.google-services") version "4.4.1" apply false }
Groovy
plugins { id 'com.android.application' version '7.3.0' apply false // ... // Add the dependency for the Google services Gradle plugin id 'com.google.gms.google-services' version '4.4.1' apply false }
Trong tệp Gradle mô-đun (cấp ứng dụng) (thường là
<project>/<app-module>/build.gradle.kts
hoặc<project>/<app-module>/build.gradle
), hãy thêm trình bổ trợ dịch vụ của Google:Kotlin
plugins { id("com.android.application") // Add the Google services Gradle plugin id("com.google.gms.google-services") // ... }
Groovy
plugins { id 'com.android.application' // Add the Google services Gradle plugin id 'com.google.gms.google-services' // ... }
Bước 4: Thêm Firebase SDK vào ứng dụng của bạn
Trong tệp Gradle mô-đun (cấp ứng dụng) (thường là
<project>/<app-module>/build.gradle.kts
hoặc<project>/<app-module>/build.gradle
), hãy thêm các phần phụ thuộc cho các sản phẩm của Firebase mà bạn muốn sử dụng trong ứng dụng của mình. Bạn nên sử dụng Firebase Android BoM để kiểm soát việc tạo phiên bản thư viện.Đã bật Analytics
dependencies { // ... // Import the Firebase BoM implementation(platform("com.google.firebase:firebase-bom:33.0.0")) // When using the BoM, you don't specify versions in Firebase library dependencies // Add the dependency for the Firebase SDK for Google Analytics implementation("com.google.firebase:firebase-analytics") // TODO: Add the dependencies for any other Firebase products you want to use // See https://firebase.google.com/docs/android/setup#available-libraries // For example, add the dependencies for Firebase Authentication and Cloud Firestore implementation("com.google.firebase:firebase-auth") implementation("com.google.firebase:firebase-firestore") }
Bằng cách sử dụng Firebase Android BoM, ứng dụng của bạn sẽ luôn sử dụng các phiên bản tương thích của thư viện Android Firebase.
Bạn đang tìm một mô-đun thư viện dành riêng cho Kotlin? Kể từ tháng 10 năm 2023 (Firebase BoM 32.5.0), cả nhà phát triển Kotlin và Java đều có thể sử dụng mô-đun thư viện chính (để biết thông tin chi tiết, hãy xem phần Câu hỏi thường gặp về sáng kiến này).
Analytics chưa được bật
dependencies { // ... // Import the Firebase BoM implementation(platform("com.google.firebase:firebase-bom:33.0.0")) // When using the BoM, you don't specify versions in Firebase library dependencies // TODO: Add the dependencies for Firebase products you want to use // See https://firebase.google.com/docs/android/setup#available-libraries // For example, add the dependencies for Firebase Authentication and Cloud Firestore implementation("com.google.firebase:firebase-auth") implementation("com.google.firebase:firebase-firestore") }
Bằng cách sử dụng Firebase Android BoM, ứng dụng của bạn sẽ luôn sử dụng các phiên bản tương thích của thư viện Android Firebase.
Bạn đang tìm một mô-đun thư viện dành riêng cho Kotlin? Kể từ tháng 10 năm 2023 (Firebase BoM 32.5.0), cả nhà phát triển Kotlin và Java đều có thể sử dụng mô-đun thư viện chính (để biết thông tin chi tiết, hãy xem phần Câu hỏi thường gặp về sáng kiến này).
Sau khi thêm các phần phụ thuộc cho những sản phẩm mà bạn muốn sử dụng, hãy đồng bộ hoá dự án Android với các tệp Gradle.
Tất cả chỉ có thế! Bạn có thể bỏ qua để xem các bước tiếp theo được đề xuất.
Tuy nhiên, nếu bạn gặp sự cố khi thiết lập, hãy truy cập vào bài viết Câu hỏi thường gặp và khắc phục sự cố về Android.
Cách 2: Thêm Firebase bằng Trợ lý Firebase
Trợ lý Firebase đăng ký ứng dụng của bạn với một dự án Firebase, đồng thời thêm các tệp, trình bổ trợ và phần phụ thuộc cần thiết của Firebase vào dự án Android của bạn – tất cả đều có trong Android Studio!
Mở dự án Android của bạn trong Android Studio, sau đó đảm bảo rằng bạn đang sử dụng phiên bản Android Studio mới nhất và Trợ lý Firebase:
- Windows / Linux: Trợ giúp > Kiểm tra bản cập nhật
- macOS: Android Studio > Check for updates (Android Studio > Kiểm tra bản cập nhật)
Mở Trợ lý Firebase: Tools > Firebase (Công cụ > Firebase).
Trong ngăn Assistant (Trợ lý), hãy chọn một sản phẩm Firebase để thêm vào ứng dụng của bạn. Hãy mở rộng phần tương ứng, sau đó nhấp vào đường liên kết hướng dẫn (ví dụ:
Analytics > Ghi nhật ký sự kiện Analytics ).Nhấp vào Kết nối với Firebase để kết nối dự án Android của bạn với Firebase.
Nhấp vào nút này để thêm một sản phẩm Firebase mà bạn muốn (ví dụ:
Thêm Analytics vào ứng dụng của bạn ).
Đồng bộ hoá ứng dụng để đảm bảo rằng tất cả phần phụ thuộc đều có phiên bản cần thiết.
Trong ngăn Assistant (Trợ lý), hãy làm theo các hướng dẫn thiết lập còn lại cho sản phẩm Firebase đã chọn.
Thêm số lượng sản phẩm Firebase khác mà bạn muốn thông qua Trợ lý Firebase!
Tất cả chỉ có thế! Hãy nhớ xem các bước tiếp theo mà chúng tôi đề xuất.
Tuy nhiên, nếu bạn gặp sự cố khi thiết lập, hãy truy cập vào bài viết Câu hỏi thường gặp và khắc phục sự cố về Android.
Thư viện có sẵn
Phần này liệt kê các sản phẩm Firebase được hỗ trợ cho Android và các phần phụ thuộc Gradle của các sản phẩm đó. Tìm hiểu thêm về các thư viện Android sau của Firebase:
Tài liệu tham khảo (Kotlin+KTX | Java)
SDK Android của Firebase Kho lưu trữ GitHub
Xin lưu ý rằng khi sử dụng Firebase Android BoM, bạn không được chỉ định từng phiên bản thư viện khi khai báo các phần phụ thuộc của thư viện Firebase trong tệp cấu hình bản dựng Gradle.
Dịch vụ hoặc sản phẩm | Phần phụ thuộc Gradle | Phiên bản mới nhất |
Thêm Analytics? | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Firebase Android BoM (Bảng kê khai thành phần) |
com.google.firebase:firebase-bom
Phiên bản Firebase BoM mới nhất chứa các phiên bản mới nhất của từng thư viện Android trên Firebase. Để tìm hiểu những phiên bản thư viện được liên kết với một phiên bản BoM cụ thể, hãy xem ghi chú phát hành của phiên bản BoM đó. |
33,0,0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
AdMob | com.google.android.gms:play-services-ads | 23.1.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Số liệu phân tích | com.google.firebase:firebase-analytics | 22.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Nhà cung cấp tuỳ chỉnh cho tính năng Kiểm tra ứng dụng | com.google.firebase:firebase-appcheck | 18.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Trình cung cấp dịch vụ gỡ lỗi cho tính năng Kiểm tra ứng dụng | com.google.firebase:firebase-appcheck-debug | 18.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Nhà cung cấp dịch vụ Kiểm tra ứng dụng cho API Tính toàn vẹn của Play | com.google.firebase:firebase-appcheck-playintegrity | 18.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Phân phối ứng dụng | com.google.firebase:firebase-appdistribution | 16.0.0-beta12 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
App Distribution API (API Phân phối ứng dụng) | com.google.firebase:firebase-appdistribution-api | 16.0.0-beta12 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Trình bổ trợ Phân phối ứng dụng | com.google.firebase:firebase-appdistribution-gradle | 5.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Xác thực | com.google.firebase:firebase-auth | 23.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Cloud Firestore | com.google.firebase:firebase-firestore | 25.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Chức năng đám mây dành cho SDK ứng dụng Firebase | com.google.firebase:firebase-functions | 21.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Gửi thông báo qua đám mây | com.google.firebase:firebase-messaging | 24.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Bộ nhớ trên đám mây | com.google.firebase:firebase-storage | 21.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Crashlytics | com.google.firebase:firebase-crashlytics | 19,0,0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Crashlytics NDK NDK | com.google.firebase:firebase-crashlytics-ndk | 19,0,0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Trình bổ trợ Crashlytics | com.google.firebase:firebase-crashlytics-gradle | 3.0.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Hỗ trợ mô-đun tính năng linh hoạt | com.google.firebase:firebase-dynamic-module-support | 16.0.0-beta03 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Đường liên kết động | com.google.firebase:firebase-dynamic-links | 22.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Tính năng gửi thông báo trong ứng dụng | com.google.firebase:firebase-inappmessaging | 21.0.0 | (bắt buộc) |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Hiển thị tính năng gửi thông báo trong ứng dụng | com.google.firebase:firebase-inappmessaging-display | 21.0.0 | (bắt buộc) |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Cài đặt Firebase | com.google.firebase:firebase-installations | 18.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
API Trình tải mô hình học máy của Firebase | com.google.firebase:firebase-ml-modeldownloader | 25.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Giám sát hiệu suất | com.google.firebase:firebase-perf | 21.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Trình bổ trợ Giám sát hiệu suất | com.google.firebase:perf-plugin | 1.4.2 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Cơ sở dữ liệu theo thời gian thực | com.google.firebase:firebase-database | 21.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Cấu hình từ xa | com.google.firebase:firebase-config | 22.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Vertex AI cho Firebase | com.google.firebase:firebase-vertexai | 16.0.0-beta01 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Trình bổ trợ Dịch vụ Google Play | com.google.gms:google-services | 4.4.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
PHÂN TÍCH ĐÃ NGỪNG HOẠT ĐỘNG | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Nhà cung cấp dịch vụ Kiểm tra ứng dụng SafetyNet | com.google.firebase:firebase-appcheck-safetynet | 16.1.2 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Lập chỉ mục ứng dụng | com.google.firebase:firebase-apparg?hl=vi | 20.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Các mô-đun KTX Firebase
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Thư viện Bộ công cụ học máy Firebase
|
Các bước tiếp theo
Thêm các dịch vụ Firebase vào ứng dụng của bạn:
Thu thập thông tin chi tiết về hành vi của người dùng bằng Analytics.
Thiết lập quy trình xác thực người dùng bằng Xác thực.
Lưu trữ dữ liệu, chẳng hạn như thông tin người dùng, bằng Cloud Firestore hoặc Cơ sở dữ liệu theo thời gian thực.
Lưu trữ các tệp, chẳng hạn như ảnh và video, bằng Cloud Storage.
Kích hoạt mã phụ trợ chạy trong môi trường bảo mật bằng Cloud Functions.
Gửi thông báo bằng Giải pháp gửi thông báo qua đám mây.
Hãy tìm hiểu thời điểm và lý do ứng dụng của bạn gặp sự cố bằng Crashlytics.
Tìm hiểu về Firebase:
Hãy truy cập vào bài viết Tìm hiểu về dự án Firebase để tìm hiểu thêm về các dự án Firebase và các phương pháp hay nhất cho các dự án.
Hãy truy cập bài viết Tìm hiểu thêm về Android và Firebase nếu bạn có thắc mắc về các khái niệm chưa quen thuộc hoặc dành riêng cho Firebase và hoạt động phát triển Android.
Khám phá các ứng dụng Firebase mẫu.
Tham gia trải nghiệm thực tế với Lớp học lập trình Android Firebase.
Tìm hiểu thêm về khoá học Firebase trong một khoá học cuối tuần.
Chuẩn bị phát hành ứng dụng:
- Thiết lập cảnh báo về ngân sách cho dự án trong bảng điều khiển Google Cloud.
- Hãy theo dõi trang tổng quan Mức sử dụng và thanh toán trong bảng điều khiển của Firebase để nắm được thông tin tổng thể về mức sử dụng dự án của bạn trên nhiều dịch vụ của Firebase.
- Xem lại danh sách kiểm tra khởi chạy Firebase.
Bạn gặp sự cố với Firebase và dự án Android của mình? Hãy truy cập vào trang Câu hỏi thường gặp và khắc phục sự cố về Android.