Dịch vụ Lưu trữ Firebase đặt trước các URL trên trang web của bạn bắt đầu bằng /__. Chiến dịch này
không gian tên dành riêng 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
Lưu trữ Firebase.
Các URL đặt trước này có sẵn cả khi bạn triển khai Firebase
(firebase deploy) hoặc khi bạn chạy ứng dụng trên máy chủ cục bộ
(firebase serve).
Thêm tập lệnh cho các URL đặt trước
Vì tính năng Lưu trữ Firebase được phân phát qua HTTP/2 khi triển khai, nên bạn có thể tăng bằng cách tải các tệp từ cùng một nguồn gốc. Dịch vụ Lưu trữ Firebase 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 chỉ nên tải các thư viện
mà bạn dùng trong ứng dụng. Ví dụ: để chỉ bao gồm phần Xác thực và
Cloud Firestore, hãy thêm các tập lệnh sau vào cuối <body> của bạn
nhưng trước khi bạn sử dụng bất kỳ dịch vụ Firebase nào:
<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
Cấu hình SDK tự động giúp bạn dễ dàng quản lý nhiều môi trường (chẳng hạn như làm nhà phát triển, thử nghiệm và phát hành chính thức) từ một cơ sở mã duy nhất. Bằng cách dựa vào URL lưu trữ đặt trước, bạn có thể triển khai cùng một mã cho nhiều Firebase dự án.
Ngoài việc tự lưu trữ 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 Firebase dự án liên kết với trang web Lưu trữ. Cấu hình Firebase này và Quá trình khởi chạy SDK do một tập lệnh mà bạn có thể trực tiếp đưa vào:
<!-- Load the Firebase SDKs before loading this file -->
<script src="/__/firebase/init.js"></script>
Khi bạn triển khai cho Firebase hoặc thử nghiệm ứng dụng cục bộ, tập lệnh này sẽ tự động định cấu hình Firebase JavaScript SDK 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 việc khởi chạy, cấu hình Firebase các giá trị cũng có sẵn ở dạng JSON:
fetch('/__/firebase/init.json').then(async response => {
firebase.initializeApp(await response.json());
});
Firebase JS SDK có sẵn (từ các URL lưu trữ đặt trước)
| Sản phẩm của 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> |
| Số liệu phân tích | <script src="/__/firebase/8.10.1/firebase-analytics.js"></script> |
| Kiểm tra ứng dụng | <script src="/__/firebase/8.10.1/firebase-app-check.js"></script> |
| Xác thực | <script src="/__/firebase/8.10.1/firebase-auth.js"></script> |
| Cloud Firestore | <script src="/__/firebase/8.10.1/firebase-firestore.js"></script> |
| SDK ứng dụng Hàm đám mây dành cho Firebase | <script src="/__/firebase/8.10.1/firebase-functions.js"></script> |
| Cài đặt Firebase | <script src="/__/firebase/8.10.1/firebase-installations.js"></script> |
| Giải pháp gửi thông báo qua đám mây | <script src="/__/firebase/8.10.1/firebase-messaging.js"></script> Để có trải nghiệm tối ưu khi sử dụng Giải pháp gửi thông báo qua đám mây, hãy thêm cả Firebase SDK cho Analytics. |
| Bộ nhớ trên đám mây | <script src="/__/firebase/8.10.1/firebase-storage.js"></script> |
|
Giám sát hiệu suất
(bản phát hành beta) |
<script src="/__/firebase/8.10.1/firebase-performance.js"></script> |
| Cơ sở dữ liệu theo thời gian thực | <script src="/__/firebase/8.10.1/firebase-database.js"></script> |
| Cấu hình từ xa
(bản phát hành beta) |
<script src="/__/firebase/8.10.1/firebase-remote-config.js"></script> Để có trải nghiệm tối ưu khi sử dụng Cấu hình từ xa, hãy thêm cả Firebase SDK cho Analytics. |
| Firebase JavaScript SDK (toàn bộ SDK) |
<script src="/__/firebase/8.10.1/firebase.js"></script> |
Trình trợ giúp xác thực
Xác thực Firebase sử dụng miền dành riêng để cung cấp JavaScript và HTML đặc biệt nhằm hoàn tất việc xác thực với qua OAuth. Điều này cho phép mỗi dự án Firebase có một giá trị riêng biệt Miền con Firebase, tăng độ bảo mật của Xác thực Firebase.
Ngoài ra, việc này cho phép bạn sử dụng miền tuỳ chỉnh của riêng mình cho authDomain
có giá trị là firebase.initializeApp(). Nếu bạn
định cấu hình miền tuỳ chỉnh
cho Lưu trữ Firebase, thì bạn cũng có thể chỉ định miền tùy chỉnh đó (thay vào đó
của miền con web.app hoặc firebaseapp.com) khi khởi chạy Firebase
SDK. Xem
Các phương pháp hay nhất để sử dụng signInWith chuyển hướng
để biết thêm chi tiết về việc sử dụng miền tuỳ chỉnh.
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 dịch vụ có một trình thực thi "điều hướng dự phòng" và hiển thị một URL cụ thể theo mặc định nếu không khớp với danh sách các mục được lưu trước trong bộ nhớ đệm.
Nếu bạn đang sử dụng bộ nhớ đệm trước sw thư viện, bạn có thể thêm cài đặt danh sách trắng dự phòng điều hướng loại trừ không gian tên dành riêng:
{
navigateFallbackWhitelist: [/^(?!\/__).*/]
}
Nói chung, chỉ cần nhớ rằng không gian tên dấu 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 dịch vụ của mình .