Interfaccia a riga di comando con fibbia

Per sviluppare e gestire progetti Apps Script dal tuo terminale anziché dall'editor di Apps Script, puoi utilizzare uno strumento open source chiamato clasp.

Il codelab su clasp offre una panoramica di tutte le funzionalità di clasp.

Funzionalità

Sviluppa in locale

clasp ti consente di sviluppare i tuoi progetti Apps Script a livello locale. Puoi scrivere il codice sul tuo computer e caricarlo in Apps Script quando hai finito. Puoi anche scaricare i 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 tuoi numerosi 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 viene scritto in Node.js e distribuito tramite lo strumento npm. Prima di utilizzare clasp, è necessario che sia installato Node.js 4.7.4 o versioni 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, il comando clasp è disponibile e utilizzabile da qualsiasi directory sul tuo 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. Dopo l'esecuzione, ti viene chiesto di accedere a un Account Google in cui sono archiviati i 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 titolo script facoltativo.

clasp create [scriptTitle]

Questo comando crea anche due file nella directory corrente:

• Un file .clasp.json in cui è archiviato l'ID script.
• Un file manifest del progetto appsscript.json contenente i metadati di progetto.

Clona un progetto esistente

Questo comando clona un progetto esistente nella directory corrente. Lo script deve essere creato o condiviso con il tuo Account Google. Specifica il progetto di script da clonare fornendo il relativo ID script.

Per trovare l'ID script del progetto, segui questi passaggi:

1. Apri il progetto Apps Script.
2. A sinistra, fai clic su Impostazioni progetto .

3. In ID, copia l'ID script.

    clasp clone <scriptId>
   

Scaricare un progetto script

Questo comando scarica il progetto Apps Script da Google Drive sul tuo file system del computer.

clasp pull

Carica un progetto script

Questo comando carica tutti i file di un progetto di script dal computer a Google Drive.

clasp push

Elenca versioni del progetto

Questo comando elenca il numero e la descrizione di ciascuna versione del progetto di script.

clasp versions

Eseguire il deployment di un progetto pubblicato

Puoi eseguire il deployment di progetti 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, devi prima creare una versione immutabile del progetto Apps Script. Una versione è un'"istantanea" di un progetto di script ed è simile a una release ramificata in sola lettura.

clasp version [description]

Questo comando visualizza il numero di versione appena creato. Utilizzando questo numero, puoi eseguire il deployment e annullare il deployment delle istanze del progetto:

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 descrizioni del progetto dello 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 lanciato come nuova scheda nel browser web predefinito.

clasp open

Contribuisci al progetto open source clasp

Dai il tuo contributo a clasp su GitHub.