规则体检
====

规则体检支持兼容性、性能、功耗等多种测试类型，开发者可自主选择不同的规则进行测试。

#### 前置操作

1.  通过以下任意一种方式，打开AppAnalyzer。
    *   单击菜单栏**Tools >** **AppAnalyzer**，打开AppAnalyzer页面。
    *   在编辑窗口右侧的工具栏，点击**AppAnalyzer**或![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/e9/v3/wmW36i6gTAiA1qEI-VzIoA/zh-cn_image_0000002624994121.png?HW-CC-KV=V1&HW-CC-Date=20260612T073903Z&HW-CC-Expire=86400&HW-CC-Sign=0DE2860C026AB88C5C1C29C60CBF58CC795945FFD6344ECCD88B8AB2FBD34B4B)，打开AppAnalyzer页面。
2.  连接设备或启动模拟器，并对应用进行[签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing)。
    *   真机：参考[使用本地真机运行应用](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-run-device)连接真机。
    *   模拟器：在AppAnalyzer首页创建或启动模拟器，具体请参考[管理模拟器](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-emulator-management)。
3.  如果使用DevEco Studio 6.0.1版本，未配置Python环境时，请根据界面提示，下载Python及三方库。或者点击AppAnalyzer底部**Python 配置**按钮进行配置。
4.  如果使用DevEco Studio 6.0.0 Beta2之前的版本，需要先编译生成HAP或HSP。使用Beta2及以上的版本，无需提前编译。

#### 进行体检

#### \[h2\]DevEco Studio 6.0.1 Beta1及以上版本

1.  点击右上角![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/61/v3/o49ZqF9BRaKkArUfP-FEgw/zh-cn_image_0000002594474754.png?HW-CC-KV=V1&HW-CC-Date=20260612T073903Z&HW-CC-Expire=86400&HW-CC-Sign=372201924B7B9B7BF93093F661B52ABBC6750B67B5A0BDB9BD5576CC43D93C30)图标选择Product、Target和构建模式，点击**Apply**后，在AppAnalyzer的首页中可查看对应的编译产物和构建模式。关于Product、Target、构建模式的介绍请参考[配置多目标产物](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-customized-multi-targets-and-products-guides)和[指定构建模式](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-hvigor-compilation-options-customizing-guide#section192461528194916)。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/4/v3/3RxQED7YQbeTBBMmqJ1FtQ/zh-cn_image_0000002625074251.png?HW-CC-KV=V1&HW-CC-Date=20260612T073903Z&HW-CC-Expire=86400&HW-CC-Sign=A86D181884B707C531F334CBEFE8FDB60A54A68EFE5962A4DF5CD09D05612049)
    
2.  在**AppAnalyzer**页面，选择**规则体检**，选择预置的体检卡片，或根据需要自定义卡片。
    
    *   点击预置的体检卡片开始体检，如需查看卡片包含的体检规则，请点击卡片右上角的![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/c5/v3/13Uu0m5xSmGz2EP21lEpvQ/zh-cn_image_0000002594634680.png?HW-CC-KV=V1&HW-CC-Date=20260612T073903Z&HW-CC-Expire=86400&HW-CC-Sign=701E9F7232E646C2EFC5AFF8118274757FCBE6D498F967700DC004A629D6C6DF)按钮，规则详情请参考[规则总览](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-app-analyzer-all-rules)。
    *   如果需要自定义体检规则，点击**+**，选择自动/手动测试和体检规则，部分规则可修改单次录制时长，请根据界面提示进行修改。
        
        如果仅选择稳定性规则，从DevEco Studio 6.0.2 Beta1版本开始，支持录制回放遍历模式，开发者先手动录制在设备上的操作，录制结束后AppAnalyzer会自动保存录制文件，选择录制文件开始体检后，AppAnalyzer会按照设置的回放时长，自动循环执行录制的操作，体检结束后可[查看报告](#li22241112508)。
        
        ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/fb/v3/sryXIvzvQrirPt7PZxkVsw/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073903Z&HW-CC-Expire=86400&HW-CC-Sign=3A4B5E2900EE76C6196B5A87973F5DAC73A20BE4692CB6B40B1B70B1E71535FE)
        
        *   请确保录制过程可循环，例如从B页面开始录制，最后结束录制时要停留在B页面。
        *   录制回放功能仅支持直板机真机。
        
        ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/26/v3/6AiW4ps4Qzm7V2UWQBSNnA/zh-cn_image_0000002625074257.png?HW-CC-KV=V1&HW-CC-Date=20260612T073903Z&HW-CC-Expire=86400&HW-CC-Sign=1993888EF74F8EB27C0F407269776DD27031D1F30265F579AC2E13CA4BCF639B)
        
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/7f/v3/apdsMwTmTwSv1BXEIaCeww/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073903Z&HW-CC-Expire=86400&HW-CC-Sign=D1FD5E65048C87013721D2D610BACB8EE577740C254D539F77D053E84662984E)
    
    以下体检规则不支持在编译模式为release下运行，请把编译模式切换到debug再重新检测：组件树节点数目过大、执行函数耗时过长、渲染界面耗时过长、ForEach中item数量过大。
    
