Google is committed to advancing racial equity for Black communities. See how.
Trang này được dịch bởi Cloud Translation API.
Switch to English

Thêm Firebase vào dự án Android của bạn

Đ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 sau:

    • API mục tiêu cấp 16 (Jelly Bean) trở lên
    • Sử dụng Gradle 4.1 trở lên
    • Sử dụng Jetpack (AndroidX) , bao gồm việc đáp ứng các yêu cầu phiên bản sau:
      • com.android.tools.build:gradle v3.2.1 trở lên
      • compileSdkVersion 28 trở lên
  • Thiết lập thiết bị vật lý hoặc sử dụng trình giả lập để chạy ứng dụng của bạn.
    Trình giả lập phải sử dụng hình ảnh giả lập với Google Play.

  • Đăng nhập vào Firebase bằng tài khoản Google của bạn.

Nếu bạn chưa có dự án Android và chỉ muốn dùng thử sản phẩm Firebase, bạn có thể tải xuống một trong các mẫu bắt đầu nhanh của chúng tôi.


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 tùy chọn sau:

  • Tùy chọn 1 : (được khuyến nghị) Sử dụng quy trình thiết lập bảng điều khiển Firebase.
  • Tùy chọn 2 : Sử dụng Android Studio Firebase Assistant (yêu cầu cấu hình bổ sung).

Tùy chọn 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 liên quan đến các tác vụ cả trong bảng điều khiển Firebase và trong dự án Android đang mở của bạn (ví dụ: bạn tải xuống tệp cấu hình Firebase từ bảng điều khiển, sau đó chuyển chúng vào dự án Android của bạn).

Bước 1 : Tạo dự án Firebase

Trước khi có thể thêm Firebase vào ứng dụng Android của mình, bạn cần tạo dự án Firebase để kết nối với ứng dụng Android của mình. Truy cập 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

Sau khi có dự án Firebase, bạn có thể thêm ứng dụng Android của mình vào đó.

Truy cập Tìm hiểu các dự án Firebase để tìm hiểu thêm về các phương pháp hay nhất và cân nhắc khi thêm ứng dụng vào dự án Firebase, bao gồm cả cách xử lý nhiều biến thể bản dựng.

  1. Đi tới bảng điều khiển Firebase .

  2. Ở giữa trang tổng quan về dự án, nhấp vào biểu tượng Android ( ) để khởi chạy quy trình thiết lập.

    Nếu bạn đã thêm một ứng dụng vào dự án Firebase của mình, hãy nhấp vào Thêm ứng dụng để hiển thị các tùy chọn nền tảng.

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

  4. (Tùy chọn) Nhập thông tin ứng dụng khác: Biệt hiệu ứng dụngGỡ lỗi ký chứng chỉ SHA-1 .

  5. Bấm Đăng ký ứng dụng .

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

  1. Thêm tệp cấu hình Firebase Android vào ứng dụng của bạn:

    1. Nhấp vào Tải xuống google-services.json để tải tệp cấu hình Firebase Android của bạn ( google-services.json ).

    2. Di chuyển tệp cấu hình của bạn vào thư mục mô-đun (cấp ứng dụng) của ứng dụng.

  2. Để bật các sản phẩm Firebase trong ứng dụng của bạn, hãy thêm plugin google-services vào tệp Gradle của bạn.

    1. Trong tệp Gradle cấp gốc (cấp dự án) của bạn ( build.gradle ), hãy thêm các quy tắc để bao gồm plugin Gradle Dịch vụ của Google. Kiểm tra xem bạn cũng có kho lưu trữ Maven của Google.

      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.3'  // Google Services plugin
        }
      }
      
      allprojects {
        // ...
      
        repositories {
          // Check that you have the following line (if not, add it):
          google()  // Google's Maven repository
          // ...
        }
      }
      
    2. Trong tệp Gradle mô-đun (cấp ứng dụng) của bạn (thường là app/build.gradle ), hãy áp dụng plugin Gradle Dịch vụ của Google:

      apply plugin: 'com.android.application'
      // Add the following line:
      apply plugin: 'com.google.gms.google-services'  // Google Services plugin
      
      android {
        // ...
      }
      

