前置文章
- 《Android系统之System Server大纲》
- 《Android无线电信息管理开篇准备工作》
- 《初识com.android.phone》
- 《PhoneInterfaceManager》
- 《TelephonyTesgistry》
- 《UICC》
前言
如果读者对 Android 的 Telephony 不是十分了解,对本文存在很多不解之处的,可以先阅读章节前置文章中的文章,尤其是 《Android无线电信息管理开篇准备工作》、《初识com.android.phone》、《UICC》,以便更好的读懂本文。
SubscriptionController 即 SIM 卡信息控制器,用 Subscription 的描述方式来自 3GPP 协议,SIM 卡可被描述为 Subscriber。SubscriptionController 作为控制器,所以它所担负的责任是 SIM 卡信息的中转和管理工作。
在文章《UICC》中,对 SIM 卡信息的来源于管理有了充分的认识,对理解 SubscriptionController 可以发挥非常重要的作用。在手机开机或 SIM 卡变更等行为时,Phone 中的 RIL 加载到 SIM 卡的信息后,便把数据传至 SubscriptionController。另外需要注意的是,SubscriptionController 没有改变 SIM 卡原始数据(卡文件数据)的能力。
SIM 卡数据管理架构
本文中提到的 SIM 卡数据,如果没有特别说明,特指 Subscriber 方面的数据,不包括其他用户数据等。
增加SIM卡数据
当有一张新的 SIM 卡插入到手机,手机检测到有 SIM 卡插入,就会发起 SIM 卡数据的查询,UiccController 将查询得到的数据,传递到 SubscriptionController。流程如下:
下面着重分析一下几个重要的过程
updateSubscriptionInfoByIccId()
synchronized protected /*private*/ void updateSubscriptionInfoByIccId() {
.....
for (int i = 0; i < PROJECT_SIM_NUM; i++) {
if (mInsertSimState[i] == SIM_NOT_INSERT) {
logd("updateSubscriptionInfoByIccId: No SIM inserted in slot " + i + " this time");
} else {
if (mInsertSimState[i] > 0) {
.....
} else /*if (sInsertSimState[i] != SIM_NOT_INSERT)*/ {
//新插入的SIM卡走这个通道,
//第一个参数是SIM卡的 ICC id
//第二个参数是 Slot id,即卡1、卡2...
mSubscriptionManager.addSubscriptionInfoRecord(mIccId[i], i);
}
}
}
.....
}
这个方法定义在文件 frameworks/opt/telephony/src/java/com/android/internal/telephony/SubscriptionInfoUpdater.java 中。
上面的方法中提到了 ICC ID,ICC ID为IC卡的唯一识别号码,共有20位数字组成。手机中通过 ICC ID 作为依据来识别不同的 SIM 卡。
Slot ID 和 手机上的卡槽对应,卡1的 Slot ID 为 0,卡2的 Slot ID 为 2,以此类推。
继续跟踪这个方法的下一步
public int addSubInfoRecord(String iccId, int slotIndex) {
.....
try {
.....
//SubscriptionController把数据固化在数据库,数据库的操作交由TelephonyProvider完成;
//数据保存路径为:
// 1、7.0之前的版本:/data/data/com.android.providers.telephony/databases/telephony.db
// 2、7.0(含)之后的版本:/data/user_de/0/com.android.providers.telephony/databases/telephony.db
//数据库表格为 siminfo
ContentResolver resolver = mContext.getContentResolver();
//查询数据库中是否已经存在同一张SIM卡的信息,通过 ICC ID 唯一识别SIM卡
Cursor cursor = resolver.query(SubscriptionManager.CONTENT_URI,
new String[]{SubscriptionManager.UNIQUE_KEY_SUBSCRIPTION_ID,
SubscriptionManager.SIM_SLOT_INDEX, SubscriptionManager.NAME_SOURCE},
SubscriptionManager.ICC_ID + "=?", new String[]{iccId}, null);
boolean setDisplayName = false;
try {
//数据库中如果已经存在同一张SIM的信息,则更新数据库信息;
//数据库中如果不存在此张SIM卡的信息,则把新的SIM卡的信息插入数据库
if (cursor == null || !cursor.moveToFirst()) {
setDisplayName = true;
//插入新的SIM卡信息到数据库
Uri uri = insertEmptySubInfoRecord(iccId, slotIndex);
if (DBG) logdl("[addSubInfoRecord] New record created: " + uri);
} else {
.....
if (value.size() > 0) {
resolver.update(SubscriptionManager.CONTENT_URI, value,
SubscriptionManager.UNIQUE_KEY_SUBSCRIPTION_ID +
"=" + Long.toString(subId), null);
}
}
}.....
//查询这个卡槽下插过的所有SIM卡数据记录
cursor = resolver.query(SubscriptionManager.CONTENT_URI, null,
SubscriptionManager.SIM_SLOT_INDEX + "=?",
new String[] {String.valueOf(slotIndex)}, null);
try {
if (cursor != null && cursor.moveToFirst()) {
do {
//subid即subscription id,由数据库中的_id(自增长字段)字段确定;
int subId = cursor.getInt(cursor.getColumnIndexOrThrow(
SubscriptionManager.UNIQUE_KEY_SUBSCRIPTION_ID));
//sSlotIndexToSubId中保存当前对应的slot id 的 sub id
//这里提一下 phone id,phone id其实和 slot id 是一致的,都是依赖卡槽从零开始编号
Integer currentSubId = sSlotIndexToSubId.get(slotIndex);
if (currentSubId == null
|| currentSubId != subId
|| !SubscriptionManager.isValidSubscriptionId(currentSubId)) {
.....
}
} while (cursor.moveToNext());
}
}
.....
return 0;
}
这个方法定义在文件 frameworks/opt/telephony/src/java/com/android/internal/telephony/SubscriptionController.java 中。
请认真阅读代码中的注释了解这个方法的过程。
如果 SIM 卡数据有变化,系统会发送如下广播:
//android.intent.action.ACTION_SUBINFO_CONTENT_CHANGE
Intent intent = new Intent(TelephonyIntents.ACTION_SUBINFO_CONTENT_CHANGE);
mContext.sendBroadcast(intent);
//android.intent.action.ACTION_SUBINFO_RECORD_UPDATED
intent = new Intent(TelephonyIntents.ACTION_SUBINFO_RECORD_UPDATED);
mContext.sendBroadcast(intent);
SIM info数据库主要信息
SubscriptionController 的介绍就到这里,因为这已经介绍了 SubscriptionController 的核心部分,其它的代码都是获取设置以上数据库中的信息,本文就不一一展开讨论他们了,过程也大多很简单,就是对数据库或者缓存数据进行查询和修改。
总结
SubscriptionController 的代码不多,业务也比较简单,主要弄懂 SubscriptionController 所管理的 SIM 卡信息的来源,传播途径,以及对 SIM 卡信息的维护这三个过程,subscriber 这块的知识在上层的应用基本就贯通了。