URL yang Dicadangkan

Firebase Hosting mencadangkan URL di situs Anda yang diawali dengan /__. Namespace yang dicadangkan ini memudahkan penggunaan fitur Firebase lain bersama dengan Firebase Hosting. URL yang dicadangkan ini tersedia ketika digunakan dan saat menjalankan firebase serve secara lokal.

Firebase SDK

Karena Firebase Hosting disajikan melalui HTTP/2 ketika diterapkan, Anda dapat meningkatkan performa dengan memuat file dari asal yang sama. Firebase Hosting melayani semua versi Firebase JS SDK dari URL khusus yang diformat seperti berikut ini:

/__/firebase/{version}/{sdk-file}.js

Kami sangat merekomendasikan agar Anda hanya memuat bagian-bagian SDK yang digunakan. Misalnya, jika Anda menggunakan Firebase Authentication dan Cloud Storage bersama-sama, Anda hanya perlu menyertakan skrip berikut:

<script src="/__/firebase/5.4.1/firebase-app.js"></script>
<script src="/__/firebase/5.4.1/firebase-auth.js"></script>
<script src="/__/firebase/5.4.1/firebase-storage.js"></script>

Semua versi Firebase SDK di-hosting dengan cara ini, dan versi baru akan segera tersedia setelah dirilis.

Konfigurasi otomatis SDK

Selain meng-hosting SDK sendiri, namespace yang dicadangkan juga menyediakan semua konfigurasi yang diperlukan untuk menginisialisasi SDK untuk project yang terkait dengan situs Firebase Hosting. Konfigurasi ini disediakan sebagai skrip yang dapat langsung Anda sertakan:

<!-- load Firebase SDK before loading this file -->
<script src="/__/firebase/init.js"></script>

Skrip ini akan mengonfigurasi aplikasi default Firebase SDK secara otomatis. Jika Anda lebih suka mengontrol inisialisasi sendiri, nilai konfigurasi juga tersedia dalam format JSON:

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

Konfigurasi SDK otomatis memudahkan pengelolaan beberapa lingkungan (seperti pengembangan, penahapan, dan produksi) dari 1 codebase. Dengan mengandalkan URL yang dicadangkan, Anda dapat menerapkan kode yang sama ke beberapa project Firebase.

Penunjang Auth

Firebase Authentication menggunakan namespace yang dicadangkan untuk menyediakan JavaScript dan HTML khusus, guna melengkapi autentikasi dengan penyedia layanan melalui OAuth. Dengan begitu, pelanggan dapat memiliki domain project yang unik, sehingga meningkatkan keamanan Firebase Authentication.

Selain itu, Anda dapat menggunakan domain kustom milik sendiri untuk opsi authDomain dari firebase.initializeApp(). Jika sudah mengonfigurasi domain kustom untuk Firebase Hosting, Anda dapat menetapkan domain tersebut saat menginisialisasi Firebase SDK, bukan subdomain firebaseapp.com.

URL yang Dicadangkan dan pekerja layanan

Jika Anda merancang Progressive Web App, Anda dapat membuat pekerja layanan yang memiliki "fallback navigasi" dan merender URL spesifik secara default jika tidak cocok dengan daftar item yang telah di-cache sebelumnya. Anda harus menonaktifkan fallback untuk namespace /__ agar Firebase Hosting berfungsi dengan baik.

Jika menggunakan library sw-precache, Anda dapat menambahkan setelan fallback navigasi yang diizinkan dan tidak mencakup namespace yang dicadangkan:

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

Secara umum, ingatlah bahwa namespace dengan garis bawah ganda dicadangkan untuk penggunaan Firebase dan Anda tidak boleh menghalangi permintaan ini di pekerja layanan.

Kirim masukan tentang...

Butuh bantuan? Kunjungi halaman dukungan kami.