Gỡ lỗi ứng dụng Google Chat

Node.js

Python

Java

Node.js

• Phiên bản mới nhất của node và npm đã được cài đặt trong môi trường cục bộ.

• Phiên bản mới nhất của nodemon đã cài đặt trong môi trường cục bộ của bạn, được dùng cho mục đích tự động tải lại:

  npm install -g nodemon

• Ứng dụng Chat HTTP được định cấu hình để gửi tin nhắn. Bạn có thể làm theo các phần Điều kiện tiên quyết, Thiết lập môi trường và Xuất bản ứng dụng lên Google Chat trong Hướng dẫn bắt đầu nhanh. Điểm khác biệt duy nhất là bạn cần đặt App name (Tên ứng dụng) thành Debug App và HTTP endpoint URL (URL điểm cuối HTTP) thành bất kỳ giá trị nào như http://example.com.

• Một IDE được thiết lập trong môi trường cục bộ của bạn có thể gỡ lỗi. Chúng tôi sử dụng IDE Visual Studio Code và các tính năng gỡ lỗi mặc định của IDE này trong hướng dẫn này để minh hoạ.

• Git được cài đặt trong môi trường cục bộ của bạn.

• Tài khoản ngrok.

Python

• Phiên bản mới nhất của python3 được cài đặt trong môi trường cục bộ của bạn.
• Phiên bản mới nhất của pip và virtualenv được cài đặt trong môi trường cục bộ, các phiên bản này được dùng để quản lý các gói Python và môi trường ảo tương ứng.
• Ứng dụng Chat HTTP được định cấu hình để gửi tin nhắn. Bạn có thể làm theo các phần Điều kiện tiên quyết, Thiết lập môi trường và Xuất bản ứng dụng lên Google Chat trong Hướng dẫn nhanh. Điểm khác biệt duy nhất là bạn cần đặt App name (Tên ứng dụng) thành Debug App và HTTP endpoint URL (URL điểm cuối HTTP) thành bất kỳ giá trị nào như http://example.com.
• Một IDE được thiết lập trong môi trường cục bộ của bạn có thể gỡ lỗi. Chúng tôi sử dụng IDE Visual Studio Code và các tính năng gỡ lỗi mặc định của IDE này trong hướng dẫn này để minh hoạ.
• Git đã cài đặt trong môi trường cục bộ của bạn.
• Tài khoản ngrok.
• Phiên bản mới nhất của gcloud đã được cài đặt và được khởi chạy trong môi trường cục bộ.

Java

• Phiên bản ổn định mới nhất của Java SE 11's JDK đã cài đặt trong môi trường cục bộ.
• Phiên bản mới nhất của Apache Maven đã cài đặt trong môi trường cục bộ của bạn, dùng để quản lý các dự án Java.
• Một ứng dụng HTTP Chat được định cấu hình để nhắn tin. Bạn có thể làm theo các phần Điều kiện tiên quyết, Thiết lập môi trường và Xuất bản ứng dụng lên Google Chat trong Hướng dẫn bắt đầu nhanh. Điểm khác biệt duy nhất là bạn cần đặt Tên ứng dụng thành Debug App và URL điểm cuối HTTP thành bất kỳ giá trị nào như http://example.com.
• Một IDE được thiết lập trong môi trường cục bộ của bạn có thể gỡ lỗi. Chúng tôi sử dụng Visual Studio Code IDE và các tính năng gỡ lỗi mặc định trong hướng dẫn này nhằm mục đích minh hoạ.
• Git đã cài đặt trong môi trường cục bộ của bạn.
• Tài khoản ngrok.
• Phiên bản mới nhất của gcloud đã được cài đặt và được khởi chạy trong môi trường cục bộ.

Node.js

1. Sao chép kho lưu trữ googleworkspace/google-chat-samples từ GitHub sang môi trường cục bộ. Kho lưu trữ này chứa mã của ứng dụng cần thực thi:

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

