TypeScript는 유형이 있는 JavaScript 상위 집합으로, 일반 Apps Script로 컴파일할 수 있습니다. Apps Script 프로젝트 개발에 TypeScript를 사용하면 다음과 같은 이점이 있습니다.
이 가이드에서는 TypeScript로 Apps Script 프로젝트를 개발할 때의 몇 가지 일반적인 작업을 다룹니다.
요구사항
TypeScript에 익숙하지 않은 경우 이 가이드에 설명된 절차를 시도하기 전에 TypeScript 문서 및 TypeScript 빠른 시작을 검토하여 기본 개념을 숙지하세요.
clasp를 사용하여 Apps Script 프로젝트에서 TypeScript를 사용하려면 다음 도구가 필요합니다. Apps Script에서 TypeScript를 사용 설정하는 데 clasp가 반드시 필요한 것은 아니지만 절차를 크게 간소화하므로 사용하는 것이 좋습니다.
아래에 설명된 프로세스를 시도하기 전에 로컬 개발 환경을 사용 설정하기 위해 다음을 설치했는지 확인하세요.
- Node 및 npm
clasp:npm install -g @google/clasp- Apps Script의 유형 정의:
npm i -S @types/google-apps-script - Visual Studio Code(TypeScript IDE 자동 완성용)
이전에 clasp을 사용한 적이 없다면 clasp 문서
를 숙지하세요.
Clasp 프로젝트에서 TypeScript 사용
clasp를 사용하여 새 로컬 Apps Script 프로젝트를 만들 수 있습니다.
이 명령어는 Apps Script 프로젝트의 기본인 appsscript.json 및 Code.gs를 만듭니다.
App Script 파일에서 TypeScript를 사용하려면 파일 확장자를 gs에서 ts로 바꾸면 됩니다.
로컬 TypeScript 파일 수정
원하는 편집기를 사용하여 프로젝트 폴더에 로컬 TypeScript 파일을 .ts 파일로 작성할 수 있습니다.
예를 들어 index.ts이라는 파일에는 다음 TypeScript 코드가 있을 수 있습니다.
const greeter = (person: string) => {
return `Hello, ${person}!`;
}
let user = 'Grant';
Logger.log(greeter(user));
화살표 함수 및 문자열 삽입 (${var})과 같은 ES6+ 기능을 사용하여 TypeScript를 작성할 수 있습니다. 이러한 파일은 프로젝트를 Apps Script 서버로 푸시할 때 Apps Script 구조로 트랜스파일됩니다.
TypeScript를 사용하는 로컬 Apps Script 프로젝트 업로드
로컬 TypeScript 및 Apps Script 파일의 수정이 완료되면 다음 clasp 명령어를 사용하여 로컬 파일을 Google Drive에 업로드할 수 있습니다.
clasp push --watch
이 명령어는 TypeScript 파일 변경사항을 감시하고 typescript를 사용하여 코드를 컴파일하고 clasp를 사용하여 프로젝트를 Google Drive에 업로드합니다.
문제 신고 또는 기능 요청 제출
clasp 도구에 문제가 발생하면 GitHub에 신고할 수 있습니다.
TypeScript 자체에 문제가 발생하면 TypeScript의 GitHub 저장소에 신고할 수 있습니다.