TypeScript to rozszerzenie JavaScriptu z określonymi typami, które można skompilować do zwykłego Apps Script. Korzystanie z TypeScriptu podczas tworzenia projektu Apps Script daje te korzyści:
- Autouzupełnianie w lokalnym środowisku IDE
- Opcjonalne pisanie strukturalne
- wnioskowanie o typie, interfejsy
- funkcje ES6, takie jak klasy i funkcje strzałkowe;
Ten przewodnik zawiera opis niektórych typowych zadań związanych z tworzeniem projektu Apps Script w TypeScript.
Wymagania
Jeśli nie znasz języka TypeScript, zapoznaj się z dokumentacją i krótkim wprowadzeniem do tego języka, aby poznać podstawowe pojęcia przed wykonaniem procedur opisanych w tym przewodniku.
Aby używać TypeScriptu w projektach Apps Script z clasp, musisz mieć te narzędzia: Korzystanie z clasp nie jest bezwzględnie konieczne, aby włączyć TypeScript w Apps Script, ale jest zdecydowanie zalecane, ponieważ znacznie upraszcza procedury.
Zanim spróbujesz wykonać którąkolwiek z opisanych poniżej czynności, upewnij się, że masz zainstalowane te elementy, aby włączyć lokalne środowisko deweloperskie:
- Node i npm
clasp:npm install -g @google/clasp- Definicje typów w Apps Script:
npm i -S @types/google-apps-script - Visual Studio Code (do autouzupełniania w IDE TypeScript)
Jeśli nie korzystasz jeszcze z clasp, zapoznaj się z clasp dokumentacją
.
Używanie TypeScriptu w projekcie Clasp
Możesz użyć clasp, aby szybko utworzyć nowy lokalny projekt Apps Script.
To polecenie tworzy pliki appsscript.json i Code.gs, które są podstawą projektu Apps Script.
Aby używać TypeScriptu w pliku Apps Script, wystarczy zmienić rozszerzenie pliku z gs na ts.
Edytowanie lokalnych plików TypeScript
W wybranym edytorze możesz pisać lokalne pliki TypeScript jako pliki .ts w folderze projektu.
Na przykład plik o nazwie index.ts może zawierać ten kod TypeScript:
const greeter = (person: string) => {
return `Hello, ${person}!`;
}
let user = 'Grant';
Logger.log(greeter(user));
Możesz pisać w TypeScript z funkcjami ES6+, takimi jak funkcje strzałkowe i interpolacja ciągów znaków (${var}). Te pliki są transpilowane do konstrukcji Apps Script, gdy przesyłasz projekt na serwer Apps Script.
Przesyłanie lokalnego projektu Apps Script, który korzysta z TypeScript
Po zakończeniu edycji lokalnych plików TypeScript i Apps Script możesz przesłać je na Dysk Google za pomocą tego polecenia:clasp
clasp push --watch
To polecenie śledzi zmiany w plikach TypeScript i używa typescript do kompilowania kodu oraz clasp do przesyłania projektu na Dysk Google.
Zgłaszanie problemów i przesyłanie próśb o dodanie funkcji
Jeśli wystąpi problem z clasp, możesz go zgłosić na GitHub.
Jeśli napotkasz problem lub błąd w samym języku TypeScript, możesz go zgłosić w repozytorium GitHub TypeScript.