เพื่อพัฒนาและจัดการโครงการสคริปต์ Apps จากเทอร์มินัลของคุณแทน
เครื่องมือแก้ไข 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
การเข้าสู่ระบบ
คำสั่งนี้จะเข้าสู่ระบบและให้สิทธิ์ในการจัดการบัญชี Google โปรเจ็กต์ Apps Script เมื่อเรียกใช้แล้ว คุณจะถูกขอให้ลงชื่อเข้าใช้ บัญชีที่จัดเก็บโปรเจ็กต์ 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 เวอร์ชันที่เปลี่ยนแปลงไม่ได้ก่อน
โปรเจ็กต์สคริปต์ เวอร์ชันจะเป็น "สแนปชอต" ของโครงการสคริปต์ และคล้ายกับ
รุ่นที่มีการแยกเวอร์ชันแบบอ่านอย่างเดียว
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