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

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

iOS+ Android Web

Đ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.

  Bạn có muốn sử dụng Cloud Messaging không?

  Đối với Cloud Messaging trên các nền tảng của Apple, sau đây là các điều kiện tiên quyết:

  • Thiết lập thiết bị Apple thực tế.
  • Lấy Khoá xác thực thông báo đẩy của Apple cho Tài khoản nhà phát triển của Apple.
  • Bật Thông báo đẩy trong Xcode trong phần App (Ứng dụng) > Capabilities (Chức nă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.

Lưu ý: Nếu đang nhắm đến macOS hoặc macOS Catalyst, bạn phải thêm khả năng Chia sẻ khoá vào mục tiêu của mình. Trong Xcode, hãy chuyển đến thẻ Signing & Capabilities (Ký và chức năng) của mục tiêu, sau đó nhấp vào + Capabilities (Thêm chức năng) để thêm một chức năng mới.

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

Quy trình công việc flutterfire configure này có tác dụng gì?

Quy trình công việc flutterfire configure thực hiện những việc sau:

• Yêu cầu bạn chọn các nền tảng (iOS, Android, Web) được hỗ trợ trong ứng dụng Flutter. Đối với mỗi nền tảng đã chọn, FlutterFire CLI sẽ tạo một ứng dụng Firebase mới trong dự án Firebase.

  Bạn có thể chọn sử dụng một dự án Firebase hiện có hoặc tạo một dự án Firebase mới. Nếu bạn đã đăng ký ứng dụng trong một dự án Firebase hiện có, thì FlutterFire CLI sẽ cố gắng so khớp các ứng dụng đó dựa trên cấu hình dự án Flutter hiện tại của bạn.

  Lưu ý: Sau đây là một số mẹo về cách thiết lập và quản lý dự án Firebase:

  • Hãy tham khảo các phương pháp hay nhất để thêm ứng dụng vào dự án Firebase, bao gồm cả cách xử lý nhiều biến thể.
  • Bật Google Analytics trong dự án để có trải nghiệm tối ưu khi sử dụng nhiều sản phẩm Firebase, chẳng hạn như Crashlytics và Remote Config.

• Tạo tệp cấu hình Firebase (firebase_options.dart) và thêm tệp đó vào thư mục lib/.

  Lưu ý: Tệp cấu hình Firebase này chứa các giá trị nhận dạng duy nhất nhưng không bí mật cho từng nền tảng mà bạn đã chọn.
  Hãy truy cập vào bài viết Tìm hiểu về dự án Firebase để tìm hiểu thêm về tệp cấu hình này.

• (dành cho Crashlytics hoặc Performance Monitoring trên Android) Thêm các trình bổ trợ Gradle bắt buộc dành riêng cho sản phẩm vào ứng dụng Flutter.

  Lưu ý: Để FlutterFire CLI thêm trình bổ trợ Gradle thích hợp, bạn phải nhập trình bổ trợ Flutter của sản phẩm vào ứng dụng Flutter.

Sau lần chạy ban đầu của flutterfire configure, bạn cần chạy lại lệnh này bất cứ khi nào bạn:

• Bắt đầu hỗ trợ một nền tảng mới trong ứng dụng Flutter.
• Bắt đầu sử dụng một dịch vụ hoặc sản phẩm Firebase mới trong ứng dụng Flutter, đặc biệt là nếu bạn bắt đầu sử dụng tính năng đăng nhập bằng Google, Crashlytics, Performance Monitoring hoặc Realtime Database.

Việc chạy lại 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 Android) tự động thêm mọi trình bổ trợ Gradle bắt buộc vào ứng dụng.

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

Thận trọng: Firebase trên Windows không dành cho các trường hợp sử dụng chính thức, chỉ dành cho quy trình phát triển cục bộ.

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

• Trải nghiệm thực tế với Lớp học lập trình Firebase Flutter.

• Chuẩn bị ra mắt ứng dụng:

  • Thiết lập cảnh báo về ngân sách cho dự án của bạn trong bảng điều khiển Google Cloud.
  • Theo dõi bảng điều khiển về Mức sử dụng và thanh toán trong bảng điều khiển Firebase để nắm được thông tin tổng quan về mức sử dụng của dự án trên nhiều dịch vụ Firebase.
  • Xem danh sách kiểm tra khi ra mắt Firebase.