TypeScript là một siêu tập hợp được nhập của JavaScript có thể biên dịch thành Apps Script thuần tuý. Khi sử dụng TypeScript trong quá trình phát triển dự án Apps Script, bạn sẽ được hưởng những lợi ích sau:
- Tính năng tự động hoàn thành IDE cục bộ
- Không bắt buộc nhập có cấu trúc
- Suy luận kiểu dữ liệu, giao diện
- Các tính năng ES6 như lớp và hàm mũi tên.
Hướng dẫn này trình bày một số tác vụ thường gặp khi phát triển một dự án Apps Script bằng TypeScript.
Yêu cầu
Nếu bạn chưa quen với TypeScript, hãy xem tài liệu về TypeScript và hướng dẫn bắt đầu nhanh về TypeScript để làm quen với các khái niệm cơ bản trước khi thử bất kỳ quy trình nào được mô tả trong hướng dẫn này.
Bạn cần có các công cụ sau đây để sử dụng TypeScript trong các dự án Apps Script bằng clasp. Mặc dù không nhất thiết phải dùng clasp để bật tính năng sử dụng TypeScript trong Apps Script, nhưng bạn nên dùng vì tính năng này giúp đơn giản hoá đáng kể các quy trình.
Trước khi thử bất kỳ quy trình nào được mô tả bên dưới, hãy nhớ cài đặt những thành phần sau để bật môi trường phát triển cục bộ:
- Node và npm
clasp:npm install -g @google/clasp- Định nghĩa kiểu cho Apps Script:
npm i -S @types/google-apps-script - Visual Studio Code (để tự động hoàn thành IDE TypeScript)
Hãy nhớ làm quen với tài liệu clasp
nếu trước đây bạn chưa từng sử dụng clasp.
Sử dụng TypeScript trong Dự án Clasp
Bạn có thể sử dụng clasp để nhanh chóng tạo một dự án Apps Script cục bộ mới.
Lệnh này tạo ra appsscript.json và Code.gs, cơ sở của một dự án Apps Script.
Để sử dụng TypeScript trong tệp App Script, bạn chỉ cần đổi tên đuôi tệp từ gs thành ts.
Chỉnh sửa tệp TypeScript cục bộ
Bằng trình chỉnh sửa mà bạn muốn, bạn có thể ghi các tệp TypeScript cục bộ dưới dạng tệp .ts trong thư mục của dự án.
Ví dụ: một tệp có tên là index.ts có thể có mã TypeScript sau:
const greeter = (person: string) => {
return `Hello, ${person}!`;
}
let user = 'Grant';
Logger.log(greeter(user));
Bạn có thể viết TypeScript bằng các tính năng ES6+, chẳng hạn như hàm mũi tên và nội suy chuỗi (${var}). Các tệp này sẽ được chuyển đổi thành các cấu trúc Apps Script khi bạn đẩy dự án lên máy chủ Apps Script.
Tải một dự án Apps Script cục bộ sử dụng TypeScript lên
Khi chỉnh sửa xong các tệp TypeScript và Apps Script cục bộ, bạn có thể tải các tệp cục bộ lên Google Drive bằng lệnh clasp sau:
clasp push --watch
Lệnh này theo dõi các thay đổi đối với tệp TypeScript và sử dụng typescript để biên dịch mã cũng như clasp để tải dự án lên Google Drive.
Báo cáo vấn đề hoặc gửi yêu cầu về tính năng
Nếu gặp vấn đề với công cụ clasp, bạn có thể báo cáo vấn đề đó trên GitHub.
Nếu gặp phải vấn đề hoặc lỗi với chính TypeScript, bạn có thể báo cáo vấn đề hoặc lỗi đó trong kho lưu trữ GitHub của TypeScript.