blob: b6a9f59f3540974c3eefd8c089ecab145b393ddb [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;
Zoey Chen3abe48e2020-10-28 22:46:48 +080086import android.util.FeatureFlagUtils;
jackqdyuleifde637f2018-01-02 14:51:01 -080087import android.util.IconDrawableFactory;
Alexandra Gherghina1eb3f312014-06-10 14:01:10 +010088import android.util.Log;
Zoltan Szatmary-Ban3af2e4c2014-12-19 17:17:23 +000089import android.view.LayoutInflater;
Jeff Sharkeyb654cbb2011-08-18 11:59:19 -070090import android.view.View;
91import android.view.ViewGroup;
PMS2263a05602017-06-14 07:10:15 +000092import android.widget.EditText;
Jeff Sharkeyb654cbb2011-08-18 11:59:19 -070093import android.widget.ListView;
94import android.widget.TabWidget;
Fan Zhangcc335d92016-09-29 14:37:14 -070095
Tim Pengdf467882020-06-24 13:10:01 +080096import androidx.annotation.NonNull;
Fan Zhang23f8d592018-08-28 15:11:40 -070097import androidx.annotation.StringRes;
Jason Chiuc78c54a2019-02-13 16:07:57 +080098import androidx.core.graphics.drawable.IconCompat;
Tim Pengdf467882020-06-24 13:10:01 +080099import androidx.core.graphics.drawable.RoundedBitmapDrawable;
100import androidx.core.graphics.drawable.RoundedBitmapDrawableFactory;
Fan Zhang23f8d592018-08-28 15:11:40 -0700101import androidx.fragment.app.Fragment;
tmfangaed8f362019-03-18 16:56:09 +0800102import androidx.lifecycle.Lifecycle;
Fan Zhang23f8d592018-08-28 15:11:40 -0700103import androidx.preference.Preference;
104import androidx.preference.PreferenceGroup;
105
Ricky Wai616342b2016-04-13 10:40:22 +0100106import com.android.internal.app.UnlaunchableAppActivity;
Ricky Wai72500162016-06-07 16:54:25 +0100107import com.android.internal.util.ArrayUtils;
Rubin Xu3231afe2016-08-24 10:15:07 +0100108import com.android.internal.widget.LockPatternUtils;
Raff Tsaiafd494d2019-10-16 15:25:21 +0800109import com.android.settings.dashboard.profileselector.ProfileFragmentBridge;
Raff Tsai84327f62019-11-15 11:02:25 +0800110import com.android.settings.dashboard.profileselector.ProfileSelectFragment;
Jeff Sharkey219ec912017-12-19 14:57:39 -0700111import com.android.settings.password.ChooseLockSettingsHelper;
tmfangaed8f362019-03-18 16:56:09 +0800112import com.android.settingslib.widget.ActionBarShadowController;
Daisuke Miyakawaa2633d02010-09-15 20:09:12 -0700113
Amith Yamasanic06d4c42011-02-25 14:35:20 -0800114import java.net.InetAddress;
115import java.util.Iterator;
Daisuke Miyakawaa2633d02010-09-15 20:09:12 -0700116import java.util.List;
Jean Chalard71ad1f42011-05-12 15:06:16 +0900117import java.util.Locale;
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800118
Jason Monk27985e12016-01-08 14:13:05 -0500119public final class Utils extends com.android.settingslib.Utils {
120
Alexandra Gherghina1eb3f312014-06-10 14:01:10 +0100121 private static final String TAG = "Settings";
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100122
Andras Kloczl106431e2020-05-18 14:53:07 +0100123 public static final String FILE_PROVIDER_AUTHORITY = "com.android.settings.files";
124
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800125 /**
126 * Set the preference's title to the matching activity's label.
127 */
128 public static final int UPDATE_PREFERENCE_FLAG_SET_TITLE_TO_MATCHING_ACTIVITY = 1;
129
Fan Zhangc3fd2892019-01-29 16:00:19 -0800130 public static final String SETTINGS_PACKAGE_NAME = "com.android.settings";
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100131
Jason Monkbeb171d2015-05-21 15:24:37 -0400132 public static final String OS_PKG = "os";
133
Anders Hammar1b2dd9032010-04-08 10:03:50 +0200134 /**
Svet Ganov864765f2019-04-05 19:00:05 -0700135 * Whether to disable the new device identifier access restrictions.
136 */
137 public static final String PROPERTY_DEVICE_IDENTIFIER_ACCESS_RESTRICTIONS_DISABLED =
138 "device_identifier_access_restrictions_disabled";
139
140 /**
Joel Galenson2118f8a2019-05-31 07:54:20 -0700141 * Whether to show the Permissions Hub.
142 */
143 public static final String PROPERTY_PERMISSIONS_HUB_ENABLED = "permissions_hub_enabled";
144
145 /**
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800146 * Finds a matching activity for a preference's intent. If a matching
147 * activity is not found, it will remove the preference.
Ying Wanga7188322010-01-04 18:45:10 -0800148 *
Sunny Shao7e866b62019-08-09 11:42:04 +0800149 * @param context The context.
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800150 * @param parentPreferenceGroup The preference group that contains the
Sunny Shao7e866b62019-08-09 11:42:04 +0800151 * preference whose intent is being resolved.
152 * @param preferenceKey The key of the preference whose intent is being
153 * resolved.
154 * @param flags 0 or one or more of
155 * {@link #UPDATE_PREFERENCE_FLAG_SET_TITLE_TO_MATCHING_ACTIVITY}
156 * .
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800157 * @return Whether an activity was found. If false, the preference was
Sunny Shao7e866b62019-08-09 11:42:04 +0800158 * removed.
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800159 */
160 public static boolean updatePreferenceToSpecificActivityOrRemove(Context context,
161 PreferenceGroup parentPreferenceGroup, String preferenceKey, int flags) {
Ying Wanga7188322010-01-04 18:45:10 -0800162
Bonian Chen5e65da02019-11-08 07:40:35 +0800163 final Preference preference = parentPreferenceGroup.findPreference(preferenceKey);
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800164 if (preference == null) {
165 return false;
166 }
Ying Wanga7188322010-01-04 18:45:10 -0800167
Bonian Chen5e65da02019-11-08 07:40:35 +0800168 final Intent intent = preference.getIntent();
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800169 if (intent != null) {
170 // Find the activity that is in the system image
Bonian Chen5e65da02019-11-08 07:40:35 +0800171 final PackageManager pm = context.getPackageManager();
172 final List<ResolveInfo> list = pm.queryIntentActivities(intent, 0);
173 final int listSize = list.size();
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800174 for (int i = 0; i < listSize; i++) {
Bonian Chen5e65da02019-11-08 07:40:35 +0800175 final ResolveInfo resolveInfo = list.get(i);
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800176 if ((resolveInfo.activityInfo.applicationInfo.flags & ApplicationInfo.FLAG_SYSTEM)
177 != 0) {
Ying Wanga7188322010-01-04 18:45:10 -0800178
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800179 // Replace the intent with this specific activity
180 preference.setIntent(new Intent().setClassName(
181 resolveInfo.activityInfo.packageName,
182 resolveInfo.activityInfo.name));
183
184 if ((flags & UPDATE_PREFERENCE_FLAG_SET_TITLE_TO_MATCHING_ACTIVITY) != 0) {
185 // Set the preference title to the activity's label
186 preference.setTitle(resolveInfo.loadLabel(pm));
187 }
Ying Wanga7188322010-01-04 18:45:10 -0800188
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800189 return true;
190 }
191 }
192 }
193
194 // Did not find a matching activity, so remove the preference
195 parentPreferenceGroup.removePreference(preference);
Ying Wanga7188322010-01-04 18:45:10 -0800196
Shuhrat Dehkanov7dc567a2012-04-23 01:59:56 +0900197 return false;
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800198 }
Ying Wanga7188322010-01-04 18:45:10 -0800199
Anders Hammar1b2dd9032010-04-08 10:03:50 +0200200 /**
Ying Wanga7188322010-01-04 18:45:10 -0800201 * Returns true if Monkey is running.
202 */
203 public static boolean isMonkeyRunning() {
Amith Yamasaniae697552011-09-27 11:33:17 -0700204 return ActivityManager.isUserAMonkey();
Ying Wanga7188322010-01-04 18:45:10 -0800205 }
Amith Yamasani60133dd2010-09-11 14:17:31 -0700206
207 /**
208 * Returns whether the device is voice-capable (meaning, it is also a phone).
209 */
210 public static boolean isVoiceCapable(Context context) {
Bonian Chen5e65da02019-11-08 07:40:35 +0800211 final TelephonyManager telephony =
Amith Yamasani60133dd2010-09-11 14:17:31 -0700212 (TelephonyManager) context.getSystemService(Context.TELEPHONY_SERVICE);
213 return telephony != null && telephony.isVoiceCapable();
214 }
Amith Yamasani0f85c482011-02-23 17:19:11 -0800215
Amith Yamasanic06d4c42011-02-25 14:35:20 -0800216 /**
217 * Returns the WIFI IP Addresses, if any, taking into account IPv4 and IPv6 style addresses.
218 * @param context the application context
Lorenzo Colitti769f0692013-08-01 17:30:07 +0900219 * @return the formatted and newline-separated IP addresses, or null if none.
Amith Yamasanic06d4c42011-02-25 14:35:20 -0800220 */
221 public static String getWifiIpAddresses(Context context) {
Bonian Chen5e65da02019-11-08 07:40:35 +0800222 final WifiManager wifiManager = context.getSystemService(WifiManager.class);
223 final Network currentNetwork = wifiManager.getCurrentNetwork();
Jaewoong Jungc260e6d2016-10-13 14:21:52 -0700224 if (currentNetwork != null) {
Bonian Chen5e65da02019-11-08 07:40:35 +0800225 final ConnectivityManager cm = (ConnectivityManager)
Sunny Shao7e866b62019-08-09 11:42:04 +0800226 context.getSystemService(Context.CONNECTIVITY_SERVICE);
Bonian Chen5e65da02019-11-08 07:40:35 +0800227 final LinkProperties prop = cm.getLinkProperties(currentNetwork);
Jaewoong Jungc260e6d2016-10-13 14:21:52 -0700228 return formatIpAddresses(prop);
229 }
230 return null;
Amith Yamasani6822b742011-10-17 16:41:00 -0700231 }
232
Amith Yamasani6822b742011-10-17 16:41:00 -0700233 private static String formatIpAddresses(LinkProperties prop) {
Amith Yamasanic06d4c42011-02-25 14:35:20 -0800234 if (prop == null) return null;
Bonian Chen5e65da02019-11-08 07:40:35 +0800235 final Iterator<InetAddress> iter = prop.getAllAddresses().iterator();
Amith Yamasanic06d4c42011-02-25 14:35:20 -0800236 // If there are no entries, return null
237 if (!iter.hasNext()) return null;
238 // Concatenate all available addresses, comma separated
239 String addresses = "";
240 while (iter.hasNext()) {
241 addresses += iter.next().getHostAddress();
Lorenzo Colitti769f0692013-08-01 17:30:07 +0900242 if (iter.hasNext()) addresses += "\n";
Amith Yamasanic06d4c42011-02-25 14:35:20 -0800243 }
244 return addresses;
245 }
Jean Chalard71ad1f42011-05-12 15:06:16 +0900246
247 public static Locale createLocaleFromString(String localeStr) {
248 // TODO: is there a better way to actually construct a locale that will match?
249 // The main problem is, on top of Java specs, locale.toString() and
250 // new Locale(locale.toString()).toString() do not return equal() strings in
251 // many cases, because the constructor takes the only string as the language
252 // code. So : new Locale("en", "US").toString() => "en_US"
253 // And : new Locale("en_US").toString() => "en_us"
Sunny Shao7e866b62019-08-09 11:42:04 +0800254 if (null == localeStr)
Jean Chalard71ad1f42011-05-12 15:06:16 +0900255 return Locale.getDefault();
Bonian Chen5e65da02019-11-08 07:40:35 +0800256 final String[] brokenDownLocale = localeStr.split("_", 3);
Jean Chalard71ad1f42011-05-12 15:06:16 +0900257 // split may not return a 0-length array.
258 if (1 == brokenDownLocale.length) {
259 return new Locale(brokenDownLocale[0]);
260 } else if (2 == brokenDownLocale.length) {
261 return new Locale(brokenDownLocale[0], brokenDownLocale[1]);
262 } else {
263 return new Locale(brokenDownLocale[0], brokenDownLocale[1], brokenDownLocale[2]);
264 }
265 }
Amith Yamasania4379d62011-07-22 10:34:58 -0700266
Jaewan Kima3fe77b2013-06-04 21:17:40 +0900267 public static boolean isBatteryPresent(Intent batteryChangedIntent) {
268 return batteryChangedIntent.getBooleanExtra(BatteryManager.EXTRA_PRESENT, true);
269 }
270
Mill Chenad99e2e2020-10-21 16:32:56 +0800271 /**
272 * Return true if battery is present.
273 */
274 public static boolean isBatteryPresent(Context context) {
275 Intent batteryBroadcast = context.registerReceiver(null /* receiver */,
276 new IntentFilter(Intent.ACTION_BATTERY_CHANGED));
277 return isBatteryPresent(batteryBroadcast);
278 }
279
Amith Yamasania4379d62011-07-22 10:34:58 -0700280 public static String getBatteryPercentage(Intent batteryChangedIntent) {
Elliott Hughes7253df32014-09-02 17:10:14 -0700281 return formatPercentage(getBatteryLevel(batteryChangedIntent));
Dianne Hackborn525f2bd2014-04-29 11:24:06 -0700282 }
283
Jeff Sharkeyb654cbb2011-08-18 11:59:19 -0700284 /**
285 * Prepare a custom preferences layout, moving padding to {@link ListView}
286 * when outside scrollbars are requested. Usually used to display
287 * {@link ListView} and {@link TabWidget} with correct padding.
288 */
Jeff Sharkey5d706792011-09-08 18:57:17 -0700289 public static void prepareCustomPreferencesList(
Jeff Sharkey97d07fa2012-11-30 12:36:53 -0800290 ViewGroup parent, View child, View list, boolean ignoreSidePadding) {
Jeff Sharkeyb654cbb2011-08-18 11:59:19 -0700291 final boolean movePadding = list.getScrollBarStyle() == View.SCROLLBARS_OUTSIDE_OVERLAY;
Fabrice Di Meglio97a18c82014-07-18 19:12:36 -0700292 if (movePadding) {
Jeff Sharkeyb654cbb2011-08-18 11:59:19 -0700293 final Resources res = list.getResources();
Jeff Sharkeyb654cbb2011-08-18 11:59:19 -0700294 final int paddingBottom = res.getDimensionPixelSize(
295 com.android.internal.R.dimen.preference_fragment_padding_bottom);
Jeff Sharkey5d706792011-09-08 18:57:17 -0700296
Fabrice Di Meglio97a18c82014-07-18 19:12:36 -0700297 if (parent instanceof PreferenceFrameLayout) {
298 ((PreferenceFrameLayout.LayoutParams) child.getLayoutParams()).removeBorders = true;
Fabrice Di Meglio97a18c82014-07-18 19:12:36 -0700299 }
Doris Lingc5a1b4f2019-02-20 16:33:24 -0800300 list.setPaddingRelative(0 /* start */, 0 /* top */, 0 /* end */, paddingBottom);
Jeff Sharkeyb654cbb2011-08-18 11:59:19 -0700301 }
302 }
Jeff Sharkeya83a24f2011-09-16 01:52:39 -0700303
Fabrice Di Meglio0f4a7792014-07-28 18:25:14 -0700304 public static void forceCustomPadding(View view, boolean additive) {
Fabrice Di Meglio38ba9a22014-07-18 19:58:50 -0700305 final Resources res = view.getResources();
Fabrice Di Meglio0f4a7792014-07-28 18:25:14 -0700306
Doris Lingc5a1b4f2019-02-20 16:33:24 -0800307 final int paddingStart = additive ? view.getPaddingStart() : 0;
308 final int paddingEnd = additive ? view.getPaddingEnd() : 0;
Fabrice Di Meglio38ba9a22014-07-18 19:58:50 -0700309 final int paddingBottom = res.getDimensionPixelSize(
310 com.android.internal.R.dimen.preference_fragment_padding_bottom);
311
Fabrice Di Meglio0f4a7792014-07-28 18:25:14 -0700312 view.setPaddingRelative(paddingStart, 0, paddingEnd, paddingBottom);
Fabrice Di Meglio38ba9a22014-07-18 19:58:50 -0700313 }
314
Amith Yamasani8d40fac2012-10-23 15:36:16 -0700315 public static String getMeProfileName(Context context, boolean full) {
316 if (full) {
317 return getProfileDisplayName(context);
318 } else {
319 return getShorterNameIfPossible(context);
Amith Yamasaniae47ef42012-09-16 17:53:35 -0700320 }
Amith Yamasani8d40fac2012-10-23 15:36:16 -0700321 }
322
323 private static String getShorterNameIfPossible(Context context) {
324 final String given = getLocalProfileGivenName(context);
325 return !TextUtils.isEmpty(given) ? given : getProfileDisplayName(context);
326 }
327
328 private static String getLocalProfileGivenName(Context context) {
329 final ContentResolver cr = context.getContentResolver();
330
331 // Find the raw contact ID for the local ME profile raw contact.
332 final long localRowProfileId;
333 final Cursor localRawProfile = cr.query(
334 Profile.CONTENT_RAW_CONTACTS_URI,
Sunny Shao7e866b62019-08-09 11:42:04 +0800335 new String[] {RawContacts._ID},
Amith Yamasani8d40fac2012-10-23 15:36:16 -0700336 RawContacts.ACCOUNT_TYPE + " IS NULL AND " +
337 RawContacts.ACCOUNT_NAME + " IS NULL",
338 null, null);
339 if (localRawProfile == null) return null;
Amith Yamasaniae47ef42012-09-16 17:53:35 -0700340
341 try {
Amith Yamasani8d40fac2012-10-23 15:36:16 -0700342 if (!localRawProfile.moveToFirst()) {
343 return null;
Amith Yamasaniae47ef42012-09-16 17:53:35 -0700344 }
Amith Yamasani8d40fac2012-10-23 15:36:16 -0700345 localRowProfileId = localRawProfile.getLong(0);
Amith Yamasaniae47ef42012-09-16 17:53:35 -0700346 } finally {
Amith Yamasani8d40fac2012-10-23 15:36:16 -0700347 localRawProfile.close();
Amith Yamasaniae47ef42012-09-16 17:53:35 -0700348 }
Amith Yamasani8d40fac2012-10-23 15:36:16 -0700349
350 // Find the structured name for the raw contact.
351 final Cursor structuredName = cr.query(
352 Profile.CONTENT_URI.buildUpon().appendPath(Contacts.Data.CONTENT_DIRECTORY).build(),
Sunny Shao7e866b62019-08-09 11:42:04 +0800353 new String[] {CommonDataKinds.StructuredName.GIVEN_NAME,
354 CommonDataKinds.StructuredName.FAMILY_NAME},
Amith Yamasani8d40fac2012-10-23 15:36:16 -0700355 Data.RAW_CONTACT_ID + "=" + localRowProfileId,
356 null, null);
357 if (structuredName == null) return null;
358
359 try {
360 if (!structuredName.moveToFirst()) {
361 return null;
362 }
363 String partialName = structuredName.getString(0);
364 if (TextUtils.isEmpty(partialName)) {
365 partialName = structuredName.getString(1);
366 }
367 return partialName;
368 } finally {
369 structuredName.close();
370 }
371 }
372
373 private static final String getProfileDisplayName(Context context) {
374 final ContentResolver cr = context.getContentResolver();
375 final Cursor profile = cr.query(Profile.CONTENT_URI,
Sunny Shao7e866b62019-08-09 11:42:04 +0800376 new String[] {Profile.DISPLAY_NAME}, null, null, null);
Amith Yamasani8d40fac2012-10-23 15:36:16 -0700377 if (profile == null) return null;
378
379 try {
380 if (!profile.moveToFirst()) {
381 return null;
382 }
383 return profile.getString(0);
384 } finally {
385 profile.close();
386 }
Amith Yamasaniae47ef42012-09-16 17:53:35 -0700387 }
Amith Yamasani9627a8e2012-09-23 12:54:14 -0700388
Amith Yamasani9627a8e2012-09-23 12:54:14 -0700389 public static boolean hasMultipleUsers(Context context) {
Bonian Chenf399bd12020-01-09 14:50:03 +0800390 return context.getSystemService(UserManager.class)
Amith Yamasani9627a8e2012-09-23 12:54:14 -0700391 .getUsers().size() > 1;
392 }
Fabrice Di Meglio769630c2014-04-24 14:48:48 -0700393
394 /**
Esteban Talavera9b86e9c2017-05-30 16:48:08 +0100395 * Returns the managed profile of the current user or {@code null} if none is found or a profile
396 * exists but it is disabled.
Alexandra Gherghina3939cd72014-06-04 10:02:55 +0100397 */
398 public static UserHandle getManagedProfile(UserManager userManager) {
Bonian Chen5e65da02019-11-08 07:40:35 +0800399 final List<UserHandle> userProfiles = userManager.getUserProfiles();
Aarthi Balachanderd0f83592018-07-10 17:04:53 -0700400 for (UserHandle profile : userProfiles) {
Alexandra Gherghina3939cd72014-06-04 10:02:55 +0100401 if (profile.getIdentifier() == userManager.getUserHandle()) {
402 continue;
403 }
404 final UserInfo userInfo = userManager.getUserInfo(profile.getIdentifier());
405 if (userInfo.isManagedProfile()) {
406 return profile;
407 }
408 }
409 return null;
410 }
411
412 /**
Esteban Talavera9b86e9c2017-05-30 16:48:08 +0100413 * Returns the managed profile of the current user or {@code null} if none is found. Unlike
414 * {@link #getManagedProfile} this method returns enabled and disabled managed profiles.
415 */
416 public static UserHandle getManagedProfileWithDisabled(UserManager userManager) {
417 // TODO: Call getManagedProfileId from here once Robolectric supports
418 // API level 24 and UserManager.getProfileIdsWithDisabled can be Mocked (to avoid having
419 // yet another implementation that loops over user profiles in this method). In the meantime
420 // we need to use UserManager.getProfiles that is available on API 23 (the one currently
421 // used for Settings Robolectric tests).
422 final int myUserId = UserHandle.myUserId();
Bonian Chen5e65da02019-11-08 07:40:35 +0800423 final List<UserInfo> profiles = userManager.getProfiles(myUserId);
Esteban Talavera9b86e9c2017-05-30 16:48:08 +0100424 final int count = profiles.size();
425 for (int i = 0; i < count; i++) {
426 final UserInfo profile = profiles.get(i);
427 if (profile.isManagedProfile()
428 && profile.getUserHandle().getIdentifier() != myUserId) {
429 return profile.getUserHandle();
430 }
431 }
432 return null;
433 }
434
435 /**
Clara Bayarri462cce12016-02-18 12:09:21 +0000436 * Retrieves the id for the given user's managed profile.
437 *
438 * @return the managed profile id or UserHandle.USER_NULL if there is none.
439 */
440 public static int getManagedProfileId(UserManager um, int parentUserId) {
Bonian Chen5e65da02019-11-08 07:40:35 +0800441 final int[] profileIds = um.getProfileIdsWithDisabled(parentUserId);
Fyodor Kupolov4a4af5a2016-04-07 16:46:18 -0700442 for (int profileId : profileIds) {
443 if (profileId != parentUserId) {
444 return profileId;
Clara Bayarri462cce12016-02-18 12:09:21 +0000445 }
446 }
447 return UserHandle.USER_NULL;
448 }
449
450 /**
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100451 * Returns the target user for a Settings activity.
Tony Mak8f41b9b2016-11-23 11:36:18 +0000452 * <p>
453 * User would be retrieved in this order:
454 * <ul>
455 * <li> If this activity is launched from other user, return that user id.
456 * <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 +0800457 * extra in the arguments or intent extras.
Tony Mak8f41b9b2016-11-23 11:36:18 +0000458 * <li> Otherwise, return UserHandle.myUserId().
459 * </ul>
460 * <p>
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100461 * Note: This is secure in the sense that it only returns a target user different to the current
462 * one if the app launching this activity is the Settings app itself, running in the same user
463 * 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 +0100464 */
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100465 public static UserHandle getSecureTargetUser(IBinder activityToken,
Tony Mak8f41b9b2016-11-23 11:36:18 +0000466 UserManager um, @Nullable Bundle arguments, @Nullable Bundle intentExtras) {
Bonian Chen5e65da02019-11-08 07:40:35 +0800467 final UserHandle currentUser = new UserHandle(UserHandle.myUserId());
468 final IActivityManager am = ActivityManager.getService();
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100469 try {
Bonian Chen5e65da02019-11-08 07:40:35 +0800470 final String launchedFromPackage = am.getLaunchedFromPackage(activityToken);
471 final boolean launchedFromSettingsApp =
472 SETTINGS_PACKAGE_NAME.equals(launchedFromPackage);
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100473
Bonian Chen5e65da02019-11-08 07:40:35 +0800474 final UserHandle launchedFromUser = new UserHandle(UserHandle.getUserId(
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100475 am.getLaunchedFromUid(activityToken)));
476 if (launchedFromUser != null && !launchedFromUser.equals(currentUser)) {
477 // Check it's secure
478 if (isProfileOf(um, launchedFromUser)) {
479 return launchedFromUser;
480 }
481 }
Bonian Chen5e65da02019-11-08 07:40:35 +0800482 final UserHandle extrasUser = getUserHandleFromBundle(intentExtras);
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100483 if (extrasUser != null && !extrasUser.equals(currentUser)) {
484 // Check it's secure
485 if (launchedFromSettingsApp && isProfileOf(um, extrasUser)) {
486 return extrasUser;
487 }
488 }
Bonian Chen5e65da02019-11-08 07:40:35 +0800489 final UserHandle argumentsUser = getUserHandleFromBundle(arguments);
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100490 if (argumentsUser != null && !argumentsUser.equals(currentUser)) {
491 // Check it's secure
492 if (launchedFromSettingsApp && isProfileOf(um, argumentsUser)) {
493 return argumentsUser;
494 }
495 }
496 } catch (RemoteException e) {
497 // Should not happen
498 Log.v(TAG, "Could not talk to activity manager.", e);
499 }
500 return currentUser;
Tony Mak8f41b9b2016-11-23 11:36:18 +0000501 }
502
503 /**
504 * Lookup both {@link Intent#EXTRA_USER} and {@link Intent#EXTRA_USER_ID} in the bundle
505 * and return the {@link UserHandle} object. Return {@code null} if nothing is found.
506 */
Sunny Shao7e866b62019-08-09 11:42:04 +0800507 private static @Nullable UserHandle getUserHandleFromBundle(Bundle bundle) {
Tony Mak8f41b9b2016-11-23 11:36:18 +0000508 if (bundle == null) {
509 return null;
510 }
511 final UserHandle user = bundle.getParcelable(EXTRA_USER);
512 if (user != null) {
513 return user;
514 }
515 final int userId = bundle.getInt(EXTRA_USER_ID, -1);
516 if (userId != -1) {
517 return UserHandle.of(userId);
518 }
519 return null;
520 }
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100521
Sunny Shao7e866b62019-08-09 11:42:04 +0800522 /**
523 * Returns true if the user provided is in the same profiles group as the current user.
524 */
525 private static boolean isProfileOf(UserManager um, UserHandle otherUser) {
526 if (um == null || otherUser == null) return false;
527 return (UserHandle.myUserId() == otherUser.getIdentifier())
528 || um.getUserProfiles().contains(otherUser);
529 }
Amith Yamasani51c6dac2014-07-02 00:06:37 +0530530
Alexandra Gherghina95b86a52014-07-24 19:13:25 +0100531 /**
Amith Yamasani45f86232014-11-19 17:12:46 -0800532 * Queries for the UserInfo of a user. Returns null if the user doesn't exist (was removed).
533 * @param userManager Instance of UserManager
Sunny Shao7e866b62019-08-09 11:42:04 +0800534 * @param checkUser The user to check the existence of.
Amith Yamasani45f86232014-11-19 17:12:46 -0800535 * @return UserInfo of the user or null for non-existent user.
536 */
537 public static UserInfo getExistingUser(UserManager userManager, UserHandle checkUser) {
Colin Cross38fa1852020-08-27 04:12:26 +0000538 final List<UserInfo> users = userManager.getAliveUsers();
Amith Yamasani45f86232014-11-19 17:12:46 -0800539 final int checkUserId = checkUser.getIdentifier();
540 for (UserInfo user : users) {
541 if (user.id == checkUserId) {
542 return user;
543 }
544 }
545 return null;
546 }
547
Zoltan Szatmary-Ban3af2e4c2014-12-19 17:17:23 +0000548 public static View inflateCategoryHeader(LayoutInflater inflater, ViewGroup parent) {
549 final TypedArray a = inflater.getContext().obtainStyledAttributes(null,
550 com.android.internal.R.styleable.Preference,
551 com.android.internal.R.attr.preferenceCategoryStyle, 0);
552 final int resId = a.getResourceId(com.android.internal.R.styleable.Preference_layout,
553 0);
554 a.recycle();
555 return inflater.inflate(resId, parent, false);
556 }
557
Christopher Tatea08a2252015-07-01 16:52:43 -0700558 public static ArraySet<String> getHandledDomains(PackageManager pm, String packageName) {
Bonian Chen5e65da02019-11-08 07:40:35 +0800559 final List<IntentFilterVerificationInfo> iviList =
560 pm.getIntentFilterVerifications(packageName);
561 final List<IntentFilter> filters = pm.getAllIntentFilters(packageName);
Christopher Tatea08a2252015-07-01 16:52:43 -0700562
Bonian Chen5e65da02019-11-08 07:40:35 +0800563 final ArraySet<String> result = new ArraySet<>();
Fan Zhang4e540db2017-11-08 13:06:38 -0800564 if (iviList != null && iviList.size() > 0) {
Christopher Tatea08a2252015-07-01 16:52:43 -0700565 for (IntentFilterVerificationInfo ivi : iviList) {
566 for (String host : ivi.getDomains()) {
567 result.add(host);
568 }
569 }
570 }
571 if (filters != null && filters.size() > 0) {
572 for (IntentFilter filter : filters) {
Christopher Tateddaa1422015-07-16 16:00:49 -0700573 if (filter.hasCategory(Intent.CATEGORY_BROWSABLE)
574 && (filter.hasDataScheme(IntentFilter.SCHEME_HTTP) ||
Sunny Shao7e866b62019-08-09 11:42:04 +0800575 filter.hasDataScheme(IntentFilter.SCHEME_HTTPS))) {
Christopher Tatea08a2252015-07-01 16:52:43 -0700576 result.addAll(filter.getHostsList());
577 }
578 }
579 }
580 return result;
581 }
582
Sudheer Shankabc956302015-04-09 12:19:53 +0100583 /**
584 * Returns the application info of the currently installed MDM package.
585 */
586 public static ApplicationInfo getAdminApplicationInfo(Context context, int profileId) {
Bonian Chen5e65da02019-11-08 07:40:35 +0800587 final DevicePolicyManager dpm =
Sudheer Shankabc956302015-04-09 12:19:53 +0100588 (DevicePolicyManager) context.getSystemService(Context.DEVICE_POLICY_SERVICE);
Bonian Chen5e65da02019-11-08 07:40:35 +0800589 final ComponentName mdmPackage = dpm.getProfileOwnerAsUser(profileId);
Sudheer Shankabc956302015-04-09 12:19:53 +0100590 if (mdmPackage == null) {
591 return null;
592 }
Bonian Chen5e65da02019-11-08 07:40:35 +0800593 final String mdmPackageName = mdmPackage.getPackageName();
Sudheer Shankabc956302015-04-09 12:19:53 +0100594 try {
Bonian Chen5e65da02019-11-08 07:40:35 +0800595 final IPackageManager ipm = AppGlobals.getPackageManager();
596 final ApplicationInfo mdmApplicationInfo =
Sudheer Shankabc956302015-04-09 12:19:53 +0100597 ipm.getApplicationInfo(mdmPackageName, 0, profileId);
598 return mdmApplicationInfo;
599 } catch (RemoteException e) {
600 Log.e(TAG, "Error while retrieving application info for package " + mdmPackageName
601 + ", userId " + profileId, e);
602 return null;
603 }
604 }
Jason Monkb45e27b2015-05-20 13:35:43 -0400605
606 public static boolean isBandwidthControlEnabled() {
607 final INetworkManagementService netManager = INetworkManagementService.Stub
608 .asInterface(ServiceManager.getService(Context.NETWORKMANAGEMENT_SERVICE));
609 try {
610 return netManager.isBandwidthControlEnabled();
611 } catch (RemoteException e) {
612 return false;
613 }
614 }
Julia Reynoldsce25af42015-07-08 16:56:31 -0400615
616 /**
617 * Returns an accessible SpannableString.
Sunny Shao7e866b62019-08-09 11:42:04 +0800618 * @param displayText the text to display
Julia Reynoldsce25af42015-07-08 16:56:31 -0400619 * @param accessibileText the text text-to-speech engines should read
620 */
621 public static SpannableString createAccessibleSequence(CharSequence displayText,
622 String accessibileText) {
Bonian Chen5e65da02019-11-08 07:40:35 +0800623 final SpannableString str = new SpannableString(displayText);
Julia Reynoldsce25af42015-07-08 16:56:31 -0400624 str.setSpan(new TtsSpan.TextBuilder(accessibileText).build(), 0,
625 displayText.length(),
626 Spannable.SPAN_INCLUSIVE_INCLUSIVE);
627 return str;
628 }
Andres Morales7bdffd82015-08-04 16:55:00 -0700629
Clara Bayarrife432e82015-10-12 12:07:02 +0100630 /**
Jeff Sharkey219ec912017-12-19 14:57:39 -0700631 * Returns the user id present in the bundle with
632 * {@link Intent#EXTRA_USER_ID} if it belongs to the current user.
Clara Bayarrife432e82015-10-12 12:07:02 +0100633 *
Jeff Sharkey219ec912017-12-19 14:57:39 -0700634 * @throws SecurityException if the given userId does not belong to the
Sunny Shao7e866b62019-08-09 11:42:04 +0800635 * current user group.
Clara Bayarrife432e82015-10-12 12:07:02 +0100636 */
Benjamin Franz194300d2016-01-13 12:16:25 +0000637 public static int getUserIdFromBundle(Context context, Bundle bundle) {
Jeff Sharkey219ec912017-12-19 14:57:39 -0700638 return getUserIdFromBundle(context, bundle, false);
639 }
640
641 /**
642 * Returns the user id present in the bundle with
643 * {@link Intent#EXTRA_USER_ID} if it belongs to the current user.
644 *
645 * @param isInternal indicating if the caller is "internal" to the system,
Sunny Shao7e866b62019-08-09 11:42:04 +0800646 * meaning we're willing to trust extras like
Kevin Chynb13bc502020-07-20 23:35:21 -0700647 * {@link ChooseLockSettingsHelper#EXTRA_KEY_ALLOW_ANY_USER}.
Jeff Sharkey219ec912017-12-19 14:57:39 -0700648 * @throws SecurityException if the given userId does not belong to the
Sunny Shao7e866b62019-08-09 11:42:04 +0800649 * current user group.
Jeff Sharkey219ec912017-12-19 14:57:39 -0700650 */
651 public static int getUserIdFromBundle(Context context, Bundle bundle, boolean isInternal) {
Clara Bayarrife432e82015-10-12 12:07:02 +0100652 if (bundle == null) {
Benjamin Franz194300d2016-01-13 12:16:25 +0000653 return getCredentialOwnerUserId(context);
Clara Bayarrife432e82015-10-12 12:07:02 +0100654 }
Jeff Sharkey219ec912017-12-19 14:57:39 -0700655 final boolean allowAnyUser = isInternal
Kevin Chynb13bc502020-07-20 23:35:21 -0700656 && bundle.getBoolean(ChooseLockSettingsHelper.EXTRA_KEY_ALLOW_ANY_USER, false);
Bonian Chen5e65da02019-11-08 07:40:35 +0800657 final int userId = bundle.getInt(Intent.EXTRA_USER_ID, UserHandle.myUserId());
Adrian Roos5a9a3cd2017-03-30 18:02:25 -0700658 if (userId == LockPatternUtils.USER_FRP) {
Jeff Sharkey219ec912017-12-19 14:57:39 -0700659 return allowAnyUser ? userId : enforceSystemUser(context, userId);
Adrian Roos5a9a3cd2017-03-30 18:02:25 -0700660 } else {
Jeff Sharkey219ec912017-12-19 14:57:39 -0700661 return allowAnyUser ? userId : enforceSameOwner(context, userId);
Adrian Roos5a9a3cd2017-03-30 18:02:25 -0700662 }
663 }
664
665 /**
666 * Returns the given user id if the current user is the system user.
667 *
668 * @throws SecurityException if the current user is not the system user.
669 */
670 public static int enforceSystemUser(Context context, int userId) {
671 if (UserHandle.myUserId() == UserHandle.USER_SYSTEM) {
672 return userId;
673 }
674 throw new SecurityException("Given user id " + userId + " must only be used from "
675 + "USER_SYSTEM, but current user is " + UserHandle.myUserId());
Clara Bayarrife432e82015-10-12 12:07:02 +0100676 }
677
678 /**
679 * Returns the given user id if it belongs to the current user.
680 *
681 * @throws SecurityException if the given userId does not belong to the current user group.
682 */
Benjamin Franz194300d2016-01-13 12:16:25 +0000683 public static int enforceSameOwner(Context context, int userId) {
Bonian Chenf399bd12020-01-09 14:50:03 +0800684 final UserManager um = context.getSystemService(UserManager.class);
Ricky Wai72500162016-06-07 16:54:25 +0100685 final int[] profileIds = um.getProfileIdsWithDisabled(UserHandle.myUserId());
686 if (ArrayUtils.contains(profileIds, userId)) {
687 return userId;
Clara Bayarrife432e82015-10-12 12:07:02 +0100688 }
Ricky Wai72500162016-06-07 16:54:25 +0100689 throw new SecurityException("Given user id " + userId + " does not belong to user "
690 + UserHandle.myUserId());
Clara Bayarrife432e82015-10-12 12:07:02 +0100691 }
692
Benjamin Franz194300d2016-01-13 12:16:25 +0000693 /**
694 * Returns the effective credential owner of the calling user.
695 */
696 public static int getCredentialOwnerUserId(Context context) {
697 return getCredentialOwnerUserId(context, UserHandle.myUserId());
698 }
699
700 /**
701 * Returns the user id of the credential owner of the given user id.
702 */
703 public static int getCredentialOwnerUserId(Context context, int userId) {
Bonian Chenf399bd12020-01-09 14:50:03 +0800704 final UserManager um = context.getSystemService(UserManager.class);
Benjamin Franz194300d2016-01-13 12:16:25 +0000705 return um.getCredentialOwnerProfile(userId);
Andres Morales7bdffd82015-08-04 16:55:00 -0700706 }
Jason Monkdb4ed192015-12-11 16:48:31 -0500707
Alex Johnston403c3302020-01-07 15:40:05 +0000708 /**
709 * Returns the credential type of the given user id.
710 */
711 public static @LockPatternUtils.CredentialType int getCredentialType(Context context,
712 int userId) {
713 final LockPatternUtils lpu = new LockPatternUtils(context);
714 return lpu.getCredentialTypeForUser(userId);
715 }
716
Jason Monkb37e2882016-01-11 14:27:20 -0500717 private static final StringBuilder sBuilder = new StringBuilder(50);
718 private static final java.util.Formatter sFormatter = new java.util.Formatter(
719 sBuilder, Locale.getDefault());
720
721 public static String formatDateRange(Context context, long start, long end) {
722 final int flags = FORMAT_SHOW_DATE | FORMAT_ABBREV_MONTH;
723
724 synchronized (sBuilder) {
725 sBuilder.setLength(0);
726 return DateUtils.formatDateRange(context, sFormatter, start, end, flags, null)
727 .toString();
728 }
729 }
Jason Monk91e2f892016-02-23 15:31:09 -0500730
Bernard Chau88d523b2016-04-14 15:08:28 +0100731 public static boolean startQuietModeDialogIfNecessary(Context context, UserManager um,
Ricky Wai616342b2016-04-13 10:40:22 +0100732 int userId) {
733 if (um.isQuietModeEnabled(UserHandle.of(userId))) {
734 final Intent intent = UnlaunchableAppActivity.createInQuietModeDialogIntent(userId);
735 context.startActivity(intent);
736 return true;
737 }
738 return false;
739 }
Sudheer Shankac3eb16e2016-04-21 12:51:43 -0700740
Rubin Xu3231afe2016-08-24 10:15:07 +0100741 public static boolean unlockWorkProfileIfNecessary(Context context, int userId) {
742 try {
Sudheer Shankaacb1a612016-11-10 15:30:14 -0800743 if (!ActivityManager.getService().isUserRunning(userId,
Rubin Xu3231afe2016-08-24 10:15:07 +0100744 ActivityManager.FLAG_AND_LOCKED)) {
745 return false;
746 }
747 } catch (RemoteException e) {
748 return false;
749 }
750 if (!(new LockPatternUtils(context)).isSecure(userId)) {
751 return false;
752 }
Robin Leecccf3242017-02-10 15:32:49 +0000753 return confirmWorkProfileCredentials(context, userId);
754 }
755
Robin Leecccf3242017-02-10 15:32:49 +0000756 private static boolean confirmWorkProfileCredentials(Context context, int userId) {
Rubin Xu3231afe2016-08-24 10:15:07 +0100757 final KeyguardManager km = (KeyguardManager) context.getSystemService(
758 Context.KEYGUARD_SERVICE);
759 final Intent unlockIntent = km.createConfirmDeviceCredentialIntent(null, null, userId);
760 if (unlockIntent != null) {
761 context.startActivity(unlockIntent);
762 return true;
763 } else {
764 return false;
765 }
Rubin Xu3231afe2016-08-24 10:15:07 +0100766 }
767
Sudheer Shankac3eb16e2016-04-21 12:51:43 -0700768 public static CharSequence getApplicationLabel(Context context, String packageName) {
769 try {
770 final ApplicationInfo appInfo = context.getPackageManager().getApplicationInfo(
771 packageName,
772 PackageManager.MATCH_DISABLED_COMPONENTS
Sunny Shao7e866b62019-08-09 11:42:04 +0800773 | PackageManager.MATCH_ANY_USER);
Sudheer Shankac3eb16e2016-04-21 12:51:43 -0700774 return appInfo.loadLabel(context.getPackageManager());
775 } catch (PackageManager.NameNotFoundException e) {
Raff Tsai376ce872020-01-06 00:42:35 +0800776 Log.e(TAG, "Unable to find info for package: " + packageName);
Sudheer Shankac3eb16e2016-04-21 12:51:43 -0700777 }
778 return null;
779 }
Jason Monk75199542016-05-06 15:09:32 -0400780
Jeff Sharkey4a8136b2016-07-27 12:53:34 -0600781 public static boolean isPackageDirectBootAware(Context context, String packageName) {
782 try {
783 final ApplicationInfo ai = context.getPackageManager().getApplicationInfo(
784 packageName, 0);
785 return ai.isDirectBootAware() || ai.isPartiallyDirectBootAware();
786 } catch (NameNotFoundException ignored) {
787 }
788 return false;
789 }
Andre Lago3e398c82016-07-25 14:12:28 +0100790
791 /**
792 * Returns a context created from the given context for the given user, or null if it fails
793 */
794 public static Context createPackageContextAsUser(Context context, int userId) {
795 try {
796 return context.createPackageContextAsUser(
797 context.getPackageName(), 0 /* flags */, UserHandle.of(userId));
798 } catch (PackageManager.NameNotFoundException e) {
799 Log.e(TAG, "Failed to create user context", e);
800 }
801 return null;
802 }
Jeff Sharkeyab508072016-10-11 14:25:22 -0600803
804 public static FingerprintManager getFingerprintManagerOrNull(Context context) {
805 if (context.getPackageManager().hasSystemFeature(PackageManager.FEATURE_FINGERPRINT)) {
Fan Zhangcf97f0b2018-01-05 11:18:44 -0800806 return (FingerprintManager) context.getSystemService(Context.FINGERPRINT_SERVICE);
Jeff Sharkeyab508072016-10-11 14:25:22 -0600807 } else {
808 return null;
809 }
810 }
Daniel Nishi31027da2017-01-19 14:03:57 -0800811
Kevin Chyn82792cc2017-07-20 00:15:44 -0700812 public static boolean hasFingerprintHardware(Context context) {
Bonian Chen5e65da02019-11-08 07:40:35 +0800813 final FingerprintManager fingerprintManager = getFingerprintManagerOrNull(context);
Kevin Chyn82792cc2017-07-20 00:15:44 -0700814 return fingerprintManager != null && fingerprintManager.isHardwareDetected();
815 }
816
Kevin Chyn4882e872018-06-25 17:58:31 -0700817 public static FaceManager getFaceManagerOrNull(Context context) {
818 if (context.getPackageManager().hasSystemFeature(PackageManager.FEATURE_FACE)) {
819 return (FaceManager) context.getSystemService(Context.FACE_SERVICE);
820 } else {
821 return null;
822 }
823 }
824
825 public static boolean hasFaceHardware(Context context) {
Bonian Chen5e65da02019-11-08 07:40:35 +0800826 final FaceManager faceManager = getFaceManagerOrNull(context);
Kevin Chyn4882e872018-06-25 17:58:31 -0700827 return faceManager != null && faceManager.isHardwareDetected();
828 }
829
Daniel Nishi31027da2017-01-19 14:03:57 -0800830 /**
831 * Launches an intent which may optionally have a user id defined.
832 * @param fragment Fragment to use to launch the activity.
Sunny Shao7e866b62019-08-09 11:42:04 +0800833 * @param intent Intent to launch.
Daniel Nishi31027da2017-01-19 14:03:57 -0800834 */
835 public static void launchIntent(Fragment fragment, Intent intent) {
836 try {
837 final int userId = intent.getIntExtra(Intent.EXTRA_USER_ID, -1);
838
839 if (userId == -1) {
840 fragment.startActivity(intent);
841 } else {
842 fragment.getActivity().startActivityAsUser(intent, new UserHandle(userId));
843 }
844 } catch (ActivityNotFoundException e) {
845 Log.w(TAG, "No activity found for " + intent);
846 }
847 }
848
Christine Franksc6890ab2017-06-23 14:28:21 -0700849 public static boolean isDemoUser(Context context) {
Bonian Chenf399bd12020-01-09 14:50:03 +0800850 return UserManager.isDeviceInDemoMode(context)
851 && context.getSystemService(UserManager.class).isDemoUser();
Christine Franksc6890ab2017-06-23 14:28:21 -0700852 }
853
Justin Klaassen30257272017-08-08 21:58:05 -0700854 public static ComponentName getDeviceOwnerComponent(Context context) {
855 final DevicePolicyManager dpm = (DevicePolicyManager) context.getSystemService(
856 Context.DEVICE_POLICY_SERVICE);
857 return dpm.getDeviceOwnerComponentOnAnyUser();
Christine Franks14782222017-01-23 16:44:02 -0800858 }
Daniel Nishidfed8a22017-01-19 16:32:41 -0800859
860 /**
861 * Returns if a given user is a profile of another user.
Sunny Shao7e866b62019-08-09 11:42:04 +0800862 * @param user The user whose profiles wibe checked.
Daniel Nishidfed8a22017-01-19 16:32:41 -0800863 * @param profile The (potential) profile.
864 * @return if the profile is actually a profile
865 */
866 public static boolean isProfileOf(UserInfo user, UserInfo profile) {
867 return user.id == profile.id ||
868 (user.profileGroupId != UserInfo.NO_PROFILE_GROUP_ID
869 && user.profileGroupId == profile.profileGroupId);
870 }
Daniel Nishi9f60f422017-02-15 15:25:48 -0800871
872 /**
873 * Tries to initalize a volume with the given bundle. If it is a valid, private, and readable
874 * {@link VolumeInfo}, it is returned. If it is not valid, null is returned.
875 */
876 @Nullable
877 public static VolumeInfo maybeInitializeVolume(StorageManager sm, Bundle bundle) {
878 final String volumeId = bundle.getString(VolumeInfo.EXTRA_VOLUME_ID,
879 VolumeInfo.ID_PRIVATE_INTERNAL);
Bonian Chen5e65da02019-11-08 07:40:35 +0800880 final VolumeInfo volume = sm.findVolumeById(volumeId);
Daniel Nishi9f60f422017-02-15 15:25:48 -0800881 return isVolumeValid(volume) ? volume : null;
882 }
883
jackqdyuleiddba9662017-03-08 19:35:02 -0800884 /**
jackqdyulei00015fb2017-08-22 11:25:30 -0700885 * Return {@code true} if the supplied package is device owner or profile owner of at
886 * least one user.
Sunny Shao7e866b62019-08-09 11:42:04 +0800887 * @param userManager used to get profile owner app for each user
jackqdyulei00015fb2017-08-22 11:25:30 -0700888 * @param devicePolicyManager used to check whether it is device owner app
Sunny Shao7e866b62019-08-09 11:42:04 +0800889 * @param packageName package to check about
jackqdyulei00015fb2017-08-22 11:25:30 -0700890 */
891 public static boolean isProfileOrDeviceOwner(UserManager userManager,
Fan Zhangaab36de2018-03-30 16:58:28 -0700892 DevicePolicyManager devicePolicyManager, String packageName) {
Bonian Chen5e65da02019-11-08 07:40:35 +0800893 final List<UserInfo> userInfos = userManager.getUsers();
jackqdyulei00015fb2017-08-22 11:25:30 -0700894 if (devicePolicyManager.isDeviceOwnerAppOnAnyUser(packageName)) {
895 return true;
896 }
897 for (int i = 0, size = userInfos.size(); i < size; i++) {
Bonian Chen5e65da02019-11-08 07:40:35 +0800898 final ComponentName cn = devicePolicyManager
899 .getProfileOwnerAsUser(userInfos.get(i).id);
jackqdyulei00015fb2017-08-22 11:25:30 -0700900 if (cn != null && cn.getPackageName().equals(packageName)) {
901 return true;
902 }
903 }
904 return false;
905 }
906
907 /**
Alex Johnston341f9952020-02-26 15:54:11 +0000908 * Return {@code true} if the supplied package is the device owner or profile owner of a
909 * given user.
910 *
911 * @param devicePolicyManager used to check whether it is device owner and profile owner app
912 * @param packageName package to check about
913 * @param userId the if of the relevant user
914 */
915 public static boolean isProfileOrDeviceOwner(DevicePolicyManager devicePolicyManager,
916 String packageName, int userId) {
917 if ((devicePolicyManager.getDeviceOwnerUserId() == userId)
918 && devicePolicyManager.isDeviceOwnerApp(packageName)) {
919 return true;
920 }
921 final ComponentName cn = devicePolicyManager.getProfileOwnerAsUser(userId);
922 if (cn != null && cn.getPackageName().equals(packageName)) {
923 return true;
924 }
925 return false;
926 }
927
928 /**
jackqdyuleiddba9662017-03-08 19:35:02 -0800929 * Return the resource id to represent the install status for an app
930 */
931 @StringRes
932 public static int getInstallationStatus(ApplicationInfo info) {
933 if ((info.flags & ApplicationInfo.FLAG_INSTALLED) == 0) {
934 return R.string.not_installed;
935 }
936 return info.enabled ? R.string.installed : R.string.disabled;
937 }
938
Daniel Nishi9f60f422017-02-15 15:25:48 -0800939 private static boolean isVolumeValid(VolumeInfo volume) {
940 return (volume != null) && (volume.getType() == VolumeInfo.TYPE_PRIVATE)
941 && volume.isMountedReadable();
942 }
jackqdyuleif4c1cef2017-03-31 12:57:10 -0700943
PMS2263a05602017-06-14 07:10:15 +0000944 public static void setEditTextCursorPosition(EditText editText) {
945 editText.setSelection(editText.getText().length());
946 }
Felipe Lemebd884502017-09-15 18:16:21 -0700947
948 /**
949 * Sets the preference icon with a drawable that is scaled down to to avoid crashing Settings if
950 * it's too big.
951 */
952 public static void setSafeIcon(Preference pref, Drawable icon) {
953 Drawable safeIcon = icon;
Phil Weaver5a3e02d2018-03-08 17:38:46 -0800954 if ((icon != null) && !(icon instanceof VectorDrawable)) {
Felipe Lemebd884502017-09-15 18:16:21 -0700955 safeIcon = getSafeDrawable(icon, 500, 500);
956 }
957 pref.setIcon(safeIcon);
958 }
959
960 /**
961 * Gets a drawable with a limited size to avoid crashing Settings if it's too big.
962 *
Sunny Shao7e866b62019-08-09 11:42:04 +0800963 * @param original original drawable, typically an app icon.
964 * @param maxWidth maximum width, in pixels.
Felipe Lemebd884502017-09-15 18:16:21 -0700965 * @param maxHeight maximum height, in pixels.
966 */
967 public static Drawable getSafeDrawable(Drawable original, int maxWidth, int maxHeight) {
968 final int actualWidth = original.getMinimumWidth();
969 final int actualHeight = original.getMinimumHeight();
970
971 if (actualWidth <= maxWidth && actualHeight <= maxHeight) {
972 return original;
973 }
974
Bonian Chen5e65da02019-11-08 07:40:35 +0800975 final float scaleWidth = ((float) maxWidth) / actualWidth;
976 final float scaleHeight = ((float) maxHeight) / actualHeight;
977 final float scale = Math.min(scaleWidth, scaleHeight);
Felipe Lemebd884502017-09-15 18:16:21 -0700978 final int width = (int) (actualWidth * scale);
979 final int height = (int) (actualHeight * scale);
980
981 final Bitmap bitmap;
982 if (original instanceof BitmapDrawable) {
983 bitmap = Bitmap.createScaledBitmap(((BitmapDrawable) original).getBitmap(), width,
984 height, false);
985 } else {
Jason Chiuc78c54a2019-02-13 16:07:57 +0800986 bitmap = createBitmap(original, width, height);
Felipe Lemebd884502017-09-15 18:16:21 -0700987 }
988 return new BitmapDrawable(null, bitmap);
989 }
jackqdyuleifde637f2018-01-02 14:51:01 -0800990
991 /**
Jason Chiuc78c54a2019-02-13 16:07:57 +0800992 * Create an Icon pointing to a drawable.
Jason Chiu1217bbe2019-01-24 16:32:31 +0800993 */
Jason Chiuc78c54a2019-02-13 16:07:57 +0800994 public static IconCompat createIconWithDrawable(Drawable drawable) {
995 Bitmap bitmap;
Jason Chiu1217bbe2019-01-24 16:32:31 +0800996 if (drawable instanceof BitmapDrawable) {
Sunny Shao7e866b62019-08-09 11:42:04 +0800997 bitmap = ((BitmapDrawable)drawable).getBitmap();
Jason Chiuc78c54a2019-02-13 16:07:57 +0800998 } else {
999 final int width = drawable.getIntrinsicWidth();
1000 final int height = drawable.getIntrinsicHeight();
1001 bitmap = createBitmap(drawable,
1002 width > 0 ? width : 1,
1003 height > 0 ? height : 1);
Jason Chiu1217bbe2019-01-24 16:32:31 +08001004 }
Jason Chiuc78c54a2019-02-13 16:07:57 +08001005 return IconCompat.createWithBitmap(bitmap);
1006 }
Jason Chiu1217bbe2019-01-24 16:32:31 +08001007
clownshen24827d32019-03-29 20:22:02 +08001008 /**
1009 * Creates a drawable with specified width and height.
1010 */
1011 public static Bitmap createBitmap(Drawable drawable, int width, int height) {
Jason Chiuc78c54a2019-02-13 16:07:57 +08001012 final Bitmap bitmap = Bitmap.createBitmap(width, height, Bitmap.Config.ARGB_8888);
Jason Chiu1217bbe2019-01-24 16:32:31 +08001013 final Canvas canvas = new Canvas(bitmap);
1014 drawable.setBounds(0, 0, canvas.getWidth(), canvas.getHeight());
1015 drawable.draw(canvas);
1016 return bitmap;
1017 }
1018
1019 /**
jackqdyuleifde637f2018-01-02 14:51:01 -08001020 * Get the {@link Drawable} that represents the app icon
1021 */
1022 public static Drawable getBadgedIcon(IconDrawableFactory iconDrawableFactory,
1023 PackageManager packageManager, String packageName, int userId) {
1024 try {
Tony Mak4e292812018-03-19 15:37:21 +00001025 final ApplicationInfo appInfo = packageManager.getApplicationInfoAsUser(
1026 packageName, PackageManager.GET_META_DATA, userId);
jackqdyuleifde637f2018-01-02 14:51:01 -08001027 return iconDrawableFactory.getBadgedIcon(appInfo, userId);
1028 } catch (PackageManager.NameNotFoundException e) {
1029 return packageManager.getDefaultActivityIcon();
1030 }
1031 }
Raff Tsai2928cd42018-11-05 16:10:19 +08001032
1033 /** Returns true if the current package is installed & enabled. */
1034 public static boolean isPackageEnabled(Context context, String packageName) {
1035 try {
1036 return context.getPackageManager().getApplicationInfo(packageName, 0).enabled;
1037 } catch (Exception e) {
1038 Log.e(TAG, "Error while retrieving application info for package " + packageName, e);
1039 }
1040 return false;
1041 }
markchien1dd1d792019-01-11 16:18:20 +08001042
1043 /** Get {@link Resources} by subscription id if subscription id is valid. */
1044 public static Resources getResourcesForSubId(Context context, int subId) {
1045 if (subId != SubscriptionManager.INVALID_SUBSCRIPTION_ID) {
1046 return SubscriptionManager.getResourcesForSubId(context, subId);
1047 } else {
1048 return context.getResources();
1049 }
1050 }
Ng Zhi Anb97bdc32019-02-01 12:39:31 -08001051
1052 /**
1053 * Returns true if SYSTEM_ALERT_WINDOW permission is available.
1054 * Starting from Q, SYSTEM_ALERT_WINDOW is disabled on low ram phones.
1055 */
1056 public static boolean isSystemAlertWindowEnabled(Context context) {
1057 // SYSTEM_ALERT_WINDOW is disabled on on low ram devices starting from Q
1058 ActivityManager am = (ActivityManager) context.getSystemService(Context.ACTIVITY_SERVICE);
1059 return !(am.isLowRamDevice() && (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q));
1060 }
tmfangaed8f362019-03-18 16:56:09 +08001061
1062 /**
1063 * Adds a shadow appear/disappear animation to action bar scroll.
1064 *
1065 * <p/>
1066 * This method must be called after {@link Fragment#onCreate(Bundle)}.
1067 */
1068 public static void setActionBarShadowAnimation(Activity activity, Lifecycle lifecycle,
1069 View scrollView) {
1070 if (activity == null) {
1071 Log.w(TAG, "No activity, cannot style actionbar.");
1072 return;
1073 }
1074 final ActionBar actionBar = activity.getActionBar();
1075 if (actionBar == null) {
1076 Log.w(TAG, "No actionbar, cannot style actionbar.");
1077 return;
1078 }
1079 actionBar.setElevation(0);
1080
1081 if (lifecycle != null && scrollView != null) {
1082 ActionBarShadowController.attachToView(activity, lifecycle, scrollView);
1083 }
1084 }
Raff Tsaiafd494d2019-10-16 15:25:21 +08001085
1086 /**
1087 * Return correct target fragment based on argument
1088 *
1089 * @param activity the activity target fragment will be launched.
1090 * @param fragmentName initial target fragment name.
1091 * @param args fragment launch arguments.
1092 */
1093 public static Fragment getTargetFragment(Activity activity, String fragmentName, Bundle args) {
1094 Fragment f = null;
Raff Tsai84327f62019-11-15 11:02:25 +08001095 final boolean isPersonal = args != null ? args.getInt(ProfileSelectFragment.EXTRA_PROFILE)
Raff Tsai1e5d8142019-12-12 11:45:41 +08001096 == ProfileSelectFragment.ProfileType.PERSONAL : false;
Raff Tsai84327f62019-11-15 11:02:25 +08001097 final boolean isWork = args != null ? args.getInt(ProfileSelectFragment.EXTRA_PROFILE)
Raff Tsai1e5d8142019-12-12 11:45:41 +08001098 == ProfileSelectFragment.ProfileType.WORK : false;
Raff Tsai3fbdf342020-01-16 05:27:32 +08001099 if (activity.getSystemService(UserManager.class).getUserProfiles().size() > 1
Raff Tsaiafd494d2019-10-16 15:25:21 +08001100 && ProfileFragmentBridge.FRAGMENT_MAP.get(fragmentName) != null
Raff Tsai84327f62019-11-15 11:02:25 +08001101 && !isWork && !isPersonal) {
Raff Tsaiafd494d2019-10-16 15:25:21 +08001102 f = Fragment.instantiate(activity, ProfileFragmentBridge.FRAGMENT_MAP.get(fragmentName),
1103 args);
1104 } else {
1105 f = Fragment.instantiate(activity, fragmentName, args);
1106 }
1107 return f;
1108 }
Yanting Yang96127fe2020-03-20 12:04:09 +08001109
1110 /**
1111 * Returns true if current binder uid is Settings Intelligence.
1112 */
1113 public static boolean isSettingsIntelligence(Context context) {
1114 final int callingUid = Binder.getCallingUid();
1115 final String callingPackage = context.getPackageManager().getPackagesForUid(callingUid)[0];
1116 final boolean isSettingsIntelligence = TextUtils.equals(callingPackage,
1117 context.getString(R.string.config_settingsintelligence_package_name));
1118 return isSettingsIntelligence;
1119 }
Jason Chiu8ac1e4d2020-05-11 16:13:47 +08001120
1121 /**
1122 * Returns true if the night mode is enabled.
1123 */
1124 public static boolean isNightMode(Context context) {
1125 final int currentNightMode =
1126 context.getResources().getConfiguration().uiMode & Configuration.UI_MODE_NIGHT_MASK;
1127 return currentNightMode == Configuration.UI_MODE_NIGHT_YES;
1128 }
Tim Pengdf467882020-06-24 13:10:01 +08001129
1130 /**
1131 * Returns a bitmap with rounded corner.
1132 *
1133 * @param context application context.
1134 * @param source bitmap to apply round corner.
1135 * @param cornerRadius corner radius value.
1136 */
1137 public static Bitmap convertCornerRadiusBitmap(@NonNull Context context,
1138 @NonNull Bitmap source, @NonNull float cornerRadius) {
1139 final Bitmap roundedBitmap = Bitmap.createBitmap(source.getWidth(), source.getHeight(),
1140 Bitmap.Config.ARGB_8888);
1141 final RoundedBitmapDrawable drawable =
1142 RoundedBitmapDrawableFactory.create(context.getResources(), source);
1143 drawable.setAntiAlias(true);
1144 drawable.setCornerRadius(cornerRadius);
1145 final Canvas canvas = new Canvas(roundedBitmap);
1146 drawable.setBounds(0, 0, canvas.getWidth(), canvas.getHeight());
1147 drawable.draw(canvas);
1148 return roundedBitmap;
1149 }
Zoey Chen3abe48e2020-10-28 22:46:48 +08001150
1151 public static boolean isProviderModelEnabled(Context context) {
1152 return FeatureFlagUtils.isEnabled(context, FeatureFlagUtils.SETTINGS_PROVIDER_MODEL);
1153 }
1154
Jeff Sharkey4a8136b2016-07-27 12:53:34 -06001155}