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

เพื่อพัฒนาและจัดการโครงการสคริปต์ 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 ของคุณ คุณระบุสคริปต์ โคลนด้วยการระบุรหัสสคริปต์

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

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

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

     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