Per sviluppare e gestire progetti Apps Script dal tuo terminale anziché
in Apps Script, puoi usare uno strumento open source chiamato clasp
.
Il codelab clasp
fornisce una panoramica di tutti
clasp
funzionalità.
Funzionalità
Sviluppo locale
clasp
ti consente di sviluppare i tuoi progetti Apps Script localmente. Puoi
scrivere il codice sul proprio computer e caricarlo in Apps Script quando
fatto. Puoi anche scaricare progetti Apps Script esistenti in modo da poterli modificare
quando sei offline. Poiché il codice è locale, puoi usare il tuo
di sviluppo software come git
durante la creazione di Apps Script
in modo programmatico
a gestire i progetti.
Gestisci versioni deployment
Crea, aggiorna e visualizza deployment del tuo progetto.
Codice struttura
clasp
ti consente di organizzare il codice in directory, che vengono conservate
quando li 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
Node.js versione 4.7.4 o successiva installata.
L'installazione di Node.js richiede privilegi amministrativi.
Installazione
Una volta installato Node.js, puoi utilizzare il seguente comando npm
per
installa clasp
:
npm install @google/clasp -g
Dopo l'installazione, puoi utilizzare il comando clasp
da qualsiasi directory su
del tuo computer.
In uso: clasp
Puoi utilizzare clasp
per gestire una serie di attività dalla riga di comando. Questo
descrive le operazioni comuni che puoi utilizzare durante lo sviluppo con clasp
.
Accedi
Questo comando accede e autorizza la gestione del tuo account nei progetti Apps Script. Una volta eseguita, ti verrà chiesto di accedere a un in cui sono archiviati i tuoi progetti Apps Script.
clasp login
Esci
Questo comando si disconnette dallo strumento a riga di comando. Devi eseguire nuovamente 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'intestazione titolo dello script.
clasp create [scriptTitle]
Questo comando crea anche due file nella directory corrente:
- Un file
.clasp.json
in cui è memorizzato l'ID script. - Un file manifest di progetto
appsscript.json
contenente i metadati di progetto.
clona un progetto esistente
Questo comando clona un progetto esistente nella directory attuale. Lo script devono essere creati o condivisi con il tuo Account Google. Sei tu a specificare lo script progetto da clonare fornendo il relativo ID script.
Per trovare l'ID script del progetto:
- Apri il progetto Apps Script.
- A sinistra, fai clic su Impostazioni progetto .
Sotto ID, copia l'ID script.
clasp clone <scriptId>
Scaricare un progetto di script
Questo comando scarica il progetto Apps Script da Google Drive nel tuo al file system del 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
Elenca le versioni del progetto
Questo comando elenca il numero e la descrizione di ogni elemento e versioni successive.
clasp versions
Esegui il deployment di un progetto pubblicato
Puoi eseguire il deployment di progetti di script come app web, componenti aggiuntivi o eseguibili. Puoi
creare deployment nell'editor di script
nel progetto manifest o utilizzando clasp
.
Per eseguire il deployment di un progetto con clasp
, crea prima una versione immutabile dell'app
Progetto di script. Una versione è uno "snapshot" di un progetto di script ed è simile
una release con ramificazione 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 i relativi ID deployment del progetto di script descrizioni.
clasp deployments
Apri il progetto nell'editor di Apps Script
Questo comando apre un progetto di script nell'editor di Apps Script. L'editore è vengono aperte come nuova scheda nel browser web predefinito.
clasp open
Contribuisci al progetto open source clasp
Dai il tuo contributo a clasp
su GitHub.