Lo strumento dell'interfaccia a riga di comando (CLI) di gactions consente di creare la struttura e i file di progetto richiesti e di eseguirne il deployment come progetto Actions nella console Actions. Per informazioni sull'utilizzo dello strumento a riga di comando in scenari comuni dopo l'installazione e la configurazione, consulta la guida dell'utente.
Dopo l'installazione, puoi ottenere un riepilogo delle funzionalità dello strumento nel terminale:
gactions --help
Viene visualizzato il seguente output:
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.
Installare lo strumento a riga di comando gactions
Installa lo strumento di interfaccia a riga di comando (CLI) gactions scaricando un pacchetto di installazione, decomprimendolo e configurando il percorso di esecuzione.
Per installare e configurare le azioni, procedi nel seguente modo:
Scarica il pacchetto appropriato per il tuo sistema operativo:
Piattaforma Package Checksum Windows Scarica SHA256 Linux Scarica SHA256 Sistema operativo Mac Scarica SHA256 Estrai il pacchetto nella posizione che preferisci e aggiungi il programma binario alla variabile
PATH
del tuo ambiente. In alternativa, estrai il pacchetto in una posizione già presente nella variabilePATH
(ad esempio,/usr/local/bin
).Su Linux e Mac, abilita le autorizzazioni di esecuzione se necessario:
chmod +x PATH_TO/gactions
Esegui questo comando per autenticare l'interfaccia a riga di comando. Questo comando avvia un flusso di autenticazione e richiede un browser web:
gactions login
Al termine del flusso, l'interfaccia a riga di comando esegue automaticamente l'autenticazione.
Creare e configurare un progetto
Prima di poter utilizzare lo strumento a riga di comando gactions, devi creare un progetto nella console di Actions e concedere l'accesso alle azioni al progetto. Per creare e configurare un progetto, segui questi passaggi:
- Vai alla Console di Actions.
- Fai clic su Nuovo progetto, inserisci un nome per il progetto e fai clic su Crea progetto.
- Seleziona una categoria e fai clic su Avanti.
- Seleziona Progetto vuoto e fai clic su Inizia a creare.
- Abilita l'API Actions nella console Google Cloud seguendo le istruzioni riportate in Abilitare e disabilitare le API. In questo modo le gactions possono interagire con il tuo progetto.
Inizializzare un campione
Crea una directory vuota, quindi esegui gactions init SAMPLE_NAME
da quella directory per importare un progetto Actions di esempio. Puoi utilizzare il progetto di esempio come modello per creare il tuo progetto e comprendere la struttura di un progetto Actions.
Ad esempio, il seguente comando comporta l'aggiunta dei contenuti dell'esempio hello-world
alla directory:
gactions init hello-world