Dùng dự án Firebase của riêng bạn

Firebase là bộ dịch vụ ứng dụng của Google: cơ sở dữ liệu tài liệu tên Firestore, đăng nhập, lưu trữ tệp, thông báo đẩy và nhiều dịch vụ khác. Nếu bạn đã có một dự án Firebase — có thể đang chạy cho một ứng dụng di động — bạn có thể kết nối dự án đó với ứng dụng MonstarX và dùng bất kỳ dịch vụ nào trong số đó.

Bạn có thể dùng Firebase cho một việc duy nhất (ví dụ gửi thông báo đẩy tới người dùng ứng dụng di động) hoặc biến Firestore thành cơ sở dữ liệu của ứng dụng, để ứng dụng web và các ứng dụng khác của bạn dùng chung một dữ liệu.

Trước khi bắt đầu

• Một dự án Firebase, và quyền truy cập phần cài đặt của dự án trong bảng điều khiển Firebase.
• Nếu muốn đăng nhập người dùng bằng Firebase Authentication, cần một ứng dụng web đã được thêm vào dự án Firebase đó.

Làm sao để kết nối Firebase?

1. Trong bảng điều khiển Firebase, mở Project settings → Service accounts và nhấp vào Generate new private key. Một tệp JSON sẽ được tải xuống.

2. Trong MonstarX, mở dự án và nhấp vào Dịch vụ đám mây trên thanh trên cùng, rồi nhấp Đám mây.

3. Trong Trình kết nối, nhấp vào Kết nối bên cạnh Firebase.

4. Mở tệp JSON bằng trình soạn văn bản, sao chép toàn bộ nội dung và dán vào Tệp khóa tài khoản dịch vụ. MonstarX tự đọc id dự án từ tệp này.

5. Chỉ điền các trường không bắt buộc nếu bạn cần:

   • Khóa API web — lấy ở Project settings → General → Your apps → Web app → apiKey. Chỉ cần khi đăng nhập người dùng bằng Firebase Authentication.
   • Bucket lưu trữ — chỉ khi tệp của bạn không nằm trong bucket mặc định của dự án.
   • URL Realtime Database — chỉ dành cho Realtime Database. Firestore không cần gì ở đây.

   

6. Nhấp vào Kết nối Firebase. MonstarX kiểm tra khóa với Google trước khi lưu, và hiện những gì tìm thấy bên cạnh Đã kết nối — id dự án và các bộ sưu tập Firestore, hoặc “chưa có cơ sở dữ liệu Firestore”.

Nếu bạn dán nhầm tệp — ví dụ tệp cấu hình ứng dụng web nhỏ thay vì khóa tài khoản dịch vụ — MonstarX sẽ từ chối và cho biết thiếu những trường nào.

Chú ý

Khóa tài khoản dịch vụ làm được mọi thứ trong dự án Firebase của bạn. Chỉ dán khóa vào biểu mẫu này, không bao giờ dán vào cuộc trò chuyện hay mã nguồn ứng dụng. MonstarX lưu khóa ở dạng mã hóa và chỉ dùng trên máy chủ của ứng dụng.

Ứng dụng của tôi làm được gì với Firebase?

Sau khi kết nối, hãy yêu cầu tính năng bằng lời thường, như “gửi thông báo đẩy cho hội viên khi một lớp bị hủy”. MonstarX sẽ xây dựng bằng Firebase:

Dịch vụ Firebase	Ứng dụng làm được gì
Firestore	Thêm, đọc, tìm, cập nhật và xóa tài liệu; đếm tài liệu
Authentication	Đăng ký và đăng nhập người dùng, đặt lại mật khẩu và quản lý người dùng (cần khóa API web)
Cloud Storage	Tải tệp lên, lấy liên kết tải xuống, liệt kê và xóa tệp
Cloud Messaging	Gửi thông báo đẩy tới một thiết bị hoặc một chủ đề
Realtime Database	Đọc và ghi dữ liệu (cần URL Realtime Database)

Mọi thứ chạy trên máy chủ của ứng dụng, nên khách truy cập không bao giờ thấy khóa của bạn.

Firestore có thể làm cơ sở dữ liệu của ứng dụng không?

Được. Mọi ứng dụng đều bắt đầu với cơ sở dữ liệu của MonstarX, nhưng bạn có thể chọn Firestore làm nơi lưu dữ liệu thay thế.

1. Kết nối Firebase trước (xem ở trên).

2. Trong Dịch vụ đám mây›Đám mây, tìm mục Nơi ứng dụng này lưu dữ liệu.

3. Chọn Firestore (dự án Firebase của bạn). Khi chưa kết nối Firebase, lựa chọn này ghi “kết nối Firebase trước” và không chọn được.

   

