présentation de gactions

L'outil d'interface de ligne de commande (CLI) gactions vous aide à créer la structure et les fichiers de projet requis, puis à les déployer en tant que projet Actions dans la console Actions. Pour en savoir plus sur l'utilisation de l'outil de ligne de commande dans les scénarios courants après son installation et sa configuration, consultez plutôt le guide de l'utilisateur.

Une fois l'outil installé, vous pouvez obtenir un résumé de ses fonctionnalités dans votre terminal:

gactions --help

Le résultat suivant s'affiche :

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.

Installer l'outil de ligne de commande gactions

Installez l'outil d'interface de ligne de commande (CLI) gactions en téléchargeant un package d'installation, en le décompressant et en configurant votre chemin d'exécution.

Pour installer et configurer les gactions, procédez comme suit:

  1. Téléchargez le package correspondant à votre système d'exploitation:

    Plate-forme Empaqueter Total
    Windows Télécharger SHA256
    Linux Télécharger SHA256
    macOS Télécharger SHA256
  2. Extrayez le package à l'emplacement de votre choix, puis ajoutez le binaire à la variable PATH de votre environnement. Vous pouvez également extraire le package vers un emplacement qui se trouve déjà dans votre variable PATH (par exemple, /usr/local/bin).

  3. Sous Linux et Mac, activez les autorisations d'exécution si nécessaire:

    chmod +x PATH_TO/gactions
  4. Exécutez la commande suivante pour authentifier la CLI. Cette commande lance un flux d'authentification et nécessite un navigateur Web:

    gactions login

    Une fois le flux terminé, la CLI s'authentifie automatiquement.

Créer et configurer un projet

Avant de pouvoir utiliser l'outil de ligne de commande gactions, vous devez créer un projet dans la console Actions et autoriser gactions à y accéder. Pour créer et configurer un projet, procédez comme suit:

  1. Accédez à la console Actions.
  2. Cliquez sur Nouveau projet, saisissez un nom de projet, puis cliquez sur Créer un projet.
  3. Sélectionnez une catégorie, puis cliquez sur Suivant.
  4. Sélectionnez Blank project (Projet vide), puis cliquez sur Start build (Commencer à créer).
  5. Activez l'API Actions dans la console Google Cloud en suivant les instructions de la section Activer et désactiver des API. Cela permet aux gactions d'interagir avec votre projet.

Initialiser un exemple

Créez un répertoire vide, puis exécutez gactions init SAMPLE_NAME à partir de ce répertoire pour importer un exemple de projet Actions. Vous pouvez utiliser l'exemple de projet comme modèle pour créer votre propre projet et comprendre la structure d'un projet Actions.

Par exemple, la commande suivante entraîne l'ajout du contenu de l'exemple hello-world à votre répertoire:

gactions init hello-world