Per sviluppare e gestire i progetti Apps Script dal terminale anziché dall'editor Apps Script, puoi utilizzare uno strumento open source chiamato clasp
.
Il clasp
codelab fornisce una panoramica di tutte le funzionalità di
clasp
.
Funzionalità
Sviluppare localmente
clasp
ti consente di sviluppare i tuoi progetti Apps Script a livello locale. Puoi
scrivere codice sul tuo computer e caricarlo su Apps Script al termine
dell'operazione. Puoi anche scaricare i progetti Apps Script esistenti per modificarli
quando sei offline. Poiché il codice è locale, puoi utilizzare i tuoi strumenti di sviluppo preferiti, come git
, quando crei progetti Apps Script.
Gestire le versioni del deployment
Crea, aggiorna e visualizza le implementazioni multiple del tuo progetto.
Codice struttura
clasp
ti consente di organizzare il codice in directory, che vengono conservate
quando le carichi su script.google.com. Ad esempio:
# On script.google.com: ├── tests/slides.gs └── tests/sheets.gs # Locally: ├── tests/ │ ├─ slides.gs │ └─ sheets.gs
Requisiti
clasp
è scritto in Node.js e distribuito tramite
lo strumento npm
. Prima di utilizzare clasp
, devi aver installato
Node.js versione 4.7.4 o successive.
L'installazione di Node.js richiede privilegi amministrativi.
Installazione
Dopo aver installato Node.js, puoi utilizzare il seguente comando npm
per installare clasp
:
npm install @google/clasp -g
Dopo l'installazione, puoi utilizzare il comando clasp
da qualsiasi directory del computer.
In uso: clasp
Puoi utilizzare clasp
per gestire una serie di attività dalla riga di comando. Questa
sezione descrive le operazioni comuni che puoi utilizzare durante lo sviluppo con clasp
.
Accedi
Questo comando esegue l'accesso e autorizza la gestione dei progetti Apps Script del tuo Account Google. Una volta eseguito, ti viene chiesto di accedere a un Account Google in cui sono archiviati i tuoi progetti Apps Script.
clasp login
Esci
Questo comando esegue la disconnessione dallo strumento a riga di comando. Devi accedere di nuovo utilizzando
clasp login
per eseguire nuovamente l'autenticazione con Google prima di continuare a utilizzare clasp
.
clasp logout
Crea un nuovo progetto Apps Script
Questo comando crea un nuovo script nella directory corrente con un titolo opzionale.
clasp create [scriptTitle]
Questo comando crea anche due file nella directory corrente:
- Un file
.clasp.json
che memorizza l'ID script. - Un file manifest del progetto
appsscript.json
contenente i metadati del progetto.
Clonare un progetto esistente
Questo comando clona un progetto esistente nella directory corrente. Lo script deve essere creato o condiviso con il tuo Account Google. Specifichi il progetto di script da clonare fornendo il relativo ID script.
Per trovare l'ID script del progetto, segui questi passaggi:
- Apri il progetto Apps Script.
- A sinistra, fai clic su Impostazioni progetto .
In ID, copia l'ID script.
clasp clone <scriptId>
Scaricare un progetto di script
Questo comando scarica il progetto Apps Script da Google Drive al file system del computer.
clasp pull
Caricare un progetto di script
Questo comando carica tutti i file di un progetto di script dal computer a Google Drive.
clasp push
Elenco delle versioni del progetto
Questo comando elenca il numero e la descrizione di ciascuna versione di un progetto di script.
clasp versions
Eseguire il deployment di un progetto pubblicato
Puoi eseguire il deployment dei progetti di script come app web, componenti aggiuntivi o eseguibili. Puoi
creare deployment nell'editor di script,
nel manifest del progetto o utilizzando clasp
.
Per eseguire il deployment di un progetto con clasp
, crea prima una versione immutabile del progetto Apps
Script. Una versione è uno "snapshot" di un progetto di script ed è simile a
una release ramificata di sola lettura.
clasp version [description]
Questo comando mostra il numero di versione appena creato. Utilizzando questo numero, puoi eseguire il deployment e l'annullamento del deployment delle istanze del tuo progetto:
clasp deploy [version] [description]
clasp undeploy <deploymentId>
Questo comando aggiorna un deployment esistente con una nuova versione e descrizione:
clasp redeploy <deploymentId> <version> <description>
Elenca implementazioni
Questo comando elenca gli ID deployment, le versioni e le relative descrizioni del progetto di script.
clasp deployments
Apri il progetto nell'editor di Apps Script
Questo comando apre un progetto di script nell'editor di Apps Script. L'editor viene avviato come nuova scheda nel browser web predefinito.
clasp open
Contribuire al progetto open source clasp
Contribuisci a clasp
su GitHub.