סקירה כללית של אינטראקציות

כלי שורת הפקודה gactions (CLI) עוזר ליצור את המבנה והקבצים הנדרשים של הפרויקט ולפרוס אותם כפרויקט פעולות במסוף פעולות. למידע על השימוש בכלי שורת הפקודה בתרחישים נפוצים לאחר ההתקנה וההגדרה, קראו את המדריך למשתמש.

אחרי שמתקינים את הכלי, אפשר לראות סיכום של הפונקציונליות שלו בטרמינל:

gactions --help

יופיע הפלט הבא:

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.

התקנת כלי שורת הפקודה gactions

כדי להתקין את כלי ממשק שורת הפקודה gactions (CLI), מורידים חבילת התקנה, פותחים אותה ומגדירים את נתיב הביצוע.

כדי להתקין ולהגדיר Gactions, פועלים לפי השלבים הבאים:

  1. מורידים את החבילה המתאימה למערכת ההפעלה שלכם:

    הפלטפורמה Package סכום כולל
    Windows הורדה SHA256
    Linux הורדה SHA256
    Mac OS הורדה SHA256

  2. מחלצים את החבילה למיקום הרצוי ומוסיפים את הקובץ הבינארי למשתנה PATH של הסביבה. לחלופין, מחלצים את החבילה למיקום שכבר נמצא במשתנה PATH (לדוגמה, /usr/local/bin).

  3. ב-Linux וב-Mac, צריך להפעיל הרשאות הפעלה אם יש צורך:

    chmod +x PATH_TO/gactions

  4. מריצים את הפקודה הבאה כדי לאמת את ה-CLI. הפקודה הזו מתחילה תהליך אימות וצריך להשתמש בדפדפן אינטרנט:

    gactions login

    כשהתהליך מסתיים, ה-CLI עובר אימות באופן אוטומטי.

יצירה והגדרה של פרויקט

כדי שתוכלו להשתמש בכלי שורת הפקודה gactions, עליכם ליצור פרויקט במסוף Actions ולתת ל-gactions גישה לפרויקט. כדי ליצור ולהגדיר פרויקט:

  1. נכנסים אל Actions Console.
  2. לוחצים על פרויקט חדש, נותנים שם לפרויקט ולוחצים על יצירת פרויקט.
  3. בוחרים קטגוריה ולוחצים על הבא.
  4. בוחרים באפשרות פרויקט ריק ולוחצים על התחלת המבנה.
  5. פועלים לפי ההוראות במאמר הפעלה והשבתה של ממשקי API כדי להפעיל את Actions API במסוף Google Cloud. כך יכולים ליצור אינטראקציה עם הפרויקט שלכם באמצעות gaction.

הפעלת מדגם

כדי לייבא פרויקט פעולות לדוגמה, יוצרים ספרייה ריקה ולאחר מכן מריצים את gactions init SAMPLE_NAME מאותה ספרייה. אתם יכולים להשתמש בפרויקט לדוגמה כמודל כדי ליצור פרויקט משלכם ולהבין את המבנה של פרויקט פעולות.

לדוגמה, בעקבות הפקודה הבאה התוכן של הדוגמה hello-world מתווסף לספרייה שלכם:

gactions init hello-world