目 录
2.1 自注册客户端使用说明................................................................... 1
2.2 自注册辅助软件使用说明............................................................... 2
3 使用自注册客户端...................................................................................... 9
3.2 信息注册......................................................................................... 10
3.3 适配说明......................................................................................... 10
适配包包含以下内容文件如下所示:
SystemHelper.apk
自注册客户端安装文件,用于预装到终端/system/app目录。
必须预装
RegisterHelper.apk
自注册辅助软件仅用于测试,配合SystemHelper.apk使用。
主要功能包括查看终端信息,清除注册数据,临时改变服务器的地址,打开注册软件的日志开关,打开30分钟轮次开关。
送测阶段INSTALL至手机,方便测试人员使用,正式版不能预装
Readme.doc
适配包说明文件。
1. 将SystemHelper.apkpush至终端/system/app/目录下;
命令如下:
adb push ($本地路径\)SystemHelper.apk system/app/
说明:
1) 请确保终端已经获取root权限,且有system/app目录的读写权限。若提示无权限,可执行adb remount命令后再次push。
2) 若厂商需将自注册客户端安装至其他目录,请确保自注册客户端有该目录的读写权限,并能够开机启动。
3) 若厂商终端内置安全管理应用程序,请不要阻止自注册客户端(程序包名为com.mobiletools.systemhelper)的开机启动行为。
4) 若厂商终端内置了唤醒对齐软件,请不要将自注册客户端唤醒对齐(程序包名为com.mobiletools.systemhelper)。
5) 厂商送测时请将SystemHelper.apk预装在手机ROM中。
2. 重启终端,进入终端设置中,在应用程序管理器里查看全部应用,若看到com.xxx(厂商名).helper表明安装成功;
说明:
1)push成功后,不可以卸载,但可以停用。
2.2 自注册辅助软件使用说明
1. 安装测试辅助软件。将RegisterHelper.apk拷贝至测试终端SD卡或机身内存,点击apk安装即可。安装完毕后,进入应用界面如下图:
功能说明:
1)查看终端信息——查看该终端注册所需的参数信息。
2)激活——连接到自注册客户端。连接成功后,“清除注册数据”、“设置服务器地址”、“打开日志”、“打开30分钟轮次”被点亮并可以使用;
3)清除注册数据——将终端恢复为未注册状态,以便进行其它测试用例。同时会将服务器地址恢复为生产平台的地址,关闭日志功能,关闭30分钟轮次功能。因此在执行这一操作之后,需要重新设置服务器地址为测试平台地址,以便能继续使用测试平台进行测试。
4)设置服务器地址——将上方编辑框中的值设置为自注册服务器的地址。编辑框中默认为测试平台的地址。
5)打开日志——点击后将打开SystemHelper的日志开关,在测试时会有日志生成,方便追踪测试过程。
6)打开30分钟轮次——点击后将重试轮次之间的时间间隔减小为30分钟,同时会输出日志文件。
7)具体测试方法和测试案例请参考联通测试规范。
2. 模拟测试。依次点击“激活”,“清除注册数据”,“设置服务器地址”,“退出”后重启终端可激活自注册模拟测试功能。终端开机后,连接到wifi或蜂窝网络后可触发注册功能。操作如下图:
3. 打开自注册客户端日志功能。依次点击“激活”,“清除注册数据”,“设置服务器地址”,“打开日志”,“退出”后重启终端可激活带运行日志的自注册模拟测试功能。操作如下图:
说明:
1) 日志功能用于打开SystemHelper的日志开关选项。测试如果出现问题,无需刷机只要通过RegistHelper就可打开日志,方便抓取log用于分析和定位出错原因。
2) 日志默认保存在手机内置存储的根目录下。日志文件名为SystemHelper.log。(完整路径为:/sdcard/SystemHelper.log)
如果没有内置存储空间或SD卡,日志将保存在手机的/data/data/com.mobiletools.systemhelper/files/目录下。可通过adb命令查看。
adb shell cat /data/data/com.mobiletools.systemhelper/files/*.log
3) 日志打开后,如要关闭日志功能,需要依次点击“激活”,“清除注册数据”即可。
4. 打开自注册客户端30分钟轮次功能。依次点击“激活”,“清除注册数据”,“设置服务器地址”,“打开30分钟轮次”,“退出”后重启终端可激活30分钟轮次测试功能。操作如下图:
说明:
1)30分钟轮次功能打开后会将重试轮次之间的时间间隔减小为30分钟,同时会输出日志文件。该功能很少使用。
2)如要关闭30分钟轮次功能,需要依次点击“激活”,“清除注册数据”即可。
3.1 注册参数
自注册客户端会获取以下终端参数:
参数名称 | 说明 | 支持程度 |
Manuf | 厂商代码 | 必需 |
Model | 终端型号 | 必需 |
HWVersion | 终端硬件版本 | 必需 |
SWVersion | 终端软件版本 | 必需 |
OS | 操作系统名称 | 必需 |
OSVersion | 操作系统版本 | 必需 |
IMEI1 | 主卡槽的IMEI | 必需 |
ICCID1 | 主SIM卡的ICCID | 如果能取到则包含 |
IMSI1 | 主SIM卡的IMSI | 如果能取到则包含 |
MSISDN1 | 主卡用户号码 | 如果能取到则包含 |
MNC1 | 主卡运营商MCC+MNC | 如果能取到则包含 |
NCLS1 | 主卡网络类型,取值为GSM或WCDMA | 如果能取到则包含 |
CellID1 | 注册时主卡所接入的基站CellID | 如果能取到则包含 |
LAC1 | 注册时主卡所在基站位置区码 | 如果能取到则包含 |
IMEI2 | 副卡槽的IMEI | 如果能取到则包含 |
ICCID2 | 副SIM卡的ICCID | 如果能取到则包含 |
IMSI2 | 副SIM卡的IMSI | 如果能取到则包含 |
MSISDN2 | 副卡用户号码 | 如果能取到则包含 |
MNC2 | 副卡运营商MCC+MNC | 如果能取到则包含 |
NCLS2 | 副卡网络类型,取值为GSM或WCDMA | 如果能取到则包含 |
CellID2 | 注册时副卡所接入的基站CellID | 可选 |
LAC2 | 注册时副卡所在位置区码 | 可选 |
AccType | 注册时使用的数据通道的接入类型,取值Mobile或WiFi | 必需 |
Time | 检测到第一次开机的时间,格式为:YYYY-MM-DD HH:mm:SS。注意这不是成功注册的时间。注册可能会失败多次,终端应准确记录第一次开机或者更换SIM卡的时间。 | 必需 |
3.2 信息注册
自注册客户端可通过wifi注册或数据网络数据注册。客户端启动后会检测终端是否已完成注册,若未完成注册,会向服务器发起注册。
Wifi注册:开机后当连接wifi网络后,等待2分钟会触发注册。
数据注册:开机后当连接数据网络后,等待30分钟会触发注册。
3.3 适配说明
1. 请预装SystemHelper.apk。
2. 请保证SystemHelper.apk能够开机启动,不被系统拦截。
3.4 测试平台地址
http://dm.wo.com.cn:6002/boncregtest/
账号:gionee01 密码:gionee1q2w3e