4. Nếu ứng dụng đã có dữ liệu, nhấp vào Sao chép dữ liệu hiện có để đưa dữ liệu sang, rồi xác nhận.

Từ đó trở đi:

• MonstarX xây dựng bằng bộ sưu tập và tài liệu thay cho bảng, và xem các bộ sưu tập thật của bạn trước khi viết mã — không bao giờ bịa ra trường mà dữ liệu của bạn không có.
• Dịch vụ đám mây›Cơ sở dữ liệu hiện các Bộ sưu tập Firestore cùng tài liệu trong đó. Ở đây chúng chỉ đọc; ứng dụng tự ghi.
• Tài khoản vẫn ở MonstarX. Người dùng vẫn đăng nhập như trước, và Dịch vụ đám mây›Người dùng vẫn hoạt động như cũ. Đó là lý do MonstarX giữ lại cơ sở dữ liệu của mình thay vì xóa đi.

Để chuyển lại, chọn Cơ sở dữ liệu MonstarX ở cùng chỗ đó. Ứng dụng quay về cơ sở dữ liệu của mình đúng như trước.

Sao chép dữ liệu hiện có làm gì?

• Mỗi bảng trở thành một bộ sưu tập cùng tên, và mỗi hàng thành một tài liệu. Id của hàng trở thành id của tài liệu.
• Chạy lại sẽ cập nhật các tài liệu đó thay vì nhân đôi.
• Bốn bảng đăng nhập vẫn nằm trong cơ sở dữ liệu MonstarX, nơi lưu tài khoản.
• Thao tác này không xóa gì, ở cả hai nơi.
• Ứng dụng lớn có thể được sao chép thành nhiều phần. Nếu thông báo cho biết đã dừng để giữ yêu cầu ngắn gọn, hãy chạy lại và quá trình sẽ tiếp tục từ chỗ đã dừng.

Điều cần biết

• Firestore hoặc Supabase, không phải cả hai. Mỗi ứng dụng lưu dữ liệu ở một nơi. Muốn đổi từ Supabase sang Firestore, hãy chuyển dữ liệu về cơ sở dữ liệu MonstarX trước. Bản thân trình kết nối Firebase vẫn dùng được song song với Supabase cho lưu trữ, gửi thông báo hoặc đăng nhập.
• Ứng dụng không cần Firebase SDK. MonstarX làm việc với Firebase qua một công cụ hỗ trợ có sẵn, hoạt động giống nhau trong bản xem trước và ứng dụng đã xuất bản.
• Thông báo đẩy tới thiết bị di động cần token thiết bị từ ứng dụng di động của bạn; MonstarX gửi tới những token mà ứng dụng được cung cấp.
• Xuất bản lên Google Cloud Run là một trình kết nối khác: xem Xuất bản lên nền tảng khác.

Câu hỏi thường gặp

Tôi tìm tệp khóa tài khoản dịch vụ ở đâu?

Trong bảng điều khiển Firebase: Project settings → Service accounts → Generate new private key. Dán toàn bộ tệp JSON vào Tệp khóa tài khoản dịch vụ.

Tôi có thể chỉ dùng Firebase cho thông báo đẩy không?

Được. Kết nối Firebase không chuyển dữ liệu của bạn. Ứng dụng vẫn dùng cơ sở dữ liệu của MonstarX, trừ khi bạn chọn Firestore trong Nơi ứng dụng này lưu dữ liệu.

Nếu tôi chuyển sang Firestore, người dùng có cần tài khoản mới không?

Không. Tài khoản vẫn nằm trong cơ sở dữ liệu MonstarX và đăng nhập vẫn hoạt động như trước. Chỉ dữ liệu riêng của ứng dụng được chuyển sang Firestore.

Màn hình ghi “chưa có cơ sở dữ liệu Firestore”. Có sao không?

Chỉ khi bạn muốn dùng Firestore. Kết nối vẫn thành công, vì có thể ứng dụng chỉ cần lưu trữ, đăng nhập hoặc thông báo đẩy. Hãy tạo cơ sở dữ liệu Firestore trong bảng điều khiển Firebase để dùng.

Sao chép dữ liệu có xóa gì không?

Không. Sao chép dữ liệu hiện có chỉ thêm hoặc cập nhật tài liệu trong Firestore. Cơ sở dữ liệu của MonstarX vẫn giữ nguyên.

Liên quan

SupabaseLưu dữ liệu trong Postgres của riêng bạn thay thế.

Cơ sở dữ liệu của ứng dụngCơ sở dữ liệu mà mọi ứng dụng có từ đầu.

Trình kết nốiMọi dịch vụ ứng dụng có thể kết nối.

Tài khoản người dùngĐăng ký và đăng nhập hoạt động thế nào trong ứng dụng.