Thêm Firebase vào dự án Android

Đ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 rằng dự án của bạn đáp ứng các yêu cầu này (xin lưu ý rằng một số sản phẩm có thể có yêu cầu nghiêm ngặt hơn):

    • Nhắm đến API cấp 21 (Lollipop) trở lên
    • Sử dụng Android 5.0 trở lên
    • Sử dụng Jetpack (AndroidX), bao gồm cả việc đáp ứng các yêu cầu về phiên bản sau:
      • com.android.tools.build:gradle phiên bản 7.3.0 trở lên
      • compileSdkVersion 28 trở lên

  • Thiết lập một thiết bị thực hoặc sử dụng trình mô phỏng để chạy ứng dụng của bạn.
    Xin lưu ý rằng các SDK Firebase có một phần phụ thuộc vào 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ử một sản phẩm của Firebase, bạn có thể tải một trong các mẫu khởi động nhanh của chúng tôi xuống.


Bạn có thể kết nối ứng dụng Android của mình với Firebase bằng một trong các lựa chọn sau:

  • Cách 1: (nên dùng) Sử dụng quy trình thiết lập bảng điều khiển Firebase.
  • Lựa chọn 2: Sử dụng Trợ lý Firebase của Android Studio (có thể cần thêm cấu hình).


Cách 1: Thêm Firebase bằng bảng điều khiển Firebase

