Trang này được dịch bởi Cloud Translation API.

Tìm hiểu về Firebase cho Android

Khi phát triển dự án Android bằng Firebase, bạn có thể khám phá những khái niệm mà bạn chưa biết hoặc chỉ có trong Firebase. Trang này nhằm mục đích trả lời những câu hỏi đó hoặc hướng dẫn bạn đến các tài nguyên để tìm hiểu thêm.

Nếu bạn có thắc mắc về một chủ đề không có trên trang này, vui lòng truy cập vào một trong các cộng đồng trực tuyến của chúng tôi. Chúng tôi cũng sẽ định kỳ cập nhật trang này bằng các chủ đề mới, vì vậy, hãy nhớ quay lại để xem chúng tôi có thêm chủ đề mà bạn muốn tìm hiểu hay không!

Trình bổ trợ Trợ lý Firebase cho Android Studio

Trợ lý Firebase là một trình bổ trợ Android Studio giúp đăng ký ứng dụng Android của bạn với một dự án Firebase và thêm các tệp cấu hình, trình bổ trợ và phần phụ thuộc Firebase cần thiết vào dự án Android của bạn ngay trong Android Studio!

Làm theo hướng dẫn trên trang Bắt đầu sử dụng Android để dùng Trợ lý Firebase. Đảm bảo rằng bạn đang sử dụng phiên bản mới nhất của cả Android Studio và Trợ lý Firebase (chuyển đến File > Check for updates (Tệp > Kiểm tra bản cập nhật)).

Khi bạn chọn các sản phẩm cụ thể của Firebase để thêm vào ứng dụng, Trợ lý Firebase sẽ tự động khai báo các phần phụ thuộc bắt buộc trong tệp app/build.gradle của bạn. Xin lưu ý rằng nếu bạn muốn sử dụng Firebase Android BoM (nên dùng), hãy cập nhật các phần phụ thuộc trong tệp Gradle (cấp ứng dụng) của mô-đun (thường là app/build.gradle) để nhập nền tảng BoM. Bạn cũng cần xoá các phiên bản khỏi từng dòng phần phụ thuộc của thư viện Firebase.

Ngoài ra, để sử dụng một số sản phẩm của Firebase, bạn phải bật API hoặc cung cấp tài nguyên bên ngoài Android Studio. Hướng dẫn cho từng sản phẩm trong Trợ lý Firebase mô tả mọi hành động bổ sung mà bạn cần thực hiện. Ví dụ: để sử dụng Cloud Firestore, bạn cần thiết lập cơ sở dữ liệu và quy tắc trong bảng điều khiển Firebase.

Dịch vụ của Google – tệp cấu hình và trình bổ trợ

Trong quá trình thêm Firebase vào dự án Android, bạn cần thêm trình bổ trợ google-services và tệp cấu hình google-services.json vào dự án.

Nếu thêm Firebase vào dự án Android thông qua bảng điều khiển Firebase, Management REST API hoặc Firebase CLI, bạn phải thêm trình bổ trợ và tệp cấu hình vào dự án theo cách thủ công. Tuy nhiên, nếu bạn sử dụng Trợ lý Firebase, thì các tác vụ này sẽ tự động được thực hiện cho bạn trong quá trình thiết lập.

Hãy truy cập vào tài liệu Android để tìm hiểu cách hoạt động của trình bổ trợ Dịch vụ Google và tệp cấu hình.

Firebase Android BoM (Bill of Materials)

Firebase Android BoM (Bill of Materials) cho phép bạn quản lý mọi phiên bản thư viện Firebase bằng cách chỉ định duy nhất một phiên bản – phiên bản của BoM.

Khi bạn sử dụng Firebase BoM trong ứng dụng, BoM sẽ tự động kéo các phiên bản thư viện riêng lẻ được liên kết với phiên bản của BoM. Tất cả các phiên bản thư viện riêng lẻ sẽ tương thích. Khi bạn cập nhật phiên bản BoM trong ứng dụng, tất cả các thư viện Firebase mà bạn sử dụng trong ứng dụng sẽ cập nhật lên các phiên bản được liên kết với phiên bản BoM đó.

Để tìm hiểu xem những phiên bản thư viện Firebase 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 đó. Nếu bạn cần so sánh các phiên bản thư viện được liên kết với một phiên bản BoM so với một phiên bản BoM khác, hãy sử dụng tiện ích so sánh bên dưới.

