تساعدك أداة واجهة سطر أوامر 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 من خلال تنزيل حزمة تثبيت وفك ضغطها وإعداد مسار التنفيذ.
لتثبيت الإجراءات وضبطها، اتّبِع الخطوات التالية:
يمكنك تنزيل الحزمة المناسبة لنظام التشغيل الذي تستخدمه:
النظام الأساسي الحزمة المجموع الاختباري أجهزة Windows تنزيل SHA256 Linux تنزيل SHA256 نظام تشغيل Mac تنزيل SHA256 استخرِج الحزمة إلى مكان من اختيارك وأضِف البرنامج الثنائي إلى متغيّر
PATH
في بيئتك. ويمكنك بدلاً من ذلك استخراج الحزمة إلى موقع جغرافي متوفّر حاليًا في المتغيّرPATH
(على سبيل المثال،/usr/local/bin
).على نظامي التشغيل Linux وMac، فعِّل أذونات التنفيذ إذا لزم الأمر:
chmod +x PATH_TO/gactions
شغّل الأمر التالي لمصادقة CLI. يبدأ هذا الأمر مسار المصادقة ويتطلب متصفح ويب:
gactions login
وعند اكتمال التدفق، تتم المصادقة تلقائيًا على واجهة سطر الأوامر.
إنشاء مشروع وإعداده
قبل أن تتمكن من استخدام أداة سطر أوامر gactions، عليك إنشاء مشروع في وحدة تحكم المهام ومنح gactions إمكانية الوصول إلى المشروع. لإنشاء مشروع وإعداده، قم بما يلي:
- انتقِل إلى وحدة تحكّم "الإجراءات".
- انقر على مشروع جديد، وأدخِل اسم مشروع، ثم انقر على إنشاء مشروع.
- يمكنك اختيار فئة والنقر على التالي.
- اختَر مشروع فارغ وانقر على بدء الإنشاء.
- يُرجى تفعيل Actions API في Google Cloud Console باتّباع التعليمات الواردة في تفعيل وإيقاف واجهات برمجة التطبيقات. يسمح هذا للكائنات بالتفاعل مع مشروعك.
إعداد عيّنة
أنشئ دليلاً فارغًا، ثم شغِّل gactions init SAMPLE_NAME
من ذلك الدليل لاستيراد نموذج مشروع الإجراءات. يمكنك استخدام نموذج المشروع كنموذج لإنشاء مشروعك الخاص وفهم هيكل مشروع
المهام.
على سبيل المثال، يؤدي الأمر التالي إلى عرض محتوى نموذج hello-world
الذي تتم إضافته إلى الدليل:
gactions init hello-world