برنامه‌های Google Chat را اشکال‌زدایی کنید

Node.js

پایتون

جاوا

Node.js

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

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

  npm install -g nodemon

• یک برنامه چت HTTP که برای پیام رسانی پیکربندی شده است. می‌توانید بخش‌های پیش‌نیازها ، راه‌اندازی محیط ، و انتشار برنامه در Google Chat راهنمای Quickstart را دنبال کنید. تنها تفاوت‌ها این است که باید نام برنامه را روی Debug App و URL نقطه پایانی HTTP را روی هر چیزی مانند http://example.com تنظیم کنید.

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

• Git در محیط محلی شما نصب شده است .

• یک حساب ngrok .

پایتون

• آخرین نسخه python3 نصب شده در محیط محلی شما.
• آخرین نسخه pip و virtualenv نصب شده در محیط محلی شما، به ترتیب برای مدیریت بسته های پایتون و محیط های مجازی استفاده می شوند.
• یک برنامه چت HTTP که برای پیام رسانی پیکربندی شده است. می‌توانید بخش‌های پیش‌نیازها ، راه‌اندازی محیط ، و انتشار برنامه در Google Chat راهنمای Quickstart را دنبال کنید. تنها تفاوت‌ها این است که باید نام برنامه را روی Debug App و URL نقطه پایانی HTTP را روی هر چیزی مانند http://example.com تنظیم کنید.
• یک IDE راه اندازی شده در محیط محلی شما که می تواند اشکال زدایی کند. ما از Visual Studio Code IDE و ویژگی‌های اشکال‌زدایی پیش‌فرض آن در این راهنما برای اهداف تصویری استفاده می‌کنیم.
• Git در محیط محلی شما نصب شده است .
• یک حساب ngrok .
• آخرین نسخه gcloud در محیط محلی شما نصب و راه اندازی شده است .

جاوا

• آخرین نسخه پایدار Java SE 11's JDK که در محیط محلی شما نصب شده است .
• آخرین نسخه Apache Maven که در محیط محلی شما نصب شده است ، برای مدیریت پروژه های جاوا استفاده می شود.
• یک برنامه چت HTTP که برای پیام رسانی پیکربندی شده است. می‌توانید بخش‌های پیش‌نیازها ، راه‌اندازی محیط ، و انتشار برنامه در Google Chat راهنمای Quickstart را دنبال کنید. تنها تفاوت‌ها این است که باید نام برنامه را روی Debug App و URL نقطه پایانی HTTP را روی هر چیزی مانند http://example.com تنظیم کنید.
• یک IDE راه اندازی شده در محیط محلی شما که می تواند اشکال زدایی کند. ما از Visual Studio Code IDE و ویژگی‌های اشکال‌زدایی پیش‌فرض آن در این راهنما برای اهداف تصویری استفاده می‌کنیم.
• Git در محیط محلی شما نصب شده است .
• یک حساب ngrok .
• آخرین نسخه gcloud در محیط محلی شما نصب و راه اندازی شده است .

Node.js

1. مخزن googleworkspace/google-chat-samples را از GitHub در محیط محلی خود کلون کنید، این مخزن حاوی کد برنامه برای اجرا است:

   git clone https://github.com/googleworkspace/google-chat-samples.git

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

   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 را ایجاد و پیکربندی کنید که با ایجاد فایل .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 گوش می دهد.

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

   ngrok http --domain=NGROK_STATIC_DOMAIN 9000

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

   

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

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

   

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

5. برنامه چت خود را با ارسال یک پیام مستقیم به آن تست کنید:

   • Google Chat را باز کنید.

     به Google Chat بروید

   • روی add جدید چت کلیک کنید.

   • در گفتگو، نام برنامه چت خود را وارد کنید.

   • در نتایج جستجو، برنامه چت خود را پیدا کنید، روی افزودن > گپ کلیک کنید.

   • در فضای پیام مستقیم، Hello تایپ کرده و enter فشار دهید. برنامه چت شما پاسخ نمی دهد زیرا به طور فعال در حال رفع اشکال است.

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

   

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

7. هنگامی که اجرای را از دیباگر Visual Studio Code قبل از اتمام زمان چت Google از سر می گیرید، برنامه چت پاسخ می دهد Your message : Hello .

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

   

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

9. برای تغییر رفتار برنامه، Your message با Here was your message inline 35 of the index.json جایگزین کنید. هنگامی که فایل را ذخیره می کنید، nodemon به طور خودکار برنامه را با کد منبع به روز شده بارگیری می کند و Visual Studio Code در حالت اشکال زدایی باقی می ماند.

   

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

