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 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ị vật lý hoặc sử dụng trình giả lập để 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 mô phỏng phải được 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 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 Trợ lý Android Studio Firebase (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ụ 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

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

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 ( plat_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 .

   Tên gói là gì và bạn tìm thấy nó ở đâu?

   • Tên gói xác định duy nhất ứng dụng của bạn trên thiết bị và trong Cửa hàng Google Play.

   • Tên gói thường được gọi là ID ứng dụng .

   • Tìm tên gói ứng dụng của bạn trong tệp Gradle mô-đun (cấp ứng dụng), thường là app/build.gradle (tên gói ví dụ: com.yourcompany.yourproject ).

   • Xin lưu ý rằng giá trị tên gói có phân biệt chữ hoa chữ thường và không thể thay đổi giá trị này cho ứng dụng Firebase Android này sau khi được đăng ký với dự án Firebase của bạn.

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

   Biệt hiệu ứng dụng và chứng chỉ ký gỡ lỗi SHA-1 được sử dụng như thế nào trong Firebase?

   • Biệt hiệu ứng dụng : Mã nhận dạng nội bộ, tiện lợi chỉ hiển thị với bạn trong bảng điều khiển Firebase

   • Gỡ lỗi ký chứng chỉ SHA-1 : Hàm băm SHA-1 được yêu cầu bởi Xác thực Firebase (khi sử dụng Đăng nhập bằng Google hoặc đăng nhập bằng số điện thoại ) và Liên kết động Firebase .

5. Nhấp vào Đă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.

   Bạn cần biết gì về tệp cấu hình này?

   • Tệp cấu hình Firebase chứa các số nhận dạng duy nhất nhưng không bí mật cho dự án của bạn. Để tìm hiểu thêm về tệp cấu hình này, hãy truy cập Tìm hiểu dự án Firebase .

   • Bạn có thể tải xuống lại tệp cấu hình Firebase của mình bất kỳ lúc nào.

   • Đảm bảo rằng tên tệp cấu hình không được nối với các ký tự bổ sung, chẳng hạn như (2) .

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.13'  // 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. Sử dụng Firebase Android BoM , khai báo 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. Khai báo chúng trong tệp Gradle mô-đun (cấp ứng dụng) của bạn (thường là app/build.gradle ).

   Đã bật phân tích

   Java

   dependencies {
     // ...
   
     // Import the Firebase BoM
     implementation platform('com.google.firebase:firebase-bom:30.3.1')
   
     // When using the BoM, you don't specify versions in Firebase library dependencies
   
     // Declare the dependency for the Firebase SDK for Google Analytics
     implementation 'com.google.firebase:firebase-analytics'
   
     // Declare the dependencies for any other desired Firebase products
     // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
     implementation 'com.google.firebase:firebase-auth'
     implementation 'com.google.firebase:firebase-firestore'
   }
   

   Kotlin+KTX

   dependencies {
     // ...
   
     // Import the Firebase BoM
     implementation platform('com.google.firebase:firebase-bom:30.3.1')
   
     // When using the BoM, you don't specify versions in Firebase library dependencies
   
     // Declare the dependency for the Firebase SDK for Google Analytics
     implementation 'com.google.firebase:firebase-analytics-ktx'
   
     // Declare the dependencies for any other desired Firebase products
     // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
     implementation 'com.google.firebase:firebase-auth-ktx'
     implementation 'com.google.firebase:firebase-firestore-ktx'
   }
   

   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 Firebase Android.

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

   Java

   dependencies {
     // ...
   
     // Import the Firebase BoM
     implementation platform('com.google.firebase:firebase-bom:30.3.1')
   
     // When using the BoM, you don't specify versions in Firebase library dependencies
   
     // Declare the dependencies for the desired Firebase products
     // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
     implementation 'com.google.firebase:firebase-auth'
     implementation 'com.google.firebase:firebase-firestore'
   }
   

   Kotlin+KTX

   dependencies {
     // ...
   
     // Import the Firebase BoM
     implementation platform('com.google.firebase:firebase-bom:30.3.1')
   
     // When using the BoM, you don't specify versions in Firebase library dependencies
   
     // Declare the dependencies for the desired Firebase products
     // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
     implementation 'com.google.firebase:firebase-auth-ktx'
     implementation 'com.google.firebase:firebase-firestore-ktx'
   }
   

   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 Firebase Android.

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.

   Gặp lỗi xây dựng khi gọi hỗ trợ tùy chỉnh và bật gỡ gỡ lỗi? Đây là cách khắc phục.

   Các bản dựng Gradle sử dụng plugin Android Gradle (AGP) v4.2 trở xuống cần bật hỗ trợ Java 8. Nếu không, các dự án Android này gặp lỗi xây dựng khi thêm SDK Firebase.

   Để khắc phục lỗi xây dựng này, bạn có thể làm theo một trong hai tùy chọn:

   • Thêm compileOptions được liệt kê từ thông báo lỗi vào tệp build.gradle cấp ứng dụng của bạn.
   • Tăng minSdkVersion cho dự án Android của bạn lên 26 hoặc cao hơn.

   Tìm hiểu thêm về lỗi xây dựng này trong Câu hỏi thường gặp này .

Đó là nó! Bạn có thể bỏ qua trước để 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 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, plugin và phụ thuộc Firebase cần thiết vào dự án Android của bạn - tất cả đều từ bên 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 Android Studio mới nhất và Hỗ trợ 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ở Hỗ trợ 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.

      Dòng công việc này làm gì?

      • Quy trình làm việc này tự động tạo ứng dụng Firebase Android mới bằng cách sử dụng tên gói ứng dụng của bạn. Bạn có thể tạo ứng dụng Firebase Android mới này trong dự án Firebase hiện có hoặc dự án mới.

        Dưới đây là một số mẹo về cách thiết lập dự án Firebase của bạn:

        • Xem các phương pháp hay nhất của chúng tôi để thêm ứng dụng vào dự án Firebase, bao gồm cách xử lý nhiều biến thể.

        • Nếu bạn tạo một dự án mới, chúng tôi thực sự khuyên bạn nên thiết lập Google Analytics cho dự án của mình, điều này cho phép bạn có trải nghiệm tối ưu khi sử dụng nhiều sản phẩm Firebase.

      • Dòng công việc này cũng thêm tệp cấu hình Android của dự án Firebase ( google-services.json ) vào thư mục mô-đun (cấp ứng dụng) của ứng dụng của bạn.

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

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

• Đại diện Firebase Android SDK GitHub

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

Bước tiếp theo

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

• Nhận thông tin chi tiết về hành vi của người dùng với Analytics .

• Thiết lập luồng xác thực người dùng với Xác thực .

• Lưu trữ dữ liệu, như thông tin người dùng, với Cloud Firestore hoặc Cơ sở dữ liệu thời gian thực .

• Lưu trữ các tệp, chẳng hạn như ảnh và video, bằng Bộ nhớ đám mây .

• Kích hoạt mã phụ trợ chạy trong môi trường an toàn với Chức năng đám mây .

• Gửi thông báo bằng Nhắn tin qua đám mây .

• Tìm hiểu thời điểm và lý do ứng dụng của bạn gặp sự cố với Crashlytics .

Tìm hiểu về Firebase:

• Truy cập Tìm hiểu các dự án Firebase để tìm hiểu thêm về các dự án Firebase và các phương pháp hay nhất cho các dự án.

• Truy cập Tìm hiểu thêm về Android và Firebase nếu bạn có câu hỏi về các khái niệm không quen thuộc hoặc cụ thể đối với phát triển Firebase và Android.

• Khám phá các ứng dụng Firebase mẫu .

• Có được trải nghiệm thực tế với Firebase Android Codelab .

• Tìm hiểu thêm với Firebase trong khóa học Cuối tuần .

• Chuẩn bị khởi chạy ứng dụng của bạn:

  • Thiết lập thông báo ngân sách cho dự án của bạn trong Google Cloud Console.
  • Theo dõi Bảng điều khiển sử dụng và thanh toán trong bảng điều khiển Firebase để có được bức tranh tổng thể về việc sử dụng dự án của bạn trên nhiều dịch vụ Firebase.
  • Xem lại danh sách kiểm tra khởi chạy Firebase .

• Bạn gặp sự cố với Firebase và dự án Android của mình? Truy cập Câu hỏi thường gặp & khắc phục sự cố Android .