دليل البدء السريع لأداة تطوير البرامج (SDK) لحزمة تطوير البرامج (SDK) وأداة إنشاء المهام

يرشدك هذا الدليل خلال عملية إعداد بيئتك لإنشاء المهام باستخدام كل من "حزمة SDK للإجراءات" و"أداة إنشاء المهام". ستقوم بتنفيذ المهام التالية:

• تثبيت Node.js: أنت بحاجة إلى بيئة وقت التشغيل هذه لاستخدام مكتبة تنفيذ Node.js.
• تثبيت واجهة سطر الأوامر من Firebase: تتيح لك أداة سطر الأوامر هذه تطوير تبعيات Firebase ونشرها، مثل تطبيقات الويب للوحة الرسم التفاعلية، في استضافة Firebase.
• تثبيت أداة سطر أوامر gactions: عند التطوير باستخدام حزمة تطوير البرامج (SDK) للإجراءات، تستخدم هذه الأداة لإنشاء حزمة إجراءات لتنفيذ الإجراء الخاص بك وإدارتها ونشرها.
• إنشاء مشروع "المهام": مشروع "المهام" هو الحاوية المنطقية لإجراءات المحادثات. عليك إنشاء واحد في وحدة تحكم الإجراءات قبل أن تتمكن من البدء في الإنشاء.
• إعداد نموذج ونشره: توضّح لك هذه العيّنة البسيطة كيفية البدء في إنشاء المهام المستندة إلى "لوحة الرسم التفاعلية".

بعد إكمال دليل البدء السريع هذا، يمكنك مزامنة مشروع المهام بين بيئة التطوير المحلية وتجربة الويب في "أداة إنشاء المهام".

تثبيت Node.js وواجهة سطر الأوامر على Firebase

نزِّل Node.js وثبّتها وفقًا لوثائق Node.js لاستخدام مكتبة التنفيذ الخاصة بنا. كما يتيح لك تثبيت Node.js تثبيت واجهة سطر الأوامر من Firebase باستخدام npm، والإصدارات اللاحقة، لتشغيل تنفيذ إجراء المحادثة محليًا.

عليك تثبيت واجهة سطر الأوامر في Firebase وإعدادها وفقًا لمستندات Firebase. تتيح لك واجهة سطر الأوامر في Firebase نشر تطبيق ويب "لوحة الرسم التفاعلية" على "استضافة Firebase"، وعند الضرورة، النشر يدويًا في وظائف السحابة الإلكترونية لبرنامج Firebase.

تثبيت أداة سطر أوامر 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 باتّباع التعليمات الواردة في تفعيل وإيقاف واجهات برمجة التطبيقات. يسمح هذا للكائنات بالتفاعل مع مشروعك.

الحصول على عيّنة مرحبًا بالعالم

توضّح لك العينة التفاعلية في hello world كيفية إنشاء مشروع إجراءات بسيط باستخدام مهمة واحدة تستند إلى "لوحة الرسم التفاعلية".

1. قم بإنشاء دليل فارغ وقم بإعداد عينة لوحة الرسم التفاعلية في هذا الدليل. على سبيل المثال، يؤدي الرمز التالي إلى إعداد النموذج في دليل interactive-canvas-sample/، وهو ما يُستخدم كمثال في هذا المستند:

   gactions init interactive-canvas --dest interactive-canvas-sample
   cd interactive-canvas-sample
   

2. افتح ملف interactive-canvas-sample/sdk/settings/settings.yaml وغيِّر قيمة الحقل projectId إلى رقم تعريف مشروعك.

نشر العيّنة واختبارها

بعد إعداد النموذج، يمكنك نشر تطبيق الويب "لوحة الرسم التفاعلية" ومشروع "المهام". تنشئ هذه العملية نسخة مسودة من مشروع المهام يمكنك نشرها في محاكي الإجراءات لمعاينتها واختبارها:

1. من دليل interactive-canvas-sample/، شغِّل الأمر التالي لنشر تطبيق الويب Interactive Canvas (محتوى دليل public/).

   firebase deploy --project PROJECT_ID --only hosting
   

   يمكنك الاطّلاع على نسخة معروضة من تطبيق الويب من خلال عنوان URL الذي يعرضه واجهة سطر الأوامر في Firebase في المتصفّح: https://PROJECT_ID.web.app.

2. افتح ملف interactive-canvas-sample/sdk/webhooks/ActionsOnGoogleFulfillment/index.js وغيّر قيمة المتغير CANVAS_URL إلى عنوان URL لتطبيق الويب لمشروعك.

   const CANVAS_URL = 'https://PROJECT_ID.web.app';
   

3. من دليل interactive-canvas-sample/sdk/، قم بتشغيل الأمر التالي لدفع الإصدار المحلي من مشروع Actions إلى وحدة التحكم كإصدار مسودة:

   gactions push
   

4. من دليل interactive-canvas-sample/sdk/، شغِّل الأمر التالي لاختبار مشروع Actions في المحاكي:

   gactions deploy preview
   

5. افتح الرابط الذي تعرضه أداة سطر الأوامر للانتقال إلى المحاكي.

6. في المحاكي، أدخِل "Talk to Interactive Panel sample" (عيّنة من لوحة الرسم التفاعلية) لبدء الإجراء. من المفترض أن يظهر لك مثلث يدور حوله تطبيق الويب المنشور في https://PROJECT_ID.web.app.