Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Bắt đầu sử dụng Firebase trong dự án Flutter

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

Cài đặt trình chỉnh sửa hoặc môi trường phát triển tích hợp (IDE) mà bạn muốn.
Cài đặt Flutter cho hệ điều hành cụ thể của bạn, bao gồm cả những hệ điều hành sau:
- Flutter SDK
- Thư viện hỗ trợ
- Phần mềm và SDK dành riêng cho từng nền tảng

Điều kiện tiên quyết theo từng nền tảng:

Apple

Thiết lập một thiết bị thực của Apple hoặc sử dụng trình mô phỏng để chạy ứng dụng.
Đảm bảo ứng dụng Flutter của bạn nhắm đến các phiên bản nền tảng sau đây trở lên:
- iOS 15
- macOS 10.15

Bạn có muốn dùng Cloud Messaging không?

Đối với Cloud Messaging trên các nền tảng của Apple, bạn cần đáp ứng các điều kiện tiên quyết sau:

Thiết lập thiết bị thực của Apple.

Lấy Khoá xác thực Dịch vụ thông báo đẩy của Apple cho tài khoản nhà phát triển Apple.

Bật thông báo đẩy trong Xcode trong phần App > Capabilities (Ứng dụng > Chức năng).

Android

Thiết lập một thiết bị hoặc trình mô phỏng để chạy ứng dụng của bạn. Trình mô phỏng phải sử dụng hình ảnh trình mô phỏng có Google Play.
Đảm bảo rằng ứng dụng của bạn đáp ứng các yêu cầu sau:
- Nhắm đến API cấp 23 (Marshmallow) trở lên
- Chạy Android 6.0 trở lên

Web

Không có điều kiện tiên quyết cụ thể theo nền tảng

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

Nếu bạn chưa cài đặt, hãy cài đặt CLI Firebase.
Đă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
```
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

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

Quy trình 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 của bạn.

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ý các ứ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 xem các phương pháp hay nhất của chúng tôi để thêm ứng dụng vào một dự án Firebase, bao gồm cả cách xử lý nhiều biến thể.

Bật Google Analytics trong dự án của bạn. Tính năng này mang đến trải nghiệm tối ưu khi sử dụng nhiều sản phẩm của Firebase, chẳng hạn như Crashlytics và Remote Config.

Tạo một 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.
Truy cập vào bài viết Tìm hiểu về các dự án Firebase để tìm hiểu thêm về tệp cấu hình này.

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

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

Sau lần chạy flutterfire configure ban đầu này, bạn cần chạy lại lệnh 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 của bạn.
Bắt đầu sử dụng một dịch vụ hoặc sản phẩm mới của Firebase 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 ở trạng thái mới nhất và (đối với Android) tự động thêm mọi trình bổ trợ Gradle cần thiết vào ứng dụng của bạn.

Bước 3: Khởi động Firebase trong ứng dụng của bạn

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
```
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
```
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';
```

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());

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ể bắt đầu 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ỗ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 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:

Trong thư mục dự án Flutter, hãy chạy lệnh sau:
```
flutter pub add PLUGIN_NAME
```
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, 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.
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 điểm cần đặc biệt lưu ý khi tạo ứng dụng web

Hỗ trợ Trusted Types

Firebase SDK cho Flutter hỗ trợ việc sử dụng Trusted Types để giúp ngăn chặn các cuộc tấn công XSS dựa trên DOM (phía máy khách). Khi bạn bật tính năng thực thi Loại đáng tin cậy cho ứng dụng, Firebase SDK sẽ chèn các tập lệnh của ứng dụng vào DOM bằng cách sử dụng các chính sách Loại đáng tin cậy tuỳ chỉnh, có tên là flutterfire-firebase_core, flutterfire-firebase_auth, v.v.

Tắt tính năng tự động chèn SDK JavaScript của Firebase

Theo mặc định, Firebase Flutter SDK sẽ tự động chèn SDK JavaScript của Firebase khi tạo cho web. Nếu không muốn SDK JavaScript của Firebase được tự động chèn, bạn có thể làm như sau:

Bỏ qua tập lệnh tự động chèn bằng cách thêm thuộc tính sau vào bên trong thẻ <script> trong tệp web/index.html trong dự án Flutter của bạn:

<!-- Add this property inside a <script> tag within your "web/index.html" file in your Flutter project -->
<!-- Put in the names of all the plugins you wish to ignore: -->
window.flutterfire_ignore_scripts = ['analytics', 'firestore'];

Tải tập lệnh theo cách thủ công bằng một trong các cách sau:

Cách 1: Thêm SDK một cách rõ ràng vào tệp web/index.html của bạn, bên trong lệnh gọi lại window.addEventListener:

  window.addEventListener('load', async function (ev) {
    window.firebase_firestore = await import("https://www.gstatic.com/firebasejs/12.13.0/firebase-firestore.js");
    window.firebase_analytics = await import("https://www.gstatic.com/firebasejs/12.13.0/firebase-analytics.js");

    _flutter.loader.loadEntrypoint().then(function (engineInitializer) {
      // rest of the code

Cách 2: Tải mã SDK JavaScript của Firebase của trình bổ trợ xuống từ miền gstatic rồi lưu mã đó vào một tệp JavaScript để lưu giữ trong dự án và tải theo cách thủ công:

  // "web/my-analytics.js" & "web/my-firestore.js" file loaded as a script into your "web/index.html" file:
  window.addEventListener('load', async function (ev) {
    window.firebase_analytics = await import("./my-analytics.js");
    window.firebase_firestore = await import("./my-firestore.js");

    _flutter.loader.loadEntrypoint().then(function (engineInitializer) {
      // rest of the code

Các trình bổ trợ có sẵn

Sản phẩm	Tên trình bổ trợ	Các thiết bị khác của Apple (macOS, v.v.)	Windows
Firebase AI Logic ¹	`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
SQL 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.}

^{2 Firebase SQL Connect trước đây có tên là "Firebase Data Connect".}

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 ngân sách cho dự án của bạn trong bảng điều khiển Google Cloud.
- Theo dõi trang tổng quan 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ụ của Firebase.
- Xem danh sách kiểm tra trước khi phát hành của Firebase.