一、SPN模块简介
【笔记】SPN和PLMN 运营商网络名称显示
Android U 配置 WiFiCalling 场景下PLMN/SPN 显示的代码逻辑介绍
【笔记】Android Telephony 漫游SPN显示定制（Roaming Alpha Tag）
二、相关配置字段
- non_roaming_operator_string_array 是否视为非漫游
- spn_display_condition_override_int
- opl_override_opl_string_array 覆写卡文件EF_OPL（"plmn1,lactac_start,lactac_end,index"）
- pnn_override_string_array 覆写卡文件EF_PNN（"alpha_long1,alpha_short1"）
CarrierConfigManager 定义
frameworks/base/telephony/java/android/telephony/CarrierConfigManager.java
三、需求场景及功能代码
漫游场景
漫游情况一般分为国内漫游和国际漫游（），一般国内漫游认为在国内，国际漫游在国外。
不清楚漫游到国内外的情况时，可以通过底层上报获取状态，接口getDataRoamingType()
frameworks/base/telephony/java/android/telephony/ServiceState.java (androidxref.cn android-14.0.0_r18)
frameworks
漫游状态字段
| ROAMING_TYPE_ | num | Function |
|---|---|---|
| ROAMING_TYPE_NOT_ROAMING | 0 | 本地网络home |
| ROAMING_TYPE_UNKNOWN | 1 | 漫游但不能判断类型 domestic or international. |
| ROAMING_TYPE_DOMESTIC | 2 | 国内漫游 domestic |
| ROAMING_TYPE_INTERNATIONAL | 3 | 国际漫游 international |
//@Retention注解标记了该注解的保留策略，即 SOURCE。
//编译器在编译过程中会忽略@Retention注解，即编译后的代码中不会出现Retention。
//@Retention注解的作用是为了给静态分析工具提供元数据。
//@IntDef一个定义在 Android SDK 中的注解，用于告诉静态分析工具这个枚举类型 RoamingType 的取值范围，它包括一个 prefix 和一个 value。其中，prefix 参数指定了枚举值的前缀，这是为了避免与其他枚举类型的取值冲突；value 参数指定了枚举类型的所有可能取值。
/** @hide */
@Retention(RetentionPolicy.SOURCE)
@IntDef(prefix = { "ROAMING_TYPE_" }, value = {
ROAMING_TYPE_NOT_ROAMING,
ROAMING_TYPE_UNKNOWN,
ROAMING_TYPE_DOMESTIC,
ROAMING_TYPE_INTERNATIONAL
})
//定义了一个注解类型 RoamingType，它实际上是一个注解类的声明。
//作用：可以在其他代码中使用该注解来表示 RoamingType 类型的值。
public @interface RoamingType {}
/**
* Not roaming, registered in home network.
* @hide
*/
@SystemApi
public static final int ROAMING_TYPE_NOT_ROAMING = 0;
/**
* registered in a roaming network, but can not tell if it's domestic or international.
* @hide
*/
@SystemApi
public static final int ROAMING_TYPE_UNKNOWN = 1;
/**
* registered in a domestic roaming network
* @hide
*/
@SystemApi
public static final int ROAMING_TYPE_DOMESTIC = 2;
/**
* registered in an international roaming network
* @hide
*/
@SystemApi
public static final int ROAMING_TYPE_INTERNATIONAL = 3;四、开发方案
- 将non_roaming_operator_string_array配置成false，则指定漫游到的mccmnc会视为home网，不会显示plmn，以spn为准。
- carrier_name_string和carrier_name_override_bool 配套配置实现overlay
- 对于漫游时，定制OPL（opl_override_opl_string_array）
比如针对cid=1952的卡，原始配置：packages/apps/CarrierConfig/assets/carrier_config_carrierid_1952_US-Cellular.xml
定制配置如下：/packages/apps/CarrierConfig/res/xml/vendor.xml
<carrier_config cid="1952" name="U.S. Cellular">
<string name="carrier_name_string">UScellular</string>
<boolean name="carrier_name_override_bool" value="true"/>
<!--plmn1,lactac_start,lactac_end,index"-->
<string-array name="opl_override_opl_string_array" num="24">
<item value="311580,0,65535,0" />
<item value="311581,0,65535,0" />
<item value="311582,0,65535,0" />
<item value="311583,0,65535,0" />
<item value="311584,0,65535,0" />
<item value="311585,0,65535,0" />
<item value="311586,0,65535,0" />
<item value="311587,0,65535,0" />
<item value="311588,0,65535,0" />
<item value="311589,0,65535,0" />
<item value="311220,0,65535,0" />
<item value="311221,0,65535,0" />
<item value="311222,0,65535,0" />
<item value="311223,0,65535,0" />
<item value="311224,0,65535,0" />
<item value="311225,0,65535,0" />
<item value="311226,0,65535,0" />
<item value="311227,0,65535,0" />
<item value="311228,0,65535,0" />
<item value="311229,0,65535,0" />
<item value="310120,0,65535,0" />
<item value="312420,0,65535,0" />
<item value="311480,0,65535,0" />
<item value="310410,0,65535,0" />
</string-array>
<string-array name="pnn_override_string_array" num="1">
<item value="UScelluar" />
</string-array>
</carrier_config>
