Per sviluppare e gestire i progetti Apps Script dal tuo terminale anziché dall'editor Apps Script, puoi utilizzare uno strumento open source chiamato clasp.
Il codelab di clasp fornisce una panoramica di tutte
le funzionalità di clasp.
Funzionalità
Sviluppa localmente
clasp ti consente di sviluppare progetti Apps Script in locale. Puoi scrivere il codice sul tuo computer e caricarlo in Apps Script al termine dell'operazione. Puoi anche scaricare progetti Apps Script esistenti per poterli modificare quando sei offline. Poiché il codice è locale, puoi utilizzare i tuoi strumenti di sviluppo preferiti come git per creare progetti Apps Script.
Gestisci le versioni del deployment
Crea, aggiorna e visualizza i vari deployment del tuo progetto.
Codice struttura
clasp 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 avere installato Node.js versione 4.7.4 o successiva.
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 sul 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 accede e autorizza la gestione dei progetti Apps Script del tuo Account Google. Dopo l'esecuzione, ti verrà chiesto di accedere a un Account Google in cui sono archiviati i tuoi progetti Apps Script.
clasp login
Disconnessione
Questo comando esce dallo strumento a riga di comando. Devi eseguire di nuovo l'accesso 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 facoltativo per lo script.
clasp create [scriptTitle]
Questo comando crea anche due file nella directory corrente:
- Un file
.clasp.jsonin cui è memorizzato l'ID script. - Un file manifest del progetto
appsscript.jsoncontenente i metadati del progetto.
clona un progetto esistente
Questo comando clona un progetto esistente nella directory attuale. Lo script deve essere creato o condiviso con il tuo Account Google. Puoi specificare il progetto di script da clonare fornendone l'ID script.
Per trovare l'ID script del progetto:
- Apri il progetto Apps Script.
- A sinistra, fai clic su Impostazioni progetto .
In ID, copia l'ID script.
clasp clone <scriptId>
Scarica un progetto di script
Questo comando scarica il progetto Apps Script da Google Drive nel file system del tuo computer.
clasp pull
Carica 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 delle versioni di un progetto di script.
clasp versions
Esegui il deployment di un progetto pubblicato
Puoi eseguire il deployment dei progetti di script come app web, componenti aggiuntivi o eseguibili. Puoi creare i 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 è un'"istantanea" di un progetto di script ed è simile a una release con ramificazioni di sola lettura.
clasp version [description]
Questo comando visualizza il numero di versione appena creato. Utilizzando questo numero, puoi eseguire il deployment delle istanze del tuo progetto e annullarne il deployment:
clasp deploy [version] [description]
clasp undeploy <deploymentId>
Questo comando aggiorna un deployment esistente con una nuova versione e una nuova 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
Dai il tuo contributo al progetto open source clasp
Dai il tuo contributo a clasp su GitHub.