CLI ในFirebase (GitHub) มอบ มีเครื่องมือที่หลากหลายสำหรับการจัดการ ดู และทำให้ใช้งานได้ในโปรเจ็กต์ Firebase
ก่อนใช้ Firebase CLI สร้างโปรเจ็กต์ Firebase
ตั้งค่าหรืออัปเดต CLI
ติดตั้ง Firebase CLI
คุณติดตั้ง Firebase CLI โดยใช้วิธีการที่ตรงกับการดำเนินการได้
ระบบ ระดับประสบการณ์ และ/หรือกรณีการใช้งาน ไม่ว่าคุณจะติดตั้ง
CLI คุณมีสิทธิ์เข้าถึงฟังก์ชันการทำงานเดียวกันนี้และคำสั่ง firebase
หน้าต่าง
คุณติดตั้ง Firebase CLI สำหรับ Windows ได้โดยใช้รายการใดรายการหนึ่งต่อไปนี้ ตัวเลือก:
ตัวเลือก | คำอธิบาย | แนะนำสำหรับ... |
---|---|---|
ไบนารีแบบสแตนด์อโลน | ดาวน์โหลดไบนารีแบบสแตนด์อโลนสำหรับ CLI จากนั้นคุณสามารถเข้าถึง
ไฟล์ปฏิบัติการเพื่อเปิด Shell ที่คุณสามารถเรียกใช้
คำสั่ง firebase
|
นักพัฒนาซอฟต์แวร์รายใหม่ นักพัฒนาแอปที่ไม่ได้ใช้หรือไม่คุ้นเคยกับ Node.js |
npm | ใช้ npm (ตัวจัดการแพ็กเกจโหนด) เพื่อติดตั้ง CLI และเปิดใช้
คำสั่ง firebase ที่ใช้ได้ทั่วโลก
|
นักพัฒนาแอปที่ใช้ Node.js |
ไบนารีแบบสแตนด์อโลน
หากต้องการดาวน์โหลดและเรียกใช้ไบนารีสำหรับ Firebase CLI ให้ทำตามขั้นตอนต่อไปนี้
ดาวน์โหลด ไบนารี CLI สำหรับ Firebase Windows
เข้าถึงไบนารีเพื่อเปิด Shell ที่คุณเรียกใช้
firebase
ได้ คำสั่ง
npm
วิธีใช้ npm
(ตัวจัดการแพ็กเกจโหนด) เพื่อติดตั้ง
Firebase CLI ให้ทำตามขั้นตอนต่อไปนี้
ติดตั้ง Node.js โดยใช้ NVM-Windows (เครื่องมือจัดการเวอร์ชันของโหนด) การติดตั้ง Node.js จะติดตั้งโดยอัตโนมัติ เครื่องมือคำสั่ง
npm
ติดตั้ง Firebase CLI ผ่าน
npm
โดยเรียกใช้คำสั่งต่อไปนี้npm install -g firebase-tools
คำสั่งนี้จะเป็นการเปิดใช้คำสั่ง
firebase
ที่ใช้ได้ทั่วโลก
macOS หรือ Linux
คุณสามารถติดตั้ง Firebase CLI สำหรับ macOS หรือ Linux ได้โดยใช้ ตัวเลือกต่อไปนี้
ตัวเลือก | คำอธิบาย | แนะนำสำหรับ... |
---|---|---|
สคริปต์การติดตั้งอัตโนมัติ | เรียกใช้คำสั่งเดียวที่ตรวจหาระบบปฏิบัติการของคุณโดยอัตโนมัติ
ดาวน์โหลด CLI รุ่นล่าสุด แล้วเปิดใช้
คำสั่ง firebase
|
นักพัฒนาซอฟต์แวร์รายใหม่ นักพัฒนาแอปที่ไม่ได้ใช้หรือไม่คุ้นเคยกับ Node.js การทำให้ใช้งานได้โดยอัตโนมัติใน CI/CD สภาพแวดล้อม |
ไบนารีแบบสแตนด์อโลน | ดาวน์โหลดไบนารีแบบสแตนด์อโลนสำหรับ CLI จากนั้น คุณจะ กำหนดค่าและเรียกใช้ไบนารีที่เหมาะกับเวิร์กโฟลว์ | เวิร์กโฟลว์ที่ปรับแต่งได้อย่างเต็มรูปแบบโดยใช้ CLI |
npm | ใช้ npm (ตัวจัดการแพ็กเกจโหนด) เพื่อติดตั้ง CLI และเปิดใช้
คำสั่ง firebase ที่ใช้ได้ทั่วโลก
|
นักพัฒนาแอปที่ใช้ Node.js |
สคริปต์การติดตั้งอัตโนมัติ
หากต้องการติดตั้ง Firebase CLI โดยใช้สคริปต์การติดตั้งอัตโนมัติ ให้ทำตาม ขั้นตอนเหล่านี้:
เรียกใช้คำสั่ง cURL ต่อไปนี้
curl -sL https://firebase.tools | bash
สคริปต์นี้จะตรวจจับระบบปฏิบัติการของคุณโดยอัตโนมัติ ดาวน์โหลด Firebase CLI รุ่นล่าสุด จากนั้นก็เปิดใช้เวอร์ชันที่พร้อมใช้งานทั่วโลก คำสั่ง
firebase
สำหรับตัวอย่างและรายละเอียดเพิ่มเติมเกี่ยวกับสคริปต์การติดตั้งอัตโนมัติ โปรดดูที่ ซอร์สโค้ดของสคริปต์ที่ firebase.tools
ไบนารีแบบสแตนด์อโลน
หากต้องการดาวน์โหลดและเรียกใช้ไบนารีสำหรับ Firebase CLI ที่เจาะจง สำหรับระบบปฏิบัติการของคุณ ให้ทำตามขั้นตอนต่อไปนี้
ดาวน์โหลดไบนารี CLI ของ Firebase สำหรับระบบปฏิบัติการของคุณ: macOS | Linux
(ไม่บังคับ) ตั้งค่าคำสั่ง
firebase
ที่ใช้ได้ทั่วโลก- ทำให้ไฟล์สั่งการไบนารีได้โดยเรียกใช้
chmod +x ./firebase_tools
- เพิ่มเส้นทางของไบนารีลงใน เส้นทาง
- ทำให้ไฟล์สั่งการไบนารีได้โดยเรียกใช้
npm
ในการใช้ npm
(ตัวจัดการแพ็กเกจโหนด) เพื่อติดตั้ง Firebase CLI
ให้ทำตามขั้นตอนต่อไปนี้
เข้าสู่ระบบและทดสอบ CLI ของ Firebase
หลังจากติดตั้ง CLI คุณต้องตรวจสอบสิทธิ์ จากนั้นคุณจะยืนยันได้ โดยแสดงรายการโปรเจ็กต์ Firebase
เข้าสู่ระบบ Firebase โดยใช้บัญชี Google โดยเรียกใช้รายการต่อไปนี้ คำสั่ง:
firebase login
คำสั่งนี้จะเชื่อมต่อเครื่องภายในของคุณกับ Firebase และให้สิทธิ์ สิทธิ์เข้าถึงโปรเจ็กต์ Firebase
ทดสอบว่า CLI ได้รับการติดตั้งอย่างถูกต้องและเข้าถึงบัญชีของคุณโดย แสดงรายการโปรเจ็กต์ Firebase ของคุณ เรียกใช้คำสั่งต่อไปนี้
firebase projects:list
รายการที่แสดงควรเหมือนกับโปรเจ็กต์ Firebase ที่แสดงใน คอนโซล Firebase
อัปเดตเป็น CLI เวอร์ชันล่าสุด
โดยทั่วไปคุณต้องการใช้ Firebase CLI เวอร์ชันล่าสุด
วิธีอัปเดตเวอร์ชัน CLI ขึ้นอยู่กับระบบปฏิบัติการและวิธีที่คุณใช้ ติดตั้ง CLI
Windows
- ไบนารีแบบสแตนด์อโลน: ดาวน์โหลด เวอร์ชัน จากนั้นให้นำไปแทนที่ในระบบ
- npm: เรียกใช้
npm install -g firebase-tools
macOS
- สคริปต์การติดตั้งอัตโนมัติ: เรียกใช้
curl -sL https://firebase.tools | upgrade=true bash
- ไบนารีแบบสแตนด์อโลน: ดาวน์โหลด เวอร์ชัน จากนั้นจ่าย แทนที่ในระบบของคุณได้
- npm: เรียกใช้
npm install -g firebase-tools
Linux
- สคริปต์การติดตั้งอัตโนมัติ: เรียกใช้
curl -sL https://firebase.tools | upgrade=true bash
- ไบนารีแบบสแตนด์อโลน: ดาวน์โหลด เวอร์ชัน จากนั้นจ่าย แทนที่ในระบบของคุณได้
- npm: เรียกใช้
npm install -g firebase-tools
ใช้ CLI กับระบบ CI
CLI ของ Firebase ต้องใช้เบราว์เซอร์เพื่อดำเนินการตรวจสอบสิทธิ์ให้เสร็จสมบูรณ์ แต่ CLI เข้ากันได้กับ CI และสภาพแวดล้อมแบบไม่มีส่วนหัวอื่นๆ อย่างสมบูรณ์
ในคอมพิวเตอร์ที่มีเบราว์เซอร์ ติดตั้ง Firebase CLI
เริ่มขั้นตอนการลงชื่อเข้าใช้โดยเรียกใช้คำสั่งต่อไปนี้
firebase login:ci
ไปที่ URL ที่ระบุ จากนั้นเข้าสู่ระบบโดยใช้บัญชี Google
พิมพ์ ใหม่ โทเค็นการรีเฟรช เซสชัน CLI ปัจจุบันจะไม่ได้รับผลกระทบ
จัดเก็บโทเค็นเอาต์พุตด้วยวิธีที่ปลอดภัยแต่เข้าถึงได้ในระบบ CI
ใช้โทเค็นนี้เมื่อเรียกใช้คำสั่ง
firebase
คุณสามารถใช้ ตัวเลือก 2 รายการต่อไปนี้ตัวเลือกที่ 1: จัดเก็บโทเค็นเป็นตัวแปรสภาพแวดล้อม
FIREBASE_TOKEN
ระบบจะใช้โทเค็นโดยอัตโนมัติตัวเลือกที่ 2: เรียกใช้คำสั่ง
firebase
ทั้งหมดด้วยคำสั่ง--token TOKEN
Flag ในระบบ CI
ตามลำดับความสำคัญในการโหลดโทเค็น: Flag, สภาพแวดล้อม ตัวแปร Firebase ที่ต้องการ
เริ่มต้นโปรเจ็กต์ Firebase
งานทั่วไปหลายอย่างที่ทำโดยใช้ CLI เช่น การทำให้ใช้งานได้ใน Firebase
ต้องมีไดเรกทอรีโปรเจ็กต์ คุณสร้างไดเรกทอรีโปรเจ็กต์
โดยใช้คำสั่ง firebase init
โดยปกติแล้วไดเรกทอรีโปรเจ็กต์จะเหมือนกัน
เป็นรากควบคุมแหล่งที่มา และหลังจากเรียกใช้ firebase init
ค่า
ไดเรกทอรีมีการกำหนดค่า firebase.json
หากต้องการเริ่มต้นโปรเจ็กต์ Firebase ใหม่ ให้เรียกใช้คำสั่งต่อไปนี้จากภายใน ไดเรกทอรีของแอป
firebase init
คำสั่ง firebase init
จะนำคุณเข้าสู่การตั้งค่าไดเรกทอรีโปรเจ็กต์
และผลิตภัณฑ์ Firebase บางรายการ ในระหว่างการเริ่มต้นโปรเจ็กต์ CLI ของ Firebase
ขอให้คุณทำงานต่อไปนี้ให้เสร็จสมบูรณ์
เลือกผลิตภัณฑ์ Firebase ที่ต้องการตั้งค่าในโปรเจ็กต์ Firebase
ขั้นตอนนี้จะแจ้งให้คุณตั้งการกำหนดค่าสำหรับไฟล์เฉพาะสำหรับ ผลิตภัณฑ์ที่เลือกไว้ สำหรับรายละเอียดเพิ่มเติมเกี่ยวกับการกำหนดค่าเหล่านี้ โปรดดูที่ เอกสารของผลิตภัณฑ์ที่เฉพาะเจาะจง (เช่น Hosting) โปรดทราบว่า เรียกใช้
firebase init
ในภายหลังได้เสมอเพื่อตั้งค่าผลิตภัณฑ์ Firebase เพิ่มเติมเลือกโปรเจ็กต์ Firebase เริ่มต้น
ขั้นตอนนี้จะเชื่อมโยงไดเรกทอรีโครงการปัจจุบันกับโครงการ Firebase ดังนั้น ที่คำสั่งเฉพาะโปรเจ็กต์ (เช่น
firebase deploy
) จะทำงานกับ โปรเจ็กต์ Firebase ที่เหมาะสมนอกจากนี้คุณยังสามารถ เชื่อมโยงโปรเจ็กต์ Firebase หลายโปรเจ็กต์ (เช่น โปรเจ็กต์ทดลองใช้และโปรเจ็กต์ที่ใช้งานจริง) ที่มีโปรเจ็กต์เดียวกัน ไดเรกทอรี
ในช่วงท้ายของการเริ่มต้น Firebase จะสร้าง ที่รูทของไดเรกทอรีแอปในเครื่อง
ไฟล์การกำหนดค่า
firebase.json
ที่แสดง การกำหนดค่าโปรเจ็กต์ของคุณไฟล์
.firebaserc
ที่จัดเก็บโปรเจ็กต์ของคุณ aliases
ไฟล์ firebase.json
คำสั่ง firebase init
จะสร้าง
firebase.json
ในรูทของไดเรกทอรีโปรเจ็กต์
ต้องใช้ไฟล์ firebase.json
เพื่อ
ทำให้เนื้อหาใช้งานได้ด้วย Firebase CLI เนื่องจากมีการระบุ
ไฟล์และการตั้งค่าใดจากไดเรกทอรีโปรเจ็กต์ที่ทำให้ใช้งานได้กับ
โปรเจ็กต์ Firebase เนื่องจากการตั้งค่าบางอย่างสามารถกําหนดได้ในโปรเจ็กต์ของคุณ
หรือ
Firebase โปรดตรวจสอบว่าคุณแก้ปัญหาที่อาจเกิดขึ้น
ความขัดแย้งในการทำให้ใช้งานได้
คุณสามารถกำหนดค่าตัวเลือกส่วนใหญ่ของ Firebase Hosting ได้
ในไฟล์ firebase.json
โดยตรง อย่างไรก็ตาม สำหรับ
บริการ Firebase ที่ทำให้ใช้งานได้ด้วย Firebase CLI
คำสั่ง firebase init
จะสร้างไฟล์เฉพาะที่คุณสามารถกำหนดการตั้งค่าได้
สำหรับบริการเหล่านั้น เช่น ไฟล์ index.js
สำหรับ Cloud Functions คุณสามารถ
ตั้งค่า Hooks ล่วงหน้าหรือหลังจากทำให้ใช้งานได้ในไฟล์ firebase.json
ด้วย
ต่อไปนี้เป็นตัวอย่างไฟล์ firebase.json
ที่มีการตั้งค่าเริ่มต้นหากคุณ
เลือก Firebase Hosting, Cloud Firestore และ Cloud Functions for Firebase
(ด้วยการเลือกแหล่งที่มาและ Lint ของ TypeScript ไว้) ระหว่างการเริ่มต้น
{
"hosting": {
"public": "public",
"ignore": [
"firebase.json",
"**/.*",
"**/node_modules/**"
]
},
"firestore": {
"rules": "firestore.rules",
"indexes": "firestore.indexes.json"
},
"functions": {
"predeploy": [
"npm --prefix \"$RESOURCE_DIR\" run lint",
"npm --prefix \"$RESOURCE_DIR\" run build"
]
}
}
แม้ว่าระบบจะใช้ firebase.json
โดยค่าเริ่มต้น คุณก็ส่ง
แฟล็ก --config PATH
เพื่อระบุทางเลือก
ใหม่
การกำหนดค่าสำหรับฐานข้อมูล Cloud Firestore หลายรายการ
เมื่อคุณเรียกใช้ firebase init
ไฟล์ firebase.json
ของคุณจะมีไฟล์เดียว
คีย์ firestore
ที่สอดคล้องกับฐานข้อมูลเริ่มต้นของโปรเจ็กต์ตามที่แสดง
ที่ด้านบน
หากโปรเจ็กต์มีฐานข้อมูล Cloud Firestore หลายรายการ ให้แก้ไข
firebase.json
เพื่อเชื่อมโยง Cloud Firestore Security Rules และ
ไฟล์ต้นทางของดัชนีฐานข้อมูลที่มีแต่ละฐานข้อมูล แก้ไขไฟล์ด้วย
อาร์เรย์ JSON ที่มี 1 รายการสำหรับแต่ละฐานข้อมูล
"firestore": [
{
"database": "(default)",
"rules": "firestore.default.rules",
"indexes": "firestore.default.indexes.json"
},
{
"database": "ecommerce",
"rules": "firestore.ecommerce.rules",
"indexes": "firestore.ecommerce.indexes.json"
}
],
ไฟล์ Cloud Functions รายการที่ไม่ต้องสนใจเมื่อทำให้ใช้งานได้
ขณะทำให้ฟังก์ชันใช้งานได้ CLI จะระบุโดยอัตโนมัติ
รายการไฟล์ในไดเรกทอรี functions
ที่จะละเว้น ช่วงเวลานี้
ป้องกันไม่ให้ทำให้ใช้งานได้กับไฟล์ส่วนเกินของแบ็กเอนด์ซึ่งอาจ
จะเพิ่มขนาดข้อมูลการติดตั้งใช้งาน
รายการไฟล์ที่ละเว้นโดยค่าเริ่มต้นซึ่งแสดงในรูปแบบ JSON มีดังนี้
"ignore": [
".git",
".runtimeconfig.json",
"firebase-debug.log",
"firebase-debug.*.log",
"node_modules"
]
หากคุณเพิ่มค่าที่กำหนดเองสำหรับ ignore
ใน firebase.json
โปรด
อย่าลืมเก็บ (หรือเพิ่ม ถ้าไม่มี) รายการไฟล์ที่แสดงข้างต้นไว้
จัดการชื่อแทนของโปรเจ็กต์
คุณเชื่อมโยงโปรเจ็กต์ Firebase หลายโปรเจ็กต์กับไดเรกทอรีโปรเจ็กต์เดียวกันได้
เช่น คุณอาจต้องการใช้โปรเจ็กต์ Firebase 1 โปรเจ็กต์สำหรับการทดลองใช้และอีกโปรเจ็กต์หนึ่ง
สำหรับเวอร์ชันที่ใช้งานจริง เมื่อใช้สภาพแวดล้อมโปรเจ็กต์ที่แตกต่างกัน คุณจะยืนยันการเปลี่ยนแปลงได้
ก่อนทำให้ใช้งานได้จริง คำสั่ง firebase use
ช่วยให้คุณเปลี่ยน
ระหว่างชื่อแทน รวมทั้งสร้างชื่อแทนใหม่
เพิ่มชื่อแทนโปรเจ็กต์
เมื่อคุณเลือกโปรเจ็กต์ Firebase ระหว่างโปรเจ็กต์
การเริ่มต้น โปรเจ็กต์จะสร้างขึ้นโดยอัตโนมัติ
กำหนดชื่อแทนของ default
แล้ว แต่หากต้องการอนุญาตคำสั่งเฉพาะโปรเจ็กต์
ทำงานกับโปรเจ็กต์ Firebase อื่น แต่ยังคงใช้โปรเจ็กต์เดียวกัน
ให้เรียกใช้คำสั่งต่อไปนี้จากในไดเรกทอรีโปรเจ็กต์
firebase use --add
คำสั่งนี้จะให้คุณเลือกโปรเจ็กต์ Firebase อื่นและกำหนด
เป็นชื่อแทน ระบบจะเขียนการมอบหมายชื่อแทนไปยังไฟล์ .firebaserc
ภายใน
ไดเรกทอรีโปรเจ็กต์ของคุณ
ใช้ชื่อแทนโปรเจ็กต์
หากต้องการใช้ชื่อแทนโปรเจ็กต์ Firebase ที่มอบหมาย ให้เรียกใช้คำสั่งต่อไปนี้จาก ภายในไดเรกทอรีโปรเจ็กต์ของคุณ
คำสั่ง | คำอธิบาย |
---|---|
firebase use |
ดูรายการชื่อแทนที่กำหนดไว้ในปัจจุบันสำหรับไดเรกทอรีโปรเจ็กต์ของคุณ |
firebase use \ |
สั่งการคำสั่งทั้งหมดให้ทำงานกับโปรเจ็กต์ Firebase ที่ระบุ
CLI ใช้โปรเจ็กต์นี้เป็น "โปรเจ็กต์ที่ใช้งานอยู่" ในปัจจุบัน |
firebase use --clear |
ล้างโปรเจ็กต์ที่ใช้งานอยู่
เรียกใช้ |
firebase use \ |
นำชื่อแทนออกจากไดเรกทอรีโปรเจ็กต์ |
คุณสามารถลบล้างสิ่งที่กําลังใช้เป็นโปรเจ็กต์ที่ใช้งานอยู่ในปัจจุบันได้โดยส่ง
แฟล็ก --project
ด้วยคำสั่ง CLI เช่น คุณสามารถตั้งค่า
CLI เพื่อทำงานกับโปรเจ็กต์ Firebase ที่คุณได้กำหนด staging
ชื่อแทน ถ้าต้องการเรียกใช้คำสั่งเดียวกับโปรเจ็กต์ Firebase ที่
คุณได้กำหนดชื่อแทน prod
แล้ว คุณจะสามารถเรียกใช้ได้ ตัวอย่างเช่น
การควบคุมแหล่งที่มาและชื่อแทนโปรเจ็กต์
โดยทั่วไป คุณควรตรวจสอบไฟล์ .firebaserc
ในการควบคุมแหล่งที่มาเพื่อ
อนุญาตให้ทีมของคุณแชร์ชื่อแทนโปรเจ็กต์ได้ อย่างไรก็ตาม สำหรับโปรเจ็กต์โอเพนซอร์ส หรือ
เทมเพลตเริ่มต้น โดยทั่วไปแล้วคุณไม่ควรตรวจสอบในไฟล์ .firebaserc
หากคุณมีโครงการพัฒนาซอฟต์แวร์สําหรับการใช้งานเท่านั้น คุณสามารถเลือก
แฟล็ก --project
พร้อมกับคำสั่งหรือการเรียกใช้แต่ละรายการ
firebase use PROJECT_ID
โดยไม่กำหนดชื่อแทนให้
โปรเจ็กต์ Firebase
แสดงและทดสอบโปรเจ็กต์ Firebase ในเครื่อง
คุณดูและทดสอบโปรเจ็กต์ Firebase บน URL ที่โฮสต์ในเครื่องได้ก่อนวันที่
ใช้งานได้จริง หากต้องการทดสอบเฉพาะฟีเจอร์บางอย่าง คุณสามารถใช้
รายการที่คั่นด้วยคอมมาในแฟล็กของคำสั่ง firebase serve
เรียกใช้คำสั่งต่อไปนี้จากรูทของไดเรกทอรีโปรเจ็กต์ในเครื่องหากคุณ ต้องการดำเนินการอย่างใดอย่างหนึ่งต่อไปนี้
- ดูเนื้อหาแบบคงที่สำหรับแอปที่โฮสต์ด้วย Firebase
- ใช้ Cloud Functions เพื่อสร้างเนื้อหาแบบไดนามิกสำหรับ Firebase Hosting และคุณต้องการใช้ การผลิต (ทำให้ใช้งานได้) ฟังก์ชัน HTTP เพื่อจำลอง Hosting บน URL ในเครื่อง
firebase serve --only hosting
จำลองโปรเจ็กต์โดยใช้ฟังก์ชัน HTTP local
เรียกใช้คำสั่งต่อไปนี้จากไดเรกทอรีโปรเจ็กต์ของคุณเพื่อจำลอง ที่ใช้ฟังก์ชัน HTTP local
หากต้องการจำลองฟังก์ชัน HTTP และการโฮสต์สำหรับการทดสอบใน URL ภายใน ให้ใช้ คำสั่งต่อไปนี้
firebase serve
firebase serve --only functions,hosting // uses a flag
หากต้องการจำลองเฉพาะฟังก์ชัน HTTP ให้ใช้คำสั่งต่อไปนี้
firebase serve --only functions
ทดสอบจากอุปกรณ์อื่นในเครือข่ายเดียวกัน
โดยค่าเริ่มต้น firebase serve
จะตอบกลับคำขอจาก localhost
เท่านั้น ช่วงเวลานี้
หมายความว่าคุณจะสามารถเข้าถึงเนื้อหาที่โฮสต์ไว้จากเว็บของคอมพิวเตอร์ของคุณได้
เบราว์เซอร์แต่ไม่ได้มาจากอุปกรณ์อื่นๆ ในเครือข่ายของคุณ หากคุณต้องการทดสอบจาก
ในอุปกรณ์อื่นๆ ให้ใช้แฟล็ก --host
ดังนี้
firebase serve --host 0.0.0.0 // accepts requests to any host
ทำให้ใช้งานได้กับโปรเจ็กต์ Firebase
CLI ของ Firebase จัดการการติดตั้งใช้งานโค้ดและเนื้อหาใน Firebase ซึ่งได้แก่
- เว็บไซต์ Firebase Hosting รุ่นใหม่ของคุณ
- Cloud Functions for Firebase ใหม่ ที่อัปเดต หรือที่มีอยู่
- กฎสำหรับ Firebase Realtime Database
- กฎสำหรับ Cloud Storage for Firebase
- กฎสำหรับ Cloud Firestore
- ดัชนีสำหรับ Cloud Firestore
หากต้องการทำให้โปรเจ็กต์ Firebase ใช้งานได้ ให้เรียกใช้คำสั่งต่อไปนี้จากโปรเจ็กต์ของคุณ ไดเรกทอรี:
firebase deploy
โดยคุณจะเพิ่มความคิดเห็นในการทำให้ใช้งานได้แต่ละรายการก็ได้ ความคิดเห็นนี้จะ พร้อมกับข้อมูลการติดตั้งใช้งานอื่นๆ ในโปรเจ็กต์ Firebase Hosting เช่น
firebase deploy -m "Deploying the best new feature ever."
โปรดคํานึงถึงสิ่งต่อไปนี้เมื่อใช้คําสั่ง firebase deploy
หากต้องการปรับใช้ทรัพยากรจากไดเรกทอรีโปรเจ็กต์ ไดเรกทอรีโปรเจ็กต์ ต้องมีไฟล์
firebase.json
ไฟล์นี้ ที่สร้างขึ้นโดยอัตโนมัติสำหรับคุณโดยfirebase init
โดยค่าเริ่มต้น
firebase deploy
จะสร้างรุ่นสำหรับทรัพยากรที่ทำให้ใช้งานได้ทั้งหมด ในไดเรกทอรีโปรเจ็กต์ หากต้องการทำให้บริการหรือฟีเจอร์ Firebase ที่เฉพาะเจาะจงใช้งานได้ ใช้การทำให้ใช้งานได้บางส่วน
ความขัดแย้งของการทำให้ใช้งานได้สำหรับกฎความปลอดภัย
สำหรับ Firebase Realtime Database, Cloud Storage for Firebase และ Cloud Firestore คุณจะกำหนดกฎความปลอดภัยได้ในไดเรกทอรีโปรเจ็กต์ในเครื่องหรือใน คอนโซล Firebase
อีกทางเลือกหนึ่งในการป้องกันความขัดแย้งของการทำให้ใช้งานได้คือ ใช้การทำให้ใช้งานได้บางส่วน และกำหนดกฎใน คอนโซล Firebase
โควต้าการทำให้ใช้งานได้
อาจเป็นไปได้ (แต่อาจไม่เกิดขึ้นก็ได้) ที่อาจใช้เกินโควต้าที่จำกัด
อัตราหรือปริมาณการดำเนินการทำให้ Firebase ใช้งานได้ ตัวอย่างเช่น เมื่อ
การทำให้ฟังก์ชันจำนวนมากใช้งานได้จำนวนมาก คุณอาจได้รับ HTTP 429 Quota
ข้อความแสดงข้อผิดพลาด ในการแก้ปัญหาดังกล่าว ให้ลอง
โดยใช้การติดตั้งใช้งานบางส่วน
ย้อนกลับการทำให้ใช้งานได้
คุณสามารถย้อนกลับการทำให้ใช้งานได้ของ Firebase Hosting จาก Firebase Hosting โดยเลือก การดำเนินการย้อนกลับสำหรับรุ่นที่ต้องการ
ขณะนี้ยังย้อนกลับรุ่นของกฎความปลอดภัยสำหรับ Firebase Realtime Database, Cloud Storage for Firebase หรือ Cloud Firestore
ทำให้บริการ Firebase บางอย่างใช้งานได้
หากต้องการทำให้บริการหรือฟีเจอร์ Firebase บางรายการใช้งานได้ ให้ใช้
รายการที่คั่นด้วยคอมมาในแฟล็กของคำสั่ง firebase deploy
ตัวอย่างเช่น
คำสั่งต่อไปนี้ทำให้เนื้อหา Firebase Hosting ใช้งานได้และ
กฎความปลอดภัย Cloud Storage ข้อ
firebase deploy --only hosting,storage
ตารางต่อไปนี้แสดงบริการและฟีเจอร์ที่ใช้ได้บางส่วน
ของการทำให้ใช้งานได้ ชื่อในแฟล็กจะตรงกับคีย์ใน
firebase.json
ไวยากรณ์การแจ้งว่าไม่เหมาะสม | มีการนำบริการหรือฟีเจอร์ไปใช้งาน |
---|---|
--only hosting |
เนื้อหาภาษาFirebase Hosting |
--only database |
กฎ Firebase Realtime Database รายการ |
--only storage |
กฎ Cloud Storage for Firebase รายการ |
--only firestore |
กฎ Cloud Firestore ข้อและจะจัดทำดัชนีสำหรับฐานข้อมูลที่กำหนดค่าทั้งหมด |
--only functions |
Cloud Functions for Firebase (อาจมีแฟล็กนี้ในเวอร์ชันที่เฉพาะเจาะจงมากขึ้น) |
ทำให้ฟังก์ชันที่เฉพาะเจาะจงใช้งานได้
เมื่อทำให้ฟังก์ชันใช้งานได้ คุณจะกำหนดเป้าหมายฟังก์ชันเฉพาะได้ เช่น
firebase deploy --only functions:function1
firebase deploy --only functions:function1,functions:function2
อีกทางเลือกหนึ่งคือจัดกลุ่มฟังก์ชันเป็นกลุ่มส่งออกใน
/functions/index.js
ไฟล์ ฟังก์ชันการจัดกลุ่มช่วยให้คุณทำให้
โดยใช้คำสั่งเดียว
ตัวอย่างเช่น คุณสามารถเขียนฟังก์ชันต่อไปนี้เพื่อกำหนด groupA
และ
groupB
:
var functions = require('firebase-functions/v1');
exports.groupA = {
function1: functions.https.onRequest(...),
function2: functions.database.ref('\path').onWrite(...)
}
exports.groupB = require('./groupB');
ในตัวอย่างนี้ ไฟล์ functions/groupB.js
ที่แยกต่างหากจะมี
ฟังก์ชันที่กำหนดฟังก์ชันใน groupB
โดยเฉพาะ เช่น
var functions = require('firebase-functions/v1');
exports.function3 = functions.storage.object().onChange(...);
exports.function4 = functions.analytics.event('in_app_purchase').onLog(...);
ในตัวอย่างนี้ คุณสามารถทำให้ฟังก์ชัน groupA
ทั้งหมดใช้งานได้โดยการเรียกใช้ฟังก์ชัน
คำสั่งต่อไปนี้จากไดเรกทอรีโปรเจ็กต์ของคุณ:
firebase deploy --only functions:groupA
หรือคุณสามารถกำหนดเป้าหมายฟังก์ชันเฉพาะภายในกลุ่มโดยเรียกใช้ฟังก์ชันต่อไปนี้ คำสั่ง:
firebase deploy --only functions:groupA.function1,groupB.function4
ลบฟังก์ชัน
Firebase CLI รองรับคำสั่งและตัวเลือกต่อไปนี้สำหรับ ลบฟังก์ชันที่ทำให้ใช้งานได้ก่อนหน้านี้
ลบฟังก์ชันทั้งหมดที่ตรงกับชื่อที่ระบุในทุกภูมิภาค:
firebase functions:delete FUNCTION-1_NAME
ลบฟังก์ชันที่ระบุซึ่งทำงานอยู่ในภูมิภาคที่ไม่ใช่ค่าเริ่มต้น
firebase functions:delete FUNCTION-1_NAME --region REGION_NAME
ลบฟังก์ชันมากกว่า 1 รายการ:
firebase functions:delete FUNCTION-1_NAME FUNCTION-2_NAME
ลบกลุ่มฟังก์ชันที่ระบุ
firebase functions:delete GROUP_NAME
ข้ามข้อความแจ้งการยืนยัน:
firebase functions:delete FUNCTION-1_NAME --force
ตั้งค่างานที่ใช้สคริปต์ล่วงหน้าและหลังจากทำให้ใช้งานได้
คุณสามารถเชื่อมต่อสคริปต์ Shell กับคำสั่ง firebase deploy
เพื่อดำเนินการ
งานล่วงหน้าหรือหลังการปรับใช้ ตัวอย่างเช่น สคริปต์การติดตั้งใช้งานล่วงหน้า
แปลงโค้ด TypeScript เป็น JavaScript และ Hook ที่หลังจากติดตั้งใช้งานสามารถแจ้งเตือนได้
ผู้ดูแลเนื้อหาเว็บไซต์ใหม่จะทำให้ใช้งานได้กับ Firebase Hosting
หากต้องการตั้งค่า Hooks ที่นำส่งล่วงหน้าหรือหลังจากติดตั้งใช้งาน ให้เพิ่มสคริปต์ Bash ลงใน
firebase.json
คุณสามารถกำหนด
สคริปต์สั้นๆ โดยตรงในไฟล์ firebase.json
หรือคุณสามารถอ้างอิง
ไฟล์ที่อยู่ในไดเรกทอรีโปรเจ็กต์
ตัวอย่างเช่น สคริปต์ต่อไปนี้คือนิพจน์ firebase.json
สำหรับ
งานหลังทำให้ใช้งานได้ที่ส่งข้อความ Slack เมื่อการทำให้ใช้งานได้เสร็จสมบูรณ์ไปยัง
Firebase Hosting
"hosting": {
// ...
"postdeploy": "./messageSlack.sh 'Just deployed to Firebase Hosting'",
"public": "public"
}
ไฟล์สคริปต์ messageSlack.sh
อยู่ในไดเรกทอรีและรูปแบบของโปรเจ็กต์
ดังนี้
curl -X POST -H 'Content-type: application/json' --data '{"text":"$1"}' \https://SLACK_WEBHOOK_URL
คุณสามารถตั้งค่าฮุก predeploy
และ postdeploy
สำหรับ
ชิ้นงานที่นำไปใช้ได้ โปรดทราบว่าการเรียกใช้ firebase deploy
จะทริกเกอร์งานล่วงหน้าและหลังจากทำให้ใช้งานได้ทั้งหมดตามที่กำหนดไว้ใน
firebase.json
ไฟล์ เรียกใช้เฉพาะงานที่เกี่ยวข้องกับ
Firebase ทั้งหมด ให้ใช้คำสั่งการติดตั้งใช้งานบางส่วน
ฮุก predeploy
และ postdeploy
พิมพ์เอาต์พุตมาตรฐานและข้อผิดพลาด
สตรีมของสคริปต์ไปยังเทอร์มินัล สำหรับกรณีที่ส่งไม่สำเร็จ โปรดสังเกตข้อมูลต่อไปนี้
- หากฮุกที่ทำให้ใช้งานได้ไม่สำเร็จตามที่คาดไว้ ระบบจะยกเลิกการทำให้ใช้งานได้
- หากการติดตั้งใช้งานล้มเหลวไม่ว่าด้วยสาเหตุใดก็ตาม ระบบจะไม่ทริกเกอร์ฮุกหลังจากการติดตั้งใช้งาน
ตัวแปรสภาพแวดล้อม
ภายในสคริปต์ที่ทำงานใน Hooks ก่อนทำให้ใช้งานได้และหลังจากทำให้ใช้งานได้แล้ว ตัวแปรสภาพแวดล้อมที่ใช้ได้มีดังนี้
$GCLOUD_PROJECT
: รหัสโปรเจ็กต์ที่ใช้งานอยู่$PROJECT_DIR
: ไดเรกทอรีรากที่มีไฟล์firebase.json
$RESOURCE_DIR
: (สำหรับสคริปต์hosting
และfunctions
เท่านั้น) ตำแหน่งของไดเรกทอรีที่มี Hosting หรือ ทรัพยากร Cloud Functions รายการที่จะทำให้ใช้งานได้
จัดการอินสแตนซ์ Realtime Database หลายรายการ
โปรเจ็กต์ Firebase มีได้ อินสแตนซ์ Firebase Realtime Database หลายรายการ โดย ตามค่าเริ่มต้น คำสั่ง CLI จะโต้ตอบกับอินสแตนซ์ฐานข้อมูลเริ่มต้นของคุณ
แต่คุณสามารถโต้ตอบกับอินสแตนซ์ฐานข้อมูลที่ไม่ใช่ค่าเริ่มต้นได้โดยใช้
แฟล็ก --instance DATABASE_NAME
--instance
firebase database:get
firebase database:profile
firebase database:push
firebase database:remove
firebase database:set
firebase database:update
การอ้างอิงคำสั่ง
คำสั่งการดูแลระบบ CLI
คำสั่ง | คำอธิบาย |
---|---|
ความช่วยเหลือ | แสดงข้อมูลความช่วยเหลือเกี่ยวกับ CLI หรือคำสั่งเฉพาะ |
เริ่มต้น | เชื่อมโยงและสร้างโปรเจ็กต์ Firebase ใหม่ในไดเรกทอรีปัจจุบัน
คำสั่งนี้จะสร้าง
firebase.json
ในไดเรกทอรีปัจจุบัน |
login | ตรวจสอบสิทธิ์ CLI ในบัญชี Firebase ต้องมีสิทธิ์เข้าถึง
เว็บเบราว์เซอร์ การเข้าสู่ระบบ CLI ในสภาพแวดล้อมระยะไกลที่ไม่อนุญาตให้เข้าถึง localhost ใช้ --no-localhost |
login:ci | สร้างโทเค็นการตรวจสอบสิทธิ์สำหรับใช้ในแบบไม่โต้ตอบ สภาพแวดล้อมการใช้งาน |
ออกจากระบบ | ออกจากระบบ CLI จากบัญชี Firebase |
เปิด | เปิดเบราว์เซอร์เพื่อดูทรัพยากรของโปรเจ็กต์ที่เกี่ยวข้อง |
โปรเจ็กต์:รายการ | แสดงรายการโปรเจ็กต์ Firebase ทั้งหมดที่คุณมีสิทธิ์เข้าถึง |
การใช้งาน | ตั้งค่าโปรเจ็กต์ Firebase ที่ใช้งานอยู่สำหรับ CLI จัดการชื่อแทนโปรเจ็กต์ |
คำสั่งการจัดการโปรเจ็กต์
คำสั่ง | คำอธิบาย | |
---|---|---|
การจัดการโปรเจ็กต์ Firebase | ||
projects:addfirebase | เพิ่มทรัพยากร Firebase ไปยังโปรเจ็กต์ Google Cloud ที่มีอยู่ | |
projects:create | สร้างโปรเจ็กต์ Google Cloud ใหม่ แล้วเพิ่มทรัพยากร Firebase ไปยัง โปรเจ็กต์ใหม่ | |
โปรเจ็กต์:รายการ | แสดงรายการโปรเจ็กต์ Firebase ทั้งหมดที่คุณมีสิทธิ์เข้าถึง | |
การจัดการแอป Firebase (iOS, Android, เว็บ) | ||
apps:สร้าง | สร้างแอป Firebase ใหม่ในโปรเจ็กต์ที่ใช้งานอยู่ | |
แอป:รายการ | แสดงรายการแอป Firebase ที่ลงทะเบียนในโปรเจ็กต์ที่ใช้งานอยู่ | |
แอป:sdkconfig | พิมพ์การกำหนดค่าบริการของ Google ของแอป Firebase | |
ตั้งค่า:เว็บ | เลิกใช้งานแล้ว แต่ให้ใช้ apps:sdkconfig และ
ระบุ web เป็นอาร์กิวเมนต์แพลตฟอร์มการพิมพ์ การกำหนดค่าบริการของ Google ของเว็บแอป Firebase |
|
การจัดการแฮชใบรับรอง SHA (Android เท่านั้น) | ||
apps:android:sha:create \ SHA_HASH FIREBASE_APP_ID |
เพิ่มแฮชใบรับรอง SHA ที่ระบุลงใน แอป Firebase บน Android | |
apps:android:sha:ลบ \ SHA_HASH FIREBASE_APP_ID |
ลบแฮชใบรับรอง SHA ที่ระบุออกจาก แอป Firebase บน Android | |
apps:android:sha:list \ FIREBASE_APP_ID |
แสดงรายการแฮชใบรับรอง SHA สำหรับที่ระบุ แอป Firebase บน Android |
การติดตั้งใช้งานและการพัฒนาภายใน
คำสั่งเหล่านี้ช่วยให้คุณใช้งานและโต้ตอบกับเว็บไซต์ Firebase Hosting ได้
คำสั่ง | คำอธิบาย |
---|---|
ติดตั้งใช้งาน | ทำให้โค้ดและเนื้อหาจากไดเรกทอรีโครงการใช้งานได้เป็นค่าที่ใช้งานอยู่
สำหรับ Firebase Hosting ประเภท
firebase.json
ต้องระบุไฟล์การกำหนดค่า
|
บริการ | เริ่มต้นเว็บเซิร์ฟเวอร์ภายในด้วยการกำหนดค่า Firebase Hosting
สำหรับ Firebase Hosting ประเภท
firebase.json
ต้องระบุไฟล์การกำหนดค่า |
คำสั่ง App Distribution รายการ
คำสั่ง | คำอธิบาย |
---|---|
appdistribution:distribution \ --app FIREBASE_APP_ID |
ทำให้ผู้ทดสอบสามารถใช้บิลด์ได้ |
appdistribution:testers:add | เพิ่มผู้ทดสอบไปยังโปรเจ็กต์ |
appdistribution:testers:remove | นำผู้ทดสอบออกจากโปรเจ็กต์ |
คำสั่ง App Hosting รายการ
คำสั่ง | คำอธิบาย |
---|---|
apphosting:backends:create \ --โครงการ PROJECT_ID --ตำแหน่ง REGION --แอป APP_ID |
สร้างคอลเล็กชันของทรัพยากรที่มีการจัดการซึ่งลิงก์กับฐานของโค้ดเดียว ที่ประกอบขึ้นเป็นแบ็กเอนด์ App Hosting (ไม่บังคับ) ระบุ เว็บแอป Firebase ตามรหัสแอป Firebase |
apphosting:backends:get \
BACKEND_ID --โครงการ PROJECT_ID --ตำแหน่ง REGION |
เรียกข้อมูลรายละเอียดที่เจาะจง ซึ่งรวมถึง URL สาธารณะของแบ็กเอนด์ |
apphosting:backends:list \ --โครงการ PROJECT_ID |
เรียกข้อมูลรายการแบ็กเอนด์ที่ใช้งานอยู่ทั้งหมดที่เชื่อมโยงกับโปรเจ็กต์ |
firebase apphosting:backends:delete \
BACKEND_ID --โครงการ PROJECT_ID --ตำแหน่ง REGION |
ลบแบ็กเอนด์ออกจากโปรเจ็กต์ |
apphosting:secrets:set \ KEY --โครงการ PROJECT_ID --สถานที่ REGION --ไฟล์ข้อมูล Data file |
จัดเก็บเนื้อหาข้อมูลลับใน Secret Manager (ไม่บังคับ)
เส้นทางของไฟล์ที่จะอ่านข้อมูลลับ ตั้งค่าเป็น _ เพื่ออ่าน
ข้อมูลลับจากอินพุตมาตรฐาน
|
apphosting:secrets:grantaccess \ KEY --โครงการ PROJECT_ID BACKEND_ID --ตำแหน่ง REGION |
ให้สิทธิ์ แบ็กเอนด์ บัญชีบริการ เข้าถึงข้อมูลลับที่ให้ไว้เพื่อให้สามารถเข้าถึงโดย App Hosting ขณะสร้างหรือรันไทม์ |
apphosting:secrets:describe \ KEY --โปรเจ็กต์ PROJECT_ID |
รับข้อมูลเมตาสำหรับข้อมูลลับและเวอร์ชันของข้อมูลลับ |
firebase apphosting:secrets:access \ KEY[@version] --โปรเจ็กต์ PROJECT_ID |
เข้าถึงค่าข้อมูลลับที่ระบุข้อมูลลับและเวอร์ชันของข้อมูลลับ ค่าเริ่มต้นคือเข้าถึงเวอร์ชันล่าสุด |
คำสั่ง Authentication (การจัดการผู้ใช้)
คำสั่ง | คำอธิบาย |
---|---|
auth:export | ส่งออกบัญชีผู้ใช้ของโปรเจ็กต์ที่ใช้งานอยู่เป็นไฟล์ JSON หรือ CSV สำหรับ ดูรายละเอียดเพิ่มเติมได้ที่ auth:IMPORT และ auth:export |
auth:นำเข้า | นำเข้าบัญชีผู้ใช้จากไฟล์ JSON หรือ CSV ไปยัง ดูรายละเอียดเพิ่มเติมได้ที่ auth:IMPORT และ auth:export |
คำสั่ง Cloud Firestore รายการ
คำสั่ง | คำอธิบาย |
---|---|
firestore:locations |
แสดงรายการตำแหน่งที่ใช้ได้สำหรับฐานข้อมูล Cloud Firestore ของคุณ |
firestore:databases:create DATABASE_ID |
สร้างอินสแตนซ์ฐานข้อมูลในโหมดดั้งเดิมในโปรเจ็กต์ Firebase คำสั่งจะใช้แฟล็กต่อไปนี้
|
firestore:databases:list |
แสดงรายการฐานข้อมูลในโปรเจ็กต์ Firebase |
firestore:databases:get DATABASE_ID |
รับการกำหนดค่าฐานข้อมูลสำหรับฐานข้อมูลที่ระบุใน โปรเจ็กต์ Firebase |
firestore:databases:update DATABASE_ID |
อัปเดตการกำหนดค่าฐานข้อมูลของฐานข้อมูลที่ระบุใน โปรเจ็กต์ Firebase ต้องได้รับแฟล็กอย่างน้อย 1 รายการ คำสั่งจะใช้แฟล็กต่อไปนี้
|
firestore:databases:ลบ DATABASE_ID |
ลบฐานข้อมูลในโปรเจ็กต์ Firebase |
firestore:indexes |
แสดงรายการดัชนีสำหรับฐานข้อมูลในโปรเจ็กต์ Firebase คำสั่งดังกล่าวใช้แฟล็กต่อไปนี้
|
firestore:delete |
ลบเอกสารในฐานข้อมูลของโปรเจ็กต์ที่ใช้งานอยู่ การใช้ CLI คุณจะลบเอกสารทั้งหมดในคอลเล็กชันซ้ำได้ โปรดทราบว่าการลบข้อมูล Cloud Firestore ที่มี CLI จะทำให้เกิดการอ่านและ ลบค่าใช้จ่าย สำหรับข้อมูลเพิ่มเติม โปรดดู ทำความเข้าใจการเรียกเก็บเงินของ Cloud Firestore คำสั่งดังกล่าวใช้แฟล็กต่อไปนี้
|
คำสั่ง Cloud Functions for Firebase รายการ
คำสั่ง | คำอธิบาย |
---|---|
functions:config:clone | โคลนสภาพแวดล้อมของโปรเจ็กต์อื่นลงใน Firebase ที่ใช้งานอยู่ |
functions:config:get | ดึงข้อมูลการกำหนดค่าที่มีอยู่ของโปรเจ็กต์ที่ใช้งานอยู่ Cloud Functions |
functions:config:set | จัดเก็บค่าการกำหนดค่ารันไทม์ของโปรเจ็กต์ที่ใช้งานอยู่ Cloud Functions |
functions:config:unset | นำค่าออกจากการกำหนดค่ารันไทม์ของโปรเจ็กต์ที่ใช้งานอยู่ |
functions:log | อ่านบันทึกจาก Cloud Functions ที่ทำให้ใช้งานได้แล้ว |
ดูข้อมูลเพิ่มเติมได้ที่สภาพแวดล้อม เอกสารการกำหนดค่า
คำสั่ง Crashlytics รายการ
คำสั่ง | คำอธิบาย |
---|---|
crashlytics:mappingfile:generateid \ --resource-file=PATH/TO/ANDROID_RESOURCE.XML |
สร้างรหัสไฟล์การแมปที่ไม่ซ้ำกันในทรัพยากร Android ที่ระบุ (XML) |
crashlytics:mappingfile:upload \ --app=FIREBASE_APP_ID \ --resource-file=PATH/TO/ANDROID_RESOURCE.XML \ PATH/TO/MAPPING_FILE.TXT |
อัปโหลดไฟล์การแมป (TXT) ที่ใช้ร่วมกับ Proguard สำหรับแอปนี้ และเชื่อมโยงกับรหัสไฟล์การแมปที่ประกาศใน ไฟล์ทรัพยากร Android (XML) |
crashlytics:symbols:upload \ --app=FIREBASE_APP_ID \ PATH/TO/SYMBOLS |
สร้างไฟล์สัญลักษณ์ที่เข้ากันได้กับ Crashlytics สำหรับไลบรารีเนทีฟ ขัดข้องบน Android และอัปโหลดไปยังเซิร์ฟเวอร์ Firebase |
คำสั่ง Extensions รายการ
คำสั่ง | คำอธิบาย |
---|---|
ต่อ | แสดงข้อมูลเกี่ยวกับวิธีใช้คำสั่ง Firebase Extensions แสดงรายการอินสแตนซ์ของส่วนขยายที่ติดตั้งในโปรเจ็กต์ที่ใช้งานอยู่ |
ext:configure \ EXTENSION_INSTANCE_ID |
กำหนดค่าค่าพารามิเตอร์ของอินสแตนซ์ส่วนขยายใหม่ใน ไฟล์ Manifest ของส่วนขยาย |
ext:info \ PUBLISHER_ID/EXTENSION_ID |
พิมพ์ข้อมูลโดยละเอียดเกี่ยวกับส่วนขยาย |
ext:ติดตั้ง \ PUBLISHER_ID/EXTENSION_ID |
เพิ่มส่วนขยายอินสแตนซ์ใหม่ลงใน ไฟล์ Manifest ของส่วนขยาย |
ext:list | แสดงรายการอินสแตนซ์ส่วนขยายทั้งหมดที่ติดตั้งในโปรเจ็กต์ Firebase พิมพ์รหัสอินสแตนซ์สำหรับส่วนขยายแต่ละรายการ |
ext:ถอนการติดตั้ง \ EXTENSION_INSTANCE_ID |
นำอินสแตนซ์ส่วนขยายออกจาก ไฟล์ Manifest ของส่วนขยาย |
ext:update \ EXTENSION_INSTANCE_ID |
อัปเดตอินสแตนซ์ของส่วนขยายเป็นเวอร์ชันล่าสุดใน ไฟล์ Manifest ของส่วนขยาย |
ext:ส่งออก | ส่งออกอินสแตนซ์ของส่วนขยายที่ติดตั้งทั้งหมดจากโปรเจ็กต์ไปยัง ไฟล์ Manifest ของส่วนขยาย |
คำสั่งของผู้เผยแพร่โฆษณา Extensions รายการ
คำสั่ง | คำอธิบาย |
---|---|
ext:dev:init | เริ่มต้นโครงสร้างโค้ดเบสสำหรับส่วนขยายใหม่ในรายการปัจจุบัน ไดเรกทอรี |
ext:dev:list \ PUBLISHER_ID |
พิมพ์รายการส่วนขยายทั้งหมดที่อัปโหลดโดยผู้เผยแพร่ |
ext:dev:register | ลงทะเบียนโปรเจ็กต์ Firebase เป็น ส่วนขยายผู้เผยแพร่โฆษณา |
ext:dev:deprecate \ PUBLISHER_ID/EXTENSION_ID \ VERSION_PREDICATE |
เลิกใช้งาน
เวอร์ชันส่วนขยายที่ตรงกับเวอร์ชันภาคแสดง ภาคแสดงเวอร์ชันสามารถเป็นเวอร์ชันเดียวได้ (เช่น 1.0.0 )
หรือช่วงของเวอร์ชัน (เช่น >1.0.0 )หากไม่ได้ระบุเวอร์ชันล่วงหน้า เลิกใช้งานส่วนขยายนั้นทุกเวอร์ชัน |
ext:dev:undeprecate \ PUBLISHER_ID/EXTENSION_ID \ VERSION_PREDICATE |
เลิกใช้งาน
เวอร์ชันส่วนขยายที่ตรงกับเวอร์ชันภาคแสดง ภาคแสดงเวอร์ชันสามารถเป็นเวอร์ชันเดียวได้ (เช่น 1.0.0 )
หรือช่วงของเวอร์ชัน (เช่น >1.0.0 )หากไม่ได้ระบุเวอร์ชันล่วงหน้า ยกเลิกการเลิกใช้งานส่วนขยายนั้นทุกเวอร์ชัน |
ext:dev:upload \ PUBLISHER_ID/EXTENSION_ID |
อัปโหลดส่วนขยายเวอร์ชันใหม่ |
ext:dev:usage \ PUBLISHER_ID |
แสดงจำนวนการติดตั้งและเมตริกการใช้งานสำหรับส่วนขยายที่อัปโหลดโดย ผู้เผยแพร่โฆษณา |
คำสั่ง Hosting รายการ
คำสั่ง | คำอธิบาย |
---|---|
hosting:disable |
หยุดแสดงการเข้าชม Firebase Hosting สำหรับ Firebase ที่ใช้งานอยู่ URL Hosting ของโปรเจ็กต์จะแสดงข้อความ "ไม่พบเว็บไซต์" ข้อความ หลังจากเรียกใช้คำสั่งนี้ |
การจัดการเว็บไซต์ Hosting แห่ง | |
firebase Hosting:sites:create \ SITE_ID |
สร้างเว็บไซต์ Hosting ใหม่ในโปรเจ็กต์ Firebase ที่ใช้งานอยู่โดยใช้
ระบุ (ไม่บังคับ) ระบุเว็บแอป Firebase ที่มีอยู่เพื่อเชื่อมโยง
กับเว็บไซต์ใหม่โดยส่งค่าสถานะต่อไปนี้
|
firebase Hosting:sites:delete \ SITE_ID |
ลบเว็บไซต์ Hosting ที่ระบุ CLI จะแสดงข้อความแจ้งให้ยืนยันก่อนลบเว็บไซต์ (ไม่บังคับ) ข้ามข้อความแจ้งการยืนยันโดยการส่งผ่าน
แฟล็กต่อไปนี้: |
firebase Hosting:sites:get \ SITE_ID |
เรียกดูข้อมูลเกี่ยวกับเว็บไซต์ Hosting ที่ระบุ |
firebase Hosting:sites:list |
แสดงรายการเว็บไซต์ทั้ง Hosting รายการสำหรับโปรเจ็กต์ Firebase ที่ใช้งานอยู่ |
การจัดการช่องตัวอย่าง | |
firebase Hosting:channel:create \ CHANNEL_ID |
สร้างช่องทางแสดงตัวอย่างใหม่ใน
default Hosting เว็บไซต์ที่ใช้
คำสั่งนี้ไม่ทำให้ใช้งานได้กับแชแนล |
firebase Hosting:channel:delete \ CHANNEL_ID |
ลบเวอร์ชันตัวอย่างที่ระบุ คุณลบช่องที่เผยแพร่อยู่ของเว็บไซต์ไม่ได้ |
firebase Hosting:channel:deploy \ CHANNEL_ID |
ทำให้เนื้อหา Hosting ใช้งานได้และกำหนดค่าเป็นที่ระบุ เวอร์ชันตัวอย่าง หากยังไม่มีช่องทางแสดงตัวอย่าง คำสั่งนี้จะสร้าง ช่องในเว็บไซต์ Hosting เริ่มต้น ก่อนทำให้ใช้งานได้ในช่อง |
firebase Hosting:channel:list | แสดงรายการช่องทั้งหมด (รวมถึงช่อง "ถ่ายทอดสด") ค่าเริ่มต้น Hosting เว็บไซต์ |
firebase Hosting:channel:open \ CHANNEL_ID |
เปิดเบราว์เซอร์ไปยัง URL ของช่องที่ระบุหรือแสดงผล URL ถ้าเปิดในเบราว์เซอร์ไม่ได้ |
การโคลนเวอร์ชัน | |
firebase Hosting:clone \ SOURCE_SITE_ID:SOURCE_CHANNEL_ID \ TARGET_SITE_ID:TARGET_CHANNEL_ID |
โคลนเวอร์ชันที่ใช้งานล่าสุดใน "แหล่งที่มา" ที่ระบุ ช่องไปยัง "เป้าหมาย" ที่ระบุ ช่องสัญญาณ คำสั่งนี้จะใช้กับ "เป้าหมาย" ที่ระบุด้วย หาก "เป้าหมาย" ยังไม่มีแชแนล คำสั่งนี้จะสร้าง แสดงตัวอย่างแชแนลใน "เป้าหมาย" Hosting เว็บไซต์ก่อนทำให้ใช้งานได้กับ ช่อง |
firebase Hosting:clone \ SOURCE_SITE_ID:@VERSION_ID \ TARGET_SITE_ID:TARGET_CHANNEL_ID |
โคลนเวอร์ชันที่ระบุไปยัง "เป้าหมาย" ที่ระบุ ช่องสัญญาณ คำสั่งนี้จะใช้กับ "เป้าหมาย" ที่ระบุด้วย หาก "เป้าหมาย" ยังไม่มีแชแนล คำสั่งนี้จะสร้าง แสดงตัวอย่างแชแนลใน "เป้าหมาย" Hosting เว็บไซต์ก่อนทำให้ใช้งานได้กับ ช่อง คุณสามารถค้นหา |
คำสั่ง Realtime Database รายการ
โปรดทราบว่าคุณสร้างอินสแตนซ์ Realtime Database เริ่มต้นเริ่มต้นได้ใน
คอนโซล Firebase หรือโดยการใช้firebase init
ทั่วไป
เวิร์กโฟลว์หรือ
ขั้นตอน firebase init database
เมื่อสร้างอินสแตนซ์แล้ว คุณจะจัดการอินสแตนซ์เหล่านั้นได้ตามที่กล่าวไว้ใน จัดการอินสแตนซ์ Realtime Database หลายรายการ
คำสั่ง | คำอธิบาย |
---|---|
database:get | ดึงข้อมูลจากฐานข้อมูลของโปรเจ็กต์ที่ใช้งานอยู่และแสดงเป็น JSON รองรับการค้นหาข้อมูลที่จัดทำดัชนี |
database:instances:create | สร้างอินสแตนซ์ฐานข้อมูลที่มีชื่ออินสแตนซ์ที่ระบุ ยอมรับ
ตัวเลือก --location สำหรับการสร้างฐานข้อมูลใน
ภูมิภาค สำหรับชื่อภูมิภาคที่จะใช้กับตัวเลือกนี้ โปรดดู
เลือกตำแหน่งสำหรับโปรเจ็กต์
หากไม่มีอินสแตนซ์ฐานข้อมูลสำหรับโปรเจ็กต์ปัจจุบัน คุณจะได้รับข้อความแจ้ง
เพื่อเรียกใช้โฟลว์ firebase init เพื่อสร้างอินสแตนซ์
|
ฐานข้อมูล:อินสแตนซ์:รายการ | แสดงรายการอินสแตนซ์ฐานข้อมูลทั้งหมดสำหรับโปรเจ็กต์นี้ ยอมรับ
ตัวเลือก --location สำหรับการแสดงรายการฐานข้อมูลใน
ภูมิภาค สำหรับชื่อภูมิภาคที่จะใช้กับตัวเลือกนี้ โปรดดู
เลือกตำแหน่งสำหรับโปรเจ็กต์ |
ฐานข้อมูล:โปรไฟล์ | สร้างโปรไฟล์ของการดำเนินการบนฐานข้อมูลของโปรเจ็กต์ที่ใช้งานอยู่ สำหรับ ดูรายละเอียดเพิ่มเติมได้ที่ การดำเนินการ Realtime Database ประเภท |
ฐานข้อมูล:พุช | พุชข้อมูลใหม่ไปยังรายการ ณ ตำแหน่งที่ระบุใน ฐานข้อมูลของโครงการ รับอินพุตจากไฟล์, STDIN หรือบรรทัดคำสั่ง อาร์กิวเมนต์ |
database:remove | ลบข้อมูลทั้งหมดในตำแหน่งที่ระบุใน ฐานข้อมูล |
ฐานข้อมูล:ชุด | แทนที่ข้อมูลทั้งหมดในตำแหน่งที่ระบุใน ฐานข้อมูล รับอินพุตจากไฟล์, STDIN หรืออาร์กิวเมนต์บรรทัดคำสั่ง |
ฐานข้อมูล:อัปเดต | ทำการอัปเดตบางส่วน ณ ตำแหน่งที่ระบุใน ฐานข้อมูลของโครงการ รับอินพุตจากไฟล์, STDIN หรือบรรทัดคำสั่ง อาร์กิวเมนต์ |
คำสั่ง Remote Config รายการ
คำสั่ง | คำอธิบาย |
---|---|
remoteconfig:versions:list \ --จำกัด NUMBER_OF_VERSIONS |
แสดงรายการเทมเพลต 10 เวอร์ชันล่าสุด ระบุ
0 เพื่อแสดงผลเวอร์ชันที่มีอยู่ทั้งหมด หรือ
ส่งตัวเลือก --limit เพื่อจำกัดจำนวน
เวอร์ชันที่กำลังแสดงผล |
remoteconfig:get \ --v, version_number VERSION_NUMBER --o, เอาต์พุต FILENAME |
รับเทมเพลตตามเวอร์ชัน (ค่าเริ่มต้นเป็นเวอร์ชันล่าสุด)
และแสดงกลุ่มพารามิเตอร์ พารามิเตอร์ ชื่อเงื่อนไข และ
ลงในตาราง นอกจากนี้ คุณยังเขียนเอาต์พุตไปยัง
ไฟล์ที่ระบุด้วย -o, FILENAME |
remoteconfig:rollback \ --v, version_number VERSION_NUMBER --บังคับ |
ย้อนกลับเทมเพลต Remote Config รายการเป็นเวอร์ชันก่อนหน้าที่ระบุ
ตัวเลขหรือค่าเริ่มต้นเป็นเวอร์ชันก่อนหน้าก่อนหน้า (เวอร์ชันปัจจุบัน -1) หากไม่ผ่าน --force ระบบจะแสดงข้อความใช่/ไม่ใช่
ก่อนที่จะทำการย้อนกลับ |