需求描述及功能逻辑
OMADM 机制根据节点信息修改对应的APN,因此代码也通过Node消息管控实现。
- _listenOpApnSettings
- opCheckIsInProgressAndSaveNodeValue
- saveAndUpdateApnValue
- this.operatorVariantHandlers[simslot.index].applySettings(mcc, mnc/*, false*/, apnEnabledStateChange)
- applySettings(mcc, mnc, updateAPN)
- applyOperatorVariantSettings(result)
- buildApnSettings(allApnList)
- 初始化APN数组 var apnSettings = [] 和tmpApnSettings
- 根据APN_TYPES.length长度遍历赋值tmpApnSettings,
- 再将数组拷贝给apnSettings 保存 apnSettings = this.convertApnSettings(tmpApnSettings); this.buildPreferredApnSettings(apnSettings);
- buildPreferredApnSettings(apnSettings)
- navigator.b2g.engmodeManager.setDataProfileByType(JSON.stringify(apnSettings[index]), 1);
接口表 operator_variant_xxx.js(gaia)
业务模块
- gaia/apps/system/js/operator_variant_handler.js 具体APN数据处理者
- gaia/apps/system/js/operator_variant_manager.js 运营商管理
Interface | Module | Comment |
_listenOpApnSettings(simslot) | operator_variant_manager.js | |
opCheckIsInProgressAndSaveNodeValue(node, value, simslot) | operator_variant_manager.js | |
saveAndUpdateApnValue(node, value, simslot) | operator_variant_manager.js | |
applySettings(mcc, mnc, updateAPN) | operator_variant_handler.js | updateAPN是OMADM对应的APN class 类型 |
applyOperatorVariantSettings(result) | operator_variant_handler.js | |
buildApnSettings(allApnList) | operator_variant_handler.js | |
buildPreferredApnSettings(apnSettings) | operator_variant_handler.js | 此接口只会被调用一次,因此在manager里面循环传参updateAPN调用applySettings()执行卡的时候,不能下发全部类型的全部APN。(存疑) |
setDataProfileByType | EngmodeManager.jsm | Manager通过发消息触发服务执行: 1.Services.cpmm.sendAsyncMessage("Engmode:setDataProfileByType", 2.内部收到消息在receiveMessage(aMessage)匹配case 执行 case "Engmode:setDataProfileByType:Return": 3. |
_setDataProfileByType | EngmodeService.jsm | 在 buildPreferredApnSettings定制的类型会触发dataprofile下发MD,在engmode中实现。 |
相关工具模块 Engmode(gecko)
- gecko/koost/engmode/EngmodeService.jsm
在engmode实现同步APN到MD的接口,定义上层和底层APN Type的映射关系,用于同步dataProfile到Modem。
js/module | Interface | Comment |
EngmodeManager.jsm | setDataProfileByType(strApnSetting, type) | 管理通过消息调起服务。 |
EngmodeService.jsm | _setDataProfileByType(networkType, profileId, apn, protocol, roamingProtocol, authType, user, password, type, maxConnsTime, maxConns, waitTime, enabled, inactivityTimer, callback) | 定义服务 |
对象管理 OperatorVariantHandler
- 在operator_variant_manager.js创建,在operator_variant_handler.js实现自身功能逻辑。
- OperatorVariantHandler 是一个管理运营商变体的对象,用于存储和处理与运营商变体相关的信息。
operator_variant_manager.js
Manager的结构如下:
(function() {var OperatorVariantManager = function(core) {/** Array of OperatorVariantHandler objects. */if (core) {this.mobileConnections = core.mobileConnections;}this.operatorVariantHandlers = [];};OperatorVariantManager.IMPORTS = ['js/operator_variant_handler.js'];OperatorVariantManager.EVENTS = ['simslot-updated','simslot-iccinfochange','logohidden'];BaseModule.create(OperatorVariantManager, {});//具体功能实现
})();
1、在 KaiOS 的 JavaScript 中,BaseModule 是一个基础模块,用于封装应用程序中的通用功能,例如管理应用程序状态、处理事件、创建通用UI等。BaseModule.create() 是一个用于创建模块实例的静态方法,第一个参数为模块构造函数,第二个参数为模块的配置对象,用于指定模块的名称、版本、依赖关系等信息。
2、logohidden 是一个自定义的事件名称(在OperatorVariantManager.EVENTS定义),用于在 KaiOS 中指示系统已经完成启动过程并准备好显示应用程序。当系统启动时,会显示 KaiOS 的 Logo,一旦logohidden!=null,就会触发 logohidden 事件,表明系统已经启动完毕并准备好显示应用程序。
(1)在下面init代码片段中,注册 logohidden 事件的监听器,在事件触发时调用 updateSavedIccIds() 方法,该方法用于更新保存的 ICCID 列表。这个事件监听器只会在 logohidden 后执行一次,因为 { once: true } 参数指定了事件只会触发一次,确保 updateSavedIccIds() 方法不会被重复调用。
(2)_handle_logohidden 方法是一个事件监听器,它会在 logohidden 事件触发时被调用。在这个方法中,会遍历所有的移动连接对象,并检查是否有对应的 operatorVariantHandlers 对象。如果没有,就将该对象的值设置为 null。
日志参考:
01-16 17:49:49.532 996 996 I GeckoDump: _handle_logohidden operatorVariantHandlers[0] set to value null
BaseModule.create(OperatorVariantManager, {name: 'OperatorVariantManager',_start: function() {},_stop: function() {},'_handle_simslot-updated': function(evt) {},//。会影响APN的加载,如operatorVariantHandlers[index]被初始化成null。'_handle_logohidden': function() {navigator.b2g.mobileConnections.forEach((conn, index) => {if (!this.operatorVariantHandlers[index]) {//如果指定SIM 卡槽还没有准备好,就需要将对应的 operatorVariantHandlers 对象的值设置为 nulldump('_handle_logohidden operatorVariantHandlers[' + index + '] set to value null ')this.operatorVariantHandlers[index] = 'null';}});},'_handle_simslot-iccinfochange': function(evt) {},//在SIM状态变化的时候会执行,如果存在客制化return了可能会导致operatorVariantHandlers=nnull因此出现APN加载中断问题。//【关键逻辑】this.operatorVariantHandlers[simslot.index]只会在这里赋值_updateOperatorVariantHandler: function(simslot) {if (!this._isVariantReady(simslot)) {return;}if (!this.operatorVariantHandlers[simslot.index]) {this.operatorVariantHandlers[simslot.index] =new OperatorVariantHandler(simslot.simCard.iccInfo.iccid,simslot.index, this);this.operatorVariantHandlers[simslot.index].start();}},//SIM卡槽状态_isVariantReady: function(simslot) {//sim不存在 || SIM没有iccInfo || SIM iccInfo没有iccid = SIM 没有readyif (!simslot.simCard ||!simslot.simCard.iccInfo ||!simslot.simCard.iccInfo.iccid) {if (this.operatorVariantHandlers[simslot.index]) {this.operatorVariantHandlers[simslot.index] = 'removed';} else {this.operatorVariantHandlers[simslot.index] = null;}return false;} else if (!this.deviceInfoOs) {return false;}return true;},updateSavedIccIds: function() {},//初始化,会调用_updateOperatorVariantHandler,并监听logohidden和拔卡//OperatorVariantManager 对象被创建时被调用,用于初始化该对象并注册必要的事件监听器init: function() {if (this.deviceInfoOs) {SettingsObserver.unobserve('deviceinfo.os', this.updateDeviceInfoOs);SIMSlotManager.getSlots().forEach(function(slot) {this._updateOperatorVariantHandler(slot);}, this);}//只执行一次window.addEventListener('logohidden', () => {this.updateSavedIccIds();}, { once: true });window.addEventListener('simslot-removed', () => {this.updateSavedIccIds();});},updateDeviceInfoOs: function(value) {},nsureValueUnderKeyIsArray: function(key) {}});
拓展知识
SIM
在KaiOS中,是operator_variant_handler.js文件管理着OperatorVariantHandler对象中运营商的信息,包括初始化和切换卡变更。
iccid
mcc
mnc
OMADM
OMA-DM(Open Mobile Alliance Device Management)是一种用于远程管理移动设备的协议,通过OMA-DM协议,运营商可以向设备推送各种配置、更新、命令等。
在OMA-DM协议中,消息体是指通过协议传输的消息数据。
在OMA-DM协议中,更新APN配置时,需要通过指定一个APN配置模板来实现。
一般通过服务器推送消息到设备,用户终端收到后根据信息修改对应的APN。有的运营商通过class匹配不同类型的APN,而上层修改APN后也需要同步到MD,同样需要建立映射关系。
举例如下:
APN Type | AP class | MD profile_Id | Comment/eg |
ims | 1 | 5 | const NETWORK_TYPE_MOBILE_IMS = 5; |
fota | 2 | 7 | const NETWORK_TYPE_MOBILE_FOTA = 7; |
default | 3 | 0 | const NETWORK_TYPE_MOBILE = 1; |
mms | 4 | 2 | const NETWORK_TYPE_MOBILE_MMS = 2; |
- MD ProfileId 可以自定义的,AP Class应该运营商有要求。
- apn.json中配置"profile_id"字段