ใช้อินเทอร์เฟซบรรทัดคำสั่งด้วยตัวประสาน

หากต้องการพัฒนาและจัดการโปรเจ็กต์ 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ไฟล์ที่จัดเก็บรหัสสคริปต์
• appsscript.json ไฟล์ Manifest ของโปรเจ็กต์ที่มีข้อมูลเมตาของโปรเจ็กต์

โคลนโปรเจ็กต์ที่มีอยู่

คำสั่งนี้จะโคลนโปรเจ็กต์ที่มีอยู่ในไดเรกทอรีปัจจุบัน สคริปต์ ต้องสร้างหรือแชร์กับบัญชี Google ของคุณ คุณระบุโปรเจ็กต์สคริปต์ ที่จะโคลนได้โดยระบุรหัสสคริปต์

หากต้องการค้นหารหัสสคริปต์ของโปรเจ็กต์ ให้ทำตามขั้นตอนด้านล่าง

1. เปิดโปรเจ็กต์ Apps Script
2. คลิกการตั้งค่าโปรเจ็กต์ ทางด้านซ้าย

3. คัดลอกรหัสสคริปต์ในส่วนรหัส

    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