HTTP Google Workspace অ্যাড-অন পরীক্ষা করে ডিবাগ করুন

নোড.জেএস

• আপনার স্থানীয় পরিবেশে node এবং npm এর সর্বশেষ সংস্করণ ইনস্টল করা আছে ।

• আপনার স্থানীয় পরিবেশে nodemon এর সর্বশেষ সংস্করণ ইনস্টল করা আছে । এটি স্বয়ংক্রিয়ভাবে রিলোড করার জন্য ব্যবহৃত হয়:

  npm install -g nodemon

• একটি গুগল ক্লাউড প্রজেক্ট । আপনি কুইকস্টার্ট গাইডের 'পূর্বশর্ত' এবং 'পরিবেশ সেট আপ' অংশগুলো অনুসরণ করতে পারেন।

• আপনার স্থানীয় পরিবেশে ডিবাগ করার জন্য গুগল ওয়ার্কস্পেস অ্যাড-অনের কোড। এই নির্দেশিকায়, দৃষ্টান্তমূলক উদ্দেশ্যে আমরা গিটহাব রিপোজিটরি googleworkspace/add-ons-samples এর 3p-resources কোড উদাহরণ থেকে প্রিভিউ লিঙ্ক বৈশিষ্ট্যগুলি ব্যবহার করেছি।

• আপনার স্থানীয় পরিবেশে সেট আপ করা একটি IDE যা ডিবাগ করতে পারে। এই নির্দেশিকায় আমরা দৃষ্টান্তমূলক উদ্দেশ্যে Visual Studio Code IDE এবং এর ডিফল্ট ডিবাগিং বৈশিষ্ট্যগুলি ব্যবহার করেছি।

• একটি ngrok অ্যাকাউন্ট।

• আপনার স্থানীয় পরিবেশে gcloud এর সর্বশেষ সংস্করণ ইনস্টল এবং চালু করা হয়েছে ।

পাইথন

• আপনার স্থানীয় পরিবেশে python3 এর সর্বশেষ সংস্করণ ইনস্টল করা আছে ।
• আপনার লোকাল এনভায়রনমেন্টে pip এবং virtualenv এর সর্বশেষ সংস্করণ ইনস্টল করা আছে। এগুলো যথাক্রমে পাইথন প্যাকেজ এবং ভার্চুয়াল এনভায়রনমেন্ট পরিচালনা করতে ব্যবহৃত হয়।
• একটি গুগল ক্লাউড প্রজেক্ট । আপনি কুইকস্টার্ট গাইডের 'পূর্বশর্ত' এবং 'পরিবেশ সেট আপ' অংশগুলো অনুসরণ করতে পারেন।
• আপনার স্থানীয় পরিবেশে ডিবাগ করার জন্য গুগল ওয়ার্কস্পেস অ্যাড-অনের কোড। এই নির্দেশিকায়, দৃষ্টান্তমূলক উদ্দেশ্যে আমরা গিটহাব রিপোজিটরি googleworkspace/add-ons-samples এর 3p-resources কোড উদাহরণ থেকে প্রিভিউ লিঙ্ক বৈশিষ্ট্যগুলি ব্যবহার করেছি।
• আপনার স্থানীয় পরিবেশে সেট আপ করা একটি IDE যা ডিবাগ করতে পারে। এই নির্দেশিকায় আমরা দৃষ্টান্তমূলক উদ্দেশ্যে Visual Studio Code IDE এবং এর ডিফল্ট ডিবাগিং বৈশিষ্ট্যগুলি ব্যবহার করেছি।
• একটি ngrok অ্যাকাউন্ট।
• আপনার স্থানীয় পরিবেশে gcloud এর সর্বশেষ সংস্করণ ইনস্টল এবং চালু করা হয়েছে ।

জাভা

