تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

تصحيح أخطاء إضافات Google Workspace

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

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

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

في هذا القسم، يمكنك التفاعل مع "إضافة Google Workspace" التي يتم تنفيذها في بيئتك المحلية.

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

الشكل 1. تصحيح الأخطاء في بيئة التطوير المحلي

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

Node.js

أحدث إصدارات من node وnpm تم تثبيتها في بيئتك المحلية.
أحدث إصدار من تطبيق "nodemon" المثبَّت في بيئتك المحلية ويُستخدم لأغراض إعادة التحميل تلقائيًا:
```
npm install -g nodemon
```
مشروع على Google Cloud: يمكنك اتّباع الأقسام المتطلبات الأساسية وضبط بيئة دليل التشغيل السريع.
هو رمز إضافة Google Workspace لتصحيح الأخطاء في بيئتك المحلية. نستخدم ميزات رابط المعاينة من مثال الرمز البرمجي 3p-resources من مستودع GitHub googleworkspace/add-ons-samples في هذا الدليل لأغراض التوضيح.
بيئة تطوير متكاملة (IDE) تم إعدادها في بيئتك المحلية والتي يمكن تصحيح الأخطاء فيها. نستخدم Visual Studio Code IDE وميزات تصحيح الأخطاء التلقائية في هذا الدليل لأغراض التوضيح.
حساب على ngrok
أحدث إصدار من gcloud تم تثبيته وتم إعداده في بيئةك المحلية.

Python

أحدث إصدار من python3 مثبّت في بيئتك المحلية.
تم تثبيت أحدث إصدار من pip وvirtualenv في بيئتك المحلية، ويتم استخدامهما لإدارة حزم Python والبيئات الافتراضية على التوالي.
مشروع على Google Cloud: يمكنك اتّباع الأقسام المتطلبات الأساسية وضبط بيئة دليل التشغيل السريع.
هو رمز إضافة Google Workspace لتصحيح الأخطاء في بيئتك المحلية. نستخدم ميزات رابط المعاينة من مثال الرمز البرمجي 3p-resources من مستودع GitHub googleworkspace/add-ons-samples في هذا الدليل لأغراض التوضيح.
بيئة تطوير متكاملة (IDE) تم إعدادها في بيئتك المحلية والتي يمكن تصحيح الأخطاء فيها. نستخدم Visual Studio Code IDE وميزات تصحيح الأخطاء التلقائية في هذا الدليل لأغراض التوضيح.
حساب على ngrok
أحدث إصدار من gcloud تم تثبيته وتم إعداده في بيئةك المحلية.

Java

أحدث إصدار ثابت من Java SE 11's JDK المثبَّت في بيئتك المحلية.
أحدث إصدار من Apache Maven مثبّت في بيئتك المحلية، ويتم استخدامه لإدارة مشاريع Java.
مشروع على Google Cloud: يمكنك اتّباع الأقسام المتطلبات الأساسية وضبط بيئة دليل التشغيل السريع.
هو رمز إضافة Google Workspace لتصحيح الأخطاء في بيئتك المحلية. نستخدم ميزات رابط المعاينة من مثال الرمز البرمجي 3p-resources من مستودع GitHub googleworkspace/add-ons-samples في هذا الدليل لأغراض التوضيح.
بيئة تطوير متكاملة (IDE) تم إعدادها في بيئتك المحلية والتي يمكن تصحيح الأخطاء فيها. نستخدم Visual Studio Code IDE وميزات تصحيح الأخطاء التلقائية في هذا الدليل لأغراض التوضيح.
حساب على ngrok
أحدث إصدار من gcloud تم تثبيته وتم إعداده في بيئةك المحلية.

إتاحة خدمة المضيف المحلي للجميع

عليك توصيل بيئتك المحلية بالإنترنت حتى تتمكّن "إضافة Google Workspace" من الوصول إليها. يُستخدم تطبيق ngrok لإعادة توجيه طلبات HTTP التي يتم إجراؤها إلى عنوان URL متاح للجميع إلى بيئتك المحلية.

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

