افزونه های Google Workspace را اشکال زدایی کنید

به عنوان یک توسعه دهنده افزونه Google Workspace، ممکن است برای آزمایش تغییرات یا عیب یابی مشکلات پیچیده نیاز به اشکال زدایی کد داشته باشید. اشکال زدایی افزونه های Google Workspace بسته به معماری برنامه، کاری که برنامه انجام می دهد، نحوه استقرار برنامه و تنظیمات برگزیده شما می تواند به روش های مختلفی انجام شود.

این صفحه نحوه اشکال زدایی افزونه Google Workspace را با استفاده از ngrok توضیح می دهد که یک پلت فرم ورودی یکپارچه است که می توانید از آن برای آزمایش محیط های توسعه محلی استفاده کنید. در این راهنما، تغییرات کد را در یک محیط محلی آزمایش می‌کنید و مشکلات را در یک محیط راه دور عیب‌یابی می‌کنید.

توجه: اگر افزونه Google Workspace شما با Google Apps Script ساخته شده است، به جای آن از موارد زیر استفاده کنید:

• آزمایش استقرار
• از اشکال زدا و نقاط شکست استفاده کنید

اشکال زدایی از محیط توسعه محلی

در این بخش، شما با افزونه Google Workspace خود که در محیط محلی شما اجرا می شود، تعامل دارید.

شکل 1. اشکال زدایی در یک محیط توسعه محلی.

پیش نیازها

Node.js

• آخرین نسخه های node و npm نصب شده در محیط محلی شما.

• آخرین نسخه nodemon نصب شده در محیط محلی شما، برای اهداف بارگذاری مجدد خودکار استفاده می شود:

  npm install -g nodemon
  

• یک پروژه Google Cloud . می‌توانید بخش‌های پیش‌نیازها و تنظیم محیط راهنمای Quickstart را دنبال کنید.

• کد افزونه Google Workspace برای رفع اشکال در محیط محلی شما. ما از ویژگی های پیوند پیش نمایش از نمونه کد 3p-resources از مخزن GitHub googleworkspace/add-ons-samples در این راهنما برای اهداف تصویری استفاده می کنیم.

• یک IDE راه اندازی شده در محیط محلی شما که می تواند اشکال زدایی کند. ما از Visual Studio Code IDE و ویژگی‌های اشکال‌زدایی پیش‌فرض آن در این راهنما برای اهداف تصویری استفاده می‌کنیم.

• یک حساب ngrok .

• آخرین نسخه gcloud در محیط محلی شما نصب و راه اندازی شده است .

پایتون

• آخرین نسخه python3 نصب شده در محیط محلی شما.
• آخرین نسخه pip و virtualenv نصب شده در محیط محلی شما، به ترتیب برای مدیریت بسته های پایتون و محیط های مجازی استفاده می شوند.
• یک پروژه Google Cloud . می‌توانید بخش‌های پیش‌نیازها و تنظیم محیط راهنمای Quickstart را دنبال کنید.
• کد افزونه Google Workspace برای رفع اشکال در محیط محلی شما. ما از ویژگی های پیوند پیش نمایش از نمونه کد 3p-resources از مخزن GitHub googleworkspace/add-ons-samples در این راهنما برای اهداف تصویری استفاده می کنیم.
• یک IDE راه اندازی شده در محیط محلی شما که می تواند اشکال زدایی کند. ما از Visual Studio Code IDE و ویژگی‌های اشکال‌زدایی پیش‌فرض آن در این راهنما برای اهداف تصویری استفاده می‌کنیم.
• یک حساب ngrok .
• آخرین نسخه gcloud در محیط محلی شما نصب و راه اندازی شده است .

جاوا

• آخرین نسخه پایدار Java SE 11's JDK که در محیط محلی شما نصب شده است .
• آخرین نسخه Apache Maven که در محیط محلی شما نصب شده است ، برای مدیریت پروژه های جاوا استفاده می شود.
• یک پروژه Google Cloud . می‌توانید بخش‌های پیش‌نیازها و تنظیم محیط راهنمای Quickstart را دنبال کنید.
• کد افزونه Google Workspace برای رفع اشکال در محیط محلی شما. ما از ویژگی های پیوند پیش نمایش از نمونه کد 3p-resources از مخزن GitHub googleworkspace/add-ons-samples در این راهنما برای اهداف تصویری استفاده می کنیم.
• یک IDE راه اندازی شده در محیط محلی شما که می تواند اشکال زدایی کند. ما از Visual Studio Code IDE و ویژگی‌های اشکال‌زدایی پیش‌فرض آن در این راهنما برای اهداف تصویری استفاده می‌کنیم.
• یک حساب ngrok .
• آخرین نسخه gcloud در محیط محلی شما نصب و راه اندازی شده است .

