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

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

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



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

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

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

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

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

ขั้นตอนนี้เป็นขั้นตอนที่ไม่บังคับ แต่ขอแนะนำอย่างยิ่ง

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

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

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

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

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

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

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

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

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