Bước 4 : Thêm SDK Firebase vào ứng dụng của bạn

  1. Đối với tệp Gradle mô-đun (cấp ứng dụng) của bạn (thường là app/build.gradle ), hãy thêm các phần phụ thuộc cho các sản phẩm Firebase mà bạn muốn sử dụng trong ứng dụng của mình.

    Đã bật phân tích

    Java

    dependencies {
      // ...
    
      // Add the dependency for the Firebase SDK for Google Analytics
      implementation 'com.google.firebase:firebase-analytics:17.5.0'
    
      // Add the dependencies for any other desired Firebase products
      // For example, to use Firebase Authentication and Cloud Firestore
      implementation 'com.google.firebase:firebase-auth:19.4.0'
      implementation 'com.google.firebase:firebase-firestore:21.6.0'
    }
    
    // Getting a "Could not find" error? Make sure that you've added
    // Google's Maven repository to your project-level build.gradle file
    

    Kotlin + KTX

    dependencies {
      // ...
    
      // Add the dependency for the Firebase SDK for Google Analytics
      implementation 'com.google.firebase:firebase-analytics-ktx:17.5.0'
    
      // Add the dependencies for any other desired Firebase products
      // For example, to use Firebase Authentication and Cloud Firestore
      implementation 'com.google.firebase:firebase-auth-ktx:19.4.0'
      implementation 'com.google.firebase:firebase-firestore-ktx:21.6.0'
    }
    
    // Getting a "Could not find" error? Make sure that you've added
    // Google's Maven repository to your project-level build.gradle file
    

    Analytics không được bật

    Java

    dependencies {
      // ...
    
      // Add the dependencies for the desired Firebase products
      // For example, to use Firebase Authentication and Cloud Firestore
      implementation 'com.google.firebase:firebase-auth:19.4.0'
      implementation 'com.google.firebase:firebase-firestore:21.6.0'
    }
    
    // Getting a "Could not find" error? Make sure that you've added
    // Google's Maven repository to your project-level build.gradle file
    

    Kotlin + KTX

    dependencies {
      // ...
    
      // Add the dependencies for the desired Firebase products
      // For example, to use Firebase Authentication and Cloud Firestore
      implementation 'com.google.firebase:firebase-auth-ktx:19.4.0'
      implementation 'com.google.firebase:firebase-firestore-ktx:21.6.0'
    }
    
    // Getting a "Could not find" error? Make sure that you've added
    // Google's Maven repository to your project-level build.gradle file
    
  2. Đồng bộ hóa ứng dụng của bạn để đảm bảo rằng tất cả các phụ thuộc đều có phiên bản cần thiết.

Đó là nó! Bạn có thể chuyển sang các bước tiếp theo .

Tùy chọn 2 : Thêm Firebase bằng Hỗ trợ 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 và mã Firebase cần thiết vào dự án Android của bạn - tất cả đều từ bên trong Android Studio.

Lưu ý rằng tùy chọn được đề xuất để kết nối ứng dụng của bạn với Firebase là sử dụng quy trình thiết lập bảng điều khiển Firebase .

  1. Mở dự án Android của bạn trong Android Studio.

  2. Chọn Công cụ> Firebase để mở ngăn Trợ lý .

  3. 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 nó, sau đó nhấp vào liên kết hướng dẫn (ví dụ: Analytics > Ghi nhật ký sự kiện Analytics ).

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

  5. Trong ngăn Hỗ trợ Firebase, hãy nhấp vào nút để thêm phần phụ thuộc vào thư viện cho sản phẩm Firebase đã chọn của bạn (ví dụ: Thêm Analytics vào ứng dụng của bạn ).

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

  7. Nếu bạn đã thêm Analytics, hãy chạy ứng dụng của bạn để gửi xác minh tới Firebase rằng bạn đã tích hợp thành công Firebase. Nếu không, bạn có thể bỏ qua bước xác minh này.

    Nhật ký thiết bị của bạn sẽ hiển thị xác minh Firebase rằng quá trình khởi chạy đã hoàn tất. Nếu bạn đã chạy ứng dụng của mình trên trình giả lập có quyền truy cập mạng, bảng điều khiển Firebase sẽ thông báo cho bạn rằng kết nối ứng dụng của bạn đã hoàn tất.

  8. Trong ngăn Hỗ trợ Firebase, 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 của bạn.

  9. Thêm nhiều sản phẩm Firebase khác tùy thích thông qua Trợ lý Firebase!

Đó là nó! Đảm bảo kiểm tra các bước tiếp theo được đề xuất.

Kiểm soát việc lập phiên bản thư viện bằng Hóa đơn nguyên vật liệu (BoM) của Firebase

Để quản lý phiên bản thư viện dễ dàng hơn, hãy cân nhắc nhập Hóa đơn nguyên vật liệu (BoM) của Firebase.

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ụ thuộc Gradle của chúng. Tìm hiểu thêm về các thư viện Android Firebase này:

Java

