Hãy làm theo hướng dẫn này để sử dụng SDK Firebase JavaScript trong ứng dụng web của bạn hoặc dưới dạng ứng dụng khách để truy cập của người dùng cuối, chẳng hạn như trong ứng dụng Node.js trên máy tính hoặc ứng dụng IoT.
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ẽ sử dụng để kết nối ứng dụng với tài nguyên dự án Firebase.
Truy cập bài viết Tìm hiểu về dự án Firebase để tìm hiểu thêm về 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ử 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 cho API mô-đun của SDK Firebase JS, sử dụng định dạng Mô-đun JavaScript.
Quy trình công việc này sử dụng npm và yêu cầu trình 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 gói mô-đun nhằm loại bỏ mã không dùng đến (hiệu ứng rung cây) và giảm kích thước SDK.
Cài đặt Firebase bằng npm:
npm install firebase
Khởi động Firebase trong ứng dụng và tạo đối tượng Ứng dụng Firebase:
import { initializeApp } from 'firebase/app'; // TODO: Replace the following with your app's Firebase project 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ụ Firebase. Sau khi khởi chạy đố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ụ 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), thì 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 duy trì trên quá trình kết xuất phía máy chủ và lượt kết xuất từ ứng dụng khách. Trong logic máy chủ, hãy triển khai giao diện
FirebaseServerApp
để tối ưu hoá tính năng quản lý phiên bằng worker dịch vụ của ứng dụng.
Bước 3: Truy cập Firebase trong ứng dụng
Bạn có thể nhập các dịch vụ Firebase (như Cloud Firestore, Authentication, Realtime Database, Remote Config, v.v.) trong từng gói con.
Ví dụ bên dưới 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 'firebase/<service>'; // TODO: Replace the following with your app's Firebase project 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
Firebase Web SDK được thiết kế để hoạt động với các trình gói mô-đun nhằm xoá mọi mã không sử dụng (kỹ thuật rung cây). Bạn nên sử dụng phương pháp này cho các ứng dụng phát hành công khai. Các công cụ như Angular CLI, Next.js, Vue CLI hoặc Create React App sẽ 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à nhập vào cơ sở mã của bạn.
Hãy xem hướng dẫn của chúng tôi về Cách sử dụng trình gói mô-đun với Firebase để biết thêm thông tin.
Các dịch vụ Firebase hiện có cho web
Giờ đây, khi đã thiết lập để 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 tuỳ chọn nhập thay thế, hãy xem tài liệu về các thư viện hiện có.
Các bước tiếp theo
Tìm hiểu về Firebase:
Khám phá các ứng dụng Firebase mẫu.
Trải nghiệm thực tế với Lớp học lập trình về Firebase Web.
Khám phá mã nguồn mở trong GitHub.
Xem lại các môi trường được hỗ trợ cho SDK Firebase JavaScript.
Tăng tốc quá trình phát triển bằng các thư viện nguồn mở do Firebase duy trì, chẳng hạn như AngularFire, RxFire và FirebaseUI cho web.
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 trang tổng quan 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.