ติดตั้งส่วนขยาย Firebase

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

อย่าลืมตรวจสอบความแตกต่างของการดำเนินการที่รองรับสำหรับวิธีการติดตั้งแต่ละวิธี



หากต้องการติดตั้งหรือจัดการส่วนขยาย คุณต้องได้รับมอบหมายบทบาทใดบทบาทหนึ่งต่อไปนี้: เจ้าของ หรือผู้แก้ไข หรือ ผู้ดูแลระบบ Firebase

หากต้องการติดตั้งส่วนขยาย โปรเจ็กต์ของคุณต้องใช้แพ็กเกจ Blaze (จ่ายตามการใช้งาน) แม้ว่าจะไม่มีค่าใช้จ่ายในการติดตั้งส่วนขยาย แต่คุณอาจถูกเรียกเก็บเงินสำหรับการใช้บริการ Firebase หรือบริการคลาวด์ เช่น Cloud Secret Manager หากการใช้งานของคุณเกินขีดจำกัดการใช้งานฟรีของบริการ

ก่อนเริ่มต้น

เพิ่ม Firebase ลงในโปรเจ็กต์และอัปเกรดโปรเจ็กต์ Firebase เป็นแพ็กเกจ Blaze (จ่ายตามการใช้งาน) หากยังไม่ได้ดำเนินการ

ขั้นตอนที่ 1: ดูข้อมูลโดยละเอียดเกี่ยวกับส่วนขยาย

ขั้นตอนนี้ไม่บังคับ แต่ขอแนะนำให้ทำ

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

  • วิธีทำงานของส่วนขยาย งานก่อนการติดตั้ง และรายละเอียดเกี่ยวกับส่วนขยาย
  • ข้อมูลระบุตัวบุคคลทั่วไปและคำอธิบาย
  • งานของส่วนขยายต้องใช้บัญชีสำหรับการเรียกเก็บเงินหรือไม่
  • บริการ (API) ของ Google และ บทบาทการเข้าถึงที่จำเป็นสำหรับ การดำเนินการ
  • ทรัพยากรที่สร้างขึ้น สำหรับส่วนขยาย (เช่น ฟังก์ชัน)
  • คำอธิบายพารามิเตอร์ที่ผู้ใช้กำหนดค่าได้

วิธีดูข้อมูลโดยละเอียดของส่วนขยาย

  1. เรียกดูส่วนขยาย Firebase อย่างเป็นทางการใน Extensions Hub

  2. คลิกการ์ดของส่วนขยายเพื่อดำเนินการต่อไปนี้

ขั้นตอนที่ 2: ติดตั้งส่วนขยาย

ในระหว่างกระบวนการติดตั้ง ระบบจะแจ้งให้คุณตรวจสอบข้อกำหนดพื้นฐาน ของส่วนขยาย (เช่น API ที่เปิดใช้, ทรัพยากรที่สร้างขึ้น, สิทธิ์เข้าถึงที่ได้รับ ฯลฯ) ระบบจะแจ้งให้คุณทราบข้อกำหนดในการเรียกเก็บเงิน และจะแจ้งให้คุณระบุค่าสำหรับพารามิเตอร์ที่กำหนดค่าได้ของส่วนขยายด้วย

  1. เรียกดูส่วนขยาย Firebase อย่างเป็นทางการใน Extensions Hub

  2. คลิกการ์ดของส่วนขยาย จากนั้นดูข้อมูลโดยละเอียดของส่วนขยาย ซึ่งอาจมีวิธีการใช้งานที่เฉพาะเจาะจงและงานก่อนการติดตั้ง

  3. คลิกติดตั้ง แล้วทำตามวิธีการบนหน้าจอเพื่อติดตั้ง ส่วนขยาย

ขั้นตอนที่ 3: ตั้งค่าหลังการติดตั้งให้เสร็จสมบูรณ์

ส่วนขยายบางรายการมีขั้นตอนที่จำเป็นหรือขั้นตอนที่ไม่บังคับให้คุณดำเนินการให้เสร็จสมบูรณ์ก่อนใช้งาน ดูวิธีการเหล่านี้ได้ในหน้ารายละเอียดหลังการติดตั้งของส่วนขยายใน แดชบอร์ดExtensionsของคอนโซลFirebase (ลิงก์ที่เฉพาะเจาะจงไปยัง แดชบอร์ดจะแสดงในเทอร์มินัลหลังการติดตั้ง)

นอกจากนี้ คุณยังดูวิธีการเหล่านี้ได้ในไฟล์ POSTINSTALL.md ที่รวมอยู่ใน ไดเรกทอรีต้นทางของส่วนขยาย

สร้างทรัพยากร Firebase

หากคุณกำหนดค่าส่วนขยายให้ใช้ทรัพยากร Firebase (Cloud Firestore คอลเล็กชัน, Realtime Database เส้นทาง, Cloud Storage บัคเก็ต) ที่ยังไม่มีอยู่ ให้สร้างทรัพยากรเหล่านั้นก่อนใช้ส่วนขยาย

สร้างตัวแฮนเดิลเหตุการณ์ Eventarc

ส่วนขยายบางรายการจะเผยแพร่ไปยัง Eventarc เมื่อมีเหตุการณ์สำคัญเกิดขึ้นระหว่างการดำเนินการ หากส่วนขยายเผยแพร่เหตุการณ์และคุณเปิดใช้เหตุการณ์ระหว่างการติดตั้ง คุณสามารถเขียนฟังก์ชันที่ตอบสนองต่อเหตุการณ์เหล่านี้ด้วยตรรกะที่กำหนดเอง ซึ่งอาจมีประโยชน์ เช่น เพื่อแจ้งให้ผู้ใช้ทราบเมื่อมีการทำงานที่ใช้เวลานานเสร็จสมบูรณ์ หรือเพื่อประมวลผลเอาต์พุตของฟังก์ชันส่วนขยาย

ดูรายการเหตุการณ์ (หากมี) ที่ส่วนขยายเผยแพร่ได้ในเอกสารประกอบของส่วนขยาย ตัวอย่างเช่น ดูประเภทเหตุการณ์สำหรับส่วนขยาย Run Payments with Stripe

จากนั้นดูทริกเกอร์เหตุการณ์ที่กำหนดเองสำหรับ ข้อมูลเกี่ยวกับการเขียนตัวแฮนเดิลเหตุการณ์ Eventarc

ติดตั้งอินสแตนซ์ของส่วนขยายหลายรายการ

คุณสามารถติดตั้งส่วนขยายเดียวกันมากกว่า 1 ครั้งในโปรเจ็กต์เดียวกัน อินสแตนซ์ที่ติดตั้งแต่ละรายการสามารถมีการกำหนดค่าที่ปรับแต่งเองและทรัพยากรส่วนขยายของตัวเอง คุณระบุและอ้างอิงอินสแตนซ์ที่ติดตั้งแต่ละรายการโดยใช้ รหัสอินสแตนซ์ ซึ่งไม่ซ้ำกันภายในโปรเจ็กต์

ระบบจะแจ้งให้คุณยืนยันหรือแก้ไขรหัสอินสแตนซ์ของอินสแตนซ์เพิ่มเติมแต่ละรายการของส่วนขยายที่คุณติดตั้ง

ขั้นตอนถัดไป