إنشاء عملية نشر الإضافة وتثبيتها

اضبط إضافة Google Workspace لإرسال جميع طلبات HTTP إلى نطاقك الثابت. يجب أن يظهر ملف النشر على النحو التالي:

{
  "oauthScopes": [
    "https://www.googleapis.com/auth/workspace.linkpreview",
    "https://www.googleapis.com/auth/workspace.linkcreate"
  ],
  "addOns": {
    "common": {
      "name": "Manage support cases",
      "logoUrl": "https://developers.google.com/workspace/add-ons/images/support-icon.png",
      "layoutProperties": {
        "primaryColor": "#dd4b39"
      }
    },
    "docs": {
      "linkPreviewTriggers": [
        {
          "runFunction": "NGROK_STATIC_DOMAIN",
          "patterns": [
            {
              "hostPattern": "example.com",
              "pathPrefix": "support/cases"
            },
            {
              "hostPattern": "*.example.com",
              "pathPrefix": "cases"
            },
            {
              "hostPattern": "cases.example.com"
            }
          ],
          "labelText": "Support case",
          "localizedLabelText": {
            "es": "Caso de soporte"
          },
          "logoUrl": "https://developers.google.com/workspace/add-ons/images/support-icon.png"
        }
      ],
      "createActionTriggers": [
        {
          "id": "createCase",
          "labelText": "Create support case",
          "localizedLabelText": {
            "es": "Crear caso de soporte"
          },
          "runFunction": "$URL2",
          "logoUrl": "https://developers.google.com/workspace/add-ons/images/support-icon.png"
        }
      ]
    }
  }
}

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

اضبط مشروع Google Cloud لاستخدام:
```
gcloud config set project PROJECT_ID
```
احصل على بيانات اعتماد جديدة للمستخدم لاستخدامها في بيانات الاعتماد التلقائية للتطبيق:
```
gcloud auth application-default login
```
استبدِل PROJECT_ID برقم تعريف المشروع الخاص بمشروع Google Cloud الخاص بالتطبيق.

إنشاء عملية النشر:

gcloud workspace-add-ons deployments create manageSupportCases \
    --deployment-file=DEPLOYMENT_FILE_PATH

استبدل DEPLOYMENT_FILE_PATH بمسار ملف النشر.

تثبيت عملية النشر:

gcloud workspace-add-ons deployments install manageSupportCases

ترسِل "إضافة Google Workspace" جميع طلبات HTTP إلى النطاق الثابت.

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

اختبار إضافة Google Workspace

يمكنك تفعيل "إضافة Google Workspace" واختبارها وتصحيح الأخطاء فيها وإعادة تحميلها تلقائيًا.

Node.js

من بيئة التطوير المتكاملة Visual Studio Code التي تم تثبيتها في بيئتك المحلية، عليك تنفيذ ما يلي:
1. في نافذة جديدة، افتح المجلد add-ons-samples/node/3p-resources.
2. يمكنك إعداد التطبيق للتشغيل المحلي وتصحيح الأخطاء في إعادة التحميل التلقائي من خلال إضافة تبعية واحدة ونص برمجيَّين في ملف package.json:
```
{
    ...
    "dependencies": {
      ...
      "@google-cloud/functions_framework": "^3.3.0"
    },
    "scripts": {
        ...
        "start": "npx functions-framework --target=createLinkPreview --port=9000",
        "debug-watch": "nodemon --watch ./ --exec npm start"
    }
    ...
}
```
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.
  
  الشكل 3. التطبيق قيد التشغيل ويستمع إلى طلبات HTTP على المنفذ 9000.
