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

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

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