หากต้องการพัฒนาและจัดการโปรเจ็กต์ Apps Script จากเทอร์มินัลแทนเครื่องมือแก้ไข Apps Script คุณสามารถใช้เครื่องมือโอเพนซอร์สชื่อ clasp
clasp Codelab ให้ภาพรวมของฟีเจอร์ clasp ทั้งหมด
ฟีเจอร์
พัฒนาในเครื่อง
clasp ช่วยให้คุณพัฒนาโปรเจ็กต์ Apps Script ได้ในเครื่อง คุณสามารถเขียนโค้ดในคอมพิวเตอร์ของคุณเองและอัปโหลดไปยัง Apps Script เมื่อเขียนเสร็จแล้ว นอกจากนี้ คุณยังดาวน์โหลดโปรเจ็กต์ Apps Script ที่มีอยู่เพื่อให้แก้ไขได้เมื่อออฟไลน์อยู่ได้ด้วย เนื่องจากโค้ดอยู่ในเครื่อง คุณจึงใช้เครื่องมือพัฒนาซอฟต์แวร์ที่คุณชื่นชอบ เช่น git เมื่อสร้างโปรเจ็กต์ Apps Script ได้
จัดการเวอร์ชันของการติดตั้งใช้งาน
สร้าง อัปเดต และดูการใช้งานโปรเจ็กต์หลายรายการ
รหัสโครงสร้าง
clasp ช่วยให้คุณจัดระเบียบโค้ดเป็นไดเรกทอรี ซึ่งจะยังคงอยู่เมื่อคุณอัปโหลดไปยัง script.google.com ตัวอย่างเช่น
# On script.google.com: ├── tests/slides.gs └── tests/sheets.gs # Locally: ├── tests/ │ ├─ slides.gs │ └─ sheets.gs
ข้อกำหนด
clasp เขียนด้วย Node.js และเผยแพร่ผ่านเครื่องมือ npm ก่อนใช้ clasp คุณต้องติดตั้ง Node.js เวอร์ชัน 4.7.4 ขึ้นไป
การติดตั้ง Node.js ต้องใช้สิทธิ์ระดับผู้ดูแลระบบ
การติดตั้ง
เมื่อติดตั้ง Node.js แล้ว คุณจะใช้คำสั่ง npm ต่อไปนี้เพื่อติดตั้ง clasp ได้
npm install @google/clasp -g
หลังจากติดตั้งแล้ว คุณจะใช้คำสั่ง clasp จากไดเรกทอรีใดก็ได้ในคอมพิวเตอร์
กำลังใช้ clasp
คุณสามารถใช้ clasp เพื่อจัดการงานต่างๆ จากบรรทัดคำสั่งได้ ส่วนนี้จะอธิบายการดำเนินการทั่วไปที่คุณสามารถใช้เมื่อพัฒนาด้วย clasp
การเข้าสู่ระบบ
คำสั่งนี้จะเข้าสู่ระบบและอนุญาตให้จัดการโปรเจ็กต์ Apps Script ของบัญชี Google เมื่อเรียกใช้แล้ว ระบบจะขอให้คุณลงชื่อเข้าใช้บัญชี Google ที่เก็บโปรเจ็กต์ Apps Script
clasp login
ออกจากระบบ
คำสั่งนี้จะออกจากระบบเครื่องมือบรรทัดคำสั่ง คุณต้องเข้าสู่ระบบอีกครั้งโดยใช้ clasp login เพื่อตรวจสอบสิทธิ์กับ Google อีกครั้งก่อนใช้ clasp ต่อ
clasp logout
สร้างโปรเจ็กต์ Apps Script ใหม่
คำสั่งนี้จะสร้างสคริปต์ใหม่ในไดเรกทอรีปัจจุบันพร้อมชื่อสคริปต์ (ไม่บังคับ)
clasp create [scriptTitle]
คำสั่งนี้จะสร้างไฟล์ 2 ไฟล์ในไดเรกทอรีปัจจุบันด้วย
- ไฟล์
.clasp.jsonที่เก็บรหัสสคริปต์ - ไฟล์ Manifest ของโปรเจ็กต์
appsscript.jsonที่มีข้อมูลเมตาของโปรเจ็กต์
โคลนโปรเจ็กต์ที่มีอยู่
คำสั่งนี้จะโคลนโปรเจ็กต์ที่มีอยู่ในไดเรกทอรีปัจจุบัน ต้องสร้างหรือแชร์สคริปต์กับบัญชี Google คุณระบุโปรเจ็กต์สคริปต์ที่จะโคลนได้โดยระบุรหัสสคริปต์
หากต้องการค้นหารหัสสคริปต์ของโปรเจ็กต์ ให้ทําตามขั้นตอนด้านล่าง
- เปิดโปรเจ็กต์ Apps Script
- คลิกการตั้งค่าโปรเจ็กต์ ทางด้านซ้าย
คัดลอกรหัสสคริปต์ในส่วนรหัส
clasp clone <scriptId>
ดาวน์โหลดโปรเจ็กต์สคริปต์
คำสั่งนี้จะดาวน์โหลดโปรเจ็กต์ Apps Script จาก Google ไดรฟ์ไปยังระบบไฟล์ของคอมพิวเตอร์
clasp pull
อัปโหลดโปรเจ็กต์สคริปต์
คำสั่งนี้จะอัปโหลดไฟล์ทั้งหมดของโปรเจ็กต์สคริปต์จากคอมพิวเตอร์ไปยัง Google ไดรฟ์
clasp push
แสดงรายการเวอร์ชันโปรเจ็กต์
คำสั่งนี้จะแสดงหมายเลขและคําอธิบายของเวอร์ชันโปรเจ็กต์สคริปต์แต่ละเวอร์ชัน
clasp versions
ติดตั้งใช้งานโปรเจ็กต์ที่เผยแพร่แล้ว
คุณสามารถทำให้โปรเจ็กต์สคริปต์ใช้งานได้เป็นเว็บแอป ส่วนเสริม หรือไฟล์ปฏิบัติการ คุณสามารถสร้างการติดตั้งใช้งานในเครื่องมือแก้ไขสคริปต์ ในไฟล์ Manifest ของโปรเจ็กต์ หรือใช้ clasp
หากต้องการทำให้โปรเจ็กต์พร้อมใช้งานด้วย clasp ก่อนอื่นให้สร้างโปรเจ็กต์ Apps Script เวอร์ชันที่แก้ไขไม่ได้ เวอร์ชันคือ "ภาพรวม" ของโปรเจ็กต์สคริปต์และคล้ายกับรุ่นที่แยกสาขาแบบอ่านอย่างเดียว
clasp version [description]
คำสั่งนี้จะแสดงหมายเลขเวอร์ชันที่สร้างขึ้นใหม่ คุณสามารถใช้หมายเลขดังกล่าวเพื่อทำให้อินสแตนซ์ของโปรเจ็กต์ใช้งานได้และเลิกใช้งานได้ ดังนี้
clasp deploy [version] [description]
clasp undeploy <deploymentId>
คำสั่งนี้จะอัปเดตการใช้งานที่มีอยู่ด้วยเวอร์ชันและคําอธิบายใหม่
clasp redeploy <deploymentId> <version> <description>
แสดงรายการการทำให้ใช้งานได้
คำสั่งนี้จะแสดงรหัส เวอร์ชัน และคำอธิบายของการติดตั้งใช้งานโปรเจ็กต์สคริปต์
clasp deployments
เปิดโปรเจ็กต์ในเครื่องมือแก้ไข Apps Script
คำสั่งนี้จะเปิดโปรเจ็กต์สคริปต์ในเครื่องมือแก้ไข Apps Script เครื่องมือแก้ไขจะเปิดเป็นแท็บใหม่ในเว็บเบราว์เซอร์เริ่มต้น
clasp open
มีส่วนร่วมในโปรเจ็กต์โอเพนซอร์ส clasp
มีส่วนร่วมใน clasp ใน GitHub