TypeScript는 자바스크립트의 유형이 있는 상위 집합으로 일반 Apps Script로 컴파일할 수 있습니다. Apps Script 프로젝트를 개발할 때 TypeScript를 사용하면 다음과 같은 이점이 있습니다.
이 가이드에서는 TypeScript로 Apps Script 프로젝트를 개발하는 일반적인 작업을 설명합니다.
요구사항
TypeScript에 익숙하지 않은 경우 이 가이드에 설명된 절차를 시도하기 전에 TypeScript 문서 및 TypeScript 빠른 시작을 검토하여 기본 개념을 숙지하세요.
clasp
로 Apps Script 프로젝트에서 TypeScript를 사용하려면 다음 도구가 필요합니다. Apps Script에서 TypeScript를 사용하도록 설정하기 위해 clasp
를 반드시 사용할 필요는 없지만 절차가 크게 간소화되므로 이 방법을 사용하는 것이 좋습니다.
아래 설명된 프로세스를 시도하기 전에 다음을 설치하여 로컬 개발 환경을 사용 설정했는지 확인합니다.
- 노드 및 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 드라이브에 업로드할 수 있습니다.
clasp push --watch
이 명령어는 TypeScript 파일 변경사항을 감시하고 typescript
를 사용하여 코드를 컴파일하고 clasp
를 사용하여 프로젝트를 Google Drive에 업로드합니다.
문제 신고 또는 기능 요청 제출
clasp
도구에 문제가 발생하면 GitHub에서 신고할 수 있습니다.
TypeScript 자체에 문제나 버그가 있으면 TypeScript의 GitHub 저장소에 신고할 수 있습니다.