宿主工具白皮书

简介

宿主工具是一个桌面化CTS测试工具，能为宿主提供CTS全能力测试、单能力调试和确认上报CTS报告的能力。宿主在首次集成小程序SDK和每次升级小程序SDK时都必须通过CTS测试（Compatibility Test Suite ，CTS），以保障小程序在宿主APP中正确运行且具有良好体验。

操作手册

以下是宿主工具操作手册，使用过程中如遇到问题，请联系百度侧工作人员。

一、登陆

输入宿主工具账号和密码（同：开源联盟平台账号一致）

宿主工具登录账号与开源联盟平台账号一致，都使用百度UC账号进行登录.

二、配置环境

1、PC端环境配置（只有测试iOS设备需要配置环境）
点击【配置本地环境】，打开电脑环境配置页，找到mac驱动ios设置环境配置，按步骤进行相关配置

2、移动设备环境配置
点击【配置移动设备】打开设备配置页，根据想要测试的设备类型（iOS，Android）找到相应的配置部分进行配置

三、CTS全能力调试

1、自动测试
（1）点击【进入自动测试】，进入CTS全能力自动化调试页面；
（2）进入该页面后，需先在左侧配置栏进行环境可用性检测，确保当前测试设备已安装好宿主APP，且连接上电脑；（包名在『开源联盟平台-设置-开发设置-开发信息』中配置后生成，详见Q&A）；
（3）点击【全能力测试】进行CTS自动化测试，测试完成后将会生成CTS报告，可打开查看报告结果；
（4）若该份CTS报告通过率过低，建议宿主先check未通过的能力，然后点击【补充测试】进行覆盖测试。补充测试会对该份CTS报告中失败的case进行重新测试，并覆盖生成新的CTS报告；
注意：补充测试需在同一部测试手机，同一swan SDK、宿主版本号和端类型下进行
（5）报告通过率过低不允许上传（通过率过低，请先查看报告中未通过的能力，进行宿主能力补齐。如若仍有问题，联系百度侧工作人员）

2、手动测试
因部分能力无法通过自动化case执行，需进行手动测试。
（1）点击【进入手动测试】，进入CTS手动测试页面；
（2）进入该页面后，需先在左侧配置栏进行环境可用性检测，确保当前测试设备已安装好宿主APP，且连接上电脑；
（3）右侧页面点击【生成二维码】，会在空白处生成CTS小程序二维码；
（4）打开宿主app，扫描二维码进入CTS小程序后可进行手动测试，测试完毕后需在手机端上传手动测试报告；

四、单能力调试

（1）右侧页面API/组件调试模块，点击【进入调试】，打开单能力调试页面；
（2）进入该页面后，需先在左侧配置栏进行环境可用性检测，确保当前测试设备已安装好宿主APP，且连接上电脑；
（3）下拉框支持输入或选择多个待调试的API/组件，点击【执行测试】进行单能力调试；
（4）单能力调试完毕后，点击打开报告可查看单能力调试结果；