blob: f45ac5edb25bcf280b111a0df8343f80efaf315b [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;
Amith Yamasaniae697552011-09-27 11:33:17 -070025import android.app.ActivityManager;
Amith Yamasani9627a8e2012-09-23 12:54:14 -070026import android.app.AlertDialog;
Sudheer Shankabc956302015-04-09 12:19:53 +010027import android.app.AppGlobals;
Amith Yamasani9627a8e2012-09-23 12:54:14 -070028import android.app.Dialog;
Fabrice Di Meglio769630c2014-04-24 14:48:48 -070029import android.app.Fragment;
Alexandra Gherghina1eb3f312014-06-10 14:01:10 +010030import android.app.IActivityManager;
Rubin Xu3231afe2016-08-24 10:15:07 +010031import android.app.KeyguardManager;
Sudheer Shankabc956302015-04-09 12:19:53 +010032import android.app.admin.DevicePolicyManager;
Daniel Nishi31027da2017-01-19 14:03:57 -080033import android.content.ActivityNotFoundException;
Fabrice Di Meglio8b2ea392015-01-23 19:03:22 -080034import android.content.ComponentName;
Amith Yamasani8d40fac2012-10-23 15:36:16 -070035import android.content.ContentResolver;
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -080036import android.content.Context;
Amith Yamasani9627a8e2012-09-23 12:54:14 -070037import android.content.DialogInterface;
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -080038import android.content.Intent;
Fabrice Di Meglio8b2ea392015-01-23 19:03:22 -080039import android.content.IntentFilter;
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -080040import android.content.pm.ApplicationInfo;
Sudheer Shankabc956302015-04-09 12:19:53 +010041import android.content.pm.IPackageManager;
Christopher Tatea08a2252015-07-01 16:52:43 -070042import android.content.pm.IntentFilterVerificationInfo;
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -080043import android.content.pm.PackageManager;
Jason Monk75199542016-05-06 15:09:32 -040044import android.content.pm.PackageManager.NameNotFoundException;
Jeff Sharkeyb654cbb2011-08-18 11:59:19 -070045import android.content.pm.ResolveInfo;
Amith Yamasaniae47ef42012-09-16 17:53:35 -070046import android.content.pm.UserInfo;
Anders Hammar1b2dd9032010-04-08 10:03:50 +020047import android.content.res.Resources;
Jason Monkb5aa73f2015-03-31 12:59:33 -040048import android.content.res.TypedArray;
Amith Yamasaniae47ef42012-09-16 17:53:35 -070049import android.database.Cursor;
Amith Yamasanif34a85d2012-09-17 18:31:45 -070050import android.graphics.Bitmap;
Felipe Lemebd884502017-09-15 18:16:21 -070051import android.graphics.Canvas;
52import android.graphics.drawable.BitmapDrawable;
53import android.graphics.drawable.Drawable;
Jeff Sharkeyab508072016-10-11 14:25:22 -060054import android.hardware.fingerprint.FingerprintManager;
Roozbeh Pournader15872242017-06-20 16:46:49 -070055import android.icu.text.MeasureFormat;
Roozbeh Pournader4de9df22017-08-26 14:05:15 -070056import android.icu.text.RelativeDateTimeFormatter;
57import android.icu.text.RelativeDateTimeFormatter.RelativeUnit;
Roozbeh Pournader15872242017-06-20 16:46:49 -070058import android.icu.util.Measure;
59import android.icu.util.MeasureUnit;
Roozbeh Pournader4de9df22017-08-26 14:05:15 -070060import android.icu.util.ULocale;
Amith Yamasanic06d4c42011-02-25 14:35:20 -080061import android.net.ConnectivityManager;
62import android.net.LinkProperties;
Jaewoong Jungc260e6d2016-10-13 14:21:52 -070063import android.net.Network;
Jaewoong Jungc260e6d2016-10-13 14:21:52 -070064import android.net.wifi.WifiManager;
Amith Yamasania4379d62011-07-22 10:34:58 -070065import android.os.BatteryManager;
Anders Hammar1b2dd9032010-04-08 10:03:50 +020066import android.os.Bundle;
Alexandra Gherghina1eb3f312014-06-10 14:01:10 +010067import android.os.IBinder;
Jason Monkb45e27b2015-05-20 13:35:43 -040068import android.os.INetworkManagementService;
Jason Monkbe941212016-05-27 12:58:53 -040069import android.os.Looper;
Alexandra Gherghina1eb3f312014-06-10 14:01:10 +010070import android.os.RemoteException;
Jason Monkb45e27b2015-05-20 13:35:43 -040071import android.os.ServiceManager;
Amith Yamasaniae47ef42012-09-16 17:53:35 -070072import android.os.UserHandle;
73import android.os.UserManager;
Fabrice Di Megliodff3faa2015-02-27 11:14:11 -080074import android.os.storage.StorageManager;
Daniel Nishi9f60f422017-02-15 15:25:48 -080075import android.os.storage.VolumeInfo;
Jeff Sharkeyb654cbb2011-08-18 11:59:19 -070076import android.preference.PreferenceFrameLayout;
Amith Yamasani8d40fac2012-10-23 15:36:16 -070077import android.provider.ContactsContract.CommonDataKinds;
Amith Yamasaniae47ef42012-09-16 17:53:35 -070078import android.provider.ContactsContract.Contacts;
Amith Yamasani8d40fac2012-10-23 15:36:16 -070079import android.provider.ContactsContract.Data;
Amith Yamasaniae47ef42012-09-16 17:53:35 -070080import android.provider.ContactsContract.Profile;
Amith Yamasani8d40fac2012-10-23 15:36:16 -070081import android.provider.ContactsContract.RawContacts;
Udam Saini679f7ad2016-03-25 10:47:00 -070082import android.provider.Settings;
jackqdyuleiddba9662017-03-08 19:35:02 -080083import android.support.annotation.StringRes;
Jason Monk39b46742015-09-10 15:52:51 -040084import android.support.v7.preference.Preference;
85import android.support.v7.preference.PreferenceGroup;
Jason Monk91e2f892016-02-23 15:31:09 -050086import android.support.v7.preference.PreferenceManager;
87import android.support.v7.preference.PreferenceScreen;
Amith Yamasani60133dd2010-09-11 14:17:31 -070088import android.telephony.TelephonyManager;
Julia Reynoldsce25af42015-07-08 16:56:31 -040089import android.text.Spannable;
90import android.text.SpannableString;
jackqdyuleif4c1cef2017-03-31 12:57:10 -070091import android.text.SpannableStringBuilder;
92import android.text.Spanned;
Anders Hammar1b2dd9032010-04-08 10:03:50 +020093import android.text.TextUtils;
Jason Monkb37e2882016-01-11 14:27:20 -050094import android.text.format.DateUtils;
Julia Reynoldsce25af42015-07-08 16:56:31 -040095import android.text.style.TtsSpan;
Christopher Tatea08a2252015-07-01 16:52:43 -070096import android.util.ArraySet;
jackqdyuleifde637f2018-01-02 14:51:01 -080097import android.util.IconDrawableFactory;
Alexandra Gherghina1eb3f312014-06-10 14:01:10 +010098import android.util.Log;
Jason Monkdb4ed192015-12-11 16:48:31 -050099import android.util.TypedValue;
Zoltan Szatmary-Ban3af2e4c2014-12-19 17:17:23 +0000100import android.view.LayoutInflater;
Jeff Sharkeyb654cbb2011-08-18 11:59:19 -0700101import android.view.View;
102import android.view.ViewGroup;
PMS2263a05602017-06-14 07:10:15 +0000103import android.widget.EditText;
Jeff Sharkeyb654cbb2011-08-18 11:59:19 -0700104import android.widget.ListView;
105import android.widget.TabWidget;
Fan Zhangcc335d92016-09-29 14:37:14 -0700106
Ricky Wai616342b2016-04-13 10:40:22 +0100107import com.android.internal.app.UnlaunchableAppActivity;
Ricky Wai72500162016-06-07 16:54:25 +0100108import com.android.internal.util.ArrayUtils;
Rubin Xu3231afe2016-08-24 10:15:07 +0100109import com.android.internal.widget.LockPatternUtils;
Jeff Sharkey219ec912017-12-19 14:57:39 -0700110import com.android.settings.password.ChooseLockSettingsHelper;
Doris Lingdee1a222017-08-31 16:17:30 -0700111import com.android.settings.wrapper.DevicePolicyManagerWrapper;
Tony Mantlerd9af0b82017-10-20 15:03:28 -0700112import com.android.settings.wrapper.FingerprintManagerWrapper;
Leif Hendrik Wilden28dee1f2018-01-11 10:15:36 -0800113import com.android.settingslib.core.instrumentation.VisibilityLoggerMixin;
Daisuke Miyakawaa2633d02010-09-15 20:09:12 -0700114
Amith Yamasanic06d4c42011-02-25 14:35:20 -0800115import java.net.InetAddress;
Alexandra Gherghina80e1f1b2014-07-31 14:56:33 +0100116import java.util.ArrayList;
Amith Yamasanic06d4c42011-02-25 14:35:20 -0800117import java.util.Iterator;
Daisuke Miyakawaa2633d02010-09-15 20:09:12 -0700118import java.util.List;
Jean Chalard71ad1f42011-05-12 15:06:16 +0900119import java.util.Locale;
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800120
Jason Monk27985e12016-01-08 14:13:05 -0500121public final class Utils extends com.android.settingslib.Utils {
122
Alexandra Gherghina1eb3f312014-06-10 14:01:10 +0100123 private static final String TAG = "Settings";
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100124
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
130 /**
Dianne Hackborn68f005f2014-06-18 18:29:12 -0700131 * Color spectrum to use to indicate badness. 0 is completely transparent (no data),
132 * 1 is most bad (red), the last value is least bad (green).
133 */
134 public static final int[] BADNESS_COLORS = new int[] {
135 0x00000000, 0xffc43828, 0xffe54918, 0xfff47b00,
136 0xfffabf2c, 0xff679e37, 0xff0a7f42
137 };
138
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100139 private static final String SETTINGS_PACKAGE_NAME = "com.android.settings";
140
Elliott Hughes7253df32014-09-02 17:10:14 -0700141 private static final int SECONDS_PER_MINUTE = 60;
142 private static final int SECONDS_PER_HOUR = 60 * 60;
143 private static final int SECONDS_PER_DAY = 24 * 60 * 60;
144
Jason Monkbeb171d2015-05-21 15:24:37 -0400145 public static final String OS_PKG = "os";
146
Anders Hammar1b2dd9032010-04-08 10:03:50 +0200147 /**
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800148 * Finds a matching activity for a preference's intent. If a matching
149 * activity is not found, it will remove the preference.
Ying Wanga7188322010-01-04 18:45:10 -0800150 *
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800151 * @param context The context.
152 * @param parentPreferenceGroup The preference group that contains the
153 * preference whose intent is being resolved.
154 * @param preferenceKey The key of the preference whose intent is being
155 * resolved.
156 * @param flags 0 or one or more of
157 * {@link #UPDATE_PREFERENCE_FLAG_SET_TITLE_TO_MATCHING_ACTIVITY}
158 * .
159 * @return Whether an activity was found. If false, the preference was
160 * removed.
161 */
162 public static boolean updatePreferenceToSpecificActivityOrRemove(Context context,
163 PreferenceGroup parentPreferenceGroup, String preferenceKey, int flags) {
Ying Wanga7188322010-01-04 18:45:10 -0800164
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800165 Preference preference = parentPreferenceGroup.findPreference(preferenceKey);
166 if (preference == null) {
167 return false;
168 }
Ying Wanga7188322010-01-04 18:45:10 -0800169
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800170 Intent intent = preference.getIntent();
171 if (intent != null) {
172 // Find the activity that is in the system image
173 PackageManager pm = context.getPackageManager();
174 List<ResolveInfo> list = pm.queryIntentActivities(intent, 0);
175 int listSize = list.size();
176 for (int i = 0; i < listSize; i++) {
177 ResolveInfo resolveInfo = list.get(i);
178 if ((resolveInfo.activityInfo.applicationInfo.flags & ApplicationInfo.FLAG_SYSTEM)
179 != 0) {
Ying Wanga7188322010-01-04 18:45:10 -0800180
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800181 // Replace the intent with this specific activity
182 preference.setIntent(new Intent().setClassName(
183 resolveInfo.activityInfo.packageName,
184 resolveInfo.activityInfo.name));
185
186 if ((flags & UPDATE_PREFERENCE_FLAG_SET_TITLE_TO_MATCHING_ACTIVITY) != 0) {
187 // Set the preference title to the activity's label
188 preference.setTitle(resolveInfo.loadLabel(pm));
189 }
Ying Wanga7188322010-01-04 18:45:10 -0800190
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800191 return true;
192 }
193 }
194 }
195
196 // Did not find a matching activity, so remove the preference
197 parentPreferenceGroup.removePreference(preference);
Ying Wanga7188322010-01-04 18:45:10 -0800198
Shuhrat Dehkanov7dc567a2012-04-23 01:59:56 +0900199 return false;
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800200 }
Ying Wanga7188322010-01-04 18:45:10 -0800201
Anders Hammar1b2dd9032010-04-08 10:03:50 +0200202 /**
Benjamin Franz194300d2016-01-13 12:16:25 +0000203 * Returns the UserManager for a given context
204 *
205 * @throws IllegalStateException if no UserManager could be retrieved.
206 */
207 public static UserManager getUserManager(Context context) {
208 UserManager um = UserManager.get(context);
209 if (um == null) {
210 throw new IllegalStateException("Unable to load UserManager");
211 }
212 return um;
213 }
214
215 /**
Ying Wanga7188322010-01-04 18:45:10 -0800216 * Returns true if Monkey is running.
217 */
218 public static boolean isMonkeyRunning() {
Amith Yamasaniae697552011-09-27 11:33:17 -0700219 return ActivityManager.isUserAMonkey();
Ying Wanga7188322010-01-04 18:45:10 -0800220 }
Amith Yamasani60133dd2010-09-11 14:17:31 -0700221
222 /**
223 * Returns whether the device is voice-capable (meaning, it is also a phone).
224 */
225 public static boolean isVoiceCapable(Context context) {
226 TelephonyManager telephony =
227 (TelephonyManager) context.getSystemService(Context.TELEPHONY_SERVICE);
228 return telephony != null && telephony.isVoiceCapable();
229 }
Amith Yamasani0f85c482011-02-23 17:19:11 -0800230
Amith Yamasanic06d4c42011-02-25 14:35:20 -0800231 /**
232 * Returns the WIFI IP Addresses, if any, taking into account IPv4 and IPv6 style addresses.
233 * @param context the application context
Lorenzo Colitti769f0692013-08-01 17:30:07 +0900234 * @return the formatted and newline-separated IP addresses, or null if none.
Amith Yamasanic06d4c42011-02-25 14:35:20 -0800235 */
236 public static String getWifiIpAddresses(Context context) {
Jaewoong Jungc260e6d2016-10-13 14:21:52 -0700237 WifiManager wifiManager = context.getSystemService(WifiManager.class);
238 Network currentNetwork = wifiManager.getCurrentNetwork();
239 if (currentNetwork != null) {
240 ConnectivityManager cm = (ConnectivityManager)
Amith Yamasanic06d4c42011-02-25 14:35:20 -0800241 context.getSystemService(Context.CONNECTIVITY_SERVICE);
Jaewoong Jungc260e6d2016-10-13 14:21:52 -0700242 LinkProperties prop = cm.getLinkProperties(currentNetwork);
243 return formatIpAddresses(prop);
244 }
245 return null;
Amith Yamasani6822b742011-10-17 16:41:00 -0700246 }
247
248 /**
249 * Returns the default link's IP addresses, if any, taking into account IPv4 and IPv6 style
250 * addresses.
Lorenzo Colitti769f0692013-08-01 17:30:07 +0900251 * @return the formatted and newline-separated IP addresses, or null if none.
Amith Yamasani6822b742011-10-17 16:41:00 -0700252 */
Lorenzo Colitti6eb6a902013-11-08 03:53:29 +0900253 public static String getDefaultIpAddresses(ConnectivityManager cm) {
Amith Yamasani6822b742011-10-17 16:41:00 -0700254 LinkProperties prop = cm.getActiveLinkProperties();
255 return formatIpAddresses(prop);
256 }
257
258 private static String formatIpAddresses(LinkProperties prop) {
Amith Yamasanic06d4c42011-02-25 14:35:20 -0800259 if (prop == null) return null;
Lorenzo Colitti769f0692013-08-01 17:30:07 +0900260 Iterator<InetAddress> iter = prop.getAllAddresses().iterator();
Amith Yamasanic06d4c42011-02-25 14:35:20 -0800261 // If there are no entries, return null
262 if (!iter.hasNext()) return null;
263 // Concatenate all available addresses, comma separated
264 String addresses = "";
265 while (iter.hasNext()) {
266 addresses += iter.next().getHostAddress();
Lorenzo Colitti769f0692013-08-01 17:30:07 +0900267 if (iter.hasNext()) addresses += "\n";
Amith Yamasanic06d4c42011-02-25 14:35:20 -0800268 }
269 return addresses;
270 }
Jean Chalard71ad1f42011-05-12 15:06:16 +0900271
272 public static Locale createLocaleFromString(String localeStr) {
273 // TODO: is there a better way to actually construct a locale that will match?
274 // The main problem is, on top of Java specs, locale.toString() and
275 // new Locale(locale.toString()).toString() do not return equal() strings in
276 // many cases, because the constructor takes the only string as the language
277 // code. So : new Locale("en", "US").toString() => "en_US"
278 // And : new Locale("en_US").toString() => "en_us"
279 if (null == localeStr)
280 return Locale.getDefault();
281 String[] brokenDownLocale = localeStr.split("_", 3);
282 // split may not return a 0-length array.
283 if (1 == brokenDownLocale.length) {
284 return new Locale(brokenDownLocale[0]);
285 } else if (2 == brokenDownLocale.length) {
286 return new Locale(brokenDownLocale[0], brokenDownLocale[1]);
287 } else {
288 return new Locale(brokenDownLocale[0], brokenDownLocale[1], brokenDownLocale[2]);
289 }
290 }
Amith Yamasania4379d62011-07-22 10:34:58 -0700291
Jaewan Kima3fe77b2013-06-04 21:17:40 +0900292 public static boolean isBatteryPresent(Intent batteryChangedIntent) {
293 return batteryChangedIntent.getBooleanExtra(BatteryManager.EXTRA_PRESENT, true);
294 }
295
Amith Yamasania4379d62011-07-22 10:34:58 -0700296 public static String getBatteryPercentage(Intent batteryChangedIntent) {
Elliott Hughes7253df32014-09-02 17:10:14 -0700297 return formatPercentage(getBatteryLevel(batteryChangedIntent));
Dianne Hackborn525f2bd2014-04-29 11:24:06 -0700298 }
299
Jeff Sharkeyb654cbb2011-08-18 11:59:19 -0700300 /**
301 * Prepare a custom preferences layout, moving padding to {@link ListView}
302 * when outside scrollbars are requested. Usually used to display
303 * {@link ListView} and {@link TabWidget} with correct padding.
304 */
Jeff Sharkey5d706792011-09-08 18:57:17 -0700305 public static void prepareCustomPreferencesList(
Jeff Sharkey97d07fa2012-11-30 12:36:53 -0800306 ViewGroup parent, View child, View list, boolean ignoreSidePadding) {
Jeff Sharkeyb654cbb2011-08-18 11:59:19 -0700307 final boolean movePadding = list.getScrollBarStyle() == View.SCROLLBARS_OUTSIDE_OVERLAY;
Fabrice Di Meglio97a18c82014-07-18 19:12:36 -0700308 if (movePadding) {
Jeff Sharkeyb654cbb2011-08-18 11:59:19 -0700309 final Resources res = list.getResources();
Amith Yamasani56f51a82013-08-05 10:07:23 -0700310 final int paddingSide = res.getDimensionPixelSize(R.dimen.settings_side_margin);
Jeff Sharkeyb654cbb2011-08-18 11:59:19 -0700311 final int paddingBottom = res.getDimensionPixelSize(
312 com.android.internal.R.dimen.preference_fragment_padding_bottom);
Jeff Sharkey5d706792011-09-08 18:57:17 -0700313
Fabrice Di Meglio97a18c82014-07-18 19:12:36 -0700314 if (parent instanceof PreferenceFrameLayout) {
315 ((PreferenceFrameLayout.LayoutParams) child.getLayoutParams()).removeBorders = true;
316
317 final int effectivePaddingSide = ignoreSidePadding ? 0 : paddingSide;
318 list.setPaddingRelative(effectivePaddingSide, 0, effectivePaddingSide, paddingBottom);
319 } else {
320 list.setPaddingRelative(paddingSide, 0, paddingSide, paddingBottom);
321 }
Jeff Sharkeyb654cbb2011-08-18 11:59:19 -0700322 }
323 }
Jeff Sharkeya83a24f2011-09-16 01:52:39 -0700324
Fabrice Di Meglio0f4a7792014-07-28 18:25:14 -0700325 public static void forceCustomPadding(View view, boolean additive) {
Fabrice Di Meglio38ba9a22014-07-18 19:58:50 -0700326 final Resources res = view.getResources();
327 final int paddingSide = res.getDimensionPixelSize(R.dimen.settings_side_margin);
Fabrice Di Meglio0f4a7792014-07-28 18:25:14 -0700328
329 final int paddingStart = paddingSide + (additive ? view.getPaddingStart() : 0);
330 final int paddingEnd = paddingSide + (additive ? view.getPaddingEnd() : 0);
Fabrice Di Meglio38ba9a22014-07-18 19:58:50 -0700331 final int paddingBottom = res.getDimensionPixelSize(
332 com.android.internal.R.dimen.preference_fragment_padding_bottom);
333
Fabrice Di Meglio0f4a7792014-07-28 18:25:14 -0700334 view.setPaddingRelative(paddingStart, 0, paddingEnd, paddingBottom);
Fabrice Di Meglio38ba9a22014-07-18 19:58:50 -0700335 }
336
Amith Yamasani8d40fac2012-10-23 15:36:16 -0700337 public static String getMeProfileName(Context context, boolean full) {
338 if (full) {
339 return getProfileDisplayName(context);
340 } else {
341 return getShorterNameIfPossible(context);
Amith Yamasaniae47ef42012-09-16 17:53:35 -0700342 }
Amith Yamasani8d40fac2012-10-23 15:36:16 -0700343 }
344
345 private static String getShorterNameIfPossible(Context context) {
346 final String given = getLocalProfileGivenName(context);
347 return !TextUtils.isEmpty(given) ? given : getProfileDisplayName(context);
348 }
349
350 private static String getLocalProfileGivenName(Context context) {
351 final ContentResolver cr = context.getContentResolver();
352
353 // Find the raw contact ID for the local ME profile raw contact.
354 final long localRowProfileId;
355 final Cursor localRawProfile = cr.query(
356 Profile.CONTENT_RAW_CONTACTS_URI,
357 new String[] {RawContacts._ID},
358 RawContacts.ACCOUNT_TYPE + " IS NULL AND " +
359 RawContacts.ACCOUNT_NAME + " IS NULL",
360 null, null);
361 if (localRawProfile == null) return null;
Amith Yamasaniae47ef42012-09-16 17:53:35 -0700362
363 try {
Amith Yamasani8d40fac2012-10-23 15:36:16 -0700364 if (!localRawProfile.moveToFirst()) {
365 return null;
Amith Yamasaniae47ef42012-09-16 17:53:35 -0700366 }
Amith Yamasani8d40fac2012-10-23 15:36:16 -0700367 localRowProfileId = localRawProfile.getLong(0);
Amith Yamasaniae47ef42012-09-16 17:53:35 -0700368 } finally {
Amith Yamasani8d40fac2012-10-23 15:36:16 -0700369 localRawProfile.close();
Amith Yamasaniae47ef42012-09-16 17:53:35 -0700370 }
Amith Yamasani8d40fac2012-10-23 15:36:16 -0700371
372 // Find the structured name for the raw contact.
373 final Cursor structuredName = cr.query(
374 Profile.CONTENT_URI.buildUpon().appendPath(Contacts.Data.CONTENT_DIRECTORY).build(),
375 new String[] {CommonDataKinds.StructuredName.GIVEN_NAME,
376 CommonDataKinds.StructuredName.FAMILY_NAME},
377 Data.RAW_CONTACT_ID + "=" + localRowProfileId,
378 null, null);
379 if (structuredName == null) return null;
380
381 try {
382 if (!structuredName.moveToFirst()) {
383 return null;
384 }
385 String partialName = structuredName.getString(0);
386 if (TextUtils.isEmpty(partialName)) {
387 partialName = structuredName.getString(1);
388 }
389 return partialName;
390 } finally {
391 structuredName.close();
392 }
393 }
394
395 private static final String getProfileDisplayName(Context context) {
396 final ContentResolver cr = context.getContentResolver();
397 final Cursor profile = cr.query(Profile.CONTENT_URI,
398 new String[] {Profile.DISPLAY_NAME}, null, null, null);
399 if (profile == null) return null;
400
401 try {
402 if (!profile.moveToFirst()) {
403 return null;
404 }
405 return profile.getString(0);
406 } finally {
407 profile.close();
408 }
Amith Yamasaniae47ef42012-09-16 17:53:35 -0700409 }
Amith Yamasani9627a8e2012-09-23 12:54:14 -0700410
411 /** Not global warming, it's global change warning. */
412 public static Dialog buildGlobalChangeWarningDialog(final Context context, int titleResId,
413 final Runnable positiveAction) {
414 final AlertDialog.Builder builder = new AlertDialog.Builder(context);
415 builder.setTitle(titleResId);
416 builder.setMessage(R.string.global_change_warning);
417 builder.setPositiveButton(android.R.string.ok, new DialogInterface.OnClickListener() {
418 @Override
419 public void onClick(DialogInterface dialog, int which) {
420 positiveAction.run();
421 }
422 });
423 builder.setNegativeButton(android.R.string.cancel, null);
424
425 return builder.create();
426 }
427
428 public static boolean hasMultipleUsers(Context context) {
429 return ((UserManager) context.getSystemService(Context.USER_SERVICE))
430 .getUsers().size() > 1;
431 }
Fabrice Di Meglio769630c2014-04-24 14:48:48 -0700432
433 /**
434 * Start a new instance of the activity, showing only the given fragment.
435 * When launched in this mode, the given preference fragment will be instantiated and fill the
436 * entire activity.
437 *
438 * @param context The context.
Fabrice Di Meglio93b77b72014-05-17 00:01:07 +0000439 * @param fragmentName The name of the fragment to display.
Fabrice Di Meglio769630c2014-04-24 14:48:48 -0700440 * @param args Optional arguments to supply to the fragment.
Fabrice Di Meglioa9e77992014-06-09 12:52:24 -0700441 * @param resultTo Option fragment that should receive the result of the activity launch.
442 * @param resultRequestCode If resultTo is non-null, this is the request code in which
443 * to report the result.
444 * @param titleResId resource id for the String to display for the title of this set
445 * of preferences.
Fabrice Di Meglio769630c2014-04-24 14:48:48 -0700446 * @param title String to display for the title of this set of preferences.
Fan Zhangc6ca3142017-02-14 15:02:35 -0800447 * @param metricsCategory The current metricsCategory for logging source when fragment starts
Fabrice Di Meglio769630c2014-04-24 14:48:48 -0700448 */
Fabrice Di Meglio93b77b72014-05-17 00:01:07 +0000449 public static void startWithFragment(Context context, String fragmentName, Bundle args,
Alexandra Gherghina62464b82014-08-11 12:40:13 +0100450 Fragment resultTo, int resultRequestCode, int titleResId,
Fan Zhangc6ca3142017-02-14 15:02:35 -0800451 CharSequence title, int metricsCategory) {
Fabrice Di Meglio0d643fd2014-06-16 20:11:27 -0700452 startWithFragment(context, fragmentName, args, resultTo, resultRequestCode,
Fan Zhangc6ca3142017-02-14 15:02:35 -0800453 null /* titleResPackageName */, titleResId, title, false /* not a shortcut */,
454 metricsCategory);
Alexandra Gherghina62464b82014-08-11 12:40:13 +0100455 }
456
Ajay Nadathurd473e382017-11-07 13:38:50 -0800457
458 /**
459 * Start a new instance of the activity, showing only the given fragment.
460 * When launched in this mode, the given preference fragment will be instantiated and fill the
461 * entire activity.
462 *
463 * @param context The context.
464 * @param fragmentName The name of the fragment to display.
465 * @param titleResId resource id for the String to display for the title of this set
466 * of preferences.
467 * @param metricsCategory The current metricsCategory for logging source when fragment starts
468 * @param intentFlags flag that should be added to the intent.
469 */
470 public static void startWithFragment(Context context, String fragmentName, int titleResId,
471 int metricsCategory, int intentFlags) {
472 startWithFragment(context, fragmentName, null, null, 0,
473 null /* titleResPackageName */, titleResId, null, false /* not a shortcut */,
474 metricsCategory, intentFlags);
475 }
476
Alexandra Gherghina62464b82014-08-11 12:40:13 +0100477 /**
478 * Start a new instance of the activity, showing only the given fragment.
479 * When launched in this mode, the given preference fragment will be instantiated and fill the
480 * entire activity.
481 *
482 * @param context The context.
483 * @param fragmentName The name of the fragment to display.
484 * @param args Optional arguments to supply to the fragment.
485 * @param resultTo Option fragment that should receive the result of the activity launch.
486 * @param resultRequestCode If resultTo is non-null, this is the request code in which
487 * to report the result.
488 * @param titleResPackageName Optional package name for the resource id of the title.
489 * @param titleResId resource id for the String to display for the title of this set
490 * of preferences.
491 * @param title String to display for the title of this set of preferences.
Fan Zhangc6ca3142017-02-14 15:02:35 -0800492 * @param metricsCategory The current metricsCategory for logging source when fragment starts
Alexandra Gherghina62464b82014-08-11 12:40:13 +0100493 */
494 public static void startWithFragment(Context context, String fragmentName, Bundle args,
495 Fragment resultTo, int resultRequestCode, String titleResPackageName, int titleResId,
Fan Zhangc6ca3142017-02-14 15:02:35 -0800496 CharSequence title, int metricsCategory) {
Alexandra Gherghina62464b82014-08-11 12:40:13 +0100497 startWithFragment(context, fragmentName, args, resultTo, resultRequestCode,
Fan Zhangc6ca3142017-02-14 15:02:35 -0800498 titleResPackageName, titleResId, title, false /* not a shortcut */,
499 metricsCategory);
Fabrice Di Meglio0d643fd2014-06-16 20:11:27 -0700500 }
501
502 public static void startWithFragment(Context context, String fragmentName, Bundle args,
Alexandra Gherghina62464b82014-08-11 12:40:13 +0100503 Fragment resultTo, int resultRequestCode, int titleResId,
Fan Zhangc6ca3142017-02-14 15:02:35 -0800504 CharSequence title, boolean isShortcut, int metricsCategory) {
Alexandra Gherghina62464b82014-08-11 12:40:13 +0100505 Intent intent = onBuildStartFragmentIntent(context, fragmentName, args,
Fan Zhangc6ca3142017-02-14 15:02:35 -0800506 null /* titleResPackageName */, titleResId, title, isShortcut, metricsCategory);
Alexandra Gherghina62464b82014-08-11 12:40:13 +0100507 if (resultTo == null) {
508 context.startActivity(intent);
509 } else {
Doris Ling36e953f2016-08-12 15:25:00 -0700510 resultTo.getActivity().startActivityForResult(intent, resultRequestCode);
Alexandra Gherghina62464b82014-08-11 12:40:13 +0100511 }
512 }
513
514 public static void startWithFragment(Context context, String fragmentName, Bundle args,
515 Fragment resultTo, int resultRequestCode, String titleResPackageName, int titleResId,
Fan Zhangc6ca3142017-02-14 15:02:35 -0800516 CharSequence title, boolean isShortcut, int metricsCategory) {
Ajay Nadathurd473e382017-11-07 13:38:50 -0800517 startWithFragment(context, fragmentName, args, resultTo, resultRequestCode,
Fan Zhangb7270a52018-01-22 14:07:52 -0800518 titleResPackageName, titleResId, title, isShortcut, metricsCategory,
519 Intent.FLAG_ACTIVITY_NEW_TASK);
Ajay Nadathurd473e382017-11-07 13:38:50 -0800520 }
521
522
523 public static void startWithFragment(Context context, String fragmentName, Bundle args,
524 Fragment resultTo, int resultRequestCode, String titleResPackageName, int titleResId,
525 CharSequence title, boolean isShortcut, int metricsCategory, int flags) {
Alexandra Gherghina62464b82014-08-11 12:40:13 +0100526 Intent intent = onBuildStartFragmentIntent(context, fragmentName, args, titleResPackageName,
Fan Zhangc6ca3142017-02-14 15:02:35 -0800527 titleResId, title, isShortcut, metricsCategory);
Ajay Nadathurd473e382017-11-07 13:38:50 -0800528 intent.addFlags(flags);
Fabrice Di Meglio769630c2014-04-24 14:48:48 -0700529 if (resultTo == null) {
530 context.startActivity(intent);
531 } else {
532 resultTo.startActivityForResult(intent, resultRequestCode);
533 }
534 }
535
Zoltan Szatmary-Ban7a2ccf22014-09-18 10:26:11 +0100536 public static void startWithFragmentAsUser(Context context, String fragmentName, Bundle args,
Fan Zhangc6ca3142017-02-14 15:02:35 -0800537 int titleResId, CharSequence title, boolean isShortcut, int metricsCategory,
Alexandra Gherghina62464b82014-08-11 12:40:13 +0100538 UserHandle userHandle) {
Victor Chang16da2aa2016-03-11 19:44:56 +0000539 // workaround to avoid crash in b/17523189
540 if (userHandle.getIdentifier() == UserHandle.myUserId()) {
Fan Zhangc6ca3142017-02-14 15:02:35 -0800541 startWithFragment(context, fragmentName, args, null, 0, titleResId, title, isShortcut,
542 metricsCategory);
Victor Chang16da2aa2016-03-11 19:44:56 +0000543 } else {
544 Intent intent = onBuildStartFragmentIntent(context, fragmentName, args,
Fan Zhangc6ca3142017-02-14 15:02:35 -0800545 null /* titleResPackageName */, titleResId, title, isShortcut, metricsCategory);
Victor Chang16da2aa2016-03-11 19:44:56 +0000546 intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
547 intent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TASK);
548 context.startActivityAsUser(intent, userHandle);
549 }
Zoltan Szatmary-Ban7a2ccf22014-09-18 10:26:11 +0100550 }
551
Fabrice Di Meglio769630c2014-04-24 14:48:48 -0700552 /**
553 * Build an Intent to launch a new activity showing the selected fragment.
554 * The implementation constructs an Intent that re-launches the current activity with the
555 * appropriate arguments to display the fragment.
556 *
Fabrice Di Meglio0d643fd2014-06-16 20:11:27 -0700557 *
Fabrice Di Meglio769630c2014-04-24 14:48:48 -0700558 * @param context The Context.
Fabrice Di Meglio93b77b72014-05-17 00:01:07 +0000559 * @param fragmentName The name of the fragment to display.
Fabrice Di Meglio769630c2014-04-24 14:48:48 -0700560 * @param args Optional arguments to supply to the fragment.
Alexandra Gherghina62464b82014-08-11 12:40:13 +0100561 * @param titleResPackageName Optional package name for the resource id of the title.
Fabrice Di Meglioa9e77992014-06-09 12:52:24 -0700562 * @param titleResId Optional title resource id to show for this item.
Fabrice Di Meglio769630c2014-04-24 14:48:48 -0700563 * @param title Optional title to show for this item.
Fabrice Di Meglio0d643fd2014-06-16 20:11:27 -0700564 * @param isShortcut tell if this is a Launcher Shortcut or not
Fan Zhangc6ca3142017-02-14 15:02:35 -0800565 * @param sourceMetricsCategory The context (source) from which an action is performed
Fabrice Di Meglio769630c2014-04-24 14:48:48 -0700566 * @return Returns an Intent that can be launched to display the given
567 * fragment.
568 */
Fabrice Di Meglio93b77b72014-05-17 00:01:07 +0000569 public static Intent onBuildStartFragmentIntent(Context context, String fragmentName,
Alexandra Gherghina62464b82014-08-11 12:40:13 +0100570 Bundle args, String titleResPackageName, int titleResId, CharSequence title,
Fan Zhangc6ca3142017-02-14 15:02:35 -0800571 boolean isShortcut, int sourceMetricsCategory) {
Fabrice Di Meglio769630c2014-04-24 14:48:48 -0700572 Intent intent = new Intent(Intent.ACTION_MAIN);
573 intent.setClass(context, SubSettings.class);
Fabrice Di Meglio93b77b72014-05-17 00:01:07 +0000574 intent.putExtra(SettingsActivity.EXTRA_SHOW_FRAGMENT, fragmentName);
Fabrice Di Meglio769630c2014-04-24 14:48:48 -0700575 intent.putExtra(SettingsActivity.EXTRA_SHOW_FRAGMENT_ARGUMENTS, args);
Alexandra Gherghina62464b82014-08-11 12:40:13 +0100576 intent.putExtra(SettingsActivity.EXTRA_SHOW_FRAGMENT_TITLE_RES_PACKAGE_NAME,
577 titleResPackageName);
Fabrice Di Meglioa9e77992014-06-09 12:52:24 -0700578 intent.putExtra(SettingsActivity.EXTRA_SHOW_FRAGMENT_TITLE_RESID, titleResId);
Fabrice Di Meglio769630c2014-04-24 14:48:48 -0700579 intent.putExtra(SettingsActivity.EXTRA_SHOW_FRAGMENT_TITLE, title);
Fabrice Di Meglio0d643fd2014-06-16 20:11:27 -0700580 intent.putExtra(SettingsActivity.EXTRA_SHOW_FRAGMENT_AS_SHORTCUT, isShortcut);
Leif Hendrik Wilden28dee1f2018-01-11 10:15:36 -0800581 intent.putExtra(VisibilityLoggerMixin.EXTRA_SOURCE_METRICS_CATEGORY, sourceMetricsCategory);
Fabrice Di Meglio769630c2014-04-24 14:48:48 -0700582 return intent;
583 }
Alexandra Gherghina3939cd72014-06-04 10:02:55 +0100584
585 /**
Esteban Talavera9b86e9c2017-05-30 16:48:08 +0100586 * Returns the managed profile of the current user or {@code null} if none is found or a profile
587 * exists but it is disabled.
Alexandra Gherghina3939cd72014-06-04 10:02:55 +0100588 */
589 public static UserHandle getManagedProfile(UserManager userManager) {
590 List<UserHandle> userProfiles = userManager.getUserProfiles();
591 final int count = userProfiles.size();
592 for (int i = 0; i < count; i++) {
593 final UserHandle profile = userProfiles.get(i);
594 if (profile.getIdentifier() == userManager.getUserHandle()) {
595 continue;
596 }
597 final UserInfo userInfo = userManager.getUserInfo(profile.getIdentifier());
598 if (userInfo.isManagedProfile()) {
599 return profile;
600 }
601 }
602 return null;
603 }
604
605 /**
Esteban Talavera9b86e9c2017-05-30 16:48:08 +0100606 * Returns the managed profile of the current user or {@code null} if none is found. Unlike
607 * {@link #getManagedProfile} this method returns enabled and disabled managed profiles.
608 */
609 public static UserHandle getManagedProfileWithDisabled(UserManager userManager) {
610 // TODO: Call getManagedProfileId from here once Robolectric supports
611 // API level 24 and UserManager.getProfileIdsWithDisabled can be Mocked (to avoid having
612 // yet another implementation that loops over user profiles in this method). In the meantime
613 // we need to use UserManager.getProfiles that is available on API 23 (the one currently
614 // used for Settings Robolectric tests).
615 final int myUserId = UserHandle.myUserId();
616 List<UserInfo> profiles = userManager.getProfiles(myUserId);
617 final int count = profiles.size();
618 for (int i = 0; i < count; i++) {
619 final UserInfo profile = profiles.get(i);
620 if (profile.isManagedProfile()
621 && profile.getUserHandle().getIdentifier() != myUserId) {
622 return profile.getUserHandle();
623 }
624 }
625 return null;
626 }
627
628 /**
Clara Bayarri462cce12016-02-18 12:09:21 +0000629 * Retrieves the id for the given user's managed profile.
630 *
631 * @return the managed profile id or UserHandle.USER_NULL if there is none.
632 */
633 public static int getManagedProfileId(UserManager um, int parentUserId) {
Fyodor Kupolov4a4af5a2016-04-07 16:46:18 -0700634 int[] profileIds = um.getProfileIdsWithDisabled(parentUserId);
635 for (int profileId : profileIds) {
636 if (profileId != parentUserId) {
637 return profileId;
Clara Bayarri462cce12016-02-18 12:09:21 +0000638 }
639 }
640 return UserHandle.USER_NULL;
641 }
642
643 /**
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100644 * Returns the target user for a Settings activity.
Tony Mak8f41b9b2016-11-23 11:36:18 +0000645 * <p>
646 * User would be retrieved in this order:
647 * <ul>
648 * <li> If this activity is launched from other user, return that user id.
649 * <li> If this is launched from the Settings app in same user, return the user contained as an
650 * extra in the arguments or intent extras.
651 * <li> Otherwise, return UserHandle.myUserId().
652 * </ul>
653 * <p>
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100654 * Note: This is secure in the sense that it only returns a target user different to the current
655 * one if the app launching this activity is the Settings app itself, running in the same user
656 * 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 +0100657 */
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100658 public static UserHandle getSecureTargetUser(IBinder activityToken,
Tony Mak8f41b9b2016-11-23 11:36:18 +0000659 UserManager um, @Nullable Bundle arguments, @Nullable Bundle intentExtras) {
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100660 UserHandle currentUser = new UserHandle(UserHandle.myUserId());
Sudheer Shankaacb1a612016-11-10 15:30:14 -0800661 IActivityManager am = ActivityManager.getService();
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100662 try {
663 String launchedFromPackage = am.getLaunchedFromPackage(activityToken);
664 boolean launchedFromSettingsApp = SETTINGS_PACKAGE_NAME.equals(launchedFromPackage);
665
666 UserHandle launchedFromUser = new UserHandle(UserHandle.getUserId(
667 am.getLaunchedFromUid(activityToken)));
668 if (launchedFromUser != null && !launchedFromUser.equals(currentUser)) {
669 // Check it's secure
670 if (isProfileOf(um, launchedFromUser)) {
671 return launchedFromUser;
672 }
673 }
Tony Mak8f41b9b2016-11-23 11:36:18 +0000674 UserHandle extrasUser = getUserHandleFromBundle(intentExtras);
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100675 if (extrasUser != null && !extrasUser.equals(currentUser)) {
676 // Check it's secure
677 if (launchedFromSettingsApp && isProfileOf(um, extrasUser)) {
678 return extrasUser;
679 }
680 }
Tony Mak8f41b9b2016-11-23 11:36:18 +0000681 UserHandle argumentsUser = getUserHandleFromBundle(arguments);
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100682 if (argumentsUser != null && !argumentsUser.equals(currentUser)) {
683 // Check it's secure
684 if (launchedFromSettingsApp && isProfileOf(um, argumentsUser)) {
685 return argumentsUser;
686 }
687 }
688 } catch (RemoteException e) {
689 // Should not happen
690 Log.v(TAG, "Could not talk to activity manager.", e);
691 }
692 return currentUser;
Tony Mak8f41b9b2016-11-23 11:36:18 +0000693 }
694
695 /**
696 * Lookup both {@link Intent#EXTRA_USER} and {@link Intent#EXTRA_USER_ID} in the bundle
697 * and return the {@link UserHandle} object. Return {@code null} if nothing is found.
698 */
699 private static @Nullable UserHandle getUserHandleFromBundle(Bundle bundle) {
700 if (bundle == null) {
701 return null;
702 }
703 final UserHandle user = bundle.getParcelable(EXTRA_USER);
704 if (user != null) {
705 return user;
706 }
707 final int userId = bundle.getInt(EXTRA_USER_ID, -1);
708 if (userId != -1) {
709 return UserHandle.of(userId);
710 }
711 return null;
712 }
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100713
714 /**
715 * Returns the target user for a Settings activity.
716 *
717 * The target user can be either the current user, the user that launched this activity or
718 * the user contained as an extra in the arguments or intent extras.
719 *
720 * You should use {@link #getSecureTargetUser(IBinder, UserManager, Bundle, Bundle)} if
721 * possible.
722 *
723 * @see #getInsecureTargetUser(IBinder, Bundle, Bundle)
724 */
725 public static UserHandle getInsecureTargetUser(IBinder activityToken, @Nullable Bundle arguments,
726 @Nullable Bundle intentExtras) {
727 UserHandle currentUser = new UserHandle(UserHandle.myUserId());
Sudheer Shankaacb1a612016-11-10 15:30:14 -0800728 IActivityManager am = ActivityManager.getService();
Alexandra Gherghina1eb3f312014-06-10 14:01:10 +0100729 try {
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100730 UserHandle launchedFromUser = new UserHandle(UserHandle.getUserId(
731 am.getLaunchedFromUid(activityToken)));
732 if (launchedFromUser != null && !launchedFromUser.equals(currentUser)) {
733 return launchedFromUser;
734 }
735 UserHandle extrasUser = intentExtras != null
736 ? (UserHandle) intentExtras.getParcelable(EXTRA_USER) : null;
737 if (extrasUser != null && !extrasUser.equals(currentUser)) {
738 return extrasUser;
739 }
740 UserHandle argumentsUser = arguments != null
741 ? (UserHandle) arguments.getParcelable(EXTRA_USER) : null;
742 if (argumentsUser != null && !argumentsUser.equals(currentUser)) {
743 return argumentsUser;
Alexandra Gherghina1eb3f312014-06-10 14:01:10 +0100744 }
745 } catch (RemoteException e) {
746 // Should not happen
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100747 Log.v(TAG, "Could not talk to activity manager.", e);
748 return null;
Alexandra Gherghina1eb3f312014-06-10 14:01:10 +0100749 }
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100750 return currentUser;
751 }
Alexandra Gherghina1eb3f312014-06-10 14:01:10 +0100752
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100753 /**
754 * Returns true if the user provided is in the same profiles group as the current user.
755 */
756 private static boolean isProfileOf(UserManager um, UserHandle otherUser) {
757 if (um == null || otherUser == null) return false;
758 return (UserHandle.myUserId() == otherUser.getIdentifier())
759 || um.getUserProfiles().contains(otherUser);
Alexandra Gherghina1eb3f312014-06-10 14:01:10 +0100760 }
Amith Yamasani51c6dac2014-07-02 00:06:37 +0530761
Alexandra Gherghina95b86a52014-07-24 19:13:25 +0100762 /**
Fabrice Di Meglio22a2a492014-08-08 12:27:57 -0700763 * Return whether or not the user should have a SIM Cards option in Settings.
764 * TODO: Change back to returning true if count is greater than one after testing.
765 * TODO: See bug 16533525.
766 */
767 public static boolean showSimCardTile(Context context) {
768 final TelephonyManager tm =
769 (TelephonyManager) context.getSystemService(Context.TELEPHONY_SERVICE);
770
PauloftheWestdbd03822014-12-04 11:56:35 -0800771 return tm.getSimCount() > 1;
Fabrice Di Meglio22a2a492014-08-08 12:27:57 -0700772 }
Dan Sandlerb58b5122014-09-02 18:31:49 +0200773
774 /**
Elliott Hughes7253df32014-09-02 17:10:14 -0700775 * Returns elapsed time for the given millis, in the following format:
776 * 2d 5h 40m 29s
777 * @param context the application context
778 * @param millis the elapsed time in milli seconds
779 * @param withSeconds include seconds?
780 * @return the formatted elapsed time
781 */
jackqdyuleif4c1cef2017-03-31 12:57:10 -0700782 public static CharSequence formatElapsedTime(Context context, double millis,
783 boolean withSeconds) {
784 SpannableStringBuilder sb = new SpannableStringBuilder();
Elliott Hughes7253df32014-09-02 17:10:14 -0700785 int seconds = (int) Math.floor(millis / 1000);
786 if (!withSeconds) {
787 // Round up.
788 seconds += 30;
789 }
790
791 int days = 0, hours = 0, minutes = 0;
792 if (seconds >= SECONDS_PER_DAY) {
793 days = seconds / SECONDS_PER_DAY;
794 seconds -= days * SECONDS_PER_DAY;
795 }
796 if (seconds >= SECONDS_PER_HOUR) {
797 hours = seconds / SECONDS_PER_HOUR;
798 seconds -= hours * SECONDS_PER_HOUR;
799 }
800 if (seconds >= SECONDS_PER_MINUTE) {
801 minutes = seconds / SECONDS_PER_MINUTE;
802 seconds -= minutes * SECONDS_PER_MINUTE;
803 }
jackqdyuleif4c1cef2017-03-31 12:57:10 -0700804
Roozbeh Pournader15872242017-06-20 16:46:49 -0700805 final ArrayList<Measure> measureList = new ArrayList(4);
806 if (days > 0) {
807 measureList.add(new Measure(days, MeasureUnit.DAY));
808 }
809 if (hours > 0) {
810 measureList.add(new Measure(hours, MeasureUnit.HOUR));
811 }
812 if (minutes > 0) {
813 measureList.add(new Measure(minutes, MeasureUnit.MINUTE));
814 }
815 if (withSeconds && seconds > 0) {
816 measureList.add(new Measure(seconds, MeasureUnit.SECOND));
817 }
818 if (measureList.size() == 0) {
819 // Everything addable was zero, so nothing was added. We add a zero.
820 measureList.add(new Measure(0, withSeconds ? MeasureUnit.SECOND : MeasureUnit.MINUTE));
821 }
822 final Measure[] measureArray = measureList.toArray(new Measure[measureList.size()]);
823
824 final Locale locale = context.getResources().getConfiguration().locale;
825 final MeasureFormat measureFormat = MeasureFormat.getInstance(
826 locale, MeasureFormat.FormatWidth.NARROW);
827 sb.append(measureFormat.formatMeasures(measureArray));
828
829 if (measureArray.length == 1 && MeasureUnit.MINUTE.equals(measureArray[0].getUnit())) {
830 // Add ttsSpan if it only have minute value, because it will be read as "meters"
831 final TtsSpan ttsSpan = new TtsSpan.MeasureBuilder().setNumber(minutes)
832 .setUnit("minute").build();
833 sb.setSpan(ttsSpan, 0, sb.length(), Spanned.SPAN_EXCLUSIVE_EXCLUSIVE);
Elliott Hughes7253df32014-09-02 17:10:14 -0700834 }
jackqdyuleif4c1cef2017-03-31 12:57:10 -0700835
836 return sb;
Elliott Hughes7253df32014-09-02 17:10:14 -0700837 }
PauloftheWest0a0daca2014-11-06 15:02:58 -0800838
839 /**
Roozbeh Pournader4de9df22017-08-26 14:05:15 -0700840 * Returns relative time for the given millis in the past, in a short format such as "2 days
841 * ago", "5 hr. ago", "40 min. ago", or "29 sec. ago".
842 *
843 * <p>The unit is chosen to have good information value while only using one unit. So 27 hours
844 * and 50 minutes would be formatted as "28 hr. ago", while 50 hours would be formatted as
845 * "2 days ago".
846 *
847 * @param context the application context
848 * @param millis the elapsed time in milli seconds
849 * @param withSeconds include seconds?
850 * @return the formatted elapsed time
851 */
852 public static CharSequence formatRelativeTime(Context context, double millis,
853 boolean withSeconds) {
854 final int seconds = (int) Math.floor(millis / 1000);
855 final RelativeUnit unit;
856 final int value;
857 if (withSeconds && seconds < 2 * SECONDS_PER_MINUTE) {
858 unit = RelativeUnit.SECONDS;
859 value = seconds;
860 } else if (seconds < 2 * SECONDS_PER_HOUR) {
861 unit = RelativeUnit.MINUTES;
862 value = (seconds + SECONDS_PER_MINUTE / 2) / SECONDS_PER_MINUTE;
863 } else if (seconds < 2 * SECONDS_PER_DAY) {
864 unit = RelativeUnit.HOURS;
865 value = (seconds + SECONDS_PER_HOUR / 2) / SECONDS_PER_HOUR;
866 } else {
867 unit = RelativeUnit.DAYS;
868 value = (seconds + SECONDS_PER_DAY / 2) / SECONDS_PER_DAY;
869 }
870
871 final Locale locale = context.getResources().getConfiguration().locale;
872 final RelativeDateTimeFormatter formatter = RelativeDateTimeFormatter.getInstance(
873 ULocale.forLocale(locale),
874 null /* default NumberFormat */,
875 RelativeDateTimeFormatter.Style.SHORT,
876 android.icu.text.DisplayContext.CAPITALIZATION_FOR_MIDDLE_OF_SENTENCE);
877
878 return formatter.format(value, RelativeDateTimeFormatter.Direction.LAST, unit);
879 }
880
881 /**
Amith Yamasani45f86232014-11-19 17:12:46 -0800882 * Queries for the UserInfo of a user. Returns null if the user doesn't exist (was removed).
883 * @param userManager Instance of UserManager
884 * @param checkUser The user to check the existence of.
885 * @return UserInfo of the user or null for non-existent user.
886 */
887 public static UserInfo getExistingUser(UserManager userManager, UserHandle checkUser) {
888 final List<UserInfo> users = userManager.getUsers(true /* excludeDying */);
889 final int checkUserId = checkUser.getIdentifier();
890 for (UserInfo user : users) {
891 if (user.id == checkUserId) {
892 return user;
893 }
894 }
895 return null;
896 }
897
Zoltan Szatmary-Ban3af2e4c2014-12-19 17:17:23 +0000898 public static View inflateCategoryHeader(LayoutInflater inflater, ViewGroup parent) {
899 final TypedArray a = inflater.getContext().obtainStyledAttributes(null,
900 com.android.internal.R.styleable.Preference,
901 com.android.internal.R.attr.preferenceCategoryStyle, 0);
902 final int resId = a.getResourceId(com.android.internal.R.styleable.Preference_layout,
903 0);
904 a.recycle();
905 return inflater.inflate(resId, parent, false);
906 }
907
Fabrice Di Megliodff3faa2015-02-27 11:14:11 -0800908 /**
909 * Return if we are running low on storage space or not.
910 *
911 * @param context The context
912 * @return true if we are running low on storage space
913 */
914 public static boolean isLowStorage(Context context) {
915 final StorageManager sm = StorageManager.from(context);
916 return (sm.getStorageBytesUntilLow(context.getFilesDir()) < 0);
917 }
918
Fabrice Di Meglio8b2ea392015-01-23 19:03:22 -0800919
Fabrice Di Meglio8b2ea392015-01-23 19:03:22 -0800920 public static boolean hasPreferredActivities(PackageManager pm, String packageName) {
921 // Get list of preferred activities
922 List<ComponentName> prefActList = new ArrayList<>();
923 // Intent list cannot be null. so pass empty list
924 List<IntentFilter> intentList = new ArrayList<>();
925 pm.getPreferredActivities(intentList, prefActList, packageName);
926 Log.d(TAG, "Have " + prefActList.size() + " number of activities in preferred list");
927 return prefActList.size() > 0;
928 }
929
Christopher Tatea08a2252015-07-01 16:52:43 -0700930 public static ArraySet<String> getHandledDomains(PackageManager pm, String packageName) {
931 List<IntentFilterVerificationInfo> iviList = pm.getIntentFilterVerifications(packageName);
932 List<IntentFilter> filters = pm.getAllIntentFilters(packageName);
933
934 ArraySet<String> result = new ArraySet<>();
Fan Zhang4e540db2017-11-08 13:06:38 -0800935 if (iviList != null && iviList.size() > 0) {
Christopher Tatea08a2252015-07-01 16:52:43 -0700936 for (IntentFilterVerificationInfo ivi : iviList) {
937 for (String host : ivi.getDomains()) {
938 result.add(host);
939 }
940 }
941 }
942 if (filters != null && filters.size() > 0) {
943 for (IntentFilter filter : filters) {
Christopher Tateddaa1422015-07-16 16:00:49 -0700944 if (filter.hasCategory(Intent.CATEGORY_BROWSABLE)
945 && (filter.hasDataScheme(IntentFilter.SCHEME_HTTP) ||
946 filter.hasDataScheme(IntentFilter.SCHEME_HTTPS))) {
Christopher Tatea08a2252015-07-01 16:52:43 -0700947 result.addAll(filter.getHostsList());
948 }
949 }
950 }
951 return result;
952 }
953
Sudheer Shankabc956302015-04-09 12:19:53 +0100954 /**
955 * Returns the application info of the currently installed MDM package.
956 */
957 public static ApplicationInfo getAdminApplicationInfo(Context context, int profileId) {
958 DevicePolicyManager dpm =
959 (DevicePolicyManager) context.getSystemService(Context.DEVICE_POLICY_SERVICE);
960 ComponentName mdmPackage = dpm.getProfileOwnerAsUser(profileId);
961 if (mdmPackage == null) {
962 return null;
963 }
964 String mdmPackageName = mdmPackage.getPackageName();
965 try {
966 IPackageManager ipm = AppGlobals.getPackageManager();
967 ApplicationInfo mdmApplicationInfo =
968 ipm.getApplicationInfo(mdmPackageName, 0, profileId);
969 return mdmApplicationInfo;
970 } catch (RemoteException e) {
971 Log.e(TAG, "Error while retrieving application info for package " + mdmPackageName
972 + ", userId " + profileId, e);
973 return null;
974 }
975 }
Jason Monkb45e27b2015-05-20 13:35:43 -0400976
977 public static boolean isBandwidthControlEnabled() {
978 final INetworkManagementService netManager = INetworkManagementService.Stub
979 .asInterface(ServiceManager.getService(Context.NETWORKMANAGEMENT_SERVICE));
980 try {
981 return netManager.isBandwidthControlEnabled();
982 } catch (RemoteException e) {
983 return false;
984 }
985 }
Julia Reynoldsce25af42015-07-08 16:56:31 -0400986
987 /**
988 * Returns an accessible SpannableString.
989 * @param displayText the text to display
990 * @param accessibileText the text text-to-speech engines should read
991 */
992 public static SpannableString createAccessibleSequence(CharSequence displayText,
993 String accessibileText) {
994 SpannableString str = new SpannableString(displayText);
995 str.setSpan(new TtsSpan.TextBuilder(accessibileText).build(), 0,
996 displayText.length(),
997 Spannable.SPAN_INCLUSIVE_INCLUSIVE);
998 return str;
999 }
Andres Morales7bdffd82015-08-04 16:55:00 -07001000
Clara Bayarrife432e82015-10-12 12:07:02 +01001001 /**
Jeff Sharkey219ec912017-12-19 14:57:39 -07001002 * Returns the user id present in the bundle with
1003 * {@link Intent#EXTRA_USER_ID} if it belongs to the current user.
Clara Bayarrife432e82015-10-12 12:07:02 +01001004 *
Jeff Sharkey219ec912017-12-19 14:57:39 -07001005 * @throws SecurityException if the given userId does not belong to the
1006 * current user group.
Clara Bayarrife432e82015-10-12 12:07:02 +01001007 */
Benjamin Franz194300d2016-01-13 12:16:25 +00001008 public static int getUserIdFromBundle(Context context, Bundle bundle) {
Jeff Sharkey219ec912017-12-19 14:57:39 -07001009 return getUserIdFromBundle(context, bundle, false);
1010 }
1011
1012 /**
1013 * Returns the user id present in the bundle with
1014 * {@link Intent#EXTRA_USER_ID} if it belongs to the current user.
1015 *
1016 * @param isInternal indicating if the caller is "internal" to the system,
1017 * meaning we're willing to trust extras like
1018 * {@link ChooseLockSettingsHelper#EXTRA_ALLOW_ANY_USER}.
1019 * @throws SecurityException if the given userId does not belong to the
1020 * current user group.
1021 */
1022 public static int getUserIdFromBundle(Context context, Bundle bundle, boolean isInternal) {
Clara Bayarrife432e82015-10-12 12:07:02 +01001023 if (bundle == null) {
Benjamin Franz194300d2016-01-13 12:16:25 +00001024 return getCredentialOwnerUserId(context);
Clara Bayarrife432e82015-10-12 12:07:02 +01001025 }
Jeff Sharkey219ec912017-12-19 14:57:39 -07001026 final boolean allowAnyUser = isInternal
1027 && bundle.getBoolean(ChooseLockSettingsHelper.EXTRA_ALLOW_ANY_USER, false);
Clara Bayarri6934a042015-10-14 11:07:35 +01001028 int userId = bundle.getInt(Intent.EXTRA_USER_ID, UserHandle.myUserId());
Adrian Roos5a9a3cd2017-03-30 18:02:25 -07001029 if (userId == LockPatternUtils.USER_FRP) {
Jeff Sharkey219ec912017-12-19 14:57:39 -07001030 return allowAnyUser ? userId : enforceSystemUser(context, userId);
Adrian Roos5a9a3cd2017-03-30 18:02:25 -07001031 } else {
Jeff Sharkey219ec912017-12-19 14:57:39 -07001032 return allowAnyUser ? userId : enforceSameOwner(context, userId);
Adrian Roos5a9a3cd2017-03-30 18:02:25 -07001033 }
1034 }
1035
1036 /**
1037 * Returns the given user id if the current user is the system user.
1038 *
1039 * @throws SecurityException if the current user is not the system user.
1040 */
1041 public static int enforceSystemUser(Context context, int userId) {
1042 if (UserHandle.myUserId() == UserHandle.USER_SYSTEM) {
1043 return userId;
1044 }
1045 throw new SecurityException("Given user id " + userId + " must only be used from "
1046 + "USER_SYSTEM, but current user is " + UserHandle.myUserId());
Clara Bayarrife432e82015-10-12 12:07:02 +01001047 }
1048
1049 /**
1050 * Returns the given user id if it belongs to the current user.
1051 *
1052 * @throws SecurityException if the given userId does not belong to the current user group.
1053 */
Benjamin Franz194300d2016-01-13 12:16:25 +00001054 public static int enforceSameOwner(Context context, int userId) {
Ricky Wai72500162016-06-07 16:54:25 +01001055 final UserManager um = getUserManager(context);
1056 final int[] profileIds = um.getProfileIdsWithDisabled(UserHandle.myUserId());
1057 if (ArrayUtils.contains(profileIds, userId)) {
1058 return userId;
Clara Bayarrife432e82015-10-12 12:07:02 +01001059 }
Ricky Wai72500162016-06-07 16:54:25 +01001060 throw new SecurityException("Given user id " + userId + " does not belong to user "
1061 + UserHandle.myUserId());
Clara Bayarrife432e82015-10-12 12:07:02 +01001062 }
1063
Benjamin Franz194300d2016-01-13 12:16:25 +00001064 /**
1065 * Returns the effective credential owner of the calling user.
1066 */
1067 public static int getCredentialOwnerUserId(Context context) {
1068 return getCredentialOwnerUserId(context, UserHandle.myUserId());
1069 }
1070
1071 /**
1072 * Returns the user id of the credential owner of the given user id.
1073 */
1074 public static int getCredentialOwnerUserId(Context context, int userId) {
1075 UserManager um = getUserManager(context);
1076 return um.getCredentialOwnerProfile(userId);
Andres Morales7bdffd82015-08-04 16:55:00 -07001077 }
Jason Monkdb4ed192015-12-11 16:48:31 -05001078
1079 public static int resolveResource(Context context, int attr) {
1080 TypedValue value = new TypedValue();
1081 context.getTheme().resolveAttribute(attr, value, true);
1082 return value.resourceId;
1083 }
Jason Monkb37e2882016-01-11 14:27:20 -05001084
1085 private static final StringBuilder sBuilder = new StringBuilder(50);
1086 private static final java.util.Formatter sFormatter = new java.util.Formatter(
1087 sBuilder, Locale.getDefault());
1088
1089 public static String formatDateRange(Context context, long start, long end) {
1090 final int flags = FORMAT_SHOW_DATE | FORMAT_ABBREV_MONTH;
1091
1092 synchronized (sBuilder) {
1093 sBuilder.setLength(0);
1094 return DateUtils.formatDateRange(context, sFormatter, start, end, flags, null)
1095 .toString();
1096 }
1097 }
Jason Monk91e2f892016-02-23 15:31:09 -05001098
1099 public static List<String> getNonIndexable(int xml, Context context) {
Jason Monkbe941212016-05-27 12:58:53 -04001100 if (Looper.myLooper() == null) {
1101 // Hack to make sure Preferences can initialize. Prefs expect a looper, but
1102 // don't actually use it for the basic stuff here.
1103 Looper.prepare();
1104 }
Jason Monk9ee80cd2016-03-03 11:21:42 -05001105 final List<String> ret = new ArrayList<>();
Jason Monkbe941212016-05-27 12:58:53 -04001106 PreferenceManager manager = new PreferenceManager(context);
1107 PreferenceScreen screen = manager.inflateFromResource(context, xml, null);
1108 checkPrefs(screen, ret);
Jason Monk91e2f892016-02-23 15:31:09 -05001109
1110 return ret;
1111 }
1112
1113 private static void checkPrefs(PreferenceGroup group, List<String> ret) {
1114 if (group == null) return;
1115 for (int i = 0; i < group.getPreferenceCount(); i++) {
1116 Preference pref = group.getPreference(i);
1117 if (pref instanceof SelfAvailablePreference
1118 && !((SelfAvailablePreference) pref).isAvailable(group.getContext())) {
1119 ret.add(pref.getKey());
1120 if (pref instanceof PreferenceGroup) {
1121 addAll((PreferenceGroup) pref, ret);
1122 }
1123 } else if (pref instanceof PreferenceGroup) {
1124 checkPrefs((PreferenceGroup) pref, ret);
1125 }
1126 }
1127 }
1128
1129 private static void addAll(PreferenceGroup group, List<String> ret) {
1130 if (group == null) return;
1131 for (int i = 0; i < group.getPreferenceCount(); i++) {
1132 Preference pref = group.getPreference(i);
1133 ret.add(pref.getKey());
1134 if (pref instanceof PreferenceGroup) {
1135 addAll((PreferenceGroup) pref, ret);
1136 }
1137 }
1138 }
Udam Saini679f7ad2016-03-25 10:47:00 -07001139
1140 public static boolean isDeviceProvisioned(Context context) {
1141 return Settings.Global.getInt(context.getContentResolver(),
1142 Settings.Global.DEVICE_PROVISIONED, 0) != 0;
1143 }
Ricky Wai616342b2016-04-13 10:40:22 +01001144
Bernard Chau88d523b2016-04-14 15:08:28 +01001145 public static boolean startQuietModeDialogIfNecessary(Context context, UserManager um,
Ricky Wai616342b2016-04-13 10:40:22 +01001146 int userId) {
1147 if (um.isQuietModeEnabled(UserHandle.of(userId))) {
1148 final Intent intent = UnlaunchableAppActivity.createInQuietModeDialogIntent(userId);
1149 context.startActivity(intent);
1150 return true;
1151 }
1152 return false;
1153 }
Sudheer Shankac3eb16e2016-04-21 12:51:43 -07001154
Rubin Xu3231afe2016-08-24 10:15:07 +01001155 public static boolean unlockWorkProfileIfNecessary(Context context, int userId) {
1156 try {
Sudheer Shankaacb1a612016-11-10 15:30:14 -08001157 if (!ActivityManager.getService().isUserRunning(userId,
Rubin Xu3231afe2016-08-24 10:15:07 +01001158 ActivityManager.FLAG_AND_LOCKED)) {
1159 return false;
1160 }
1161 } catch (RemoteException e) {
1162 return false;
1163 }
1164 if (!(new LockPatternUtils(context)).isSecure(userId)) {
1165 return false;
1166 }
Robin Leecccf3242017-02-10 15:32:49 +00001167 return confirmWorkProfileCredentials(context, userId);
1168 }
1169
1170 public static boolean confirmWorkProfileCredentialsIfNecessary(Context context, int userId) {
1171 KeyguardManager km = (KeyguardManager) context.getSystemService(Context.KEYGUARD_SERVICE);
1172 if (!km.isDeviceLocked(userId)) {
1173 return false;
1174 }
1175 return confirmWorkProfileCredentials(context, userId);
1176 }
1177
1178 private static boolean confirmWorkProfileCredentials(Context context, int userId) {
Rubin Xu3231afe2016-08-24 10:15:07 +01001179 final KeyguardManager km = (KeyguardManager) context.getSystemService(
1180 Context.KEYGUARD_SERVICE);
1181 final Intent unlockIntent = km.createConfirmDeviceCredentialIntent(null, null, userId);
1182 if (unlockIntent != null) {
1183 context.startActivity(unlockIntent);
1184 return true;
1185 } else {
1186 return false;
1187 }
Rubin Xu3231afe2016-08-24 10:15:07 +01001188 }
1189
Sudheer Shankac3eb16e2016-04-21 12:51:43 -07001190 public static CharSequence getApplicationLabel(Context context, String packageName) {
1191 try {
1192 final ApplicationInfo appInfo = context.getPackageManager().getApplicationInfo(
1193 packageName,
1194 PackageManager.MATCH_DISABLED_COMPONENTS
Amith Yamasani21556cd2016-11-01 15:49:21 -07001195 | PackageManager.MATCH_ANY_USER);
Sudheer Shankac3eb16e2016-04-21 12:51:43 -07001196 return appInfo.loadLabel(context.getPackageManager());
1197 } catch (PackageManager.NameNotFoundException e) {
1198 Log.w(TAG, "Unable to find info for package: " + packageName);
1199 }
1200 return null;
1201 }
Jason Monk75199542016-05-06 15:09:32 -04001202
Jeff Sharkey4a8136b2016-07-27 12:53:34 -06001203 public static boolean isPackageDirectBootAware(Context context, String packageName) {
1204 try {
1205 final ApplicationInfo ai = context.getPackageManager().getApplicationInfo(
1206 packageName, 0);
1207 return ai.isDirectBootAware() || ai.isPartiallyDirectBootAware();
1208 } catch (NameNotFoundException ignored) {
1209 }
1210 return false;
1211 }
Andre Lago3e398c82016-07-25 14:12:28 +01001212
1213 /**
1214 * Returns a context created from the given context for the given user, or null if it fails
1215 */
1216 public static Context createPackageContextAsUser(Context context, int userId) {
1217 try {
1218 return context.createPackageContextAsUser(
1219 context.getPackageName(), 0 /* flags */, UserHandle.of(userId));
1220 } catch (PackageManager.NameNotFoundException e) {
1221 Log.e(TAG, "Failed to create user context", e);
1222 }
1223 return null;
1224 }
Jeff Sharkeyab508072016-10-11 14:25:22 -06001225
1226 public static FingerprintManager getFingerprintManagerOrNull(Context context) {
1227 if (context.getPackageManager().hasSystemFeature(PackageManager.FEATURE_FINGERPRINT)) {
Fan Zhangcf97f0b2018-01-05 11:18:44 -08001228 return (FingerprintManager) context.getSystemService(Context.FINGERPRINT_SERVICE);
Jeff Sharkeyab508072016-10-11 14:25:22 -06001229 } else {
1230 return null;
1231 }
1232 }
Daniel Nishi31027da2017-01-19 14:03:57 -08001233
Doris Lingdee1a222017-08-31 16:17:30 -07001234 public static FingerprintManagerWrapper getFingerprintManagerWrapperOrNull(Context context) {
Maurice Lame1976ac2017-05-08 21:43:02 -07001235 FingerprintManager fingerprintManager = getFingerprintManagerOrNull(context);
1236 if (fingerprintManager != null) {
1237 return new FingerprintManagerWrapper(fingerprintManager);
1238 } else {
1239 return null;
1240 }
1241 }
1242
Kevin Chyn82792cc2017-07-20 00:15:44 -07001243 public static boolean hasFingerprintHardware(Context context) {
1244 FingerprintManager fingerprintManager = getFingerprintManagerOrNull(context);
1245 return fingerprintManager != null && fingerprintManager.isHardwareDetected();
1246 }
1247
Daniel Nishi31027da2017-01-19 14:03:57 -08001248 /**
1249 * Launches an intent which may optionally have a user id defined.
1250 * @param fragment Fragment to use to launch the activity.
1251 * @param intent Intent to launch.
1252 */
1253 public static void launchIntent(Fragment fragment, Intent intent) {
1254 try {
1255 final int userId = intent.getIntExtra(Intent.EXTRA_USER_ID, -1);
1256
1257 if (userId == -1) {
1258 fragment.startActivity(intent);
1259 } else {
1260 fragment.getActivity().startActivityAsUser(intent, new UserHandle(userId));
1261 }
1262 } catch (ActivityNotFoundException e) {
1263 Log.w(TAG, "No activity found for " + intent);
1264 }
1265 }
1266
Christine Franksc6890ab2017-06-23 14:28:21 -07001267 public static boolean isDemoUser(Context context) {
1268 return UserManager.isDeviceInDemoMode(context) && getUserManager(context).isDemoUser();
1269 }
1270
Justin Klaassen30257272017-08-08 21:58:05 -07001271 public static ComponentName getDeviceOwnerComponent(Context context) {
1272 final DevicePolicyManager dpm = (DevicePolicyManager) context.getSystemService(
1273 Context.DEVICE_POLICY_SERVICE);
1274 return dpm.getDeviceOwnerComponentOnAnyUser();
Christine Franks14782222017-01-23 16:44:02 -08001275 }
Daniel Nishidfed8a22017-01-19 16:32:41 -08001276
1277 /**
1278 * Returns if a given user is a profile of another user.
Christine Franksa0dd9872017-07-11 17:32:57 -07001279 * @param user The user whose profiles wibe checked.
Daniel Nishidfed8a22017-01-19 16:32:41 -08001280 * @param profile The (potential) profile.
1281 * @return if the profile is actually a profile
1282 */
1283 public static boolean isProfileOf(UserInfo user, UserInfo profile) {
1284 return user.id == profile.id ||
1285 (user.profileGroupId != UserInfo.NO_PROFILE_GROUP_ID
1286 && user.profileGroupId == profile.profileGroupId);
1287 }
Daniel Nishi9f60f422017-02-15 15:25:48 -08001288
1289 /**
1290 * Tries to initalize a volume with the given bundle. If it is a valid, private, and readable
1291 * {@link VolumeInfo}, it is returned. If it is not valid, null is returned.
1292 */
1293 @Nullable
1294 public static VolumeInfo maybeInitializeVolume(StorageManager sm, Bundle bundle) {
1295 final String volumeId = bundle.getString(VolumeInfo.EXTRA_VOLUME_ID,
1296 VolumeInfo.ID_PRIVATE_INTERNAL);
1297 VolumeInfo volume = sm.findVolumeById(volumeId);
1298 return isVolumeValid(volume) ? volume : null;
1299 }
1300
jackqdyuleiddba9662017-03-08 19:35:02 -08001301 /**
jackqdyulei00015fb2017-08-22 11:25:30 -07001302 * Return {@code true} if the supplied package is device owner or profile owner of at
1303 * least one user.
1304 * @param userManager used to get profile owner app for each user
1305 * @param devicePolicyManager used to check whether it is device owner app
1306 * @param packageName package to check about
1307 */
1308 public static boolean isProfileOrDeviceOwner(UserManager userManager,
1309 DevicePolicyManagerWrapper devicePolicyManager, String packageName) {
1310 List<UserInfo> userInfos = userManager.getUsers();
1311 if (devicePolicyManager.isDeviceOwnerAppOnAnyUser(packageName)) {
1312 return true;
1313 }
1314 for (int i = 0, size = userInfos.size(); i < size; i++) {
1315 ComponentName cn = devicePolicyManager.getProfileOwnerAsUser(userInfos.get(i).id);
1316 if (cn != null && cn.getPackageName().equals(packageName)) {
1317 return true;
1318 }
1319 }
1320 return false;
1321 }
1322
1323 /**
jackqdyuleiddba9662017-03-08 19:35:02 -08001324 * Return the resource id to represent the install status for an app
1325 */
1326 @StringRes
1327 public static int getInstallationStatus(ApplicationInfo info) {
1328 if ((info.flags & ApplicationInfo.FLAG_INSTALLED) == 0) {
1329 return R.string.not_installed;
1330 }
1331 return info.enabled ? R.string.installed : R.string.disabled;
1332 }
1333
Daniel Nishi9f60f422017-02-15 15:25:48 -08001334 private static boolean isVolumeValid(VolumeInfo volume) {
1335 return (volume != null) && (volume.getType() == VolumeInfo.TYPE_PRIVATE)
1336 && volume.isMountedReadable();
1337 }
jackqdyuleif4c1cef2017-03-31 12:57:10 -07001338
PMS2263a05602017-06-14 07:10:15 +00001339 public static void setEditTextCursorPosition(EditText editText) {
1340 editText.setSelection(editText.getText().length());
1341 }
Felipe Lemebd884502017-09-15 18:16:21 -07001342
1343 /**
1344 * Sets the preference icon with a drawable that is scaled down to to avoid crashing Settings if
1345 * it's too big.
1346 */
1347 public static void setSafeIcon(Preference pref, Drawable icon) {
1348 Drawable safeIcon = icon;
1349 if (icon != null) {
1350 safeIcon = getSafeDrawable(icon, 500, 500);
1351 }
1352 pref.setIcon(safeIcon);
1353 }
1354
1355 /**
1356 * Gets a drawable with a limited size to avoid crashing Settings if it's too big.
1357 *
1358 * @param original original drawable, typically an app icon.
1359 * @param maxWidth maximum width, in pixels.
1360 * @param maxHeight maximum height, in pixels.
1361 */
1362 public static Drawable getSafeDrawable(Drawable original, int maxWidth, int maxHeight) {
1363 final int actualWidth = original.getMinimumWidth();
1364 final int actualHeight = original.getMinimumHeight();
1365
1366 if (actualWidth <= maxWidth && actualHeight <= maxHeight) {
1367 return original;
1368 }
1369
1370 float scaleWidth = ((float) maxWidth) / actualWidth;
1371 float scaleHeight = ((float) maxHeight) / actualHeight;
1372 float scale = Math.min(scaleWidth, scaleHeight);
1373 final int width = (int) (actualWidth * scale);
1374 final int height = (int) (actualHeight * scale);
1375
1376 final Bitmap bitmap;
1377 if (original instanceof BitmapDrawable) {
1378 bitmap = Bitmap.createScaledBitmap(((BitmapDrawable) original).getBitmap(), width,
1379 height, false);
1380 } else {
1381 bitmap = Bitmap.createBitmap(width, height, Bitmap.Config.ARGB_8888);
1382 final Canvas canvas = new Canvas(bitmap);
1383 original.setBounds(0, 0, canvas.getWidth(), canvas.getHeight());
1384 original.draw(canvas);
1385 }
1386 return new BitmapDrawable(null, bitmap);
1387 }
jackqdyuleifde637f2018-01-02 14:51:01 -08001388
1389 /**
1390 * Get the {@link Drawable} that represents the app icon
1391 */
1392 public static Drawable getBadgedIcon(IconDrawableFactory iconDrawableFactory,
1393 PackageManager packageManager, String packageName, int userId) {
1394 try {
1395 final ApplicationInfo appInfo = packageManager.getApplicationInfo(packageName,
1396 PackageManager.GET_META_DATA);
1397 return iconDrawableFactory.getBadgedIcon(appInfo, userId);
1398 } catch (PackageManager.NameNotFoundException e) {
1399 return packageManager.getDefaultActivityIcon();
1400 }
1401 }
Jeff Sharkey4a8136b2016-07-27 12:53:34 -06001402}