Catch up on highlights from Firebase at Google I/O 2023. Learn more

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:

    • Nhắm mục tiêu API cấp 19 (KitKat) trở lên
    • Sử dụng Android 4.4 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ị thực hoặc sử dụng trình mô phỏng để chạy ứng dụng của bạn.
    Lưu ý rằng SDK Firebase phụ thuộc vào các dịch vụ của Google Play yêu cầu thiết bị hoặc trình giả lập phải cài đặt các dịch vụ của 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 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 đề xuất) 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 (có thể 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 các tệp cấu hình Firebase từ bảng điều khiển, sau đó di 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

Để sử dụng Firebase trong ứng dụng Android, bạn cần đăng ký ứng dụng với dự án Firebase. Đăng ký ứng dụng của bạn thường được gọi là "thêm" ứng dụng vào dự án của bạn.

  1. Chuyển đến 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 ( ) hoặc Thêm ứng dụng để khởi chạy quy trình thiết lập.

  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ụngChứng chỉ ký gỡ lỗi SHA-1 .

  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 Android ( google-services.json ) vào ứng dụng của bạn:

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

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

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

    1. Trong tệp Gradle cấp gốc (cấp dự án) ( <project>/build.gradle ), hãy thêm plugin dịch vụ của Google dưới dạng phụ thuộc bản dựng:

      buildscript {
      
          repositories {
            // Make sure that you have the following two repositories
            google()  // Google's Maven repository
            mavenCentral()  // Maven Central repository
          }
      
          dependencies {
            ...
      
            // Add the dependency for the Google services Gradle plugin
            classpath 'com.google.gms:google-services:4.3.15'
          }
      }
      
      allprojects {
        ...
      
        repositories {
          // Make sure that you have the following two repositories
          google()  // Google's Maven repository
          mavenCentral()  // Maven Central repository
        }
      }
      
    2. Trong tệp Gradle mô-đun (cấp ứng dụng) của bạn (thường là <project>/<app-module>/build.gradle ), hãy thêm plugin dịch vụ của Google:

      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 của bạn

  1. Trong tệp Gradle mô-đun (cấp ứng dụng) của bạn (thường là <project>/<app-module>/build.gradle ), hãy thêm 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. Chúng tôi khuyên bạn nên sử dụng Firebase Android BoM để kiểm soát việc lập phiên bản thư viện.

    Đã bật phân tích

    Kotlin+KTX

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:32.1.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-ktx'
    
      // 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-ktx'
      implementation 'com.google.firebase:firebase-firestore-ktx'
    }
    

    Java

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:32.1.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.

    Phân tích không được bật

    Kotlin+KTX

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:32.1.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-ktx'
      implementation 'com.google.firebase:firebase-firestore-ktx'
    }
    

    Java

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:32.1.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.

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

Đó là nó! 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 Câu hỏi thường gặp & khắc phục sự cố Android .



Tùy chọn 2 : Thêm Firebase bằng Firebase Assistant

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, plugin và phần phụ thuộc Firebase cần thiết vào dự án Android của bạn — tất cả đều từ trong Android Studio!

  1. 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 mới nhất của Android Studio và Trợ lý Firebase:

    • Windows / Linux: Trợ giúp > Kiểm tra các bản cập nhật
    • macOS: Android Studio > Kiểm tra các bản cập nhật
  2. Mở Trợ lý Firebase: Công cụ > Firebase .

  3. Trong ngăn 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 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 ).

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

    2. Nhấp vào nút để thêm 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ộ hóa ứng dụng của bạn để đảm bảo rằng tất cả các phần phụ thuộc đều 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 thiết lập còn lại cho sản phẩm Firebase đã chọn của bạn.

  6. Thêm bao 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.

Tuy nhiên, nếu bạn gặp sự cố khi thiết lập, hãy truy cập Câu hỏi thường gặp & khắc phục sự cố 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 thành phần phụ thuộc Gradle của chúng. Tìm hiểu thêm về các thư viện Firebase Android này:

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 các phụ thuộc thư viện Firebase trong build.gradle .

Kotlin+KTX

Dịch vụ hoặc Sản phẩm Phụ thuộc lớp Muộn nhất
phiên bản
Thêm phân tích?
Firebase Android BoM
(Hóa đơn nguyên vật liệu)
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 phiên bản thư viện nào được ánh xạ tới một phiên bản BoM cụ thể, hãy xem lại ghi chú phát hành cho phiên bản BoM đó.