10. این بار، به جای ارسال پیام دوم Hello در فضا، می توانید آخرین درخواست HTTP ثبت شده در رابط وب میزبانی شده توسط برنامه ngrok در محیط محلی خود را انتخاب کنید و روی Replay کلیک کنید. مانند دفعه قبل، برنامه چت شما پاسخ نمی دهد زیرا به طور فعال اشکال زدایی می شود.

11. هنگامی که اجرای را از دیباگر Visual Studio Code از سر می گیرید، می توانید از رابط وب میزبانی شده توسط برنامه ngrok در محیط محلی خود مشاهده کنید که برنامه با نسخه به روز شده پیام پاسخی ایجاد می کند. Here was your message : Hello .

پایتون

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

   gcloud config set project PROJECT_ID
   gcloud auth application-default login

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

2. مخزن googleworkspace/google-chat-samples را از GitHub در محیط محلی خود کلون کنید، این مخزن حاوی کد برنامه است:

   git clone https://github.com/googleworkspace/google-chat-samples.git

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

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

      

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

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

   ngrok http --domain=NGROK_STATIC_DOMAIN 9000

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

   

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

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

   

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

6. برنامه چت خود را با ارسال یک پیام مستقیم به آن تست کنید:

   • Google Chat را باز کنید.

     به Google Chat بروید

   • روی add جدید چت کلیک کنید.

   • در گفتگو، نام برنامه چت خود را وارد کنید.

   • در نتایج جستجو، برنامه چت خود را پیدا کنید، روی افزودن > گپ کلیک کنید.

   • در فضای پیام مستقیم، Hey! و enter فشار دهید. برنامه چت شما پاسخ نمی دهد زیرا به طور فعال در حال رفع اشکال است.

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

   

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

8. هنگامی که اجرای را از دیباگر Visual Studio Code قبل از اتمام زمان چت Google از سر می گیرید، برنامه چت با نام و تصویر آواتار شما در پیام پاسخ می دهد.

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

   

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

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

    

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

11. این بار به جای ارسال پیام دوم Hey! در این فضا، می توانید آخرین درخواست HTTP ثبت شده در رابط وب میزبانی شده توسط برنامه ngrok در محیط محلی خود را انتخاب کنید و روی Replay کلیک کنید. مانند دفعه قبل، برنامه چت شما پاسخ نمی دهد زیرا به طور فعال اشکال زدایی می شود.

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

جاوا

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

   gcloud config set project PROJECT_ID
   gcloud auth application-default login

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

2. مخزن googleworkspace/google-chat-samples را از GitHub در محیط محلی خود کلون کنید، این مخزن حاوی کد برنامه است:

   git clone https://github.com/googleworkspace/google-chat-samples.git

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

   1. در یک پنجره جدید، پوشه google-chat-samples/java/avatar-app را باز کنید.

   2. پروژه Maven را برای اجرای App کاربردی در پورت 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>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 گوش می دهد.

      

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

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

   ngrok http --domain=NGROK_STATIC_DOMAIN 9000

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

   

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

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

   

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

6. برنامه چت خود را با ارسال یک پیام مستقیم به آن تست کنید:

   • Google Chat را باز کنید.

     به Google Chat بروید

   • روی add جدید چت کلیک کنید.

   • در گفتگو، نام برنامه چت خود را وارد کنید.

   • در نتایج جستجو، برنامه چت خود را پیدا کنید، روی افزودن > گپ کلیک کنید.

   • در فضای پیام مستقیم، Hey! و enter فشار دهید. برنامه چت شما پاسخ نمی دهد زیرا به طور فعال در حال رفع اشکال است.

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

   

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

8. هنگامی که اجرای را از دیباگر Visual Studio Code قبل از اتمام زمان چت Google از سر می گیرید، برنامه چت با نام و تصویر آواتار شما در پیام پاسخ می دهد.

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

   

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

10. برای تغییر رفتار برنامه، Hello با Hey inline 55 از فایل App.java جایگزین کنید، فرآیند mvnDebug را مجدداً راه اندازی کنید و Remote Debug Watch مجدداً راه اندازی کنید تا اشکال زدایی را مجدداً ضمیمه کرده و مجدداً راه اندازی کنید .

11. این بار به جای ارسال پیام دوم Hey! در این فضا، می توانید آخرین درخواست HTTP ثبت شده در رابط وب میزبانی شده توسط برنامه ngrok در محیط محلی خود را انتخاب کنید و روی Replay کلیک کنید. مانند دفعه قبل، برنامه چت شما پاسخ نمی دهد زیرا به طور فعال اشکال زدایی می شود.

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