diff options
author | chen xu <fionaxu@google.com> | 2019-03-11 10:25:39 -0700 |
---|---|---|
committer | android-build-merger <android-build-merger@google.com> | 2019-03-11 10:25:39 -0700 |
commit | 8a2df338db699cb83cf1c22951d7f6201bf9ddd9 (patch) | |
tree | a1761a2eb0ac31b097fc01408a08f8987e86f429 | |
parent | 09a30cba0380106deeafbc78675bf7437cbf133e (diff) | |
parent | 462d40193f149b14c25e51134180c12eb78aefb8 (diff) | |
download | android_packages_apps_CarrierConfig-8a2df338db699cb83cf1c22951d7f6201bf9ddd9.tar.gz android_packages_apps_CarrierConfig-8a2df338db699cb83cf1c22951d7f6201bf9ddd9.tar.bz2 android_packages_apps_CarrierConfig-8a2df338db699cb83cf1c22951d7f6201bf9ddd9.zip |
improve carrier id documentation am: 0962fe946e
am: 462d40193f
Change-Id: I79137f75da70fe80a9de730d958e90f8351e440d
-rw-r--r-- | README | 2 | ||||
-rw-r--r-- | src/com/android/carrierconfig/DefaultCarrierConfigService.java | 24 |
2 files changed, 16 insertions, 10 deletions
@@ -9,7 +9,7 @@ folder. Two ways to configure per-network configuration. Preferred way is carrier_config_carrierid_<carrierid>_<carriername>.xml AOSP carrier ID assignments can be found at https://android.googlesource.com/platform/packages/providers/TelephonyProvider/+/master/assets/carrier_list.textpb -another way is carrier_config_mccmnc_<mccmnc>.xml +use carrier_config_mccmnc_<mccmnc>.xml only if there is no matching carrier id. This app uses a CarrierIdentifier to read the appropriate config snippets from the assets folder. diff --git a/src/com/android/carrierconfig/DefaultCarrierConfigService.java b/src/com/android/carrierconfig/DefaultCarrierConfigService.java index d69722e..2980332 100644 --- a/src/com/android/carrierconfig/DefaultCarrierConfigService.java +++ b/src/com/android/carrierconfig/DefaultCarrierConfigService.java @@ -48,7 +48,13 @@ public class DefaultCarrierConfigService extends CarrierService { * Returns per-network overrides for carrier configuration. * * This returns a carrier config bundle appropriate for the given carrier by reading data from - * files in our assets folder. First we look for file named after + * files in our assets folder. Config files in assets folder are carrier-id-indexed + * {@link TelephonyManager#getSimCarrierId()}. NOTE: config files named after mccmnc + * are for those without a matching carrier id and should be renamed to carrier id once the + * missing IDs are added to + * <a href="https://android.googlesource.com/platform/packages/providers/TelephonyProvider/+/master/assets/carrier_list.textpb">carrier id list</a> + * + * First, look for file named after * carrier_config_carrierid_<carrierid>_<carriername>.xml if carrier id is not * {@link TelephonyManager#UNKNOWN_CARRIER_ID}. Note <carriername> is to improve the * readability which should not be used to search asset files. If there is no configuration, @@ -143,26 +149,26 @@ public class DefaultCarrierConfigService extends CarrierService { * by {@link PersistableBundle#restoreFromXml}. All the matching bundles will be flattened and * returned as a single bundle.</p> * - * <p>Here is an example document. The second bundle will be applied to the first only if the - * GID1 is ABCD. + * <p>Here is an example document in vendor.xml. * <pre>{@code * <carrier_config_list> - * <carrier_config> + * <carrier_config cid="1938" name="verizon"> * <boolean name="voicemail_notification_persistent_bool" value="true" /> * </carrier_config> - * <carrier_config gid1="ABCD"> + * <carrier_config cid="1788" name="sprint"> * <boolean name="voicemail_notification_persistent_bool" value="false" /> * </carrier_config> * </carrier_config_list> * }</pre></p> * - * <p>Here is another example document in vendor.xml. + * <p>Here is an example document. The second bundle will be applied to the first only if the + * GID1 is ABCD. * <pre>{@code * <carrier_config_list> - * <carrier_config cid="1938" name="verizon"> + * <carrier_config> * <boolean name="voicemail_notification_persistent_bool" value="true" /> * </carrier_config> - * <carrier_config cid="1788" name="sprint"> + * <carrier_config gid1="ABCD"> * <boolean name="voicemail_notification_persistent_bool" value="false" /> * </carrier_config> * </carrier_config_list> @@ -170,7 +176,7 @@ public class DefaultCarrierConfigService extends CarrierService { * * @param parser an XmlPullParser pointing at the beginning of the document. * @param id the details of the SIM operator used to filter parts of the document. If read from - * file named after carrier id, this will be set to {@null code} as no filter match + * files named after carrier id, this will be set to {@null code} as no filter match * needed. * @return a possibly empty PersistableBundle containing the config values. */ |