2. Trên IDE Visual Studio Code được cài đặt trong môi trường cục bộ, hãy làm như sau:

   1. Trong một cửa sổ mới, hãy mở thư mục google-chat-samples/node/basic-app.

   2. Định cấu hình ứng dụng để tự động tải lại gỡ lỗi bằng cách thêm 2 tập lệnh vào tệp package.json:

      {
          ...
          "scripts": {
              ...
              "debug": "node --inspect index.js",
              "debug-watch": "nodemon --watch ./ --exec npm run debug"
          }
          ...
      }
      

   3. Trong thư mục gốc, hãy cài đặt ứng dụng:

      npm install

   4. Tạo và định cấu hình một lần chạy có tên Debug Watch để kích hoạt tập lệnh debug-watch bằng cách tạo tệp .vscode/launch.json trong thư mục gốc:

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

   5. Thêm một điểm ngắt tạm dừng quá trình xử lý yêu cầu HTTP trong tệp index.js và bắt đầu chạy và gỡ lỗi bằng cấu hình Debug Watch đã thêm trước đó. Ứng dụng hiện đang chạy và theo dõi các yêu cầu HTTP trên cổng 9000.

      

      Hình 3. Ứng dụng đang chạy và lắng nghe các yêu cầu HTTP trên cổng 9000.

3. Chạy ứng dụng ngrok trong môi trường cục bộ:

   ngrok http --domain=NGROK_STATIC_DOMAIN 9000

   Thay thế NGROK_STATIC_DOMAIN bằng miền tĩnh trong tài khoản ngrok của bạn. Tất cả các yêu cầu hiện được chuyển hướng đến môi trường cục bộ và cổng mà ứng dụng sử dụng.

   

   Hình 4. Cổng kết nối có máy chủ ngrok đang chạy và chuyển hướng.

4. Giao diện web cũng được khởi động trên máy chủ cục bộ của bạn bằng ứng dụng ngrok, bạn có thể theo dõi tất cả hoạt động bằng cách mở giao diện web đó trong trình duyệt.

   

   Hình 5. Giao diện web do ứng dụng ngrok lưu trữ không hiển thị yêu cầu HTTP nào.

5. Kiểm thử ứng dụng Chat bằng cách gửi tin nhắn trực tiếp:

   • Mở Google Chat.

     Chuyển đến Google Chat

   • Nhấp vào biểu tượng Cuộc trò chuyện mới add.

   • Trong hộp thoại, hãy nhập tên của ứng dụng Chat.

   • Trong kết quả tìm kiếm, hãy tìm ứng dụng Chat, nhấp vào Thêm > Chat.

   • Trong không gian tin nhắn trực tiếp, hãy nhập Hello rồi nhấn enter. Ứng dụng Chat không trả lời vì đang được gỡ lỗi tích cực.

6. Trong Visual Studio Code của môi trường cục bộ, bạn có thể thấy quá trình thực thi bị tạm dừng tại điểm ngắt đã đặt.

   

   Hình 6. Quá trình thực thi bị tạm dừng tại điểm ngắt đã đặt.

7. Khi bạn tiếp tục thực thi từ trình gỡ lỗi của Visual Studio Code trước khi Google Chat hết thời gian chờ, ứng dụng Chat sẽ trả lời Your message : Hello.

8. Bạn có thể kiểm tra nhật ký yêu cầu và phản hồi HTTP từ giao diện web do ứng dụng ngrok lưu trữ trong môi trường cục bộ.

   

   Hình 7. Yêu cầu HTTP từ giao diện web do ứng dụng ngrok lưu trữ.

9. Để thay đổi hành vi của ứng dụng, hãy thay thế Your message bằng Here was your message cùng dòng 35 của index.json. Khi bạn lưu tệp, nodemon sẽ tự động tải lại ứng dụng bằng mã nguồn đã cập nhật và Visual Studio Code vẫn ở chế độ gỡ lỗi.

   

   Hình 8. Ứng dụng đang chạy và nghe các yêu cầu HTTP trên cổng 9000 với thay đổi về mã được tải.

