TypeScript to typowy nadzbiór kodu JavaScript, który można kompilować do zwykłego języka Apps Script. Używanie TypeScriptu do tworzenia projektu Apps Script wiąże się z następującymi korzyściami:
- Autouzupełnianie lokalnego IDE
- Opcjonalne pisanie strukturalne
- Wnioskowanie o typ, interfejsy
- Funkcje ES6, takie jak klasy i funkcje strzałek.
W tym przewodniku opisano kilka typowych zadań związanych z programowaniem projektu Apps Script przy użyciu języka TypeScript.
Wymagania
Jeśli nie znasz języka TypeScript, zapoznaj się z dokumentacją TypeScript i krótkim wprowadzeniem do TypeScriptu, aby poznać podstawowe pojęcia, zanim zaczniesz korzystać z procedur opisanych w tym przewodniku.
Poniższe narzędzia są wymagane do korzystania z TypeScriptu w projektach Apps Script w clasp
. Chociaż używanie clasp
nie jest ściśle wymagane do umożliwienia korzystania z TypeScriptu w Apps Script, zdecydowanie zalecamy jego stosowanie, ponieważ znacznie upraszcza ono procedury.
Zanim spróbujesz wykonać którykolwiek z opisanych poniżej procesów, zainstaluj te rozwiązania, aby włączyć lokalne środowisko programistyczne:
- Węzeł i npm
clasp
:npm install -g @google/clasp
- Definicje typów dla Apps Script:
npm i -S @types/google-apps-script
- Visual Studio Code (na potrzeby autouzupełniania w IDE TypeScript)
Jeśli nie korzystasz jeszcze z usługi clasp
, zapoznaj się z dokumentacją usługi clasp
.
Używanie TypeScriptu w projekcie Clasp
Aby szybko utworzyć nowy lokalny projekt Apps Script, możesz użyć polecenia clasp
.
To polecenie tworzy appsscript.json
i Code.gs
, które są podstawą projektu Apps Script.
Aby używać TypeScriptu w pliku App Script, po prostu zmień rozszerzenie pliku z gs
na ts
.
Edytuj lokalne pliki TypeScript
W preferowanym edytorze możesz zapisywać lokalne pliki TypeScript jako pliki .ts
w folderze projektu.
Na przykład plik o nazwie index.ts
może zawierać taki kod TypeScript:
const greeter = (person: string) => {
return `Hello, ${person}!`;
}
let user = 'Grant';
Logger.log(greeter(user));
Możesz pisać w języku TypeScript przy użyciu funkcji w wersji ES6+, takich jak funkcje strzałek i interpolacja ciągów znaków (${var}
). Pliki te są transpilowane w język Apps Script konstruowane po przekazaniu projektu na serwer Apps Script.
Prześlij lokalny projekt Apps Script, który korzysta z TypeScriptu
Po zakończeniu edytowania lokalnych plików TypeScript i Apps Script możesz przesłać je na Dysk Google, korzystając z tego polecenia clasp
:
clasp push --watch
Polecenie to monitoruje zmiany w pliku TypeScript i używa polecenia 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 napotkasz problem z narzędziem clasp
, możesz go zgłosić na GitHub.
Jeśli napotkasz problem lub błąd z samym TypeScriptem, możesz go zgłosić w repozytorium TypeScript na GitHubie.