目录

HarmonyOS元服务Charles抓包调试配置

Q:HarmonyOS元服务如何使用Charles抓包便于调试?

A:

本方案适用于在Windows电脑上运行Charles抓取元服务的网络包。

配置环境时,一定要在电脑Charles弹出的窗口选择Allow,才能够跟手机连接。

下载证书时,链接需加上http://chls.pro/ssl,下载完需要另存到公共目录Download等。

上传下载@ohos.request模块接口均不支持Charles抓包。

上传下载模块不支持Charles、Fiddler等代理抓包工具,如需抓取上传下载的报文,可改用Network Kit(@ohos.net.http)或Remote Communication Kit(rcp)发起请求,或使用设备的网络报文分析功能配合Wireshark抓取报文。

使用Charles抓包具体步骤如下:

  1. 将手机与Windows电脑连接在同一局域网下,手机连接WiFi时,点击代理设置(手动),设置代理IP,端口为Charles监听的端口。Charles的本机IP 常与Windows电脑的IP相同,可在Charles的Help--->Local IP Address中查看;监听端口默认为8888,可在Proxy--->Proxy Settings中查看和修改。Wi-Fi代理的完整入口为:设置--->WLAN--->点击(或长按)已连接的网络--->修改网络--->显示高级选项--->代理--->手动。
  2. 设置代理,操作步骤:
    1. 点击 Proxy--->SSL Proxy Settings--->在Include添加 *:* 和 *:443
    2. 点击 Proxy--->Proxy Settings--->勾选Enable transparent HTTP proxying
  3. Windows电脑端打开手机端证书下载入口,点击 Help--->SSL Proxying--->Install Charles Root Certificate on a Mobile Device or Remote Browser,在弹出的提示框中查看手机端下载证书的网址(http://chls.pro/ssl)。
  4. 导入系统根证书至手机:
    1. 通过手机浏览器下载Charles提供的网址下载证书,在浏览器下载之后要另存到下载目录
    2. 通过 hdc 启动证书安装器(需设备已开启开发者模式与 USB 调试,PC 已安装 hdc 并通过 USB 连接设备):

      hdc shell aa start -a MainAbility -b com.ohos.certmanager

      如hdc不可用,也可在手机上通过设置--->隐私和安全--->高级--->证书与凭据--->从存储设备安装进入安装入口。安装用户CA证书时需对设备用户身份进行认证。

    3. 选择从存储设备安装,证书类型选择「CA证书」,再选择步骤 1) 中另存到下载目录的pem证书文件。
  5. 安装Charles证书到Windows电脑系统可信目录,操作步骤:

    点击 Help--->SSL Proxying--->Install Charles Root Certificate--->安装证书--->选择证书存储路径为:受信任的根证书颁发机构

  6. 打开Charles,开始抓包。

若已按上述步骤操作仍抓不到HTTPS明文,可检查应用是否在src/main/resources/base/profile/network_config.json中将trust-global-user-ca或trust-current-user-ca配置为false。配置为false时应用不信任用户安装的CA证书,Charles无法解密其HTTPS报文;正式发布版本建议保持不信任配置,抓包请在调测版本上进行。