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

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

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



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

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

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

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

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

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

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