# 调试周期性预加载

prefetch_test_tool是为周期性预加载功能提供的一种命令行工具，开发者集成预加载服务后，使用该工具可以更方便、更高效地进行周期性预加载功能测试和调试，提高开发效率，同时确保预加载服务的平稳运行。

当前命令行工具支持的命令集如下：

|命令名|描述|
|:----------------|:---------------|
|[getcache](#调试命令)|提供获取周期性预加载数据的能力。|

## 调试准备

使用命令行工具调试周期性预加载之前，需要完成以下准备工作：

* 您已在开发者联盟官网注册账号并通过实名认证，详情请参见[账号注册认证](https://developer.huawei.com/consumer/cn/doc/start/registration-and-verification-0000001053628148)。

* 您已在本地安装DevEco Studio 5.0.3 Release及以上版本。

* 手机/平板终端设备的ROM版本已升级至HarmonyOS 6.0.0 Beta5及以上版本。

* 设置HAP包的"Build Mode"为"debug"，且已[申请调试证书](https://developer.huawei.com/consumer/cn/doc/app/agc-help-debug-cert-0000002283256797)。

  ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/32/v3/PexEkPT6RBS96IJkxyXARg/zh-cn_image_0000002809050883.png?HW-CC-KV=V1&HW-CC-Date=20261102T125431Z&HW-CC-Expire=31536000000&HW-CC-Sign=3711276AA4EC9E073A02C5E336C0DE4E59D3E394DFA8BACD8557FB6BA41F714B)

## 切换shell环境

prefetch_test_tool命令行工具基于hdc shell调试，需要切换到hdc shell命令环境。

1. PC连接调试设备。连接方式请根据实际情况选择，详情请参见[设备连接管理](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/hdc#设备连接管理)。

2. 打开DevEco Studio，菜单栏选择"View > Tool Windows > Terminal"进入Terminal窗口。

   ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/22/v3/D9fzLY6zReSDVPliq1loWA/zh-cn_image_0000002779851318.png?HW-CC-KV=V1&HW-CC-Date=20261102T125431Z&HW-CC-Expire=31536000000&HW-CC-Sign=9F5F2FADAEBC0FFF81062C4A1B09FD0DB0373A155B7C71D63D484FBF8F218462)
3. 输入hdc shell，切换到hdc shell命令环境。切换过程中如果出现报错，请参见[常见问题](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/hdc#常见问题)排查解决。

   ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/26/v3/V8rKVAjiRFm6qh1i7SnYcQ/zh-cn_image_0000002779691350.png?HW-CC-KV=V1&HW-CC-Date=20261102T125431Z&HW-CC-Expire=31536000000&HW-CC-Sign=8D9E3B28EB330D8C1263EED0385EC5674126C0436272AB248AD7736E8233B490)

## 调试命令

命令名"getcache"，提供获取周期性预加载数据的能力。

### 命令格式

```shell
cf_prefetch getcache -m <bundlename>
```

### 命令选项

|命令选项|必填(M)/选填(O)|描述|示例|
|:---|:----------|:------------------------------------------------|:---------------------------------------------|
|-m|M|应用包名。此处的包名需要与您在AppGallery Connect中创建应用时配置的包名保持一致。|cf_prefetch getcache -m com.huawei.hms.xs.test|

## 调用示例

### 正常场景

* 输入cf_prefetch help，获取命令行工具的使用说明。

  ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/7b/v3/nCY2jtg9QVutT9YVYe2HNw/zh-cn_image_0000002809010971.png?HW-CC-KV=V1&HW-CC-Date=20261102T125431Z&HW-CC-Expire=31536000000&HW-CC-Sign=7EE2D579F775F89A51A90EDBDAB83154D9A76541892C40909DCBA09333EF48D5)
* 输入cf_prefetch getcache -h，获取getcache命令支持的参数信息。

  ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/53/v3/_yXODNDTR5m8M1l1XqFmPA/zh-cn_image_0000002809050885.png?HW-CC-KV=V1&HW-CC-Date=20261102T125431Z&HW-CC-Expire=31536000000&HW-CC-Sign=A2A4BDC221405DEA6BAD318194F22E93C819BF4B3DA3CC6792A7953A25057866)
* 输入cf_prefetch getcache -m <bundlename>，立即向云侧请求获取一次周期性预加载数据。

  ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/32/v3/pCBC1aloQCurihbJSA_V1A/zh-cn_image_0000002779851320.png?HW-CC-KV=V1&HW-CC-Date=20261102T125431Z&HW-CC-Expire=31536000000&HW-CC-Sign=3DB9D3706C50C41DFE12DF327388395C9335680C87918BF52542E1D4B231B4AD)
  > 说明
  >
  > 如果返回结果中的"fetch data timestamp"不是当前时间，则表示仍为上一次成功拉取数据的时间戳，此次数据拉取失败，请参见[异常场景](#异常场景)排查。

### 异常场景

* 链路不通，例如无网络情况；或周期性预加载配置不正确。

  ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/a3/v3/MLyS-3g1RyOcjk8RaHuD9g/zh-cn_image_0000002779691352.png?HW-CC-KV=V1&HW-CC-Date=20261102T125431Z&HW-CC-Expire=31536000000&HW-CC-Sign=F3213F177A0A0C91C9139A70A62ED06DC19E0AF9603C42020E5030A781BA9B5F)
* 命令行工具内部错误。

  ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/1d/v3/027bpjtgQCmZiGqUC_yegA/zh-cn_image_0000002809010973.png?HW-CC-KV=V1&HW-CC-Date=20261102T125431Z&HW-CC-Expire=31536000000&HW-CC-Sign=9DBA30233AB195BB8787898ECB62E88C2E3CCD757E50A08ADD723FCF205FA338)
* HAP包非debug调试模式。

  ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/e6/v3/PPc8cYYxSy6nv9buHIfDhQ/zh-cn_image_0000002809050887.png?HW-CC-KV=V1&HW-CC-Date=20261102T125431Z&HW-CC-Expire=31536000000&HW-CC-Sign=76DBC4F5637CC8C63BA63586F735AA11400423DC00CB91F053FCFEA29B844978)
* 应用包名输入错误。

  ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/75/v3/8zVAcqLRRv63raLA-An_-w/zh-cn_image_0000002779851322.png?HW-CC-KV=V1&HW-CC-Date=20261102T125431Z&HW-CC-Expire=31536000000&HW-CC-Sign=2F8BBABC9973C189A65DC3DF6B60AC22AA2C36E7AAA41714E138FCA45B91CD47)