تصحيح الأخطاء في تطبيقات Google Chat

بصفتك مطوّر تطبيقات Google Chat، قد تحتاج إلى تصحيح الأخطاء في الرمز البرمجي لاختبار التغييرات أو تحديد المشاكل المعقّدة وحلّها. يمكن تصحيح أخطاء تطبيقات المحادثة بطرق مختلفة حسب بنية تطبيقك ووظائفه وطريقة نشره وإعداداتك المفضّلة.

توضّح هذه الصفحة كيفية تصحيح أخطاء تطبيق HTTP Chat باستخدام ngrok، وهي منصة موحّدة للوصول يمكنك استخدامها لاختبار بيئات التطوير المحلية. في هذا الدليل، ستختبر تغييرات الرمز في بيئة محلية وتحدّد المشاكل في بيئة بعيدة وتحلّها.

تصحيح الأخطاء من بيئة التطوير المحلية

في هذا القسم، يمكنك التفاعل مع تطبيق Chat الذي يتم تنفيذه في بيئتك المحلية.

تصحيح الأخطاء من بيئة التطوير المحلية

الشكل 1. تصحيح الأخطاء في بيئة تطوير على الجهاز

ورشة

Node.js

Python

Java

المتطلبات الأساسية

Node.js

Python

  • أحدث إصدار من python3 مثبّت في بيئتك المحلية
  • يجب تثبيت أحدث إصدار من pip وvirtualenv في بيئتك المحلية، ويتم استخدامهما لإدارة حِزم Python والبيئات الافتراضية على التوالي.
  • تطبيق Chat عبر HTTP تم إعداده للمراسلة يمكنك اتّباع الأقسام المتطلبات الأساسية وإعداد البيئة ونشر التطبيق على Google Chat في دليل البدء السريع. الاختلافات الوحيدة هي أنّه عليك ضبط اسم التطبيق على Debug App وعنوان URL لنقطة نهاية HTTP على أي قيمة مثل http://example.com.
  • بيئة تطوير متكاملة (IDE) تم إعدادها في بيئتك المحلية ويمكنها تصحيح الأخطاء نستخدم في هذا الدليل Visual Studio Code IDE وميزات تصحيح الأخطاء الافتراضية لأغراض توضيحية.
  • Git مثبَّت في بيئتك المحلية.
  • حساب على ngrok
  • يجب تثبيت أحدث إصدار من gcloud وإعداده في بيئتك المحلية.

Java

إتاحة الخدمة المحلية بشكل علني

يجب ربط بيئتك المحلية بالإنترنت ليتمكّن تطبيق Chat من الوصول إليها. يتم استخدام تطبيق ngrok لإعادة توجيه طلبات HTTP المُرسَلة إلى عنوان URL عام إلى بيئتك المحلية.

  1. في متصفّح في بيئتك المحلية، سجِّل الدخول إلى حسابك على ngrok.
  2. ثبِّت التطبيق وأعِدّ authtoken في بيئتك المحلية.
  3. أنشئ نطاقًا ثابتًا في حسابك على ngrok، ويُشار إليه باسم NGROK_STATIC_DOMAIN في تعليمات هذا الدليل.

ضبط إعدادات تطبيق Chat

اضبط تطبيق Chat لإرسال جميع طلبات HTTP إلى نطاقك الثابت.

  1. في Google Cloud Console، افتح صفحة Google Chat API:

    الانتقال إلى صفحة Google Chat API

  2. انقر على علامة التبويب الإعداد.

  3. انتقِل إلى الميزات التفاعلية > إعدادات الاتصال واضبط قيمة حقل النص عنوان URL لنقطة نهاية HTTP على:

    https://NGROK_STATIC_DOMAIN
    

    استبدِل NGROK_STATIC_DOMAIN بالنطاق الثابت في حسابك على ngrok.

  4. انقر على حفظ.

يرسل تطبيق Chat جميع طلبات HTTP إلى النطاق الثابت