10. Lần này, thay vì gửi thông báo thứ hai Hello trong không gian, bạn có thể chọn yêu cầu HTTP gần đây nhất được ghi lại trên giao diện web do ứng dụng ngrok lưu trữ trong môi trường cục bộ của bạn rồi nhấp vào Replay. Tương tự như lần trước, ứng dụng Chat không trả lời vì đang được gỡ lỗi.

11. Khi tiếp tục quá trình thực thi từ trình gỡ lỗi của Visual Studio Code, bạn có thể thấy trên giao diện web do ứng dụng ngrok lưu trữ trong môi trường cục bộ, ứng dụng sẽ tạo phản hồi với phiên bản đã cập nhật của thông báo Here was your message : Hello.

Python

1. Thu thập thông tin xác thực người dùng mới để sử dụng cho Thông tin xác thực mặc định của ứng dụng:

   gcloud config set project PROJECT_ID
   gcloud auth application-default login

   Thay thế PROJECT_ID bằng mã dự án cho dự án Google Cloud của ứng dụng.

2. Sao chép kho lưu trữ googleworkspace/google-chat-samples từ GitHub vào môi trường cục bộ của bạn, kho lưu trữ này chứa mã ứng dụng:

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

3. Từ IDE Visual Studio Code đã cài đặt trong môi trường cục bộ, hãy làm như sau:

   1. Trong một cửa sổ mới, hãy mở thư mục google-chat-samples/python/avatar-app.

   2. Tạo một môi trường ảo mới cho Python env và kích hoạt môi trường đó:

      virtualenv env
      source env/bin/activate

   3. Cài đặt tất cả phần phụ thuộc dự án bằng pip trong môi trường ảo:

      pip install -r requirements.txt

   4. Tạo tệp .vscode/launch.json trong thư mục gốc và định cấu hình khởi chạy có tên Debug Watch để kích hoạt ứng dụng từ mô-đun functions-framework trên cổng 9000 ở chế độ gỡ lỗi trên môi trường ảo 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. Thêm một điểm ngắt tạm dừng quá trình xử lý yêu cầu HTTP trong tệp main.py và bắt đầu chạy và gỡ lỗi bằng cấu hình Debug Watch đã thêm trước đó. Ứng dụng hiện đang chạy và theo dõi các yêu cầu HTTP trên cổng 9000.

      

      Hình 3. Ứng dụng đang chạy và lắng nghe các yêu cầu HTTP trên cổng 9000.

4. Chạy ứng dụng ngrok trong môi trường cục bộ:

   ngrok http --domain=NGROK_STATIC_DOMAIN 9000

   Thay thế NGROK_STATIC_DOMAIN bằng miền tĩnh trong tài khoản ngrok của bạn. Tất cả các yêu cầu hiện được chuyển hướng đến môi trường cục bộ và cổng mà ứng dụng sử dụng.

   

   Hình 4. Cổng kết nối có máy chủ ngrok đang chạy và chuyển hướng.

5. Giao diện web cũng được khởi động trên máy chủ cục bộ của bạn bằng ứng dụng ngrok, bạn có thể theo dõi tất cả hoạt động bằng cách mở giao diện web đó trong trình duyệt.

   

   Hình 5. Giao diện web do ứng dụng ngrok lưu trữ không hiển thị yêu cầu HTTP nào.

6. Kiểm thử ứng dụng Chat bằng cách gửi tin nhắn trực tiếp:

   • Mở Google Chat.

     Chuyển đến Google Chat

   • Nhấp vào biểu tượng Cuộc trò chuyện mới add.

   • Trong hộp thoại, hãy nhập tên của ứng dụng Chat.

   • Trong kết quả tìm kiếm, hãy tìm ứng dụng Chat, nhấp vào Thêm > Chat.

   • Trong không gian tin nhắn trực tiếp, hãy nhập Hey! rồi nhấn enter. Ứng dụng Chat không trả lời vì đang được gỡ lỗi tích cực.

