package com.android.settingslib; import static android.app.admin.DevicePolicyResources.Strings.Settings.WORK_PROFILE_USER_LABEL; import android.annotation.ColorInt; import android.annotation.Nullable; import android.app.admin.DevicePolicyManager; import android.content.Context; import android.content.Intent; import android.content.pm.ApplicationInfo; import android.content.pm.PackageInfo; import android.content.pm.PackageManager; import android.content.pm.PackageManager.NameNotFoundException; import android.content.pm.Signature; import android.content.pm.UserInfo; import android.content.res.ColorStateList; import android.content.res.Resources; import android.content.res.TypedArray; import android.graphics.Bitmap; import android.graphics.Canvas; import android.graphics.Color; import android.graphics.ColorFilter; import android.graphics.ColorMatrix; import android.graphics.ColorMatrixColorFilter; import android.graphics.drawable.Drawable; import android.hardware.usb.UsbManager; import android.hardware.usb.UsbPort; import android.hardware.usb.UsbPortStatus; import android.location.LocationManager; import android.media.AudioManager; import android.net.NetworkCapabilities; import android.net.TetheringManager; import android.net.vcn.VcnTransportInfo; import android.net.wifi.WifiInfo; import android.os.BatteryManager; import android.os.Build; import android.os.SystemProperties; import android.os.UserHandle; import android.os.UserManager; import android.print.PrintManager; import android.provider.Settings; import android.telephony.AccessNetworkConstants; import android.telephony.NetworkRegistrationInfo; import android.telephony.ServiceState; import android.telephony.TelephonyManager; import android.util.Log; import androidx.annotation.NonNull; import androidx.annotation.RequiresApi; import androidx.core.graphics.drawable.RoundedBitmapDrawable; import androidx.core.graphics.drawable.RoundedBitmapDrawableFactory; import com.android.internal.annotations.VisibleForTesting; import com.android.internal.util.UserIcons; import com.android.launcher3.icons.BaseIconFactory.IconOptions; import com.android.launcher3.icons.IconFactory; import com.android.settingslib.drawable.UserIconDrawable; import com.android.settingslib.fuelgauge.BatteryStatus; import com.android.settingslib.utils.BuildCompatUtils; import java.text.NumberFormat; import java.util.List; public class Utils { @VisibleForTesting static final String STORAGE_MANAGER_ENABLED_PROPERTY = "ro.storage_manager.enabled"; @VisibleForTesting static final String INCOMPATIBLE_CHARGER_WARNING_DISABLED = "incompatible_charger_warning_disabled"; private static Signature[] sSystemSignature; private static String sPermissionControllerPackageName; private static String sServicesSystemSharedLibPackageName; private static String sSharedSystemSharedLibPackageName; static final int[] WIFI_PIE = { com.android.internal.R.drawable.ic_wifi_signal_0, com.android.internal.R.drawable.ic_wifi_signal_1, com.android.internal.R.drawable.ic_wifi_signal_2, com.android.internal.R.drawable.ic_wifi_signal_3, com.android.internal.R.drawable.ic_wifi_signal_4 }; static final int[] SHOW_X_WIFI_PIE = { R.drawable.ic_show_x_wifi_signal_0, R.drawable.ic_show_x_wifi_signal_1, R.drawable.ic_show_x_wifi_signal_2, R.drawable.ic_show_x_wifi_signal_3, R.drawable.ic_show_x_wifi_signal_4 }; public static void updateLocationEnabled(Context context, boolean enabled, int userId, int source) { Settings.Secure.putIntForUser( context.getContentResolver(), Settings.Secure.LOCATION_CHANGER, source, userId); LocationManager locationManager = context.getSystemService(LocationManager.class); locationManager.setLocationEnabledForUser(enabled, UserHandle.of(userId)); } /** * Return string resource that best describes combination of tethering * options available on this device. */ public static int getTetheringLabel(TetheringManager tm) { String[] usbRegexs = tm.getTetherableUsbRegexs(); String[] wifiRegexs = tm.getTetherableWifiRegexs(); String[] bluetoothRegexs = tm.getTetherableBluetoothRegexs(); boolean usbAvailable = usbRegexs.length != 0; boolean wifiAvailable = wifiRegexs.length != 0; boolean bluetoothAvailable = bluetoothRegexs.length != 0; if (wifiAvailable && usbAvailable && bluetoothAvailable) { return R.string.tether_settings_title_all; } else if (wifiAvailable && usbAvailable) { return R.string.tether_settings_title_all; } else if (wifiAvailable && bluetoothAvailable) { return R.string.tether_settings_title_all; } else if (wifiAvailable) { return R.string.tether_settings_title_wifi; } else if (usbAvailable && bluetoothAvailable) { return R.string.tether_settings_title_usb_bluetooth; } else if (usbAvailable) { return R.string.tether_settings_title_usb; } else { return R.string.tether_settings_title_bluetooth; } } /** * Returns a label for the user, in the form of "User: user name" or "Work profile". */ public static String getUserLabel(Context context, UserInfo info) { String name = info != null ? info.name : null; if (info.isManagedProfile()) { // We use predefined values for managed profiles return BuildCompatUtils.isAtLeastT() ? getUpdatableManagedUserTitle(context) : context.getString(R.string.managed_user_title); } else if (info.isGuest()) { name = context.getString(com.android.internal.R.string.guest_name); } if (name == null && info != null) { name = Integer.toString(info.id); } else if (info == null) { name = context.getString(R.string.unknown); } return context.getResources().getString(R.string.running_process_item_user_label, name); } @RequiresApi(Build.VERSION_CODES.TIRAMISU) private static String getUpdatableManagedUserTitle(Context context) { return context.getSystemService(DevicePolicyManager.class).getResources().getString( WORK_PROFILE_USER_LABEL, () -> context.getString(R.string.managed_user_title)); } /** * Returns a circular icon for a user. */ public static Drawable getUserIcon(Context context, UserManager um, UserInfo user) { final int iconSize = UserIconDrawable.getDefaultSize(context); if (user.isManagedProfile()) { Drawable drawable = UserIconDrawable.getManagedUserDrawable(context); drawable.setBounds(0, 0, iconSize, iconSize); return drawable; } if (user.iconPath != null) { Bitmap icon = um.getUserIcon(user.id); if (icon != null) { return new UserIconDrawable(iconSize).setIcon(icon).bake(); } } return new UserIconDrawable(iconSize).setIconDrawable( UserIcons.getDefaultUserIcon(context.getResources(), user.id, /* light= */ false)) .bake(); } /** Formats a double from 0.0..100.0 with an option to round **/ public static String formatPercentage(double percentage, boolean round) { final int localPercentage = round ? Math.round((float) percentage) : (int) percentage; return formatPercentage(localPercentage); } /** Formats the ratio of amount/total as a percentage. */ public static String formatPercentage(long amount, long total) { return formatPercentage(((double) amount) / total); } /** Formats an integer from 0..100 as a percentage. */ public static String formatPercentage(int percentage) { return formatPercentage(((double) percentage) / 100.0); } /** Formats a double from 0.0..1.0 as a percentage. */ public static String formatPercentage(double percentage) { return NumberFormat.getPercentInstance().format(percentage); } public static int getBatteryLevel(Intent batteryChangedIntent) { int level = batteryChangedIntent.getIntExtra(BatteryManager.EXTRA_LEVEL, 0); int scale = batteryChangedIntent.getIntExtra(BatteryManager.EXTRA_SCALE, 100); return (level * 100) / scale; } /** * Get battery status string * * @param context the context * @param batteryChangedIntent battery broadcast intent received from {@link * Intent.ACTION_BATTERY_CHANGED}. * @param compactStatus to present compact battery charging string if {@code true} * @return battery status string */ public static String getBatteryStatus(Context context, Intent batteryChangedIntent, boolean compactStatus) { final int status = batteryChangedIntent.getIntExtra(BatteryManager.EXTRA_STATUS, BatteryManager.BATTERY_STATUS_UNKNOWN); final Resources res = context.getResources(); String statusString = res.getString(R.string.battery_info_status_unknown); final BatteryStatus batteryStatus = new BatteryStatus(batteryChangedIntent); if (batteryStatus.isCharged()) { statusString = res.getString(compactStatus ? R.string.battery_info_status_full_charged : R.string.battery_info_status_full); } else { if (status == BatteryManager.BATTERY_STATUS_CHARGING) { if (compactStatus) { statusString = res.getString(R.string.battery_info_status_charging); } else if (batteryStatus.isPluggedInWired()) { switch (batteryStatus.getChargingSpeed(context)) { case BatteryStatus.CHARGING_FAST: statusString = res.getString( R.string.battery_info_status_charging_fast); break; case BatteryStatus.CHARGING_SLOWLY: statusString = res.getString( R.string.battery_info_status_charging_slow); break; default: statusString = res.getString(R.string.battery_info_status_charging); break; } } else if (batteryStatus.isPluggedInDock()) { statusString = res.getString(R.string.battery_info_status_charging_dock); } else { statusString = res.getString(R.string.battery_info_status_charging_wireless); } } else if (status == BatteryManager.BATTERY_STATUS_DISCHARGING) { statusString = res.getString(R.string.battery_info_status_discharging); } else if (status == BatteryManager.BATTERY_STATUS_NOT_CHARGING) { statusString = res.getString(R.string.battery_info_status_not_charging); } } return statusString; } public static ColorStateList getColorAccent(Context context) { return getColorAttr(context, android.R.attr.colorAccent); } public static ColorStateList getColorError(Context context) { return getColorAttr(context, android.R.attr.colorError); } @ColorInt public static int getColorAccentDefaultColor(Context context) { return getColorAttrDefaultColor(context, android.R.attr.colorAccent); } @ColorInt public static int getColorErrorDefaultColor(Context context) { return getColorAttrDefaultColor(context, android.R.attr.colorError); } @ColorInt public static int getColorStateListDefaultColor(Context context, int resId) { final ColorStateList list = context.getResources().getColorStateList(resId, context.getTheme()); return list.getDefaultColor(); } /** * This method computes disabled color from normal color * * @param context the context * @param inputColor normal color. * @return disabled color. */ @ColorInt public static int getDisabled(Context context, int inputColor) { return applyAlphaAttr(context, android.R.attr.disabledAlpha, inputColor); } @ColorInt public static int applyAlphaAttr(Context context, int attr, int inputColor) { TypedArray ta = context.obtainStyledAttributes(new int[]{attr}); float alpha = ta.getFloat(0, 0); ta.recycle(); return applyAlpha(alpha, inputColor); } @ColorInt public static int applyAlpha(float alpha, int inputColor) { alpha *= Color.alpha(inputColor); return Color.argb((int) (alpha), Color.red(inputColor), Color.green(inputColor), Color.blue(inputColor)); } @ColorInt public static int getColorAttrDefaultColor(Context context, int attr) { return getColorAttrDefaultColor(context, attr, 0); } /** * Get color styled attribute {@code attr}, default to {@code defValue} if not found. */ @ColorInt public static int getColorAttrDefaultColor(Context context, int attr, @ColorInt int defValue) { TypedArray ta = context.obtainStyledAttributes(new int[]{attr}); @ColorInt int colorAccent = ta.getColor(0, defValue); ta.recycle(); return colorAccent; } public static ColorStateList getColorAttr(Context context, int attr) { TypedArray ta = context.obtainStyledAttributes(new int[]{attr}); ColorStateList stateList = null; try { stateList = ta.getColorStateList(0); } finally { ta.recycle(); } return stateList; } public static int getThemeAttr(Context context, int attr) { return getThemeAttr(context, attr, 0); } public static int getThemeAttr(Context context, int attr, int defaultValue) { TypedArray ta = context.obtainStyledAttributes(new int[]{attr}); int theme = ta.getResourceId(0, defaultValue); ta.recycle(); return theme; } public static Drawable getDrawable(Context context, int attr) { TypedArray ta = context.obtainStyledAttributes(new int[]{attr}); Drawable drawable = ta.getDrawable(0); ta.recycle(); return drawable; } /** * Create a color matrix suitable for a ColorMatrixColorFilter that modifies only the color but * preserves the alpha for a given drawable * @param color * @return a color matrix that uses the source alpha and given color */ public static ColorMatrix getAlphaInvariantColorMatrixForColor(@ColorInt int color) { int r = Color.red(color); int g = Color.green(color); int b = Color.blue(color); ColorMatrix cm = new ColorMatrix(new float[] { 0, 0, 0, 0, r, 0, 0, 0, 0, g, 0, 0, 0, 0, b, 0, 0, 0, 1, 0 }); return cm; } /** * Create a ColorMatrixColorFilter to tint a drawable but retain its alpha characteristics * * @return a ColorMatrixColorFilter which changes the color of the output but is invariant on * the source alpha */ public static ColorFilter getAlphaInvariantColorFilterForColor(@ColorInt int color) { return new ColorMatrixColorFilter(getAlphaInvariantColorMatrixForColor(color)); } /** * Determine whether a package is a "system package", in which case certain things (like * disabling notifications or disabling the package altogether) should be disallowed. *
* Note: This function is just for UI treatment, and should not be used for security purposes. * * @deprecated Use {@link ApplicationInfo#isSignedWithPlatformKey()} and * {@link #isEssentialPackage} instead. */ @Deprecated public static boolean isSystemPackage(Resources resources, PackageManager pm, PackageInfo pkg) { if (sSystemSignature == null) { sSystemSignature = new Signature[]{getSystemSignature(pm)}; } return (sSystemSignature[0] != null && sSystemSignature[0].equals(getFirstSignature(pkg))) || isEssentialPackage(resources, pm, pkg.packageName); } private static Signature getFirstSignature(PackageInfo pkg) { if (pkg != null && pkg.signatures != null && pkg.signatures.length > 0) { return pkg.signatures[0]; } return null; } private static Signature getSystemSignature(PackageManager pm) { try { final PackageInfo sys = pm.getPackageInfo("android", PackageManager.GET_SIGNATURES); return getFirstSignature(sys); } catch (NameNotFoundException e) { } return null; } /** * Determine whether a package is a "essential package". *
* In which case certain things (like disabling the package) should be disallowed.
*/
public static boolean isEssentialPackage(
Resources resources, PackageManager pm, String packageName) {
if (sPermissionControllerPackageName == null) {
sPermissionControllerPackageName = pm.getPermissionControllerPackageName();
}
if (sServicesSystemSharedLibPackageName == null) {
sServicesSystemSharedLibPackageName = pm.getServicesSystemSharedLibraryPackageName();
}
if (sSharedSystemSharedLibPackageName == null) {
sSharedSystemSharedLibPackageName = pm.getSharedSystemSharedLibraryPackageName();
}
return packageName.equals(sPermissionControllerPackageName)
|| packageName.equals(sServicesSystemSharedLibPackageName)
|| packageName.equals(sSharedSystemSharedLibPackageName)
|| packageName.equals(PrintManager.PRINT_SPOOLER_PACKAGE_NAME)
|| isDeviceProvisioningPackage(resources, packageName);
}
/**
* Returns {@code true} if the supplied package is the device provisioning app. Otherwise,
* returns {@code false}.
*/
public static boolean isDeviceProvisioningPackage(Resources resources, String packageName) {
String deviceProvisioningPackage = resources.getString(
com.android.internal.R.string.config_deviceProvisioningPackage);
return deviceProvisioningPackage != null && deviceProvisioningPackage.equals(packageName);
}
/**
* Returns the Wifi icon resource for a given RSSI level.
*
* @param level The number of bars to show (0-4)
* @throws IllegalArgumentException if an invalid RSSI level is given.
*/
public static int getWifiIconResource(int level) {
return getWifiIconResource(false /* showX */, level);
}
/**
* Returns the Wifi icon resource for a given RSSI level.
*
* @param showX True if a connected Wi-Fi network has the problem which should show Pie+x
* signal icon to users.
* @param level The number of bars to show (0-4)
* @throws IllegalArgumentException if an invalid RSSI level is given.
*/
public static int getWifiIconResource(boolean showX, int level) {
if (level < 0 || level >= WIFI_PIE.length) {
throw new IllegalArgumentException("No Wifi icon found for level: " + level);
}
return showX ? SHOW_X_WIFI_PIE[level] : WIFI_PIE[level];
}
public static int getDefaultStorageManagerDaysToRetain(Resources resources) {
int defaultDays = Settings.Secure.AUTOMATIC_STORAGE_MANAGER_DAYS_TO_RETAIN_DEFAULT;
try {
defaultDays =
resources.getInteger(
com.android
.internal
.R
.integer
.config_storageManagerDaystoRetainDefault);
} catch (Resources.NotFoundException e) {
// We are likely in a test environment.
}
return defaultDays;
}
public static boolean isWifiOnly(Context context) {
return !context.getSystemService(TelephonyManager.class).isDataCapable();
}
/** Returns if the automatic storage management feature is turned on or not. **/
public static boolean isStorageManagerEnabled(Context context) {
boolean isDefaultOn;
try {
isDefaultOn = SystemProperties.getBoolean(STORAGE_MANAGER_ENABLED_PROPERTY, false);
} catch (Resources.NotFoundException e) {
isDefaultOn = false;
}
return Settings.Secure.getInt(context.getContentResolver(),
Settings.Secure.AUTOMATIC_STORAGE_MANAGER_ENABLED,
isDefaultOn ? 1 : 0)
!= 0;
}
/**
* get that {@link AudioManager#getMode()} is in ringing/call/communication(VoIP) status.
*/
public static boolean isAudioModeOngoingCall(Context context) {
final AudioManager audioManager = context.getSystemService(AudioManager.class);
final int audioMode = audioManager.getMode();
return audioMode == AudioManager.MODE_RINGTONE
|| audioMode == AudioManager.MODE_IN_CALL
|| audioMode == AudioManager.MODE_IN_COMMUNICATION;
}
/**
* Return the service state is in-service or not.
* To make behavior consistent with SystemUI and Settings/AboutPhone/SIM status UI
*
* @param serviceState Service state. {@link ServiceState}
*/
public static boolean isInService(ServiceState serviceState) {
if (serviceState == null) {
return false;
}
int state = getCombinedServiceState(serviceState);
if (state == ServiceState.STATE_POWER_OFF
|| state == ServiceState.STATE_OUT_OF_SERVICE
|| state == ServiceState.STATE_EMERGENCY_ONLY) {
return false;
} else {
return true;
}
}
/**
* Return the combined service state.
* To make behavior consistent with SystemUI and Settings/AboutPhone/SIM status UI
*
* @param serviceState Service state. {@link ServiceState}
*/
public static int getCombinedServiceState(ServiceState serviceState) {
if (serviceState == null) {
return ServiceState.STATE_OUT_OF_SERVICE;
}
// Consider the device to be in service if either voice or data
// service is available. Some SIM cards are marketed as data-only
// and do not support voice service, and on these SIM cards, we
// want to show signal bars for data service as well as the "no
// service" or "emergency calls only" text that indicates that voice
// is not available. Note that we ignore the IWLAN service state
// because that state indicates the use of VoWIFI and not cell service
final int state = serviceState.getState();
final int dataState = serviceState.getDataRegistrationState();
if (state == ServiceState.STATE_OUT_OF_SERVICE
|| state == ServiceState.STATE_EMERGENCY_ONLY) {
if (dataState == ServiceState.STATE_IN_SERVICE && isNotInIwlan(serviceState)) {
return ServiceState.STATE_IN_SERVICE;
}
}
return state;
}
/** Get the corresponding adaptive icon drawable. */
public static Drawable getBadgedIcon(Context context, Drawable icon, UserHandle user) {
UserManager um = context.getSystemService(UserManager.class);
boolean isClone = um.getProfiles(user.getIdentifier()).stream()
.anyMatch(profile ->
profile.isCloneProfile() && profile.id == user.getIdentifier());
try (IconFactory iconFactory = IconFactory.obtain(context)) {
return iconFactory
.createBadgedIconBitmap(
icon,
new IconOptions().setUser(user).setIsCloneProfile(isClone))
.newIcon(context);
}
}
/** Get the {@link Drawable} that represents the app icon */
public static Drawable getBadgedIcon(Context context, ApplicationInfo appInfo) {
return getBadgedIcon(context, appInfo.loadUnbadgedIcon(context.getPackageManager()),
UserHandle.getUserHandleForUid(appInfo.uid));
}
private static boolean isNotInIwlan(ServiceState serviceState) {
final NetworkRegistrationInfo networkRegWlan = serviceState.getNetworkRegistrationInfo(
NetworkRegistrationInfo.DOMAIN_PS,
AccessNetworkConstants.TRANSPORT_TYPE_WLAN);
if (networkRegWlan == null) {
return true;
}
final boolean isInIwlan = (networkRegWlan.getRegistrationState()
== NetworkRegistrationInfo.REGISTRATION_STATE_HOME)
|| (networkRegWlan.getRegistrationState()
== NetworkRegistrationInfo.REGISTRATION_STATE_ROAMING);
return !isInIwlan;
}
/**
* Returns a bitmap with rounded corner.
*
* @param context application context.
* @param source bitmap to apply round corner.
* @param cornerRadius corner radius value.
*/
public static Bitmap convertCornerRadiusBitmap(@NonNull Context context,
@NonNull Bitmap source, @NonNull float cornerRadius) {
final Bitmap roundedBitmap = Bitmap.createBitmap(source.getWidth(), source.getHeight(),
Bitmap.Config.ARGB_8888);
final RoundedBitmapDrawable drawable =
RoundedBitmapDrawableFactory.create(context.getResources(), source);
drawable.setAntiAlias(true);
drawable.setCornerRadius(cornerRadius);
final Canvas canvas = new Canvas(roundedBitmap);
drawable.setBounds(0, 0, canvas.getWidth(), canvas.getHeight());
drawable.draw(canvas);
return roundedBitmap;
}
/**
* Returns the WifiInfo for the underlying WiFi network of the VCN network, returns null if the
* input NetworkCapabilities is not for a VCN network with underlying WiFi network.
*
* TODO(b/238425913): Move this method to be inside systemui not settingslib once we've migrated
* off of {@link WifiStatusTracker} and {@link NetworkControllerImpl}.
*
* @param networkCapabilities NetworkCapabilities of the network.
*/
@Nullable
public static WifiInfo tryGetWifiInfoForVcn(NetworkCapabilities networkCapabilities) {
if (networkCapabilities.getTransportInfo() == null
|| !(networkCapabilities.getTransportInfo() instanceof VcnTransportInfo)) {
return null;
}
VcnTransportInfo vcnTransportInfo =
(VcnTransportInfo) networkCapabilities.getTransportInfo();
return vcnTransportInfo.getWifiInfo();
}
/** Whether there is any incompatible chargers in the current UsbPort? */
public static boolean containsIncompatibleChargers(Context context, String tag) {
// Avoid the caller doesn't have permission to read the "Settings.Secure" data.
try {
// Whether the incompatible charger warning is disabled or not
if (Settings.Secure.getInt(context.getContentResolver(),
INCOMPATIBLE_CHARGER_WARNING_DISABLED, 0) == 1) {
Log.d(tag, "containsIncompatibleChargers: disabled");
return false;
}
} catch (Exception e) {
Log.e(tag, "containsIncompatibleChargers()", e);
return false;
}
final List