Catch up on highlights from Firebase at Google I/O 2023. Learn more

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

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

อย่าลืมตรวจสอบ ความแตกต่าง ในการดำเนินการที่รองรับสำหรับคอนโซล Firebase CLI และ Firebase


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

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

ก่อนที่คุณจะเริ่มต้น

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

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

ขั้นตอนนี้เป็นทางเลือก แต่แนะนำอย่างยิ่ง

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

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

หากต้องการดูข้อมูลโดยละเอียดของส่วนขยาย:

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

  2. คลิกการ์ดของส่วนขยายเพื่อ:

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

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

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

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

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

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

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

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

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

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

สร้างตัวจัดการเหตุการณ์ Eventarc

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

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

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

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

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

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