כלי שורת הפקודה 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, פועלים לפי השלבים הבאים:
מורידים את החבילה המתאימה למערכת ההפעלה שלכם:
הפלטפורמה Package סכום כולל Windows הורדה SHA256 Linux הורדה SHA256 Mac OS הורדה SHA256 מחלצים את החבילה למיקום הרצוי ומוסיפים את הקובץ הבינארי למשתנה
PATH
של הסביבה. לחלופין, מחלצים את החבילה למיקום שכבר נמצא במשתנהPATH
(לדוגמה,/usr/local/bin
).ב-Linux וב-Mac, צריך להפעיל הרשאות הפעלה אם יש צורך:
chmod +x PATH_TO/gactions
מריצים את הפקודה הבאה כדי לאמת את ה-CLI. הפקודה הזו מתחילה תהליך אימות וצריך להשתמש בדפדפן אינטרנט:
gactions login
כשהתהליך מסתיים, ה-CLI עובר אימות באופן אוטומטי.
יצירה והגדרה של פרויקט
כדי שתוכלו להשתמש בכלי שורת הפקודה gactions, עליכם ליצור פרויקט במסוף Actions ולתת ל-gactions גישה לפרויקט. כדי ליצור ולהגדיר פרויקט:
- נכנסים אל Actions Console.
- לוחצים על פרויקט חדש, נותנים שם לפרויקט ולוחצים על יצירת פרויקט.
- בוחרים קטגוריה ולוחצים על הבא.
- בוחרים באפשרות פרויקט ריק ולוחצים על התחלת המבנה.
- פועלים לפי ההוראות במאמר הפעלה והשבתה של ממשקי API כדי להפעיל את Actions API במסוף Google Cloud. כך יכולים ליצור אינטראקציה עם הפרויקט שלכם באמצעות gaction.
הפעלת מדגם
כדי לייבא פרויקט פעולות ל��וגמה, יוצרים ספרייה ריקה ולאחר מכן מריצים את gactions init SAMPLE_NAME
מאותה ספרייה. אתם יכולים להשתמש בפרויקט לדוגמה כמודל כדי ליצור פרויקט משלכם ולהבין את המבנה של פרויקט פעולות.
לדוגמה, בעקבות הפקודה הבאה התוכן של הדוגמה hello-world
מתווסף לספרייה שלכם:
gactions init hello-world