TypeScript là một tập mẹ JavaScript đã nhập, 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ẽ nhận được các lợi ích sau:
- Tự động hoàn thành IDE cục bộ
- Nhập có cấu trúc không bắt buộ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ố thao tác phổ biến để phát triển dự án Apps Script bằng TypeScript.
Yêu cầu
Nếu bạn chưa hiểu rõ về TypeScript, hãy xem lại tài liệu về TypeScript và hướng dẫn bắt đầu nhanh 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 để 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 cho phép sử dụng TypeScript trong Apps Script, nhưng bạn nên sử dụng clasp
vì phương thức này giúp đơn giản hoá 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 đảm bảo bạn đã cài đặt các quy trình 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 loại cho Apps Script:
npm i -S @types/google-apps-script
- Mã Visual Studio (dành cho tính năng tự động hoàn thành IDE TypeScript)
Hãy nhớ làm quen với tài liệu về clasp
nếu 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 dự án Apps Script mới trên máy.
Lệnh này tạo một appsscript.json
và Code.gs
, là cơ sở của 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 các tệp TypeScript cục bộ
Bằng cách sử dụng trình chỉnh sửa ưu tiê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 index.ts
có thể chứa 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 trở lên, chẳng hạn như hàm mũi tên và loại nội suy chuỗi (${var}
). Các tệp này sẽ được sao chép vào các cấu trúc Apps Script khi bạn đẩy dự án lên máy chủ Apps Script.
Tải 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 trên máy lên Google Drive bằng lệnh clasp
sau:
clasp push --watch
Lệnh này theo dõi các thay đổi của tệp TypeScript, đồng thời sử dụng typescript
để biên dịch mã và sử dụng clasp
để tải dự án lên Google Drive.
Báo cáo sự cố hoặc yêu cầu về tính năng của tệp
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 sự cố hoặc lỗi với TypeScript, bạn có thể báo cáo sự cố đó trong kho lưu trữ GitHub của TypeScript.