Tìm hiểu thêm về khả năng hỗ trợ của Gradle đối với các nền tảng BoM.

Sau đây là cách sử dụng Firebase Android BoM để khai báo các phần phụ thuộc trong tệp Gradle mô-đun (cấp ứng dụng) (thường là app/build.gradle). Khi sử dụng BoM, bạn không chỉ định từng phiên bản thư viện trong các dòng phần phụ thuộc.

dependencies {
  // Import the BoM for the Firebase platform
  implementation platform('com.google.firebase:firebase-bom:34.0.0')

  // Declare the dependencies for the desired Firebase products without specifying versions
  // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
  implementation 'com.google.firebase:firebase-auth'
  implementation 'com.google.firebase:firebase-firestore'
}

Sau đây là một số câu hỏi thường gặp về việc sử dụng Firebase Android BoM:

Làm cách nào để sử dụng một phiên bản thư viện khác với phiên bản được chỉ định trong BoM?

Dưới đây là cách ghi đè một phiên bản thư viện được chỉ định trong BoM:

Duy trì dòng này để nhập nền tảng BoM.

Trong dòng phần phụ thuộc của thư viện, hãy chỉ định phiên bản thư viện mong muốn. Ví dụ: dưới đây là cách khai báo các phần phụ thuộc nếu bạn muốn sử dụng App Indexing phiên bản 18.0.0, bất kể phiên bản nào được chỉ định trong BoM, nhưng bạn muốn sử dụng các phiên bản của BoM cho Authentication và Cloud Firestore:

dependencies {
  // Import the BoM for the Firebase platform
  implementation platform('com.google.firebase:firebase-bom:34.0.0')

  // Declare the dependency for the App Indexing library and specify a version
  // This specified library version overrides the version designated in the BoM.
  implementation 'com.google.firebase:firebase-appindexing:18.0.0'

  // Declare the dependencies for the other Firebase libraries without specifying versions
  // These libraries will use the versions designated in the BoM.
  implementation 'com.google.firebase:firebase-auth'
  implementation 'com.google.firebase:firebase-firestore'
}

BoM có tự động thêm tất cả các thư viện Firebase vào ứng dụng của tôi không?

Không. Để thực sự thêm và sử dụng các thư viện Firebase trong ứng dụng, bạn phải khai báo từng thư viện ở dạng một dòng phần phụ thuộc riêng trong tệp Gradle mô-đun (cấp ứng dụng) (thường là app/build.gradle).

Việc sử dụng BoM đảm bảo rằng các phiên bản của mọi thư viện Firebase trong ứng dụng của bạn đều tương thích, nhưng BoM không thực sự thêm những thư viện Firebase đó vào ứng dụng của bạn.

BoM có hỗ trợ các thư viện tiện ích Kotlin (KTX) của Firebase không?

Vào tháng 7 năm 2025 (BoM phiên bản 34.0.0), các thư viện tiện ích Firebase Kotlin (KTX) đã bị xoá khỏi BoM. Nếu sử dụng phiên bản BoM cũ hơn v34.0.0, thì bạn có thể tiếp tục sử dụng các thư viện KTX trong ứng dụng của mình.

Tuy nhiên, bạn nên di chuyển ứng dụng của mình để sử dụng các API KTX từ các mô-đun chính; nếu không, bạn sẽ không thể cập nhật lên các phiên bản BoM mới hơn và do đó là các phiên bản mới hơn của thư viện sản phẩm Firebase. Để biết thông tin chi tiết, hãy xem Câu hỏi thường gặp về sáng kiến này.

Tôi có thể sử dụng BoM để thêm các thư viện Android không có trong Firebase không?

Không. Firebase Android BoM chỉ quản lý các phiên bản thư viện cho thư viện Firebase.

Tại sao BoM là cách được đề xuất để quản lý các phiên bản thư viện Firebase?

Mặc dù mỗi thư viện Firebase đều được lập phiên bản độc lập, nhưng chúng được tạo cùng nhau để đảm bảo rằng bản phát hành mới nhất của mỗi thư viện đều tương thích với các thư viện khác.

Bằng cách sử dụng BoM để quản lý các phiên bản thư viện Firebase của ứng dụng, bạn không cần theo dõi phiên bản nào của một thư viện Firebase tương thích với một thư viện Firebase khác.

