TypeScript è un superset tipizzato di JavaScript che può essere compilato in Apps Script semplice. Quando utilizzi TypeScript nello sviluppo di un progetto Apps Script, ottieni i seguenti vantaggi:
- Completamento automatico dell'IDE locale
- Digitazione strutturale facoltativa
- Inferenza dei tipi, interfacce
- Funzionalità ES6 come classi e funzioni freccia.
Questa guida illustra alcune attività comuni per lo sviluppo di un progetto Apps Script con TypeScript.
Requisiti
Se non hai familiarità con TypeScript, consulta la documentazione di TypeScript e la guida rapida di TypeScript per acquisire familiarità con i concetti di base prima di tentare una delle procedure descritte in questa guida.
Per utilizzare TypeScript nei progetti Apps Script con clasp, sono necessari i seguenti strumenti. Sebbene l'utilizzo di clasp non sia
strettamente necessario per attivare l'utilizzo di TypeScript in Apps Script, è vivamente
consigliato in quanto semplifica notevolmente le procedure.
Prima di tentare una delle procedure descritte di seguito, assicurati di aver installato quanto segue per attivare l'ambiente di sviluppo locale:
- Node e npm
clasp:npm install -g @google/clasp- Definizioni dei tipi per Apps Script:
npm i -S @types/google-apps-script - Visual Studio Code (per il completamento automatico dell'IDE TypeScript)
Se non hai mai utilizzato clasp, assicurati di acquisire familiarità con la documentazione di clasp
.
Utilizzo di TypeScript in un progetto Clasp
Puoi utilizzare clasp per
creare rapidamente un nuovo progetto Apps Script locale.
Questo comando crea un appsscript.json e un Code.gs, la base di un progetto Apps
Script.
Per utilizzare TypeScript in un file Apps Script, è sufficiente rinominare l'estensione del file da
gs a ts.
Modificare i file TypeScript locali
Utilizzando l'editor che preferisci, puoi scrivere file TypeScript locali come file .ts
nella cartella del progetto.
Ad esempio, un file denominato index.ts potrebbe contenere il seguente codice
TypeScript:
const greeter = (person: string) => {
return `Hello, ${person}!`;
}
let user = 'Grant';
Logger.log(greeter(user));
Puoi scrivere TypeScript con funzionalità ES6+ come
funzioni freccia
e interpolazione di stringhe (${var}). Questi file vengono transpilati in costrutti Apps Script quando esegui il push del progetto sul server Apps Script.
Carica un progetto Apps Script locale che utilizza TypeScript
Al termine della modifica dei file TypeScript e Apps Script locali, puoi caricare i file locali su Google Drive utilizzando il seguente comando clasp:
clasp push --watch
Questo comando monitora le modifiche ai file TypeScript e utilizza typescript per compilare
il codice e clasp per caricare il progetto su Google Drive.
Segnalare problemi o inviare richieste di funzionalità
Se riscontri un problema con lo strumento clasp, puoi segnalarlo su
GitHub.
Se riscontri un problema o un bug con TypeScript stesso, puoi segnalarlo nel repository GitHub di TypeScript.