الشكل 2. يرسل تطبيق Chat جميع طلبات HTTP إلى النطاق الثابت. تعمل خدمة ngrok العامة كجسر يربط بين تطبيق Chat ورمز التطبيق الذي يتم تنفيذه محليًا.

اختبار تطبيق Chat

يمكنك نشر تطبيق Chat وإعداده واختباره وتصحيح أخطائه وإعادة تحميله تلقائيًا على جهازك.

Node.js

  1. استنسِخ مستودع googleworkspace/google-chat-samples من GitHub إلى بيئتك المحلية، فهو يحتوي على رمز التطبيق الذي سيتم تنفيذه:

    git clone https://github.com/googleworkspace/google-chat-samples.git
  2. من بيئة التطوير المتكاملة (IDE) Visual Studio Code المثبّتة في بيئتك المحلية، اتّبِع الخطوات التالية:

    1. في نافذة جديدة، افتح المجلد google-chat-samples/node/basic-app.
    2. اضبط التطبيق على إعادة تحميل تصحيح الأخطاء تلقائيًا من خلال إضافة نصَين برمجيَين في ملف package.json:

      {
          ...
          "scripts": {
              ...
              "debug": "node --inspect index.js",
              "debug-watch": "nodemon --watch ./ --exec npm run debug"
          }
          ...
      }
      
    3. من الدليل الجذر، ثبِّت التطبيق:

      npm install
    4. أنشئ عملية إطلاق باسم Debug Watch تؤدي إلى تشغيل النص البرمجي debug-watch من خلال إنشاء الملف .vscode/launch.json في الدليل الجذر:

      {
          "version": "0.2.0",
          "configurations": [{
              "type": "node",
              "request": "launch",
              "name": "Debug Watch",
              "cwd": "${workspaceRoot}",
              "runtimeExecutable": "npm",
              "runtimeArgs": ["run-script", "debug-watch"]
          }]
      }
      
    5. أضِف نقطة توقّف مؤقت توقف معالجة طلب HTTP في الملف index.js، ثم ابدأ التشغيل والتصحيح باستخدام إعدادات Debug Watch التي أضفتها سابقًا. أصبح التطبيق الآن قيد التشغيل ويستمع إلى طلبات HTTP على المنفذ 9000.

      التطبيق قيد التشغيل ويستمع إلى طلبات HTTP على المنفذ `9000`

      الشكل 3. التطبيق قيد التشغيل وينتظر طلبات HTTP على المنفذ 9000.

  3. شغِّل تطبيق ngrok في بيئتك المحلية:

    ngrok http --domain=NGROK_STATIC_DOMAIN 9000

    استبدِل NGROK_STATIC_DOMAIN بالنطاق الثابت في حسابك على ngrok. يتم الآن إعادة توجيه جميع الطلبات إلى بيئتك المحلية والمنفذ الذي يستخدمه التطبيق.

    الوحدة الطرفية التي يتم فيها تشغيل خادم `ngrok` وإعادة التوجيه

    الشكل 4 نافذة الوحدة الطرفية التي يتم فيها تشغيل خادم ngrok وإعادة التوجيه

  4. يتم أيضًا تشغيل واجهة ويب على المضيف المحلي من خلال ngrokالتطبيق، ويمكنك تتبُّع جميع الأنشطة من خلال فتحها في متصفّح.

    واجهة الويب المستضافة من خلال تطبيق `ngrok` والتي لا تعرض أي طلبات HTTP

    الشكل 5. واجهة الويب المستضافة من خلال تطبيق ngrok التي لا تعرض أي طلبات HTTP

  5. اختبِر تطبيق Chat من خلال إرسال رسالة مباشرة إليه:

    • افتح Google Chat.

      الانتقال إلى Google Chat

    • انقر على محادثة جديدة .

    • في مربّع الحوار، أدخِل اسم تطبيق Chat.

    • في نتائج البحث، ابحث عن تطبيق Chat، وانقر على إضافة > Chat.

    • في مساحة الرسالة المباشرة، اكتب Hello واضغط على enter. لا يرد تطبيق Chat لأنّه قيد تصحيح الأخطاء بشكل نشط.

  6. في Visual Studio Code في بيئتك المحلية، يمكنك ملاحظة أنّه تم إيقاف التنفيذ مؤقتًا عند نقطة التوقف التي تم ضبطها.

    يتم إيقاف التنفيذ مؤقتًا عند نقطة الإيقاف التي تم ضبطها

    الشكل 6. يتم إيقاف التنفيذ مؤقتًا عند نقطة الإيقاف التي تم ضبطها.

  7. عند استئناف التنفيذ من أداة تصحيح الأخطاء في Visual Studio Code قبل أن تنتهي مهلة تطبيق Chat في Google Chat، ستتلقّى الرد Your message : Hello.

  8. يمكنك مراجعة سجلات طلبات واستجابات HTTP من واجهة الويب التي يستضيفها تطبيق ngrok في بيئتك المحلية.

    طلب HTTP من واجهة الويب التي يستضيفها تطبيق `ngrok`

    الشكل 7. طلب HTTP من واجهة الويب التي يستضيفها تطبيق ngrok

  9. لتغيير سلوك التطبيق، استبدِل Your message بـ Here was your message مضمّنًا 35 في index.json. عند حفظ الملف، يعيد nodemon تلقائيًا تحميل التطبيق باستخدام رمز المصدر المعدَّل، ويبقى Visual Studio Code في وضع تصحيح الأخطاء.

    التطبيق قيد التشغيل ويستمع إلى طلبات HTTP على المنفذ
`9000` مع تحميل تغيير الرمز

    الشكل 8. التطبيق قيد التشغيل ويستمع إلى طلبات HTTP على المنفذ 9000 مع تحميل تغيير الرمز.

  10. في هذه المرة، بدلاً من إرسال رسالة ثانية Hello في المساحة، يمكنك اختيار آخر طلب HTTP تم تسجيله على واجهة الويب المستضافة من خلال تطبيق ngrok في بيئتك المحلية والنقر على Replay. كما حدث في المرة السابقة، لا يردّ تطبيق Chat لأنّه يخضع حاليًا لتصحيح الأخطاء.

  11. عند استئناف التنفيذ من مصحّح الأخطاء في Visual Studio Code، يمكنك أن ترى من واجهة الويب التي يستضيفها تطبيق ngrok في بيئتك المحلية أنّ التطبيق ينشئ ردًا يتضمّن الإصدار المعدَّل من الرسالة Here was your message : Hello.

Python

  1. احصل على بيانات اعتماد مستخدم جديد لاستخدامها مع بيانات الاعتماد التلقائية للتطبيق:

    gcloud config set project PROJECT_ID
    gcloud auth application-default login

    استبدِل PROJECT_ID بمعرّف المشروع لمشروع Cloud الخاص بالتطبيق.

  2. استنسِخ مستودع googleworkspace/google-chat-samples من GitHub إلى بيئتك المحلية، فهو يحتوي على الرمز البرمجي للتطبيق:

    git clone https://github.com/googleworkspace/google-chat-samples.git
  3. من بيئة التطوير المتكاملة (IDE) Visual Studio Code المثبّتة في بيئتك المحلية، اتّبِع الخطوات التالية:

    1. في نافذة جديدة، افتح المجلد google-chat-samples/python/avatar-app.
    2. أنشئ بيئة افتراضية جديدة لـ Python env وفعِّلها:

      virtualenv env
      source env/bin/activate
    3. ثبِّت جميع التبعيات الخاصة بالمشروع باستخدام pip في البيئة الافتراضية:

      pip install -r requirements.txt
    4. أنشئ الملف .vscode/launch.json في الدليل الجذر، واضبط عملية تشغيل باسم Debug Watch تؤدي إلى تشغيل التطبيق من الوحدة functions-framework على المنفذ 9000 في وضع التصحيح في البيئة الافتراضية env:

      {
          "version": "0.2.0",
          "configurations": [{
              "type": "python",
              "request": "launch",
              "name": "Debug Watch",
              "python": "${workspaceFolder}/env/bin/python3",
              "module": "functions_framework",
              "args": [
                  "--target", "avatar_app",
                  "--port", "9000",
                  "--debug"
              ]
          }]
      }
      
    5. أضِف نقطة توقّف مؤقت توقف معالجة طلب HTTP في الملف main.py، ثم ابدأ التشغيل والتصحيح باستخدام إعدادات Debug Watch التي أضفتها سابقًا. أصبح التطبيق الآن قيد التشغيل ويستمع إلى طلبات HTTP على المنفذ 9000.

      التطبيق قيد التشغيل ويستمع إلى طلبات HTTP على المنفذ `9000`

      الشكل 3. التطبيق قيد التشغيل وينتظر طلبات HTTP على المنفذ 9000.

  4. شغِّل تطبيق ngrok في بيئتك المحلية:

    ngrok http --domain=NGROK_STATIC_DOMAIN 9000

    استبدِل NGROK_STATIC_DOMAIN بالنطاق الثابت في حسابك على ngrok. يتم الآن إعادة توجيه جميع الطلبات إلى بيئتك المحلية والمنفذ الذي يستخدمه التطبيق.

    الوحدة الطرفية التي يتم فيها تشغيل خادم `ngrok` وإعادة التوجيه

    الشكل 4 نافذة الوحدة الطرفية التي يتم فيها تشغيل خادم ngrok وإعادة التوجيه

  5. يتم أيضًا تشغيل واجهة ويب على المضيف المحلي من خلال ngrokالتطبيق، ويمكنك تتبُّع جميع الأنشطة من خلال فتحها في متصفّح.

    واجهة الويب المستضافة من خلال تطبيق `ngrok` والتي لا تعرض أي طلبات HTTP

    الشكل 5. واجهة الويب المستضافة من خلال تطبيق ngrok التي لا تعرض أي طلبات HTTP

  6. اختبِر تطبيق Chat من خلال إرسال رسالة مباشرة إليه:

    • افتح Google Chat.

      الانتقال إلى Google Chat

    • انقر على محادثة جديدة .

    • في مربّع الحوار، أدخِل اسم تطبيق Chat.

    • في نتائج البحث، ابحث عن تطبيق Chat، وانقر على إضافة > Chat.

    • في مساحة الرسالة المباشرة، اكتب Hey! واضغط على enter. لا يرد تطبيق Chat لأنّه قيد تصحيح الأخطاء بشكل نشط.

  7. في Visual Studio Code في بيئتك المحلية، يمكنك ملاحظة أنّه تم إيقاف التنفيذ مؤقتًا عند نقطة التوقف التي تم ضبطها.

    يتم إيقاف التنفيذ مؤقتًا عند نقطة الإيقاف التي تم ضبطها

    الشكل 6. يتم إيقاف التنفيذ مؤقتًا عند نقطة الإيقاف التي تم ضبطها.

  8. عند استئناف التنفيذ من أداة تصحيح الأخطاء في Visual Studio Code قبل أن تنتهي مهلة تطبيق Chat، سيردّ التطبيق باسمك وصورة الأفاتار في الرسالة.

  9. يمكنك مراجعة سجلات طلبات واستجابات HTTP من واجهة الويب التي يستضيفها تطبيق ngrok في بيئتك المحلية.

    طلب HTTP من واجهة الويب التي يستضيفها تطبيق `ngrok`

    الشكل 7. طلب HTTP من واجهة الويب التي يستضيفها تطبيق ngrok

  10. لتغيير سلوك التطبيق، استبدِل Hello بـ Hey inline 51 في الملف main.py. عند حفظ الملف، يعيد Visual Studio Code تحميل التطبيق تلقائيًا باستخدام رمز المصدر المعدَّل ويبقى في وضع التصحيح.

    التطبيق قيد التشغيل ويستمع إلى طلبات HTTP على المنفذ
`9000` مع تحميل تغيير الرمز

    الشكل 8. التطبيق قيد التشغيل ويستمع إلى طلبات HTTP على المنفذ 9000 مع تحميل تغيير الرمز.

  11. في هذه المرة، بدلاً من إرسال رسالة ثانية Hey! في المساحة، يمكنك اختيار آخر طلب HTTP تم تسجيله على واجهة الويب المستضافة من خلال تطبيق ngrok في بيئتك المحلية والنقر على Replay. كما حدث في المرة السابقة، لا يردّ تطبيق Chat لأنّه يخضع حاليًا لتصحيح الأخطاء.

  12. عند استئناف التنفيذ من مصحّح الأخطاء في Visual Studio Code، يمكنك أن ترى من واجهة الويب التي يستضيفها تطبيق ngrok في بيئتك المحلية أنّ التطبيق ينشئ ردًا يتضمّن الإصدار المعدَّل من الرسالة.

Java

  1. احصل على بيانات اعتماد مستخدم جديد لاستخدامها مع بيانات الاعتماد التلقائية للتطبيق:

    gcloud config set project PROJECT_ID
    gcloud auth application-default login

    استبدِل PROJECT_ID بمعرّف المشروع لمشروع Cloud الخاص بالتطبيق.

  2. استنسِخ مستودع googleworkspace/google-chat-samples من GitHub في بيئتك المحلية، فهو يحتوي على الرمز البرمجي للتطبيق:

    git clone https://github.com/googleworkspace/google-chat-samples.git
  3. من بيئة التطوير المتكاملة (IDE) Visual Studio Code المثبّتة في بيئتك المحلية، اتّبِع الخطوات التالية:

    1. في نافذة جديدة، افتح المجلد google-chat-samples/java/avatar-app.
    2. اضبط إعدادات مشروع Maven لتشغيل التطبيق App على المنفذ 9000 محليًا من خلال إضافة المكوّن الإضافي function-maven-plugin لإنشاء إطار عمل Cloud Functions في الملف pom.xml:

      ...
      <plugin>
          <groupId>com.google.cloud.functions</groupId>
          <artifactId>function-maven-plugin</artifactId>
          <version>0.11.0</version>
          <configuration>
              <functionTarget>App</functionTarget>
              <port>9000</port>
          </configuration>
      </plugin>
      ...
      
    3. يمكنك الآن تشغيله محليًا في وضع تصحيح الأخطاء:

      mvnDebug function:run
      Preparing to execute Maven in debug mode
      Listening for transport dt_socket at address: 8000
    4. أنشئ الملف .vscode/launch.json في الدليل الجذر، وحدِّد عملية تشغيل باسم Remote Debug Watch يتم ربطها بالتطبيق الذي تم تشغيله سابقًا باستخدام المنفذ 8000:

      {
          "version": "0.2.0",
          "configurations": [{
              "type": "java",
              "request": "attach",
              "name": "Remote Debug Watch",
              "projectName": "http-function",
              "hostName": "localhost",
              "port": 8000
          }]
      }
      
    5. أضِف نقطة توقّف مؤقت توقف معالجة طلب HTTP في الملف App.java، ثم ابدأ عملية الربط والتصحيح باستخدام إعدادات Remote Debug Watch التي أضفتها سابقًا. أصبح التطبيق يعمل الآن ويستمع إلى طلبات HTTP على المنفذ 9000.

      التطبيق قيد التشغيل ويستمع إلى طلبات HTTP على المنفذ `9000`

      الشكل 3: يتم تشغيل التطبيق والاستماع إلى طلبات HTTP على المنفذ 9000.

  4. شغِّل تطبيق ngrok في بيئتك المحلية:

    ngrok http --domain=NGROK_STATIC_DOMAIN 9000

    استبدِل NGROK_STATIC_DOMAIN بالنطاق الثابت في حسابك على ngrok. يتم الآن إعادة توجيه جميع الطلبات إلى بيئتك المحلية والمنفذ الذي يستخدمه التطبيق.

    الوحدة الطرفية التي يتم فيها تشغيل خادم `ngrok` وإعادة التوجيه

    الشكل 4 نافذة الوحدة الطرفية التي يتم فيها تشغيل خادم ngrok وإعادة التوجيه

  5. يتم أيضًا تشغيل واجهة ويب على المضيف المحلي من خلال ngrokالتطبيق، ويمكنك تتبُّع جميع الأنشطة من خلال فتحها في متصفّح.

    واجهة الويب المستضافة من خلال تطبيق `ngrok` والتي لا تعرض أي طلبات HTTP

    الشكل 5. واجهة الويب المستضافة من خلال تطبيق ngrok التي لا تعرض أي طلبات HTTP

  6. اختبِر تطبيق Chat من خلال إرسال رسالة مباشرة إليه:

    • افتح Google Chat.

      الانتقال إلى Google Chat

    • انقر على محادثة جديدة .

    • في مربّع الحوار، أدخِل اسم تطبيق Chat.

    • في نتائج البحث، ابحث عن تطبيق Chat، وانقر على إضافة > Chat.

    • في مساحة الرسالة المباشرة، اكتب Hey! واضغط على enter. لا يرد تطبيق Chat لأنّه قيد تصحيح الأخطاء بشكل نشط.

  7. في Visual Studio Code في بيئتك المحلية، يمكنك ملاحظة أنّه تم إيقاف التنفيذ مؤقتًا عند نقطة التوقف التي تم ضبطها.

    يتم إيقاف التنفيذ مؤقتًا عند نقطة الإيقاف التي تم ضبطها

    الشكل 6. يتم إيقاف التنفيذ مؤقتًا عند نقطة الإيقاف التي تم ضبطها.

  8. عند استئناف التنفيذ من أداة تصحيح الأخطاء في Visual Studio Code قبل أن تنتهي مهلة تطبيق Chat، سيردّ التطبيق باسمك وصورة الأفاتار في الرسالة.

  9. يمكنك مراجعة سجلات طلبات واستجابات HTTP من واجهة الويب التي يستضيفها تطبيق ngrok في بيئتك المحلية.

    طلب HTTP من واجهة الويب التي يستضيفها تطبيق `ngrok`

    الشكل 7. طلب HTTP من واجهة الويب التي يستضيفها تطبيق ngrok

  10. لتغيير سلوك التطبيق، استبدِل Hello بـ Hey في السطر 55 من الملف App.java، وأعِد تشغيل عملية mvnDebug، ثم أعِد تشغيل Remote Debug Watch لإعادة الربط وإعادة بدء تصحيح الأخطاء.

  11. في هذه المرة، بدلاً من إرسال رسالة ثانية Hey! في المساحة، يمكنك اختيار آخر طلب HTTP تم تسجيله على واجهة الويب المستضافة من خلال تطبيق ngrok في بيئتك المحلية والنقر على Replay. كما حدث في المرة السابقة، لا يردّ تطبيق Chat لأنّه يخضع حاليًا لتصحيح الأخطاء.

  12. عند استئناف التنفيذ من مصحّح الأخطاء في Visual Studio Code، يمكنك أن ترى من واجهة الويب التي يستضيفها تطبيق ngrok في بيئتك المحلية أنّ التطبيق ينشئ ردًا يتضمّن الإصدار المعدَّل من الرسالة.

تصحيح الأخطاء من بيئة بعيدة

في هذا القسم، ستتفاعل مع تطبيق Chat الذي يتم تنفيذه في بيئة بعيدة.

تصحيح الأخطاء من بيئة بعيدة

الشكل 9. تصحيح الأخطاء من بيئة بعيدة

المتطلبات الأساسية

  • مساحة رسالة مباشرة مع تطبيق Chat. يمكنك اتّباع القسم اختبار تطبيق Chat من دليل البدء السريع والبحث عن تطبيق Chat لبدء محادثة.
  • يُشار إلى تطبيقك الذي يتم تشغيله في بيئة بعيدة مع تفعيل أداة تصحيح الأخطاء على منفذ معيّن باسم REMOTE_DEBUG_PORT في تعليمات هذا الدليل.
  • يمكن أن ssh بيئتك المحلية إلى بيئتك البعيدة.
  • بيئة تطوير متكاملة (IDE) تم إعدادها في بيئتك المحلية ويمكنها تصحيح الأخطاء نستخدم في هذا الدليل Visual Studio Code IDE وميزات تصحيح الأخطاء التلقائية لأغراض توضيحية.

ربط البيئات المحلية والبعيدة

في بيئتك المحلية التي تريد بدء اتصال عميل تصحيح الأخطاء منها، عليك إعداد اتصال نفَقي عبر بروتوكول النقل الآمن (SSH) باتّباع الخطوات التالية:

