blob: f9359a2f5911a6e42e89ae737005d48c2380d6b9 [file] [log] [blame]
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -08001/**
2 * Copyright (C) 2007 Google Inc.
3 *
4 * Licensed under the Apache License, Version 2.0 (the "License"); you may not
5 * use this file except in compliance with the License. You may obtain a copy
6 * of the License at
7 *
8 * http://www.apache.org/licenses/LICENSE-2.0
9 *
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
12 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
13 * License for the specific language governing permissions and limitations
14 * under the License.
15 */
16
17package com.android.settings;
18
Daniel Nishi422e7c32017-02-09 16:07:22 -080019import static android.content.Intent.EXTRA_USER;
20import static android.content.Intent.EXTRA_USER_ID;
21import static android.text.format.DateUtils.FORMAT_ABBREV_MONTH;
22import static android.text.format.DateUtils.FORMAT_SHOW_DATE;
23
Alexandra Gherghina7d748c02014-06-27 12:33:42 +010024import android.annotation.Nullable;
tmfangaed8f362019-03-18 16:56:09 +080025import android.app.ActionBar;
26import android.app.Activity;
Amith Yamasaniae697552011-09-27 11:33:17 -070027import android.app.ActivityManager;
Sudheer Shankabc956302015-04-09 12:19:53 +010028import android.app.AppGlobals;
Alexandra Gherghina1eb3f312014-06-10 14:01:10 +010029import android.app.IActivityManager;
Rubin Xu3231afe2016-08-24 10:15:07 +010030import android.app.KeyguardManager;
Sudheer Shankabc956302015-04-09 12:19:53 +010031import android.app.admin.DevicePolicyManager;
Daniel Nishi31027da2017-01-19 14:03:57 -080032import android.content.ActivityNotFoundException;
Fabrice Di Meglio8b2ea392015-01-23 19:03:22 -080033import android.content.ComponentName;
Amith Yamasani8d40fac2012-10-23 15:36:16 -070034import android.content.ContentResolver;
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -080035import android.content.Context;
36import android.content.Intent;
Fabrice Di Meglio8b2ea392015-01-23 19:03:22 -080037import android.content.IntentFilter;
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -080038import android.content.pm.ApplicationInfo;
Sudheer Shankabc956302015-04-09 12:19:53 +010039import android.content.pm.IPackageManager;
Christopher Tatea08a2252015-07-01 16:52:43 -070040import android.content.pm.IntentFilterVerificationInfo;
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -080041import android.content.pm.PackageManager;
Jason Monk75199542016-05-06 15:09:32 -040042import android.content.pm.PackageManager.NameNotFoundException;
Jeff Sharkeyb654cbb2011-08-18 11:59:19 -070043import android.content.pm.ResolveInfo;
Amith Yamasaniae47ef42012-09-16 17:53:35 -070044import android.content.pm.UserInfo;
Jason Chiu8ac1e4d2020-05-11 16:13:47 +080045import android.content.res.Configuration;
Anders Hammar1b2dd9032010-04-08 10:03:50 +020046import android.content.res.Resources;
Jason Monkb5aa73f2015-03-31 12:59:33 -040047import android.content.res.TypedArray;
Amith Yamasaniae47ef42012-09-16 17:53:35 -070048import android.database.Cursor;
Amith Yamasanif34a85d2012-09-17 18:31:45 -070049import android.graphics.Bitmap;
Felipe Lemebd884502017-09-15 18:16:21 -070050import android.graphics.Canvas;
51import android.graphics.drawable.BitmapDrawable;
52import android.graphics.drawable.Drawable;
Phil Weaver5a3e02d2018-03-08 17:38:46 -080053import android.graphics.drawable.VectorDrawable;
Kevin Chyn4882e872018-06-25 17:58:31 -070054import android.hardware.face.FaceManager;
Jeff Sharkeyab508072016-10-11 14:25:22 -060055import android.hardware.fingerprint.FingerprintManager;
Amith Yamasanic06d4c42011-02-25 14:35:20 -080056import android.net.ConnectivityManager;
57import android.net.LinkProperties;
Jaewoong Jungc260e6d2016-10-13 14:21:52 -070058import android.net.Network;
Jaewoong Jungc260e6d2016-10-13 14:21:52 -070059import android.net.wifi.WifiManager;
Amith Yamasania4379d62011-07-22 10:34:58 -070060import android.os.BatteryManager;
Yanting Yang96127fe2020-03-20 12:04:09 +080061import android.os.Binder;
Ng Zhi Anb97bdc32019-02-01 12:39:31 -080062import android.os.Build;
Anders Hammar1b2dd9032010-04-08 10:03:50 +020063import android.os.Bundle;
Alexandra Gherghina1eb3f312014-06-10 14:01:10 +010064import android.os.IBinder;
Jason Monkb45e27b2015-05-20 13:35:43 -040065import android.os.INetworkManagementService;
Alexandra Gherghina1eb3f312014-06-10 14:01:10 +010066import android.os.RemoteException;
Jason Monkb45e27b2015-05-20 13:35:43 -040067import android.os.ServiceManager;
Amith Yamasaniae47ef42012-09-16 17:53:35 -070068import android.os.UserHandle;
69import android.os.UserManager;
Fabrice Di Megliodff3faa2015-02-27 11:14:11 -080070import android.os.storage.StorageManager;
Daniel Nishi9f60f422017-02-15 15:25:48 -080071import android.os.storage.VolumeInfo;
Jeff Sharkeyb654cbb2011-08-18 11:59:19 -070072import android.preference.PreferenceFrameLayout;
Amith Yamasani8d40fac2012-10-23 15:36:16 -070073import android.provider.ContactsContract.CommonDataKinds;
Amith Yamasaniae47ef42012-09-16 17:53:35 -070074import android.provider.ContactsContract.Contacts;
Amith Yamasani8d40fac2012-10-23 15:36:16 -070075import android.provider.ContactsContract.Data;
Amith Yamasaniae47ef42012-09-16 17:53:35 -070076import android.provider.ContactsContract.Profile;
Amith Yamasani8d40fac2012-10-23 15:36:16 -070077import android.provider.ContactsContract.RawContacts;
markchien1dd1d792019-01-11 16:18:20 +080078import android.telephony.SubscriptionManager;
Amith Yamasani60133dd2010-09-11 14:17:31 -070079import android.telephony.TelephonyManager;
Julia Reynoldsce25af42015-07-08 16:56:31 -040080import android.text.Spannable;
81import android.text.SpannableString;
Anders Hammar1b2dd9032010-04-08 10:03:50 +020082import android.text.TextUtils;
Jason Monkb37e2882016-01-11 14:27:20 -050083import android.text.format.DateUtils;
Julia Reynoldsce25af42015-07-08 16:56:31 -040084import android.text.style.TtsSpan;
Christopher Tatea08a2252015-07-01 16:52:43 -070085import android.util.ArraySet;
jackqdyuleifde637f2018-01-02 14:51:01 -080086import android.util.IconDrawableFactory;
Alexandra Gherghina1eb3f312014-06-10 14:01:10 +010087import android.util.Log;
Zoltan Szatmary-Ban3af2e4c2014-12-19 17:17:23 +000088import android.view.LayoutInflater;
Jeff Sharkeyb654cbb2011-08-18 11:59:19 -070089import android.view.View;
90import android.view.ViewGroup;
PMS2263a05602017-06-14 07:10:15 +000091import android.widget.EditText;
Jeff Sharkeyb654cbb2011-08-18 11:59:19 -070092import android.widget.ListView;
93import android.widget.TabWidget;
Fan Zhangcc335d92016-09-29 14:37:14 -070094
Tim Pengdf467882020-06-24 13:10:01 +080095import androidx.annotation.NonNull;
Fan Zhang23f8d592018-08-28 15:11:40 -070096import androidx.annotation.StringRes;
Jason Chiuc78c54a2019-02-13 16:07:57 +080097import androidx.core.graphics.drawable.IconCompat;
Tim Pengdf467882020-06-24 13:10:01 +080098import androidx.core.graphics.drawable.RoundedBitmapDrawable;
99import androidx.core.graphics.drawable.RoundedBitmapDrawableFactory;
Fan Zhang23f8d592018-08-28 15:11:40 -0700100import androidx.fragment.app.Fragment;
tmfangaed8f362019-03-18 16:56:09 +0800101import androidx.lifecycle.Lifecycle;
Fan Zhang23f8d592018-08-28 15:11:40 -0700102import androidx.preference.Preference;
103import androidx.preference.PreferenceGroup;
104
Ricky Wai616342b2016-04-13 10:40:22 +0100105import com.android.internal.app.UnlaunchableAppActivity;
Ricky Wai72500162016-06-07 16:54:25 +0100106import com.android.internal.util.ArrayUtils;
Rubin Xu3231afe2016-08-24 10:15:07 +0100107import com.android.internal.widget.LockPatternUtils;
Raff Tsaiafd494d2019-10-16 15:25:21 +0800108import com.android.settings.dashboard.profileselector.ProfileFragmentBridge;
Raff Tsai84327f62019-11-15 11:02:25 +0800109import com.android.settings.dashboard.profileselector.ProfileSelectFragment;
Jeff Sharkey219ec912017-12-19 14:57:39 -0700110import com.android.settings.password.ChooseLockSettingsHelper;
tmfangaed8f362019-03-18 16:56:09 +0800111import com.android.settingslib.widget.ActionBarShadowController;
Daisuke Miyakawaa2633d02010-09-15 20:09:12 -0700112
Amith Yamasanic06d4c42011-02-25 14:35:20 -0800113import java.net.InetAddress;
114import java.util.Iterator;
Daisuke Miyakawaa2633d02010-09-15 20:09:12 -0700115import java.util.List;
Jean Chalard71ad1f42011-05-12 15:06:16 +0900116import java.util.Locale;
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800117
Jason Monk27985e12016-01-08 14:13:05 -0500118public final class Utils extends com.android.settingslib.Utils {
119
Alexandra Gherghina1eb3f312014-06-10 14:01:10 +0100120 private static final String TAG = "Settings";
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100121
Andras Kloczl106431e2020-05-18 14:53:07 +0100122 public static final String FILE_PROVIDER_AUTHORITY = "com.android.settings.files";
123
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800124 /**
125 * Set the preference's title to the matching activity's label.
126 */
127 public static final int UPDATE_PREFERENCE_FLAG_SET_TITLE_TO_MATCHING_ACTIVITY = 1;
128
Fan Zhangc3fd2892019-01-29 16:00:19 -0800129 public static final String SETTINGS_PACKAGE_NAME = "com.android.settings";
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100130
Jason Monkbeb171d2015-05-21 15:24:37 -0400131 public static final String OS_PKG = "os";
132
Anders Hammar1b2dd9032010-04-08 10:03:50 +0200133 /**
Svet Ganov864765f2019-04-05 19:00:05 -0700134 * Whether to disable the new device identifier access restrictions.
135 */
136 public static final String PROPERTY_DEVICE_IDENTIFIER_ACCESS_RESTRICTIONS_DISABLED =
137 "device_identifier_access_restrictions_disabled";
138
139 /**
Joel Galenson2118f8a2019-05-31 07:54:20 -0700140 * Whether to show the Permissions Hub.
141 */
142 public static final String PROPERTY_PERMISSIONS_HUB_ENABLED = "permissions_hub_enabled";
143
144 /**
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800145 * Finds a matching activity for a preference's intent. If a matching
146 * activity is not found, it will remove the preference.
Ying Wanga7188322010-01-04 18:45:10 -0800147 *
Sunny Shao7e866b62019-08-09 11:42:04 +0800148 * @param context The context.
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800149 * @param parentPreferenceGroup The preference group that contains the
Sunny Shao7e866b62019-08-09 11:42:04 +0800150 * preference whose intent is being resolved.
151 * @param preferenceKey The key of the preference whose intent is being
152 * resolved.
153 * @param flags 0 or one or more of
154 * {@link #UPDATE_PREFERENCE_FLAG_SET_TITLE_TO_MATCHING_ACTIVITY}
155 * .
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800156 * @return Whether an activity was found. If false, the preference was
Sunny Shao7e866b62019-08-09 11:42:04 +0800157 * removed.
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800158 */
159 public static boolean updatePreferenceToSpecificActivityOrRemove(Context context,
160 PreferenceGroup parentPreferenceGroup, String preferenceKey, int flags) {
Ying Wanga7188322010-01-04 18:45:10 -0800161
Bonian Chen5e65da02019-11-08 07:40:35 +0800162 final Preference preference = parentPreferenceGroup.findPreference(preferenceKey);
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800163 if (preference == null) {
164 return false;
165 }
Ying Wanga7188322010-01-04 18:45:10 -0800166
Bonian Chen5e65da02019-11-08 07:40:35 +0800167 final Intent intent = preference.getIntent();
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800168 if (intent != null) {
169 // Find the activity that is in the system image
Bonian Chen5e65da02019-11-08 07:40:35 +0800170 final PackageManager pm = context.getPackageManager();
171 final List<ResolveInfo> list = pm.queryIntentActivities(intent, 0);
172 final int listSize = list.size();
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800173 for (int i = 0; i < listSize; i++) {
Bonian Chen5e65da02019-11-08 07:40:35 +0800174 final ResolveInfo resolveInfo = list.get(i);
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800175 if ((resolveInfo.activityInfo.applicationInfo.flags & ApplicationInfo.FLAG_SYSTEM)
176 != 0) {
Ying Wanga7188322010-01-04 18:45:10 -0800177
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800178 // Replace the intent with this specific activity
179 preference.setIntent(new Intent().setClassName(
180 resolveInfo.activityInfo.packageName,
181 resolveInfo.activityInfo.name));
182
183 if ((flags & UPDATE_PREFERENCE_FLAG_SET_TITLE_TO_MATCHING_ACTIVITY) != 0) {
184 // Set the preference title to the activity's label
185 preference.setTitle(resolveInfo.loadLabel(pm));
186 }
Ying Wanga7188322010-01-04 18:45:10 -0800187
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800188 return true;
189 }
190 }
191 }
192
193 // Did not find a matching activity, so remove the preference
194 parentPreferenceGroup.removePreference(preference);
Ying Wanga7188322010-01-04 18:45:10 -0800195
Shuhrat Dehkanov7dc567a2012-04-23 01:59:56 +0900196 return false;
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800197 }
Ying Wanga7188322010-01-04 18:45:10 -0800198
Anders Hammar1b2dd9032010-04-08 10:03:50 +0200199 /**
Ying Wanga7188322010-01-04 18:45:10 -0800200 * Returns true if Monkey is running.
201 */
202 public static boolean isMonkeyRunning() {
Amith Yamasaniae697552011-09-27 11:33:17 -0700203 return ActivityManager.isUserAMonkey();
Ying Wanga7188322010-01-04 18:45:10 -0800204 }
Amith Yamasani60133dd2010-09-11 14:17:31 -0700205
206 /**
207 * Returns whether the device is voice-capable (meaning, it is also a phone).
208 */
209 public static boolean isVoiceCapable(Context context) {
Bonian Chen5e65da02019-11-08 07:40:35 +0800210 final TelephonyManager telephony =
Amith Yamasani60133dd2010-09-11 14:17:31 -0700211 (TelephonyManager) context.getSystemService(Context.TELEPHONY_SERVICE);
212 return telephony != null && telephony.isVoiceCapable();
213 }
Amith Yamasani0f85c482011-02-23 17:19:11 -0800214
Amith Yamasanic06d4c42011-02-25 14:35:20 -0800215 /**
216 * Returns the WIFI IP Addresses, if any, taking into account IPv4 and IPv6 style addresses.
217 * @param context the application context
Lorenzo Colitti769f0692013-08-01 17:30:07 +0900218 * @return the formatted and newline-separated IP addresses, or null if none.
Amith Yamasanic06d4c42011-02-25 14:35:20 -0800219 */
220 public static String getWifiIpAddresses(Context context) {
Bonian Chen5e65da02019-11-08 07:40:35 +0800221 final WifiManager wifiManager = context.getSystemService(WifiManager.class);
222 final Network currentNetwork = wifiManager.getCurrentNetwork();
Jaewoong Jungc260e6d2016-10-13 14:21:52 -0700223 if (currentNetwork != null) {
Bonian Chen5e65da02019-11-08 07:40:35 +0800224 final ConnectivityManager cm = (ConnectivityManager)
Sunny Shao7e866b62019-08-09 11:42:04 +0800225 context.getSystemService(Context.CONNECTIVITY_SERVICE);
Bonian Chen5e65da02019-11-08 07:40:35 +0800226 final LinkProperties prop = cm.getLinkProperties(currentNetwork);
Jaewoong Jungc260e6d2016-10-13 14:21:52 -0700227 return formatIpAddresses(prop);
228 }
229 return null;
Amith Yamasani6822b742011-10-17 16:41:00 -0700230 }
231
Amith Yamasani6822b742011-10-17 16:41:00 -0700232 private static String formatIpAddresses(LinkProperties prop) {
Amith Yamasanic06d4c42011-02-25 14:35:20 -0800233 if (prop == null) return null;
Bonian Chen5e65da02019-11-08 07:40:35 +0800234 final Iterator<InetAddress> iter = prop.getAllAddresses().iterator();
Amith Yamasanic06d4c42011-02-25 14:35:20 -0800235 // If there are no entries, return null
236 if (!iter.hasNext()) return null;
237 // Concatenate all available addresses, comma separated
238 String addresses = "";
239 while (iter.hasNext()) {
240 addresses += iter.next().getHostAddress();
Lorenzo Colitti769f0692013-08-01 17:30:07 +0900241 if (iter.hasNext()) addresses += "\n";
Amith Yamasanic06d4c42011-02-25 14:35:20 -0800242 }
243 return addresses;
244 }
Jean Chalard71ad1f42011-05-12 15:06:16 +0900245
246 public static Locale createLocaleFromString(String localeStr) {
247 // TODO: is there a better way to actually construct a locale that will match?
248 // The main problem is, on top of Java specs, locale.toString() and
249 // new Locale(locale.toString()).toString() do not return equal() strings in
250 // many cases, because the constructor takes the only string as the language
251 // code. So : new Locale("en", "US").toString() => "en_US"
252 // And : new Locale("en_US").toString() => "en_us"
Sunny Shao7e866b62019-08-09 11:42:04 +0800253 if (null == localeStr)
Jean Chalard71ad1f42011-05-12 15:06:16 +0900254 return Locale.getDefault();
Bonian Chen5e65da02019-11-08 07:40:35 +0800255 final String[] brokenDownLocale = localeStr.split("_", 3);
Jean Chalard71ad1f42011-05-12 15:06:16 +0900256 // split may not return a 0-length array.
257 if (1 == brokenDownLocale.length) {
258 return new Locale(brokenDownLocale[0]);
259 } else if (2 == brokenDownLocale.length) {
260 return new Locale(brokenDownLocale[0], brokenDownLocale[1]);
261 } else {
262 return new Locale(brokenDownLocale[0], brokenDownLocale[1], brokenDownLocale[2]);
263 }
264 }
Amith Yamasania4379d62011-07-22 10:34:58 -0700265
Jaewan Kima3fe77b2013-06-04 21:17:40 +0900266 public static boolean isBatteryPresent(Intent batteryChangedIntent) {
267 return batteryChangedIntent.getBooleanExtra(BatteryManager.EXTRA_PRESENT, true);
268 }
269
Mill Chenad99e2e2020-10-21 16:32:56 +0800270 /**
271 * Return true if battery is present.
272 */
273 public static boolean isBatteryPresent(Context context) {
274 Intent batteryBroadcast = context.registerReceiver(null /* receiver */,
275 new IntentFilter(Intent.ACTION_BATTERY_CHANGED));
276 return isBatteryPresent(batteryBroadcast);
277 }
278
Amith Yamasania4379d62011-07-22 10:34:58 -0700279 public static String getBatteryPercentage(Intent batteryChangedIntent) {
Elliott Hughes7253df32014-09-02 17:10:14 -0700280 return formatPercentage(getBatteryLevel(batteryChangedIntent));
Dianne Hackborn525f2bd2014-04-29 11:24:06 -0700281 }
282
Jeff Sharkeyb654cbb2011-08-18 11:59:19 -0700283 /**
284 * Prepare a custom preferences layout, moving padding to {@link ListView}
285 * when outside scrollbars are requested. Usually used to display
286 * {@link ListView} and {@link TabWidget} with correct padding.
287 */
Jeff Sharkey5d706792011-09-08 18:57:17 -0700288 public static void prepareCustomPreferencesList(
Jeff Sharkey97d07fa2012-11-30 12:36:53 -0800289 ViewGroup parent, View child, View list, boolean ignoreSidePadding) {
Jeff Sharkeyb654cbb2011-08-18 11:59:19 -0700290 final boolean movePadding = list.getScrollBarStyle() == View.SCROLLBARS_OUTSIDE_OVERLAY;
Fabrice Di Meglio97a18c82014-07-18 19:12:36 -0700291 if (movePadding) {
Jeff Sharkeyb654cbb2011-08-18 11:59:19 -0700292 final Resources res = list.getResources();
Jeff Sharkeyb654cbb2011-08-18 11:59:19 -0700293 final int paddingBottom = res.getDimensionPixelSize(
294 com.android.internal.R.dimen.preference_fragment_padding_bottom);
Jeff Sharkey5d706792011-09-08 18:57:17 -0700295
Fabrice Di Meglio97a18c82014-07-18 19:12:36 -0700296 if (parent instanceof PreferenceFrameLayout) {
297 ((PreferenceFrameLayout.LayoutParams) child.getLayoutParams()).removeBorders = true;
Fabrice Di Meglio97a18c82014-07-18 19:12:36 -0700298 }
Doris Lingc5a1b4f2019-02-20 16:33:24 -0800299 list.setPaddingRelative(0 /* start */, 0 /* top */, 0 /* end */, paddingBottom);
Jeff Sharkeyb654cbb2011-08-18 11:59:19 -0700300 }
301 }
Jeff Sharkeya83a24f2011-09-16 01:52:39 -0700302
Fabrice Di Meglio0f4a7792014-07-28 18:25:14 -0700303 public static void forceCustomPadding(View view, boolean additive) {
Fabrice Di Meglio38ba9a22014-07-18 19:58:50 -0700304 final Resources res = view.getResources();
Fabrice Di Meglio0f4a7792014-07-28 18:25:14 -0700305
Doris Lingc5a1b4f2019-02-20 16:33:24 -0800306 final int paddingStart = additive ? view.getPaddingStart() : 0;
307 final int paddingEnd = additive ? view.getPaddingEnd() : 0;
Fabrice Di Meglio38ba9a22014-07-18 19:58:50 -0700308 final int paddingBottom = res.getDimensionPixelSize(
309 com.android.internal.R.dimen.preference_fragment_padding_bottom);
310
Fabrice Di Meglio0f4a7792014-07-28 18:25:14 -0700311 view.setPaddingRelative(paddingStart, 0, paddingEnd, paddingBottom);
Fabrice Di Meglio38ba9a22014-07-18 19:58:50 -0700312 }
313
Amith Yamasani8d40fac2012-10-23 15:36:16 -0700314 public static String getMeProfileName(Context context, boolean full) {
315 if (full) {
316 return getProfileDisplayName(context);
317 } else {
318 return getShorterNameIfPossible(context);
Amith Yamasaniae47ef42012-09-16 17:53:35 -0700319 }
Amith Yamasani8d40fac2012-10-23 15:36:16 -0700320 }
321
322 private static String getShorterNameIfPossible(Context context) {
323 final String given = getLocalProfileGivenName(context);
324 return !TextUtils.isEmpty(given) ? given : getProfileDisplayName(context);
325 }
326
327 private static String getLocalProfileGivenName(Context context) {
328 final ContentResolver cr = context.getContentResolver();
329
330 // Find the raw contact ID for the local ME profile raw contact.
331 final long localRowProfileId;
332 final Cursor localRawProfile = cr.query(
333 Profile.CONTENT_RAW_CONTACTS_URI,
Sunny Shao7e866b62019-08-09 11:42:04 +0800334 new String[] {RawContacts._ID},
Amith Yamasani8d40fac2012-10-23 15:36:16 -0700335 RawContacts.ACCOUNT_TYPE + " IS NULL AND " +
336 RawContacts.ACCOUNT_NAME + " IS NULL",
337 null, null);
338 if (localRawProfile == null) return null;
Amith Yamasaniae47ef42012-09-16 17:53:35 -0700339
340 try {
Amith Yamasani8d40fac2012-10-23 15:36:16 -0700341 if (!localRawProfile.moveToFirst()) {
342 return null;
Amith Yamasaniae47ef42012-09-16 17:53:35 -0700343 }
Amith Yamasani8d40fac2012-10-23 15:36:16 -0700344 localRowProfileId = localRawProfile.getLong(0);
Amith Yamasaniae47ef42012-09-16 17:53:35 -0700345 } finally {
Amith Yamasani8d40fac2012-10-23 15:36:16 -0700346 localRawProfile.close();
Amith Yamasaniae47ef42012-09-16 17:53:35 -0700347 }
Amith Yamasani8d40fac2012-10-23 15:36:16 -0700348
349 // Find the structured name for the raw contact.
350 final Cursor structuredName = cr.query(
351 Profile.CONTENT_URI.buildUpon().appendPath(Contacts.Data.CONTENT_DIRECTORY).build(),
Sunny Shao7e866b62019-08-09 11:42:04 +0800352 new String[] {CommonDataKinds.StructuredName.GIVEN_NAME,
353 CommonDataKinds.StructuredName.FAMILY_NAME},
Amith Yamasani8d40fac2012-10-23 15:36:16 -0700354 Data.RAW_CONTACT_ID + "=" + localRowProfileId,
355 null, null);
356 if (structuredName == null) return null;
357
358 try {
359 if (!structuredName.moveToFirst()) {
360 return null;
361 }
362 String partialName = structuredName.getString(0);
363 if (TextUtils.isEmpty(partialName)) {
364 partialName = structuredName.getString(1);
365 }
366 return partialName;
367 } finally {
368 structuredName.close();
369 }
370 }
371
372 private static final String getProfileDisplayName(Context context) {
373 final ContentResolver cr = context.getContentResolver();
374 final Cursor profile = cr.query(Profile.CONTENT_URI,
Sunny Shao7e866b62019-08-09 11:42:04 +0800375 new String[] {Profile.DISPLAY_NAME}, null, null, null);
Amith Yamasani8d40fac2012-10-23 15:36:16 -0700376 if (profile == null) return null;
377
378 try {
379 if (!profile.moveToFirst()) {
380 return null;
381 }
382 return profile.getString(0);
383 } finally {
384 profile.close();
385 }
Amith Yamasaniae47ef42012-09-16 17:53:35 -0700386 }
Amith Yamasani9627a8e2012-09-23 12:54:14 -0700387
Amith Yamasani9627a8e2012-09-23 12:54:14 -0700388 public static boolean hasMultipleUsers(Context context) {
Bonian Chenf399bd12020-01-09 14:50:03 +0800389 return context.getSystemService(UserManager.class)
Amith Yamasani9627a8e2012-09-23 12:54:14 -0700390 .getUsers().size() > 1;
391 }
Fabrice Di Meglio769630c2014-04-24 14:48:48 -0700392
393 /**
Esteban Talavera9b86e9c2017-05-30 16:48:08 +0100394 * Returns the managed profile of the current user or {@code null} if none is found or a profile
395 * exists but it is disabled.
Alexandra Gherghina3939cd72014-06-04 10:02:55 +0100396 */
397 public static UserHandle getManagedProfile(UserManager userManager) {
Bonian Chen5e65da02019-11-08 07:40:35 +0800398 final List<UserHandle> userProfiles = userManager.getUserProfiles();
Aarthi Balachanderd0f83592018-07-10 17:04:53 -0700399 for (UserHandle profile : userProfiles) {
Alexandra Gherghina3939cd72014-06-04 10:02:55 +0100400 if (profile.getIdentifier() == userManager.getUserHandle()) {
401 continue;
402 }
403 final UserInfo userInfo = userManager.getUserInfo(profile.getIdentifier());
404 if (userInfo.isManagedProfile()) {
405 return profile;
406 }
407 }
408 return null;
409 }
410
411 /**
Esteban Talavera9b86e9c2017-05-30 16:48:08 +0100412 * Returns the managed profile of the current user or {@code null} if none is found. Unlike
413 * {@link #getManagedProfile} this method returns enabled and disabled managed profiles.
414 */
415 public static UserHandle getManagedProfileWithDisabled(UserManager userManager) {
416 // TODO: Call getManagedProfileId from here once Robolectric supports
417 // API level 24 and UserManager.getProfileIdsWithDisabled can be Mocked (to avoid having
418 // yet another implementation that loops over user profiles in this method). In the meantime
419 // we need to use UserManager.getProfiles that is available on API 23 (the one currently
420 // used for Settings Robolectric tests).
421 final int myUserId = UserHandle.myUserId();
Bonian Chen5e65da02019-11-08 07:40:35 +0800422 final List<UserInfo> profiles = userManager.getProfiles(myUserId);
Esteban Talavera9b86e9c2017-05-30 16:48:08 +0100423 final int count = profiles.size();
424 for (int i = 0; i < count; i++) {
425 final UserInfo profile = profiles.get(i);
426 if (profile.isManagedProfile()
427 && profile.getUserHandle().getIdentifier() != myUserId) {
428 return profile.getUserHandle();
429 }
430 }
431 return null;
432 }
433
434 /**
Clara Bayarri462cce12016-02-18 12:09:21 +0000435 * Retrieves the id for the given user's managed profile.
436 *
437 * @return the managed profile id or UserHandle.USER_NULL if there is none.
438 */
439 public static int getManagedProfileId(UserManager um, int parentUserId) {
Bonian Chen5e65da02019-11-08 07:40:35 +0800440 final int[] profileIds = um.getProfileIdsWithDisabled(parentUserId);
Fyodor Kupolov4a4af5a2016-04-07 16:46:18 -0700441 for (int profileId : profileIds) {
442 if (profileId != parentUserId) {
443 return profileId;
Clara Bayarri462cce12016-02-18 12:09:21 +0000444 }
445 }
446 return UserHandle.USER_NULL;
447 }
448
449 /**
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100450 * Returns the target user for a Settings activity.
Tony Mak8f41b9b2016-11-23 11:36:18 +0000451 * <p>
452 * User would be retrieved in this order:
453 * <ul>
454 * <li> If this activity is launched from other user, return that user id.
455 * <li> If this is launched from the Settings app in same user, return the user contained as an
Sunny Shao7e866b62019-08-09 11:42:04 +0800456 * extra in the arguments or intent extras.
Tony Mak8f41b9b2016-11-23 11:36:18 +0000457 * <li> Otherwise, return UserHandle.myUserId().
458 * </ul>
459 * <p>
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100460 * Note: This is secure in the sense that it only returns a target user different to the current
461 * one if the app launching this activity is the Settings app itself, running in the same user
462 * or in one that is in the same profile group, or if the user id is provided by the system.
Alexandra Gherghina1eb3f312014-06-10 14:01:10 +0100463 */
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100464 public static UserHandle getSecureTargetUser(IBinder activityToken,
Tony Mak8f41b9b2016-11-23 11:36:18 +0000465 UserManager um, @Nullable Bundle arguments, @Nullable Bundle intentExtras) {
Bonian Chen5e65da02019-11-08 07:40:35 +0800466 final UserHandle currentUser = new UserHandle(UserHandle.myUserId());
467 final IActivityManager am = ActivityManager.getService();
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100468 try {
Bonian Chen5e65da02019-11-08 07:40:35 +0800469 final String launchedFromPackage = am.getLaunchedFromPackage(activityToken);
470 final boolean launchedFromSettingsApp =
471 SETTINGS_PACKAGE_NAME.equals(launchedFromPackage);
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100472
Bonian Chen5e65da02019-11-08 07:40:35 +0800473 final UserHandle launchedFromUser = new UserHandle(UserHandle.getUserId(
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100474 am.getLaunchedFromUid(activityToken)));
475 if (launchedFromUser != null && !launchedFromUser.equals(currentUser)) {
476 // Check it's secure
477 if (isProfileOf(um, launchedFromUser)) {
478 return launchedFromUser;
479 }
480 }
Bonian Chen5e65da02019-11-08 07:40:35 +0800481 final UserHandle extrasUser = getUserHandleFromBundle(intentExtras);
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100482 if (extrasUser != null && !extrasUser.equals(currentUser)) {
483 // Check it's secure
484 if (launchedFromSettingsApp && isProfileOf(um, extrasUser)) {
485 return extrasUser;
486 }
487 }
Bonian Chen5e65da02019-11-08 07:40:35 +0800488 final UserHandle argumentsUser = getUserHandleFromBundle(arguments);
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100489 if (argumentsUser != null && !argumentsUser.equals(currentUser)) {
490 // Check it's secure
491 if (launchedFromSettingsApp && isProfileOf(um, argumentsUser)) {
492 return argumentsUser;
493 }
494 }
495 } catch (RemoteException e) {
496 // Should not happen
497 Log.v(TAG, "Could not talk to activity manager.", e);
498 }
499 return currentUser;
Tony Mak8f41b9b2016-11-23 11:36:18 +0000500 }
501
502 /**
503 * Lookup both {@link Intent#EXTRA_USER} and {@link Intent#EXTRA_USER_ID} in the bundle
504 * and return the {@link UserHandle} object. Return {@code null} if nothing is found.
505 */
Sunny Shao7e866b62019-08-09 11:42:04 +0800506 private static @Nullable UserHandle getUserHandleFromBundle(Bundle bundle) {
Tony Mak8f41b9b2016-11-23 11:36:18 +0000507 if (bundle == null) {
508 return null;
509 }
510 final UserHandle user = bundle.getParcelable(EXTRA_USER);
511 if (user != null) {
512 return user;
513 }
514 final int userId = bundle.getInt(EXTRA_USER_ID, -1);
515 if (userId != -1) {
516 return UserHandle.of(userId);
517 }
518 return null;
519 }
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100520
Sunny Shao7e866b62019-08-09 11:42:04 +0800521 /**
522 * Returns true if the user provided is in the same profiles group as the current user.
523 */
524 private static boolean isProfileOf(UserManager um, UserHandle otherUser) {
525 if (um == null || otherUser == null) return false;
526 return (UserHandle.myUserId() == otherUser.getIdentifier())
527 || um.getUserProfiles().contains(otherUser);
528 }
Amith Yamasani51c6dac2014-07-02 00:06:37 +0530529
Alexandra Gherghina95b86a52014-07-24 19:13:25 +0100530 /**
Amith Yamasani45f86232014-11-19 17:12:46 -0800531 * Queries for the UserInfo of a user. Returns null if the user doesn't exist (was removed).
532 * @param userManager Instance of UserManager
Sunny Shao7e866b62019-08-09 11:42:04 +0800533 * @param checkUser The user to check the existence of.
Amith Yamasani45f86232014-11-19 17:12:46 -0800534 * @return UserInfo of the user or null for non-existent user.
535 */
536 public static UserInfo getExistingUser(UserManager userManager, UserHandle checkUser) {
Colin Cross38fa1852020-08-27 04:12:26 +0000537 final List<UserInfo> users = userManager.getAliveUsers();
Amith Yamasani45f86232014-11-19 17:12:46 -0800538 final int checkUserId = checkUser.getIdentifier();
539 for (UserInfo user : users) {
540 if (user.id == checkUserId) {
541 return user;
542 }
543 }
544 return null;
545 }
546
Zoltan Szatmary-Ban3af2e4c2014-12-19 17:17:23 +0000547 public static View inflateCategoryHeader(LayoutInflater inflater, ViewGroup parent) {
548 final TypedArray a = inflater.getContext().obtainStyledAttributes(null,
549 com.android.internal.R.styleable.Preference,
550 com.android.internal.R.attr.preferenceCategoryStyle, 0);
551 final int resId = a.getResourceId(com.android.internal.R.styleable.Preference_layout,
552 0);
553 a.recycle();
554 return inflater.inflate(resId, parent, false);
555 }
556
Christopher Tatea08a2252015-07-01 16:52:43 -0700557 public static ArraySet<String> getHandledDomains(PackageManager pm, String packageName) {
Bonian Chen5e65da02019-11-08 07:40:35 +0800558 final List<IntentFilterVerificationInfo> iviList =
559 pm.getIntentFilterVerifications(packageName);
560 final List<IntentFilter> filters = pm.getAllIntentFilters(packageName);
Christopher Tatea08a2252015-07-01 16:52:43 -0700561
Bonian Chen5e65da02019-11-08 07:40:35 +0800562 final ArraySet<String> result = new ArraySet<>();
Fan Zhang4e540db2017-11-08 13:06:38 -0800563 if (iviList != null && iviList.size() > 0) {
Christopher Tatea08a2252015-07-01 16:52:43 -0700564 for (IntentFilterVerificationInfo ivi : iviList) {
565 for (String host : ivi.getDomains()) {
566 result.add(host);
567 }
568 }
569 }
570 if (filters != null && filters.size() > 0) {
571 for (IntentFilter filter : filters) {
Christopher Tateddaa1422015-07-16 16:00:49 -0700572 if (filter.hasCategory(Intent.CATEGORY_BROWSABLE)
573 && (filter.hasDataScheme(IntentFilter.SCHEME_HTTP) ||
Sunny Shao7e866b62019-08-09 11:42:04 +0800574 filter.hasDataScheme(IntentFilter.SCHEME_HTTPS))) {
Christopher Tatea08a2252015-07-01 16:52:43 -0700575 result.addAll(filter.getHostsList());
576 }
577 }
578 }
579 return result;
580 }
581
Sudheer Shankabc956302015-04-09 12:19:53 +0100582 /**
583 * Returns the application info of the currently installed MDM package.
584 */
585 public static ApplicationInfo getAdminApplicationInfo(Context context, int profileId) {
Bonian Chen5e65da02019-11-08 07:40:35 +0800586 final DevicePolicyManager dpm =
Sudheer Shankabc956302015-04-09 12:19:53 +0100587 (DevicePolicyManager) context.getSystemService(Context.DEVICE_POLICY_SERVICE);
Bonian Chen5e65da02019-11-08 07:40:35 +0800588 final ComponentName mdmPackage = dpm.getProfileOwnerAsUser(profileId);
Sudheer Shankabc956302015-04-09 12:19:53 +0100589 if (mdmPackage == null) {
590 return null;
591 }
Bonian Chen5e65da02019-11-08 07:40:35 +0800592 final String mdmPackageName = mdmPackage.getPackageName();
Sudheer Shankabc956302015-04-09 12:19:53 +0100593 try {
Bonian Chen5e65da02019-11-08 07:40:35 +0800594 final IPackageManager ipm = AppGlobals.getPackageManager();
595 final ApplicationInfo mdmApplicationInfo =
Sudheer Shankabc956302015-04-09 12:19:53 +0100596 ipm.getApplicationInfo(mdmPackageName, 0, profileId);
597 return mdmApplicationInfo;
598 } catch (RemoteException e) {
599 Log.e(TAG, "Error while retrieving application info for package " + mdmPackageName
600 + ", userId " + profileId, e);
601 return null;
602 }
603 }
Jason Monkb45e27b2015-05-20 13:35:43 -0400604
605 public static boolean isBandwidthControlEnabled() {
606 final INetworkManagementService netManager = INetworkManagementService.Stub
607 .asInterface(ServiceManager.getService(Context.NETWORKMANAGEMENT_SERVICE));
608 try {
609 return netManager.isBandwidthControlEnabled();
610 } catch (RemoteException e) {
611 return false;
612 }
613 }
Julia Reynoldsce25af42015-07-08 16:56:31 -0400614
615 /**
616 * Returns an accessible SpannableString.
Sunny Shao7e866b62019-08-09 11:42:04 +0800617 * @param displayText the text to display
Julia Reynoldsce25af42015-07-08 16:56:31 -0400618 * @param accessibileText the text text-to-speech engines should read
619 */
620 public static SpannableString createAccessibleSequence(CharSequence displayText,
621 String accessibileText) {
Bonian Chen5e65da02019-11-08 07:40:35 +0800622 final SpannableString str = new SpannableString(displayText);
Julia Reynoldsce25af42015-07-08 16:56:31 -0400623 str.setSpan(new TtsSpan.TextBuilder(accessibileText).build(), 0,
624 displayText.length(),
625 Spannable.SPAN_INCLUSIVE_INCLUSIVE);
626 return str;
627 }
Andres Morales7bdffd82015-08-04 16:55:00 -0700628
Clara Bayarrife432e82015-10-12 12:07:02 +0100629 /**
Jeff Sharkey219ec912017-12-19 14:57:39 -0700630 * Returns the user id present in the bundle with
631 * {@link Intent#EXTRA_USER_ID} if it belongs to the current user.
Clara Bayarrife432e82015-10-12 12:07:02 +0100632 *
Jeff Sharkey219ec912017-12-19 14:57:39 -0700633 * @throws SecurityException if the given userId does not belong to the
Sunny Shao7e866b62019-08-09 11:42:04 +0800634 * current user group.
Clara Bayarrife432e82015-10-12 12:07:02 +0100635 */
Benjamin Franz194300d2016-01-13 12:16:25 +0000636 public static int getUserIdFromBundle(Context context, Bundle bundle) {
Jeff Sharkey219ec912017-12-19 14:57:39 -0700637 return getUserIdFromBundle(context, bundle, false);
638 }
639
640 /**
641 * Returns the user id present in the bundle with
642 * {@link Intent#EXTRA_USER_ID} if it belongs to the current user.
643 *
644 * @param isInternal indicating if the caller is "internal" to the system,
Sunny Shao7e866b62019-08-09 11:42:04 +0800645 * meaning we're willing to trust extras like
Kevin Chynb13bc502020-07-20 23:35:21 -0700646 * {@link ChooseLockSettingsHelper#EXTRA_KEY_ALLOW_ANY_USER}.
Jeff Sharkey219ec912017-12-19 14:57:39 -0700647 * @throws SecurityException if the given userId does not belong to the
Sunny Shao7e866b62019-08-09 11:42:04 +0800648 * current user group.
Jeff Sharkey219ec912017-12-19 14:57:39 -0700649 */
650 public static int getUserIdFromBundle(Context context, Bundle bundle, boolean isInternal) {
Clara Bayarrife432e82015-10-12 12:07:02 +0100651 if (bundle == null) {
Benjamin Franz194300d2016-01-13 12:16:25 +0000652 return getCredentialOwnerUserId(context);
Clara Bayarrife432e82015-10-12 12:07:02 +0100653 }
Jeff Sharkey219ec912017-12-19 14:57:39 -0700654 final boolean allowAnyUser = isInternal
Kevin Chynb13bc502020-07-20 23:35:21 -0700655 && bundle.getBoolean(ChooseLockSettingsHelper.EXTRA_KEY_ALLOW_ANY_USER, false);
Bonian Chen5e65da02019-11-08 07:40:35 +0800656 final int userId = bundle.getInt(Intent.EXTRA_USER_ID, UserHandle.myUserId());
Adrian Roos5a9a3cd2017-03-30 18:02:25 -0700657 if (userId == LockPatternUtils.USER_FRP) {
Jeff Sharkey219ec912017-12-19 14:57:39 -0700658 return allowAnyUser ? userId : enforceSystemUser(context, userId);
Adrian Roos5a9a3cd2017-03-30 18:02:25 -0700659 } else {
Jeff Sharkey219ec912017-12-19 14:57:39 -0700660 return allowAnyUser ? userId : enforceSameOwner(context, userId);
Adrian Roos5a9a3cd2017-03-30 18:02:25 -0700661 }
662 }
663
664 /**
665 * Returns the given user id if the current user is the system user.
666 *
667 * @throws SecurityException if the current user is not the system user.
668 */
669 public static int enforceSystemUser(Context context, int userId) {
670 if (UserHandle.myUserId() == UserHandle.USER_SYSTEM) {
671 return userId;
672 }
673 throw new SecurityException("Given user id " + userId + " must only be used from "
674 + "USER_SYSTEM, but current user is " + UserHandle.myUserId());
Clara Bayarrife432e82015-10-12 12:07:02 +0100675 }
676
677 /**
678 * Returns the given user id if it belongs to the current user.
679 *
680 * @throws SecurityException if the given userId does not belong to the current user group.
681 */
Benjamin Franz194300d2016-01-13 12:16:25 +0000682 public static int enforceSameOwner(Context context, int userId) {
Bonian Chenf399bd12020-01-09 14:50:03 +0800683 final UserManager um = context.getSystemService(UserManager.class);
Ricky Wai72500162016-06-07 16:54:25 +0100684 final int[] profileIds = um.getProfileIdsWithDisabled(UserHandle.myUserId());
685 if (ArrayUtils.contains(profileIds, userId)) {
686 return userId;
Clara Bayarrife432e82015-10-12 12:07:02 +0100687 }
Ricky Wai72500162016-06-07 16:54:25 +0100688 throw new SecurityException("Given user id " + userId + " does not belong to user "
689 + UserHandle.myUserId());
Clara Bayarrife432e82015-10-12 12:07:02 +0100690 }
691
Benjamin Franz194300d2016-01-13 12:16:25 +0000692 /**
693 * Returns the effective credential owner of the calling user.
694 */
695 public static int getCredentialOwnerUserId(Context context) {
696 return getCredentialOwnerUserId(context, UserHandle.myUserId());
697 }
698
699 /**
700 * Returns the user id of the credential owner of the given user id.
701 */
702 public static int getCredentialOwnerUserId(Context context, int userId) {
Bonian Chenf399bd12020-01-09 14:50:03 +0800703 final UserManager um = context.getSystemService(UserManager.class);
Benjamin Franz194300d2016-01-13 12:16:25 +0000704 return um.getCredentialOwnerProfile(userId);
Andres Morales7bdffd82015-08-04 16:55:00 -0700705 }
Jason Monkdb4ed192015-12-11 16:48:31 -0500706
Alex Johnston403c3302020-01-07 15:40:05 +0000707 /**
708 * Returns the credential type of the given user id.
709 */
710 public static @LockPatternUtils.CredentialType int getCredentialType(Context context,
711 int userId) {
712 final LockPatternUtils lpu = new LockPatternUtils(context);
713 return lpu.getCredentialTypeForUser(userId);
714 }
715
Jason Monkb37e2882016-01-11 14:27:20 -0500716 private static final StringBuilder sBuilder = new StringBuilder(50);
717 private static final java.util.Formatter sFormatter = new java.util.Formatter(
718 sBuilder, Locale.getDefault());
719
720 public static String formatDateRange(Context context, long start, long end) {
721 final int flags = FORMAT_SHOW_DATE | FORMAT_ABBREV_MONTH;
722
723 synchronized (sBuilder) {
724 sBuilder.setLength(0);
725 return DateUtils.formatDateRange(context, sFormatter, start, end, flags, null)
726 .toString();
727 }
728 }
Jason Monk91e2f892016-02-23 15:31:09 -0500729
Bernard Chau88d523b2016-04-14 15:08:28 +0100730 public static boolean startQuietModeDialogIfNecessary(Context context, UserManager um,
Ricky Wai616342b2016-04-13 10:40:22 +0100731 int userId) {
732 if (um.isQuietModeEnabled(UserHandle.of(userId))) {
733 final Intent intent = UnlaunchableAppActivity.createInQuietModeDialogIntent(userId);
734 context.startActivity(intent);
735 return true;
736 }
737 return false;
738 }
Sudheer Shankac3eb16e2016-04-21 12:51:43 -0700739
Rubin Xu3231afe2016-08-24 10:15:07 +0100740 public static boolean unlockWorkProfileIfNecessary(Context context, int userId) {
741 try {
Sudheer Shankaacb1a612016-11-10 15:30:14 -0800742 if (!ActivityManager.getService().isUserRunning(userId,
Rubin Xu3231afe2016-08-24 10:15:07 +0100743 ActivityManager.FLAG_AND_LOCKED)) {
744 return false;
745 }
746 } catch (RemoteException e) {
747 return false;
748 }
749 if (!(new LockPatternUtils(context)).isSecure(userId)) {
750 return false;
751 }
Robin Leecccf3242017-02-10 15:32:49 +0000752 return confirmWorkProfileCredentials(context, userId);
753 }
754
Robin Leecccf3242017-02-10 15:32:49 +0000755 private static boolean confirmWorkProfileCredentials(Context context, int userId) {
Rubin Xu3231afe2016-08-24 10:15:07 +0100756 final KeyguardManager km = (KeyguardManager) context.getSystemService(
757 Context.KEYGUARD_SERVICE);
758 final Intent unlockIntent = km.createConfirmDeviceCredentialIntent(null, null, userId);
759 if (unlockIntent != null) {
760 context.startActivity(unlockIntent);
761 return true;
762 } else {
763 return false;
764 }
Rubin Xu3231afe2016-08-24 10:15:07 +0100765 }
766
Sudheer Shankac3eb16e2016-04-21 12:51:43 -0700767 public static CharSequence getApplicationLabel(Context context, String packageName) {
768 try {
769 final ApplicationInfo appInfo = context.getPackageManager().getApplicationInfo(
770 packageName,
771 PackageManager.MATCH_DISABLED_COMPONENTS
Sunny Shao7e866b62019-08-09 11:42:04 +0800772 | PackageManager.MATCH_ANY_USER);
Sudheer Shankac3eb16e2016-04-21 12:51:43 -0700773 return appInfo.loadLabel(context.getPackageManager());
774 } catch (PackageManager.NameNotFoundException e) {
Raff Tsai376ce872020-01-06 00:42:35 +0800775 Log.e(TAG, "Unable to find info for package: " + packageName);
Sudheer Shankac3eb16e2016-04-21 12:51:43 -0700776 }
777 return null;
778 }
Jason Monk75199542016-05-06 15:09:32 -0400779
Jeff Sharkey4a8136b2016-07-27 12:53:34 -0600780 public static boolean isPackageDirectBootAware(Context context, String packageName) {
781 try {
782 final ApplicationInfo ai = context.getPackageManager().getApplicationInfo(
783 packageName, 0);
784 return ai.isDirectBootAware() || ai.isPartiallyDirectBootAware();
785 } catch (NameNotFoundException ignored) {
786 }
787 return false;
788 }
Andre Lago3e398c82016-07-25 14:12:28 +0100789
790 /**
791 * Returns a context created from the given context for the given user, or null if it fails
792 */
793 public static Context createPackageContextAsUser(Context context, int userId) {
794 try {
795 return context.createPackageContextAsUser(
796 context.getPackageName(), 0 /* flags */, UserHandle.of(userId));
797 } catch (PackageManager.NameNotFoundException e) {
798 Log.e(TAG, "Failed to create user context", e);
799 }
800 return null;
801 }
Jeff Sharkeyab508072016-10-11 14:25:22 -0600802
803 public static FingerprintManager getFingerprintManagerOrNull(Context context) {
804 if (context.getPackageManager().hasSystemFeature(PackageManager.FEATURE_FINGERPRINT)) {
Fan Zhangcf97f0b2018-01-05 11:18:44 -0800805 return (FingerprintManager) context.getSystemService(Context.FINGERPRINT_SERVICE);
Jeff Sharkeyab508072016-10-11 14:25:22 -0600806 } else {
807 return null;
808 }
809 }
Daniel Nishi31027da2017-01-19 14:03:57 -0800810
Kevin Chyn82792cc2017-07-20 00:15:44 -0700811 public static boolean hasFingerprintHardware(Context context) {
Bonian Chen5e65da02019-11-08 07:40:35 +0800812 final FingerprintManager fingerprintManager = getFingerprintManagerOrNull(context);
Kevin Chyn82792cc2017-07-20 00:15:44 -0700813 return fingerprintManager != null && fingerprintManager.isHardwareDetected();
814 }
815
Kevin Chyn4882e872018-06-25 17:58:31 -0700816 public static FaceManager getFaceManagerOrNull(Context context) {
817 if (context.getPackageManager().hasSystemFeature(PackageManager.FEATURE_FACE)) {
818 return (FaceManager) context.getSystemService(Context.FACE_SERVICE);
819 } else {
820 return null;
821 }
822 }
823
824 public static boolean hasFaceHardware(Context context) {
Bonian Chen5e65da02019-11-08 07:40:35 +0800825 final FaceManager faceManager = getFaceManagerOrNull(context);
Kevin Chyn4882e872018-06-25 17:58:31 -0700826 return faceManager != null && faceManager.isHardwareDetected();
827 }
828
Daniel Nishi31027da2017-01-19 14:03:57 -0800829 /**
830 * Launches an intent which may optionally have a user id defined.
831 * @param fragment Fragment to use to launch the activity.
Sunny Shao7e866b62019-08-09 11:42:04 +0800832 * @param intent Intent to launch.
Daniel Nishi31027da2017-01-19 14:03:57 -0800833 */
834 public static void launchIntent(Fragment fragment, Intent intent) {
835 try {
836 final int userId = intent.getIntExtra(Intent.EXTRA_USER_ID, -1);
837
838 if (userId == -1) {
839 fragment.startActivity(intent);
840 } else {
841 fragment.getActivity().startActivityAsUser(intent, new UserHandle(userId));
842 }
843 } catch (ActivityNotFoundException e) {
844 Log.w(TAG, "No activity found for " + intent);
845 }
846 }
847
Christine Franksc6890ab2017-06-23 14:28:21 -0700848 public static boolean isDemoUser(Context context) {
Bonian Chenf399bd12020-01-09 14:50:03 +0800849 return UserManager.isDeviceInDemoMode(context)
850 && context.getSystemService(UserManager.class).isDemoUser();
Christine Franksc6890ab2017-06-23 14:28:21 -0700851 }
852
Justin Klaassen30257272017-08-08 21:58:05 -0700853 public static ComponentName getDeviceOwnerComponent(Context context) {
854 final DevicePolicyManager dpm = (DevicePolicyManager) context.getSystemService(
855 Context.DEVICE_POLICY_SERVICE);
856 return dpm.getDeviceOwnerComponentOnAnyUser();
Christine Franks14782222017-01-23 16:44:02 -0800857 }
Daniel Nishidfed8a22017-01-19 16:32:41 -0800858
859 /**
860 * Returns if a given user is a profile of another user.
Sunny Shao7e866b62019-08-09 11:42:04 +0800861 * @param user The user whose profiles wibe checked.
Daniel Nishidfed8a22017-01-19 16:32:41 -0800862 * @param profile The (potential) profile.
863 * @return if the profile is actually a profile
864 */
865 public static boolean isProfileOf(UserInfo user, UserInfo profile) {
866 return user.id == profile.id ||
867 (user.profileGroupId != UserInfo.NO_PROFILE_GROUP_ID
868 && user.profileGroupId == profile.profileGroupId);
869 }
Daniel Nishi9f60f422017-02-15 15:25:48 -0800870
871 /**
872 * Tries to initalize a volume with the given bundle. If it is a valid, private, and readable
873 * {@link VolumeInfo}, it is returned. If it is not valid, null is returned.
874 */
875 @Nullable
876 public static VolumeInfo maybeInitializeVolume(StorageManager sm, Bundle bundle) {
877 final String volumeId = bundle.getString(VolumeInfo.EXTRA_VOLUME_ID,
878 VolumeInfo.ID_PRIVATE_INTERNAL);
Bonian Chen5e65da02019-11-08 07:40:35 +0800879 final VolumeInfo volume = sm.findVolumeById(volumeId);
Daniel Nishi9f60f422017-02-15 15:25:48 -0800880 return isVolumeValid(volume) ? volume : null;
881 }
882
jackqdyuleiddba9662017-03-08 19:35:02 -0800883 /**
jackqdyulei00015fb2017-08-22 11:25:30 -0700884 * Return {@code true} if the supplied package is device owner or profile owner of at
885 * least one user.
Sunny Shao7e866b62019-08-09 11:42:04 +0800886 * @param userManager used to get profile owner app for each user
jackqdyulei00015fb2017-08-22 11:25:30 -0700887 * @param devicePolicyManager used to check whether it is device owner app
Sunny Shao7e866b62019-08-09 11:42:04 +0800888 * @param packageName package to check about
jackqdyulei00015fb2017-08-22 11:25:30 -0700889 */
890 public static boolean isProfileOrDeviceOwner(UserManager userManager,
Fan Zhangaab36de2018-03-30 16:58:28 -0700891 DevicePolicyManager devicePolicyManager, String packageName) {
Bonian Chen5e65da02019-11-08 07:40:35 +0800892 final List<UserInfo> userInfos = userManager.getUsers();
jackqdyulei00015fb2017-08-22 11:25:30 -0700893 if (devicePolicyManager.isDeviceOwnerAppOnAnyUser(packageName)) {
894 return true;
895 }
896 for (int i = 0, size = userInfos.size(); i < size; i++) {
Bonian Chen5e65da02019-11-08 07:40:35 +0800897 final ComponentName cn = devicePolicyManager
898 .getProfileOwnerAsUser(userInfos.get(i).id);
jackqdyulei00015fb2017-08-22 11:25:30 -0700899 if (cn != null && cn.getPackageName().equals(packageName)) {
900 return true;
901 }
902 }
903 return false;
904 }
905
906 /**
Alex Johnston341f9952020-02-26 15:54:11 +0000907 * Return {@code true} if the supplied package is the device owner or profile owner of a
908 * given user.
909 *
910 * @param devicePolicyManager used to check whether it is device owner and profile owner app
911 * @param packageName package to check about
912 * @param userId the if of the relevant user
913 */
914 public static boolean isProfileOrDeviceOwner(DevicePolicyManager devicePolicyManager,
915 String packageName, int userId) {
916 if ((devicePolicyManager.getDeviceOwnerUserId() == userId)
917 && devicePolicyManager.isDeviceOwnerApp(packageName)) {
918 return true;
919 }
920 final ComponentName cn = devicePolicyManager.getProfileOwnerAsUser(userId);
921 if (cn != null && cn.getPackageName().equals(packageName)) {
922 return true;
923 }
924 return false;
925 }
926
927 /**
jackqdyuleiddba9662017-03-08 19:35:02 -0800928 * Return the resource id to represent the install status for an app
929 */
930 @StringRes
931 public static int getInstallationStatus(ApplicationInfo info) {
932 if ((info.flags & ApplicationInfo.FLAG_INSTALLED) == 0) {
933 return R.string.not_installed;
934 }
935 return info.enabled ? R.string.installed : R.string.disabled;
936 }
937
Daniel Nishi9f60f422017-02-15 15:25:48 -0800938 private static boolean isVolumeValid(VolumeInfo volume) {
939 return (volume != null) && (volume.getType() == VolumeInfo.TYPE_PRIVATE)
940 && volume.isMountedReadable();
941 }
jackqdyuleif4c1cef2017-03-31 12:57:10 -0700942
PMS2263a05602017-06-14 07:10:15 +0000943 public static void setEditTextCursorPosition(EditText editText) {
944 editText.setSelection(editText.getText().length());
945 }
Felipe Lemebd884502017-09-15 18:16:21 -0700946
947 /**
948 * Sets the preference icon with a drawable that is scaled down to to avoid crashing Settings if
949 * it's too big.
950 */
951 public static void setSafeIcon(Preference pref, Drawable icon) {
952 Drawable safeIcon = icon;
Phil Weaver5a3e02d2018-03-08 17:38:46 -0800953 if ((icon != null) && !(icon instanceof VectorDrawable)) {
Felipe Lemebd884502017-09-15 18:16:21 -0700954 safeIcon = getSafeDrawable(icon, 500, 500);
955 }
956 pref.setIcon(safeIcon);
957 }
958
959 /**
960 * Gets a drawable with a limited size to avoid crashing Settings if it's too big.
961 *
Sunny Shao7e866b62019-08-09 11:42:04 +0800962 * @param original original drawable, typically an app icon.
963 * @param maxWidth maximum width, in pixels.
Felipe Lemebd884502017-09-15 18:16:21 -0700964 * @param maxHeight maximum height, in pixels.
965 */
966 public static Drawable getSafeDrawable(Drawable original, int maxWidth, int maxHeight) {
967 final int actualWidth = original.getMinimumWidth();
968 final int actualHeight = original.getMinimumHeight();
969
970 if (actualWidth <= maxWidth && actualHeight <= maxHeight) {
971 return original;
972 }
973
Bonian Chen5e65da02019-11-08 07:40:35 +0800974 final float scaleWidth = ((float) maxWidth) / actualWidth;
975 final float scaleHeight = ((float) maxHeight) / actualHeight;
976 final float scale = Math.min(scaleWidth, scaleHeight);
Felipe Lemebd884502017-09-15 18:16:21 -0700977 final int width = (int) (actualWidth * scale);
978 final int height = (int) (actualHeight * scale);
979
980 final Bitmap bitmap;
981 if (original instanceof BitmapDrawable) {
982 bitmap = Bitmap.createScaledBitmap(((BitmapDrawable) original).getBitmap(), width,
983 height, false);
984 } else {
Jason Chiuc78c54a2019-02-13 16:07:57 +0800985 bitmap = createBitmap(original, width, height);
Felipe Lemebd884502017-09-15 18:16:21 -0700986 }
987 return new BitmapDrawable(null, bitmap);
988 }
jackqdyuleifde637f2018-01-02 14:51:01 -0800989
990 /**
Jason Chiuc78c54a2019-02-13 16:07:57 +0800991 * Create an Icon pointing to a drawable.
Jason Chiu1217bbe2019-01-24 16:32:31 +0800992 */
Jason Chiuc78c54a2019-02-13 16:07:57 +0800993 public static IconCompat createIconWithDrawable(Drawable drawable) {
994 Bitmap bitmap;
Jason Chiu1217bbe2019-01-24 16:32:31 +0800995 if (drawable instanceof BitmapDrawable) {
Sunny Shao7e866b62019-08-09 11:42:04 +0800996 bitmap = ((BitmapDrawable)drawable).getBitmap();
Jason Chiuc78c54a2019-02-13 16:07:57 +0800997 } else {
998 final int width = drawable.getIntrinsicWidth();
999 final int height = drawable.getIntrinsicHeight();
1000 bitmap = createBitmap(drawable,
1001 width > 0 ? width : 1,
1002 height > 0 ? height : 1);
Jason Chiu1217bbe2019-01-24 16:32:31 +08001003 }
Jason Chiuc78c54a2019-02-13 16:07:57 +08001004 return IconCompat.createWithBitmap(bitmap);
1005 }
Jason Chiu1217bbe2019-01-24 16:32:31 +08001006
clownshen24827d32019-03-29 20:22:02 +08001007 /**
1008 * Creates a drawable with specified width and height.
1009 */
1010 public static Bitmap createBitmap(Drawable drawable, int width, int height) {
Jason Chiuc78c54a2019-02-13 16:07:57 +08001011 final Bitmap bitmap = Bitmap.createBitmap(width, height, Bitmap.Config.ARGB_8888);
Jason Chiu1217bbe2019-01-24 16:32:31 +08001012 final Canvas canvas = new Canvas(bitmap);
1013 drawable.setBounds(0, 0, canvas.getWidth(), canvas.getHeight());
1014 drawable.draw(canvas);
1015 return bitmap;
1016 }
1017
1018 /**
jackqdyuleifde637f2018-01-02 14:51:01 -08001019 * Get the {@link Drawable} that represents the app icon
1020 */
1021 public static Drawable getBadgedIcon(IconDrawableFactory iconDrawableFactory,
1022 PackageManager packageManager, String packageName, int userId) {
1023 try {
Tony Mak4e292812018-03-19 15:37:21 +00001024 final ApplicationInfo appInfo = packageManager.getApplicationInfoAsUser(
1025 packageName, PackageManager.GET_META_DATA, userId);
jackqdyuleifde637f2018-01-02 14:51:01 -08001026 return iconDrawableFactory.getBadgedIcon(appInfo, userId);
1027 } catch (PackageManager.NameNotFoundException e) {
1028 return packageManager.getDefaultActivityIcon();
1029 }
1030 }
Raff Tsai2928cd42018-11-05 16:10:19 +08001031
1032 /** Returns true if the current package is installed & enabled. */
1033 public static boolean isPackageEnabled(Context context, String packageName) {
1034 try {
1035 return context.getPackageManager().getApplicationInfo(packageName, 0).enabled;
1036 } catch (Exception e) {
1037 Log.e(TAG, "Error while retrieving application info for package " + packageName, e);
1038 }
1039 return false;
1040 }
markchien1dd1d792019-01-11 16:18:20 +08001041
1042 /** Get {@link Resources} by subscription id if subscription id is valid. */
1043 public static Resources getResourcesForSubId(Context context, int subId) {
1044 if (subId != SubscriptionManager.INVALID_SUBSCRIPTION_ID) {
1045 return SubscriptionManager.getResourcesForSubId(context, subId);
1046 } else {
1047 return context.getResources();
1048 }
1049 }
Ng Zhi Anb97bdc32019-02-01 12:39:31 -08001050
1051 /**
1052 * Returns true if SYSTEM_ALERT_WINDOW permission is available.
1053 * Starting from Q, SYSTEM_ALERT_WINDOW is disabled on low ram phones.
1054 */
1055 public static boolean isSystemAlertWindowEnabled(Context context) {
1056 // SYSTEM_ALERT_WINDOW is disabled on on low ram devices starting from Q
1057 ActivityManager am = (ActivityManager) context.getSystemService(Context.ACTIVITY_SERVICE);
1058 return !(am.isLowRamDevice() && (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q));
1059 }
tmfangaed8f362019-03-18 16:56:09 +08001060
1061 /**
1062 * Adds a shadow appear/disappear animation to action bar scroll.
1063 *
1064 * <p/>
1065 * This method must be called after {@link Fragment#onCreate(Bundle)}.
1066 */
1067 public static void setActionBarShadowAnimation(Activity activity, Lifecycle lifecycle,
1068 View scrollView) {
1069 if (activity == null) {
1070 Log.w(TAG, "No activity, cannot style actionbar.");
1071 return;
1072 }
1073 final ActionBar actionBar = activity.getActionBar();
1074 if (actionBar == null) {
1075 Log.w(TAG, "No actionbar, cannot style actionbar.");
1076 return;
1077 }
1078 actionBar.setElevation(0);
1079
1080 if (lifecycle != null && scrollView != null) {
1081 ActionBarShadowController.attachToView(activity, lifecycle, scrollView);
1082 }
1083 }
Raff Tsaiafd494d2019-10-16 15:25:21 +08001084
1085 /**
1086 * Return correct target fragment based on argument
1087 *
1088 * @param activity the activity target fragment will be launched.
1089 * @param fragmentName initial target fragment name.
1090 * @param args fragment launch arguments.
1091 */
1092 public static Fragment getTargetFragment(Activity activity, String fragmentName, Bundle args) {
1093 Fragment f = null;
Raff Tsai84327f62019-11-15 11:02:25 +08001094 final boolean isPersonal = args != null ? args.getInt(ProfileSelectFragment.EXTRA_PROFILE)
Raff Tsai1e5d8142019-12-12 11:45:41 +08001095 == ProfileSelectFragment.ProfileType.PERSONAL : false;
Raff Tsai84327f62019-11-15 11:02:25 +08001096 final boolean isWork = args != null ? args.getInt(ProfileSelectFragment.EXTRA_PROFILE)
Raff Tsai1e5d8142019-12-12 11:45:41 +08001097 == ProfileSelectFragment.ProfileType.WORK : false;
Raff Tsai3fbdf342020-01-16 05:27:32 +08001098 if (activity.getSystemService(UserManager.class).getUserProfiles().size() > 1
Raff Tsaiafd494d2019-10-16 15:25:21 +08001099 && ProfileFragmentBridge.FRAGMENT_MAP.get(fragmentName) != null
Raff Tsai84327f62019-11-15 11:02:25 +08001100 && !isWork && !isPersonal) {
Raff Tsaiafd494d2019-10-16 15:25:21 +08001101 f = Fragment.instantiate(activity, ProfileFragmentBridge.FRAGMENT_MAP.get(fragmentName),
1102 args);
1103 } else {
1104 f = Fragment.instantiate(activity, fragmentName, args);
1105 }
1106 return f;
1107 }
Yanting Yang96127fe2020-03-20 12:04:09 +08001108
1109 /**
1110 * Returns true if current binder uid is Settings Intelligence.
1111 */
1112 public static boolean isSettingsIntelligence(Context context) {
1113 final int callingUid = Binder.getCallingUid();
1114 final String callingPackage = context.getPackageManager().getPackagesForUid(callingUid)[0];
1115 final boolean isSettingsIntelligence = TextUtils.equals(callingPackage,
1116 context.getString(R.string.config_settingsintelligence_package_name));
1117 return isSettingsIntelligence;
1118 }
Jason Chiu8ac1e4d2020-05-11 16:13:47 +08001119
1120 /**
1121 * Returns true if the night mode is enabled.
1122 */
1123 public static boolean isNightMode(Context context) {
1124 final int currentNightMode =
1125 context.getResources().getConfiguration().uiMode & Configuration.UI_MODE_NIGHT_MASK;
1126 return currentNightMode == Configuration.UI_MODE_NIGHT_YES;
1127 }
Tim Pengdf467882020-06-24 13:10:01 +08001128
1129 /**
1130 * Returns a bitmap with rounded corner.
1131 *
1132 * @param context application context.
1133 * @param source bitmap to apply round corner.
1134 * @param cornerRadius corner radius value.
1135 */
1136 public static Bitmap convertCornerRadiusBitmap(@NonNull Context context,
1137 @NonNull Bitmap source, @NonNull float cornerRadius) {
1138 final Bitmap roundedBitmap = Bitmap.createBitmap(source.getWidth(), source.getHeight(),
1139 Bitmap.Config.ARGB_8888);
1140 final RoundedBitmapDrawable drawable =
1141 RoundedBitmapDrawableFactory.create(context.getResources(), source);
1142 drawable.setAntiAlias(true);
1143 drawable.setCornerRadius(cornerRadius);
1144 final Canvas canvas = new Canvas(roundedBitmap);
1145 drawable.setBounds(0, 0, canvas.getWidth(), canvas.getHeight());
1146 drawable.draw(canvas);
1147 return roundedBitmap;
1148 }
Jeff Sharkey4a8136b2016-07-27 12:53:34 -06001149}