Thêm Firebase vào dự án JavaScript của bạn

Hãy làm theo hướng dẫn này để sử dụng SDK Firebase JavaScript trong ứng dụng web hoặc làm ứng dụng khách để người dùng cuối truy cập, chẳng hạn như trong ứng dụng IoT hoặc ứng dụng Node.js cho máy tính.

Bước 1: Tạo dự án Firebase và đăng ký ứng dụng

Trước khi có thể thêm Firebase vào ứng dụng JavaScript, bạn cần tạo một dự án Firebase và đăng ký ứng dụng của mình với dự án đó. Khi đăng ký ứng dụng với Firebase, bạn sẽ nhận được một đối tượng cấu hình Firebase mà bạn sẽ dùng để kết nối ứng dụng với tài nguyên dự án Firebase.

Hãy truy cập bài viết Tìm hiểu về các dự án Firebase để tìm hiểu thêm về các dự án Firebase và các phương pháp hay nhất để thêm ứng dụng vào dự án.

Nếu chưa có dự án JavaScript và chỉ muốn dùng thử một sản phẩm của Firebase, bạn có thể tải một trong các mẫu bắt đầu nhanh của chúng tôi xuống.

Bước 2: Cài đặt SDK và khởi chạy Firebase

Trang này mô tả hướng dẫn thiết lập API mô-đun cho SDK Firebase JavaScript, sử dụng định dạng Mô-đun JavaScript.

Quy trình này sử dụng npm và yêu cầu trình đóng gói mô-đun hoặc công cụ khung JavaScript vì API mô-đun được tối ưu hoá để hoạt động với trình đóng gói mô-đun nhằm loại bỏ mã không dùng đến (tree-shaking) và giảm kích thước SDK.

  1. Cài đặt Firebase bằng npm:

    npm install firebase

  2. Khởi động Firebase trong ứng dụng của bạn và tạo một đối tượng Ứng dụng Firebase:

    import { initializeApp } from 'firebase/app';

// TODO: Replace the following with your app's Firebase configuration
const firebaseConfig = {
  //...
};

const app = initializeApp(firebaseConfig);

    Ứng dụng Firebase là một đối tượng giống như vùng chứa, lưu trữ cấu hình chung và chia sẻ thông tin xác thực trên các dịch vụ của Firebase. Sau khi khởi chạy một đối tượng Ứng dụng Firebase trong mã, bạn có thể thêm và bắt đầu sử dụng các dịch vụ của Firebase.

    Nếu ứng dụng của bạn có các tính năng động dựa trên tính năng kết xuất phía máy chủ (SSR), bạn cần thực hiện thêm một số bước để đảm bảo rằng cấu hình của bạn vẫn được duy trì trong các lượt kết xuất phía máy chủ và kết xuất phía máy khách. Trong logic máy chủ, hãy triển khai giao diện FirebaseServerApp để tối ưu hoá quy trình quản lý phiên của ứng dụng bằng trình chạy dịch vụ.

Bước 3: Truy cập Firebase trong ứng dụng của bạn

Bạn có thể nhập các dịch vụ của Firebase (như Cloud Firestore, Authentication, Realtime Database, Remote Config, v.v.) trong từng gói phụ.

Ví dụ dưới đây cho thấy cách bạn có thể sử dụng SDK Cloud Firestore Lite để truy xuất danh sách dữ liệu.

import { initializeApp } from 'firebase/app';
import { getFirestore, collection, getDocs } from 'firebase/firestore/lite';
// Follow this pattern to import other Firebase services
// import { }< from &>#39;firebase/service';

// TODO: Replace the following with your app&#39;s Firebase configuration
const firebaseConfig = {
  //...
};

const app = initializeApp(firebaseConfig);
const db = getFirestore(app);

// Get a list of cities from your database
async function getCities(db) {
  const citiesCol = collection(db, 'cities');
  const citySnapshot = await getDocs(citiesCol);
  const cityList = citySnapshot.docs.map(doc => doc.data());
  return cityList;
}

Bước 4: Sử dụng trình đóng gói mô-đun (webpack/Rollup) để giảm kích thước

SDK Firebase JavaScript được thiết kế để hoạt động với trình đóng gói mô-đun nhằm xoá mọi mã không dùng đến (loại bỏ mã thừa). Bạn nên sử dụng phương pháp này cho các ứng dụng chính thức. Các công cụ như Angular CLI, Next.js, Vue CLI hoặc Create React App tự động xử lý việc đóng gói mô-đun cho các thư viện được cài đặt thông qua npm và được nhập vào toàn bộ mã nguồn của bạn.

Để biết thêm thông tin, hãy xem hướng dẫn của chúng tôi về cách Sử dụng trình đóng gói mô-đun với Firebase.

Các dịch vụ Firebase hiện có cho web

Giờ đây, khi đã thiết lập xong để sử dụng Firebase, bạn có thể bắt đầu thêm và sử dụng bất kỳ dịch vụ Firebase nào sau đây trong ứng dụng web của mình.

Các lệnh sau đây cho biết cách nhập thư viện Firebase được cài đặt cục bộ bằng npm. Để biết các lựa chọn nhập khác, hãy xem tài liệu về các thư viện hiện có.

1 Firebase AI Logic trước đây được gọi là "Vertex AI in Firebase" với gói firebase/vertexai.

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

Các bước tiếp theo

Tìm hiểu về Firebase: