Google cam kết thúc đẩy công bằng chủng tộc cho Cộng đồng người da đen. Xem cách thực hiện.

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

Điều kiện tiên quyết

Nếu bạn chưa có một dự án Android và chỉ muốn thử ra một sản phẩm căn cứ hỏa lực, bạn có thể tải về một trong chúng tôi mẫu QuickStart .


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:

  • Lựa chọn 1 : (đề nghị) Sử dụng giao diện điều khiển thiết lập quy trình làm việc căn cứ hỏa lực.
  • Lựa chọn 2 : Sử dụng Android Studio căn cứ hỏa lực Assistant (có thể yêu cầu cấu hình bổ sung).



Lựa chọn 1: Thêm căn cứ hỏa lực sử dụng các căn cứ hỏa lực console

Thêm căn cứ hỏa lực để ứng dụng của bạn liên quan đến nhiệm vụ cả trong căn cứ hỏa lực console và trong dự án mở Android của bạn (ví dụ, bạn tải về các file cấu hình căn cứ hỏa lực từ giao diện điều khiển, sau đó di chuyển chúng vào dự án Android của bạn).

Bước 1: Tạo một dự án căn cứ hỏa lực

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. Thăm Hiểu căn cứ hỏa lực dự án để tìm hiểu thêm về các dự án căn cứ hỏa lực.

Bước 2: Đăng ký ứng dụng của bạn với căn cứ hỏa lực

Để 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. Tới các căn cứ hỏa lực console .

  2. Ở trung tâm củ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 động công việc cài đặt.

  3. Nhập tên gói ứng dụng của bạn trong lĩnh vực tên gói Android.

  4. (Tùy chọn) Nhập thông tin ứng dụng khác: nickname AppDebug ký giấy chứng nhận SHA-1.

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

