La herramienta de la interfaz de línea de comandos (CLI) de gactions te ayuda a crear la estructura del proyecto y los archivos necesarios y, luego, implementarlos como un proyecto de acciones en la consola de Actions. Para obtener información sobre el uso de la herramienta de línea de comandos en situaciones comunes después de la instalación y configuración, consulta la guía del usuario.
Una vez instalada, podrás obtener un resumen de su funcionalidad en tu terminal:
gactions --help
Aparece este resultado:
Command Line Interface for Google Actions SDK Usage: gactions [command] Available Commands: decrypt Decrypt client secret. deploy Deploy an Action to the specified channel. encrypt Encrypt client secret. help Help about any command init Initialize a directory for a new project. login Authenticate gactions CLI to your Google account via web browser. logout Log gactions CLI out of your Google Account. pull This command pulls files from Actions Console into the local file system. push This command pushes changes in the local files to Actions Console. third-party-notices Prints license files of third-party software used. version Prints current version of the CLI. Flags: -h, --help help for gactions -v, --verbose Display additional error information Use "gactions [command] --help" for more information about a command.
Cómo instalar la herramienta de línea de comandos de gactions
Para instalar la herramienta de la interfaz de línea de comandos (CLI) de gactions, descarga un paquete de instalación, descomprímelo y configura la ruta de ejecución.
Para instalar y configurar gactions, sigue estos pasos:
Descarga el paquete adecuado para tu sistema operativo:
Plataforma Paquete Suma de comprobación Windows Descargar SHA256 Linux Descargar SHA256 macOS Descargar SHA256 Extrae el paquete en la ubicación que desees y agrega el objeto binario a la variable
PATH
de tu entorno. Como alternativa, extrae el paquete en una ubicación que ya esté en tu variablePATH
(por ejemplo,/usr/local/bin
).En Linux y Mac, habilita los permisos de ejecución si es necesario:
chmod +x PATH_TO/gactions
Ejecuta el siguiente comando para autenticar la CLI. Este comando inicia un flujo de autenticación y requiere un navegador web:
gactions login
Cuando se completa el flujo, la CLI se autentica automáticamente.
Crea y configura un proyecto
Para poder usar la herramienta de línea de comandos de gactions, debes crear un proyecto en la Consola de Actions y otorgarle a gactions acceso al proyecto. Para crear y configurar un proyecto, haz lo siguiente:
- Ve a la Consola de Actions.
- Haz clic en Proyecto nuevo, ingresa un nombre y haz clic en Crear proyecto.
- Selecciona una categoría y haz clic en Siguiente.
- Selecciona Blank project y haz clic en Start building.
- Para habilitar la API de Actions en la consola de Google Cloud, sigue las instrucciones que se indican en Inhabilita y habilita las APIs. Esto permite que las gactions interactúen con tu proyecto.
Inicializa una muestra
Crea un directorio vacío y, luego, ejecuta gactions init SAMPLE_NAME
desde ese directorio para importar un proyecto de Actions de muestra. Puedes usar el proyecto de muestra como modelo para crear tu propio proyecto y comprender la estructura de un proyecto de Acciones.
Por ejemplo, el siguiente comando hace que el contenido de la muestra hello-world
se agregue a tu directorio:
gactions init hello-world