Dịch vụ hoặc Sản phẩm Gradle phụ thuộc Thêm phân tích?
AdMob com.google.android.gms: play-services-ads: 19.4.0
phân tích com.google.firebase: firebase-analytics: 17.5.0
Lập chỉ mục ứng dụng com.google.firebase: firebase-appindexing: 19.1.0
Xác thực com.google.firebase: firebase-auth: 19.4.0
Cloud Firestore com.google.firebase: firebase-firestore: 21.6.0
Chức năng đám mây cho SDK ứng dụng Firebase com.google.firebase: firebase-functions: 19.1.0
Nhắn tin qua đám mây com.google.firebase: firebase-message: 20.2.4
Lưu trữ đám mây com.google.firebase: firebase-storage: 19.2.0
Crashlytics com.google.firebase: firebase-crashlytics: 17.2.1
Liên kết động com.google.firebase: firebase-dynamic-links: 19.1.0
API tầm nhìn ML của Firebase com.google.firebase: firebase-ml-vision: 24.1.0
API mô hình tùy chỉnh Firebase ML com.google.firebase: firebase-ml-model -preter: 22.0.4
Nhắn tin trong ứng dụng com.google.firebase: firebase-inappmessaging: 19.1.1
(cần thiết)
Màn hình nhắn tin trong ứng dụng com.google.firebase: firebase-inappmessaging-display: 19.1.1
(cần thiết)
Giám sát hiệu suất com.google.firebase: firebase-perf: 19.0.8
Cơ sở dữ liệu thời gian thực com.google.firebase: firebase-database: 19.4.0
Cấu hình từ xa com.google.firebase: firebase-config: 19.2.0
Hóa đơn nguyên vật liệu của Firebase (BoM) com.google.firebase: firebase-bom: 25.10.0

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 có sẵn tại bản phát hành của BoM. Đối với các phiên bản thư viện được ánh xạ tới các phiên bản BoM trước đó, hãy xem lại ghi chú phát hành cho phiên bản đó.

Plugin dịch vụ của Google Play com.google.gms: google-services: 4.3.3
Thư viện không được dùng nữa
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 theo dõi và phát hiện đối tượng com.google.firebase: firebase-ml-vision-object-Discovery-model: 19.0.6
Firebase ML: Mô hình nhận diệ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: API AutoML Vision Edge 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: Dịch mô hình 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

Kotlin + KTX

Dịch vụ hoặc Sản phẩm Gradle phụ thuộc Thêm phân tích?
AdMob com.google.android.gms: play-services-ads: 19.4.0
phân tích com.google.firebase: firebase-analytics-ktx: 17.5.0
Lập chỉ mục ứng dụng com.google.firebase: firebase-appindexing: 19.1.0
Xác thực com.google.firebase: firebase-auth-ktx: 19.4.0
Cloud Firestore com.google.firebase: firebase-firestore-ktx: 21.6.0
Chức năng đám mây cho SDK ứng dụng Firebase com.google.firebase: firebase-functions-ktx: 19.1.0
Nhắn tin qua đám mây com.google.firebase: firebase-message: 20.2.4
Lưu trữ đám mây com.google.firebase: firebase-storage-ktx: 19.2.0
Crashlytics com.google.firebase: firebase-crashlytics-ktx: 17.2.1
Liên kết động com.google.firebase: firebase-dynamic-links-ktx: 19.1.0
API tầm nhìn ML của Firebase com.google.firebase: firebase-ml-vision: 24.1.0
API mô hình tùy chỉnh Firebase ML com.google.firebase: firebase-ml-model -preter: 22.0.4
Nhắn tin trong ứng dụng com.google.firebase: firebase-inappmessaging-ktx: 19.1.1
(cần thiết)
Màn hình nhắn tin trong ứng dụng com.google.firebase: firebase-inappmessaging-display-ktx: 19.1.1
(cần thiết)
Giám sát hiệu suất com.google.firebase: firebase-perf: 19.0.8
Cơ sở dữ liệu thời gian thực com.google.firebase: firebase-database-ktx: 19.4.0
Cấu hình từ xa com.google.firebase: firebase-config-ktx: 19.2.0
Hóa đơn nguyên vật liệu của Firebase (BoM) com.google.firebase: firebase-bom: 25.10.0

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 có sẵn tại bản phát hành của BoM. Đối với các phiên bản thư viện được ánh xạ tới các phiên bản BoM trước đó, hãy xem lại ghi chú phát hành cho phiên bản đó.

Plugin dịch vụ của Google Play com.google.gms: google-services: 4.3.3
Thư viện không được dùng nữa
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 theo dõi và phát hiện đối tượng com.google.firebase: firebase-ml-vision-object-Discovery-model: 19.0.6
Firebase ML: Mô hình nhận diệ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: API AutoML Vision Edge 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: Dịch mô hình 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

Bước tiếp theo

Tìm hiểu về Firebase:

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