تشغيل تطبيق ngrok في بيئتك المحلية:
```
ngrok http --domain=NGROK_STATIC_DOMAIN 9000
```
استبدل NGROK_STATIC_DOMAIN بالنطاق الثابت في حسابك في ngrok. ستتم الآن إعادة توجيه جميع الطلبات إلى بيئتك المحلية والمنفذ الذي يستخدمه التطبيق.

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

الشكل 5. واجهة الويب التي يستضيفها تطبيق ngrok لا تعرض أي طلبات HTTP.
يمكنك اختبار "إضافة Google Workspace" من خلال معاينة عنوان URL لطلب الحصول على دعم في مستند Google جديد باستخدام حساب مختبِر:
- إنشاء مستند Google جديد
  
  إنشاء مستند Google جديد
- اكتب الرابط التالي واضغط على enter:
```
https://example.com/support/case/?name=Name1&description=Description1&priority=P1
```
- انقر على هذا الرابط.
في علامة Visual Studio Code في بيئتك المحلية، يمكنك ملاحظة أنّ عملية التنفيذ متوقّفة مؤقتًا عند نقطة الإيقاف التي تم ضبطها.

الشكل 6. تم إيقاف التنفيذ مؤقتًا عند النقطة التي تم ضبطها.
عند استئناف التنفيذ من برنامج تصحيح أخطاء Visual Studio Code قبل انتهاء مهلة "إضافات Google Workspace"، تعرض "إضافة Google Workspace" معاينة الرابط في مستند Google من ذاكرة التخزين المؤقت.
يمكنك التحقّق من طلبات HTTP وسجلّات الاستجابة من واجهة الويب التي يستضيفها تطبيق ngrok في بيئتك المحلية.

الشكل 7. طلب HTTP من واجهة الويب التي يستضيفها تطبيق ngrok.
لتغيير سلوك التطبيق، استبدِل Case بـ Case: مضمَّنة 51 من index.js. عند حفظ الملف، يعيد nodemon تلقائيًا تحميل التطبيق باستخدام رمز المصدر المعدّل ويبقى Visual Studio Code في وضع تصحيح الأخطاء.

الشكل 8. التطبيق قيد التشغيل ويستمع إلى طلبات HTTP على المنفذ 9000 مع تحميل تغيير الرمز.
هذه المرة، بدلاً من النقر على الرابط والانتظار لبضع ثوانٍ في مستند Google جديد، يمكنك اختيار آخر طلب HTTP تم تسجيله على واجهة الويب المُستضافة من قِبل تطبيق ngrok في بيئتك المحلية والنقر على Replay. كما كانت الحال في المرة السابقة، لا تردّ "إضافة Google Workspace" لأنّها تخضع للتصحيح النشط.
عند استئناف التنفيذ من برنامج تصحيح أخطاء Visual Studio Code، يمكنك أن تلاحظ من واجهة الويب التي يستضيفها تطبيق ngrok في بيئتك المحلية أنّ التطبيق ينشئ استجابة باستخدام الإصدار المحدَّث من بطاقة المعاينة.

Python