• আপনার স্থানীয় পরিবেশে Java SE 11's JDK এর সর্বশেষ স্থিতিশীল সংস্করণ ইনস্টল করা আছে ।
• আপনার লোকাল এনভায়রনমেন্টে Apache Maven সর্বশেষ সংস্করণ ইনস্টল করা আছে । এটি জাভা প্রজেক্ট পরিচালনা করতে ব্যবহৃত হয়।
• একটি গুগল ক্লাউড প্রজেক্ট । আপনি কুইকস্টার্ট গাইডের 'পূর্বশর্ত' এবং 'পরিবেশ সেট আপ' অংশগুলো অনুসরণ করতে পারেন।
• আপনার স্থানীয় পরিবেশে ডিবাগ করার জন্য গুগল ওয়ার্কস্পেস অ্যাড-অনের কোড। এই নির্দেশিকায়, দৃষ্টান্তমূলক উদ্দেশ্যে আমরা গিটহাব রিপোজিটরি googleworkspace/add-ons-samples এর 3p-resources কোড উদাহরণ থেকে প্রিভিউ লিঙ্ক বৈশিষ্ট্যগুলি ব্যবহার করেছি।
• আপনার স্থানীয় পরিবেশে সেট আপ করা একটি IDE যা ডিবাগ করতে পারে। এই নির্দেশিকায় আমরা দৃষ্টান্তমূলক উদ্দেশ্যে Visual Studio Code IDE এবং এর ডিফল্ট ডিবাগিং বৈশিষ্ট্যগুলি ব্যবহার করেছি।
• একটি ngrok অ্যাকাউন্ট।
• আপনার স্থানীয় পরিবেশে gcloud এর সর্বশেষ সংস্করণ ইনস্টল এবং চালু করা হয়েছে ।

নোড.জেএস

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. রুট ডিরেক্টরিতে .vscode/launch.json ফাইলটি তৈরি করে Debug Watch নামের একটি লঞ্চ তৈরি ও কনফিগার করুন, যা debug-watch স্ক্রিপ্টটিকে ট্রিগার করবে:

      {
          "version": "0.2.0",
          "configurations": [{
              "type": "node",
              "request": "launch",
              "name": "Debug Watch",
              "cwd": "${workspaceRoot}",
              "runtimeExecutable": "npm",
              "runtimeArgs": ["run-script", "debug-watch"]
          }]
      }
      

   5. index.js ফাইলে একটি ব্রেকপয়েন্ট যোগ করুন যা HTTP অনুরোধ প্রক্রিয়াকরণকে থামিয়ে দেবে, এবং পূর্বে যোগ করা Debug Watch কনফিগারেশন ব্যবহার করে অ্যাপ্লিকেশনটি চালানো ও ডিবাগ করা শুরু করুন । অ্যাপ্লিকেশনটি এখন চলছে এবং 9000 পোর্টে HTTP অনুরোধের জন্য অপেক্ষা করছে।

      

2. আপনার স্থানীয় পরিবেশে ngrok অ্যাপ্লিকেশনটি চালু করুন:

   ngrok http --domain=NGROK_STATIC_DOMAIN 9000

   NGROK_STATIC_DOMAIN জায়গায় আপনার ngrok অ্যাকাউন্টের স্ট্যাটিক ডোমেইনটি বসান। এখন থেকে সমস্ত অনুরোধ আপনার লোকাল এনভায়রনমেন্ট এবং অ্যাপ্লিকেশন দ্বারা ব্যবহৃত পোর্টে রিডাইরেক্ট করা হবে।

   

3. ngrok অ্যাপ্লিকেশনটি আপনার লোকালহোস্টে একটি ওয়েব ইন্টারফেসও চালু করে। আপনি ব্রাউজারে এটি খুলে সমস্ত কার্যকলাপ পর্যবেক্ষণ করতে পারেন।

   

4. একটি টেস্টার অ্যাকাউন্ট ব্যবহার করে নতুন একটি গুগল ডকে কেস ইউআরএল প্রিভিউ করার মাধ্যমে আপনার গুগল ওয়ার্কস্পেস অ্যাড-অনটি পরীক্ষা করুন:

   • একটি গুগল ডক তৈরি করুন।

     একটি গুগল ডক তৈরি করুন

   • নিম্নলিখিত লিঙ্কটি টাইপ করুন এবং enter চাপুন:

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

   • লিঙ্কটিতে ক্লিক করুন।