ssh -L LOCAL_DEBUG_PORT:localhost:REMOTE_DEBUG_PORT REMOTE_USERNAME@REMOTE_ADDRESS

غيِّر القيم في السلسلة على الشكل التالي:

  • LOCAL_DEBUG_PORT: منفذ تصحيح الأخطاء في بيئتك المحلية
  • REMOTE_USERNAME: اسم المستخدم في بيئتك البعيدة
  • REMOTE_ADDRESS: عنوان بيئتك البعيدة
  • REMOTE_DEBUG_PORT: منفذ تصحيح الأخطاء في بيئتك البعيدة

تم الآن ربط منفذ تصحيح الأخطاء في بيئتك المحلية بمنفذ تصحيح الأخطاء في بيئتك البعيدة.

بدء تصحيح الأخطاء

من بيئة التطوير المتكاملة (IDE) Visual Studio Code المثبّتة في بيئتك المحلية، اتّبِع الخطوات التالية:

  1. في نافذة جديدة، افتح رمز المصدر لتطبيقك.
  2. أنشئ الملف .vscode/launch.json في الدليل الجذر، واضبط عملية تشغيل باسم Debug Remote تتصل بمنفذ تصحيح الأخطاء في بيئتك المحلية:

    Node.js

    {
        "version": "0.2.0",
        "configurations": [{
            "type": "node",
            "request": "attach",
            "name": "Debug Remote",
            "address": "127.0.0.1",
            "port": LOCAL_DEBUG_PORT
        }]
    }
    

    Python

    {
        "version": "0.2.0",
        "configurations": [{
            "type": "python",
            "request": "attach",
            "name": "Debug Remote",
            "connect": {
                "host": "127.0.0.1",
                "port": LOCAL_DEBUG_PORT
            }
        }]
    }
    

    Java

    {
        "version": "0.2.0",
        "configurations": [{
            "type": "java",
            "request": "attach",
            "name": "Debug Remote",
            "hostName": "127.0.0.1",
            "port": LOCAL_DEBUG_PORT
        }]
    }
    

    استبدِل LOCAL_DEBUG_PORT بمنفذ تصحيح الأخطاء في بيئتك المحلية.

  3. أضِف نقطة توقّف في الرمز المصدر لتطبيقك توقِف معالجة طلب HTTP مؤقتًا، ثم ابدأ التشغيل وتصحيح الأخطاء باستخدام إعداد Debug Remote الذي أضفته سابقًا.

في مساحة الرسائل المباشرة مع تطبيق Chat، اكتب أي شيء تريد اختباره واضغط على enter. لا يرد تطبيق Chat لأنّه يخضع حاليًا لتصحيح الأخطاء في بيئة التطوير المتكاملة Visual Studio Code.