Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 17bebd2f authored by Jeff Sharkey's avatar Jeff Sharkey
Browse files

Expose SubscriptionPlan API. 

Clean up SubscriptionPlan, add docs, and expose as public API.

Deprecate older constants in CarrierConfigManager, and point users
towards new API.  (The goal of CarrierConfigManager is to express
key/value pairs that are identical for all users on a particular
carrier, not to configure details that vary between users.)

Since a CarrierService may itself not have access to the plan
details, allow them to "delegate" the capability to configure plans
to another package name.

Factor out new RecurrenceRule class which is used by both
NetworkPolicy and SubscriptionPlan internally.  Polish it to support
arbitrary periods, and continue to test it through NPMST.

Bug: 63391323
Test: bit FrameworksCoreTests:android.util.RecurrenceRuleTest
Test: bit FrameworksServicesTests:com.android.server.NetworkPolicyManagerServiceTest
Exempt-From-Owner-Approval: Bug 63673347
Change-Id: I93fae4a43e58e9e4c32f8bf345a257dcd607f088
parent 747938ed

api/current.txt

+39 −4
Original line number Diff line number Diff line
@@ -39535,7 +39535,7 @@ package android.telephony { 
    method public android.os.PersistableBundle getConfigForSubId(int);

    method public void notifyConfigChangedForSubId(int);

    field public static final java.lang.String ACTION_CARRIER_CONFIG_CHANGED = "android.telephony.action.CARRIER_CONFIG_CHANGED";

    field public static final int DATA_CYCLE_THRESHOLD_DISABLED = -2; // 0xfffffffe

    field public static final deprecated int DATA_CYCLE_THRESHOLD_DISABLED = -2; // 0xfffffffe

    field public static final java.lang.String KEY_ADDITIONAL_CALL_SETTING_BOOL = "additional_call_setting_bool";

    field public static final java.lang.String KEY_ALLOW_ADDING_APNS_BOOL = "allow_adding_apns_bool";

    field public static final java.lang.String KEY_ALLOW_ADD_CALL_DURING_VIDEO_CALL_BOOL = "allow_add_call_during_video_call";
@@ -39577,9 +39577,10 @@ package android.telephony { 
    field public static final java.lang.String KEY_CI_ACTION_ON_SYS_UPDATE_EXTRA_VAL_STRING = "ci_action_on_sys_update_extra_val_string";

    field public static final java.lang.String KEY_CI_ACTION_ON_SYS_UPDATE_INTENT_STRING = "ci_action_on_sys_update_intent_string";

    field public static final java.lang.String KEY_CONFIG_IMS_PACKAGE_OVERRIDE_STRING = "config_ims_package_override_string";

    field public static final java.lang.String KEY_CONFIG_PLANS_PACKAGE_OVERRIDE_STRING = "config_plans_package_override_string";

    field public static final java.lang.String KEY_CSP_ENABLED_BOOL = "csp_enabled_bool";

    field public static final java.lang.String KEY_DATA_LIMIT_THRESHOLD_BYTES_LONG = "data_limit_threshold_bytes_long";

    field public static final java.lang.String KEY_DATA_WARNING_THRESHOLD_BYTES_LONG = "data_warning_threshold_bytes_long";

    field public static final deprecated java.lang.String KEY_DATA_LIMIT_THRESHOLD_BYTES_LONG = "data_limit_threshold_bytes_long";

    field public static final deprecated java.lang.String KEY_DATA_WARNING_THRESHOLD_BYTES_LONG = "data_warning_threshold_bytes_long";

    field public static final java.lang.String KEY_DEFAULT_SIM_CALL_MANAGER_STRING = "default_sim_call_manager_string";

    field public static final java.lang.String KEY_DEFAULT_VM_NUMBER_STRING = "default_vm_number_string";

    field public static final java.lang.String KEY_DIAL_STRING_REPLACE_STRING_ARRAY = "dial_string_replace_string_array";
@@ -39636,7 +39637,7 @@ package android.telephony { 
    field public static final java.lang.String KEY_MMS_UA_PROF_TAG_NAME_STRING = "uaProfTagName";

    field public static final java.lang.String KEY_MMS_UA_PROF_URL_STRING = "uaProfUrl";

    field public static final java.lang.String KEY_MMS_USER_AGENT_STRING = "userAgent";

    field public static final java.lang.String KEY_MONTHLY_DATA_CYCLE_DAY_INT = "monthly_data_cycle_day_int";

    field public static final deprecated java.lang.String KEY_MONTHLY_DATA_CYCLE_DAY_INT = "monthly_data_cycle_day_int";

    field public static final java.lang.String KEY_ONLY_SINGLE_DC_ALLOWED_INT_ARRAY = "only_single_dc_allowed_int_array";

    field public static final java.lang.String KEY_OPERATOR_SELECTION_EXPAND_BOOL = "operator_selection_expand_bool";

    field public static final java.lang.String KEY_PREFER_2G_BOOL = "prefer_2g_bool";
@@ -40148,8 +40149,10 @@ package android.telephony { 
    method public static int getDefaultSmsSubscriptionId();

    method public static int getDefaultSubscriptionId();

    method public static int getDefaultVoiceSubscriptionId();

    method public java.util.List<android.telephony.SubscriptionPlan> getSubscriptionPlans(int);

    method public boolean isNetworkRoaming(int);

    method public void removeOnSubscriptionsChangedListener(android.telephony.SubscriptionManager.OnSubscriptionsChangedListener);

    method public void setSubscriptionPlans(int, java.util.List<android.telephony.SubscriptionPlan>);

    field public static final java.lang.String ACTION_DEFAULT_SMS_SUBSCRIPTION_CHANGED = "android.telephony.action.DEFAULT_SMS_SUBSCRIPTION_CHANGED";

    field public static final java.lang.String ACTION_DEFAULT_SUBSCRIPTION_CHANGED = "android.telephony.action.DEFAULT_SUBSCRIPTION_CHANGED";

    field public static final int DATA_ROAMING_DISABLE = 0; // 0x0
@@ -40163,6 +40166,38 @@ package android.telephony { 
    method public void onSubscriptionsChanged();

  }













  public final class SubscriptionPlan implements android.os.Parcelable {













    method public java.util.Iterator<android.util.Pair<java.time.ZonedDateTime, java.time.ZonedDateTime>> cycleIterator();













    method public int describeContents();













    method public int getDataLimitBehavior();













    method public long getDataLimitBytes();













    method public long getDataUsageBytes();













    method public long getDataUsageTime();













    method public java.lang.CharSequence getSummary();













    method public java.lang.CharSequence getTitle();













    method public void writeToParcel(android.os.Parcel, int);













    field public static final long BYTES_UNKNOWN = -1L; // 0xffffffffffffffffL













    field public static final long BYTES_UNLIMITED = 9223372036854775807L; // 0x7fffffffffffffffL













    field public static final android.os.Parcelable.Creator<android.telephony.SubscriptionPlan> CREATOR;













    field public static final int LIMIT_BEHAVIOR_BILLED = 1; // 0x1













    field public static final int LIMIT_BEHAVIOR_DISABLED = 0; // 0x0













    field public static final int LIMIT_BEHAVIOR_THROTTLED = 2; // 0x2













    field public static final int LIMIT_BEHAVIOR_UNKNOWN = -1; // 0xffffffff













    field public static final long TIME_UNKNOWN = -1L; // 0xffffffffffffffffL













  }

























  public static class SubscriptionPlan.Builder {













    method public android.telephony.SubscriptionPlan build();













    method public static android.telephony.SubscriptionPlan.Builder createNonrecurring(java.time.ZonedDateTime, java.time.ZonedDateTime);













    method public static android.telephony.SubscriptionPlan.Builder createRecurringDaily(java.time.ZonedDateTime);













    method public static android.telephony.SubscriptionPlan.Builder createRecurringMonthly(java.time.ZonedDateTime);













    method public static android.telephony.SubscriptionPlan.Builder createRecurringWeekly(java.time.ZonedDateTime);













    method public android.telephony.SubscriptionPlan.Builder setDataLimit(long, int);













    method public android.telephony.SubscriptionPlan.Builder setDataUsage(long, long);













    method public android.telephony.SubscriptionPlan.Builder setSummary(java.lang.CharSequence);













    method public android.telephony.SubscriptionPlan.Builder setTitle(java.lang.CharSequence);













  }



























  public class TelephonyManager {















    method public boolean canChangeDtmfToneLength();















    method public android.telephony.TelephonyManager createForPhoneAccountHandle(android.telecom.PhoneAccountHandle);

























api/system-current.txt



+39
−5




























Original line number
Diff line number
Diff line








@@ -146,7 +146,6 @@ package android {













    field public static final java.lang.String MANAGE_CA_CERTIFICATES = "android.permission.MANAGE_CA_CERTIFICATES";















    field public static final java.lang.String MANAGE_DEVICE_ADMINS = "android.permission.MANAGE_DEVICE_ADMINS";















    field public static final java.lang.String MANAGE_DOCUMENTS = "android.permission.MANAGE_DOCUMENTS";













    field public static final java.lang.String MANAGE_FALLBACK_SUBSCRIPTION_PLANS = "android.permission.MANAGE_FALLBACK_SUBSCRIPTION_PLANS";















    field public static final java.lang.String MANAGE_OWN_CALLS = "android.permission.MANAGE_OWN_CALLS";















    field public static final java.lang.String MANAGE_USB = "android.permission.MANAGE_USB";















    field public static final java.lang.String MANAGE_USERS = "android.permission.MANAGE_USERS";










@@ -43082,7 +43081,7 @@ package android.telephony {













    method public void notifyConfigChangedForSubId(int);















    method public void updateConfigForPhoneId(int, java.lang.String);















    field public static final java.lang.String ACTION_CARRIER_CONFIG_CHANGED = "android.telephony.action.CARRIER_CONFIG_CHANGED";













    field public static final int DATA_CYCLE_THRESHOLD_DISABLED = -2; // 0xfffffffe













    field public static final deprecated int DATA_CYCLE_THRESHOLD_DISABLED = -2; // 0xfffffffe















    field public static final java.lang.String KEY_ADDITIONAL_CALL_SETTING_BOOL = "additional_call_setting_bool";















    field public static final java.lang.String KEY_ALLOW_ADDING_APNS_BOOL = "allow_adding_apns_bool";















    field public static final java.lang.String KEY_ALLOW_ADD_CALL_DURING_VIDEO_CALL_BOOL = "allow_add_call_during_video_call";










@@ -43124,9 +43123,10 @@ package android.telephony {













    field public static final java.lang.String KEY_CI_ACTION_ON_SYS_UPDATE_EXTRA_VAL_STRING = "ci_action_on_sys_update_extra_val_string";















    field public static final java.lang.String KEY_CI_ACTION_ON_SYS_UPDATE_INTENT_STRING = "ci_action_on_sys_update_intent_string";















    field public static final java.lang.String KEY_CONFIG_IMS_PACKAGE_OVERRIDE_STRING = "config_ims_package_override_string";













    field public static final java.lang.String KEY_CONFIG_PLANS_PACKAGE_OVERRIDE_STRING = "config_plans_package_override_string";















    field public static final java.lang.String KEY_CSP_ENABLED_BOOL = "csp_enabled_bool";













    field public static final java.lang.String KEY_DATA_LIMIT_THRESHOLD_BYTES_LONG = "data_limit_threshold_bytes_long";













    field public static final java.lang.String KEY_DATA_WARNING_THRESHOLD_BYTES_LONG = "data_warning_threshold_bytes_long";













    field public static final deprecated java.lang.String KEY_DATA_LIMIT_THRESHOLD_BYTES_LONG = "data_limit_threshold_bytes_long";













    field public static final deprecated java.lang.String KEY_DATA_WARNING_THRESHOLD_BYTES_LONG = "data_warning_threshold_bytes_long";















    field public static final java.lang.String KEY_DEFAULT_SIM_CALL_MANAGER_STRING = "default_sim_call_manager_string";















    field public static final java.lang.String KEY_DEFAULT_VM_NUMBER_STRING = "default_vm_number_string";















    field public static final java.lang.String KEY_DIAL_STRING_REPLACE_STRING_ARRAY = "dial_string_replace_string_array";










@@ -43183,7 +43183,7 @@ package android.telephony {













    field public static final java.lang.String KEY_MMS_UA_PROF_TAG_NAME_STRING = "uaProfTagName";















    field public static final java.lang.String KEY_MMS_UA_PROF_URL_STRING = "uaProfUrl";















    field public static final java.lang.String KEY_MMS_USER_AGENT_STRING = "userAgent";













    field public static final java.lang.String KEY_MONTHLY_DATA_CYCLE_DAY_INT = "monthly_data_cycle_day_int";













    field public static final deprecated java.lang.String KEY_MONTHLY_DATA_CYCLE_DAY_INT = "monthly_data_cycle_day_int";















    field public static final java.lang.String KEY_ONLY_SINGLE_DC_ALLOWED_INT_ARRAY = "only_single_dc_allowed_int_array";















    field public static final java.lang.String KEY_OPERATOR_SELECTION_EXPAND_BOOL = "operator_selection_expand_bool";















    field public static final java.lang.String KEY_PREFER_2G_BOOL = "prefer_2g_bool";










@@ -43697,8 +43697,10 @@ package android.telephony {













    method public static int getDefaultSmsSubscriptionId();















    method public static int getDefaultSubscriptionId();















    method public static int getDefaultVoiceSubscriptionId();













    method public java.util.List<android.telephony.SubscriptionPlan> getSubscriptionPlans(int);















    method public boolean isNetworkRoaming(int);















    method public void removeOnSubscriptionsChangedListener(android.telephony.SubscriptionManager.OnSubscriptionsChangedListener);













    method public void setSubscriptionPlans(int, java.util.List<android.telephony.SubscriptionPlan>);















    field public static final java.lang.String ACTION_DEFAULT_SMS_SUBSCRIPTION_CHANGED = "android.telephony.action.DEFAULT_SMS_SUBSCRIPTION_CHANGED";















    field public static final java.lang.String ACTION_DEFAULT_SUBSCRIPTION_CHANGED = "android.telephony.action.DEFAULT_SUBSCRIPTION_CHANGED";















    field public static final int DATA_ROAMING_DISABLE = 0; // 0x0









@@ -43712,6 +43714,38 @@ package android.telephony {













    method public void onSubscriptionsChanged();















  }



























  public final class SubscriptionPlan implements android.os.Parcelable {













    method public java.util.Iterator<android.util.Pair<java.time.ZonedDateTime, java.time.ZonedDateTime>> cycleIterator();













    method public int describeContents();













    method public int getDataLimitBehavior();













    method public long getDataLimitBytes();













    method public long getDataUsageBytes();













    method public long getDataUsageTime();













    method public java.lang.CharSequence getSummary();













    method public java.lang.CharSequence getTitle();













    method public void writeToParcel(android.os.Parcel, int);













    field public static final long BYTES_UNKNOWN = -1L; // 0xffffffffffffffffL













    field public static final long BYTES_UNLIMITED = 9223372036854775807L; // 0x7fffffffffffffffL













    field public static final android.os.Parcelable.Creator<android.telephony.SubscriptionPlan> CREATOR;













    field public static final int LIMIT_BEHAVIOR_BILLED = 1; // 0x1













    field public static final int LIMIT_BEHAVIOR_DISABLED = 0; // 0x0













    field public static final int LIMIT_BEHAVIOR_THROTTLED = 2; // 0x2













    field public static final int LIMIT_BEHAVIOR_UNKNOWN = -1; // 0xffffffff













    field public static final long TIME_UNKNOWN = -1L; // 0xffffffffffffffffL













  }

























  public static class SubscriptionPlan.Builder {













    method public android.telephony.SubscriptionPlan build();













    method public static android.telephony.SubscriptionPlan.Builder createNonrecurring(java.time.ZonedDateTime, java.time.ZonedDateTime);













    method public static android.telephony.SubscriptionPlan.Builder createRecurringDaily(java.time.ZonedDateTime);













    method public static android.telephony.SubscriptionPlan.Builder createRecurringMonthly(java.time.ZonedDateTime);













    method public static android.telephony.SubscriptionPlan.Builder createRecurringWeekly(java.time.ZonedDateTime);













    method public android.telephony.SubscriptionPlan.Builder setDataLimit(long, int);













    method public android.telephony.SubscriptionPlan.Builder setDataUsage(long, long);













    method public android.telephony.SubscriptionPlan.Builder setSummary(java.lang.CharSequence);













    method public android.telephony.SubscriptionPlan.Builder setTitle(java.lang.CharSequence);













  }



























  public final class TelephonyHistogram implements android.os.Parcelable {















    ctor public TelephonyHistogram(int, int, int);















    ctor public TelephonyHistogram(android.telephony.TelephonyHistogram);

























api/test-current.txt



+39
−4




























Original line number
Diff line number
Diff line








@@ -39761,7 +39761,7 @@ package android.telephony {













    method public android.os.PersistableBundle getConfigForSubId(int);















    method public void notifyConfigChangedForSubId(int);















    field public static final java.lang.String ACTION_CARRIER_CONFIG_CHANGED = "android.telephony.action.CARRIER_CONFIG_CHANGED";













    field public static final int DATA_CYCLE_THRESHOLD_DISABLED = -2; // 0xfffffffe













    field public static final deprecated int DATA_CYCLE_THRESHOLD_DISABLED = -2; // 0xfffffffe















    field public static final java.lang.String KEY_ADDITIONAL_CALL_SETTING_BOOL = "additional_call_setting_bool";















    field public static final java.lang.String KEY_ALLOW_ADDING_APNS_BOOL = "allow_adding_apns_bool";















    field public static final java.lang.String KEY_ALLOW_ADD_CALL_DURING_VIDEO_CALL_BOOL = "allow_add_call_during_video_call";










@@ -39803,9 +39803,10 @@ package android.telephony {













    field public static final java.lang.String KEY_CI_ACTION_ON_SYS_UPDATE_EXTRA_VAL_STRING = "ci_action_on_sys_update_extra_val_string";















    field public static final java.lang.String KEY_CI_ACTION_ON_SYS_UPDATE_INTENT_STRING = "ci_action_on_sys_update_intent_string";















    field public static final java.lang.String KEY_CONFIG_IMS_PACKAGE_OVERRIDE_STRING = "config_ims_package_override_string";













    field public static final java.lang.String KEY_CONFIG_PLANS_PACKAGE_OVERRIDE_STRING = "config_plans_package_override_string";















    field public static final java.lang.String KEY_CSP_ENABLED_BOOL = "csp_enabled_bool";













    field public static final java.lang.String KEY_DATA_LIMIT_THRESHOLD_BYTES_LONG = "data_limit_threshold_bytes_long";













    field public static final java.lang.String KEY_DATA_WARNING_THRESHOLD_BYTES_LONG = "data_warning_threshold_bytes_long";













    field public static final deprecated java.lang.String KEY_DATA_LIMIT_THRESHOLD_BYTES_LONG = "data_limit_threshold_bytes_long";













    field public static final deprecated java.lang.String KEY_DATA_WARNING_THRESHOLD_BYTES_LONG = "data_warning_threshold_bytes_long";















    field public static final java.lang.String KEY_DEFAULT_SIM_CALL_MANAGER_STRING = "default_sim_call_manager_string";















    field public static final java.lang.String KEY_DEFAULT_VM_NUMBER_STRING = "default_vm_number_string";















    field public static final java.lang.String KEY_DIAL_STRING_REPLACE_STRING_ARRAY = "dial_string_replace_string_array";










@@ -39862,7 +39863,7 @@ package android.telephony {













    field public static final java.lang.String KEY_MMS_UA_PROF_TAG_NAME_STRING = "uaProfTagName";















    field public static final java.lang.String KEY_MMS_UA_PROF_URL_STRING = "uaProfUrl";















    field public static final java.lang.String KEY_MMS_USER_AGENT_STRING = "userAgent";













    field public static final java.lang.String KEY_MONTHLY_DATA_CYCLE_DAY_INT = "monthly_data_cycle_day_int";













    field public static final deprecated java.lang.String KEY_MONTHLY_DATA_CYCLE_DAY_INT = "monthly_data_cycle_day_int";















    field public static final java.lang.String KEY_ONLY_SINGLE_DC_ALLOWED_INT_ARRAY = "only_single_dc_allowed_int_array";















    field public static final java.lang.String KEY_OPERATOR_SELECTION_EXPAND_BOOL = "operator_selection_expand_bool";















    field public static final java.lang.String KEY_PREFER_2G_BOOL = "prefer_2g_bool";










@@ -40374,8 +40375,10 @@ package android.telephony {













    method public static int getDefaultSmsSubscriptionId();















    method public static int getDefaultSubscriptionId();















    method public static int getDefaultVoiceSubscriptionId();













    method public java.util.List<android.telephony.SubscriptionPlan> getSubscriptionPlans(int);















    method public boolean isNetworkRoaming(int);















    method public void removeOnSubscriptionsChangedListener(android.telephony.SubscriptionManager.OnSubscriptionsChangedListener);













    method public void setSubscriptionPlans(int, java.util.List<android.telephony.SubscriptionPlan>);















    field public static final java.lang.String ACTION_DEFAULT_SMS_SUBSCRIPTION_CHANGED = "android.telephony.action.DEFAULT_SMS_SUBSCRIPTION_CHANGED";















    field public static final java.lang.String ACTION_DEFAULT_SUBSCRIPTION_CHANGED = "android.telephony.action.DEFAULT_SUBSCRIPTION_CHANGED";















    field public static final int DATA_ROAMING_DISABLE = 0; // 0x0









@@ -40389,6 +40392,38 @@ package android.telephony {













    method public void onSubscriptionsChanged();















  }



























  public final class SubscriptionPlan implements android.os.Parcelable {













    method public java.util.Iterator<android.util.Pair<java.time.ZonedDateTime, java.time.ZonedDateTime>> cycleIterator();













    method public int describeContents();













    method public int getDataLimitBehavior();













    method public long getDataLimitBytes();













    method public long getDataUsageBytes();













    method public long getDataUsageTime();













    method public java.lang.CharSequence getSummary();













    method public java.lang.CharSequence getTitle();













    method public void writeToParcel(android.os.Parcel, int);













    field public static final long BYTES_UNKNOWN = -1L; // 0xffffffffffffffffL













    field public static final long BYTES_UNLIMITED = 9223372036854775807L; // 0x7fffffffffffffffL













    field public static final android.os.Parcelable.Creator<android.telephony.SubscriptionPlan> CREATOR;













    field public static final int LIMIT_BEHAVIOR_BILLED = 1; // 0x1













    field public static final int LIMIT_BEHAVIOR_DISABLED = 0; // 0x0













    field public static final int LIMIT_BEHAVIOR_THROTTLED = 2; // 0x2













    field public static final int LIMIT_BEHAVIOR_UNKNOWN = -1; // 0xffffffff













    field public static final long TIME_UNKNOWN = -1L; // 0xffffffffffffffffL













  }

























  public static class SubscriptionPlan.Builder {













    method public android.telephony.SubscriptionPlan build();













    method public static android.telephony.SubscriptionPlan.Builder createNonrecurring(java.time.ZonedDateTime, java.time.ZonedDateTime);













    method public static android.telephony.SubscriptionPlan.Builder createRecurringDaily(java.time.ZonedDateTime);













    method public static android.telephony.SubscriptionPlan.Builder createRecurringMonthly(java.time.ZonedDateTime);













    method public static android.telephony.SubscriptionPlan.Builder createRecurringWeekly(java.time.ZonedDateTime);













    method public android.telephony.SubscriptionPlan.Builder setDataLimit(long, int);













    method public android.telephony.SubscriptionPlan.Builder setDataUsage(long, long);













    method public android.telephony.SubscriptionPlan.Builder setSummary(java.lang.CharSequence);













    method public android.telephony.SubscriptionPlan.Builder setTitle(java.lang.CharSequence);













  }



























  public class TelephonyManager {















    method public boolean canChangeDtmfToneLength();















    method public android.telephony.TelephonyManager createForPhoneAccountHandle(android.telecom.PhoneAccountHandle);

























core/java/android/net/INetworkPolicyManager.aidl



+0
−2




























Original line number
Diff line number
Diff line








@@ -71,7 +71,5 @@ interface INetworkPolicyManager {













    SubscriptionPlan[] getSubscriptionPlans(int subId, String callingPackage);















    void setSubscriptionPlans(int subId, in SubscriptionPlan[] plans, String callingPackage);





























    String getSubscriptionPlanOwner(int subId);





























    void factoryReset(String subscriber);















}
























core/java/android/net/NetworkPolicy.java



+87
−58


























File changed.
Preview size limit exceeded, changes collapsed.