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