Skip to content

鸿蒙版本的 PageSpy 使用教程

Blucas edited this page May 23, 2024 · 2 revisions

工作原理

部署

# 请注意镜像的 tag 是 feat-page-spy-harmony
docker pull ghcr.io/huolalatech/page-spy-web:feat-page-spy-harmony

docker run -dp 6752:6752 --name="pageSpy" --restart=always ghcr.io/huolalatech/page-spy-web:feat-page-spy-harmony

以上操作会在 6752 端口上启动 PageSpy 的服务,如果你是在本地运行上面的命令,可以在浏览器中打开 http://localhost:6752 查看。

此时 PageSpy 的调试端和服务端就准备完毕:

  • 调试端:开发者用来查看客户端运行信息;
  • 服务端:连接调试端和客户端,转发两者之间交互的消息;

接下来需要在鸿蒙项目中引入 SDK @huolala/page-spy-harmony

引入 SDK

SDK 主页:https://ohpm.openharmony.cn/#/cn/detail/@huolala%2Fpage-spy-harmony

  1. 在项目中安装 SDK

根据安装过程输出的日志确认安装的 SDK 是最新版本,当前版本:latest

ohpm install @huolala/page-spy-harmony@latest
  1. 复制以下代码(记得修改参数),初始化 SDK:
// entry/src/main/ets/Entry/EntryAbility.ts

import { PageSpy } from '@huolala/page-spy-harmony';
// 鸿蒙不支持包装 @ohos.net.http,所以查看网络请求依赖传入第三方包,目前 PageSpy 适配了 @ohos/axios
import axiosInstance from 'path/to/your/axios';

export default class EntryAbility extends UIAbility {
  onWindowStageCreate(windowStage: window.WindowStage) {
    new PageSpy({
      context: this.context,

      // PageSpy 服务的 host
      // 假设服务部署在 https://example.com 则填写 "example.com"
      api: '<your-pagespy-server-host>',

      // PageSpy 部署的服务是否 https 访问,默认为 true
      enableSSL: true,

      // 项目代码中 @ohos/axios 的实例或者类,用于查看网络请求信息
      axios: axiosInstance,
      
      project: "<填写项目名称, 可以搜索>",
      title: "<自定义内容,可以搜索>"
    });
  }
}
  1. 引入成功后重新运行项目,在 Log 面板中会看到 PageSpy 打印的信息
  1. 前往调试端筛选出待调试的终端,左边的表单可以过滤搜索
  1. 点击 “调试” 按钮,即可看到 APP 的运行信息。

技术支持群