Firebase is back at Google I/O on May 10! Register now

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

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

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

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


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

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

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

  1. หากคุณยังไม่ได้ ดำเนินการ ให้เพิ่ม Firebase ในโครงการของคุณ

  2. หากคุณยังไม่ได้อัปเกรดโปรเจ็กต์ของคุณเป็นแผน Blaze (จ่ายตามการใช้งาน)

  3. ติดตั้งหรืออัปเดต Firebase CLI เป็นเวอร์ชันล่าสุด

  4. จดรหัสโปรเจ็กต์ Firebase หรือชื่อแทนโปรเจ็กต์ที่กำหนดค่าไว้ก่อนหน้านี้

    • รหัสโครงการ — เรียกใช้ firebase projects:list จากที่ใดก็ได้บนคอมพิวเตอร์ของคุณ
    • Project alias — เรียกใช้ firebase use จากไดเร็กทอรีแอปในเครื่องของคุณ

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

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

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

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

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

  1. ตรวจสอบให้แน่ใจว่าคุณได้ ตั้งค่าสภาพแวดล้อม และ เลือกส่วนขยาย

  2. เรียกใช้คำสั่งข้อมูลส่วนขยายจากที่ใดก็ได้บนคอมพิวเตอร์ของคุณ:

    firebase ext:info publisher-id/extension-id

    ต้องระบุอาร์กิวเมนต์ publisher-id และ extension-id และดูได้จาก หน้ารายละเอียดการติดตั้งล่วงหน้าของส่วนขยาย

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

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

  1. ตรวจสอบให้แน่ใจว่าคุณได้ ตั้งค่าสภาพแวดล้อม และ เลือกส่วนขยาย

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

    firebase ext:install publisher-id/extension-id --project=projectId-or-alias

    ต้องระบุอาร์กิวเมนต์ publisher-id และ extension-id และดูได้จาก หน้ารายละเอียดการติดตั้งล่วงหน้าของส่วนขยาย

    การเรียกใช้คำสั่งนี้จะเพิ่มอินสแตนซ์ของส่วนขยายไปยัง รายการส่วนขยาย ของคุณ

  3. จากนั้น หากต้องการปรับใช้ส่วนขยายในไฟล์ Manifest ของคุณกับโปรเจ็กต์ Firebase ให้เรียกใช้:

    firebase deploy --only extensions --project=projectId-or-alias

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

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

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

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

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

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

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

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

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

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

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

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

  • ดูรายละเอียดและการกำหนดค่า ส่วนขยายที่ติดตั้งในคอนโซล Firebase

  • ตรวจสอบกิจกรรม ของส่วนขยายที่คุณติดตั้ง รวมถึงการตรวจสอบความสมบูรณ์ การใช้งาน และบันทึก

  • ใช้ Firebase CLI จัดการ ส่วนขยายที่ติดตั้ง คุณสามารถกำหนดค่าใหม่หรือถอนการติดตั้งส่วนขยายของคุณ รวมทั้งอัปเดตส่วนขยายของคุณเป็นเวอร์ชันล่าสุด

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

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