سرویس لوکال هاست را به صورت عمومی در دسترس قرار دهید

شما باید محیط محلی خود را به اینترنت متصل کنید تا افزونه Google Workspace بتواند به آن دسترسی داشته باشد. برنامه ngrok برای هدایت درخواست‌های HTTP به یک URL عمومی به محیط محلی شما استفاده می‌شود.

1. در یک مرورگر در محیط محلی خود، به حساب ngrok خود وارد شوید.
2. برنامه را نصب کنید و authtoken خود را در محیط محلی خود راه اندازی کنید.
3. یک دامنه ثابت در حساب ngrok خود ایجاد کنید ، در دستورالعمل های این راهنما به آن NGROK_STATIC_DOMAIN اشاره شده است.

توسعه افزودنی را ایجاد و نصب کنید

1. افزونه 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 خود را جایگزین NGROK_STATIC_DOMAIN کنید.

2. پروژه Google Cloud را برای استفاده تنظیم کنید:

   gcloud config set project PROJECT_ID
   

3. برای استفاده از اعتبارنامه پیش‌فرض برنامه، اعتبار کاربری جدید دریافت کنید:

   gcloud auth application-default login
   

   شناسه پروژه پروژه Google Cloud برنامه را جایگزین PROJECT_ID کنید.

4. ایجاد استقرار:

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

   مسیر فایل استقرار خود را جایگزین DEPLOYMENT_FILE_PATH کنید.

5. Deployment را نصب کنید:

   gcloud workspace-add-ons deployments install manageSupportCases
   

شکل 2. افزونه Google Workspace تمام درخواست های HTTP خود را به دامنه ثابت ارسال می کند. سرویس عمومی ngrok به عنوان پلی بین افزونه Google Workspace و کد برنامه ای که به صورت محلی اجرا می شود عمل می کند.

افزونه Google Workspace را آزمایش کنید

می‌توانید افزونه Google Workspace خود را به‌صورت محلی مستقر، آزمایش، اشکال‌زدایی و بارگیری مجدد خودکار کنید.

توجه: افزونه Google Workspace با چارچوب توابع Cloud در مثال ها اجرا می شود.

Node.js

