Para desarrollar y administrar proyectos de Apps Script desde tu terminal en lugar del editor de Apps Script, puedes usar una herramienta de código abierto llamada clasp
.
El codelab de clasp
proporciona una descripción general de todas las funciones de clasp
.
Funciones
Desarrollo a nivel local
clasp
te permite desarrollar tus proyectos de Apps Script de manera local. Puedes
escribir código en tu computadora y subirlo a Apps Script cuando termines. También puedes descargar proyectos de Apps Script existentes para editarlos sin conexión. Como el código es local, puedes usar tus herramientas de desarrollo favoritas, como git
, cuando compiles proyectos de Apps Script.
Administra las versiones de implementación
Crea, actualiza y visualiza las múltiples implementaciones de tu proyecto.
Código de la estructura
clasp
te permite organizar tu código en directorios, que se conservan cuando los subes a script.google.com. Por ejemplo:
# On script.google.com: ├── tests/slides.gs └── tests/sheets.gs # Locally: ├── tests/ │ ├─ slides.gs │ └─ sheets.gs
Requisitos
clasp
se escribe en Node.js y se distribuye a través de
la herramienta de npm
. Antes de usar clasp
, debes tener instalada
Node.js 4.7.4 o una versión posterior.
La instalación de Node.js requiere privilegios de administrador.
Instalación
Una vez que instales Node.js, puedes usar el siguiente comando de npm
para instalar clasp
:
npm install @google/clasp -g
Después de la instalación, puedes usar el comando clasp
desde cualquier directorio de la computadora.
Usa clasp
Puedes usar clasp
para manejar una variedad de tareas desde la línea de comandos. En esta sección, se describen las operaciones comunes que puedes usar cuando desarrollas con clasp
.
Acceder
Este comando accede y autoriza la administración de los proyectos de Apps Script de tu Cuenta de Google. Una vez que se ejecute, se te pedirá que accedas a una Cuenta de Google en la que estén almacenados tus proyectos de Apps Script.
clasp login
Salir
Este comando sale de la herramienta de línea de comandos. Debes volver a acceder con
clasp login
para volver a autenticar con Google antes de seguir usando clasp
.
clasp logout
Crea un nuevo proyecto de Apps Script
Este comando crea una secuencia de comandos nueva en el directorio actual con un título de secuencia de comandos opcional.
clasp create [scriptTitle]
Este comando también crea dos archivos en el directorio actual:
- Un archivo
.clasp.json
que almacena el ID de secuencia de comandos - Un archivo de manifiesto del proyecto
appsscript.json
que contiene metadatos del proyecto.
Clone un proyecto existente
Este comando clona un proyecto existente en el directorio actual. La secuencia de comandos debe crearse o compartirse con tu Cuenta de Google. Proporciona su ID de secuencia de comandos para especificar el proyecto de secuencia de comandos que deseas clonar.
Para encontrar el ID de la secuencia de comandos del proyecto, sigue estos pasos:
- Abre el proyecto de Apps Script.
- A la izquierda, haz clic en Configuración del proyecto .
En IDs, copia el ID de la secuencia de comandos.
clasp clone <scriptId>
Descarga un proyecto de secuencia de comandos
Este comando descarga el proyecto de Apps Script de Google Drive al sistema de archivos de tu computadora.
clasp pull
Subir un proyecto de secuencia de comandos
Este comando sube todos los archivos de un proyecto de secuencia de comandos de tu computadora a Google Drive.
clasp push
Mostrar lista de versiones del proyecto
Este comando enumera el número y la descripción de cada una de las versiones de un proyecto de secuencia de comandos.
clasp versions
Implementa un proyecto publicado
Puedes implementar proyectos de secuencias de comandos como aplicaciones web, complementos o ejecutables. Puedes crear implementaciones en el editor de secuencia de comandos, en el manifiesto del proyecto o con clasp
.
Para implementar un proyecto con clasp
, primero debes crear una versión inmutable del proyecto de Apps Script. Una versión es una "instantánea" de un proyecto de secuencia de comandos y es similar a una versión ramificada de solo lectura.
clasp version [description]
Este comando muestra el número de versión recién creado. Con ese número, puedes implementar y anular la implementación de instancias de tu proyecto:
clasp deploy [version] [description]
clasp undeploy <deploymentId>
Este comando actualiza una implementación existente con una versión y una descripción nuevas:
clasp redeploy <deploymentId> <version> <description>
Mostrar lista de implementaciones
Este comando enumera los ID de implementación del proyecto de secuencia de comandos, las versiones y sus descripciones.
clasp deployments
Abre el proyecto en el editor de Apps Script.
Este comando abre un proyecto de secuencia de comandos en el editor de Apps Script. El editor se inicia como una pestaña nueva en tu navegador web predeterminado.
clasp open
Contribuye al proyecto de código abierto clasp
Contribuye con clasp
en GitHub.