Bước 3: Thêm một tập tin cấu hình căn cứ hỏa lực

  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 để có được tập tin cấu hình căn cứ hỏa lực 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. Để kích hoạt sản phẩm căn cứ hỏa lực trong ứng dụng của bạn, hãy thêm google-dịch vụ cắm vào các file Gradle của bạn.

    1. Trong thư mục gốc cấp của bạn (dự án cấp) tập tin Gradle ( build.gradle ), thêm các quy tắc để bao gồm các plugin Google Dịch vụ Gradle. 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.10'  // Google Services plugin
        }
      }
      
      allprojects {
        // ...
      
        repositories {
          // Check that you have the following line (if not, add it):
          google()  // Google's Maven repository
          // ...
        }
      }
      
    2. Trong mô-đun của bạn (ứng dụng cấp) tập tin Gradle (thường là app/build.gradle ), áp dụng các plugin Google Dịch vụ Gradle:

      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 căn cứ hỏa lực SDK để ứng dụng của bạn

  1. Sử dụng các căn cứ hỏa lực Android HĐQT , kê khai các phụ thuộc cho các sản phẩm căn cứ hỏa lực mà bạn muốn sử dụng trong ứng dụng của bạn. Khai báo trong module của bạn (ứng dụng cấp) tập tin Gradle (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:28.4.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:28.4.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 việc sử dụng căn cứ hỏa lực Android HĐQT , ứng dụng của bạn sẽ luôn luôn sử dụng các phiên bản tương thích của các thư viện căn cứ hỏa lực Android.

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

    Java

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:28.4.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:28.4.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 việc sử dụng căn cứ hỏa lực Android HĐQT , ứng dụng của bạn sẽ luôn luôn sử dụng các phiên bản tương thích của các thư viện căn cứ hỏa lực 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.

Đó là nó! Bạn có thể bỏ qua phần kiểm tra đề nghị các bước tiếp theo .

Nếu bạn đang gặp rắc rối việc thiết lập, mặc dù, hãy truy cập xử lý sự cố Android & FAQ .



Phương án 2: Thêm căn cứ hỏa lực sử dụng các căn cứ hỏa lực Assistant

Các căn cứ hỏa lực Assistant đăng ký ứng dụng của bạn với một dự án căn cứ hỏa lực và thêm cần thiết căn cứ hỏa lực file, plugins, và phụ thuộc vào dự án Android của bạn - tất cả 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: Help> Check for updates
    • MacOS: Android Studio> Check for updates
  2. Mở Assistant căn cứ hỏa lực: Tools> căn cứ hỏa lực.

  3. Trong Trợ lý cửa sổ, chọn một sản phẩm căn cứ hỏa lực để 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> Nhật ký sự kiện Analytics).

    1. Nhấn Connect để căn cứ hỏa lực để kết nối dự án Android của bạn với căn cứ hỏa lực.

    2. Nhấp vào nút để thêm một sản phẩm căn cứ hỏa lực mong muốn (ví dụ, Thêm Analytics để ứ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 Trợ lý cửa sổ, hãy làm theo các hướng dẫn cài đặt còn lại cho sản phẩm được chọn căn cứ hỏa lực 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ó! Hãy chắc chắn để kiểm tra đề nghị các bước tiếp theo .

Nếu bạn đang gặp rắc rối việc thiết lập, mặc dù, hãy truy cập xử lý sự cố Android & FAQ .



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:

Lưu ý rằng khi sử dụng căn cứ hỏa lực Android HĐQT , bạn không chỉ định phiên bản thư viện cá nhân khi bạn khai báo thư viện phụ thuộc căn cứ hỏa lực trong build.gradle .

Java

Dịch vụ hoặc Sản phẩm Gradle phụ thuộc 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 mỗi 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 đó.

28.4.1
AdMob com.google.android.gms: play-services-ads 20.3.0
phân tích com.google.firebase: firebase-analytics 19.0.1
Nhà cung cấp tùy chỉnh Kiểm tra ứng dụng com.google.firebase: firebase-appcheck 16.0.0-beta02
Nhà cung cấp gỡ lỗi Kiểm tra ứng dụng com.google.firebase: firebase-appcheck-debug 16.0.0-beta02
Kiểm tra ứng dụng Nhà cung cấp SafetyNet com.google.firebase: firebase-appcheck-safenet 16.0.0-beta02
Plugin phân phối ứng dụng com.google.firebase: firebase-appdistribution-gradle 2.2.0
Lập chỉ mục ứng dụng com.google.firebase: firebase-appindexing 20.0.0
Xác thực com.google.firebase: firebase-auth 21.0.1
Cloud Firestore com.google.firebase: firebase-firestore 23.0.3
Chức năng đám mây cho SDK ứng dụng Firebase com.google.firebase: firebase-functions 20.0.1
Nhắn tin qua đám mây com.google.firebase: firebase-message 22.0.0
Lưu trữ đám mây com.google.firebase: firebase-storage 20.0.0
Crashlytics com.google.firebase: firebase-crashlytics 18.2.1
Crashlytics NDK com.google.firebase: firebase-crashlytics-ndk 18.2.1
Plugin Crashlytics com.google.firebase: firebase-crashlytics-gradle 2.7.1
Hỗ trợ mô-đun tính năng động com.google.firebase: firebase-dynamic-module-support 16.0.0-beta01
Liên kết động com.google.firebase: firebase-dynamic-links 20.1.1
Nhắn tin trong ứng dụng com.google.firebase: firebase-inappmessaging 20.1.0
(yêu cầu)
Màn hình nhắn tin trong ứng dụng com.google.firebase: firebase-inappmessaging-display 20.1.0
(yêu cầu)
Cài đặt Firebase com.google.firebase: firebase-installations 17.0.0
API trình tải xuống mô hình Firebase ML com.google.firebase: firebase-ml-modeldownloader 24.0.0
Giám sát hiệu suất com.google.firebase: firebase-perf 20.0.2
Plugin Giám sát Hiệu suất com.google.firebase: perf-plugin 1.4.0
Cơ sở dữ liệu thời gian thực com.google.firebase: firebase-database 20.0.2
Cấu hình từ xa com.google.firebase: firebase-config 21.0.1
Plugin dịch vụ của Google Play com.google.gms: google-services 4,3.10
Thư viện không được dùng nữa
API mô hình tùy chỉnh Firebase ML com.google.firebase: firebase-ml-model -preter 22.0.4
API tầm nhìn ML của Firebase 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 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: 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: 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 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 mỗi 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 đó.

28.4.1
AdMob com.google.android.gms: play-services-ads 20.3.0
phân tích com.google.firebase: firebase-analytics-ktx 19.0.1
Nhà cung cấp tùy chỉnh Kiểm tra ứng dụng com.google.firebase: firebase-appcheck 16.0.0-beta02
Nhà cung cấp gỡ lỗi Kiểm tra ứng dụng com.google.firebase: firebase-appcheck-debug 16.0.0-beta02
Kiểm tra ứng dụng Nhà cung cấp SafetyNet com.google.firebase: firebase-appcheck-safenet 16.0.0-beta02
Plugin phân phối ứng dụng com.google.firebase: firebase-appdistribution-gradle 2.2.0
Lập chỉ mục ứng dụng com.google.firebase: firebase-appindexing 20.0.0
Xác thực com.google.firebase: firebase-auth-ktx 21.0.1
Cloud Firestore com.google.firebase: firebase-firestore-ktx 23.0.3
Chức năng đám mây cho SDK ứng dụng khách Firebase com.google.firebase: firebase-functions-ktx 20.0.1
Nhắn tin qua đám mây com.google.firebase: firebase-message-ktx 22.0.0
Lưu trữ đám mây com.google.firebase: firebase-storage-ktx 20.0.0
Crashlytics com.google.firebase: firebase-crashlytics-ktx 18.2.1
Crashlytics NDK com.google.firebase: firebase-crashlytics-ndk 18.2.1
Plugin Crashlytics com.google.firebase: firebase-crashlytics-gradle 2.7.1
Hỗ trợ mô-đun tính năng động com.google.firebase: firebase-dynamic-module-support 16.0.0-beta01
Liên kết động com.google.firebase: firebase-dynamic-links-ktx 20.1.1
Nhắn tin trong ứng dụng com.google.firebase: firebase-inappmessaging-ktx 20.1.0
(yêu cầu)
Màn hình nhắn tin trong ứng dụng com.google.firebase: firebase-inappmessaging-display-ktx 20.1.0
(yêu cầu)
Cài đặt Firebase com.google.firebase: firebase-installations-ktx 17.0.0
API trình tải xuống mô hình Firebase ML com.google.firebase: firebase-ml-modeldownloader-ktx 24.0.0
Giám sát hiệu suất com.google.firebase: firebase-perf-ktx 20.0.2
Plugin Giám sát Hiệu suất com.google.firebase: perf-plugin 1.4.0
Cơ sở dữ liệu thời gian thực com.google.firebase: firebase-database-ktx 20.0.2
Cấu hình từ xa com.google.firebase: firebase-config-ktx 21.0.1
Plugin dịch vụ của Google Play com.google.gms: google-services 4,3.10
Thư viện không được dùng nữa
API mô hình tùy chỉnh Firebase ML com.google.firebase: firebase-ml-model -preter 22.0.4
API tầm nhìn ML của Firebase 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 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: 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: 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

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

Tìm hiểu về Firebase: