获取我们在 Firebase 峰会上发布的所有信息,了解 Firebase 可如何帮助您加快应用开发速度并满怀信心地运行应用。了解详情

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

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

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


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

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

ก่อนจะเริ่ม

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

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

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

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

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

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

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

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

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

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

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

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

    firebase ext:info publisher-id/extension-id

    อาร์กิวเมนต์รหัส publisher-id extension-id จำเป็น และสามารถพบได้ใน หน้ารายละเอียดการติดตั้งล่วงหน้าของส่วนขยาย

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

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

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

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

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

    อาร์กิวเมนต์รหัส publisher-id extension-id จำเป็น และสามารถพบได้ใน หน้ารายละเอียดการติดตั้งล่วงหน้าของส่วนขยาย

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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