หน้านี้ได้รับการแปลโดย Cloud Translation API
Switch to English

โหลด Firebase SDK จาก URL ที่สงวนไว้

Firebase Hosting ขอสงวน URL ในไซต์ของคุณที่ขึ้นต้นด้วย /__ เนมสเปซที่สงวนไว้นี้ช่วยให้ใช้ผลิตภัณฑ์ Firebase อื่น ๆ ร่วมกับ Firebase Hosting ได้ง่ายขึ้น

URL ที่สงวนไว้เหล่านี้พร้อมใช้งานทั้งเมื่อคุณปรับใช้กับ Firebase (การ firebase deploy ) หรือเมื่อคุณเรียกใช้แอปของคุณบนเซิร์ฟเวอร์ภายใน ( firebase serve )

เพิ่มสคริปต์สำหรับ URL ที่สงวนไว้

เนื่องจาก Firebase Hosting ให้บริการผ่าน HTTP / 2 เมื่อทำให้ใช้งานได้คุณจึงเพิ่มประสิทธิภาพได้โดยการโหลดไฟล์จากต้นทางเดียวกัน Firebase Hosting ให้บริการ Firebase JavaScript SDK ทุกเวอร์ชันจาก URL พิเศษที่มีรูปแบบดังนี้:

/__/firebase/JS_SDK_VERSION/FIREBASE_SDK_NAME.js

เราขอแนะนำอย่างยิ่งให้โหลดเฉพาะ ไลบรารี ที่คุณใช้ในแอปของคุณ ตัวอย่างเช่นหากต้องการรวมเฉพาะ Authentication และ Cloud Firestore ให้เพิ่มสคริปต์ต่อไปนี้ที่ด้านล่างของแท็ก <body> แต่ก่อนที่คุณจะใช้บริการ 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/7.21.0/firebase-app.js"></script>

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

การกำหนดค่าอัตโนมัติ SDK

การกำหนดค่า SDK อัตโนมัติทำให้ง่ายต่อการจัดการสภาพแวดล้อมที่หลากหลาย (เช่น dev, staging และ production) จาก codebase เดียว ด้วยการใช้ URL ของโฮสติ้งที่สงวนไว้คุณสามารถใช้รหัสเดียวกันกับโครงการ Firebase หลายโครงการได้

นอกเหนือจากการโฮสต์ SDK ด้วยตนเองแล้วเนมสเปซที่สงวนไว้ยังมีการกำหนดค่าทั้งหมดที่จำเป็นในการเริ่มต้น SDK สำหรับโครงการ Firebase ที่เชื่อมโยงกับไซต์โฮสติ้ง การกำหนดค่า Firebase และการเริ่มต้น SDK จัดทำโดยสคริปต์ที่คุณสามารถรวมได้โดยตรง:

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

เมื่อคุณปรับใช้กับ Firebase หรือทดสอบแอปในเครื่องสคริปต์นี้จะกำหนดค่า Firebase JavaScript SDK สำหรับ โครงการ Firebase ที่ใช้งานอยู่ โดยอัตโนมัติและเริ่มต้น SDK

หากคุณต้องการควบคุมการเริ่มต้นด้วยตนเองค่าการกำหนดค่า Firebase ก็มีให้ในรูปแบบ JSON เช่นกัน:

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

Firebase JS SDK ที่พร้อมใช้งาน (จาก Hosting URL ที่สงวนไว้)

ผลิตภัณฑ์ Firebase การอ้างอิงไลบรารี (URL ที่สงวนไว้)
แกน Firebase
(จำเป็น)
<script src="/__/firebase/7.21.0/firebase-app.js"></script>
การวิเคราะห์
<script src="/__/firebase/7.21.0/firebase-analytics.js"></script>
การรับรองความถูกต้อง พ่อ 7772517
Cloud Firestore
<script src="/__/firebase/7.21.0/firebase-firestore.js"></script>
Cloud Functions สำหรับ Firebase Client SDK
<script src="/__/firebase/7.21.0/firebase-functions.js"></script>
การส่งข้อความบนคลาวด์
<script src="/__/firebase/7.21.0/firebase-messaging.js"></script>

เพื่อประสบการณ์ที่ดีที่สุดในการใช้ Cloud Messaging ให้เพิ่ม Firebase SDK สำหรับ Analytics

การจัดเก็บเมฆ
<script src="/__/firebase/7.21.0/firebase-storage.js"></script>
การตรวจสอบประสิทธิภาพ
( รุ่นเบต้า )
<script src="/__/firebase/7.21.0/firebase-performance.js"></script>
ฐานข้อมูลเรียลไทม์
<script src="/__/firebase/7.21.0/firebase-database.js"></script>
การกำหนดค่าระยะไกล
( รุ่นเบต้า )
<script src="/__/firebase/7.21.0/firebase-remote-config.js"></script>

เพื่อประสบการณ์ที่ดีที่สุดในการใช้การกำหนดค่าระยะไกลให้เพิ่ม Firebase SDK สำหรับ Analytics

Firebase JavaScript SDK
(SDK ทั้งหมด)
<script src="/__/firebase/7.21.0/firebase.js"></script>

ผู้ช่วยรับรองความถูกต้อง

การตรวจสอบสิทธิ์ Firebase ใช้เนมสเปซที่สงวนไว้เพื่อจัดเตรียม JavaScript และ HTML พิเศษเพื่อทำการตรวจสอบสิทธิ์กับผู้ให้บริการผ่าน OAuth ซึ่งช่วยให้โครงการ Firebase แต่ละโครงการมีโดเมนย่อย Firebase ที่ไม่ซ้ำกันซึ่งช่วยเพิ่มความปลอดภัยในการตรวจสอบสิทธิ์ Firebase

นอกจากนี้สิ่งนี้ช่วยให้คุณสามารถใช้โดเมนที่คุณกำหนดเองสำหรับตัวเลือก authDomain firebase.initializeApp() หากคุณ กำหนดค่าโดเมนที่กำหนดเอง สำหรับ Firebase โฮสติ้งแล้วคุณยังสามารถระบุโดเมนที่กำหนดเองว่า (แทนของคุณ web.app หรือ firebaseapp.com โดเมนย่อย) เมื่อการเริ่มต้น Firebase SDKs

URL ที่สงวนไว้และผู้ให้บริการ

หากคุณกำลังสร้าง Progressive Web App (PWA) คุณอาจสร้างผู้ให้บริการที่มี "ทางเลือกการนำทาง" และแสดง URL ที่เฉพาะเจาะจงตามค่าเริ่มต้นหากไม่ตรงกับรายการที่กำหนดไว้ล่วงหน้า

หากคุณกำลังใช้ไลบรารี sw-precache คุณสามารถเพิ่มการตั้งค่ารายการที่อนุญาตพิเศษสำหรับการนำทางซึ่งไม่รวมเนมสเปซที่สงวนไว้:

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

โดยทั่วไปโปรดจำไว้ว่าเนมสเปซขีดล่างสองขีดสงวนไว้สำหรับการใช้งาน Firebase และคุณไม่ควรสกัดกั้นคำขอเหล่านี้ในเจ้าหน้าที่บริการของคุณ