自注册DM(二)CMCC移动DM FAQ

终端管理平台&客户端适配常见问题及解决措施

 

请各位软件负责人务必单独出DM测试版本，不要一直把测试版SDK放在代码流上，不然所出的每个软件版本都频繁上报会导致移动dm测试服务器崩溃，影响其他项目测试

移动也已经出台了相应政策来限制这种频繁上报：固定IMEI的活跃周期只能1个月，一个月后不允许该IMEI上报了

适配平台地址：https://test.fxltsbl.com/

ＧＩＸＸＸＸ @123

问题0：总体概述。厂商如何使用SDK、DM的实现原理是什么、找不到DmykAbsTelephonyManager类？

答：参考CmccDemo_Svn示例Demo，厂商要负责实现类似功能的系统级应用，赋予相应的权限，满足相应的“不可见”、“无感知”、“常驻”等要求，在Application的onCreate(Bundle)函数中初始化SDK，由厂商自行创建DmykAbsTelephonyManager类并在其中实现文档中要求的接口，通过getDefault函数返回该类实例，将jar包及.so文件添加到应用中。SDK会根据业务需求通过该实例调用接口，获取对应的信息进行处理并完成对应的上报业务。配置业务中，所需数据参数由SDK从服务器获取并进行处理，需要厂商注意的是，APN配置的修改是SDK通过操作数据库实现的，厂商只需监听数据库的变化并在数据库发生变化时发送相应的设置状态变更广播，VoLTE开关状态需要变更时，需要跳转到对应的设置页面，在用户设置完成后再发送对应的广播由SDK接收并做进一步处理。实际上，数据的采集是由厂商完成并通过接口提供给SDK的，SDK仅仅是对数据的汇总处理，并完成与平台的交互。另外，SDK中很多业务是由广播触发的，如果出现短时间内重复上报，请先自行判断是否有广播的密集重复发送。

 

问题1、SDK方提供了多个.so文件，可以删除或混淆么？

.so文件是根据CPU型号适配的，由系统决定具体使用哪个文件，所以不要做任何混淆或删改。

 

问题2、心跳周期时长及设置？

为了方便调试，心跳周期在调试版中做过比例缩短处理，商用版的一小时等于调试版的一分钟。例如：调试版在配置页面中配置心跳周期为3小时，实际3分钟就会上传心跳。

 

问题3、心跳周期什么时候生效？

心跳周期的变更会在下一次心跳后生效，例如，在10:00:00开始上报第一次心跳，默认为1小时（调试版为1分钟）周期，在10:01:20修改心跳周期为5小时（调试版中为5分钟），则10:02:00依然会上报第三次心跳，第四次心跳会在第10:07:00上报。

 

问题4、数据上报成功后在终端适配平台查不大数据，过一会又查到了？

终端适配平台页面展示存在一定延迟，上报的数据并不会即时在平台上展示，可能存在2~5分钟延迟，属于正常现象，且商用版和调试版延迟是相同的。

 

问题5、SDK的心跳怎么保活，遇到异常情景是否会失效？

SDK的计时功能（心跳、上报失败的重新发送等）可能因一些不可预测的情况导致计时器失效，但SDK有计时器检测机制，在终端重启、网络变更、计时器触发时会检测其余计时器状态，如果检测到计时器失效，会根据最近一次设置的时间

重新开启计时器，导致时间存在一定偏移，运行一段时间后恢复稳定心跳。

 

问题6、SDK设置VoLTE通知栏提醒、VoLTE状态变更、APN信息状态变更等广播的Action怎么接收？

由SDK发送的广播使用系统静态BroadCastReceiver接收，具体广播类型参考《终端管理接口规范》中定义的行为，在Activity或Server中接收可能会接受不到。

 

问题7、部分厂家手机在恢复出厂后上报业务均不再触发，发现数据不上报，使用浏览器访问网页提示证书无效等。

请确认恢复出厂后的时间，因网络传输采用HTTPS协议，证书受时间影响，可能在恢复出厂的默认时间（如2016.01.01）证书失效，在设置正确时间后上报业务即可恢复正常。

 

问题8、SDK的Service在什么条件下会stopSelf ？

出于适配和功能的考虑，Service开启后是不会关闭的，如出现Service被杀死属于异常情况，Service会在接收到指定广播后重新开启Service。终端厂商需保证终端管理客户端能后台静默运行。

 

问题9、适配过程中发现没有心跳、APN数据、应用数据不上报，日志中参照不到对应的日志。

请确保AndroidManifest.xml配置清单中的uses-permission、service、receiver、intent-filter、action等均正确配置且无遗漏。

 

问题10、重启手机后没有自注册信息上报？

自注册上报的判断条件是SIM卡变更或卡槽位置变更，仅仅重启手机是不会触发自注册上报的，可以考虑恢复出厂、更换SIM卡、将SIM卡更换卡槽等方式再次触发自注册。

 

问题11、终端厂商需实现那些功能、SDK实现那些功能？

终端厂商的职责是要实现的是接口规范的接口，以及终端规范里屏蔽权限提示，用户不可见要求，将jar包集成内置，资源集成，并赋予相应权限，保证SDK的正常运行及接口规范文档中的列出的接口均能够正常调用，DM业务上报、心跳、应用信息采集及上报逻辑由SDK实现。

 

问题12、终端管理客户端命名有什么特殊要求么？

不得包含“中国移动”、“CMCC”等与中国移动相关的字样，同样不建议包含“DM”

 

问题13、环境配置有什么要求？

参见《SDK集成文档》

 

问题14、有些手机双卡IMEI号相同，是否会触发自注册？

双卡的手机的IMEI相同，导致同一张SIM卡在更换卡槽时不触发自注册。

问题15、单卡手机卡槽2的IMEI号、cellId、LAC等信息返回什么？

默认返回空。

 

问题16、双VoLTE终端获取主卡状态时返回什么，getMasterPhoneId()在这个情况下返回什么？

双VoLTE终端返回值为3，两张卡可同时4G驻网

 

问题17、如何获取厂商实现DmykAbsTelephonyManager类实例？

DmykAbsTelephonyManager类是由终端厂商实现类，获取对象的方法为getDefault(Context context)。

 

问题18、无法查询不到VoLTE开关业务配置数据

根据imei号查看是否有相应的心跳数据volte数据上报，VoLTE业务状态随心跳上报到终端管理平台。

 

问题19、根据查询条件，未查询到上报数据，怎么处理？

上报数据会有2到3分钟延迟入库，请在之后时间在进行查询。

 

问题20、如何查看终端自注册、心跳、应用数据查看详细信息？

点击某行数据即可弹出详细数据窗口。如图所示：

 

问题21、系统参数配置没有新增规则的操作按钮？

需要有心跳数据上报后才能显示按钮。

 

问题22、采集配置没有新增规则的操作按钮？

需要有心跳数据上报后才能显示按钮。

 

 

问题23、系统参数配置如何操作？

可通过厂家+型号或IMEI号两种范围来进行配置；常用场景：点击新增系统参数配置，输入规则名称，配置纬度选择IMEI号，输入要配置的终端IMEI号，新增需要测试的配置规则；