If you are building server-rendered Angular or Next.js apps, check out next-generation Firebase App Hosting, a full-stack solution for modern web frameworks.

Tải Firebase SDK từ các URL đặt trước

Firebase Hosting dành riêng các URL trong trang web của bạn bắt đầu bằng /__. Không gian tên dành riêng này giúp bạn dễ dàng sử dụng các sản phẩm khác của Firebase cùng với Firebase Hosting.

Các URL dành riêng này có sẵn khi bạn triển khai lên Firebase (firebase deploy) hoặc khi bạn chạy ứng dụng trên một máy chủ cục bộ (firebase serve).

Thêm tập lệnh cho các URL dành riêng

Vì Firebase Hosting được phân phát qua HTTP/2 khi triển khai, nên bạn có thể tăng hiệu suất bằng cách tải các tệp từ cùng một nguồn gốc. Firebase Hosting phân phát phiên bản 8 của Firebase JavaScript SDK từ các URL đặc biệt được định dạng như sau:

/__/firebase/JS_SDK_VERSION/FIREBASE_SDK_NAME.js

Bạn nên chỉ tải những thư viện mà bạn sử dụng trong ứng dụng. Ví dụ: để chỉ đưa Authentication và Cloud Firestore vào, hãy thêm các tập lệnh sau vào cuối thẻ <body> , nhưng trước khi bạn sử dụng bất kỳ dịch vụ nào của Firebase:

<body>
  <!-- Insert these scripts at the bottom of the HTML, but before you use any Firebase services -->
  <!-- Firebase App (the core Firebase SDK) is always required and must be listed first -->
  <script src="/__/firebase/8.10.1/firebase-app.js"></script>

  <!-- Add Firebase products that you want to use -->
  <script src="/__/firebase/8.10.1/firebase-auth.js"></script>
  <script src="/__/firebase/8.10.1/firebase-firestore.js"></script>
</body>

Tự động định cấu hình SDK

Tính năng tự động định cấu hình SDK giúp bạn dễ dàng quản lý nhiều môi trường (chẳng hạn như môi trường phát triển, thử nghiệm và sản xuất) từ một cơ sở mã duy nhất. Bằng cách dựa vào URL dành riêng Hosting, bạn có thể triển khai cùng một mã cho nhiều dự án Firebase.

Ngoài việc lưu trữ chính các SDK, không gian tên dành riêng còn cung cấp tất cả cấu hình cần thiết để khởi chạy SDK cho dự án Firebase được liên kết với trang web Hosting. Cấu hình Firebase và quá trình khởi chạy SDK này được cung cấp bởi một tập lệnh mà bạn có thể đưa vào trực tiếp:

<!-- Load the Firebase SDKs before loading this file -->
<script src="/__/firebase/init.js"></script>

Khi bạn triển khai lên Firebase hoặc kiểm thử ứng dụng của mình cục bộ, tập lệnh này sẽ tự động định cấu hình SDK Firebase JavaScript cho dự án Firebase đang hoạt động và khởi chạy SDK.

Nếu bạn muốn tự kiểm soát quá trình khởi chạy, thì các giá trị cấu hình Firebase cũng có ở dạng JSON:

fetch('/__/firebase/init.json').then(async response => {
  firebase.initializeApp(await response.json());
});

Các SDK Firebase JS hiện có (từ các URL Hosting dành riêng)

Sản phẩm Firebase	Tài liệu tham khảo về thư viện (URL dành riêng)
Firebase core (bắt buộc)	<script src="/__/firebase/8.10.1/firebase-app.js"></script>
Analytics	<script src="/__/firebase/8.10.1/firebase-analytics.js"></script>
App Check	<script src="/__/firebase/8.10.1/firebase-app-check.js"></script>
Authentication	<script src="/__/firebase/8.10.1/firebase-auth.js"></script>
Cloud Firestore	<script src="/__/firebase/8.10.1/firebase-firestore.js"></script>
Cloud Functions for Firebase Client SDK	<script src="/__/firebase/8.10.1/firebase-functions.js"></script>
Firebase installations	<script src="/__/firebase/8.10.1/firebase-installations.js"></script>
Cloud Messaging	<script src="/__/firebase/8.10.1/firebase-messaging.js"></script> Để có trải nghiệm tối ưu khi sử dụng Cloud Messaging, hãy thêm SDK Firebase cho Analytics.
Cloud Storage	<script src="/__/firebase/8.10.1/firebase-storage.js"></script>
Performance Monitoring (phiên bản beta)	<script src="/__/firebase/8.10.1/firebase-performance.js"></script>
Realtime Database	<script src="/__/firebase/8.10.1/firebase-database.js"></script>
Remote Config (phiên bảnbeta)	<script src="/__/firebase/8.10.1/firebase-remote-config.js"></script> Để có trải nghiệm tối ưu khi sử dụng Remote Config, hãy thêm SDK Firebase cho Analytics.
Firebase JavaScript SDK (toàn bộ SDK)	<script src="/__/firebase/8.10.1/firebase.js"></script>

Trợ giúp xác thực

Firebase Authentication sử dụng không gian tên dành riêng để cung cấp JavaScript và HTML đặc biệt nhằm hoàn tất quá trình xác thực với các nhà cung cấp thông qua OAuth. Điều này cho phép mỗi dự án Firebase có một miền con Firebase duy nhất, giúp tăng tính bảo mật của Firebase Authentication.

Ngoài ra, điều này cho phép bạn sử dụng miền tuỳ chỉnh của riêng mình cho tuỳ chọn authDomain của firebase.initializeApp(). Nếu bạn định cấu hình một miền tuỳ chỉnh cho Firebase Hosting, thì bạn cũng có thể chỉ định miền tuỳ chỉnh đó (thay vì miền con web.app hoặc firebaseapp.com) khi khởi chạy các SDK Firebase. Hãy xem bài viết Các phương pháp hay nhất để sử dụng signInWithRedirect để biết thêm thông tin về cách sử dụng miền tuỳ chỉnh.

Các URL dành riêng và trình chạy dịch vụ

Nếu đang tạo một Ứng dụng web tiến bộ (PWA), bạn có thể tạo một trình chạy dịch vụ có "phương án dự phòng điều hướng" và hiển thị một URL cụ thể theo mặc định nếu URL đó không khớp với danh sách các mục được lưu vào bộ nhớ đệm trước.

Nếu đang sử dụng thư viện sw-precache, bạn có thể thêm chế độ cài đặt danh sách cho phép phương án dự phòng điều hướng để loại trừ không gian tên dành riêng:

{
  navigateFallbackWhitelist: [/^(?!\/__).*/]
}

Nói chung, bạn chỉ cần nhớ rằng không gian tên gạch dưới kép được dành riêng cho việc sử dụng Firebase và bạn không nên chặn các yêu cầu này trong trình chạy dịch vụ.