1. از Visual Studio Code IDE که در محیط محلی شما نصب شده است، موارد زیر را انجام دهید:

   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 ایجاد و پیکربندی کنید که با ایجاد فایل .vscode/launch.json در فهرست اصلی، اسکریپت debug-watch را فعال می کند:

      {
          "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 گوش می دهد.

2. برنامه ngrok را در محیط محلی خود راه اندازی کنید:

   ngrok http --domain=NGROK_STATIC_DOMAIN 9000
   

   دامنه ثابت در حساب ngrok خود را جایگزین NGROK_STATIC_DOMAIN کنید. اکنون همه درخواست ها به محیط محلی شما و پورت مورد استفاده برنامه هدایت می شوند.

   

   شکل 4. ترمینال با سرور ngrok در حال اجرا و تغییر مسیر.

3. یک رابط وب نیز در لوکال هاست شما توسط برنامه ngrok راه اندازی می شود، شما می توانید با باز کردن آن در یک مرورگر، تمام فعالیت ها را نظارت کنید.

   

   شکل 5. رابط وب میزبانی شده توسط برنامه ngrok بدون درخواست HTTP.

4. افزونه Google Workspace خود را با پیش نمایش URL موردی در Google Doc جدید با حساب آزمایشگر آزمایش کنید:

   • یک Google Doc جدید ایجاد کنید.

     یک Google Doc جدید ایجاد کنید

   • لینک زیر را تایپ کنید و enter فشار دهید:

     https://example.com/support/case/?name=Name1&description=Description1&priority=P1
     

   • روی لینک کلیک کنید.

5. در Visual Studio Code در محیط محلی خود، می توانید ببینید که در نقطه شکستی که تنظیم شده است، اجرا متوقف شده است.

   

   شکل 6. اجرا در نقطه شکستی که تنظیم شده بود متوقف می شود.

6. هنگامی که اجرای را از دیباگر Visual Studio Code قبل از اتمام زمان افزونه‌های Google Workspace از سر می‌گیرید، افزونه Google Workspace پیش‌نمایش پیوند را در Google Doc از حافظه پنهان نمایش می‌دهد.

7. می‌توانید گزارش‌های درخواست و پاسخ HTTP را از رابط وب میزبانی شده توسط برنامه ngrok در محیط محلی خود بررسی کنید.

   

   شکل 7. درخواست HTTP از رابط وب میزبانی شده توسط برنامه ngrok .

8. برای تغییر رفتار برنامه، Case با Case: inline 51 of the index.js جایگزین کنید. هنگامی که فایل را ذخیره می کنید، nodemon به طور خودکار برنامه را با کد منبع به روز شده بارگیری می کند و Visual Studio Code در حالت اشکال زدایی باقی می ماند.

   

   شکل 8. برنامه در حال اجرا و گوش دادن به درخواست های HTTP در پورت 9000 با تغییر کد بارگذاری شده است.

9. این بار، به جای کلیک کردن بر روی پیوند و منتظر ماندن چند ثانیه در یک Google Doc جدید، می توانید آخرین درخواست HTTP ثبت شده در رابط وب میزبانی شده توسط برنامه ngrok در محیط محلی خود را انتخاب کنید و روی Replay کلیک کنید. مانند دفعه قبل، افزونه Google Workspace شما پاسخ نمی دهد زیرا به طور فعال اشکال زدایی می شود.

10. هنگامی که اجرای را از دیباگر Visual Studio Code از سر می گیرید، می توانید از رابط وب میزبانی شده توسط برنامه ngrok در محیط محلی خود مشاهده کنید که برنامه با نسخه به روز شده کارت پیش نمایش پاسخی ایجاد می کند.

پایتون

1. از Visual Studio Code IDE که در محیط محلی شما نصب شده است، موارد زیر را انجام دهید:

   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 گوش می دهد.

2. برنامه ngrok را در محیط محلی خود راه اندازی کنید:

   ngrok http --domain=NGROK_STATIC_DOMAIN 9000
   

   دامنه ثابت در حساب ngrok خود را جایگزین NGROK_STATIC_DOMAIN کنید. اکنون همه درخواست ها به محیط محلی شما و پورت مورد استفاده برنامه هدایت می شوند.

   

   شکل 4. ترمینال با سرور ngrok در حال اجرا و تغییر مسیر.

3. یک رابط وب نیز در لوکال هاست شما توسط برنامه ngrok راه اندازی می شود، شما می توانید با باز کردن آن در یک مرورگر، تمام فعالیت ها را نظارت کنید.

   

   شکل 5. رابط وب میزبانی شده توسط برنامه ngrok بدون درخواست HTTP.

4. افزونه Google Workspace خود را با پیش نمایش URL موردی در Google Doc جدید با حساب آزمایشگر آزمایش کنید:

   • یک Google Doc جدید ایجاد کنید.

     یک Google Doc جدید ایجاد کنید

   • لینک زیر را تایپ کرده و enter فشار دهید:

     https://example.com/support/case/?name=Name1&description=Description1&priority=P1
     

   • روی لینک کلیک کنید.

5. در Visual Studio Code در محیط محلی خود، می توانید ببینید که در نقطه شکستی که تنظیم شده است، اجرا متوقف شده است.

   

   شکل 6. اجرا در نقطه شکستی که تنظیم شده بود متوقف می شود.

6. هنگامی که اجرای را از دیباگر Visual Studio Code قبل از اتمام زمان افزونه‌های Google Workspace از سر می‌گیرید، افزونه Google Workspace پیش‌نمایش پیوند را در Google Doc از حافظه پنهان نمایش می‌دهد.

7. می‌توانید گزارش‌های درخواست و پاسخ HTTP را از رابط وب میزبانی شده توسط برنامه ngrok در محیط محلی خود بررسی کنید.

   

   شکل 7. درخواست HTTP از رابط وب میزبانی شده توسط برنامه ngrok .

8. برای تغییر رفتار برنامه، Case با Case: inline 56 از فایل main.py جایگزین کنید. هنگامی که فایل را ذخیره می کنید، Visual Studio Code به طور خودکار برنامه را با کد منبع به روز شده بارگیری می کند و در حالت اشکال زدایی باقی می ماند.

   

   شکل 8. برنامه در حال اجرا و گوش دادن به درخواست های HTTP در پورت 9000 با تغییر کد بارگذاری شده است.

9. این بار، به جای کلیک کردن بر روی پیوند و منتظر ماندن چند ثانیه در یک Google Doc جدید، می توانید آخرین درخواست HTTP ثبت شده در رابط وب میزبانی شده توسط برنامه ngrok در محیط محلی خود را انتخاب کنید و روی Replay کلیک کنید. مانند دفعه قبل، افزونه Google Workspace شما پاسخ نمی دهد زیرا به طور فعال اشکال زدایی می شود.

10. هنگامی که اجرای را از دیباگر Visual Studio Code از سر می گیرید، می توانید از رابط وب میزبانی شده توسط برنامه ngrok در محیط محلی خود مشاهده کنید که برنامه با نسخه به روز شده کارت پیش نمایش پاسخی ایجاد می کند.

جاوا

1. از Visual Studio Code IDE که در محیط محلی شما نصب شده است، موارد زیر را انجام دهید:

   1. در یک پنجره جدید، پوشه add-ons-samples/java/3p-resources باز کنید.

   2. پروژه Maven را برای اجرای برنامه CreateLinkPreview در پورت 9000 به صورت محلی با افزودن افزونه ساخت Cloud Functions Framework function-maven-plugin در فایل 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 است.

2. برنامه ngrok را در محیط محلی خود راه اندازی کنید:

   ngrok http --domain=NGROK_STATIC_DOMAIN 9000
   

   دامنه ثابت در حساب ngrok خود را جایگزین NGROK_STATIC_DOMAIN کنید. اکنون همه درخواست ها به محیط محلی شما و پورت مورد استفاده برنامه هدایت می شوند.

   

   شکل 4. ترمینال با سرور ngrok در حال اجرا و تغییر مسیر.

3. یک رابط وب نیز در لوکال هاست شما توسط برنامه ngrok راه اندازی می شود، شما می توانید با باز کردن آن در یک مرورگر، تمام فعالیت ها را نظارت کنید.

   

   شکل 5. رابط وب میزبانی شده توسط برنامه ngrok بدون درخواست HTTP.

4. افزونه Google Workspace خود را با پیش نمایش URL موردی در Google Doc جدید با حساب آزمایشگر آزمایش کنید:

   • یک Google Doc جدید ایجاد کنید.

     یک Google Doc جدید ایجاد کنید

   • لینک زیر را تایپ کرده و enter فشار دهید:

     https://example.com/support/case/?name=Name1&description=Description1&priority=P1
     

   • روی لینک کلیک کنید.

5. در Visual Studio Code در محیط محلی خود، می توانید ببینید که در نقطه شکستی که تنظیم شده است، اجرا متوقف شده است.

   

   شکل 6. اجرا در نقطه شکستی که تنظیم شده بود متوقف می شود.

6. هنگامی که اجرای را از دیباگر Visual Studio Code قبل از اتمام زمان افزونه‌های Google Workspace از سر می‌گیرید، افزونه Google Workspace پیش‌نمایش پیوند را در Google Doc از حافظه پنهان نمایش می‌دهد.

7. می‌توانید گزارش‌های درخواست و پاسخ HTTP را از رابط وب میزبانی شده توسط برنامه ngrok در محیط محلی خود بررسی کنید.

   

   شکل 7. درخواست HTTP از رابط وب میزبانی شده توسط برنامه ngrok .

8. برای تغییر رفتار برنامه، Case با Case: inline 78 از فایل CreateLinkPreview.java جایگزین کنید، فرآیند mvnDebug را مجدداً راه اندازی کنید و Remote Debug Watch مجدداً راه اندازی کنید تا دوباره ضمیمه شده و اشکال زدایی مجدد شروع شود .

9. این بار، به جای کلیک کردن بر روی پیوند و منتظر ماندن چند ثانیه در یک Google Doc جدید، می توانید آخرین درخواست HTTP ثبت شده در رابط وب میزبانی شده توسط برنامه ngrok در محیط محلی خود را انتخاب کنید و روی Replay کلیک کنید. مانند دفعه قبل، افزونه Google Workspace شما پاسخ نمی دهد زیرا به طور فعال اشکال زدایی می شود.

10. هنگامی که اجرای را از دیباگر 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 IDE که در محیط محلی شما نصب شده است، موارد زیر را انجام دهید:

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
       }]
   }
   

   پایتون

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

   جاوا

   {
       "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 که قبلاً اضافه شده است ، اجرا و اشکال زدایی را شروع کنید .

با افزونه Google Workspace نصب شده خود تعامل داشته باشید. افزونه Google Workspace شما پاسخ نمی دهد زیرا به طور فعال در Visual Studio Code IDE اشکال زدایی می شود.

مطالب مرتبط

نحوه پرس و جو کردن گزارش های خطا را بیاموزید.