7. Trong Visual Studio Code trong môi trường cục bộ, bạn có thể thấy rằng quá trình thực thi bị tạm dừng tại điểm ngắt đã đặt.

   

   Hình 6. Quá trình thực thi bị tạm dừng tại điểm ngắt đã đặt.

8. Khi bạn tiếp tục thực thi từ trình gỡ lỗi của Visual Studio Code trước khi Google Chat hết thời gian chờ, ứng dụng Chat sẽ trả lời bằng tên và hình đại diện của bạn trong thư.

9. Bạn có thể kiểm tra nhật ký yêu cầu và phản hồi HTTP từ giao diện web do ứng dụng ngrok lưu trữ trong môi trường cục bộ.

   

   Hình 7. Yêu cầu HTTP từ giao diện web do ứng dụng ngrok lưu trữ.

10. Để thay đổi hành vi của ứng dụng, hãy thay thế Hello bằng Hey cùng dòng 51 của tệp main.py. Khi bạn lưu tệp, Visual Studio Code sẽ tự động tải lại ứng dụng bằng mã nguồn đã cập nhật và vẫn ở chế độ gỡ lỗi.

    

    Hình 8. Ứng dụng đang chạy và nghe các yêu cầu HTTP trên cổng 9000 với thay đổi về mã được tải.

11. Lần này, thay vì gửi thông báo thứ hai Hey! trong không gian, bạn có thể chọn yêu cầu HTTP gần đây nhất được ghi lại trên giao diện web do ứng dụng ngrok lưu trữ trong môi trường cục bộ của bạn rồi nhấp vào Replay. Giống như lần trước, ứng dụng Chat của bạn không trả lời vì đang được tích cực gỡ lỗi.

12. Khi tiếp tục quá trình thực thi từ trình gỡ lỗi của Visual Studio Code, bạn có thể thấy trên giao diện web do ứng dụng ngrok lưu trữ trong môi trường cục bộ, ứng dụng sẽ tạo phản hồi với phiên bản thông báo đã cập nhật.

Java

1. Thu thập thông tin xác thực người dùng mới để sử dụng cho Thông tin xác thực mặc định của ứng dụng:

   gcloud config set project PROJECT_ID
   gcloud auth application-default login

   Thay thế PROJECT_ID bằng mã dự án cho dự án Google Cloud của ứng dụng.

2. Sao chép kho lưu trữ googleworkspace/google-chat-samples từ GitHub trong môi trường cục bộ của bạn, kho lưu trữ này chứa mã xử lý ứng dụng:

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

3. Trên IDE Visual Studio Code được cài đặt trong môi trường cục bộ, hãy làm như sau:

   1. Trong một cửa sổ mới, hãy mở thư mục google-chat-samples/java/avatar-app.

   2. Định cấu hình dự án Maven để chạy ứng dụng App trên cổng 9000 cục bộ bằng cách thêm trình bổ trợ bản dựng Khung chức năng trên đám mây function-maven-plugin trong tệp 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. Giờ đây, bạn có thể chạy ứng dụng này trên máy tính ở chế độ gỡ lỗi:

      mvnDebug function:run
      Preparing to execute Maven in debug mode
      Listening for transport dt_socket at address: 8000

   4. Tạo tệp .vscode/launch.json trong thư mục gốc và định cấu hình một lần khởi chạy có tên Remote Debug Watch đính kèm vào ứng dụng đã khởi chạy trước đó bằng cổng 8000:

      {
          "version": "0.2.0",
          "configurations": [{
              "type": "java",
              "request": "attach",
              "name": "Remote Debug Watch",
              "projectName": "http-function",
              "hostName": "localhost",
              "port": 8000
          }]
      }
      

   5. Thêm một điểm ngắt tạm dừng quá trình xử lý yêu cầu HTTP trong tệp App.java và bắt đầu đính kèm và gỡ lỗi bằng cấu hình Remote Debug Watch đã thêm trước đó. Ứng dụng hiện đang chạy và theo dõi các yêu cầu HTTP trên cổng 9000.

      

      Hình 3. Ứng dụng đang chạy và lắng nghe các yêu cầu HTTP trên cổng 9000.

