หากต้องการพัฒนาและจัดการโปรเจ็กต์ 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