Ngay cả khi hiện tại bạn chỉ sử dụng một thư viện Firebase trong ứng dụng của mình, bạn vẫn nên sử dụng BoM vì bạn không bao giờ biết khi nào mình có thể muốn sử dụng một thư viện Firebase khác!

Ứng dụng của tôi sử dụng phiên bản Gradle cũ hơn 5.0 – tôi có thể tiếp tục sử dụng BoM không?

Có, bạn vẫn có thể sử dụng BoM! Đối với Gradle 5.0 trở lên, chế độ hỗ trợ BoM sẽ tự động bật. Tuy nhiên, đối với các phiên bản Gradle cũ hơn, bạn chỉ cần bật tính năng BoM và nhập BoM theo cách khác một chút.

Thêm enableFeaturePreview('IMPROVED_POM_SUPPORT') vào tệp settings.gradle.

Đối với tệp Gradle (ở cấp ứng dụng) trong mô-đun (thường là app/build.gradle), hãy nhập BoM như một thư viện thông thường (không có đối tượng sửa đổi platform), như sau:

dependencies {
  // Import the Firebase BoM
  implementation 'com.google.firebase:firebase-bom:34.0.0'

  // Declare the dependencies for the desired Firebase products, without specifying versions
  // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
  implementation 'com.google.firebase:firebase-auth'
  implementation 'com.google.firebase:firebase-firestore'
}

Làm cách nào để báo cáo vấn đề hoặc đưa ra ý kiến phản hồi về BoM?

Truy cập vào kho lưu trữ SDK Firebase cho Android trên GitHub.

So sánh các phiên bản Firebase BoM

Các mô-đun thư viện tiện ích Kotlin (KTX)

Các API tiện ích Kotlin (KTX) đã được thêm vào các mô-đun chính tương ứng. Ví dụ: tất cả API từ firebase-perf-ktx đã được thêm vào firebase-perf trong gói com.google.firebase.perf. Thay đổi này có nghĩa là giờ đây, nhà phát triển Kotlin nên phụ thuộc vào các mô-đun chính thay vì các mô-đun KTX (khi sử dụng Firebase BoM phiên bản 32.5.0 trở lên hoặc các phiên bản mô-đun chính có trong BoM phiên bản 32.5.0 trở lên).

Vào tháng 7 năm 2025, chúng tôi ngừng phát hành các phiên bản mới của mô-đun KTX và xoá các thư viện KTX khỏi Firebase Android BoM (phiên bản 34.0.0).

Nếu sử dụng API KTX từ các mô-đun KTX đã phát hành trước đó, bạn nên di chuyển ứng dụng để sử dụng API KTX từ các mô-đun chính thay thế. Để biết thông tin chi tiết, hãy xem Câu hỏi thường gặp về sáng kiến này.

Mô-đun tính năng và Play Feature Delivery

Kể từ tháng 5 năm 2021 (Firebase BoM phiên bản 28.0.0), bạn có thể sử dụng SDK Firebase cho Android trong các mô-đun tính năng động được cài đặt riêng biệt với mô-đun ứng dụng cơ sở.

Để bật tính năng hỗ trợ cho các mô-đun tính năng động, hãy thêm phần phụ thuộc sau vào tệp build.gradle của mô-đun cơ sở:

dependencies {
  implementation 'com.google.firebase:firebase-dynamic-module-support:16.0.0-beta04'
}

Giờ đây, sau khi thêm tính năng hỗ trợ mô-đun linh hoạt, bạn có thể thêm các phần phụ thuộc Firebase SDK (có hoặc không có Firebase BoM) vào các mô-đun tính năng của ứng dụng và sử dụng chúng như bình thường.

Ví dụ: nếu ứng dụng của bạn dùng Realtime Database để hỗ trợ một tính năng cụ thể theo thời gian thực, bạn có thể thêm phần phụ thuộc firebase-database vào build.gradle của mô-đun tính năng thay vì mô-đun cơ sở. Việc này sẽ giảm kích thước tải xuống cho hầu hết người dùng.

Hãy lưu ý những điểm hạn chế sau đây khi sử dụng SDK Firebase trong các mô-đun tính năng:

