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

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

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