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


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

  • Cài đặt trình chỉnh sửa hoặc IDE mà bạn muốn.

  • Thiết lập một thiết bị Apple thực hoặc sử dụng trình mô phỏng để chạy ứng dụng.

  • Đảm bảo rằng ứng dụng Flutter của bạn nhắm đến các phiên bản nền tảng sau hoặc mới hơn:

    • iOS 13
    • macOS 10.15

  • Cài đặt Flutter cho hệ điều hành cụ thể của bạn, bao gồm:

    • SDK Flutter
    • Thư viện hỗ trợ
    • Phần mềm và SDK dành riêng cho nền tảng

  • Đăng nhập vào Firebase bằng Tài khoản Google của bạn.

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 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 ứng dụng Flutter kết nối với Firebase.

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

flutterfire configure


Bước 3: Khởi động 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ợ lõi 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 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 (tệp này phải 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 áp dụng được 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ì các phiên bản Apple, Android và web của ứng dụng sẽ sử dụng trình bổ trợ đó.

Sau đâ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 và đối với Crashlytics và Performance Monitoring trên Android, hãy thêm các trình bổ trợ Gradle bắt buộc vào ứng dụng.

  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.

Trình bổ trợ có sẵn

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
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ừ kho lưu trữ chương trình mẫu Google Analytics, 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 (Số liệu phân tích) trong thanh đ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, thì trang tổng quan sẽ hiển thị một người dùng đang hoạt động trong bảng điều khiển "Số người dùng đang hoạt động trong 30 phút qua" (có thể mất chút thời gian để điền bảng điều khiển này).

    2. Nhấp vào DebugView. Bật tính năng này để xem tất 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 truy cập vào hướng dẫn bắt đầu sử dụng cho iOS+, Android và web.

Các bước tiếp theo