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 (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 cấp độ API mục tiêu 24 (Nougat) trở lên
    • Sử dụng Android 7.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 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 vào Google Play services yêu cầu thiết bị hoặc trình mô phỏng phải cài đặt Google Play services.

Nếu chưa có dự án Android và chỉ muốn dùng thử một 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 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.
  • Cách 2: Sử dụng Trợ lý Firebase của Android Studio (có thể cần định cấu hình thêm).



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 bao gồm các nhiệm vụ 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 bài viết 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 Biệt hiệu ứng dụng, đây là giá trị nhận dạng nội bộ, thuận tiện và chỉ bạn mới thấy được trong bảng điều khiển Firebase.

  5. Nhấp vào Register app (Đă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 của ứng dụng (google-services.json) vào cơ sở mã:

    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 của mô-đun (cấp ứng dụng) trong ứng dụng của bạn.

  2. Để các giá trị trong tệp cấu hình google-services.json có thể truy cập được vào SDK Firebase, bạn cần có Trình bổ trợ Gradle của Dịch vụ 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ợ Gradle của dịch vụ Google dưới dạng 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.6.0" 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.6.0' 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ợ Gradle cho các 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

  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 sản phẩm 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:35.2.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 những 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:35.2.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 những phiên bản tương thích của thư viện Android trên Firebase.

  2. Sau khi thêm phần phụ thuộc cho các 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 đến phần sau để xem các bước tiếp theo nên làm.

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



Cách 2: Thêm Firebase bằng Trợ lý Firebase

Trợ lý Firebase sẽ đă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 Firebase cần thiết vào dự án Android ngay trong Android Studio!

  1. Mở dự án Android trong Android Studio, sau đó đảm bảo rằng bạn đang sử dụng phiên bản mới nhất của Android Studio và Trợ lý Firebase:

    • Windows/Linux: Help > Check for updates (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)
  2. Mở Trợ lý Firebase: Tools > Firebase (Công cụ > Firebase).

  3. 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. Mở rộng phần của sản phẩm đó, sau đó nhấp vào đường liên kết đến hướng dẫn (ví dụ: Analytics > Log an Analytics event (Ghi nhật ký 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 (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 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 mà bạn đã chọn.

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

Tất cả chỉ có thế! Hãy nhớ xem các bước tiếp theo nên làm.

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

Xin lưu ý rằng khi sử dụng Firebase Android BoM, bạn không 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
(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 mỗi thư viện Firebase Android. Để tìm hiểu xem những phiên bản thư viện nào đượ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 đó.

35.2.0
Trình bổ trợ Gradle cho các dịch vụ của Google com.google.gms:google-services 4.6.0
AdMob com.google.android.gms:play-services-ads 25.5.0
Firebase AI Logic 1 com.google.firebase:firebase-ai 18.2.0
Firebase AI Logic On-Device com.google.firebase:firebase-ai-ondevice 16.0.0-beta08
Firebase AI KSP com.google.firebase:firebase-ai-ksp-processor 17.0.0
Analytics com.google.firebase:firebase-analytics 24.0.0
App Check nhà cung cấp tuỳ chỉnh com.google.firebase:firebase-appcheck 20.1.0
App Check nhà cung cấp dịch vụ gỡ lỗi com.google.firebase:firebase-appcheck-debug 20.1.0
App Check Nhà cung cấp Play Integrity com.google.firebase:firebase-appcheck-playintegrity 20.1.0
Nhà cung cấp App Check reCAPTCHA com.google.firebase:firebase-appcheck-recaptcha 20.1.0
App Distribution com.google.firebase:firebase-appdistribution 16.0.0-beta21
App Distribution API com.google.firebase:firebase-appdistribution-api 16.0.0-beta21
Trình bổ trợ App Distribution com.google.firebase:firebase-appdistribution-gradle 5.3.1
Authentication com.google.firebase:firebase-auth 25.0.0
Cloud Firestore com.google.firebase:firebase-firestore 27.2.0
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions 23.0.0
Cloud Messaging com.google.firebase:firebase-messaging 26.0.2
Cloud Storage com.google.firebase:firebase-storage 23.0.0
Crashlytics com.google.firebase:firebase-crashlytics 21.1.0
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 21.1.0
Trình bổ trợ Crashlytics com.google.firebase:firebase-crashlytics-gradle 3.0.8
Hỗ trợ mô-đun tính năng linh hoạt com.google.firebase:firebase-dynamic-module-support 16.0.0-beta05
In-App Messaging com.google.firebase:firebase-inappmessaging 23.0.0
(bắt buộc)
In-App Messaging Mạng Hiển thị com.google.firebase:firebase-inappmessaging-display 23.0.0
(bắt buộc)
Firebase lượt cài đặt com.google.firebase:firebase-installations 20.0.0
Performance Monitoring com.google.firebase:firebase-perf 23.0.1
Trình bổ trợ Performance Monitoring com.google.firebase:perf-plugin 2.0.2
Firebase Phone Number Verification com.google.firebase:firebase-pnv 17.0.0
Realtime Database com.google.firebase:firebase-database 23.0.0
Remote Config com.google.firebase:firebase-config 24.0.1
SQL Connect 2 com.google.firebase:firebase-dataconnect 18.0.1
THƯ VIỆN KHÔNG ĐƯỢC HỖ TRỢ HOẶC KHÔNG CÒN ĐƯỢC SỬ DỤNG
Dynamic Links com.google.firebase:firebase-dynamic-links 22.1.0

Các mô-đun Firebase KTX – không còn được hỗ trợ

Analytics Không sử dụng; các thư viện mô-đun KTX không còn được hỗ trợ nữa.
com.google.firebase:firebase-analytics-ktx
22.5.0
App Check nhà cung cấp tuỳ chỉnh Không sử dụng; các thư viện mô-đun KTX không còn được hỗ trợ nữa.
com.google.firebase:firebase-appcheck-ktx
18.0.0
App Distribution API Không sử dụng; các thư viện mô-đun KTX không còn được hỗ trợ nữa.
com.google.firebase:firebase-appdistribution-api-ktx
16.0.0-beta15
Authentication Không sử dụng; các thư viện mô-đun KTX không còn được hỗ trợ nữa.
com.google.firebase:firebase-auth-ktx
23.2.1
Cloud Firestore Không sử dụng; các thư viện mô-đun KTX không còn được hỗ trợ nữa.
com.google.firebase:firebase-firestore-ktx
25.1.4
Cloud Functions for Firebase Client SDK Không sử dụng; các thư viện mô-đun KTX không còn được hỗ trợ nữa.
com.google.firebase:firebase-functions-ktx
21.2.1
Cloud Messaging Không sử dụng; các thư viện mô-đun KTX không còn được hỗ trợ nữa.
com.google.firebase:firebase-messaging-ktx
24.1.2
Cloud Storage Không sử dụng; các thư viện mô-đun KTX không còn được hỗ trợ nữa.
com.google.firebase:firebase-storage-ktx
21.0.2
Crashlytics Không sử dụng; các thư viện mô-đun KTX không còn được hỗ trợ.
com.google.firebase:firebase-crashlytics-ktx
19.4.4
Dynamic Links Không sử dụng; các thư viện mô-đun KTX không còn được hỗ trợ nữa.
com.google.firebase:firebase-dynamic-links-ktx
22.1.0
In-App Messaging Không sử dụng; các thư viện mô-đun KTX không còn được hỗ trợ nữa.
com.google.firebase:firebase-inappmessaging-ktx
21.0.2
(bắt buộc)
In-App Messaging Mạng Hiển thị Không sử dụng; các thư viện mô-đun KTX không còn được hỗ trợ.
com.google.firebase:firebase-inappmessaging-display-ktx
21.0.2
(bắt buộc)
Firebase lượt cài đặt Không sử dụng; các thư viện mô-đun KTX không còn được hỗ trợ nữa.
com.google.firebase:firebase-installations-ktx
18.0.0
Firebase ML API Trình tải mô hình xuống Không sử dụng; các thư viện mô-đun KTX không còn được hỗ trợ nữa.
com.google.firebase:firebase-ml-modeldownloader-ktx
25.0.1
Performance Monitoring Không sử dụng; các thư viện mô-đun KTX không còn được hỗ trợ nữa.
com.google.firebase:firebase-perf-ktx
21.0.5
Realtime Database Không sử dụng; thư viện mô-đun KTX không còn được hỗ trợ.
com.google.firebase:firebase-database-ktx
21.0.0
Remote Config Không sử dụng; các thư viện mô-đun KTX không còn được hỗ trợ nữa.
com.google.firebase:firebase-config-ktx
22.1.2

Thư viện Firebase ML và Firebase ML Kit

Firebase ML API mô hình tuỳ chỉnh com.google.firebase:firebase-ml-model-interpreter 22.0.4
Firebase ML API Trình tải mô hình xuống com.google.firebase:firebase-ml-modeldownloader 26.1.1
Firebase ML API thị giác 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 đối tượng và theo dõi 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: API ngôn ngữ tự nhiên 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 gọi là "Vertex AI in Firebase" với gói com.google.firebase:firebase-vertexai.

2 Firebase SQL Connect trước đây có tên là "Firebase Data Connect".



Các bước tiếp theo

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

  • Xây dựng các tính năng AI tạo sinh bằng các mô hình Gemini thông qua Firebase AI Logic.

  • Nhận 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 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ữ 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 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: