blob: 8a96484ad9756532d81b41dac3ec35050dda23d1 [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;
Anders Hammar1b2dd9032010-04-08 10:03:50 +020045import android.content.res.Resources;
Jason Monkb5aa73f2015-03-31 12:59:33 -040046import android.content.res.TypedArray;
Amith Yamasaniae47ef42012-09-16 17:53:35 -070047import android.database.Cursor;
Amith Yamasanif34a85d2012-09-17 18:31:45 -070048import android.graphics.Bitmap;
Felipe Lemebd884502017-09-15 18:16:21 -070049import android.graphics.Canvas;
50import android.graphics.drawable.BitmapDrawable;
51import android.graphics.drawable.Drawable;
Phil Weaver5a3e02d2018-03-08 17:38:46 -080052import android.graphics.drawable.VectorDrawable;
Kevin Chyn4882e872018-06-25 17:58:31 -070053import android.hardware.face.FaceManager;
Jeff Sharkeyab508072016-10-11 14:25:22 -060054import android.hardware.fingerprint.FingerprintManager;
Amith Yamasanic06d4c42011-02-25 14:35:20 -080055import android.net.ConnectivityManager;
56import android.net.LinkProperties;
Jaewoong Jungc260e6d2016-10-13 14:21:52 -070057import android.net.Network;
Jaewoong Jungc260e6d2016-10-13 14:21:52 -070058import android.net.wifi.WifiManager;
Amith Yamasania4379d62011-07-22 10:34:58 -070059import android.os.BatteryManager;
Ng Zhi Anb97bdc32019-02-01 12:39:31 -080060import android.os.Build;
Anders Hammar1b2dd9032010-04-08 10:03:50 +020061import android.os.Bundle;
Alexandra Gherghina1eb3f312014-06-10 14:01:10 +010062import android.os.IBinder;
Jason Monkb45e27b2015-05-20 13:35:43 -040063import android.os.INetworkManagementService;
Alexandra Gherghina1eb3f312014-06-10 14:01:10 +010064import android.os.RemoteException;
Jason Monkb45e27b2015-05-20 13:35:43 -040065import android.os.ServiceManager;
Amith Yamasaniae47ef42012-09-16 17:53:35 -070066import android.os.UserHandle;
67import android.os.UserManager;
Fabrice Di Megliodff3faa2015-02-27 11:14:11 -080068import android.os.storage.StorageManager;
Daniel Nishi9f60f422017-02-15 15:25:48 -080069import android.os.storage.VolumeInfo;
Jeff Sharkeyb654cbb2011-08-18 11:59:19 -070070import android.preference.PreferenceFrameLayout;
Amith Yamasani8d40fac2012-10-23 15:36:16 -070071import android.provider.ContactsContract.CommonDataKinds;
Amith Yamasaniae47ef42012-09-16 17:53:35 -070072import android.provider.ContactsContract.Contacts;
Amith Yamasani8d40fac2012-10-23 15:36:16 -070073import android.provider.ContactsContract.Data;
Amith Yamasaniae47ef42012-09-16 17:53:35 -070074import android.provider.ContactsContract.Profile;
Amith Yamasani8d40fac2012-10-23 15:36:16 -070075import android.provider.ContactsContract.RawContacts;
markchien1dd1d792019-01-11 16:18:20 +080076import android.telephony.SubscriptionManager;
Amith Yamasani60133dd2010-09-11 14:17:31 -070077import android.telephony.TelephonyManager;
Julia Reynoldsce25af42015-07-08 16:56:31 -040078import android.text.Spannable;
79import android.text.SpannableString;
Anders Hammar1b2dd9032010-04-08 10:03:50 +020080import android.text.TextUtils;
Jason Monkb37e2882016-01-11 14:27:20 -050081import android.text.format.DateUtils;
Julia Reynoldsce25af42015-07-08 16:56:31 -040082import android.text.style.TtsSpan;
Christopher Tatea08a2252015-07-01 16:52:43 -070083import android.util.ArraySet;
jackqdyuleifde637f2018-01-02 14:51:01 -080084import android.util.IconDrawableFactory;
Alexandra Gherghina1eb3f312014-06-10 14:01:10 +010085import android.util.Log;
Zoltan Szatmary-Ban3af2e4c2014-12-19 17:17:23 +000086import android.view.LayoutInflater;
Jeff Sharkeyb654cbb2011-08-18 11:59:19 -070087import android.view.View;
88import android.view.ViewGroup;
PMS2263a05602017-06-14 07:10:15 +000089import android.widget.EditText;
Jeff Sharkeyb654cbb2011-08-18 11:59:19 -070090import android.widget.ListView;
91import android.widget.TabWidget;
Fan Zhangcc335d92016-09-29 14:37:14 -070092
Fan Zhang23f8d592018-08-28 15:11:40 -070093import androidx.annotation.StringRes;
Jason Chiuc78c54a2019-02-13 16:07:57 +080094import androidx.core.graphics.drawable.IconCompat;
Fan Zhang23f8d592018-08-28 15:11:40 -070095import androidx.fragment.app.Fragment;
tmfangaed8f362019-03-18 16:56:09 +080096import androidx.lifecycle.Lifecycle;
Fan Zhang23f8d592018-08-28 15:11:40 -070097import androidx.preference.Preference;
98import androidx.preference.PreferenceGroup;
99
Ricky Wai616342b2016-04-13 10:40:22 +0100100import com.android.internal.app.UnlaunchableAppActivity;
Ricky Wai72500162016-06-07 16:54:25 +0100101import com.android.internal.util.ArrayUtils;
Rubin Xu3231afe2016-08-24 10:15:07 +0100102import com.android.internal.widget.LockPatternUtils;
Raff Tsaiafd494d2019-10-16 15:25:21 +0800103import com.android.settings.dashboard.profileselector.ProfileFragmentBridge;
Raff Tsai84327f62019-11-15 11:02:25 +0800104import com.android.settings.dashboard.profileselector.ProfileSelectFragment;
Jeff Sharkey219ec912017-12-19 14:57:39 -0700105import com.android.settings.password.ChooseLockSettingsHelper;
tmfangaed8f362019-03-18 16:56:09 +0800106import com.android.settingslib.widget.ActionBarShadowController;
Daisuke Miyakawaa2633d02010-09-15 20:09:12 -0700107
Amith Yamasanic06d4c42011-02-25 14:35:20 -0800108import java.net.InetAddress;
109import java.util.Iterator;
Daisuke Miyakawaa2633d02010-09-15 20:09:12 -0700110import java.util.List;
Jean Chalard71ad1f42011-05-12 15:06:16 +0900111import java.util.Locale;
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800112
Jason Monk27985e12016-01-08 14:13:05 -0500113public final class Utils extends com.android.settingslib.Utils {
114
Alexandra Gherghina1eb3f312014-06-10 14:01:10 +0100115 private static final String TAG = "Settings";
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100116
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800117 /**
118 * Set the preference's title to the matching activity's label.
119 */
120 public static final int UPDATE_PREFERENCE_FLAG_SET_TITLE_TO_MATCHING_ACTIVITY = 1;
121
Fan Zhangc3fd2892019-01-29 16:00:19 -0800122 public static final String SETTINGS_PACKAGE_NAME = "com.android.settings";
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100123
Jason Monkbeb171d2015-05-21 15:24:37 -0400124 public static final String OS_PKG = "os";
125
Anders Hammar1b2dd9032010-04-08 10:03:50 +0200126 /**
Svet Ganov864765f2019-04-05 19:00:05 -0700127 * Whether to disable the new device identifier access restrictions.
128 */
129 public static final String PROPERTY_DEVICE_IDENTIFIER_ACCESS_RESTRICTIONS_DISABLED =
130 "device_identifier_access_restrictions_disabled";
131
132 /**
Joel Galenson2118f8a2019-05-31 07:54:20 -0700133 * Whether to show the Permissions Hub.
134 */
135 public static final String PROPERTY_PERMISSIONS_HUB_ENABLED = "permissions_hub_enabled";
136
137 /**
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800138 * Finds a matching activity for a preference's intent. If a matching
139 * activity is not found, it will remove the preference.
Ying Wanga7188322010-01-04 18:45:10 -0800140 *
Sunny Shao7e866b62019-08-09 11:42:04 +0800141 * @param context The context.
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800142 * @param parentPreferenceGroup The preference group that contains the
Sunny Shao7e866b62019-08-09 11:42:04 +0800143 * preference whose intent is being resolved.
144 * @param preferenceKey The key of the preference whose intent is being
145 * resolved.
146 * @param flags 0 or one or more of
147 * {@link #UPDATE_PREFERENCE_FLAG_SET_TITLE_TO_MATCHING_ACTIVITY}
148 * .
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800149 * @return Whether an activity was found. If false, the preference was
Sunny Shao7e866b62019-08-09 11:42:04 +0800150 * removed.
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800151 */
152 public static boolean updatePreferenceToSpecificActivityOrRemove(Context context,
153 PreferenceGroup parentPreferenceGroup, String preferenceKey, int flags) {
Ying Wanga7188322010-01-04 18:45:10 -0800154
Bonian Chen5e65da02019-11-08 07:40:35 +0800155 final Preference preference = parentPreferenceGroup.findPreference(preferenceKey);
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800156 if (preference == null) {
157 return false;
158 }
Ying Wanga7188322010-01-04 18:45:10 -0800159
Bonian Chen5e65da02019-11-08 07:40:35 +0800160 final Intent intent = preference.getIntent();
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800161 if (intent != null) {
162 // Find the activity that is in the system image
Bonian Chen5e65da02019-11-08 07:40:35 +0800163 final PackageManager pm = context.getPackageManager();
164 final List<ResolveInfo> list = pm.queryIntentActivities(intent, 0);
165 final int listSize = list.size();
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800166 for (int i = 0; i < listSize; i++) {
Bonian Chen5e65da02019-11-08 07:40:35 +0800167 final ResolveInfo resolveInfo = list.get(i);
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800168 if ((resolveInfo.activityInfo.applicationInfo.flags & ApplicationInfo.FLAG_SYSTEM)
169 != 0) {
Ying Wanga7188322010-01-04 18:45:10 -0800170
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800171 // Replace the intent with this specific activity
172 preference.setIntent(new Intent().setClassName(
173 resolveInfo.activityInfo.packageName,
174 resolveInfo.activityInfo.name));
175
176 if ((flags & UPDATE_PREFERENCE_FLAG_SET_TITLE_TO_MATCHING_ACTIVITY) != 0) {
177 // Set the preference title to the activity's label
178 preference.setTitle(resolveInfo.loadLabel(pm));
179 }
Ying Wanga7188322010-01-04 18:45:10 -0800180
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800181 return true;
182 }
183 }
184 }
185
186 // Did not find a matching activity, so remove the preference
187 parentPreferenceGroup.removePreference(preference);
Ying Wanga7188322010-01-04 18:45:10 -0800188
Shuhrat Dehkanov7dc567a2012-04-23 01:59:56 +0900189 return false;
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800190 }
Ying Wanga7188322010-01-04 18:45:10 -0800191
Anders Hammar1b2dd9032010-04-08 10:03:50 +0200192 /**
Ying Wanga7188322010-01-04 18:45:10 -0800193 * Returns true if Monkey is running.
194 */
195 public static boolean isMonkeyRunning() {
Amith Yamasaniae697552011-09-27 11:33:17 -0700196 return ActivityManager.isUserAMonkey();
Ying Wanga7188322010-01-04 18:45:10 -0800197 }
Amith Yamasani60133dd2010-09-11 14:17:31 -0700198
199 /**
200 * Returns whether the device is voice-capable (meaning, it is also a phone).
201 */
202 public static boolean isVoiceCapable(Context context) {
Bonian Chen5e65da02019-11-08 07:40:35 +0800203 final TelephonyManager telephony =
Amith Yamasani60133dd2010-09-11 14:17:31 -0700204 (TelephonyManager) context.getSystemService(Context.TELEPHONY_SERVICE);
205 return telephony != null && telephony.isVoiceCapable();
206 }
Amith Yamasani0f85c482011-02-23 17:19:11 -0800207
Amith Yamasanic06d4c42011-02-25 14:35:20 -0800208 /**
209 * Returns the WIFI IP Addresses, if any, taking into account IPv4 and IPv6 style addresses.
210 * @param context the application context
Lorenzo Colitti769f0692013-08-01 17:30:07 +0900211 * @return the formatted and newline-separated IP addresses, or null if none.
Amith Yamasanic06d4c42011-02-25 14:35:20 -0800212 */
213 public static String getWifiIpAddresses(Context context) {
Bonian Chen5e65da02019-11-08 07:40:35 +0800214 final WifiManager wifiManager = context.getSystemService(WifiManager.class);
215 final Network currentNetwork = wifiManager.getCurrentNetwork();
Jaewoong Jungc260e6d2016-10-13 14:21:52 -0700216 if (currentNetwork != null) {
Bonian Chen5e65da02019-11-08 07:40:35 +0800217 final ConnectivityManager cm = (ConnectivityManager)
Sunny Shao7e866b62019-08-09 11:42:04 +0800218 context.getSystemService(Context.CONNECTIVITY_SERVICE);
Bonian Chen5e65da02019-11-08 07:40:35 +0800219 final LinkProperties prop = cm.getLinkProperties(currentNetwork);
Jaewoong Jungc260e6d2016-10-13 14:21:52 -0700220 return formatIpAddresses(prop);
221 }
222 return null;
Amith Yamasani6822b742011-10-17 16:41:00 -0700223 }
224
Amith Yamasani6822b742011-10-17 16:41:00 -0700225 private static String formatIpAddresses(LinkProperties prop) {
Amith Yamasanic06d4c42011-02-25 14:35:20 -0800226 if (prop == null) return null;
Bonian Chen5e65da02019-11-08 07:40:35 +0800227 final Iterator<InetAddress> iter = prop.getAllAddresses().iterator();
Amith Yamasanic06d4c42011-02-25 14:35:20 -0800228 // If there are no entries, return null
229 if (!iter.hasNext()) return null;
230 // Concatenate all available addresses, comma separated
231 String addresses = "";
232 while (iter.hasNext()) {
233 addresses += iter.next().getHostAddress();
Lorenzo Colitti769f0692013-08-01 17:30:07 +0900234 if (iter.hasNext()) addresses += "\n";
Amith Yamasanic06d4c42011-02-25 14:35:20 -0800235 }
236 return addresses;
237 }
Jean Chalard71ad1f42011-05-12 15:06:16 +0900238
239 public static Locale createLocaleFromString(String localeStr) {
240 // TODO: is there a better way to actually construct a locale that will match?
241 // The main problem is, on top of Java specs, locale.toString() and
242 // new Locale(locale.toString()).toString() do not return equal() strings in
243 // many cases, because the constructor takes the only string as the language
244 // code. So : new Locale("en", "US").toString() => "en_US"
245 // And : new Locale("en_US").toString() => "en_us"
Sunny Shao7e866b62019-08-09 11:42:04 +0800246 if (null == localeStr)
Jean Chalard71ad1f42011-05-12 15:06:16 +0900247 return Locale.getDefault();
Bonian Chen5e65da02019-11-08 07:40:35 +0800248 final String[] brokenDownLocale = localeStr.split("_", 3);
Jean Chalard71ad1f42011-05-12 15:06:16 +0900249 // split may not return a 0-length array.
250 if (1 == brokenDownLocale.length) {
251 return new Locale(brokenDownLocale[0]);
252 } else if (2 == brokenDownLocale.length) {
253 return new Locale(brokenDownLocale[0], brokenDownLocale[1]);
254 } else {
255 return new Locale(brokenDownLocale[0], brokenDownLocale[1], brokenDownLocale[2]);
256 }
257 }
Amith Yamasania4379d62011-07-22 10:34:58 -0700258
Jaewan Kima3fe77b2013-06-04 21:17:40 +0900259 public static boolean isBatteryPresent(Intent batteryChangedIntent) {
260 return batteryChangedIntent.getBooleanExtra(BatteryManager.EXTRA_PRESENT, true);
261 }
262
Amith Yamasania4379d62011-07-22 10:34:58 -0700263 public static String getBatteryPercentage(Intent batteryChangedIntent) {
Elliott Hughes7253df32014-09-02 17:10:14 -0700264 return formatPercentage(getBatteryLevel(batteryChangedIntent));
Dianne Hackborn525f2bd2014-04-29 11:24:06 -0700265 }
266
Jeff Sharkeyb654cbb2011-08-18 11:59:19 -0700267 /**
268 * Prepare a custom preferences layout, moving padding to {@link ListView}
269 * when outside scrollbars are requested. Usually used to display
270 * {@link ListView} and {@link TabWidget} with correct padding.
271 */
Jeff Sharkey5d706792011-09-08 18:57:17 -0700272 public static void prepareCustomPreferencesList(
Jeff Sharkey97d07fa2012-11-30 12:36:53 -0800273 ViewGroup parent, View child, View list, boolean ignoreSidePadding) {
Jeff Sharkeyb654cbb2011-08-18 11:59:19 -0700274 final boolean movePadding = list.getScrollBarStyle() == View.SCROLLBARS_OUTSIDE_OVERLAY;
Fabrice Di Meglio97a18c82014-07-18 19:12:36 -0700275 if (movePadding) {
Jeff Sharkeyb654cbb2011-08-18 11:59:19 -0700276 final Resources res = list.getResources();
Jeff Sharkeyb654cbb2011-08-18 11:59:19 -0700277 final int paddingBottom = res.getDimensionPixelSize(
278 com.android.internal.R.dimen.preference_fragment_padding_bottom);
Jeff Sharkey5d706792011-09-08 18:57:17 -0700279
Fabrice Di Meglio97a18c82014-07-18 19:12:36 -0700280 if (parent instanceof PreferenceFrameLayout) {
281 ((PreferenceFrameLayout.LayoutParams) child.getLayoutParams()).removeBorders = true;
Fabrice Di Meglio97a18c82014-07-18 19:12:36 -0700282 }
Doris Lingc5a1b4f2019-02-20 16:33:24 -0800283 list.setPaddingRelative(0 /* start */, 0 /* top */, 0 /* end */, paddingBottom);
Jeff Sharkeyb654cbb2011-08-18 11:59:19 -0700284 }
285 }
Jeff Sharkeya83a24f2011-09-16 01:52:39 -0700286
Fabrice Di Meglio0f4a7792014-07-28 18:25:14 -0700287 public static void forceCustomPadding(View view, boolean additive) {
Fabrice Di Meglio38ba9a22014-07-18 19:58:50 -0700288 final Resources res = view.getResources();
Fabrice Di Meglio0f4a7792014-07-28 18:25:14 -0700289
Doris Lingc5a1b4f2019-02-20 16:33:24 -0800290 final int paddingStart = additive ? view.getPaddingStart() : 0;
291 final int paddingEnd = additive ? view.getPaddingEnd() : 0;
Fabrice Di Meglio38ba9a22014-07-18 19:58:50 -0700292 final int paddingBottom = res.getDimensionPixelSize(
293 com.android.internal.R.dimen.preference_fragment_padding_bottom);
294
Fabrice Di Meglio0f4a7792014-07-28 18:25:14 -0700295 view.setPaddingRelative(paddingStart, 0, paddingEnd, paddingBottom);
Fabrice Di Meglio38ba9a22014-07-18 19:58:50 -0700296 }
297
Amith Yamasani8d40fac2012-10-23 15:36:16 -0700298 public static String getMeProfileName(Context context, boolean full) {
299 if (full) {
300 return getProfileDisplayName(context);
301 } else {
302 return getShorterNameIfPossible(context);
Amith Yamasaniae47ef42012-09-16 17:53:35 -0700303 }
Amith Yamasani8d40fac2012-10-23 15:36:16 -0700304 }
305
306 private static String getShorterNameIfPossible(Context context) {
307 final String given = getLocalProfileGivenName(context);
308 return !TextUtils.isEmpty(given) ? given : getProfileDisplayName(context);
309 }
310
311 private static String getLocalProfileGivenName(Context context) {
312 final ContentResolver cr = context.getContentResolver();
313
314 // Find the raw contact ID for the local ME profile raw contact.
315 final long localRowProfileId;
316 final Cursor localRawProfile = cr.query(
317 Profile.CONTENT_RAW_CONTACTS_URI,
Sunny Shao7e866b62019-08-09 11:42:04 +0800318 new String[] {RawContacts._ID},
Amith Yamasani8d40fac2012-10-23 15:36:16 -0700319 RawContacts.ACCOUNT_TYPE + " IS NULL AND " +
320 RawContacts.ACCOUNT_NAME + " IS NULL",
321 null, null);
322 if (localRawProfile == null) return null;
Amith Yamasaniae47ef42012-09-16 17:53:35 -0700323
324 try {
Amith Yamasani8d40fac2012-10-23 15:36:16 -0700325 if (!localRawProfile.moveToFirst()) {
326 return null;
Amith Yamasaniae47ef42012-09-16 17:53:35 -0700327 }
Amith Yamasani8d40fac2012-10-23 15:36:16 -0700328 localRowProfileId = localRawProfile.getLong(0);
Amith Yamasaniae47ef42012-09-16 17:53:35 -0700329 } finally {
Amith Yamasani8d40fac2012-10-23 15:36:16 -0700330 localRawProfile.close();
Amith Yamasaniae47ef42012-09-16 17:53:35 -0700331 }
Amith Yamasani8d40fac2012-10-23 15:36:16 -0700332
333 // Find the structured name for the raw contact.
334 final Cursor structuredName = cr.query(
335 Profile.CONTENT_URI.buildUpon().appendPath(Contacts.Data.CONTENT_DIRECTORY).build(),
Sunny Shao7e866b62019-08-09 11:42:04 +0800336 new String[] {CommonDataKinds.StructuredName.GIVEN_NAME,
337 CommonDataKinds.StructuredName.FAMILY_NAME},
Amith Yamasani8d40fac2012-10-23 15:36:16 -0700338 Data.RAW_CONTACT_ID + "=" + localRowProfileId,
339 null, null);
340 if (structuredName == null) return null;
341
342 try {
343 if (!structuredName.moveToFirst()) {
344 return null;
345 }
346 String partialName = structuredName.getString(0);
347 if (TextUtils.isEmpty(partialName)) {
348 partialName = structuredName.getString(1);
349 }
350 return partialName;
351 } finally {
352 structuredName.close();
353 }
354 }
355
356 private static final String getProfileDisplayName(Context context) {
357 final ContentResolver cr = context.getContentResolver();
358 final Cursor profile = cr.query(Profile.CONTENT_URI,
Sunny Shao7e866b62019-08-09 11:42:04 +0800359 new String[] {Profile.DISPLAY_NAME}, null, null, null);
Amith Yamasani8d40fac2012-10-23 15:36:16 -0700360 if (profile == null) return null;
361
362 try {
363 if (!profile.moveToFirst()) {
364 return null;
365 }
366 return profile.getString(0);
367 } finally {
368 profile.close();
369 }
Amith Yamasaniae47ef42012-09-16 17:53:35 -0700370 }
Amith Yamasani9627a8e2012-09-23 12:54:14 -0700371
Amith Yamasani9627a8e2012-09-23 12:54:14 -0700372 public static boolean hasMultipleUsers(Context context) {
Bonian Chenf399bd12020-01-09 14:50:03 +0800373 return context.getSystemService(UserManager.class)
Amith Yamasani9627a8e2012-09-23 12:54:14 -0700374 .getUsers().size() > 1;
375 }
Fabrice Di Meglio769630c2014-04-24 14:48:48 -0700376
377 /**
Esteban Talavera9b86e9c2017-05-30 16:48:08 +0100378 * Returns the managed profile of the current user or {@code null} if none is found or a profile
379 * exists but it is disabled.
Alexandra Gherghina3939cd72014-06-04 10:02:55 +0100380 */
381 public static UserHandle getManagedProfile(UserManager userManager) {
Bonian Chen5e65da02019-11-08 07:40:35 +0800382 final List<UserHandle> userProfiles = userManager.getUserProfiles();
Aarthi Balachanderd0f83592018-07-10 17:04:53 -0700383 for (UserHandle profile : userProfiles) {
Alexandra Gherghina3939cd72014-06-04 10:02:55 +0100384 if (profile.getIdentifier() == userManager.getUserHandle()) {
385 continue;
386 }
387 final UserInfo userInfo = userManager.getUserInfo(profile.getIdentifier());
388 if (userInfo.isManagedProfile()) {
389 return profile;
390 }
391 }
392 return null;
393 }
394
395 /**
Esteban Talavera9b86e9c2017-05-30 16:48:08 +0100396 * Returns the managed profile of the current user or {@code null} if none is found. Unlike
397 * {@link #getManagedProfile} this method returns enabled and disabled managed profiles.
398 */
399 public static UserHandle getManagedProfileWithDisabled(UserManager userManager) {
400 // TODO: Call getManagedProfileId from here once Robolectric supports
401 // API level 24 and UserManager.getProfileIdsWithDisabled can be Mocked (to avoid having
402 // yet another implementation that loops over user profiles in this method). In the meantime
403 // we need to use UserManager.getProfiles that is available on API 23 (the one currently
404 // used for Settings Robolectric tests).
405 final int myUserId = UserHandle.myUserId();
Bonian Chen5e65da02019-11-08 07:40:35 +0800406 final List<UserInfo> profiles = userManager.getProfiles(myUserId);
Esteban Talavera9b86e9c2017-05-30 16:48:08 +0100407 final int count = profiles.size();
408 for (int i = 0; i < count; i++) {
409 final UserInfo profile = profiles.get(i);
410 if (profile.isManagedProfile()
411 && profile.getUserHandle().getIdentifier() != myUserId) {
412 return profile.getUserHandle();
413 }
414 }
415 return null;
416 }
417
418 /**
Clara Bayarri462cce12016-02-18 12:09:21 +0000419 * Retrieves the id for the given user's managed profile.
420 *
421 * @return the managed profile id or UserHandle.USER_NULL if there is none.
422 */
423 public static int getManagedProfileId(UserManager um, int parentUserId) {
Bonian Chen5e65da02019-11-08 07:40:35 +0800424 final int[] profileIds = um.getProfileIdsWithDisabled(parentUserId);
Fyodor Kupolov4a4af5a2016-04-07 16:46:18 -0700425 for (int profileId : profileIds) {
426 if (profileId != parentUserId) {
427 return profileId;
Clara Bayarri462cce12016-02-18 12:09:21 +0000428 }
429 }
430 return UserHandle.USER_NULL;
431 }
432
433 /**
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100434 * Returns the target user for a Settings activity.
Tony Mak8f41b9b2016-11-23 11:36:18 +0000435 * <p>
436 * User would be retrieved in this order:
437 * <ul>
438 * <li> If this activity is launched from other user, return that user id.
439 * <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 +0800440 * extra in the arguments or intent extras.
Tony Mak8f41b9b2016-11-23 11:36:18 +0000441 * <li> Otherwise, return UserHandle.myUserId().
442 * </ul>
443 * <p>
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100444 * Note: This is secure in the sense that it only returns a target user different to the current
445 * one if the app launching this activity is the Settings app itself, running in the same user
446 * 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 +0100447 */
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100448 public static UserHandle getSecureTargetUser(IBinder activityToken,
Tony Mak8f41b9b2016-11-23 11:36:18 +0000449 UserManager um, @Nullable Bundle arguments, @Nullable Bundle intentExtras) {
Bonian Chen5e65da02019-11-08 07:40:35 +0800450 final UserHandle currentUser = new UserHandle(UserHandle.myUserId());
451 final IActivityManager am = ActivityManager.getService();
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100452 try {
Bonian Chen5e65da02019-11-08 07:40:35 +0800453 final String launchedFromPackage = am.getLaunchedFromPackage(activityToken);
454 final boolean launchedFromSettingsApp =
455 SETTINGS_PACKAGE_NAME.equals(launchedFromPackage);
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100456
Bonian Chen5e65da02019-11-08 07:40:35 +0800457 final UserHandle launchedFromUser = new UserHandle(UserHandle.getUserId(
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100458 am.getLaunchedFromUid(activityToken)));
459 if (launchedFromUser != null && !launchedFromUser.equals(currentUser)) {
460 // Check it's secure
461 if (isProfileOf(um, launchedFromUser)) {
462 return launchedFromUser;
463 }
464 }
Bonian Chen5e65da02019-11-08 07:40:35 +0800465 final UserHandle extrasUser = getUserHandleFromBundle(intentExtras);
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100466 if (extrasUser != null && !extrasUser.equals(currentUser)) {
467 // Check it's secure
468 if (launchedFromSettingsApp && isProfileOf(um, extrasUser)) {
469 return extrasUser;
470 }
471 }
Bonian Chen5e65da02019-11-08 07:40:35 +0800472 final UserHandle argumentsUser = getUserHandleFromBundle(arguments);
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100473 if (argumentsUser != null && !argumentsUser.equals(currentUser)) {
474 // Check it's secure
475 if (launchedFromSettingsApp && isProfileOf(um, argumentsUser)) {
476 return argumentsUser;
477 }
478 }
479 } catch (RemoteException e) {
480 // Should not happen
481 Log.v(TAG, "Could not talk to activity manager.", e);
482 }
483 return currentUser;
Tony Mak8f41b9b2016-11-23 11:36:18 +0000484 }
485
486 /**
487 * Lookup both {@link Intent#EXTRA_USER} and {@link Intent#EXTRA_USER_ID} in the bundle
488 * and return the {@link UserHandle} object. Return {@code null} if nothing is found.
489 */
Sunny Shao7e866b62019-08-09 11:42:04 +0800490 private static @Nullable UserHandle getUserHandleFromBundle(Bundle bundle) {
Tony Mak8f41b9b2016-11-23 11:36:18 +0000491 if (bundle == null) {
492 return null;
493 }
494 final UserHandle user = bundle.getParcelable(EXTRA_USER);
495 if (user != null) {
496 return user;
497 }
498 final int userId = bundle.getInt(EXTRA_USER_ID, -1);
499 if (userId != -1) {
500 return UserHandle.of(userId);
501 }
502 return null;
503 }
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100504
Sunny Shao7e866b62019-08-09 11:42:04 +0800505 /**
506 * Returns true if the user provided is in the same profiles group as the current user.
507 */
508 private static boolean isProfileOf(UserManager um, UserHandle otherUser) {
509 if (um == null || otherUser == null) return false;
510 return (UserHandle.myUserId() == otherUser.getIdentifier())
511 || um.getUserProfiles().contains(otherUser);
512 }
Amith Yamasani51c6dac2014-07-02 00:06:37 +0530513
Alexandra Gherghina95b86a52014-07-24 19:13:25 +0100514 /**
Amith Yamasani45f86232014-11-19 17:12:46 -0800515 * Queries for the UserInfo of a user. Returns null if the user doesn't exist (was removed).
516 * @param userManager Instance of UserManager
Sunny Shao7e866b62019-08-09 11:42:04 +0800517 * @param checkUser The user to check the existence of.
Amith Yamasani45f86232014-11-19 17:12:46 -0800518 * @return UserInfo of the user or null for non-existent user.
519 */
520 public static UserInfo getExistingUser(UserManager userManager, UserHandle checkUser) {
521 final List<UserInfo> users = userManager.getUsers(true /* excludeDying */);
522 final int checkUserId = checkUser.getIdentifier();
523 for (UserInfo user : users) {
524 if (user.id == checkUserId) {
525 return user;
526 }
527 }
528 return null;
529 }
530
Zoltan Szatmary-Ban3af2e4c2014-12-19 17:17:23 +0000531 public static View inflateCategoryHeader(LayoutInflater inflater, ViewGroup parent) {
532 final TypedArray a = inflater.getContext().obtainStyledAttributes(null,
533 com.android.internal.R.styleable.Preference,
534 com.android.internal.R.attr.preferenceCategoryStyle, 0);
535 final int resId = a.getResourceId(com.android.internal.R.styleable.Preference_layout,
536 0);
537 a.recycle();
538 return inflater.inflate(resId, parent, false);
539 }
540
Christopher Tatea08a2252015-07-01 16:52:43 -0700541 public static ArraySet<String> getHandledDomains(PackageManager pm, String packageName) {
Bonian Chen5e65da02019-11-08 07:40:35 +0800542 final List<IntentFilterVerificationInfo> iviList =
543 pm.getIntentFilterVerifications(packageName);
544 final List<IntentFilter> filters = pm.getAllIntentFilters(packageName);
Christopher Tatea08a2252015-07-01 16:52:43 -0700545
Bonian Chen5e65da02019-11-08 07:40:35 +0800546 final ArraySet<String> result = new ArraySet<>();
Fan Zhang4e540db2017-11-08 13:06:38 -0800547 if (iviList != null && iviList.size() > 0) {
Christopher Tatea08a2252015-07-01 16:52:43 -0700548 for (IntentFilterVerificationInfo ivi : iviList) {
549 for (String host : ivi.getDomains()) {
550 result.add(host);
551 }
552 }
553 }
554 if (filters != null && filters.size() > 0) {
555 for (IntentFilter filter : filters) {
Christopher Tateddaa1422015-07-16 16:00:49 -0700556 if (filter.hasCategory(Intent.CATEGORY_BROWSABLE)
557 && (filter.hasDataScheme(IntentFilter.SCHEME_HTTP) ||
Sunny Shao7e866b62019-08-09 11:42:04 +0800558 filter.hasDataScheme(IntentFilter.SCHEME_HTTPS))) {
Christopher Tatea08a2252015-07-01 16:52:43 -0700559 result.addAll(filter.getHostsList());
560 }
561 }
562 }
563 return result;
564 }
565
Sudheer Shankabc956302015-04-09 12:19:53 +0100566 /**
567 * Returns the application info of the currently installed MDM package.
568 */
569 public static ApplicationInfo getAdminApplicationInfo(Context context, int profileId) {
Bonian Chen5e65da02019-11-08 07:40:35 +0800570 final DevicePolicyManager dpm =
Sudheer Shankabc956302015-04-09 12:19:53 +0100571 (DevicePolicyManager) context.getSystemService(Context.DEVICE_POLICY_SERVICE);
Bonian Chen5e65da02019-11-08 07:40:35 +0800572 final ComponentName mdmPackage = dpm.getProfileOwnerAsUser(profileId);
Sudheer Shankabc956302015-04-09 12:19:53 +0100573 if (mdmPackage == null) {
574 return null;
575 }
Bonian Chen5e65da02019-11-08 07:40:35 +0800576 final String mdmPackageName = mdmPackage.getPackageName();
Sudheer Shankabc956302015-04-09 12:19:53 +0100577 try {
Bonian Chen5e65da02019-11-08 07:40:35 +0800578 final IPackageManager ipm = AppGlobals.getPackageManager();
579 final ApplicationInfo mdmApplicationInfo =
Sudheer Shankabc956302015-04-09 12:19:53 +0100580 ipm.getApplicationInfo(mdmPackageName, 0, profileId);
581 return mdmApplicationInfo;
582 } catch (RemoteException e) {
583 Log.e(TAG, "Error while retrieving application info for package " + mdmPackageName
584 + ", userId " + profileId, e);
585 return null;
586 }
587 }
Jason Monkb45e27b2015-05-20 13:35:43 -0400588
589 public static boolean isBandwidthControlEnabled() {
590 final INetworkManagementService netManager = INetworkManagementService.Stub
591 .asInterface(ServiceManager.getService(Context.NETWORKMANAGEMENT_SERVICE));
592 try {
593 return netManager.isBandwidthControlEnabled();
594 } catch (RemoteException e) {
595 return false;
596 }
597 }
Julia Reynoldsce25af42015-07-08 16:56:31 -0400598
599 /**
600 * Returns an accessible SpannableString.
Sunny Shao7e866b62019-08-09 11:42:04 +0800601 * @param displayText the text to display
Julia Reynoldsce25af42015-07-08 16:56:31 -0400602 * @param accessibileText the text text-to-speech engines should read
603 */
604 public static SpannableString createAccessibleSequence(CharSequence displayText,
605 String accessibileText) {
Bonian Chen5e65da02019-11-08 07:40:35 +0800606 final SpannableString str = new SpannableString(displayText);
Julia Reynoldsce25af42015-07-08 16:56:31 -0400607 str.setSpan(new TtsSpan.TextBuilder(accessibileText).build(), 0,
608 displayText.length(),
609 Spannable.SPAN_INCLUSIVE_INCLUSIVE);
610 return str;
611 }
Andres Morales7bdffd82015-08-04 16:55:00 -0700612
Clara Bayarrife432e82015-10-12 12:07:02 +0100613 /**
Jeff Sharkey219ec912017-12-19 14:57:39 -0700614 * Returns the user id present in the bundle with
615 * {@link Intent#EXTRA_USER_ID} if it belongs to the current user.
Clara Bayarrife432e82015-10-12 12:07:02 +0100616 *
Jeff Sharkey219ec912017-12-19 14:57:39 -0700617 * @throws SecurityException if the given userId does not belong to the
Sunny Shao7e866b62019-08-09 11:42:04 +0800618 * current user group.
Clara Bayarrife432e82015-10-12 12:07:02 +0100619 */
Benjamin Franz194300d2016-01-13 12:16:25 +0000620 public static int getUserIdFromBundle(Context context, Bundle bundle) {
Jeff Sharkey219ec912017-12-19 14:57:39 -0700621 return getUserIdFromBundle(context, bundle, false);
622 }
623
624 /**
625 * Returns the user id present in the bundle with
626 * {@link Intent#EXTRA_USER_ID} if it belongs to the current user.
627 *
628 * @param isInternal indicating if the caller is "internal" to the system,
Sunny Shao7e866b62019-08-09 11:42:04 +0800629 * meaning we're willing to trust extras like
630 * {@link ChooseLockSettingsHelper#EXTRA_ALLOW_ANY_USER}.
Jeff Sharkey219ec912017-12-19 14:57:39 -0700631 * @throws SecurityException if the given userId does not belong to the
Sunny Shao7e866b62019-08-09 11:42:04 +0800632 * current user group.
Jeff Sharkey219ec912017-12-19 14:57:39 -0700633 */
634 public static int getUserIdFromBundle(Context context, Bundle bundle, boolean isInternal) {
Clara Bayarrife432e82015-10-12 12:07:02 +0100635 if (bundle == null) {
Benjamin Franz194300d2016-01-13 12:16:25 +0000636 return getCredentialOwnerUserId(context);
Clara Bayarrife432e82015-10-12 12:07:02 +0100637 }
Jeff Sharkey219ec912017-12-19 14:57:39 -0700638 final boolean allowAnyUser = isInternal
639 && bundle.getBoolean(ChooseLockSettingsHelper.EXTRA_ALLOW_ANY_USER, false);
Bonian Chen5e65da02019-11-08 07:40:35 +0800640 final int userId = bundle.getInt(Intent.EXTRA_USER_ID, UserHandle.myUserId());
Adrian Roos5a9a3cd2017-03-30 18:02:25 -0700641 if (userId == LockPatternUtils.USER_FRP) {
Jeff Sharkey219ec912017-12-19 14:57:39 -0700642 return allowAnyUser ? userId : enforceSystemUser(context, userId);
Adrian Roos5a9a3cd2017-03-30 18:02:25 -0700643 } else {
Jeff Sharkey219ec912017-12-19 14:57:39 -0700644 return allowAnyUser ? userId : enforceSameOwner(context, userId);
Adrian Roos5a9a3cd2017-03-30 18:02:25 -0700645 }
646 }
647
648 /**
649 * Returns the given user id if the current user is the system user.
650 *
651 * @throws SecurityException if the current user is not the system user.
652 */
653 public static int enforceSystemUser(Context context, int userId) {
654 if (UserHandle.myUserId() == UserHandle.USER_SYSTEM) {
655 return userId;
656 }
657 throw new SecurityException("Given user id " + userId + " must only be used from "
658 + "USER_SYSTEM, but current user is " + UserHandle.myUserId());
Clara Bayarrife432e82015-10-12 12:07:02 +0100659 }
660
661 /**
662 * Returns the given user id if it belongs to the current user.
663 *
664 * @throws SecurityException if the given userId does not belong to the current user group.
665 */
Benjamin Franz194300d2016-01-13 12:16:25 +0000666 public static int enforceSameOwner(Context context, int userId) {
Bonian Chenf399bd12020-01-09 14:50:03 +0800667 final UserManager um = context.getSystemService(UserManager.class);
Ricky Wai72500162016-06-07 16:54:25 +0100668 final int[] profileIds = um.getProfileIdsWithDisabled(UserHandle.myUserId());
669 if (ArrayUtils.contains(profileIds, userId)) {
670 return userId;
Clara Bayarrife432e82015-10-12 12:07:02 +0100671 }
Ricky Wai72500162016-06-07 16:54:25 +0100672 throw new SecurityException("Given user id " + userId + " does not belong to user "
673 + UserHandle.myUserId());
Clara Bayarrife432e82015-10-12 12:07:02 +0100674 }
675
Benjamin Franz194300d2016-01-13 12:16:25 +0000676 /**
677 * Returns the effective credential owner of the calling user.
678 */
679 public static int getCredentialOwnerUserId(Context context) {
680 return getCredentialOwnerUserId(context, UserHandle.myUserId());
681 }
682
683 /**
684 * Returns the user id of the credential owner of the given user id.
685 */
686 public static int getCredentialOwnerUserId(Context context, int userId) {
Bonian Chenf399bd12020-01-09 14:50:03 +0800687 final UserManager um = context.getSystemService(UserManager.class);
Benjamin Franz194300d2016-01-13 12:16:25 +0000688 return um.getCredentialOwnerProfile(userId);
Andres Morales7bdffd82015-08-04 16:55:00 -0700689 }
Jason Monkdb4ed192015-12-11 16:48:31 -0500690
Jason Monkb37e2882016-01-11 14:27:20 -0500691 private static final StringBuilder sBuilder = new StringBuilder(50);
692 private static final java.util.Formatter sFormatter = new java.util.Formatter(
693 sBuilder, Locale.getDefault());
694
695 public static String formatDateRange(Context context, long start, long end) {
696 final int flags = FORMAT_SHOW_DATE | FORMAT_ABBREV_MONTH;
697
698 synchronized (sBuilder) {
699 sBuilder.setLength(0);
700 return DateUtils.formatDateRange(context, sFormatter, start, end, flags, null)
701 .toString();
702 }
703 }
Jason Monk91e2f892016-02-23 15:31:09 -0500704
Bernard Chau88d523b2016-04-14 15:08:28 +0100705 public static boolean startQuietModeDialogIfNecessary(Context context, UserManager um,
Ricky Wai616342b2016-04-13 10:40:22 +0100706 int userId) {
707 if (um.isQuietModeEnabled(UserHandle.of(userId))) {
708 final Intent intent = UnlaunchableAppActivity.createInQuietModeDialogIntent(userId);
709 context.startActivity(intent);
710 return true;
711 }
712 return false;
713 }
Sudheer Shankac3eb16e2016-04-21 12:51:43 -0700714
Rubin Xu3231afe2016-08-24 10:15:07 +0100715 public static boolean unlockWorkProfileIfNecessary(Context context, int userId) {
716 try {
Sudheer Shankaacb1a612016-11-10 15:30:14 -0800717 if (!ActivityManager.getService().isUserRunning(userId,
Rubin Xu3231afe2016-08-24 10:15:07 +0100718 ActivityManager.FLAG_AND_LOCKED)) {
719 return false;
720 }
721 } catch (RemoteException e) {
722 return false;
723 }
724 if (!(new LockPatternUtils(context)).isSecure(userId)) {
725 return false;
726 }
Robin Leecccf3242017-02-10 15:32:49 +0000727 return confirmWorkProfileCredentials(context, userId);
728 }
729
Robin Leecccf3242017-02-10 15:32:49 +0000730 private static boolean confirmWorkProfileCredentials(Context context, int userId) {
Rubin Xu3231afe2016-08-24 10:15:07 +0100731 final KeyguardManager km = (KeyguardManager) context.getSystemService(
732 Context.KEYGUARD_SERVICE);
733 final Intent unlockIntent = km.createConfirmDeviceCredentialIntent(null, null, userId);
734 if (unlockIntent != null) {
735 context.startActivity(unlockIntent);
736 return true;
737 } else {
738 return false;
739 }
Rubin Xu3231afe2016-08-24 10:15:07 +0100740 }
741
Sudheer Shankac3eb16e2016-04-21 12:51:43 -0700742 public static CharSequence getApplicationLabel(Context context, String packageName) {
743 try {
744 final ApplicationInfo appInfo = context.getPackageManager().getApplicationInfo(
745 packageName,
746 PackageManager.MATCH_DISABLED_COMPONENTS
Sunny Shao7e866b62019-08-09 11:42:04 +0800747 | PackageManager.MATCH_ANY_USER);
Sudheer Shankac3eb16e2016-04-21 12:51:43 -0700748 return appInfo.loadLabel(context.getPackageManager());
749 } catch (PackageManager.NameNotFoundException e) {
Raff Tsai376ce872020-01-06 00:42:35 +0800750 Log.e(TAG, "Unable to find info for package: " + packageName);
Sudheer Shankac3eb16e2016-04-21 12:51:43 -0700751 }
752 return null;
753 }
Jason Monk75199542016-05-06 15:09:32 -0400754
Jeff Sharkey4a8136b2016-07-27 12:53:34 -0600755 public static boolean isPackageDirectBootAware(Context context, String packageName) {
756 try {
757 final ApplicationInfo ai = context.getPackageManager().getApplicationInfo(
758 packageName, 0);
759 return ai.isDirectBootAware() || ai.isPartiallyDirectBootAware();
760 } catch (NameNotFoundException ignored) {
761 }
762 return false;
763 }
Andre Lago3e398c82016-07-25 14:12:28 +0100764
765 /**
766 * Returns a context created from the given context for the given user, or null if it fails
767 */
768 public static Context createPackageContextAsUser(Context context, int userId) {
769 try {
770 return context.createPackageContextAsUser(
771 context.getPackageName(), 0 /* flags */, UserHandle.of(userId));
772 } catch (PackageManager.NameNotFoundException e) {
773 Log.e(TAG, "Failed to create user context", e);
774 }
775 return null;
776 }
Jeff Sharkeyab508072016-10-11 14:25:22 -0600777
778 public static FingerprintManager getFingerprintManagerOrNull(Context context) {
779 if (context.getPackageManager().hasSystemFeature(PackageManager.FEATURE_FINGERPRINT)) {
Fan Zhangcf97f0b2018-01-05 11:18:44 -0800780 return (FingerprintManager) context.getSystemService(Context.FINGERPRINT_SERVICE);
Jeff Sharkeyab508072016-10-11 14:25:22 -0600781 } else {
782 return null;
783 }
784 }
Daniel Nishi31027da2017-01-19 14:03:57 -0800785
Kevin Chyn82792cc2017-07-20 00:15:44 -0700786 public static boolean hasFingerprintHardware(Context context) {
Bonian Chen5e65da02019-11-08 07:40:35 +0800787 final FingerprintManager fingerprintManager = getFingerprintManagerOrNull(context);
Kevin Chyn82792cc2017-07-20 00:15:44 -0700788 return fingerprintManager != null && fingerprintManager.isHardwareDetected();
789 }
790
Kevin Chyn4882e872018-06-25 17:58:31 -0700791 public static FaceManager getFaceManagerOrNull(Context context) {
792 if (context.getPackageManager().hasSystemFeature(PackageManager.FEATURE_FACE)) {
793 return (FaceManager) context.getSystemService(Context.FACE_SERVICE);
794 } else {
795 return null;
796 }
797 }
798
799 public static boolean hasFaceHardware(Context context) {
Bonian Chen5e65da02019-11-08 07:40:35 +0800800 final FaceManager faceManager = getFaceManagerOrNull(context);
Kevin Chyn4882e872018-06-25 17:58:31 -0700801 return faceManager != null && faceManager.isHardwareDetected();
802 }
803
Daniel Nishi31027da2017-01-19 14:03:57 -0800804 /**
805 * Launches an intent which may optionally have a user id defined.
806 * @param fragment Fragment to use to launch the activity.
Sunny Shao7e866b62019-08-09 11:42:04 +0800807 * @param intent Intent to launch.
Daniel Nishi31027da2017-01-19 14:03:57 -0800808 */
809 public static void launchIntent(Fragment fragment, Intent intent) {
810 try {
811 final int userId = intent.getIntExtra(Intent.EXTRA_USER_ID, -1);
812
813 if (userId == -1) {
814 fragment.startActivity(intent);
815 } else {
816 fragment.getActivity().startActivityAsUser(intent, new UserHandle(userId));
817 }
818 } catch (ActivityNotFoundException e) {
819 Log.w(TAG, "No activity found for " + intent);
820 }
821 }
822
Christine Franksc6890ab2017-06-23 14:28:21 -0700823 public static boolean isDemoUser(Context context) {
Bonian Chenf399bd12020-01-09 14:50:03 +0800824 return UserManager.isDeviceInDemoMode(context)
825 && context.getSystemService(UserManager.class).isDemoUser();
Christine Franksc6890ab2017-06-23 14:28:21 -0700826 }
827
Justin Klaassen30257272017-08-08 21:58:05 -0700828 public static ComponentName getDeviceOwnerComponent(Context context) {
829 final DevicePolicyManager dpm = (DevicePolicyManager) context.getSystemService(
830 Context.DEVICE_POLICY_SERVICE);
831 return dpm.getDeviceOwnerComponentOnAnyUser();
Christine Franks14782222017-01-23 16:44:02 -0800832 }
Daniel Nishidfed8a22017-01-19 16:32:41 -0800833
834 /**
835 * Returns if a given user is a profile of another user.
Sunny Shao7e866b62019-08-09 11:42:04 +0800836 * @param user The user whose profiles wibe checked.
Daniel Nishidfed8a22017-01-19 16:32:41 -0800837 * @param profile The (potential) profile.
838 * @return if the profile is actually a profile
839 */
840 public static boolean isProfileOf(UserInfo user, UserInfo profile) {
841 return user.id == profile.id ||
842 (user.profileGroupId != UserInfo.NO_PROFILE_GROUP_ID
843 && user.profileGroupId == profile.profileGroupId);
844 }
Daniel Nishi9f60f422017-02-15 15:25:48 -0800845
846 /**
847 * Tries to initalize a volume with the given bundle. If it is a valid, private, and readable
848 * {@link VolumeInfo}, it is returned. If it is not valid, null is returned.
849 */
850 @Nullable
851 public static VolumeInfo maybeInitializeVolume(StorageManager sm, Bundle bundle) {
852 final String volumeId = bundle.getString(VolumeInfo.EXTRA_VOLUME_ID,
853 VolumeInfo.ID_PRIVATE_INTERNAL);
Bonian Chen5e65da02019-11-08 07:40:35 +0800854 final VolumeInfo volume = sm.findVolumeById(volumeId);
Daniel Nishi9f60f422017-02-15 15:25:48 -0800855 return isVolumeValid(volume) ? volume : null;
856 }
857
jackqdyuleiddba9662017-03-08 19:35:02 -0800858 /**
jackqdyulei00015fb2017-08-22 11:25:30 -0700859 * Return {@code true} if the supplied package is device owner or profile owner of at
860 * least one user.
Sunny Shao7e866b62019-08-09 11:42:04 +0800861 * @param userManager used to get profile owner app for each user
jackqdyulei00015fb2017-08-22 11:25:30 -0700862 * @param devicePolicyManager used to check whether it is device owner app
Sunny Shao7e866b62019-08-09 11:42:04 +0800863 * @param packageName package to check about
jackqdyulei00015fb2017-08-22 11:25:30 -0700864 */
865 public static boolean isProfileOrDeviceOwner(UserManager userManager,
Fan Zhangaab36de2018-03-30 16:58:28 -0700866 DevicePolicyManager devicePolicyManager, String packageName) {
Bonian Chen5e65da02019-11-08 07:40:35 +0800867 final List<UserInfo> userInfos = userManager.getUsers();
jackqdyulei00015fb2017-08-22 11:25:30 -0700868 if (devicePolicyManager.isDeviceOwnerAppOnAnyUser(packageName)) {
869 return true;
870 }
871 for (int i = 0, size = userInfos.size(); i < size; i++) {
Bonian Chen5e65da02019-11-08 07:40:35 +0800872 final ComponentName cn = devicePolicyManager
873 .getProfileOwnerAsUser(userInfos.get(i).id);
jackqdyulei00015fb2017-08-22 11:25:30 -0700874 if (cn != null && cn.getPackageName().equals(packageName)) {
875 return true;
876 }
877 }
878 return false;
879 }
880
881 /**
jackqdyuleiddba9662017-03-08 19:35:02 -0800882 * Return the resource id to represent the install status for an app
883 */
884 @StringRes
885 public static int getInstallationStatus(ApplicationInfo info) {
886 if ((info.flags & ApplicationInfo.FLAG_INSTALLED) == 0) {
887 return R.string.not_installed;
888 }
889 return info.enabled ? R.string.installed : R.string.disabled;
890 }
891
Daniel Nishi9f60f422017-02-15 15:25:48 -0800892 private static boolean isVolumeValid(VolumeInfo volume) {
893 return (volume != null) && (volume.getType() == VolumeInfo.TYPE_PRIVATE)
894 && volume.isMountedReadable();
895 }
jackqdyuleif4c1cef2017-03-31 12:57:10 -0700896
PMS2263a05602017-06-14 07:10:15 +0000897 public static void setEditTextCursorPosition(EditText editText) {
898 editText.setSelection(editText.getText().length());
899 }
Felipe Lemebd884502017-09-15 18:16:21 -0700900
901 /**
902 * Sets the preference icon with a drawable that is scaled down to to avoid crashing Settings if
903 * it's too big.
904 */
905 public static void setSafeIcon(Preference pref, Drawable icon) {
906 Drawable safeIcon = icon;
Phil Weaver5a3e02d2018-03-08 17:38:46 -0800907 if ((icon != null) && !(icon instanceof VectorDrawable)) {
Felipe Lemebd884502017-09-15 18:16:21 -0700908 safeIcon = getSafeDrawable(icon, 500, 500);
909 }
910 pref.setIcon(safeIcon);
911 }
912
913 /**
914 * Gets a drawable with a limited size to avoid crashing Settings if it's too big.
915 *
Sunny Shao7e866b62019-08-09 11:42:04 +0800916 * @param original original drawable, typically an app icon.
917 * @param maxWidth maximum width, in pixels.
Felipe Lemebd884502017-09-15 18:16:21 -0700918 * @param maxHeight maximum height, in pixels.
919 */
920 public static Drawable getSafeDrawable(Drawable original, int maxWidth, int maxHeight) {
921 final int actualWidth = original.getMinimumWidth();
922 final int actualHeight = original.getMinimumHeight();
923
924 if (actualWidth <= maxWidth && actualHeight <= maxHeight) {
925 return original;
926 }
927
Bonian Chen5e65da02019-11-08 07:40:35 +0800928 final float scaleWidth = ((float) maxWidth) / actualWidth;
929 final float scaleHeight = ((float) maxHeight) / actualHeight;
930 final float scale = Math.min(scaleWidth, scaleHeight);
Felipe Lemebd884502017-09-15 18:16:21 -0700931 final int width = (int) (actualWidth * scale);
932 final int height = (int) (actualHeight * scale);
933
934 final Bitmap bitmap;
935 if (original instanceof BitmapDrawable) {
936 bitmap = Bitmap.createScaledBitmap(((BitmapDrawable) original).getBitmap(), width,
937 height, false);
938 } else {
Jason Chiuc78c54a2019-02-13 16:07:57 +0800939 bitmap = createBitmap(original, width, height);
Felipe Lemebd884502017-09-15 18:16:21 -0700940 }
941 return new BitmapDrawable(null, bitmap);
942 }
jackqdyuleifde637f2018-01-02 14:51:01 -0800943
944 /**
Jason Chiuc78c54a2019-02-13 16:07:57 +0800945 * Create an Icon pointing to a drawable.
Jason Chiu1217bbe2019-01-24 16:32:31 +0800946 */
Jason Chiuc78c54a2019-02-13 16:07:57 +0800947 public static IconCompat createIconWithDrawable(Drawable drawable) {
948 Bitmap bitmap;
Jason Chiu1217bbe2019-01-24 16:32:31 +0800949 if (drawable instanceof BitmapDrawable) {
Sunny Shao7e866b62019-08-09 11:42:04 +0800950 bitmap = ((BitmapDrawable)drawable).getBitmap();
Jason Chiuc78c54a2019-02-13 16:07:57 +0800951 } else {
952 final int width = drawable.getIntrinsicWidth();
953 final int height = drawable.getIntrinsicHeight();
954 bitmap = createBitmap(drawable,
955 width > 0 ? width : 1,
956 height > 0 ? height : 1);
Jason Chiu1217bbe2019-01-24 16:32:31 +0800957 }
Jason Chiuc78c54a2019-02-13 16:07:57 +0800958 return IconCompat.createWithBitmap(bitmap);
959 }
Jason Chiu1217bbe2019-01-24 16:32:31 +0800960
clownshen24827d32019-03-29 20:22:02 +0800961 /**
962 * Creates a drawable with specified width and height.
963 */
964 public static Bitmap createBitmap(Drawable drawable, int width, int height) {
Jason Chiuc78c54a2019-02-13 16:07:57 +0800965 final Bitmap bitmap = Bitmap.createBitmap(width, height, Bitmap.Config.ARGB_8888);
Jason Chiu1217bbe2019-01-24 16:32:31 +0800966 final Canvas canvas = new Canvas(bitmap);
967 drawable.setBounds(0, 0, canvas.getWidth(), canvas.getHeight());
968 drawable.draw(canvas);
969 return bitmap;
970 }
971
972 /**
jackqdyuleifde637f2018-01-02 14:51:01 -0800973 * Get the {@link Drawable} that represents the app icon
974 */
975 public static Drawable getBadgedIcon(IconDrawableFactory iconDrawableFactory,
976 PackageManager packageManager, String packageName, int userId) {
977 try {
Tony Mak4e292812018-03-19 15:37:21 +0000978 final ApplicationInfo appInfo = packageManager.getApplicationInfoAsUser(
979 packageName, PackageManager.GET_META_DATA, userId);
jackqdyuleifde637f2018-01-02 14:51:01 -0800980 return iconDrawableFactory.getBadgedIcon(appInfo, userId);
981 } catch (PackageManager.NameNotFoundException e) {
982 return packageManager.getDefaultActivityIcon();
983 }
984 }
Raff Tsai2928cd42018-11-05 16:10:19 +0800985
986 /** Returns true if the current package is installed & enabled. */
987 public static boolean isPackageEnabled(Context context, String packageName) {
988 try {
989 return context.getPackageManager().getApplicationInfo(packageName, 0).enabled;
990 } catch (Exception e) {
991 Log.e(TAG, "Error while retrieving application info for package " + packageName, e);
992 }
993 return false;
994 }
markchien1dd1d792019-01-11 16:18:20 +0800995
996 /** Get {@link Resources} by subscription id if subscription id is valid. */
997 public static Resources getResourcesForSubId(Context context, int subId) {
998 if (subId != SubscriptionManager.INVALID_SUBSCRIPTION_ID) {
999 return SubscriptionManager.getResourcesForSubId(context, subId);
1000 } else {
1001 return context.getResources();
1002 }
1003 }
Ng Zhi Anb97bdc32019-02-01 12:39:31 -08001004
1005 /**
1006 * Returns true if SYSTEM_ALERT_WINDOW permission is available.
1007 * Starting from Q, SYSTEM_ALERT_WINDOW is disabled on low ram phones.
1008 */
1009 public static boolean isSystemAlertWindowEnabled(Context context) {
1010 // SYSTEM_ALERT_WINDOW is disabled on on low ram devices starting from Q
1011 ActivityManager am = (ActivityManager) context.getSystemService(Context.ACTIVITY_SERVICE);
1012 return !(am.isLowRamDevice() && (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q));
1013 }
tmfangaed8f362019-03-18 16:56:09 +08001014
1015 /**
1016 * Adds a shadow appear/disappear animation to action bar scroll.
1017 *
1018 * <p/>
1019 * This method must be called after {@link Fragment#onCreate(Bundle)}.
1020 */
1021 public static void setActionBarShadowAnimation(Activity activity, Lifecycle lifecycle,
1022 View scrollView) {
1023 if (activity == null) {
1024 Log.w(TAG, "No activity, cannot style actionbar.");
1025 return;
1026 }
1027 final ActionBar actionBar = activity.getActionBar();
1028 if (actionBar == null) {
1029 Log.w(TAG, "No actionbar, cannot style actionbar.");
1030 return;
1031 }
1032 actionBar.setElevation(0);
1033
1034 if (lifecycle != null && scrollView != null) {
1035 ActionBarShadowController.attachToView(activity, lifecycle, scrollView);
1036 }
1037 }
Raff Tsaiafd494d2019-10-16 15:25:21 +08001038
1039 /**
1040 * Return correct target fragment based on argument
1041 *
1042 * @param activity the activity target fragment will be launched.
1043 * @param fragmentName initial target fragment name.
1044 * @param args fragment launch arguments.
1045 */
1046 public static Fragment getTargetFragment(Activity activity, String fragmentName, Bundle args) {
1047 Fragment f = null;
Raff Tsai84327f62019-11-15 11:02:25 +08001048 final boolean isPersonal = args != null ? args.getInt(ProfileSelectFragment.EXTRA_PROFILE)
Raff Tsai1e5d8142019-12-12 11:45:41 +08001049 == ProfileSelectFragment.ProfileType.PERSONAL : false;
Raff Tsai84327f62019-11-15 11:02:25 +08001050 final boolean isWork = args != null ? args.getInt(ProfileSelectFragment.EXTRA_PROFILE)
Raff Tsai1e5d8142019-12-12 11:45:41 +08001051 == ProfileSelectFragment.ProfileType.WORK : false;
Raff Tsai3fbdf342020-01-16 05:27:32 +08001052 if (activity.getSystemService(UserManager.class).getUserProfiles().size() > 1
Raff Tsaiafd494d2019-10-16 15:25:21 +08001053 && ProfileFragmentBridge.FRAGMENT_MAP.get(fragmentName) != null
Raff Tsai84327f62019-11-15 11:02:25 +08001054 && !isWork && !isPersonal) {
Raff Tsaiafd494d2019-10-16 15:25:21 +08001055 f = Fragment.instantiate(activity, ProfileFragmentBridge.FRAGMENT_MAP.get(fragmentName),
1056 args);
1057 } else {
1058 f = Fragment.instantiate(activity, fragmentName, args);
1059 }
1060 return f;
1061 }
Jeff Sharkey4a8136b2016-07-27 12:53:34 -06001062}