คุณสามารถติดตั้ง (และ จัดการ ) ส่วนขยาย Firebase อย่างเป็นทางการใดก็ได้โดยใช้คอนโซล Firebase หรือ Firebase CLI (อินเทอร์เฟซบรรทัดคำสั่ง)
อย่าลืมตรวจสอบความ แตกต่าง ในการดำเนินการที่รองรับสำหรับคอนโซล Firebase CLI และ Firebase
ในการติดตั้งหรือจัดการส่วนขยาย คุณต้องได้รับมอบหมายหนึ่งในบทบาทเหล่านี้: เจ้าของหรือผู้แก้ไข หรือผู้ ดูแลระบบ Firebase
ในการติดตั้งส่วนขยาย โปรเจ็กต์ของคุณต้องอยู่ในแผน Blaze (จ่ายตามการใช้งาน) แม้ว่าจะไม่มีค่าใช้จ่ายสำหรับการติดตั้งส่วนขยาย แต่คุณอาจถูกเรียกเก็บเงินสำหรับการใช้บริการ Firebase หรือบริการ Cloud เช่น [Cloud Secret Manager][secret-pricing] หากการใช้งานของคุณเกินระดับฟรีของบริการ
ก่อนจะเริ่ม
หากคุณยังไม่ได้ดำเนินการ ให้ เพิ่ม Firebase ในโครงการของคุณ และอัปเกรดโปรเจ็กต์ Firebase เป็นแผน Blaze (จ่ายตามการใช้งาน)
ขั้นตอนที่ 1 : ดูข้อมูลโดยละเอียดเกี่ยวกับส่วนขยาย
ขั้นตอนนี้เป็นทางเลือก แต่ขอแนะนำอย่างยิ่ง
ก่อนติดตั้งส่วนขยาย Firebase เราขอแนะนำให้คุณตรวจสอบข้อมูลโดยละเอียดเกี่ยวกับส่วนขยาย ได้แก่
- วิธีการทำงานของส่วนขยาย งานก่อนการติดตั้ง และรายละเอียดเกี่ยวกับส่วนขยาย
- ข้อมูลการระบุและคำอธิบายทั่วไป
- งานของส่วนขยายต้องมีบัญชีสำหรับการเรียกเก็บเงินหรือไม่
- บริการของ Google (API) และ บทบาทการเข้าถึง ที่จำเป็นสำหรับการดำเนินการ
- ทรัพยากร ที่สร้างขึ้นสำหรับส่วนขยาย (เช่น ฟังก์ชัน)
- คำอธิบายของพารามิเตอร์ที่ผู้ใช้กำหนดค่าได้
หากต้องการดูข้อมูลโดยละเอียดของส่วนขยาย:
เรียกดูส่วนขยาย Firebase อย่างเป็นทางการจากแหล่งที่มาต่อไปนี้:
- หน้าผลิตภัณฑ์ Firebase Extensions
- แดชบอร์ด Firebase Extensions ในคอนโซล Firebase
คลิกการ์ดของส่วนขยายเพื่อ:
แสดงข้อมูลโดยละเอียดสำหรับส่วนขยาย
ค้นหาลิงก์ไปยังซอร์สโค้ดของส่วนขยายใน ที่เก็บซอร์สของ Firebase Extensions
ใน ไดเร็กทอรีส่วนขยาย ของส่วนขยาย คุณสามารถดูข้อมูลโดยละเอียดใน
README
ขั้นตอนที่ 2 : ติดตั้งส่วนขยาย
ในระหว่างขั้นตอนการติดตั้ง คุณจะได้รับแจ้งให้ตรวจสอบข้อกำหนดพื้นฐานสำหรับส่วนขยาย (เช่น เปิดใช้งาน API ทรัพยากรที่ สร้าง อนุญาต การเข้าถึง ฯลฯ) คุณจะได้รับแจ้งข้อกำหนดในการเรียกเก็บเงิน และคุณยังจะได้รับแจ้งให้ระบุค่าสำหรับพารามิเตอร์ที่กำหนดค่าได้ของส่วนขยายด้วย
เรียกดูส่วนขยาย Firebase อย่างเป็นทางการจากแหล่งที่มาต่อไปนี้:
- หน้าผลิตภัณฑ์ Firebase Extensions
- แดชบอร์ด Firebase Extensions ในคอนโซล Firebase
คลิกการ์ดของส่วนขยาย จากนั้นตรวจสอบข้อมูลโดยละเอียดสำหรับส่วนขยาย ซึ่งสามารถให้คำแนะนำการใช้งานเฉพาะและงานก่อนการติดตั้งใดๆ
คลิก ติดตั้ง จากนั้นทำตามคำแนะนำบนหน้าจอเพื่อติดตั้งส่วนขยาย
ขั้นตอนที่ 3 : ตั้งค่าหลังการติดตั้งให้เสร็จสิ้น
ส่วนขยายบางรายการมีข้อกำหนดหรือขั้นตอนเพิ่มเติมเพื่อให้คุณดำเนินการให้เสร็จสิ้นก่อนใช้งาน ค้นหาคำแนะนำเหล่านี้ในหน้ารายละเอียดหลังการติดตั้งของส่วนขยายในแดชบอร์ดส่วนขยายของคอนโซล Firebase (ลิงก์เฉพาะไปยังแดชบอร์ดจะแสดงในเทอร์มินัลหลังการติดตั้ง)
คุณยังดูคำแนะนำเหล่านี้ได้ในไฟล์ POSTINSTALL.md
ที่รวมอยู่ใน ไดเรกทอรีต้นทางของส่วนขยาย
สร้างทรัพยากร Firebase
หากคุณกำหนดค่าส่วนขยายให้ใช้ทรัพยากร Firebase (คอลเล็กชัน Cloud Firestore, เส้นทางฐานข้อมูลเรียลไทม์, ที่เก็บข้อมูล Cloud Storage) ที่ยังไม่มีอยู่ ให้สร้างขึ้นก่อนที่จะใช้ส่วนขยาย
สร้างตัวจัดการเหตุการณ์ Eventarc
ส่วนขยายบางรายการจะเผยแพร่ไปยัง Eventarc เมื่อมีเหตุการณ์สำคัญเกิดขึ้นระหว่างการดำเนินการ หากส่วนขยายเผยแพร่เหตุการณ์และคุณเปิดใช้งานกิจกรรมระหว่างการติดตั้ง คุณสามารถเขียนฟังก์ชันที่ตอบสนองต่อเหตุการณ์เหล่านี้ด้วยตรรกะที่คุณกำหนดเอง สิ่งนี้มีประโยชน์ ตัวอย่างเช่น เพื่อแจ้งให้ผู้ใช้ทราบเมื่องานที่ใช้เวลานานเสร็จสมบูรณ์ หรือเพื่อหลังการประมวลผลผลลัพธ์ของฟังก์ชันส่วนขยาย
ดูเอกสารของส่วนขยายสำหรับรายการเหตุการณ์ (ถ้ามี) ที่เผยแพร่
จากนั้น ดู ทริกเกอร์เหตุการณ์ที่กำหนดเอง สำหรับข้อมูลเกี่ยวกับการเขียนตัวจัดการเหตุการณ์ Eventarc
ติดตั้งอินสแตนซ์ส่วนขยายหลายรายการ
คุณสามารถติดตั้งส่วนขยายเดียวกันได้มากกว่าหนึ่งครั้งในโครงการเดียวกัน อินสแตนซ์ที่ติดตั้งแต่ละรายการสามารถมีการกำหนดค่าที่กำหนดเองและทรัพยากรส่วนขยายของตัวเองได้ คุณระบุและอ้างอิงถึงแต่ละอินสแตนซ์ที่ติดตั้งโดยใช้ ID อินสแตนซ์ ซึ่งไม่ซ้ำกันภายในโปรเจ็กต์ของคุณ คุณจะได้รับแจ้งให้ยืนยันหรือแก้ไข ID อินสแตนซ์ของส่วนขยายเพิ่มเติมแต่ละรายการที่คุณติดตั้ง
ขั้นตอนถัดไป
ดูรายละเอียดและการกำหนดค่า ของส่วนขยายที่ติดตั้งในคอนโซล Firebase
ตรวจสอบกิจกรรม ของส่วนขยายที่คุณติดตั้ง รวมถึงตรวจสอบความสมบูรณ์ การใช้งาน และบันทึก
ใช้คอนโซล Firebase จัดการ ส่วนขยายที่ติดตั้งของคุณ สำหรับส่วนขยาย Firebase อย่างเป็นทางการ คุณสามารถกำหนดค่าใหม่หรือถอนการติดตั้งส่วนขยายของคุณ รวมทั้งอัปเดตส่วนขยายเป็นเวอร์ชันล่าสุด
ตามแนวทางปฏิบัติที่ดีที่สุดสำหรับโปรเจ็กต์ทั้งหมด อย่าลืมตั้งค่า การแจ้งเตือนงบประมาณ สำหรับโปรเจ็กต์ของคุณ และตรวจสอบ แดชบอร์ด การใช้งานและการเรียกเก็บเงิน ในคอนโซล Firebase