نظرة عامة على الإجراءات

تساعدك أداة واجهة سطر أوامر gactions في إنشاء بنية المشروع وملفاته المطلوبة ونشرها كمشروع إجراءات في وحدة تحكُّم المهام. للحصول على معلومات عن استخدام أداة سطر الأوامر في السيناريوهات الشائعة بعد تثبيتها وإعدادها، راجع دليل المستخدم بدلاً من ذلك.

بعد تثبيت الأداة، يمكنك الحصول على ملخّص عن وظائف الأداة في الوحدة الطرفية:

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 من خلال تنزيل حزمة تثبيت وفك ضغطها وإعداد مسار التنفيذ.

لتثبيت الإجراءات وضبطها، اتّبِع الخطوات التالية:

  1. يمكنك تنزيل الحزمة المناسبة لنظام التشغيل الذي تستخدمه:

    النظام الأساسي الحزمة المجموع الاختباري
    أجهزة Windows تنزيل SHA256
    Linux تنزيل SHA256
    نظام تشغيل Mac تنزيل SHA256
  2. استخرِج الحزمة إلى مكان من اختيارك وأضِف البرنامج الثنائي إلى متغيّر PATH في بيئتك. ويمكنك بدلاً من ذلك استخراج الحزمة إلى موقع جغرافي متوفّر حاليًا في المتغيّر PATH (على سبيل المثال، /usr/local/bin).

  3. على نظامي التشغيل Linux وMac، فعِّل أذونات التنفيذ إذا لزم الأمر:

    chmod +x PATH_TO/gactions
  4. شغّل الأمر التالي لمصادقة CLI. يبدأ هذا الأمر مسار المصادقة ويتطلب متصفح ويب:

    gactions login

    وعند اكتمال التدفق، تتم المصادقة تلقائيًا على واجهة سطر الأوامر.

إنشاء مشروع وإعداده

قبل أن تتمكن من استخدام أداة سطر أوامر gactions، عليك إنشاء مشروع في وحدة تحكم المهام ومنح gactions إمكانية الوصول إلى المشروع. لإنشاء مشروع وإعداده، قم بما يلي:

  1. انتقِل إلى وحدة تحكّم "الإجراءات".
  2. انقر على مشروع جديد، وأدخِل اسم مشروع، ثم انقر على إنشاء مشروع.
  3. يمكنك اختيار فئة والنقر على التالي.
  4. اختَر مشروع فارغ وانقر على بدء الإنشاء.
  5. يُرجى تفعيل Actions API في Google Cloud Console باتّباع التعليمات الواردة في تفعيل وإيقاف واجهات برمجة التطبيقات. يسمح هذا للكائنات بالتفاعل مع مشروعك.

إعداد عيّنة

أنشئ دليلاً فارغًا، ثم شغِّل gactions init SAMPLE_NAME من ذلك الدليل لاستيراد نموذج مشروع الإجراءات. يمكنك استخدام نموذج المشروع كنموذج لإنشاء مشروعك الخاص وفهم هيكل مشروع المهام.

على سبيل المثال، يؤدي الأمر التالي إلى عرض محتوى نموذج hello-world الذي تتم إضافته إلى الدليل:

gactions init hello-world