Việc thêm Firebase vào ứng dụng của bạn bao gồm các thao tác trong cả bảng điều khiển Firebase và trong dự án Android đang mở (ví dụ: bạn tải 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 trang Tìm hiểu về 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.

  1. Chuyển đến bảng điều khiển Firebase.

  2. Ở giữa trang tổng quan của dự án, hãy nhấp vào biểu tượng Android () hoặc Thêm ứng dụng để chạy quy trình thiết lập.

  3. Nhập tên gói của ứng dụng vào trường Tên gói Android.

  4. (Không bắt buộc) Nhập thông tin khác về ứng dụng: Biệt hiệu của ứng dụng và SHA-1 của chứng chỉ ký gỡ lỗi.

  5. Nhấp vào Đăng ký ứng dụng.

Bước 3: Thêm tệp cấu hình Firebase

  1. Tải xuống rồi thêm tệp cấu hình Firebase (google-services.json) của ứng dụng vào cơ sở mã của bạn:

    1. Nhấp vào Tải google-services.json xuống để lấy tệp cấu hình Firebase của ứng dụng.

    2. 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.

  2. Để các SDK Firebase có thể truy cập vào các giá trị trong tệp cấu hình google-services.json, bạn cần có trình bổ trợ Gradle cho các dịch vụ của Google (google-services).

    1. 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ợ dịch vụ 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.3" 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.3' apply false
}

    2. 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 SDK Firebase vào ứng dụng

  1. Trong tệp Gradle của 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. 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:34.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 trên Firebase.

    Chưa bật Analytics 

    dependencies {
  // ...

  // Import the Firebase BoM
  implementation(platform("com.google.firebase:firebase-bom:34.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 trên Firebase.

  2. Sau khi thêm các phần phụ thuộc cho những sản phẩm bạn muốn sử dụng, hãy đồng bộ hoá dự án Android của bạn với các tệp Gradle.

Tất cả chỉ có thế! Bạn có thể chuyển sang phần các bước tiếp theo được đề xuất.

Tuy nhiên, nếu bạn gặp vấn đề khi thiết lập, hãy truy cập vào Câu hỏi thường gặp và cách khắc phục sự cố trên Android.


Lựa chọn 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 và thêm các tệp, trình bổ trợ và phần phụ thuộc Firebase cần thiết vào dự án Android ngay trong Android Studio!

  1. Mở dự án Android của bạn trong Android Studio, sau đó đảm bảo rằng bạn đang dùng phiên bản mới nhất của Android Studio 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 để tìm bản cập nhật)

  2. Mở Trợ lý Firebase: Tools > Firebase (Công cụ > Firebase).

  3. Trong ngăn Trợ lý, hãy chọn một sản phẩm của Firebase để thêm vào ứng dụng. Mở rộng phần của sản phẩm đó, rồi nhấp vào đường liên kết đến hướng dẫn (ví dụ: Analytics > Ghi lại một sự kiện Analytics).

    1. Nhấp vào Connect to Firebase (Kết nối với Firebase) để kết nối dự án Android của bạn với Firebase.

    2. Nhấp vào nút để thêm một sản phẩm Firebase mong muốn (ví dụ: Thêm Analytics vào ứng dụng của bạn).

  4. Đồng bộ hoá ứng dụng để đảm bảo rằng tất cả phần phụ thuộc đều có các phiên bản cần thiết.

  5. Trong ngăn Trợ lý, hãy làm theo các hướng dẫn còn lại về cách thiết lập cho sản phẩm Firebase mà bạn đã chọn.

  6. Thêm bao nhiêu sản phẩm khác của Firebase tuỳ thích thông qua Trợ lý Firebase!

Tất cả chỉ có thế! Nhớ xem các bước tiếp theo được đề xuất.

Tuy nhiên, nếu bạn gặp vấn đề khi thiết lập, hãy truy cập vào Câu hỏi thường gặp và cách khắc phục sự cố trên 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 sản phẩm. Tìm hiểu thêm về các thư viện Firebase Android sau:

  • Tài liệu tham khảo (Kotlin | Java)

  • Kho lưu trữ GitHub của SDK Firebase cho Android

Xin lưu ý rằng khi sử dụng Firebase Android BoM, bạn không chỉ định các phiên bản thư viện riêng lẻ khi khai báo 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
(Bill of Materials)		 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 Firebase Android. Để tìm hiểu xem những phiên bản thư viện nào được ánh xạ đến một phiên bản BoM cụ thể, hãy xem ghi chú phát hành cho phiên bản BoM đó.

 34.0.0
AdMob com.google.android.gms:play-services-ads 24.4.0
Firebase AI Logic 1 com.google.firebase:firebase-ai 17.0.0
Analytics com.google.firebase:firebase-analytics 23.0.0
App Check nhà cung cấp tuỳ chỉnh com.google.firebase:firebase-appcheck 19.0.0
App Check nhà cung cấp gỡ lỗi com.google.firebase:firebase-appcheck-debug 19.0.0
App Check Nhà cung cấp Tính toàn vẹn của Play com.google.firebase:firebase-appcheck-playintegrity 19.0.0
App Distribution com.google.firebase:firebase-appdistribution 16.0.0-beta16
App Distribution API com.google.firebase:firebase-appdistribution-api 16.0.0-beta16
App Distribution plugin com.google.firebase:firebase-appdistribution-gradle 5.1.1
Authentication com.google.firebase:firebase-auth 24.0.0
Cloud Firestore com.google.firebase:firebase-firestore 26.0.0
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions 22.0.0
Cloud Messaging com.google.firebase:firebase-messaging 25.0.0
Cloud Storage com.google.firebase:firebase-storage 22.0.0
Crashlytics com.google.firebase:firebase-crashlytics 20.0.0
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 20.0.0
Crashlytics plugin com.google.firebase:firebase-crashlytics-gradle 3.0.5
Data Connect com.google.firebase:firebase-dataconnect 17.0.0
Hỗ trợ mô-đun tính năng linh hoạt com.google.firebase:firebase-dynamic-module-support 16.0.0-beta04
Dynamic Links com.google.firebase:firebase-dynamic-links 22.1.0
In-App Messaging com.google.firebase:firebase-inappmessaging 22.0.0
(bắt buộc)
In-App Messaging Mạng Hiển thị com.google.firebase:firebase-inappmessaging-display 22.0.0
(bắt buộc)
Firebase lượt cài đặt com.google.firebase:firebase-installations 19.0.0
Firebase ML Model Downloader API com.google.firebase:firebase-ml-modeldownloader 26.0.0
Performance Monitoring com.google.firebase:firebase-perf 22.0.0
Performance Monitoring plugin com.google.firebase:perf-plugin 2.0.0
Realtime Database com.google.firebase:firebase-database 22.0.0
Remote Config com.google.firebase:firebase-config 23.0.0
Trình bổ trợ Dịch vụ Google Play com.google.gms:google-services 4.4.3
THƯ VIỆN KHÔNG CÒN ĐƯỢC DÙNG NỮA
App Check Nhà cung cấp SafetyNet com.google.firebase:firebase-appcheck-safetynet 16.1.2
App Indexing com.google.firebase:firebase-appindexing 20.0.0

Các mô-đun Firebase KTX

Analytics com.google.firebase:firebase-analytics-ktx 22.5.0
App Check nhà cung cấp tuỳ chỉnh com.google.firebase:firebase-appcheck-ktx 18.0.0
App Distribution API com.google.firebase:firebase-appdistribution-api-ktx 16.0.0-beta15
Authentication com.google.firebase:firebase-auth-ktx 23.2.1
Cloud Firestore com.google.firebase:firebase-firestore-ktx 25.1.4
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions-ktx 21.2.1
Cloud Messaging com.google.firebase:firebase-messaging-ktx 24.1.2
Cloud Storage com.google.firebase:firebase-storage-ktx 21.0.2
Crashlytics com.google.firebase:firebase-crashlytics-ktx 19.4.4
Dynamic Links com.google.firebase:firebase-dynamic-links-ktx 22.1.0
In-App Messaging com.google.firebase:firebase-inappmessaging-ktx 21.0.2
(bắt buộc)
In-App Messaging Mạng Hiển thị com.google.firebase:firebase-inappmessaging-display-ktx 21.0.2
(bắt buộc)
Firebase lượt cài đặt com.google.firebase:firebase-installations-ktx 18.0.0
Firebase ML Model Downloader API com.google.firebase:firebase-ml-modeldownloader-ktx 25.0.1
Performance Monitoring com.google.firebase:firebase-perf-ktx 21.0.5
Realtime Database com.google.firebase:firebase-database-ktx 21.0.0
Remote Config com.google.firebase:firebase-config-ktx 22.1.2

Thư viện Bộ công cụ học máy của Firebase

Firebase ML Custom Model APIs com.google.firebase:firebase-ml-model-interpreter 22.0.4
Firebase ML Vision API com.google.firebase:firebase-ml-vision 24.1.0
Firebase ML: Mô hình gắn nhãn hình ảnh com.google.firebase:firebase-ml-vision-image-label-model 20.0.2
Firebase ML: Mô hình phát hiện và theo dõi đối tượng com.google.firebase:firebase-ml-vision-object-detection-model 19.0.6
Firebase ML: Mô hình phát hiện khuôn mặt com.google.firebase:firebase-ml-vision-face-model 20.0.2
Firebase ML: Mô hình quét mã vạch 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: Natural Language API com.google.firebase:firebase-ml-natural-language 22.0.1
Firebase ML: Mô hình nhận dạng ngôn ngữ com.google.firebase:firebase-ml-natural-language-language-id-model 20.0.8
Firebase ML: Mô hình dịch com.google.firebase:firebase-ml-natural-language-translate-model 20.0.9
Firebase ML: Mô hình Trả lời thông minh com.google.firebase:firebase-ml-natural-language-smart-reply-model 20.0.8

1 Firebase AI Logic trước đây có tên là "Vertex AI in Firebase" với gói com.google.firebase:firebase-vertexai.


Các bước tiếp theo

Thêm các dịch vụ của Firebase vào ứng dụng:

  • Tạo các tính năng AI tạo sinh bằng các mô hình Gemini và Imagen bằng cách sử dụng Firebase AI Logic.

  • 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 một quy trình xác thực người dùng bằng Authentication.

  • Lưu trữ dữ liệu, chẳng hạn như thông tin người dùng, bằng Cloud Firestore hoặc Realtime Database.

  • Lưu trữ các tệp như ảnh và video bằng Cloud Storage.

  • Kích hoạt mã phụ trợ chạy trong một môi trường an toàn bằng Cloud Functions.

  • Gửi thông báo bằng biểu tượng Cloud Messaging.

  • 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: