Thêm Firebase vào ứng dụng Flutter


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

Nếu chưa có ứng dụng Flutter, bạn có thể hoàn thành phần Bắt đầu: Thử nghiệm để tạo một ứng dụng Flutter mới bằng trình chỉnh sửa hoặc IDE mà bạn muốn.

Bước 1: Cài đặt các công cụ dòng lệnh cần thiết

  1. Nếu bạn chưa cài đặt, hãy cài đặt CLI Firebase.

  2. Đăng nhập vào Firebase bằng Tài khoản Google của bạn bằng cách chạy lệnh sau:

    firebase login

  3. Cài đặt FlutterFire CLI bằng cách chạy lệnh sau từ bất kỳ thư mục nào:

    dart pub global activate flutterfire_cli

Bước 2: Định cấu hình ứng dụng để sử dụng Firebase

Sử dụng FlutterFire CLI để định cấu hình các ứng dụng Flutter để kết nối với Firebase.

Trong thư mục dự án Flutter, hãy chạy lệnh sau để bắt đầu quy trình định cấu hình ứng dụng:

flutterfire configure


Bước 3: Khởi chạy Firebase trong ứng dụng

  1. Trong thư mục dự án Flutter, hãy chạy lệnh sau để cài đặt trình bổ trợ cốt lõi:

    flutter pub add firebase_core

  2. Trong thư mục dự án Flutter, hãy chạy lệnh sau để đảm bảo rằng cấu hình Firebase của ứng dụng Flutter đã được cập nhật:

    flutterfire configure

  3. Trong tệp lib/main.dart, hãy nhập trình bổ trợ chính Firebase và tệp cấu hình mà bạn đã tạo trước đó:

    import 'package:firebase_core/firebase_core.dart';
import 'firebase_options.dart';

  4. Ngoài ra, trong tệp lib/main.dart, hãy khởi chạy Firebase bằng đối tượng DefaultFirebaseOptions do tệp cấu hình xuất:

    WidgetsFlutterBinding.ensureInitialized();
await Firebase.initializeApp(
  options: DefaultFirebaseOptions.currentPlatform,
);
runApp(const MyApp());

  5. Tạo lại ứng dụng Flutter:

    flutter run

Nếu muốn sử dụng một dự án minh hoạ, bạn có thể khởi động Trình mô phỏng Firebase và trong tệp lib/main.dart, hãy khởi chạy Firebase bằng demoProjectId (nên bắt đầu bằng demo-):

  await Firebase.initializeApp(
    demoProjectId: "demo-project-id",
  );

Bước 4: Thêm trình bổ trợ Firebase

Bạn truy cập vào Firebase trong ứng dụng Flutter thông qua nhiều trình bổ trợ Firebase Flutter, mỗi trình bổ trợ cho một sản phẩm Firebase (ví dụ: Cloud Firestore, Authentication, Analytics, v.v.).

Vì Flutter là một khung đa nền tảng, nên mỗi trình bổ trợ Firebase đều có thể áp dụng cho Apple, Android và các nền tảng web. Vì vậy, nếu bạn thêm bất kỳ trình bổ trợ Firebase nào vào ứng dụng Flutter, thì các phiên bản Apple, Android và web của ứng dụng đó sẽ sử dụng trình bổ trợ này.

Dưới đây là cách thêm trình bổ trợ Firebase Flutter:

  1. Trong thư mục dự án Flutter, hãy chạy lệnh sau:

    flutter pub add PLUGIN_NAME

  2. Trong thư mục dự án Flutter, hãy chạy lệnh sau:

    flutterfire configure

    Việc chạy lệnh này đảm bảo rằng cấu hình Firebase của ứng dụng Flutter luôn được cập nhật, đồng thời đối với Crashlytics và Performance Monitoring trên Android, sẽ thêm các trình bổ trợ Gradle cần thiết vào ứng dụng của bạn.

  3. Sau khi hoàn tất, hãy tạo lại dự án Flutter:

    flutter run

Bạn đã hoàn tất! Ứng dụng Flutter của bạn được đăng ký và định cấu hình để sử dụng Firebase.

Các trình bổ trợ hiện có

Product Tên trình bổ trợ iOS Android Web
khác của Apple (macOS, v.v.)		 Windows
Analytics firebase_analytics
beta
App Check firebase_app_check
beta
Authentication firebase_auth
beta beta
Cloud Firestore cloud_firestore
beta beta
Cloud Functions cloud_functions
beta
Cloud Messaging firebase_messaging
beta
Cloud Storage firebase_storage
beta beta
Crashlytics firebase_crashlytics
beta
Data Connect firebase_data_connect
Dynamic Links firebase_dynamic_links
In-App Messaging firebase_in_app_messaging
Số lượt cài đặt Firebase firebase_app_installations
beta
Trình tải mô hình học máy xuống firebase_ml_model_downloader
beta
Performance Monitoring firebase_performance
Realtime Database firebase_database
beta
Remote Config firebase_remote_config
beta
Vertex AI in Firebase firebase_vertexai
beta

Dùng thử ứng dụng mẫu với Analytics

Giống như tất cả các gói, trình bổ trợ firebase_analytics đi kèm với một chương trình mẫu.

  1. Mở một ứng dụng Flutter mà bạn đã định cấu hình để sử dụng Firebase (xem hướng dẫn trên trang này).

  2. Truy cập vào thư mục lib của ứng dụng, sau đó xoá tệp main.dart hiện có.

  3. Từ Google Analytics kho lưu trữ chương trình mẫu, hãy sao chép và dán hai tệp sau vào thư mục lib của ứng dụng:

    • main.dart
    • tabs_page.dart

  4. Chạy ứng dụng Flutter.

  5. Chuyển đến dự án Firebase của ứng dụng trong bảng điều khiển Firebase, sau đó nhấp vào Analytics trong bảng điều hướng bên trái.

    1. Nhấp vào Trang tổng quan. Nếu Analytics hoạt động đúng cách, trang tổng quan sẽ hiển thị người dùng đang hoạt động trong bảng "Người dùng hoạt động trong 30 phút qua" (có thể mất thời gian để bảng này điền sẵn).

    2. Nhấp vào DebugView. Bật tính năng này để xem tất cả các sự kiện do chương trình mẫu tạo ra.

Để biết thêm thông tin về cách thiết lập Analytics, hãy xem hướng dẫn bắt đầu dành cho iOS+, Android và web.

Các bước tiếp theo