3.  开始体检后，请等待AppAnalyzer完成构建、签名、安装等操作。如果本次体检依赖Python三方库并且本地未安装，AppAnalyzer会同步下载安装三方库。在测试过程中，请保持连接的设备为解锁亮屏状态。
    *   如果是自动测试，根据界面提示，登录应用账号后点击继续按钮![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/b4/v3/2oynbjYSQgC2FQSuiiusAQ/zh-cn_image_0000002624994117.png?HW-CC-KV=V1&HW-CC-Date=20260612T073903Z&HW-CC-Expire=86400&HW-CC-Sign=82B1B5223EDDB4BD8E9E3CD5B2FE89FEAC5D1E4C64D4FCA46023622B78F3D9DE)，继续测试；或者无需登录账号，直接点击![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/29/v3/JpjREqnMQrKVUFnxH6qlgg/zh-cn_image_0000002624994107.png?HW-CC-KV=V1&HW-CC-Date=20260612T073903Z&HW-CC-Expire=86400&HW-CC-Sign=877B825402D90434D690838F5757454EC411CFD9780D6E855488CDD5E1E731AF)按钮继续测试。
    *   如果是手动测试，根据界面提示，点击开始按钮![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/ab/v3/8ZcnmFXsQv-h5xCupHJhhg/zh-cn_image_0000002624994115.png?HW-CC-KV=V1&HW-CC-Date=20260612T073903Z&HW-CC-Expire=86400&HW-CC-Sign=A781FA631AE48F181FB4CC8EE73E7AFB746C3246EE5E2419C0BC5C3199E6D0F8)开始录制，并手动遍历应用/元服务的功能。如果在录制时间范围内未遍历完成，可继续点击![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/c5/v3/mKM1QVimQe6a7m1fYEo5Ig/zh-cn_image_0000002594634676.png?HW-CC-KV=V1&HW-CC-Date=20260612T073903Z&HW-CC-Expire=86400&HW-CC-Sign=343CB079FE77F132156C56F0A2D4A67795FAC1EEE9823054B1CFA9E35024AA7B)按钮，进行多次遍历，遍历完成后点击结束按钮![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/74/v3/Pz6Jhg6kSmmRUEfyNzS66g/zh-cn_image_0000002625074259.png?HW-CC-KV=V1&HW-CC-Date=20260612T073903Z&HW-CC-Expire=86400&HW-CC-Sign=494F8135652D4B3CD708652EF521F9E349A80BB89698DBD6B19DC1DFBE89A29E)。
4.  查看测试报告，包含以下内容。
    
    *   **源文件、调优文件（包含trace文件和调用栈文件）或snapshot文件、时间戳等**：点击源文件可跳转到问题源码，点击调优文件或snapshot文件支持直接拉起性能分析工具Profiler并导入性能检测的问题数据进行调优分析，点击时间戳可以打开Profiler并定位到问题发生的时间范围。
    *   **分析文档**：点击链接可跳转至官网文档，参考文档对检测出来的问题进行分析。
    *   **优化建议**：针对检测出来的问题，给出对应的最佳实践，点击链接可跳转至官网文档。
    
    从DevEco Studio 6.0.2 Beta1版本开始，如果在体检中遇到问题，可点击报告右上角的**User Feedback**向我们反馈。
    
    从DevEco Studio 6.1.0 Release版本开始，支持导出报告，以实现报告的共享，具体可查看[导出报告](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-app-analyzer-history-reports#section78017171818)。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/7/v3/b26X376rSIm5YDQm3XQwBg/zh-cn_image_0000002625074263.png?HW-CC-KV=V1&HW-CC-Date=20260612T073903Z&HW-CC-Expire=86400&HW-CC-Sign=133E91205521F2292C804B2A9C10F602902ECC19910C7B688A81A723FDFABB14)
    

#### \[h2\]DevEco Studio 6.0.1 Beta1以下版本

1.  如果使用DevEco Studio 6.0.0 Beta2及以上的版本，支持在体检过程中自动编译构建打包。点击右上角![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/ed/v3/KKO_UWE2SYaEi5kSs6gjgQ/zh-cn_image_0000002624994119.png?HW-CC-KV=V1&HW-CC-Date=20260612T073903Z&HW-CC-Expire=86400&HW-CC-Sign=3930F2E86A8E9C1CBB92D87854B525BABED87070B0D9104A3E1BBFC8D243B830)图标选择Product、Target和构建模式，关于Product、Target、构建模式的介绍请参考[配置多目标产物](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-customized-multi-targets-and-products-guides)和[指定构建模式](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-hvigor-compilation-options-customizing-guide#section192461528194916)。
2.  在**AppAnalyzer**页面，选择**规则体检**，选择自动或手动方式，**模块**选择框选择HarmonyOS应用/元服务工程模块。
    
    *   自动方式：体检时无需手动遍历，AppAnalyzer会自动检测。
    *   手动方式：体检时需要根据提示手动遍历HarmonyOS应用/元服务的功能。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/d8/v3/QA8RQ56TSWW955-xU52iMQ/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073903Z&HW-CC-Expire=86400&HW-CC-Sign=FEE67DA6A919C2C3A67EA87CBD195A55D07B9AB74927628F5D33E76BD3EE04A4)
    
    *   如果使用DevEco Studio 6.0.0 Beta2之前的版本，只有已经完成签名编译打包的模块才能被选中。
    *   支持同时添加多个模块，要求所有模块的“bundleName”相同，且多个模块中只能包含一个entry。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/94/v3/GH1acAKIREqvf7W9-JN-1Q/zh-cn_image_0000002594474750.png?HW-CC-KV=V1&HW-CC-Date=20260612T073903Z&HW-CC-Expire=86400&HW-CC-Sign=37261BEBB8620CE6641E69B4D4AEB3E5001B22D7AD601FFF5F24E510DA4024E9)
    
