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