Các sản phẩm như Dynamic Links hoặc Firebase In-App Messaging dựa vào sự kiện Analytics first_open có thể bỏ lỡ sự kiện này khi được dùng trong một mô-đun tính năng động.
Khi sử dụng Cloud Firestore và Authentication cùng nhau, bạn phải luôn đưa cả hai vào cùng một mô-đun. Nếu không thể, hãy đảm bảo rằng Authentication được tải trước Cloud Firestore; nếu không, một số thao tác Cloud Firestore có thể có trạng thái xác thực không chính xác.
Khi dùng firebase-crashlytics-ndk làm phần phụ thuộc của một mô-đun tính năng động, bạn cần đặt thuộc tính unstrippedNativeLibsDir trong tệp build.gradle của ứng dụng, như mô tả trong tài liệu về NDK Crashlytics.

Để biết thêm thông tin về các mô-đun tính năng và Play Feature Delivery, hãy truy cập vào phần Tổng quan về Play Feature Delivery.

Trình bổ trợ Gradle của Dịch vụ Google so với Dịch vụ Google Play so với Cửa hàng Google Play

Một số thành phần trong hệ sinh thái của Google, Firebase và Android có quy ước đặt tên tương tự nhau. Sau đây là nội dung giải thích ngắn gọn cho từng loại:

Trình bổ trợ Gradle cho các dịch vụ của Google: Một trình bổ trợ Gradle (com.google.gms.google-services) chạy trong thời gian tạo bản dựng để đảm bảo ứng dụng của bạn có cấu hình phù hợp để truy cập vào Firebase và API của Google; Mặc dù có tên như vậy, trình bổ trợ này không liên quan đến Dịch vụ Google Play (xem mục tiếp theo) và không ảnh hưởng đến các chức năng của ứng dụng trong thời gian chạy.; Trình bổ trợ này cũng xử lý tệp google-services.json mà bạn thêm vào ứng dụng trong quá trình thiết lập Firebase. Tìm hiểu thêm về trình bổ trợ Gradle cho các dịch vụ của Google.
Dịch vụ Google Play: Một dịch vụ chạy ngầm không hiển thị trên thiết bị Android và cung cấp một số API phổ biến của Google (chẳng hạn như Google Maps và Google Sign In) cho các ứng dụng trên thiết bị; Bằng cách tập trung những API phổ biến này vào một dịch vụ duy nhất, dịch vụ này giúp giảm kích thước của các ứng dụng khác và cho phép thiết bị nhận các bản cập nhật bảo mật tự động cũng như các tính năng nâng cao mà không cần cập nhật hệ điều hành. Tìm hiểu thêm về Dịch vụ Google Play.
Cửa hàng Google Play: Một cửa hàng để tải ứng dụng, phim, sách và nhiều nội dung khác xuống thiết bị Android; Là nhà phát triển, bạn quản lý việc phân phối, phát hành, v.v. cho ứng dụng của mình thông qua Google Play Console. Nếu có Cửa hàng Google Play, thì thiết bị cũng đang chạy Dịch vụ Google Play (xem mục trước). Tìm hiểu thêm về Cửa hàng Google Play dành cho nhà phát triển.
Google Play Games services: Một bộ API dành cho nhà phát triển trò chơi di động; Tìm hiểu thêm về Dịch vụ trò chơi của Google Play và cách tích hợp Firebase với dự án Dịch vụ trò chơi của Google Play.

Tài nguyên nguồn mở cho Firebase SDK cho Android

Firebase hỗ trợ hoạt động phát triển nguồn mở, đồng thời khuyến khích cộng đồng đóng góp và phản hồi.

Firebase SDK cho Android

Hầu hết các SDK Firebase cho Android đều được phát triển dưới dạng thư viện nguồn mở trong kho lưu trữ Firebase GitHub công khai của chúng tôi. Chúng tôi đang nỗ lực để sớm chuyển các thư viện Firebase còn lại được phát triển riêng tư sang GitHub công khai!

Mẫu bắt đầu nhanh

Firebase duy trì một bộ sưu tập các mẫu khởi động nhanh cho hầu hết các API Firebase trên Android. Bạn có thể tìm thấy những hướng dẫn bắt đầu nhanh này trong kho lưu trữ hướng dẫn bắt đầu nhanh công khai của Firebase trên GitHub.

Bạn có thể mở từng hướng dẫn nhanh dưới dạng một dự án Android Studio, sau đó chạy dự án đó trên thiết bị di động hoặc thiết bị ảo (AVD). Hoặc bạn có thể sử dụng các hướng dẫn nhanh này làm mã ví dụ để sử dụng Firebase SDK.