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 tất phần Bắt đầu: Lái thử để 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 bắt buộc

  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 nhằm 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 động Firebase trong ứng dụng của bạn

  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 luôn được cập nhật:

    flutterfire configure
    
  3. Trong tệp lib/main.dart, hãy nhập trình bổ trợ Firebase Core 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 động 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 (phải bắt đầu bằng demo-):

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

Bước 4: Thêm các 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ột trình bổ trợ cho mỗi sản phẩm của 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 áp dụng cho các nền tảng Apple, Android và 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ì trình bổ trợ đó sẽ được các phiên bản Apple, Android và web của ứng dụng sử dụng.

Sau đây là cách thêm một 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 và đối với CrashlyticsPerformance Monitoring trên Android, lệnh này sẽ thêm các trình bổ trợ Gradle bắt buộc 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! Các ứ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ợ có sẵn

Product Tên trình bổ trợ iOS Android Web Các thiết bị khác của Apple
(macOS, v.v.)
Windows
Firebase AI Logic 1 firebase_ai
beta
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
Firebase lượt cài đặt 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

1 Firebase AI Logic trước đây có tên là "Vertex AI in Firebase" với trình bổ trợ firebase_vertexai.

Dùng thử một ứng dụng mẫu bằng Analytics

Giống như mọi 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 ví dụ, hãy sao chép và dán 2 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 Phân tích trong trình đơn đ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ẽ cho thấy một người dùng đang hoạt động trong bảng "Số người dùng đang hoạt động trong 30 phút qua" (có thể mất một khoảng thời gian để điền thông tin vào bảng này).

    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 ví dụ tạo ra.

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

Các bước tiếp theo