من بيئة التطوير المتكاملة Visual Studio Code التي تم تثبيتها في بيئتك المحلية، عليك تنفيذ ما يلي:
1. في نافذة جديدة، افتح المجلد add-ons-samples/python/3p-resources/create_link_preview.
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", "create_link_preview",
            "--port", "9000",
            "--debug"
        ]
    }]
}
```
5. أضِف نقطة توقف تُوقف معالجة طلب HTTP مؤقتًا في ملف main.py، وابدأ التشغيل وتصحيح الأخطاء بعد إضافة إعدادات Debug Watch. يعمل التطبيق الآن ويستمع إلى طلبات HTTP على المنفذ 9000.
  
  الشكل 3. التطبيق قيد التشغيل ويستمع إلى طلبات HTTP على المنفذ 9000.
تشغيل تطبيق ngrok في بيئتك المحلية:
```
ngrok http --domain=NGROK_STATIC_DOMAIN 9000
```
استبدل NGROK_STATIC_DOMAIN بالنطاق الثابت في حسابك في ngrok. ستتم الآن إعادة توجيه جميع الطلبات إلى بيئتك المحلية والمنفذ الذي يستخدمه التطبيق.

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

الشكل 5. واجهة الويب التي يستضيفها تطبيق ngrok لا تعرض أي طلبات HTTP.
يمكنك اختبار "إضافة Google Workspace" من خلال معاينة عنوان URL لطلب الحصول على دعم في مستند Google جديد باستخدام حساب مختبِر:
- إنشاء مستند Google جديد
  
  إنشاء مستند Google جديد
- اكتب الرابط التالي واضغط على enter:
```
https://example.com/support/case/?name=Name1&description=Description1&priority=P1
```
- انقر على هذا الرابط.
في علامة Visual Studio Code في بيئتك المحلية، يمكنك ملاحظة أنّ عملية التنفيذ متوقّفة مؤقتًا عند نقطة الإيقاف التي تم ضبطها.

الشكل 6. تم إيقاف التنفيذ مؤقتًا عند النقطة التي تم ضبطها.
عند استئناف التنفيذ من برنامج تصحيح أخطاء Visual Studio Code قبل انتهاء مهلة "إضافات Google Workspace"، تعرض "إضافة Google Workspace" معاينة الرابط في مستند Google من ذاكرة التخزين المؤقت.
يمكنك التحقّق من طلبات HTTP وسجلّات الاستجابة من واجهة الويب التي يستضيفها تطبيق ngrok في بيئتك المحلية.

الشكل 7. طلب HTTP من واجهة الويب التي يستضيفها تطبيق ngrok.
لتغيير سلوك التطبيق، استبدِل Case بـ Case: مضمَّنة 56 من ملف main.py. عند حفظ الملف، يعيد Visual Studio Code تحميل التطبيق تلقائيًا باستخدام رمز المصدر المعدّل ويظل في وضع تصحيح الأخطاء.

الشكل 8. التطبيق قيد التشغيل ويستمع إلى طلبات HTTP على المنفذ 9000 مع تحميل تغيير الرمز.
هذه المرة، بدلاً من النقر على الرابط والانتظار لبضع ثوانٍ في مستند Google جديد، يمكنك اختيار آخر طلب HTTP تم تسجيله على واجهة الويب المُستضافة من قِبل تطبيق ngrok في بيئتك المحلية والنقر على Replay. كما كانت الحال في المرة السابقة، لا تردّ "إضافة Google Workspace" لأنّها تخضع للتصحيح النشط.
عند استئناف التنفيذ من برنامج تصحيح أخطاء Visual Studio Code، يمكنك أن تلاحظ من واجهة الويب التي يستضيفها تطبيق ngrok في بيئتك المحلية أنّ التطبيق ينشئ استجابة باستخدام الإصدار المحدَّث من بطاقة المعاينة.

Java

من بيئة التطوير المتكاملة Visual Studio Code التي تم تثبيتها في بيئتك المحلية، عليك تنفيذ ما يلي:
1. في نافذة جديدة، افتح المجلد add-ons-samples/java/3p-resources.
2. اضبط مشروع Maven لتشغيل التطبيق CreateLinkPreview على المنفذ 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>CreateLinkPreview</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 مؤقتًا في ملف CreateLinkPreview.java، وابدأ بالإرفاق وتصحيح الأخطاء بعد إضافة إعدادات Remote Debug Watch التي سبق أن تمت إضافتها. التطبيق قيد التشغيل الآن ويستمع إلى طلبات HTTP على المنفذ 9000.
  
  الشكل 3. التطبيق قيد التشغيل ويستمع إلى طلبات HTTP على المنفذ 9000.
تشغيل تطبيق ngrok في بيئتك المحلية:
```
ngrok http --domain=NGROK_STATIC_DOMAIN 9000
```
استبدل NGROK_STATIC_DOMAIN بالنطاق الثابت في حسابك في ngrok. ستتم الآن إعادة توجيه جميع الطلبات إلى بيئتك المحلية والمنفذ الذي يستخدمه التطبيق.

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

الشكل 5. واجهة الويب التي يستضيفها تطبيق ngrok لا تعرض أي طلبات HTTP.
يمكنك اختبار "إضافة Google Workspace" من خلال معاينة عنوان URL لطلب الحصول على دعم في مستند Google جديد باستخدام حساب مختبِر:
- إنشاء مستند Google جديد
  
  إنشاء مستند Google جديد
- اكتب الرابط التالي واضغط على enter:
```
https://example.com/support/case/?name=Name1&description=Description1&priority=P1
```
- انقر على هذا الرابط.
في علامة Visual Studio Code في بيئتك المحلية، يمكنك ملاحظة أنّ عملية التنفيذ متوقّفة مؤقتًا عند نقطة الإيقاف التي تم ضبطها.

الشكل 6. تم إيقاف التنفيذ مؤقتًا عند النقطة التي تم ضبطها.
عند استئناف التنفيذ من برنامج تصحيح أخطاء Visual Studio Code قبل انتهاء مهلة "إضافات Google Workspace"، تعرض "إضافة Google Workspace" معاينة الرابط في مستند Google من ذاكرة التخزين المؤقت.
يمكنك التحقّق من طلبات HTTP وسجلّات الاستجابة من واجهة الويب التي يستضيفها تطبيق ngrok في بيئتك المحلية.

الشكل 7. طلب HTTP من واجهة الويب التي يستضيفها تطبيق ngrok.
لتغيير سلوك التطبيق، استبدِل Case بـ Case: مضمَّنة 78 من ملف CreateLinkPreview.java، وأعِد تشغيل عملية mvnDebug، وأعِد تشغيل Remote Debug Watch لإعادة إرفاق تصحيح الأخطاء وإعادة تشغيله.
هذه المرة، بدلاً من النقر على الرابط والانتظار لبضع ثوانٍ في مستند Google جديد، يمكنك اختيار آخر طلب HTTP تم تسجيله على واجهة الويب المُستضافة من قِبل تطبيق ngrok في بيئتك المحلية والنقر على Replay. كما كانت الحال في المرة السابقة، لا تردّ "إضافة Google Workspace" لأنّها تخضع للتصحيح النشط.
عند استئناف التنفيذ من برنامج تصحيح أخطاء Visual Studio Code، يمكنك أن تلاحظ من واجهة الويب التي يستضيفها تطبيق ngrok في بيئتك المحلية أنّ التطبيق ينشئ استجابة باستخدام الإصدار المحدَّث من بطاقة المعاينة.

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

في هذا القسم، يمكنك التفاعل مع "إضافة Google Workspace" التي يتم تنفيذها في بيئة بعيدة.

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

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

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

تم نشر إضافة Google Workspace وتثبيتها.
وعندما يتم تشغيل تطبيقك في البيئة البعيدة مع تفعيل برنامج تصحيح الأخطاء على منفذ معيّن، تتم الإشارة إليه باسم 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: منفذ تصحيح الأخطاء في البيئة البعيدة.

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

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

من بيئة التطوير المتكاملة Visual Studio Code التي تم تثبيتها في بيئتك المحلية، يمكنك تنفيذ ما يلي:

في نافذة جديدة، افتح رمز المصدر لتطبيقك.

يمكنك إنشاء الملف .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 بمنفذ تصحيح الأخطاء في بيئتك المحلية.

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

التفاعل مع إضافة Google Workspace المثبَّتة لا تردّ "إضافة Google Workspace" عليها لأنّه يتم تصحيح أخطائها في بيئة التطوير المتكاملة Visual Studio Code.

مواضيع ذات صلة

تعرَّف على كيفية طلب البحث عن سجلّات الأخطاء.