blob: 6b0a5b8b7655c20bd68dcc465ae7b3a9c304fa95 [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;
Alexandra Gherghina1eb3f312014-06-10 14:01:10 +010097import android.util.Log;
Jason Monkdb4ed192015-12-11 16:48:31 -050098import android.util.TypedValue;
Zoltan Szatmary-Ban3af2e4c2014-12-19 17:17:23 +000099import android.view.LayoutInflater;
Jeff Sharkeyb654cbb2011-08-18 11:59:19 -0700100import android.view.View;
101import android.view.ViewGroup;
PMS2263a05602017-06-14 07:10:15 +0000102import android.widget.EditText;
Jeff Sharkeyb654cbb2011-08-18 11:59:19 -0700103import android.widget.ListView;
104import android.widget.TabWidget;
Fan Zhangcc335d92016-09-29 14:37:14 -0700105
Ricky Wai616342b2016-04-13 10:40:22 +0100106import com.android.internal.app.UnlaunchableAppActivity;
Ricky Wai72500162016-06-07 16:54:25 +0100107import com.android.internal.util.ArrayUtils;
Rubin Xu3231afe2016-08-24 10:15:07 +0100108import com.android.internal.widget.LockPatternUtils;
Jeff Sharkey219ec912017-12-19 14:57:39 -0700109import com.android.settings.password.ChooseLockSettingsHelper;
Doris Lingdee1a222017-08-31 16:17:30 -0700110import com.android.settings.wrapper.DevicePolicyManagerWrapper;
Tony Mantlerd9af0b82017-10-20 15:03:28 -0700111import com.android.settings.wrapper.FingerprintManagerWrapper;
Daisuke Miyakawaa2633d02010-09-15 20:09:12 -0700112
Amith Yamasanic06d4c42011-02-25 14:35:20 -0800113import java.net.InetAddress;
Alexandra Gherghina80e1f1b2014-07-31 14:56:33 +0100114import java.util.ArrayList;
Amith Yamasanic06d4c42011-02-25 14:35:20 -0800115import java.util.Iterator;
Daisuke Miyakawaa2633d02010-09-15 20:09:12 -0700116import java.util.List;
Jean Chalard71ad1f42011-05-12 15:06:16 +0900117import java.util.Locale;
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800118
Jason Monk27985e12016-01-08 14:13:05 -0500119public final class Utils extends com.android.settingslib.Utils {
120
Alexandra Gherghina1eb3f312014-06-10 14:01:10 +0100121 private static final String TAG = "Settings";
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100122
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800123 /**
124 * Set the preference's title to the matching activity's label.
125 */
126 public static final int UPDATE_PREFERENCE_FLAG_SET_TITLE_TO_MATCHING_ACTIVITY = 1;
127
128 /**
Dianne Hackborn68f005f2014-06-18 18:29:12 -0700129 * Color spectrum to use to indicate badness. 0 is completely transparent (no data),
130 * 1 is most bad (red), the last value is least bad (green).
131 */
132 public static final int[] BADNESS_COLORS = new int[] {
133 0x00000000, 0xffc43828, 0xffe54918, 0xfff47b00,
134 0xfffabf2c, 0xff679e37, 0xff0a7f42
135 };
136
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100137 private static final String SETTINGS_PACKAGE_NAME = "com.android.settings";
138
Elliott Hughes7253df32014-09-02 17:10:14 -0700139 private static final int SECONDS_PER_MINUTE = 60;
140 private static final int SECONDS_PER_HOUR = 60 * 60;
141 private static final int SECONDS_PER_DAY = 24 * 60 * 60;
142
Jason Monkbeb171d2015-05-21 15:24:37 -0400143 public static final String OS_PKG = "os";
144
Anders Hammar1b2dd9032010-04-08 10:03:50 +0200145 /**
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800146 * Finds a matching activity for a preference's intent. If a matching
147 * activity is not found, it will remove the preference.
Ying Wanga7188322010-01-04 18:45:10 -0800148 *
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800149 * @param context The context.
150 * @param parentPreferenceGroup The preference group that contains the
151 * preference whose intent is being resolved.
152 * @param preferenceKey The key of the preference whose intent is being
153 * resolved.
154 * @param flags 0 or one or more of
155 * {@link #UPDATE_PREFERENCE_FLAG_SET_TITLE_TO_MATCHING_ACTIVITY}
156 * .
157 * @return Whether an activity was found. If false, the preference was
158 * removed.
159 */
160 public static boolean updatePreferenceToSpecificActivityOrRemove(Context context,
161 PreferenceGroup parentPreferenceGroup, String preferenceKey, int flags) {
Ying Wanga7188322010-01-04 18:45:10 -0800162
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800163 Preference preference = parentPreferenceGroup.findPreference(preferenceKey);
164 if (preference == null) {
165 return false;
166 }
Ying Wanga7188322010-01-04 18:45:10 -0800167
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800168 Intent intent = preference.getIntent();
169 if (intent != null) {
170 // Find the activity that is in the system image
171 PackageManager pm = context.getPackageManager();
172 List<ResolveInfo> list = pm.queryIntentActivities(intent, 0);
173 int listSize = list.size();
174 for (int i = 0; i < listSize; i++) {
175 ResolveInfo resolveInfo = list.get(i);
176 if ((resolveInfo.activityInfo.applicationInfo.flags & ApplicationInfo.FLAG_SYSTEM)
177 != 0) {
Ying Wanga7188322010-01-04 18:45:10 -0800178
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800179 // Replace the intent with this specific activity
180 preference.setIntent(new Intent().setClassName(
181 resolveInfo.activityInfo.packageName,
182 resolveInfo.activityInfo.name));
183
184 if ((flags & UPDATE_PREFERENCE_FLAG_SET_TITLE_TO_MATCHING_ACTIVITY) != 0) {
185 // Set the preference title to the activity's label
186 preference.setTitle(resolveInfo.loadLabel(pm));
187 }
Ying Wanga7188322010-01-04 18:45:10 -0800188
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800189 return true;
190 }
191 }
192 }
193
194 // Did not find a matching activity, so remove the preference
195 parentPreferenceGroup.removePreference(preference);
Ying Wanga7188322010-01-04 18:45:10 -0800196
Shuhrat Dehkanov7dc567a2012-04-23 01:59:56 +0900197 return false;
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800198 }
Ying Wanga7188322010-01-04 18:45:10 -0800199
Anders Hammar1b2dd9032010-04-08 10:03:50 +0200200 /**
Benjamin Franz194300d2016-01-13 12:16:25 +0000201 * Returns the UserManager for a given context
202 *
203 * @throws IllegalStateException if no UserManager could be retrieved.
204 */
205 public static UserManager getUserManager(Context context) {
206 UserManager um = UserManager.get(context);
207 if (um == null) {
208 throw new IllegalStateException("Unable to load UserManager");
209 }
210 return um;
211 }
212
213 /**
Ying Wanga7188322010-01-04 18:45:10 -0800214 * Returns true if Monkey is running.
215 */
216 public static boolean isMonkeyRunning() {
Amith Yamasaniae697552011-09-27 11:33:17 -0700217 return ActivityManager.isUserAMonkey();
Ying Wanga7188322010-01-04 18:45:10 -0800218 }
Amith Yamasani60133dd2010-09-11 14:17:31 -0700219
220 /**
221 * Returns whether the device is voice-capable (meaning, it is also a phone).
222 */
223 public static boolean isVoiceCapable(Context context) {
224 TelephonyManager telephony =
225 (TelephonyManager) context.getSystemService(Context.TELEPHONY_SERVICE);
226 return telephony != null && telephony.isVoiceCapable();
227 }
Amith Yamasani0f85c482011-02-23 17:19:11 -0800228
Amith Yamasanic06d4c42011-02-25 14:35:20 -0800229 /**
230 * Returns the WIFI IP Addresses, if any, taking into account IPv4 and IPv6 style addresses.
231 * @param context the application context
Lorenzo Colitti769f0692013-08-01 17:30:07 +0900232 * @return the formatted and newline-separated IP addresses, or null if none.
Amith Yamasanic06d4c42011-02-25 14:35:20 -0800233 */
234 public static String getWifiIpAddresses(Context context) {
Jaewoong Jungc260e6d2016-10-13 14:21:52 -0700235 WifiManager wifiManager = context.getSystemService(WifiManager.class);
236 Network currentNetwork = wifiManager.getCurrentNetwork();
237 if (currentNetwork != null) {
238 ConnectivityManager cm = (ConnectivityManager)
Amith Yamasanic06d4c42011-02-25 14:35:20 -0800239 context.getSystemService(Context.CONNECTIVITY_SERVICE);
Jaewoong Jungc260e6d2016-10-13 14:21:52 -0700240 LinkProperties prop = cm.getLinkProperties(currentNetwork);
241 return formatIpAddresses(prop);
242 }
243 return null;
Amith Yamasani6822b742011-10-17 16:41:00 -0700244 }
245
246 /**
247 * Returns the default link's IP addresses, if any, taking into account IPv4 and IPv6 style
248 * addresses.
Lorenzo Colitti769f0692013-08-01 17:30:07 +0900249 * @return the formatted and newline-separated IP addresses, or null if none.
Amith Yamasani6822b742011-10-17 16:41:00 -0700250 */
Lorenzo Colitti6eb6a902013-11-08 03:53:29 +0900251 public static String getDefaultIpAddresses(ConnectivityManager cm) {
Amith Yamasani6822b742011-10-17 16:41:00 -0700252 LinkProperties prop = cm.getActiveLinkProperties();
253 return formatIpAddresses(prop);
254 }
255
256 private static String formatIpAddresses(LinkProperties prop) {
Amith Yamasanic06d4c42011-02-25 14:35:20 -0800257 if (prop == null) return null;
Lorenzo Colitti769f0692013-08-01 17:30:07 +0900258 Iterator<InetAddress> iter = prop.getAllAddresses().iterator();
Amith Yamasanic06d4c42011-02-25 14:35:20 -0800259 // If there are no entries, return null
260 if (!iter.hasNext()) return null;
261 // Concatenate all available addresses, comma separated
262 String addresses = "";
263 while (iter.hasNext()) {
264 addresses += iter.next().getHostAddress();
Lorenzo Colitti769f0692013-08-01 17:30:07 +0900265 if (iter.hasNext()) addresses += "\n";
Amith Yamasanic06d4c42011-02-25 14:35:20 -0800266 }
267 return addresses;
268 }
Jean Chalard71ad1f42011-05-12 15:06:16 +0900269
270 public static Locale createLocaleFromString(String localeStr) {
271 // TODO: is there a better way to actually construct a locale that will match?
272 // The main problem is, on top of Java specs, locale.toString() and
273 // new Locale(locale.toString()).toString() do not return equal() strings in
274 // many cases, because the constructor takes the only string as the language
275 // code. So : new Locale("en", "US").toString() => "en_US"
276 // And : new Locale("en_US").toString() => "en_us"
277 if (null == localeStr)
278 return Locale.getDefault();
279 String[] brokenDownLocale = localeStr.split("_", 3);
280 // split may not return a 0-length array.
281 if (1 == brokenDownLocale.length) {
282 return new Locale(brokenDownLocale[0]);
283 } else if (2 == brokenDownLocale.length) {
284 return new Locale(brokenDownLocale[0], brokenDownLocale[1]);
285 } else {
286 return new Locale(brokenDownLocale[0], brokenDownLocale[1], brokenDownLocale[2]);
287 }
288 }
Amith Yamasania4379d62011-07-22 10:34:58 -0700289
Jaewan Kima3fe77b2013-06-04 21:17:40 +0900290 public static boolean isBatteryPresent(Intent batteryChangedIntent) {
291 return batteryChangedIntent.getBooleanExtra(BatteryManager.EXTRA_PRESENT, true);
292 }
293
Amith Yamasania4379d62011-07-22 10:34:58 -0700294 public static String getBatteryPercentage(Intent batteryChangedIntent) {
Elliott Hughes7253df32014-09-02 17:10:14 -0700295 return formatPercentage(getBatteryLevel(batteryChangedIntent));
Dianne Hackborn525f2bd2014-04-29 11:24:06 -0700296 }
297
Jeff Sharkeyb654cbb2011-08-18 11:59:19 -0700298 /**
299 * Prepare a custom preferences layout, moving padding to {@link ListView}
300 * when outside scrollbars are requested. Usually used to display
301 * {@link ListView} and {@link TabWidget} with correct padding.
302 */
Jeff Sharkey5d706792011-09-08 18:57:17 -0700303 public static void prepareCustomPreferencesList(
Jeff Sharkey97d07fa2012-11-30 12:36:53 -0800304 ViewGroup parent, View child, View list, boolean ignoreSidePadding) {
Jeff Sharkeyb654cbb2011-08-18 11:59:19 -0700305 final boolean movePadding = list.getScrollBarStyle() == View.SCROLLBARS_OUTSIDE_OVERLAY;
Fabrice Di Meglio97a18c82014-07-18 19:12:36 -0700306 if (movePadding) {
Jeff Sharkeyb654cbb2011-08-18 11:59:19 -0700307 final Resources res = list.getResources();
Amith Yamasani56f51a82013-08-05 10:07:23 -0700308 final int paddingSide = res.getDimensionPixelSize(R.dimen.settings_side_margin);
Jeff Sharkeyb654cbb2011-08-18 11:59:19 -0700309 final int paddingBottom = res.getDimensionPixelSize(
310 com.android.internal.R.dimen.preference_fragment_padding_bottom);
Jeff Sharkey5d706792011-09-08 18:57:17 -0700311
Fabrice Di Meglio97a18c82014-07-18 19:12:36 -0700312 if (parent instanceof PreferenceFrameLayout) {
313 ((PreferenceFrameLayout.LayoutParams) child.getLayoutParams()).removeBorders = true;
314
315 final int effectivePaddingSide = ignoreSidePadding ? 0 : paddingSide;
316 list.setPaddingRelative(effectivePaddingSide, 0, effectivePaddingSide, paddingBottom);
317 } else {
318 list.setPaddingRelative(paddingSide, 0, paddingSide, paddingBottom);
319 }
Jeff Sharkeyb654cbb2011-08-18 11:59:19 -0700320 }
321 }
Jeff Sharkeya83a24f2011-09-16 01:52:39 -0700322
Fabrice Di Meglio0f4a7792014-07-28 18:25:14 -0700323 public static void forceCustomPadding(View view, boolean additive) {
Fabrice Di Meglio38ba9a22014-07-18 19:58:50 -0700324 final Resources res = view.getResources();
325 final int paddingSide = res.getDimensionPixelSize(R.dimen.settings_side_margin);
Fabrice Di Meglio0f4a7792014-07-28 18:25:14 -0700326
327 final int paddingStart = paddingSide + (additive ? view.getPaddingStart() : 0);
328 final int paddingEnd = paddingSide + (additive ? view.getPaddingEnd() : 0);
Fabrice Di Meglio38ba9a22014-07-18 19:58:50 -0700329 final int paddingBottom = res.getDimensionPixelSize(
330 com.android.internal.R.dimen.preference_fragment_padding_bottom);
331
Fabrice Di Meglio0f4a7792014-07-28 18:25:14 -0700332 view.setPaddingRelative(paddingStart, 0, paddingEnd, paddingBottom);
Fabrice Di Meglio38ba9a22014-07-18 19:58:50 -0700333 }
334
Amith Yamasani8d40fac2012-10-23 15:36:16 -0700335 public static String getMeProfileName(Context context, boolean full) {
336 if (full) {
337 return getProfileDisplayName(context);
338 } else {
339 return getShorterNameIfPossible(context);
Amith Yamasaniae47ef42012-09-16 17:53:35 -0700340 }
Amith Yamasani8d40fac2012-10-23 15:36:16 -0700341 }
342
343 private static String getShorterNameIfPossible(Context context) {
344 final String given = getLocalProfileGivenName(context);
345 return !TextUtils.isEmpty(given) ? given : getProfileDisplayName(context);
346 }
347
348 private static String getLocalProfileGivenName(Context context) {
349 final ContentResolver cr = context.getContentResolver();
350
351 // Find the raw contact ID for the local ME profile raw contact.
352 final long localRowProfileId;
353 final Cursor localRawProfile = cr.query(
354 Profile.CONTENT_RAW_CONTACTS_URI,
355 new String[] {RawContacts._ID},
356 RawContacts.ACCOUNT_TYPE + " IS NULL AND " +
357 RawContacts.ACCOUNT_NAME + " IS NULL",
358 null, null);
359 if (localRawProfile == null) return null;
Amith Yamasaniae47ef42012-09-16 17:53:35 -0700360
361 try {
Amith Yamasani8d40fac2012-10-23 15:36:16 -0700362 if (!localRawProfile.moveToFirst()) {
363 return null;
Amith Yamasaniae47ef42012-09-16 17:53:35 -0700364 }
Amith Yamasani8d40fac2012-10-23 15:36:16 -0700365 localRowProfileId = localRawProfile.getLong(0);
Amith Yamasaniae47ef42012-09-16 17:53:35 -0700366 } finally {
Amith Yamasani8d40fac2012-10-23 15:36:16 -0700367 localRawProfile.close();
Amith Yamasaniae47ef42012-09-16 17:53:35 -0700368 }
Amith Yamasani8d40fac2012-10-23 15:36:16 -0700369
370 // Find the structured name for the raw contact.
371 final Cursor structuredName = cr.query(
372 Profile.CONTENT_URI.buildUpon().appendPath(Contacts.Data.CONTENT_DIRECTORY).build(),
373 new String[] {CommonDataKinds.StructuredName.GIVEN_NAME,
374 CommonDataKinds.StructuredName.FAMILY_NAME},
375 Data.RAW_CONTACT_ID + "=" + localRowProfileId,
376 null, null);
377 if (structuredName == null) return null;
378
379 try {
380 if (!structuredName.moveToFirst()) {
381 return null;
382 }
383 String partialName = structuredName.getString(0);
384 if (TextUtils.isEmpty(partialName)) {
385 partialName = structuredName.getString(1);
386 }
387 return partialName;
388 } finally {
389 structuredName.close();
390 }
391 }
392
393 private static final String getProfileDisplayName(Context context) {
394 final ContentResolver cr = context.getContentResolver();
395 final Cursor profile = cr.query(Profile.CONTENT_URI,
396 new String[] {Profile.DISPLAY_NAME}, null, null, null);
397 if (profile == null) return null;
398
399 try {
400 if (!profile.moveToFirst()) {
401 return null;
402 }
403 return profile.getString(0);
404 } finally {
405 profile.close();
406 }
Amith Yamasaniae47ef42012-09-16 17:53:35 -0700407 }
Amith Yamasani9627a8e2012-09-23 12:54:14 -0700408
409 /** Not global warming, it's global change warning. */
410 public static Dialog buildGlobalChangeWarningDialog(final Context context, int titleResId,
411 final Runnable positiveAction) {
412 final AlertDialog.Builder builder = new AlertDialog.Builder(context);
413 builder.setTitle(titleResId);
414 builder.setMessage(R.string.global_change_warning);
415 builder.setPositiveButton(android.R.string.ok, new DialogInterface.OnClickListener() {
416 @Override
417 public void onClick(DialogInterface dialog, int which) {
418 positiveAction.run();
419 }
420 });
421 builder.setNegativeButton(android.R.string.cancel, null);
422
423 return builder.create();
424 }
425
426 public static boolean hasMultipleUsers(Context context) {
427 return ((UserManager) context.getSystemService(Context.USER_SERVICE))
428 .getUsers().size() > 1;
429 }
Fabrice Di Meglio769630c2014-04-24 14:48:48 -0700430
431 /**
432 * Start a new instance of the activity, showing only the given fragment.
433 * When launched in this mode, the given preference fragment will be instantiated and fill the
434 * entire activity.
435 *
436 * @param context The context.
Fabrice Di Meglio93b77b72014-05-17 00:01:07 +0000437 * @param fragmentName The name of the fragment to display.
Fabrice Di Meglio769630c2014-04-24 14:48:48 -0700438 * @param args Optional arguments to supply to the fragment.
Fabrice Di Meglioa9e77992014-06-09 12:52:24 -0700439 * @param resultTo Option fragment that should receive the result of the activity launch.
440 * @param resultRequestCode If resultTo is non-null, this is the request code in which
441 * to report the result.
442 * @param titleResId resource id for the String to display for the title of this set
443 * of preferences.
Fabrice Di Meglio769630c2014-04-24 14:48:48 -0700444 * @param title String to display for the title of this set of preferences.
Fan Zhangc6ca3142017-02-14 15:02:35 -0800445 * @param metricsCategory The current metricsCategory for logging source when fragment starts
Fabrice Di Meglio769630c2014-04-24 14:48:48 -0700446 */
Fabrice Di Meglio93b77b72014-05-17 00:01:07 +0000447 public static void startWithFragment(Context context, String fragmentName, Bundle args,
Alexandra Gherghina62464b82014-08-11 12:40:13 +0100448 Fragment resultTo, int resultRequestCode, int titleResId,
Fan Zhangc6ca3142017-02-14 15:02:35 -0800449 CharSequence title, int metricsCategory) {
Fabrice Di Meglio0d643fd2014-06-16 20:11:27 -0700450 startWithFragment(context, fragmentName, args, resultTo, resultRequestCode,
Fan Zhangc6ca3142017-02-14 15:02:35 -0800451 null /* titleResPackageName */, titleResId, title, false /* not a shortcut */,
452 metricsCategory);
Alexandra Gherghina62464b82014-08-11 12:40:13 +0100453 }
454
Ajay Nadathurd473e382017-11-07 13:38:50 -0800455
456 /**
457 * Start a new instance of the activity, showing only the given fragment.
458 * When launched in this mode, the given preference fragment will be instantiated and fill the
459 * entire activity.
460 *
461 * @param context The context.
462 * @param fragmentName The name of the fragment to display.
463 * @param titleResId resource id for the String to display for the title of this set
464 * of preferences.
465 * @param metricsCategory The current metricsCategory for logging source when fragment starts
466 * @param intentFlags flag that should be added to the intent.
467 */
468 public static void startWithFragment(Context context, String fragmentName, int titleResId,
469 int metricsCategory, int intentFlags) {
470 startWithFragment(context, fragmentName, null, null, 0,
471 null /* titleResPackageName */, titleResId, null, false /* not a shortcut */,
472 metricsCategory, intentFlags);
473 }
474
Alexandra Gherghina62464b82014-08-11 12:40:13 +0100475 /**
476 * Start a new instance of the activity, showing only the given fragment.
477 * When launched in this mode, the given preference fragment will be instantiated and fill the
478 * entire activity.
479 *
480 * @param context The context.
481 * @param fragmentName The name of the fragment to display.
482 * @param args Optional arguments to supply to the fragment.
483 * @param resultTo Option fragment that should receive the result of the activity launch.
484 * @param resultRequestCode If resultTo is non-null, this is the request code in which
485 * to report the result.
486 * @param titleResPackageName Optional package name for the resource id of the title.
487 * @param titleResId resource id for the String to display for the title of this set
488 * of preferences.
489 * @param title String to display for the title of this set of preferences.
Fan Zhangc6ca3142017-02-14 15:02:35 -0800490 * @param metricsCategory The current metricsCategory for logging source when fragment starts
Alexandra Gherghina62464b82014-08-11 12:40:13 +0100491 */
492 public static void startWithFragment(Context context, String fragmentName, Bundle args,
493 Fragment resultTo, int resultRequestCode, String titleResPackageName, int titleResId,
Fan Zhangc6ca3142017-02-14 15:02:35 -0800494 CharSequence title, int metricsCategory) {
Alexandra Gherghina62464b82014-08-11 12:40:13 +0100495 startWithFragment(context, fragmentName, args, resultTo, resultRequestCode,
Fan Zhangc6ca3142017-02-14 15:02:35 -0800496 titleResPackageName, titleResId, title, false /* not a shortcut */,
497 metricsCategory);
Fabrice Di Meglio0d643fd2014-06-16 20:11:27 -0700498 }
499
500 public static void startWithFragment(Context context, String fragmentName, Bundle args,
Alexandra Gherghina62464b82014-08-11 12:40:13 +0100501 Fragment resultTo, int resultRequestCode, int titleResId,
Fan Zhangc6ca3142017-02-14 15:02:35 -0800502 CharSequence title, boolean isShortcut, int metricsCategory) {
Alexandra Gherghina62464b82014-08-11 12:40:13 +0100503 Intent intent = onBuildStartFragmentIntent(context, fragmentName, args,
Fan Zhangc6ca3142017-02-14 15:02:35 -0800504 null /* titleResPackageName */, titleResId, title, isShortcut, metricsCategory);
Alexandra Gherghina62464b82014-08-11 12:40:13 +0100505 if (resultTo == null) {
506 context.startActivity(intent);
507 } else {
Doris Ling36e953f2016-08-12 15:25:00 -0700508 resultTo.getActivity().startActivityForResult(intent, resultRequestCode);
Alexandra Gherghina62464b82014-08-11 12:40:13 +0100509 }
510 }
511
512 public static void startWithFragment(Context context, String fragmentName, Bundle args,
513 Fragment resultTo, int resultRequestCode, String titleResPackageName, int titleResId,
Fan Zhangc6ca3142017-02-14 15:02:35 -0800514 CharSequence title, boolean isShortcut, int metricsCategory) {
Ajay Nadathurd473e382017-11-07 13:38:50 -0800515 startWithFragment(context, fragmentName, args, resultTo, resultRequestCode,
516 titleResPackageName, titleResId, title, isShortcut, metricsCategory, 0);
517 }
518
519
520 public static void startWithFragment(Context context, String fragmentName, Bundle args,
521 Fragment resultTo, int resultRequestCode, String titleResPackageName, int titleResId,
522 CharSequence title, boolean isShortcut, int metricsCategory, int flags) {
Alexandra Gherghina62464b82014-08-11 12:40:13 +0100523 Intent intent = onBuildStartFragmentIntent(context, fragmentName, args, titleResPackageName,
Fan Zhangc6ca3142017-02-14 15:02:35 -0800524 titleResId, title, isShortcut, metricsCategory);
Ajay Nadathurd473e382017-11-07 13:38:50 -0800525 intent.addFlags(flags);
Fabrice Di Meglio769630c2014-04-24 14:48:48 -0700526 if (resultTo == null) {
527 context.startActivity(intent);
528 } else {
529 resultTo.startActivityForResult(intent, resultRequestCode);
530 }
531 }
532
Zoltan Szatmary-Ban7a2ccf22014-09-18 10:26:11 +0100533 public static void startWithFragmentAsUser(Context context, String fragmentName, Bundle args,
Fan Zhangc6ca3142017-02-14 15:02:35 -0800534 int titleResId, CharSequence title, boolean isShortcut, int metricsCategory,
Alexandra Gherghina62464b82014-08-11 12:40:13 +0100535 UserHandle userHandle) {
Victor Chang16da2aa2016-03-11 19:44:56 +0000536 // workaround to avoid crash in b/17523189
537 if (userHandle.getIdentifier() == UserHandle.myUserId()) {
Fan Zhangc6ca3142017-02-14 15:02:35 -0800538 startWithFragment(context, fragmentName, args, null, 0, titleResId, title, isShortcut,
539 metricsCategory);
Victor Chang16da2aa2016-03-11 19:44:56 +0000540 } else {
541 Intent intent = onBuildStartFragmentIntent(context, fragmentName, args,
Fan Zhangc6ca3142017-02-14 15:02:35 -0800542 null /* titleResPackageName */, titleResId, title, isShortcut, metricsCategory);
Victor Chang16da2aa2016-03-11 19:44:56 +0000543 intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
544 intent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TASK);
545 context.startActivityAsUser(intent, userHandle);
546 }
Zoltan Szatmary-Ban7a2ccf22014-09-18 10:26:11 +0100547 }
548
Fabrice Di Meglio769630c2014-04-24 14:48:48 -0700549 /**
550 * Build an Intent to launch a new activity showing the selected fragment.
551 * The implementation constructs an Intent that re-launches the current activity with the
552 * appropriate arguments to display the fragment.
553 *
Fabrice Di Meglio0d643fd2014-06-16 20:11:27 -0700554 *
Fabrice Di Meglio769630c2014-04-24 14:48:48 -0700555 * @param context The Context.
Fabrice Di Meglio93b77b72014-05-17 00:01:07 +0000556 * @param fragmentName The name of the fragment to display.
Fabrice Di Meglio769630c2014-04-24 14:48:48 -0700557 * @param args Optional arguments to supply to the fragment.
Alexandra Gherghina62464b82014-08-11 12:40:13 +0100558 * @param titleResPackageName Optional package name for the resource id of the title.
Fabrice Di Meglioa9e77992014-06-09 12:52:24 -0700559 * @param titleResId Optional title resource id to show for this item.
Fabrice Di Meglio769630c2014-04-24 14:48:48 -0700560 * @param title Optional title to show for this item.
Fabrice Di Meglio0d643fd2014-06-16 20:11:27 -0700561 * @param isShortcut tell if this is a Launcher Shortcut or not
Fan Zhangc6ca3142017-02-14 15:02:35 -0800562 * @param sourceMetricsCategory The context (source) from which an action is performed
Fabrice Di Meglio769630c2014-04-24 14:48:48 -0700563 * @return Returns an Intent that can be launched to display the given
564 * fragment.
565 */
Fabrice Di Meglio93b77b72014-05-17 00:01:07 +0000566 public static Intent onBuildStartFragmentIntent(Context context, String fragmentName,
Alexandra Gherghina62464b82014-08-11 12:40:13 +0100567 Bundle args, String titleResPackageName, int titleResId, CharSequence title,
Fan Zhangc6ca3142017-02-14 15:02:35 -0800568 boolean isShortcut, int sourceMetricsCategory) {
Fabrice Di Meglio769630c2014-04-24 14:48:48 -0700569 Intent intent = new Intent(Intent.ACTION_MAIN);
570 intent.setClass(context, SubSettings.class);
Fabrice Di Meglio93b77b72014-05-17 00:01:07 +0000571 intent.putExtra(SettingsActivity.EXTRA_SHOW_FRAGMENT, fragmentName);
Fabrice Di Meglio769630c2014-04-24 14:48:48 -0700572 intent.putExtra(SettingsActivity.EXTRA_SHOW_FRAGMENT_ARGUMENTS, args);
Alexandra Gherghina62464b82014-08-11 12:40:13 +0100573 intent.putExtra(SettingsActivity.EXTRA_SHOW_FRAGMENT_TITLE_RES_PACKAGE_NAME,
574 titleResPackageName);
Fabrice Di Meglioa9e77992014-06-09 12:52:24 -0700575 intent.putExtra(SettingsActivity.EXTRA_SHOW_FRAGMENT_TITLE_RESID, titleResId);
Fabrice Di Meglio769630c2014-04-24 14:48:48 -0700576 intent.putExtra(SettingsActivity.EXTRA_SHOW_FRAGMENT_TITLE, title);
Fabrice Di Meglio0d643fd2014-06-16 20:11:27 -0700577 intent.putExtra(SettingsActivity.EXTRA_SHOW_FRAGMENT_AS_SHORTCUT, isShortcut);
Fan Zhangc6ca3142017-02-14 15:02:35 -0800578 intent.putExtra(SettingsActivity.EXTRA_SOURCE_METRICS_CATEGORY, sourceMetricsCategory);
Fabrice Di Meglio769630c2014-04-24 14:48:48 -0700579 return intent;
580 }
Alexandra Gherghina3939cd72014-06-04 10:02:55 +0100581
582 /**
Esteban Talavera9b86e9c2017-05-30 16:48:08 +0100583 * Returns the managed profile of the current user or {@code null} if none is found or a profile
584 * exists but it is disabled.
Alexandra Gherghina3939cd72014-06-04 10:02:55 +0100585 */
586 public static UserHandle getManagedProfile(UserManager userManager) {
587 List<UserHandle> userProfiles = userManager.getUserProfiles();
588 final int count = userProfiles.size();
589 for (int i = 0; i < count; i++) {
590 final UserHandle profile = userProfiles.get(i);
591 if (profile.getIdentifier() == userManager.getUserHandle()) {
592 continue;
593 }
594 final UserInfo userInfo = userManager.getUserInfo(profile.getIdentifier());
595 if (userInfo.isManagedProfile()) {
596 return profile;
597 }
598 }
599 return null;
600 }
601
602 /**
Esteban Talavera9b86e9c2017-05-30 16:48:08 +0100603 * Returns the managed profile of the current user or {@code null} if none is found. Unlike
604 * {@link #getManagedProfile} this method returns enabled and disabled managed profiles.
605 */
606 public static UserHandle getManagedProfileWithDisabled(UserManager userManager) {
607 // TODO: Call getManagedProfileId from here once Robolectric supports
608 // API level 24 and UserManager.getProfileIdsWithDisabled can be Mocked (to avoid having
609 // yet another implementation that loops over user profiles in this method). In the meantime
610 // we need to use UserManager.getProfiles that is available on API 23 (the one currently
611 // used for Settings Robolectric tests).
612 final int myUserId = UserHandle.myUserId();
613 List<UserInfo> profiles = userManager.getProfiles(myUserId);
614 final int count = profiles.size();
615 for (int i = 0; i < count; i++) {
616 final UserInfo profile = profiles.get(i);
617 if (profile.isManagedProfile()
618 && profile.getUserHandle().getIdentifier() != myUserId) {
619 return profile.getUserHandle();
620 }
621 }
622 return null;
623 }
624
625 /**
Clara Bayarri462cce12016-02-18 12:09:21 +0000626 * Retrieves the id for the given user's managed profile.
627 *
628 * @return the managed profile id or UserHandle.USER_NULL if there is none.
629 */
630 public static int getManagedProfileId(UserManager um, int parentUserId) {
Fyodor Kupolov4a4af5a2016-04-07 16:46:18 -0700631 int[] profileIds = um.getProfileIdsWithDisabled(parentUserId);
632 for (int profileId : profileIds) {
633 if (profileId != parentUserId) {
634 return profileId;
Clara Bayarri462cce12016-02-18 12:09:21 +0000635 }
636 }
637 return UserHandle.USER_NULL;
638 }
639
640 /**
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100641 * Returns the target user for a Settings activity.
Tony Mak8f41b9b2016-11-23 11:36:18 +0000642 * <p>
643 * User would be retrieved in this order:
644 * <ul>
645 * <li> If this activity is launched from other user, return that user id.
646 * <li> If this is launched from the Settings app in same user, return the user contained as an
647 * extra in the arguments or intent extras.
648 * <li> Otherwise, return UserHandle.myUserId().
649 * </ul>
650 * <p>
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100651 * Note: This is secure in the sense that it only returns a target user different to the current
652 * one if the app launching this activity is the Settings app itself, running in the same user
653 * 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 +0100654 */
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100655 public static UserHandle getSecureTargetUser(IBinder activityToken,
Tony Mak8f41b9b2016-11-23 11:36:18 +0000656 UserManager um, @Nullable Bundle arguments, @Nullable Bundle intentExtras) {
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100657 UserHandle currentUser = new UserHandle(UserHandle.myUserId());
Sudheer Shankaacb1a612016-11-10 15:30:14 -0800658 IActivityManager am = ActivityManager.getService();
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100659 try {
660 String launchedFromPackage = am.getLaunchedFromPackage(activityToken);
661 boolean launchedFromSettingsApp = SETTINGS_PACKAGE_NAME.equals(launchedFromPackage);
662
663 UserHandle launchedFromUser = new UserHandle(UserHandle.getUserId(
664 am.getLaunchedFromUid(activityToken)));
665 if (launchedFromUser != null && !launchedFromUser.equals(currentUser)) {
666 // Check it's secure
667 if (isProfileOf(um, launchedFromUser)) {
668 return launchedFromUser;
669 }
670 }
Tony Mak8f41b9b2016-11-23 11:36:18 +0000671 UserHandle extrasUser = getUserHandleFromBundle(intentExtras);
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100672 if (extrasUser != null && !extrasUser.equals(currentUser)) {
673 // Check it's secure
674 if (launchedFromSettingsApp && isProfileOf(um, extrasUser)) {
675 return extrasUser;
676 }
677 }
Tony Mak8f41b9b2016-11-23 11:36:18 +0000678 UserHandle argumentsUser = getUserHandleFromBundle(arguments);
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100679 if (argumentsUser != null && !argumentsUser.equals(currentUser)) {
680 // Check it's secure
681 if (launchedFromSettingsApp && isProfileOf(um, argumentsUser)) {
682 return argumentsUser;
683 }
684 }
685 } catch (RemoteException e) {
686 // Should not happen
687 Log.v(TAG, "Could not talk to activity manager.", e);
688 }
689 return currentUser;
Tony Mak8f41b9b2016-11-23 11:36:18 +0000690 }
691
692 /**
693 * Lookup both {@link Intent#EXTRA_USER} and {@link Intent#EXTRA_USER_ID} in the bundle
694 * and return the {@link UserHandle} object. Return {@code null} if nothing is found.
695 */
696 private static @Nullable UserHandle getUserHandleFromBundle(Bundle bundle) {
697 if (bundle == null) {
698 return null;
699 }
700 final UserHandle user = bundle.getParcelable(EXTRA_USER);
701 if (user != null) {
702 return user;
703 }
704 final int userId = bundle.getInt(EXTRA_USER_ID, -1);
705 if (userId != -1) {
706 return UserHandle.of(userId);
707 }
708 return null;
709 }
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100710
711 /**
712 * Returns the target user for a Settings activity.
713 *
714 * The target user can be either the current user, the user that launched this activity or
715 * the user contained as an extra in the arguments or intent extras.
716 *
717 * You should use {@link #getSecureTargetUser(IBinder, UserManager, Bundle, Bundle)} if
718 * possible.
719 *
720 * @see #getInsecureTargetUser(IBinder, Bundle, Bundle)
721 */
722 public static UserHandle getInsecureTargetUser(IBinder activityToken, @Nullable Bundle arguments,
723 @Nullable Bundle intentExtras) {
724 UserHandle currentUser = new UserHandle(UserHandle.myUserId());
Sudheer Shankaacb1a612016-11-10 15:30:14 -0800725 IActivityManager am = ActivityManager.getService();
Alexandra Gherghina1eb3f312014-06-10 14:01:10 +0100726 try {
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100727 UserHandle launchedFromUser = new UserHandle(UserHandle.getUserId(
728 am.getLaunchedFromUid(activityToken)));
729 if (launchedFromUser != null && !launchedFromUser.equals(currentUser)) {
730 return launchedFromUser;
731 }
732 UserHandle extrasUser = intentExtras != null
733 ? (UserHandle) intentExtras.getParcelable(EXTRA_USER) : null;
734 if (extrasUser != null && !extrasUser.equals(currentUser)) {
735 return extrasUser;
736 }
737 UserHandle argumentsUser = arguments != null
738 ? (UserHandle) arguments.getParcelable(EXTRA_USER) : null;
739 if (argumentsUser != null && !argumentsUser.equals(currentUser)) {
740 return argumentsUser;
Alexandra Gherghina1eb3f312014-06-10 14:01:10 +0100741 }
742 } catch (RemoteException e) {
743 // Should not happen
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100744 Log.v(TAG, "Could not talk to activity manager.", e);
745 return null;
Alexandra Gherghina1eb3f312014-06-10 14:01:10 +0100746 }
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100747 return currentUser;
748 }
Alexandra Gherghina1eb3f312014-06-10 14:01:10 +0100749
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100750 /**
751 * Returns true if the user provided is in the same profiles group as the current user.
752 */
753 private static boolean isProfileOf(UserManager um, UserHandle otherUser) {
754 if (um == null || otherUser == null) return false;
755 return (UserHandle.myUserId() == otherUser.getIdentifier())
756 || um.getUserProfiles().contains(otherUser);
Alexandra Gherghina1eb3f312014-06-10 14:01:10 +0100757 }
Amith Yamasani51c6dac2014-07-02 00:06:37 +0530758
Alexandra Gherghina95b86a52014-07-24 19:13:25 +0100759 /**
Fabrice Di Meglio22a2a492014-08-08 12:27:57 -0700760 * Return whether or not the user should have a SIM Cards option in Settings.
761 * TODO: Change back to returning true if count is greater than one after testing.
762 * TODO: See bug 16533525.
763 */
764 public static boolean showSimCardTile(Context context) {
765 final TelephonyManager tm =
766 (TelephonyManager) context.getSystemService(Context.TELEPHONY_SERVICE);
767
PauloftheWestdbd03822014-12-04 11:56:35 -0800768 return tm.getSimCount() > 1;
Fabrice Di Meglio22a2a492014-08-08 12:27:57 -0700769 }
Dan Sandlerb58b5122014-09-02 18:31:49 +0200770
771 /**
Elliott Hughes7253df32014-09-02 17:10:14 -0700772 * Returns elapsed time for the given millis, in the following format:
773 * 2d 5h 40m 29s
774 * @param context the application context
775 * @param millis the elapsed time in milli seconds
776 * @param withSeconds include seconds?
777 * @return the formatted elapsed time
778 */
jackqdyuleif4c1cef2017-03-31 12:57:10 -0700779 public static CharSequence formatElapsedTime(Context context, double millis,
780 boolean withSeconds) {
781 SpannableStringBuilder sb = new SpannableStringBuilder();
Elliott Hughes7253df32014-09-02 17:10:14 -0700782 int seconds = (int) Math.floor(millis / 1000);
783 if (!withSeconds) {
784 // Round up.
785 seconds += 30;
786 }
787
788 int days = 0, hours = 0, minutes = 0;
789 if (seconds >= SECONDS_PER_DAY) {
790 days = seconds / SECONDS_PER_DAY;
791 seconds -= days * SECONDS_PER_DAY;
792 }
793 if (seconds >= SECONDS_PER_HOUR) {
794 hours = seconds / SECONDS_PER_HOUR;
795 seconds -= hours * SECONDS_PER_HOUR;
796 }
797 if (seconds >= SECONDS_PER_MINUTE) {
798 minutes = seconds / SECONDS_PER_MINUTE;
799 seconds -= minutes * SECONDS_PER_MINUTE;
800 }
jackqdyuleif4c1cef2017-03-31 12:57:10 -0700801
Roozbeh Pournader15872242017-06-20 16:46:49 -0700802 final ArrayList<Measure> measureList = new ArrayList(4);
803 if (days > 0) {
804 measureList.add(new Measure(days, MeasureUnit.DAY));
805 }
806 if (hours > 0) {
807 measureList.add(new Measure(hours, MeasureUnit.HOUR));
808 }
809 if (minutes > 0) {
810 measureList.add(new Measure(minutes, MeasureUnit.MINUTE));
811 }
812 if (withSeconds && seconds > 0) {
813 measureList.add(new Measure(seconds, MeasureUnit.SECOND));
814 }
815 if (measureList.size() == 0) {
816 // Everything addable was zero, so nothing was added. We add a zero.
817 measureList.add(new Measure(0, withSeconds ? MeasureUnit.SECOND : MeasureUnit.MINUTE));
818 }
819 final Measure[] measureArray = measureList.toArray(new Measure[measureList.size()]);
820
821 final Locale locale = context.getResources().getConfiguration().locale;
822 final MeasureFormat measureFormat = MeasureFormat.getInstance(
823 locale, MeasureFormat.FormatWidth.NARROW);
824 sb.append(measureFormat.formatMeasures(measureArray));
825
826 if (measureArray.length == 1 && MeasureUnit.MINUTE.equals(measureArray[0].getUnit())) {
827 // Add ttsSpan if it only have minute value, because it will be read as "meters"
828 final TtsSpan ttsSpan = new TtsSpan.MeasureBuilder().setNumber(minutes)
829 .setUnit("minute").build();
830 sb.setSpan(ttsSpan, 0, sb.length(), Spanned.SPAN_EXCLUSIVE_EXCLUSIVE);
Elliott Hughes7253df32014-09-02 17:10:14 -0700831 }
jackqdyuleif4c1cef2017-03-31 12:57:10 -0700832
833 return sb;
Elliott Hughes7253df32014-09-02 17:10:14 -0700834 }
PauloftheWest0a0daca2014-11-06 15:02:58 -0800835
836 /**
Roozbeh Pournader4de9df22017-08-26 14:05:15 -0700837 * Returns relative time for the given millis in the past, in a short format such as "2 days
838 * ago", "5 hr. ago", "40 min. ago", or "29 sec. ago".
839 *
840 * <p>The unit is chosen to have good information value while only using one unit. So 27 hours
841 * and 50 minutes would be formatted as "28 hr. ago", while 50 hours would be formatted as
842 * "2 days ago".
843 *
844 * @param context the application context
845 * @param millis the elapsed time in milli seconds
846 * @param withSeconds include seconds?
847 * @return the formatted elapsed time
848 */
849 public static CharSequence formatRelativeTime(Context context, double millis,
850 boolean withSeconds) {
851 final int seconds = (int) Math.floor(millis / 1000);
852 final RelativeUnit unit;
853 final int value;
854 if (withSeconds && seconds < 2 * SECONDS_PER_MINUTE) {
855 unit = RelativeUnit.SECONDS;
856 value = seconds;
857 } else if (seconds < 2 * SECONDS_PER_HOUR) {
858 unit = RelativeUnit.MINUTES;
859 value = (seconds + SECONDS_PER_MINUTE / 2) / SECONDS_PER_MINUTE;
860 } else if (seconds < 2 * SECONDS_PER_DAY) {
861 unit = RelativeUnit.HOURS;
862 value = (seconds + SECONDS_PER_HOUR / 2) / SECONDS_PER_HOUR;
863 } else {
864 unit = RelativeUnit.DAYS;
865 value = (seconds + SECONDS_PER_DAY / 2) / SECONDS_PER_DAY;
866 }
867
868 final Locale locale = context.getResources().getConfiguration().locale;
869 final RelativeDateTimeFormatter formatter = RelativeDateTimeFormatter.getInstance(
870 ULocale.forLocale(locale),
871 null /* default NumberFormat */,
872 RelativeDateTimeFormatter.Style.SHORT,
873 android.icu.text.DisplayContext.CAPITALIZATION_FOR_MIDDLE_OF_SENTENCE);
874
875 return formatter.format(value, RelativeDateTimeFormatter.Direction.LAST, unit);
876 }
877
878 /**
Amith Yamasani45f86232014-11-19 17:12:46 -0800879 * Queries for the UserInfo of a user. Returns null if the user doesn't exist (was removed).
880 * @param userManager Instance of UserManager
881 * @param checkUser The user to check the existence of.
882 * @return UserInfo of the user or null for non-existent user.
883 */
884 public static UserInfo getExistingUser(UserManager userManager, UserHandle checkUser) {
885 final List<UserInfo> users = userManager.getUsers(true /* excludeDying */);
886 final int checkUserId = checkUser.getIdentifier();
887 for (UserInfo user : users) {
888 if (user.id == checkUserId) {
889 return user;
890 }
891 }
892 return null;
893 }
894
Zoltan Szatmary-Ban3af2e4c2014-12-19 17:17:23 +0000895 public static View inflateCategoryHeader(LayoutInflater inflater, ViewGroup parent) {
896 final TypedArray a = inflater.getContext().obtainStyledAttributes(null,
897 com.android.internal.R.styleable.Preference,
898 com.android.internal.R.attr.preferenceCategoryStyle, 0);
899 final int resId = a.getResourceId(com.android.internal.R.styleable.Preference_layout,
900 0);
901 a.recycle();
902 return inflater.inflate(resId, parent, false);
903 }
904
Fabrice Di Megliodff3faa2015-02-27 11:14:11 -0800905 /**
906 * Return if we are running low on storage space or not.
907 *
908 * @param context The context
909 * @return true if we are running low on storage space
910 */
911 public static boolean isLowStorage(Context context) {
912 final StorageManager sm = StorageManager.from(context);
913 return (sm.getStorageBytesUntilLow(context.getFilesDir()) < 0);
914 }
915
Fabrice Di Meglio8b2ea392015-01-23 19:03:22 -0800916
Fabrice Di Meglio8b2ea392015-01-23 19:03:22 -0800917 public static boolean hasPreferredActivities(PackageManager pm, String packageName) {
918 // Get list of preferred activities
919 List<ComponentName> prefActList = new ArrayList<>();
920 // Intent list cannot be null. so pass empty list
921 List<IntentFilter> intentList = new ArrayList<>();
922 pm.getPreferredActivities(intentList, prefActList, packageName);
923 Log.d(TAG, "Have " + prefActList.size() + " number of activities in preferred list");
924 return prefActList.size() > 0;
925 }
926
Christopher Tatea08a2252015-07-01 16:52:43 -0700927 public static ArraySet<String> getHandledDomains(PackageManager pm, String packageName) {
928 List<IntentFilterVerificationInfo> iviList = pm.getIntentFilterVerifications(packageName);
929 List<IntentFilter> filters = pm.getAllIntentFilters(packageName);
930
931 ArraySet<String> result = new ArraySet<>();
Fan Zhang4e540db2017-11-08 13:06:38 -0800932 if (iviList != null && iviList.size() > 0) {
Christopher Tatea08a2252015-07-01 16:52:43 -0700933 for (IntentFilterVerificationInfo ivi : iviList) {
934 for (String host : ivi.getDomains()) {
935 result.add(host);
936 }
937 }
938 }
939 if (filters != null && filters.size() > 0) {
940 for (IntentFilter filter : filters) {
Christopher Tateddaa1422015-07-16 16:00:49 -0700941 if (filter.hasCategory(Intent.CATEGORY_BROWSABLE)
942 && (filter.hasDataScheme(IntentFilter.SCHEME_HTTP) ||
943 filter.hasDataScheme(IntentFilter.SCHEME_HTTPS))) {
Christopher Tatea08a2252015-07-01 16:52:43 -0700944 result.addAll(filter.getHostsList());
945 }
946 }
947 }
948 return result;
949 }
950
Sudheer Shankabc956302015-04-09 12:19:53 +0100951 /**
952 * Returns the application info of the currently installed MDM package.
953 */
954 public static ApplicationInfo getAdminApplicationInfo(Context context, int profileId) {
955 DevicePolicyManager dpm =
956 (DevicePolicyManager) context.getSystemService(Context.DEVICE_POLICY_SERVICE);
957 ComponentName mdmPackage = dpm.getProfileOwnerAsUser(profileId);
958 if (mdmPackage == null) {
959 return null;
960 }
961 String mdmPackageName = mdmPackage.getPackageName();
962 try {
963 IPackageManager ipm = AppGlobals.getPackageManager();
964 ApplicationInfo mdmApplicationInfo =
965 ipm.getApplicationInfo(mdmPackageName, 0, profileId);
966 return mdmApplicationInfo;
967 } catch (RemoteException e) {
968 Log.e(TAG, "Error while retrieving application info for package " + mdmPackageName
969 + ", userId " + profileId, e);
970 return null;
971 }
972 }
Jason Monkb45e27b2015-05-20 13:35:43 -0400973
974 public static boolean isBandwidthControlEnabled() {
975 final INetworkManagementService netManager = INetworkManagementService.Stub
976 .asInterface(ServiceManager.getService(Context.NETWORKMANAGEMENT_SERVICE));
977 try {
978 return netManager.isBandwidthControlEnabled();
979 } catch (RemoteException e) {
980 return false;
981 }
982 }
Julia Reynoldsce25af42015-07-08 16:56:31 -0400983
984 /**
985 * Returns an accessible SpannableString.
986 * @param displayText the text to display
987 * @param accessibileText the text text-to-speech engines should read
988 */
989 public static SpannableString createAccessibleSequence(CharSequence displayText,
990 String accessibileText) {
991 SpannableString str = new SpannableString(displayText);
992 str.setSpan(new TtsSpan.TextBuilder(accessibileText).build(), 0,
993 displayText.length(),
994 Spannable.SPAN_INCLUSIVE_INCLUSIVE);
995 return str;
996 }
Andres Morales7bdffd82015-08-04 16:55:00 -0700997
Clara Bayarrife432e82015-10-12 12:07:02 +0100998 /**
Jeff Sharkey219ec912017-12-19 14:57:39 -0700999 * Returns the user id present in the bundle with
1000 * {@link Intent#EXTRA_USER_ID} if it belongs to the current user.
Clara Bayarrife432e82015-10-12 12:07:02 +01001001 *
Jeff Sharkey219ec912017-12-19 14:57:39 -07001002 * @throws SecurityException if the given userId does not belong to the
1003 * current user group.
Clara Bayarrife432e82015-10-12 12:07:02 +01001004 */
Benjamin Franz194300d2016-01-13 12:16:25 +00001005 public static int getUserIdFromBundle(Context context, Bundle bundle) {
Jeff Sharkey219ec912017-12-19 14:57:39 -07001006 return getUserIdFromBundle(context, bundle, false);
1007 }
1008
1009 /**
1010 * Returns the user id present in the bundle with
1011 * {@link Intent#EXTRA_USER_ID} if it belongs to the current user.
1012 *
1013 * @param isInternal indicating if the caller is "internal" to the system,
1014 * meaning we're willing to trust extras like
1015 * {@link ChooseLockSettingsHelper#EXTRA_ALLOW_ANY_USER}.
1016 * @throws SecurityException if the given userId does not belong to the
1017 * current user group.
1018 */
1019 public static int getUserIdFromBundle(Context context, Bundle bundle, boolean isInternal) {
Clara Bayarrife432e82015-10-12 12:07:02 +01001020 if (bundle == null) {
Benjamin Franz194300d2016-01-13 12:16:25 +00001021 return getCredentialOwnerUserId(context);
Clara Bayarrife432e82015-10-12 12:07:02 +01001022 }
Jeff Sharkey219ec912017-12-19 14:57:39 -07001023 final boolean allowAnyUser = isInternal
1024 && bundle.getBoolean(ChooseLockSettingsHelper.EXTRA_ALLOW_ANY_USER, false);
Clara Bayarri6934a042015-10-14 11:07:35 +01001025 int userId = bundle.getInt(Intent.EXTRA_USER_ID, UserHandle.myUserId());
Adrian Roos5a9a3cd2017-03-30 18:02:25 -07001026 if (userId == LockPatternUtils.USER_FRP) {
Jeff Sharkey219ec912017-12-19 14:57:39 -07001027 return allowAnyUser ? userId : enforceSystemUser(context, userId);
Adrian Roos5a9a3cd2017-03-30 18:02:25 -07001028 } else {
Jeff Sharkey219ec912017-12-19 14:57:39 -07001029 return allowAnyUser ? userId : enforceSameOwner(context, userId);
Adrian Roos5a9a3cd2017-03-30 18:02:25 -07001030 }
1031 }
1032
1033 /**
1034 * Returns the given user id if the current user is the system user.
1035 *
1036 * @throws SecurityException if the current user is not the system user.
1037 */
1038 public static int enforceSystemUser(Context context, int userId) {
1039 if (UserHandle.myUserId() == UserHandle.USER_SYSTEM) {
1040 return userId;
1041 }
1042 throw new SecurityException("Given user id " + userId + " must only be used from "
1043 + "USER_SYSTEM, but current user is " + UserHandle.myUserId());
Clara Bayarrife432e82015-10-12 12:07:02 +01001044 }
1045
1046 /**
1047 * Returns the given user id if it belongs to the current user.
1048 *
1049 * @throws SecurityException if the given userId does not belong to the current user group.
1050 */
Benjamin Franz194300d2016-01-13 12:16:25 +00001051 public static int enforceSameOwner(Context context, int userId) {
Ricky Wai72500162016-06-07 16:54:25 +01001052 final UserManager um = getUserManager(context);
1053 final int[] profileIds = um.getProfileIdsWithDisabled(UserHandle.myUserId());
1054 if (ArrayUtils.contains(profileIds, userId)) {
1055 return userId;
Clara Bayarrife432e82015-10-12 12:07:02 +01001056 }
Ricky Wai72500162016-06-07 16:54:25 +01001057 throw new SecurityException("Given user id " + userId + " does not belong to user "
1058 + UserHandle.myUserId());
Clara Bayarrife432e82015-10-12 12:07:02 +01001059 }
1060
Benjamin Franz194300d2016-01-13 12:16:25 +00001061 /**
1062 * Returns the effective credential owner of the calling user.
1063 */
1064 public static int getCredentialOwnerUserId(Context context) {
1065 return getCredentialOwnerUserId(context, UserHandle.myUserId());
1066 }
1067
1068 /**
1069 * Returns the user id of the credential owner of the given user id.
1070 */
1071 public static int getCredentialOwnerUserId(Context context, int userId) {
1072 UserManager um = getUserManager(context);
1073 return um.getCredentialOwnerProfile(userId);
Andres Morales7bdffd82015-08-04 16:55:00 -07001074 }
Jason Monkdb4ed192015-12-11 16:48:31 -05001075
1076 public static int resolveResource(Context context, int attr) {
1077 TypedValue value = new TypedValue();
1078 context.getTheme().resolveAttribute(attr, value, true);
1079 return value.resourceId;
1080 }
Jason Monkb37e2882016-01-11 14:27:20 -05001081
1082 private static final StringBuilder sBuilder = new StringBuilder(50);
1083 private static final java.util.Formatter sFormatter = new java.util.Formatter(
1084 sBuilder, Locale.getDefault());
1085
1086 public static String formatDateRange(Context context, long start, long end) {
1087 final int flags = FORMAT_SHOW_DATE | FORMAT_ABBREV_MONTH;
1088
1089 synchronized (sBuilder) {
1090 sBuilder.setLength(0);
1091 return DateUtils.formatDateRange(context, sFormatter, start, end, flags, null)
1092 .toString();
1093 }
1094 }
Jason Monk91e2f892016-02-23 15:31:09 -05001095
1096 public static List<String> getNonIndexable(int xml, Context context) {
Jason Monkbe941212016-05-27 12:58:53 -04001097 if (Looper.myLooper() == null) {
1098 // Hack to make sure Preferences can initialize. Prefs expect a looper, but
1099 // don't actually use it for the basic stuff here.
1100 Looper.prepare();
1101 }
Jason Monk9ee80cd2016-03-03 11:21:42 -05001102 final List<String> ret = new ArrayList<>();
Jason Monkbe941212016-05-27 12:58:53 -04001103 PreferenceManager manager = new PreferenceManager(context);
1104 PreferenceScreen screen = manager.inflateFromResource(context, xml, null);
1105 checkPrefs(screen, ret);
Jason Monk91e2f892016-02-23 15:31:09 -05001106
1107 return ret;
1108 }
1109
1110 private static void checkPrefs(PreferenceGroup group, List<String> ret) {
1111 if (group == null) return;
1112 for (int i = 0; i < group.getPreferenceCount(); i++) {
1113 Preference pref = group.getPreference(i);
1114 if (pref instanceof SelfAvailablePreference
1115 && !((SelfAvailablePreference) pref).isAvailable(group.getContext())) {
1116 ret.add(pref.getKey());
1117 if (pref instanceof PreferenceGroup) {
1118 addAll((PreferenceGroup) pref, ret);
1119 }
1120 } else if (pref instanceof PreferenceGroup) {
1121 checkPrefs((PreferenceGroup) pref, ret);
1122 }
1123 }
1124 }
1125
1126 private static void addAll(PreferenceGroup group, List<String> ret) {
1127 if (group == null) return;
1128 for (int i = 0; i < group.getPreferenceCount(); i++) {
1129 Preference pref = group.getPreference(i);
1130 ret.add(pref.getKey());
1131 if (pref instanceof PreferenceGroup) {
1132 addAll((PreferenceGroup) pref, ret);
1133 }
1134 }
1135 }
Udam Saini679f7ad2016-03-25 10:47:00 -07001136
1137 public static boolean isDeviceProvisioned(Context context) {
1138 return Settings.Global.getInt(context.getContentResolver(),
1139 Settings.Global.DEVICE_PROVISIONED, 0) != 0;
1140 }
Ricky Wai616342b2016-04-13 10:40:22 +01001141
Bernard Chau88d523b2016-04-14 15:08:28 +01001142 public static boolean startQuietModeDialogIfNecessary(Context context, UserManager um,
Ricky Wai616342b2016-04-13 10:40:22 +01001143 int userId) {
1144 if (um.isQuietModeEnabled(UserHandle.of(userId))) {
1145 final Intent intent = UnlaunchableAppActivity.createInQuietModeDialogIntent(userId);
1146 context.startActivity(intent);
1147 return true;
1148 }
1149 return false;
1150 }
Sudheer Shankac3eb16e2016-04-21 12:51:43 -07001151
Rubin Xu3231afe2016-08-24 10:15:07 +01001152 public static boolean unlockWorkProfileIfNecessary(Context context, int userId) {
1153 try {
Sudheer Shankaacb1a612016-11-10 15:30:14 -08001154 if (!ActivityManager.getService().isUserRunning(userId,
Rubin Xu3231afe2016-08-24 10:15:07 +01001155 ActivityManager.FLAG_AND_LOCKED)) {
1156 return false;
1157 }
1158 } catch (RemoteException e) {
1159 return false;
1160 }
1161 if (!(new LockPatternUtils(context)).isSecure(userId)) {
1162 return false;
1163 }
Robin Leecccf3242017-02-10 15:32:49 +00001164 return confirmWorkProfileCredentials(context, userId);
1165 }
1166
1167 public static boolean confirmWorkProfileCredentialsIfNecessary(Context context, int userId) {
1168 KeyguardManager km = (KeyguardManager) context.getSystemService(Context.KEYGUARD_SERVICE);
1169 if (!km.isDeviceLocked(userId)) {
1170 return false;
1171 }
1172 return confirmWorkProfileCredentials(context, userId);
1173 }
1174
1175 private static boolean confirmWorkProfileCredentials(Context context, int userId) {
Rubin Xu3231afe2016-08-24 10:15:07 +01001176 final KeyguardManager km = (KeyguardManager) context.getSystemService(
1177 Context.KEYGUARD_SERVICE);
1178 final Intent unlockIntent = km.createConfirmDeviceCredentialIntent(null, null, userId);
1179 if (unlockIntent != null) {
1180 context.startActivity(unlockIntent);
1181 return true;
1182 } else {
1183 return false;
1184 }
Rubin Xu3231afe2016-08-24 10:15:07 +01001185 }
1186
Sudheer Shankac3eb16e2016-04-21 12:51:43 -07001187 public static CharSequence getApplicationLabel(Context context, String packageName) {
1188 try {
1189 final ApplicationInfo appInfo = context.getPackageManager().getApplicationInfo(
1190 packageName,
1191 PackageManager.MATCH_DISABLED_COMPONENTS
Amith Yamasani21556cd2016-11-01 15:49:21 -07001192 | PackageManager.MATCH_ANY_USER);
Sudheer Shankac3eb16e2016-04-21 12:51:43 -07001193 return appInfo.loadLabel(context.getPackageManager());
1194 } catch (PackageManager.NameNotFoundException e) {
1195 Log.w(TAG, "Unable to find info for package: " + packageName);
1196 }
1197 return null;
1198 }
Jason Monk75199542016-05-06 15:09:32 -04001199
Jeff Sharkey4a8136b2016-07-27 12:53:34 -06001200 public static boolean isPackageDirectBootAware(Context context, String packageName) {
1201 try {
1202 final ApplicationInfo ai = context.getPackageManager().getApplicationInfo(
1203 packageName, 0);
1204 return ai.isDirectBootAware() || ai.isPartiallyDirectBootAware();
1205 } catch (NameNotFoundException ignored) {
1206 }
1207 return false;
1208 }
Andre Lago3e398c82016-07-25 14:12:28 +01001209
1210 /**
1211 * Returns a context created from the given context for the given user, or null if it fails
1212 */
1213 public static Context createPackageContextAsUser(Context context, int userId) {
1214 try {
1215 return context.createPackageContextAsUser(
1216 context.getPackageName(), 0 /* flags */, UserHandle.of(userId));
1217 } catch (PackageManager.NameNotFoundException e) {
1218 Log.e(TAG, "Failed to create user context", e);
1219 }
1220 return null;
1221 }
Jeff Sharkeyab508072016-10-11 14:25:22 -06001222
1223 public static FingerprintManager getFingerprintManagerOrNull(Context context) {
1224 if (context.getPackageManager().hasSystemFeature(PackageManager.FEATURE_FINGERPRINT)) {
1225 return context.getSystemService(FingerprintManager.class);
1226 } else {
1227 return null;
1228 }
1229 }
Daniel Nishi31027da2017-01-19 14:03:57 -08001230
Doris Lingdee1a222017-08-31 16:17:30 -07001231 public static FingerprintManagerWrapper getFingerprintManagerWrapperOrNull(Context context) {
Maurice Lame1976ac2017-05-08 21:43:02 -07001232 FingerprintManager fingerprintManager = getFingerprintManagerOrNull(context);
1233 if (fingerprintManager != null) {
1234 return new FingerprintManagerWrapper(fingerprintManager);
1235 } else {
1236 return null;
1237 }
1238 }
1239
Kevin Chyn82792cc2017-07-20 00:15:44 -07001240 public static boolean hasFingerprintHardware(Context context) {
1241 FingerprintManager fingerprintManager = getFingerprintManagerOrNull(context);
1242 return fingerprintManager != null && fingerprintManager.isHardwareDetected();
1243 }
1244
Daniel Nishi31027da2017-01-19 14:03:57 -08001245 /**
1246 * Launches an intent which may optionally have a user id defined.
1247 * @param fragment Fragment to use to launch the activity.
1248 * @param intent Intent to launch.
1249 */
1250 public static void launchIntent(Fragment fragment, Intent intent) {
1251 try {
1252 final int userId = intent.getIntExtra(Intent.EXTRA_USER_ID, -1);
1253
1254 if (userId == -1) {
1255 fragment.startActivity(intent);
1256 } else {
1257 fragment.getActivity().startActivityAsUser(intent, new UserHandle(userId));
1258 }
1259 } catch (ActivityNotFoundException e) {
1260 Log.w(TAG, "No activity found for " + intent);
1261 }
1262 }
1263
Christine Franksc6890ab2017-06-23 14:28:21 -07001264 public static boolean isDemoUser(Context context) {
1265 return UserManager.isDeviceInDemoMode(context) && getUserManager(context).isDemoUser();
1266 }
1267
Justin Klaassen30257272017-08-08 21:58:05 -07001268 public static ComponentName getDeviceOwnerComponent(Context context) {
1269 final DevicePolicyManager dpm = (DevicePolicyManager) context.getSystemService(
1270 Context.DEVICE_POLICY_SERVICE);
1271 return dpm.getDeviceOwnerComponentOnAnyUser();
Christine Franks14782222017-01-23 16:44:02 -08001272 }
Daniel Nishidfed8a22017-01-19 16:32:41 -08001273
1274 /**
1275 * Returns if a given user is a profile of another user.
Christine Franksa0dd9872017-07-11 17:32:57 -07001276 * @param user The user whose profiles wibe checked.
Daniel Nishidfed8a22017-01-19 16:32:41 -08001277 * @param profile The (potential) profile.
1278 * @return if the profile is actually a profile
1279 */
1280 public static boolean isProfileOf(UserInfo user, UserInfo profile) {
1281 return user.id == profile.id ||
1282 (user.profileGroupId != UserInfo.NO_PROFILE_GROUP_ID
1283 && user.profileGroupId == profile.profileGroupId);
1284 }
Daniel Nishi9f60f422017-02-15 15:25:48 -08001285
1286 /**
1287 * Tries to initalize a volume with the given bundle. If it is a valid, private, and readable
1288 * {@link VolumeInfo}, it is returned. If it is not valid, null is returned.
1289 */
1290 @Nullable
1291 public static VolumeInfo maybeInitializeVolume(StorageManager sm, Bundle bundle) {
1292 final String volumeId = bundle.getString(VolumeInfo.EXTRA_VOLUME_ID,
1293 VolumeInfo.ID_PRIVATE_INTERNAL);
1294 VolumeInfo volume = sm.findVolumeById(volumeId);
1295 return isVolumeValid(volume) ? volume : null;
1296 }
1297
jackqdyuleiddba9662017-03-08 19:35:02 -08001298 /**
jackqdyulei00015fb2017-08-22 11:25:30 -07001299 * Return {@code true} if the supplied package is device owner or profile owner of at
1300 * least one user.
1301 * @param userManager used to get profile owner app for each user
1302 * @param devicePolicyManager used to check whether it is device owner app
1303 * @param packageName package to check about
1304 */
1305 public static boolean isProfileOrDeviceOwner(UserManager userManager,
1306 DevicePolicyManagerWrapper devicePolicyManager, String packageName) {
1307 List<UserInfo> userInfos = userManager.getUsers();
1308 if (devicePolicyManager.isDeviceOwnerAppOnAnyUser(packageName)) {
1309 return true;
1310 }
1311 for (int i = 0, size = userInfos.size(); i < size; i++) {
1312 ComponentName cn = devicePolicyManager.getProfileOwnerAsUser(userInfos.get(i).id);
1313 if (cn != null && cn.getPackageName().equals(packageName)) {
1314 return true;
1315 }
1316 }
1317 return false;
1318 }
1319
1320 /**
jackqdyuleiddba9662017-03-08 19:35:02 -08001321 * Return the resource id to represent the install status for an app
1322 */
1323 @StringRes
1324 public static int getInstallationStatus(ApplicationInfo info) {
1325 if ((info.flags & ApplicationInfo.FLAG_INSTALLED) == 0) {
1326 return R.string.not_installed;
1327 }
1328 return info.enabled ? R.string.installed : R.string.disabled;
1329 }
1330
Daniel Nishi9f60f422017-02-15 15:25:48 -08001331 private static boolean isVolumeValid(VolumeInfo volume) {
1332 return (volume != null) && (volume.getType() == VolumeInfo.TYPE_PRIVATE)
1333 && volume.isMountedReadable();
1334 }
jackqdyuleif4c1cef2017-03-31 12:57:10 -07001335
PMS2263a05602017-06-14 07:10:15 +00001336 public static void setEditTextCursorPosition(EditText editText) {
1337 editText.setSelection(editText.getText().length());
1338 }
Felipe Lemebd884502017-09-15 18:16:21 -07001339
1340 /**
1341 * Sets the preference icon with a drawable that is scaled down to to avoid crashing Settings if
1342 * it's too big.
1343 */
1344 public static void setSafeIcon(Preference pref, Drawable icon) {
1345 Drawable safeIcon = icon;
1346 if (icon != null) {
1347 safeIcon = getSafeDrawable(icon, 500, 500);
1348 }
1349 pref.setIcon(safeIcon);
1350 }
1351
1352 /**
1353 * Gets a drawable with a limited size to avoid crashing Settings if it's too big.
1354 *
1355 * @param original original drawable, typically an app icon.
1356 * @param maxWidth maximum width, in pixels.
1357 * @param maxHeight maximum height, in pixels.
1358 */
1359 public static Drawable getSafeDrawable(Drawable original, int maxWidth, int maxHeight) {
1360 final int actualWidth = original.getMinimumWidth();
1361 final int actualHeight = original.getMinimumHeight();
1362
1363 if (actualWidth <= maxWidth && actualHeight <= maxHeight) {
1364 return original;
1365 }
1366
1367 float scaleWidth = ((float) maxWidth) / actualWidth;
1368 float scaleHeight = ((float) maxHeight) / actualHeight;
1369 float scale = Math.min(scaleWidth, scaleHeight);
1370 final int width = (int) (actualWidth * scale);
1371 final int height = (int) (actualHeight * scale);
1372
1373 final Bitmap bitmap;
1374 if (original instanceof BitmapDrawable) {
1375 bitmap = Bitmap.createScaledBitmap(((BitmapDrawable) original).getBitmap(), width,
1376 height, false);
1377 } else {
1378 bitmap = Bitmap.createBitmap(width, height, Bitmap.Config.ARGB_8888);
1379 final Canvas canvas = new Canvas(bitmap);
1380 original.setBounds(0, 0, canvas.getWidth(), canvas.getHeight());
1381 original.draw(canvas);
1382 }
1383 return new BitmapDrawable(null, bitmap);
1384 }
Jeff Sharkey4a8136b2016-07-27 12:53:34 -06001385}