Để phát triển và quản lý các dự án Google Apps Script từ thiết bị đầu cuối thay vì trình chỉnh sửa Apps Script, hãy sử dụng công cụ nguồn mở clasp.
Lớp học lập trình clasp cung cấp thông tin tổng quan về tất cả các tính năng của clasp.
Tính năng
clasp bao gồm các tính năng sau:
Phát triển cục bộ
clasp cho phép bạn phát triển các dự án Apps Script cục bộ. Viết mã trên máy tính của riêng bạn và tải mã đó lên Apps Script khi hoàn tất. Bạn cũng có thể tải các dự án Apps Script hiện có xuống để chỉnh sửa khi không có mạng. Sử dụng các công cụ phát triển mà bạn yêu thích, chẳng hạn như git khi xây dựng các dự án Apps Script.
Quản lý các phiên bản triển khai
Tạo, cập nhật và xem nhiều lượt triển khai dự án của bạn.
Mã cấu trúc
clasp cho phép bạn sắp xếp mã thành các thư mục. Các thư mục này sẽ được giữ nguyên khi bạn tải mã lên script.google.com. Ví dụ:
# On script.google.com: ├── tests/slides.gs └── tests/sheets.gs # Locally: ├── tests/ │ ├─ slides.gs │ └─ sheets.gs
Loại dự án
Bạn có thể sử dụng clasp để quản lý cả dự án tập lệnh độc lập và dự án tập lệnh liên kết với vùng chứa.
Dự án độc lập
Một dự án độc lập sẽ xuất hiện dưới dạng một tệp riêng biệt trong Google Drive. Bạn có thể tạo một tập lệnh độc lập mới bằng lệnh clasp create.
Dự án bị ràng buộc với vùng chứa
Dự án liên kết với vùng chứa được đính kèm vào một tệp Google Tài liệu, Trang tính, Trang trình bày hoặc Google Biểu mẫu. Bạn có thể tạo một tập lệnh mới được liên kết với vùng chứa và đính kèm tập lệnh đó vào một tệp mới bằng lệnh clasp create. Bạn cũng có thể đính kèm một tập lệnh mới vào một tệp hiện có bằng cờ --parentId.
Các loại dự án khác
clasp cũng hỗ trợ việc tạo tập lệnh cho các ứng dụng web và API.
Yêu cầu
clasp được viết bằng Node.js và phân phối bằng công cụ npm. Trước khi sử dụng clasp, bạn phải cài đặt Node.js phiên bản 20.0.0 trở lên.
Bạn phải có đặc quyền của quản trị viên để cài đặt Node.js.
Cài đặt
Sau khi cài đặt Node.js, hãy dùng lệnh npm sau đây để cài đặt clasp:
npm install @google/clasp -g
Sau khi cài đặt, hãy sử dụng lệnh clasp từ bất kỳ thư mục nào trên máy tính.
Sử dụng clasp
Dùng clasp để xử lý nhiều tác vụ từ dòng lệnh. Phần này mô tả các thao tác thường dùng khi phát triển bằng clasp.
Đăng nhập
Lệnh này đăng nhập và cho phép quản lý các dự án Apps Script trong Tài khoản Google của bạn. Sau khi chạy, bạn sẽ được yêu cầu đăng nhập vào một Tài khoản Google nơi lưu trữ các dự án Apps Script của bạn.
clasp login
Đăng xuất
Lệnh này sẽ đăng xuất khỏi công cụ dòng lệnh. Đăng nhập lại bằng clasp login để xác thực lại bằng Google trước khi tiếp tục sử dụng clasp.
clasp logout
Tạo một dự án Apps Script mới
Lệnh này tạo một tập lệnh mới trong thư mục hiện tại với tiêu đề tập lệnh không bắt buộc.
clasp create [scriptTitle] [--type <projectType>] [--parentId <parentId>]
Lệnh này sử dụng các tham số không bắt buộc sau:
scriptTitle: Tiêu đề của dự án tập lệnh.--type <projectType>: Loại dự án cần tạo. Các giá trị được phép làstandalone,docs,sheets,slides,forms,webappvàapi.--parentId <parentId>: Mã nhận dạng của tệp hiện có trên Google Drive (Tài liệu, Trang tính, Trang trình bày hoặc Biểu mẫu) mà dự án tập lệnh mới sẽ được liên kết.
Lệnh này cũng tạo ra 2 tệp trong thư mục hiện tại:
- Tệp
.clasp.jsonlưu trữ mã tập lệnh. - Tệp kê khai dự án
appsscript.jsonchứa siêu dữ liệu dự án.
Sao chép một dự án hiện có
Lệnh này sao chép một dự án hiện có trong thư mục hiện tại. Tập lệnh phải được tạo hoặc chia sẻ với Tài khoản Google của bạn. Bạn chỉ định dự án tập lệnh cần sao chép bằng cách cung cấp mã tập lệnh của dự án đó. Bạn có thể sao chép cả dự án độc lập và dự án bị ràng buộc với vùng chứa.
Cách tìm mã tập lệnh của dự án:
- Mở dự án Apps Script.
- Ở bên trái, hãy nhấp vào Cài đặt dự án .
Trong mục Mã nhận dạng, hãy sao chép Mã tập lệnh.
clasp clone
Tải dự án tập lệnh xuống
Lệnh này tải dự án Apps Script xuống hệ thống tệp của máy tính từ Google Drive.
clasp pull
Tải một dự án tập lệnh lên
Lệnh này tải tất cả các tệp của dự án tập lệnh từ máy tính lên Drive.
clasp push
Liệt kê các phiên bản dự án
Lệnh này liệt kê số lượng và nội dung mô tả của từng phiên bản dự án tập lệnh.
clasp versions
Triển khai dự án đã xuất bản
Triển khai các dự án tập lệnh dưới dạng ứng dụng web, tiện ích bổ sung của Google Workspace hoặc tệp thực thi. Tạo các lượt triển khai trong trình chỉnh sửa tập lệnh, trong tệp kê khai dự án hoặc bằng cách sử dụng clasp.
Để triển khai một dự án bằng clasp, trước tiên, hãy tạo một phiên bản bất biến của dự án Apps Script. Phiên bản là "ảnh chụp nhanh" của một dự án tập lệnh và tương tự như một bản phát hành phân nhánh chỉ đọc.
clasp version [description]
Lệnh này sẽ hiển thị số hiệu phiên bản mới tạo. Sử dụng số đó để triển khai và huỷ triển khai các phiên bản của dự án:
clasp deploy [version] [description]
clasp undeploy <deploymentId>
Lệnh này sẽ cập nhật một bản triển khai hiện có bằng phiên bản và nội dung mô tả mới:
clasp redeploy <deploymentId> <version> <description>
Liệt kê các đợt triển khai
Lệnh này liệt kê mã nhận dạng quy trình triển khai, phiên bản và nội dung mô tả của dự án tập lệnh.
clasp deployments
Mở dự án trong trình chỉnh sửa Apps Script
Lệnh này sẽ mở một dự án tập lệnh trong trình chỉnh sửa Apps Script. Trình chỉnh sửa sẽ mở ra dưới dạng một thẻ mới trong trình duyệt web mặc định của bạn.
clasp open-script
Đóng góp cho dự án nguồn mở clasp
Đóng góp cho clasp trên GitHub.