4. Chạy ứng dụng ngrok trong môi trường cục bộ:

   ngrok http --domain=NGROK_STATIC_DOMAIN 9000

   Thay thế NGROK_STATIC_DOMAIN bằng miền tĩnh trong tài khoản ngrok của bạn. Tất cả các yêu cầu hiện được chuyển hướng đến môi trường cục bộ và cổng mà ứng dụng sử dụng.

   

   Hình 4. Cổng kết nối có máy chủ ngrok đang chạy và chuyển hướng.

5. Giao diện web cũng được khởi động trên máy chủ cục bộ của bạn bằng ứng dụng ngrok, bạn có thể theo dõi tất cả hoạt động bằng cách mở giao diện web đó trong trình duyệt.

   

   Hình 5. Giao diện web do ứng dụng ngrok lưu trữ không hiển thị yêu cầu HTTP nào.

6. Kiểm thử ứng dụng Chat bằng cách gửi tin nhắn trực tiếp:

   • Mở Google Chat.

     Truy cập Google Chat

   • Nhấp vào biểu tượng Cuộc trò chuyện mới add.

   • Trong hộp thoại, hãy nhập tên của ứng dụng Chat.

   • Trong kết quả tìm kiếm, hãy tìm ứng dụng Chat, nhấp vào Thêm > Chat.

   • Trong không gian tin nhắn trực tiếp, hãy nhập Hey! rồi nhấn enter. Ứng dụng Chat của bạn không phản hồi vì đang được chủ động gỡ lỗi.

7. Trong Visual Studio Code trong môi trường cục bộ, bạn có thể thấy rằng quá trình thực thi bị tạm dừng tại điểm ngắt đã đặt.

   

   Hình 6. Quá trình thực thi bị tạm dừng tại điểm ngắt đã đặt.

8. Khi bạn tiếp tục thực thi từ trình gỡ lỗi của Visual Studio Code trước khi Google Chat hết thời gian chờ, ứng dụng Chat sẽ trả lời bằng tên và hình đại diện của bạn trong thư.

9. Bạn có thể kiểm tra nhật ký yêu cầu và phản hồi HTTP từ giao diện web do ứng dụng ngrok lưu trữ trong môi trường cục bộ.

   

   Hình 7. Yêu cầu HTTP từ giao diện web do ứng dụng ngrok lưu trữ.

10. Để thay đổi hành vi của ứng dụng, hãy thay thế Hello bằng Hey cùng dòng 55 của tệp App.java, khởi động lại quy trình mvnDebug và khởi chạy lại Remote Debug Watch để đính kèm lại và bắt đầu lại quá trình gỡ lỗi.

11. Lần này, thay vì gửi thông báo thứ hai Hey! trong không gian, bạn có thể chọn yêu cầu HTTP gần đây nhất được ghi lại trên giao diện web do ứng dụng ngrok lưu trữ trong môi trường cục bộ của bạn rồi nhấp vào Replay. Tương tự như lần trước, ứng dụng Chat không trả lời vì ứng dụng này đang được gỡ lỗi.

12. Khi tiếp tục thực thi từ trình gỡ lỗi của Visual Studio Code, bạn có thể thấy từ giao diện web do ứng dụng ngrok lưu trữ trong môi trường cục bộ rằng ứng dụng sẽ tạo một phản hồi với phiên bản cập nhật của thông báo.