3.  选择待测试的规则，规则详情请参考[规则总览](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-app-analyzer-all-rules)，然后在**AppAnalyzer**页面底部单击**开始**按钮，开始测试。部分测试规则依赖Python，请根据AppAnalyzer的指引，下载Python及三方库。在测试过程中，请保持连接的设备为解锁亮屏状态。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/60/v3/oYzOrJE2Qcq8oT739lA1xw/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073903Z&HW-CC-Expire=86400&HW-CC-Sign=BEEF26FEC2D6DA6ACA53A5A610AA23A50E36F951237834B448CC0F0F79F3BBFD)
    
    *   请勿在测试完成前点击结束，如果提前结束测试会导致测试结果不准确。
    *   支持Python 3.9~3.12版本，推荐使用Python 3.11.7版本。
    *   部分规则体检会进行投屏，如果测试过程中同时使用其他投屏工具，如DevEco Testing，可能会对UX测试的投屏造成干扰。如果投屏中断或不同步，可点击左上角刷新按钮重新投屏。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/cf/v3/d0AVgkCrRQW4X7vwx90TWQ/zh-cn_image_0000002594634678.png?HW-CC-KV=V1&HW-CC-Date=20260612T073903Z&HW-CC-Expire=86400&HW-CC-Sign=9C6F218582676FFA8996B92CBB0D997731E90558E1D92FB4921FDFA196E63F51)
    
4.  如果是手动方式，在安装应用/元服务完成后，需要根据提示手动遍历HarmonyOS应用/元服务的功能。手动遍历完成后点击**结束**按钮停止测试任务，等待数据解析完成后，查看测试结果如下。
    
    *   测试报告：检测结果的汇总信息，点击**详情链接**可跳转到对应的详情报告。
        
        ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/59/v3/C2XYdZNQSB-wra4lnLLp3A/zh-cn_image_0000002624994111.png?HW-CC-KV=V1&HW-CC-Date=20260612T073903Z&HW-CC-Expire=86400&HW-CC-Sign=9B82C32940D5715B404DBABBB68B4A19280D5ED9B8EAB6AF709118E6C1E17F42)
        
    *   详情报告：只包含检测失败的规则，给出详细的测试结果、相关的定位文件和对应的优化建议。
        
        *   **源文件、调优文件（包含trace文件和调用栈文件）或snapshot文件、时间戳等**：点击源文件可跳转到问题源码，点击调优文件或snapshot文件支持直接拉起性能分析工具Profiler并导入性能检测的问题数据进行调优分析，点击时间戳可以打开Profiler并定位到问题发生的时间范围。
        *   **分析文档**：点击链接可跳转至官网文档，参考文档对检测出来的问题进行分析。
        *   **优化建议**：点击链接可跳转至官网文档，参考文档对检测出来的问题进行优化。
        *   **Code Linter**：在“最佳实践测试”项目中，可直接在拉起Code Linter的同时，传递有问题的代码文件名，自动执行代码检查。在“快速性能测试”和“性能测试”项目中，因无代码文件名等信息，部分检测规则不支持自动执行代码检查，仅支持拉起Code Linter。
        
        ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/4b/v3/dTWhSa-0RsqHNSH7EjlBew/zh-cn_image_0000002625074261.png?HW-CC-KV=V1&HW-CC-Date=20260612T073903Z&HW-CC-Expire=86400&HW-CC-Sign=FD9E9FAB4DC6A888725B6DD0E65C453E483A1EA6C3138C8F4FEAD43C4C69D1D9)