5. আপনার স্থানীয় পরিবেশে থাকা Visual Studio Code আপনি দেখতে পাবেন যে, সেট করা ব্রেকপয়েন্টটিতে প্রোগ্রামটি থেমে আছে।

   

6. গুগল ওয়ার্কস্পেস অ্যাড-অনের টাইম আউট হওয়ার আগে আপনি যখন Visual Studio Code ডিবাগার থেকে প্রোগ্রামটি পুনরায় চালু করেন, তখন গুগল ওয়ার্কস্পেস অ্যাড-অনটি ক্যাশে থেকে গুগল ডকে লিঙ্ক প্রিভিউ প্রদর্শন করে।

7. আপনি আপনার স্থানীয় পরিবেশে ngrok অ্যাপ্লিকেশন দ্বারা হোস্ট করা ওয়েব ইন্টারফেস থেকে HTTP অনুরোধ এবং প্রতিক্রিয়া লগগুলি পরীক্ষা করতে পারেন।

   

8. অ্যাপ্লিকেশনটির আচরণ পরিবর্তন করতে, index.js ফাইলের 51 লাইনে Case-এর পরিবর্তে Case Case: ব্যবহার করুন। ফাইলটি সেভ করলে, nodemon স্বয়ংক্রিয়ভাবে আপডেট করা সোর্স কোড দিয়ে অ্যাপ্লিকেশনটি রিলোড করে এবং Visual Studio Code ডিবাগ মোডে থেকে যায়।

   

9. This time, instead of clicking the link and waiting for a few seconds in a new Google Doc, you can select the last HTTP request logged on the web interface hosted by the ngrok application in your local environment and click Replay . Same as last time, your Google Workspace add-on doesn't reply because it's being actively debugged .

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 মডিউল থেকে অ্যাপ্লিকেশনটিকে env ভার্চুয়াল এনভায়রনমেন্টের 9000 পোর্টে ডিবাগ মোডে ট্রিগার করবে।

      {
          "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. main.py ফাইলে একটি ব্রেকপয়েন্ট যোগ করুন যা HTTP অনুরোধ প্রক্রিয়াকরণকে থামিয়ে দেবে, এবং পূর্বে যোগ করা Debug Watch কনফিগারেশন ব্যবহার করে অ্যাপ্লিকেশনটি চালানো ও ডিবাগ করা শুরু করুন । অ্যাপ্লিকেশনটি এখন চলছে এবং 9000 পোর্টে HTTP অনুরোধের জন্য অপেক্ষা করছে।

      

2. আপনার স্থানীয় পরিবেশে ngrok অ্যাপ্লিকেশনটি চালু করুন:

   ngrok http --domain=NGROK_STATIC_DOMAIN 9000

   NGROK_STATIC_DOMAIN জায়গায় আপনার ngrok অ্যাকাউন্টের স্ট্যাটিক ডোমেইনটি বসান। এখন থেকে সমস্ত অনুরোধ আপনার লোকাল এনভায়রনমেন্ট এবং অ্যাপ্লিকেশন দ্বারা ব্যবহৃত পোর্টে রিডাইরেক্ট করা হবে।

   

3. ngrok অ্যাপ্লিকেশনটি আপনার লোকালহোস্টে একটি ওয়েব ইন্টারফেসও চালু করে। ব্রাউজারে এটি খুলে সমস্ত কার্যকলাপ পর্যবেক্ষণ করুন।

   

4. একটি টেস্টার অ্যাকাউন্ট ব্যবহার করে নতুন একটি গুগল ডকে কেস ইউআরএল প্রিভিউ করার মাধ্যমে আপনার গুগল ওয়ার্কস্পেস অ্যাড-অনটি পরীক্ষা করুন:

   • একটি গুগল ডক তৈরি করুন।

     একটি গুগল ডক তৈরি করুন

   • নিম্নলিখিত লিঙ্কটি টাইপ করুন এবং enter চাপুন:

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

   • লিঙ্কটিতে ক্লিক করুন।

5. আপনার স্থানীয় পরিবেশে থাকা Visual Studio Code আপনি দেখতে পাবেন যে, সেট করা ব্রেকপয়েন্টটিতে প্রোগ্রামটি থেমে আছে।

   

6. গুগল ওয়ার্কস্পেস অ্যাড-অনের টাইম আউট হওয়ার আগে আপনি যখন Visual Studio Code ডিবাগার থেকে প্রোগ্রামটি পুনরায় চালু করেন, তখন গুগল ওয়ার্কস্পেস অ্যাড-অনটি ক্যাশে থেকে গুগল ডকে লিঙ্ক প্রিভিউ প্রদর্শন করে।

7. আপনি আপনার স্থানীয় পরিবেশে ngrok অ্যাপ্লিকেশন দ্বারা হোস্ট করা ওয়েব ইন্টারফেস থেকে HTTP অনুরোধ এবং প্রতিক্রিয়া লগগুলি পরীক্ষা করতে পারেন।

   

8. অ্যাপ্লিকেশনটির আচরণ পরিবর্তন করতে, main.py ফাইলের 56 লাইনে Case-এর পরিবর্তে Case Case: ব্যবহার করুন। ফাইলটি সেভ করলে, Visual Studio Code স্বয়ংক্রিয়ভাবে আপডেট করা সোর্স কোড দিয়ে অ্যাপ্লিকেশনটি পুনরায় লোড করে এবং ডিবাগ মোডে থেকে যায়।

   

9. এবার, লিঙ্কে ক্লিক করে একটি নতুন গুগল ডকে কয়েক সেকেন্ড অপেক্ষা করার পরিবর্তে, আপনি আপনার লোকাল এনভায়রনমেন্টে ngrok অ্যাপ্লিকেশন দ্বারা হোস্ট করা ওয়েব ইন্টারফেসে লগ করা সর্বশেষ HTTP রিকোয়েস্টটি সিলেক্ট করে Replay ) ক্লিক করতে পারেন। আগের বারের মতোই, আপনার গুগল ওয়ার্কস্পেস অ্যাড-অনটি কোনো উত্তর দেবে না, কারণ এটি সক্রিয়ভাবে ডিবাগ করা হচ্ছে।

10. যখন আপনি Visual Studio Code ডিবাগার থেকে প্রোগ্রামটি পুনরায় চালু করেন, তখন আপনার স্থানীয় পরিবেশে থাকা ngrok অ্যাপ্লিকেশনের ওয়েব ইন্টারফেস থেকে দেখতে পাবেন যে, অ্যাপ্লিকেশনটি প্রিভিউ কার্ডের আপডেট করা সংস্করণসহ একটি প্রতিক্রিয়া তৈরি করছে।

জাভা

1. আপনার স্থানীয় পরিবেশে ইনস্টল করা Visual Studio Code IDE থেকে নিম্নলিখিতগুলি করুন:

   1. একটি নতুন উইন্ডোতে add-ons-samples/java/3p-resources ফোল্ডারটি খুলুন।

   2. pom.xml ফাইলে Cloud Functions Framework-এর বিল্ড প্লাগইন function-maven-plugin যোগ করে Maven প্রজেক্টটি কনফিগার করুন, যাতে CreateLinkPreview স্থানীয়ভাবে 9000 পোর্টে পোর্টে রান করে।

      ...
      <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. CreateLinkPreview.java ফাইলে একটি ব্রেকপয়েন্ট যোগ করুন যা HTTP অনুরোধ প্রক্রিয়াকরণকে থামিয়ে দেবে, এবং পূর্বে যোগ করা Remote Debug Watch কনফিগারেশন ব্যবহার করে অ্যাটাচ ও ডিবাগিং শুরু করুন । অ্যাপ্লিকেশনটি এখন চলছে এবং 9000 পোর্টে HTTP অনুরোধের জন্য অপেক্ষা করছে।

      

2. আপনার স্থানীয় পরিবেশে ngrok অ্যাপ্লিকেশনটি চালু করুন:

   ngrok http --domain=NGROK_STATIC_DOMAIN 9000

   NGROK_STATIC_DOMAIN জায়গায় আপনার ngrok অ্যাকাউন্টের স্ট্যাটিক ডোমেইনটি বসান। এখন থেকে সমস্ত অনুরোধ আপনার লোকাল এনভায়রনমেন্ট এবং অ্যাপ্লিকেশন দ্বারা ব্যবহৃত পোর্টে রিডাইরেক্ট করা হবে।

   

3. ngrok অ্যাপ্লিকেশনটি আপনার লোকালহোস্টে একটি ওয়েব ইন্টারফেসও চালু করে। ব্রাউজারে এটি খুলে সমস্ত কার্যকলাপ পর্যবেক্ষণ করুন।

   

4. একটি টেস্টার অ্যাকাউন্ট ব্যবহার করে নতুন একটি গুগল ডকে কেস ইউআরএল প্রিভিউ করার মাধ্যমে আপনার গুগল ওয়ার্কস্পেস অ্যাড-অনটি পরীক্ষা করুন:

   • একটি গুগল ডক তৈরি করুন।

     একটি গুগল ডক তৈরি করুন

   • নিম্নলিখিত লিঙ্কটি টাইপ করুন এবং enter চাপুন:

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

   • লিঙ্কটিতে ক্লিক করুন।

5. আপনার স্থানীয় পরিবেশে থাকা Visual Studio Code আপনি দেখতে পাবেন যে, সেট করা ব্রেকপয়েন্টটিতে প্রোগ্রামটি থেমে আছে।

   

6. গুগল ওয়ার্কস্পেস অ্যাড-অনের টাইম আউট হওয়ার আগে আপনি যখন Visual Studio Code ডিবাগার থেকে প্রোগ্রামটি পুনরায় চালু করেন, তখন গুগল ওয়ার্কস্পেস অ্যাড-অনটি ক্যাশে থেকে গুগল ডকে লিঙ্ক প্রিভিউ প্রদর্শন করে।

7. আপনি আপনার স্থানীয় পরিবেশে ngrok অ্যাপ্লিকেশন দ্বারা হোস্ট করা ওয়েব ইন্টারফেস থেকে HTTP অনুরোধ এবং প্রতিক্রিয়া লগগুলি পরীক্ষা করতে পারেন।

   

8. অ্যাপ্লিকেশনটির আচরণ পরিবর্তন করতে, CreateLinkPreview.java ফাইলের 78 লাইনে Case-এর পরিবর্তে Case Case: ব্যবহার করুন, mvnDebug প্রসেসটি রিস্টার্ট করুন, এবং ডিবাগিং পুনরায় অ্যাটাচ ও রিস্টার্ট করার জন্য Remote Debug Watch রিলঞ্চ করুন।

9. এবার, লিঙ্কে ক্লিক করে একটি নতুন গুগল ডকে কয়েক সেকেন্ড অপেক্ষা করার পরিবর্তে, আপনি আপনার লোকাল এনভায়রনমেন্টে ngrok অ্যাপ্লিকেশন দ্বারা হোস্ট করা ওয়েব ইন্টারফেসে লগ করা সর্বশেষ HTTP রিকোয়েস্টটি সিলেক্ট করে Replay ) ক্লিক করতে পারেন। আগের বারের মতোই, আপনার গুগল ওয়ার্কস্পেস অ্যাড-অনটি কোনো উত্তর দেবে না, কারণ এটি সক্রিয়ভাবে ডিবাগ করা হচ্ছে।

10. যখন আপনি Visual Studio Code ডিবাগার থেকে প্রোগ্রামটি পুনরায় চালু করেন, তখন আপনার স্থানীয় পরিবেশে থাকা ngrok অ্যাপ্লিকেশনের ওয়েব ইন্টারফেস থেকে দেখতে পাবেন যে, অ্যাপ্লিকেশনটি প্রিভিউ কার্ডের আপডেট করা সংস্করণসহ একটি প্রতিক্রিয়া তৈরি করছে।