32.1.0
AdMob com.google.android.gms:play-services-ads 22.1.0
phân tích com.google.firebase:firebase-analytics-ktx 21.3.0
Nhà cung cấp tùy chỉnh Kiểm tra ứng dụng com.google.firebase:firebase-appcheck-ktx 17.0.1
Nhà cung cấp gỡ lỗi Kiểm tra ứng dụng com.google.firebase:firebase-appcheck-debug 17.0.1
Kiểm tra ứng dụng Nhà cung cấp tính toàn vẹn của Play com.google.firebase:firebase-appcheck-playintegrity 17.0.1
Phân phối ứng dụng com.google.firebase:firebase-appdistribution 16.0.0-beta08
API phân phối ứng dụng com.google.firebase:firebase-appdistribution-api-ktx 16.0.0-beta08
Plugin phân phối ứng dụng com.google.firebase:firebase-appdistribution-gradle 4.0.0
xác thực com.google.firebase:firebase-auth-ktx 22.0.0
Cửa hàng lửa trên đám mây com.google.firebase:firebase-firestore-ktx 24.6.1
Chức năng đám mây cho SDK máy khách Firebase com.google.firebase:firebase-functions-ktx 20.3.1
Nhắn tin qua đám mây com.google.firebase:firebase-messaging-ktx 23.1.2
Lưu trữ đám mây com.google.firebase:firebase-storage-ktx 20.2.0
Crashlytics com.google.firebase:firebase-crashlytics-ktx 18.3.7
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.3.7
plugin crashlytics com.google.firebase:firebase-crashlytics-gradle 2.9.5
Hỗ trợ mô-đun tính năng động com.google.firebase:firebase-dynamic-module-support 16.0.0-beta03
Liên kết động com.google.firebase:firebase-dynamic-links-ktx 21.1.0
Nhắn tin trong ứng dụng com.google.firebase:firebase-inappmessaging-ktx 20.3.2
(yêu cầu)
Hiển thị tin nhắn trong ứng dụng com.google.firebase:firebase-inappmessaging-display-ktx 20.3.2
(yêu cầu)
cài đặt căn cứ hỏa lực com.google.firebase:firebase-installations-ktx 17.1.3
API trình tải xuống mô hình Firebase ML com.google.firebase:firebase-ml-modeldoader-ktx 24.1.2
Giám sát hiệu suất com.google.firebase:firebase-perf-ktx 20.3.2
Plugin giám sát hiệu suất com.google.firebase:perf-plugin 1.4.2
Cơ sở dữ liệu thời gian thực com.google.firebase:firebase-database-ktx 20.2.2
Cấu hình từ xa com.google.firebase:firebase-config-ktx 21.4.0
Plugin dịch vụ Google Play com.google.gms:google-services 4.3.15
thư viện không dùng nữa
Ứng dụng Kiểm tra nhà cung cấp SafetyNet com.google.firebase:firebase-appcheck-safetynet 16.1.2
Lập chỉ mục ứng dụng com.google.firebase:firebase-appindexing 20.0.0

Thư viện Firebase ML Kit

API mô hình tùy chỉnh Firebase ML com.google.firebase:firebase-ml-model-interpreter 22.0.4
API tầm nhìn Firebase ML com.google.firebase:firebase-ml-vision 24.1.0
Firebase ML: Mô hình ghi 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-detection-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: 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-ngôn ngữ 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

Java

Dịch vụ hoặc Sản phẩm Phụ thuộc lớp Muộn nhất
phiên bản
Thêm phân tích?
Firebase Android BoM
(Hóa đơn nguyên vật liệu)
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 phiên bản thư viện nào được ánh xạ tới một phiên bản BoM cụ thể, hãy xem lại ghi chú phát hành cho phiên bản BoM đó.

32.1.0
AdMob com.google.android.gms:play-services-ads 22.1.0
phân tích com.google.firebase:firebase-analytics 21.3.0
Nhà cung cấp tùy chỉnh Kiểm tra ứng dụng com.google.firebase:firebase-appcheck 17.0.1
Nhà cung cấp gỡ lỗi Kiểm tra ứng dụng com.google.firebase:firebase-appcheck-debug 17.0.1
Kiểm tra ứng dụng Nhà cung cấp tính toàn vẹn của Play com.google.firebase:firebase-appcheck-playintegrity 17.0.1
Phân phối ứng dụng com.google.firebase:firebase-appdistribution 16.0.0-beta08
API phân phối ứng dụng com.google.firebase:firebase-appdistribution-api 16.0.0-beta08
Plugin phân phối ứng dụng com.google.firebase:firebase-appdistribution-gradle 4.0.0
xác thực com.google.firebase:firebase-auth 22.0.0
Cửa hàng lửa trên đám mây com.google.firebase:firebase-firestore 24.6.1
Chức năng đám mây cho SDK máy khách Firebase com.google.firebase:firebase-functions 20.3.1
Nhắn tin qua đám mây com.google.firebase:firebase-messaging 23.1.2
Lưu trữ đám mây com.google.firebase:firebase-storage 20.2.0
Crashlytics com.google.firebase:firebase-crashlytics 18.3.7
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.3.7
plugin crashlytics com.google.firebase:firebase-crashlytics-gradle 2.9.5
Hỗ trợ mô-đun tính năng động com.google.firebase:firebase-dynamic-module-support 16.0.0-beta03
Liên kết động com.google.firebase:firebase-dynamic-links 21.1.0
Nhắn tin trong ứng dụng com.google.firebase:firebase-inappmessaging 20.3.2
(yêu cầu)
Hiển thị tin nhắn trong ứng dụng com.google.firebase:firebase-inappmessaging-display 20.3.2
(yêu cầu)
cài đặt căn cứ hỏa lực com.google.firebase:firebase-installations 17.1.3
API trình tải xuống mô hình Firebase ML com.google.firebase:firebase-ml-modeldoader 24.1.2
Giám sát hiệu suất com.google.firebase:firebase-perf 20.3.2
Plugin giám sát hiệu suất com.google.firebase:perf-plugin 1.4.2
Cơ sở dữ liệu thời gian thực com.google.firebase:cơ sở dữ liệu firebase 20.2.2
Cấu hình từ xa com.google.firebase:firebase-config 21.4.0
Plugin dịch vụ Google Play com.google.gms:google-services 4.3.15
thư viện không dùng nữa
Ứng dụng Kiểm tra nhà cung cấp SafetyNet com.google.firebase:firebase-appcheck-safetynet 16.1.2
Lập chỉ mục ứng dụng com.google.firebase:firebase-appindexing 20.0.0

Thư viện Firebase ML Kit

API mô hình tùy chỉnh Firebase ML com.google.firebase:firebase-ml-model-interpreter 22.0.4
API tầm nhìn Firebase ML com.google.firebase:firebase-ml-vision 24.1.0
Firebase ML: Mô hình ghi 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-detection-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: 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-ngôn ngữ 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



Bước tiếp theo

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

Tìm hiểu về Firebase: