TypeScript là một tập hợp con đượ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ẽ nhận được các lợi ích sau:
- Tự động hoàn thành IDE cục bộ
- Kiểu cấu trúc không bắt buộc
- Suy luận kiể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ố nhiệm vụ phổ biến để phát triển dự án Apps Script bằng TypeScript.
Yêu cầu
Nếu bạn chưa quen với TypeScript, hãy xem lại 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 để sử dụng TypeScript trong các dự án Apps Script bằng clasp. Mặc dù không bắt buộc phải sử dụng clasp để bật tính năng sử dụng TypeScript trong Apps Script, nhưng bạn nên sử 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 đảm bảo bạn đã cài đặt những 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 loại cho Apps Script:
npm i -S @types/google-apps-script - Visual Studio Code (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 một dự án Apps Script mới trên máy.
Lệnh này tạo appsscript.json và Code.gs, cơ sở của dự án Apps Script.
Để sử dụng TypeScript trong tệp Apps 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ộ
Khi sử dụng trình chỉnh sửa bạn muốn, bạn có thể viết 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ụ: tệp có tên 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+ như hàm mũi tên và nội suy chuỗi (${var}). Các tệp này được chuyển đổi sang cấu trúc Apps Script khi bạn đẩy dự án đến máy chủ Apps Script.
Tải một dự án Apps Script cục bộ lên sử dụng TypeScript
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ã và 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 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.