blob: d04ae8d0de9e6fe29d095346c5e7a8f6221cadce [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;
51import android.graphics.BitmapFactory;
Jeff Sharkeyab508072016-10-11 14:25:22 -060052import android.hardware.fingerprint.FingerprintManager;
Amith Yamasanic06d4c42011-02-25 14:35:20 -080053import android.net.ConnectivityManager;
54import android.net.LinkProperties;
Jaewoong Jungc260e6d2016-10-13 14:21:52 -070055import android.net.Network;
Amith Yamasaniae47ef42012-09-16 17:53:35 -070056import android.net.Uri;
Jaewoong Jungc260e6d2016-10-13 14:21:52 -070057import android.net.wifi.WifiManager;
Amith Yamasania4379d62011-07-22 10:34:58 -070058import android.os.BatteryManager;
Anders Hammar1b2dd9032010-04-08 10:03:50 +020059import android.os.Bundle;
Alexandra Gherghina1eb3f312014-06-10 14:01:10 +010060import android.os.IBinder;
Jason Monkb45e27b2015-05-20 13:35:43 -040061import android.os.INetworkManagementService;
Jason Monkbe941212016-05-27 12:58:53 -040062import android.os.Looper;
Alexandra Gherghina1eb3f312014-06-10 14:01:10 +010063import android.os.RemoteException;
Jason Monkb45e27b2015-05-20 13:35:43 -040064import android.os.ServiceManager;
Amith Yamasaniae47ef42012-09-16 17:53:35 -070065import android.os.UserHandle;
66import android.os.UserManager;
Fabrice Di Megliodff3faa2015-02-27 11:14:11 -080067import android.os.storage.StorageManager;
Daniel Nishi9f60f422017-02-15 15:25:48 -080068import android.os.storage.VolumeInfo;
Jeff Sharkeyb654cbb2011-08-18 11:59:19 -070069import android.preference.PreferenceFrameLayout;
Amith Yamasani8d40fac2012-10-23 15:36:16 -070070import android.provider.ContactsContract.CommonDataKinds;
Amith Yamasaniae47ef42012-09-16 17:53:35 -070071import android.provider.ContactsContract.Contacts;
Amith Yamasani8d40fac2012-10-23 15:36:16 -070072import android.provider.ContactsContract.Data;
Amith Yamasaniae47ef42012-09-16 17:53:35 -070073import android.provider.ContactsContract.Profile;
Amith Yamasani8d40fac2012-10-23 15:36:16 -070074import android.provider.ContactsContract.RawContacts;
Udam Saini679f7ad2016-03-25 10:47:00 -070075import android.provider.Settings;
jackqdyuleiddba9662017-03-08 19:35:02 -080076import android.support.annotation.StringRes;
Jason Monk39b46742015-09-10 15:52:51 -040077import android.support.v7.preference.Preference;
78import android.support.v7.preference.PreferenceGroup;
Jason Monk91e2f892016-02-23 15:31:09 -050079import android.support.v7.preference.PreferenceManager;
80import android.support.v7.preference.PreferenceScreen;
Amith Yamasani60133dd2010-09-11 14:17:31 -070081import android.telephony.TelephonyManager;
Julia Reynoldsce25af42015-07-08 16:56:31 -040082import android.text.Spannable;
83import android.text.SpannableString;
Anders Hammar1b2dd9032010-04-08 10:03:50 +020084import android.text.TextUtils;
Jason Monkb37e2882016-01-11 14:27:20 -050085import android.text.format.DateUtils;
Julia Reynoldsce25af42015-07-08 16:56:31 -040086import android.text.style.TtsSpan;
Christopher Tatea08a2252015-07-01 16:52:43 -070087import android.util.ArraySet;
Alexandra Gherghina1eb3f312014-06-10 14:01:10 +010088import android.util.Log;
Zoltan Szatmary-Bane5814ff2014-12-19 16:27:45 +000089import android.util.SparseArray;
Jason Monkdb4ed192015-12-11 16:48:31 -050090import android.util.TypedValue;
Zoltan Szatmary-Ban3af2e4c2014-12-19 17:17:23 +000091import android.view.LayoutInflater;
Jeff Sharkeyb654cbb2011-08-18 11:59:19 -070092import android.view.View;
93import android.view.ViewGroup;
Jason Monkb5aa73f2015-03-31 12:59:33 -040094import android.view.animation.Animation;
95import android.view.animation.Animation.AnimationListener;
96import android.view.animation.AnimationUtils;
Jeff Sharkeyb654cbb2011-08-18 11:59:19 -070097import android.widget.ListView;
98import android.widget.TabWidget;
Fan Zhangcc335d92016-09-29 14:37:14 -070099
Ricky Wai616342b2016-04-13 10:40:22 +0100100import com.android.internal.app.UnlaunchableAppActivity;
Ricky Wai72500162016-06-07 16:54:25 +0100101import com.android.internal.util.ArrayUtils;
Alexandra Gherghinabc6e78f2014-09-03 10:22:09 +0100102import com.android.internal.util.UserIcons;
Rubin Xu3231afe2016-08-24 10:15:07 +0100103import com.android.internal.widget.LockPatternUtils;
Daisuke Miyakawaa2633d02010-09-15 20:09:12 -0700104
Amith Yamasaniae47ef42012-09-16 17:53:35 -0700105import java.io.IOException;
106import java.io.InputStream;
Amith Yamasanic06d4c42011-02-25 14:35:20 -0800107import java.net.InetAddress;
Alexandra Gherghina80e1f1b2014-07-31 14:56:33 +0100108import java.util.ArrayList;
Amith Yamasanic06d4c42011-02-25 14:35:20 -0800109import java.util.Iterator;
Daisuke Miyakawaa2633d02010-09-15 20:09:12 -0700110import java.util.List;
Jean Chalard71ad1f42011-05-12 15:06:16 +0900111import java.util.Locale;
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800112
Jason Monk27985e12016-01-08 14:13:05 -0500113public final class Utils extends com.android.settingslib.Utils {
114
Alexandra Gherghina1eb3f312014-06-10 14:01:10 +0100115 private static final String TAG = "Settings";
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100116
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800117 /**
118 * Set the preference's title to the matching activity's label.
119 */
120 public static final int UPDATE_PREFERENCE_FLAG_SET_TITLE_TO_MATCHING_ACTIVITY = 1;
121
122 /**
Shuhrat Dehkanov96577682012-10-03 12:24:07 +0900123 * The opacity level of a disabled icon.
124 */
125 public static final float DISABLED_ALPHA = 0.4f;
126
127 /**
Dianne Hackborn68f005f2014-06-18 18:29:12 -0700128 * Color spectrum to use to indicate badness. 0 is completely transparent (no data),
129 * 1 is most bad (red), the last value is least bad (green).
130 */
131 public static final int[] BADNESS_COLORS = new int[] {
132 0x00000000, 0xffc43828, 0xffe54918, 0xfff47b00,
133 0xfffabf2c, 0xff679e37, 0xff0a7f42
134 };
135
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100136 private static final String SETTINGS_PACKAGE_NAME = "com.android.settings";
137
Elliott Hughes7253df32014-09-02 17:10:14 -0700138 private static final int SECONDS_PER_MINUTE = 60;
139 private static final int SECONDS_PER_HOUR = 60 * 60;
140 private static final int SECONDS_PER_DAY = 24 * 60 * 60;
141
Jason Monkbeb171d2015-05-21 15:24:37 -0400142 public static final String OS_PKG = "os";
143
Zoltan Szatmary-Bane5814ff2014-12-19 16:27:45 +0000144 private static SparseArray<Bitmap> sDarkDefaultUserBitmapCache = new SparseArray<Bitmap>();
145
Anders Hammar1b2dd9032010-04-08 10:03:50 +0200146 /**
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800147 * Finds a matching activity for a preference's intent. If a matching
148 * activity is not found, it will remove the preference.
Ying Wanga7188322010-01-04 18:45:10 -0800149 *
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800150 * @param context The context.
151 * @param parentPreferenceGroup The preference group that contains the
152 * preference whose intent is being resolved.
153 * @param preferenceKey The key of the preference whose intent is being
154 * resolved.
155 * @param flags 0 or one or more of
156 * {@link #UPDATE_PREFERENCE_FLAG_SET_TITLE_TO_MATCHING_ACTIVITY}
157 * .
158 * @return Whether an activity was found. If false, the preference was
159 * removed.
160 */
161 public static boolean updatePreferenceToSpecificActivityOrRemove(Context context,
162 PreferenceGroup parentPreferenceGroup, String preferenceKey, int flags) {
Ying Wanga7188322010-01-04 18:45:10 -0800163
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800164 Preference preference = parentPreferenceGroup.findPreference(preferenceKey);
165 if (preference == null) {
166 return false;
167 }
Ying Wanga7188322010-01-04 18:45:10 -0800168
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800169 Intent intent = preference.getIntent();
170 if (intent != null) {
171 // Find the activity that is in the system image
172 PackageManager pm = context.getPackageManager();
173 List<ResolveInfo> list = pm.queryIntentActivities(intent, 0);
174 int listSize = list.size();
175 for (int i = 0; i < listSize; i++) {
176 ResolveInfo resolveInfo = list.get(i);
177 if ((resolveInfo.activityInfo.applicationInfo.flags & ApplicationInfo.FLAG_SYSTEM)
178 != 0) {
Ying Wanga7188322010-01-04 18:45:10 -0800179
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800180 // Replace the intent with this specific activity
181 preference.setIntent(new Intent().setClassName(
182 resolveInfo.activityInfo.packageName,
183 resolveInfo.activityInfo.name));
184
185 if ((flags & UPDATE_PREFERENCE_FLAG_SET_TITLE_TO_MATCHING_ACTIVITY) != 0) {
186 // Set the preference title to the activity's label
187 preference.setTitle(resolveInfo.loadLabel(pm));
188 }
Ying Wanga7188322010-01-04 18:45:10 -0800189
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800190 return true;
191 }
192 }
193 }
194
195 // Did not find a matching activity, so remove the preference
196 parentPreferenceGroup.removePreference(preference);
Ying Wanga7188322010-01-04 18:45:10 -0800197
Shuhrat Dehkanov7dc567a2012-04-23 01:59:56 +0900198 return false;
The Android Open Source Projectafc4ab22009-03-03 19:32:34 -0800199 }
Ying Wanga7188322010-01-04 18:45:10 -0800200
Anders Hammar1b2dd9032010-04-08 10:03:50 +0200201 /**
Benjamin Franz194300d2016-01-13 12:16:25 +0000202 * Returns the UserManager for a given context
203 *
204 * @throws IllegalStateException if no UserManager could be retrieved.
205 */
206 public static UserManager getUserManager(Context context) {
207 UserManager um = UserManager.get(context);
208 if (um == null) {
209 throw new IllegalStateException("Unable to load UserManager");
210 }
211 return um;
212 }
213
214 /**
Ying Wanga7188322010-01-04 18:45:10 -0800215 * Returns true if Monkey is running.
216 */
217 public static boolean isMonkeyRunning() {
Amith Yamasaniae697552011-09-27 11:33:17 -0700218 return ActivityManager.isUserAMonkey();
Ying Wanga7188322010-01-04 18:45:10 -0800219 }
Amith Yamasani60133dd2010-09-11 14:17:31 -0700220
221 /**
222 * Returns whether the device is voice-capable (meaning, it is also a phone).
223 */
224 public static boolean isVoiceCapable(Context context) {
225 TelephonyManager telephony =
226 (TelephonyManager) context.getSystemService(Context.TELEPHONY_SERVICE);
227 return telephony != null && telephony.isVoiceCapable();
228 }
Amith Yamasani0f85c482011-02-23 17:19:11 -0800229
Robert Greenwalt8af88fb2011-08-31 11:17:47 -0700230 public static boolean isWifiOnly(Context context) {
231 ConnectivityManager cm = (ConnectivityManager)context.getSystemService(
232 Context.CONNECTIVITY_SERVICE);
233 return (cm.isNetworkSupported(ConnectivityManager.TYPE_MOBILE) == false);
Amith Yamasani0f85c482011-02-23 17:19:11 -0800234 }
Amith Yamasanic06d4c42011-02-25 14:35:20 -0800235
236 /**
237 * Returns the WIFI IP Addresses, if any, taking into account IPv4 and IPv6 style addresses.
238 * @param context the application context
Lorenzo Colitti769f0692013-08-01 17:30:07 +0900239 * @return the formatted and newline-separated IP addresses, or null if none.
Amith Yamasanic06d4c42011-02-25 14:35:20 -0800240 */
241 public static String getWifiIpAddresses(Context context) {
Jaewoong Jungc260e6d2016-10-13 14:21:52 -0700242 WifiManager wifiManager = context.getSystemService(WifiManager.class);
243 Network currentNetwork = wifiManager.getCurrentNetwork();
244 if (currentNetwork != null) {
245 ConnectivityManager cm = (ConnectivityManager)
Amith Yamasanic06d4c42011-02-25 14:35:20 -0800246 context.getSystemService(Context.CONNECTIVITY_SERVICE);
Jaewoong Jungc260e6d2016-10-13 14:21:52 -0700247 LinkProperties prop = cm.getLinkProperties(currentNetwork);
248 return formatIpAddresses(prop);
249 }
250 return null;
Amith Yamasani6822b742011-10-17 16:41:00 -0700251 }
252
253 /**
254 * Returns the default link's IP addresses, if any, taking into account IPv4 and IPv6 style
255 * addresses.
Lorenzo Colitti769f0692013-08-01 17:30:07 +0900256 * @return the formatted and newline-separated IP addresses, or null if none.
Amith Yamasani6822b742011-10-17 16:41:00 -0700257 */
Lorenzo Colitti6eb6a902013-11-08 03:53:29 +0900258 public static String getDefaultIpAddresses(ConnectivityManager cm) {
Amith Yamasani6822b742011-10-17 16:41:00 -0700259 LinkProperties prop = cm.getActiveLinkProperties();
260 return formatIpAddresses(prop);
261 }
262
263 private static String formatIpAddresses(LinkProperties prop) {
Amith Yamasanic06d4c42011-02-25 14:35:20 -0800264 if (prop == null) return null;
Lorenzo Colitti769f0692013-08-01 17:30:07 +0900265 Iterator<InetAddress> iter = prop.getAllAddresses().iterator();
Amith Yamasanic06d4c42011-02-25 14:35:20 -0800266 // If there are no entries, return null
267 if (!iter.hasNext()) return null;
268 // Concatenate all available addresses, comma separated
269 String addresses = "";
270 while (iter.hasNext()) {
271 addresses += iter.next().getHostAddress();
Lorenzo Colitti769f0692013-08-01 17:30:07 +0900272 if (iter.hasNext()) addresses += "\n";
Amith Yamasanic06d4c42011-02-25 14:35:20 -0800273 }
274 return addresses;
275 }
Jean Chalard71ad1f42011-05-12 15:06:16 +0900276
277 public static Locale createLocaleFromString(String localeStr) {
278 // TODO: is there a better way to actually construct a locale that will match?
279 // The main problem is, on top of Java specs, locale.toString() and
280 // new Locale(locale.toString()).toString() do not return equal() strings in
281 // many cases, because the constructor takes the only string as the language
282 // code. So : new Locale("en", "US").toString() => "en_US"
283 // And : new Locale("en_US").toString() => "en_us"
284 if (null == localeStr)
285 return Locale.getDefault();
286 String[] brokenDownLocale = localeStr.split("_", 3);
287 // split may not return a 0-length array.
288 if (1 == brokenDownLocale.length) {
289 return new Locale(brokenDownLocale[0]);
290 } else if (2 == brokenDownLocale.length) {
291 return new Locale(brokenDownLocale[0], brokenDownLocale[1]);
292 } else {
293 return new Locale(brokenDownLocale[0], brokenDownLocale[1], brokenDownLocale[2]);
294 }
295 }
Amith Yamasania4379d62011-07-22 10:34:58 -0700296
Jaewan Kima3fe77b2013-06-04 21:17:40 +0900297 public static boolean isBatteryPresent(Intent batteryChangedIntent) {
298 return batteryChangedIntent.getBooleanExtra(BatteryManager.EXTRA_PRESENT, true);
299 }
300
Amith Yamasania4379d62011-07-22 10:34:58 -0700301 public static String getBatteryPercentage(Intent batteryChangedIntent) {
Elliott Hughes7253df32014-09-02 17:10:14 -0700302 return formatPercentage(getBatteryLevel(batteryChangedIntent));
Dianne Hackborn525f2bd2014-04-29 11:24:06 -0700303 }
304
Jeff Sharkeyb654cbb2011-08-18 11:59:19 -0700305 /**
306 * Prepare a custom preferences layout, moving padding to {@link ListView}
307 * when outside scrollbars are requested. Usually used to display
308 * {@link ListView} and {@link TabWidget} with correct padding.
309 */
Jeff Sharkey5d706792011-09-08 18:57:17 -0700310 public static void prepareCustomPreferencesList(
Jeff Sharkey97d07fa2012-11-30 12:36:53 -0800311 ViewGroup parent, View child, View list, boolean ignoreSidePadding) {
Jeff Sharkeyb654cbb2011-08-18 11:59:19 -0700312 final boolean movePadding = list.getScrollBarStyle() == View.SCROLLBARS_OUTSIDE_OVERLAY;
Fabrice Di Meglio97a18c82014-07-18 19:12:36 -0700313 if (movePadding) {
Jeff Sharkeyb654cbb2011-08-18 11:59:19 -0700314 final Resources res = list.getResources();
Amith Yamasani56f51a82013-08-05 10:07:23 -0700315 final int paddingSide = res.getDimensionPixelSize(R.dimen.settings_side_margin);
Jeff Sharkeyb654cbb2011-08-18 11:59:19 -0700316 final int paddingBottom = res.getDimensionPixelSize(
317 com.android.internal.R.dimen.preference_fragment_padding_bottom);
Jeff Sharkey5d706792011-09-08 18:57:17 -0700318
Fabrice Di Meglio97a18c82014-07-18 19:12:36 -0700319 if (parent instanceof PreferenceFrameLayout) {
320 ((PreferenceFrameLayout.LayoutParams) child.getLayoutParams()).removeBorders = true;
321
322 final int effectivePaddingSide = ignoreSidePadding ? 0 : paddingSide;
323 list.setPaddingRelative(effectivePaddingSide, 0, effectivePaddingSide, paddingBottom);
324 } else {
325 list.setPaddingRelative(paddingSide, 0, paddingSide, paddingBottom);
326 }
Jeff Sharkeyb654cbb2011-08-18 11:59:19 -0700327 }
328 }
Jeff Sharkeya83a24f2011-09-16 01:52:39 -0700329
Fabrice Di Meglio0f4a7792014-07-28 18:25:14 -0700330 public static void forceCustomPadding(View view, boolean additive) {
Fabrice Di Meglio38ba9a22014-07-18 19:58:50 -0700331 final Resources res = view.getResources();
332 final int paddingSide = res.getDimensionPixelSize(R.dimen.settings_side_margin);
Fabrice Di Meglio0f4a7792014-07-28 18:25:14 -0700333
334 final int paddingStart = paddingSide + (additive ? view.getPaddingStart() : 0);
335 final int paddingEnd = paddingSide + (additive ? view.getPaddingEnd() : 0);
Fabrice Di Meglio38ba9a22014-07-18 19:58:50 -0700336 final int paddingBottom = res.getDimensionPixelSize(
337 com.android.internal.R.dimen.preference_fragment_padding_bottom);
338
Fabrice Di Meglio0f4a7792014-07-28 18:25:14 -0700339 view.setPaddingRelative(paddingStart, 0, paddingEnd, paddingBottom);
Fabrice Di Meglio38ba9a22014-07-18 19:58:50 -0700340 }
341
Amith Yamasaniae47ef42012-09-16 17:53:35 -0700342 /* Used by UserSettings as well. Call this on a non-ui thread. */
Sudheer Shanka71caf692016-04-14 16:50:14 -0700343 public static void copyMeProfilePhoto(Context context, UserInfo user) {
Amith Yamasaniae47ef42012-09-16 17:53:35 -0700344 Uri contactUri = Profile.CONTENT_URI;
345
Sudheer Shanka71caf692016-04-14 16:50:14 -0700346 int userId = user != null ? user.id : UserHandle.myUserId();
347
Amith Yamasaniae47ef42012-09-16 17:53:35 -0700348 InputStream avatarDataStream = Contacts.openContactPhotoInputStream(
349 context.getContentResolver(),
350 contactUri, true);
351 // If there's no profile photo, assign a default avatar
352 if (avatarDataStream == null) {
Sudheer Shanka71caf692016-04-14 16:50:14 -0700353 assignDefaultPhoto(context, userId);
Sudheer Shanka39975a62016-04-15 17:20:54 -0700354 return;
Amith Yamasaniae47ef42012-09-16 17:53:35 -0700355 }
Sudheer Shanka39975a62016-04-15 17:20:54 -0700356
357 UserManager um = (UserManager) context.getSystemService(Context.USER_SERVICE);
358 Bitmap icon = BitmapFactory.decodeStream(avatarDataStream);
359 um.setUserIcon(userId, icon);
Amith Yamasaniae47ef42012-09-16 17:53:35 -0700360 try {
Amith Yamasanif34a85d2012-09-17 18:31:45 -0700361 avatarDataStream.close();
362 } catch (IOException ioe) { }
Sudheer Shanka71caf692016-04-14 16:50:14 -0700363 }
364
jackqdyulei8164c642016-12-27 10:15:27 -0800365 /**
366 * Assign the default photo to user with {@paramref userId}
367 * @param context used to get the {@link UserManager}
368 * @param userId used to get the icon bitmap
369 * @return true if assign photo successfully, false if failed
370 */
371 public static boolean assignDefaultPhoto(Context context, int userId) {
372 if (context == null) {
373 return false;
374 }
Sudheer Shanka71caf692016-04-14 16:50:14 -0700375 UserManager um = (UserManager) context.getSystemService(Context.USER_SERVICE);
376 Bitmap bitmap = getDefaultUserIconAsBitmap(userId);
377 um.setUserIcon(userId, bitmap);
jackqdyulei8164c642016-12-27 10:15:27 -0800378
379 return true;
Amith Yamasaniae47ef42012-09-16 17:53:35 -0700380 }
381
Amith Yamasani8d40fac2012-10-23 15:36:16 -0700382 public static String getMeProfileName(Context context, boolean full) {
383 if (full) {
384 return getProfileDisplayName(context);
385 } else {
386 return getShorterNameIfPossible(context);
Amith Yamasaniae47ef42012-09-16 17:53:35 -0700387 }
Amith Yamasani8d40fac2012-10-23 15:36:16 -0700388 }
389
390 private static String getShorterNameIfPossible(Context context) {
391 final String given = getLocalProfileGivenName(context);
392 return !TextUtils.isEmpty(given) ? given : getProfileDisplayName(context);
393 }
394
395 private static String getLocalProfileGivenName(Context context) {
396 final ContentResolver cr = context.getContentResolver();
397
398 // Find the raw contact ID for the local ME profile raw contact.
399 final long localRowProfileId;
400 final Cursor localRawProfile = cr.query(
401 Profile.CONTENT_RAW_CONTACTS_URI,
402 new String[] {RawContacts._ID},
403 RawContacts.ACCOUNT_TYPE + " IS NULL AND " +
404 RawContacts.ACCOUNT_NAME + " IS NULL",
405 null, null);
406 if (localRawProfile == null) return null;
Amith Yamasaniae47ef42012-09-16 17:53:35 -0700407
408 try {
Amith Yamasani8d40fac2012-10-23 15:36:16 -0700409 if (!localRawProfile.moveToFirst()) {
410 return null;
Amith Yamasaniae47ef42012-09-16 17:53:35 -0700411 }
Amith Yamasani8d40fac2012-10-23 15:36:16 -0700412 localRowProfileId = localRawProfile.getLong(0);
Amith Yamasaniae47ef42012-09-16 17:53:35 -0700413 } finally {
Amith Yamasani8d40fac2012-10-23 15:36:16 -0700414 localRawProfile.close();
Amith Yamasaniae47ef42012-09-16 17:53:35 -0700415 }
Amith Yamasani8d40fac2012-10-23 15:36:16 -0700416
417 // Find the structured name for the raw contact.
418 final Cursor structuredName = cr.query(
419 Profile.CONTENT_URI.buildUpon().appendPath(Contacts.Data.CONTENT_DIRECTORY).build(),
420 new String[] {CommonDataKinds.StructuredName.GIVEN_NAME,
421 CommonDataKinds.StructuredName.FAMILY_NAME},
422 Data.RAW_CONTACT_ID + "=" + localRowProfileId,
423 null, null);
424 if (structuredName == null) return null;
425
426 try {
427 if (!structuredName.moveToFirst()) {
428 return null;
429 }
430 String partialName = structuredName.getString(0);
431 if (TextUtils.isEmpty(partialName)) {
432 partialName = structuredName.getString(1);
433 }
434 return partialName;
435 } finally {
436 structuredName.close();
437 }
438 }
439
440 private static final String getProfileDisplayName(Context context) {
441 final ContentResolver cr = context.getContentResolver();
442 final Cursor profile = cr.query(Profile.CONTENT_URI,
443 new String[] {Profile.DISPLAY_NAME}, null, null, null);
444 if (profile == null) return null;
445
446 try {
447 if (!profile.moveToFirst()) {
448 return null;
449 }
450 return profile.getString(0);
451 } finally {
452 profile.close();
453 }
Amith Yamasaniae47ef42012-09-16 17:53:35 -0700454 }
Amith Yamasani9627a8e2012-09-23 12:54:14 -0700455
456 /** Not global warming, it's global change warning. */
457 public static Dialog buildGlobalChangeWarningDialog(final Context context, int titleResId,
458 final Runnable positiveAction) {
459 final AlertDialog.Builder builder = new AlertDialog.Builder(context);
460 builder.setTitle(titleResId);
461 builder.setMessage(R.string.global_change_warning);
462 builder.setPositiveButton(android.R.string.ok, new DialogInterface.OnClickListener() {
463 @Override
464 public void onClick(DialogInterface dialog, int which) {
465 positiveAction.run();
466 }
467 });
468 builder.setNegativeButton(android.R.string.cancel, null);
469
470 return builder.create();
471 }
472
473 public static boolean hasMultipleUsers(Context context) {
474 return ((UserManager) context.getSystemService(Context.USER_SERVICE))
475 .getUsers().size() > 1;
476 }
Fabrice Di Meglio769630c2014-04-24 14:48:48 -0700477
478 /**
479 * Start a new instance of the activity, showing only the given fragment.
480 * When launched in this mode, the given preference fragment will be instantiated and fill the
481 * entire activity.
482 *
483 * @param context The context.
Fabrice Di Meglio93b77b72014-05-17 00:01:07 +0000484 * @param fragmentName The name of the fragment to display.
Fabrice Di Meglio769630c2014-04-24 14:48:48 -0700485 * @param args Optional arguments to supply to the fragment.
Fabrice Di Meglioa9e77992014-06-09 12:52:24 -0700486 * @param resultTo Option fragment that should receive the result of the activity launch.
487 * @param resultRequestCode If resultTo is non-null, this is the request code in which
488 * to report the result.
489 * @param titleResId resource id for the String to display for the title of this set
490 * of preferences.
Fabrice Di Meglio769630c2014-04-24 14:48:48 -0700491 * @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
Fabrice Di Meglio769630c2014-04-24 14:48:48 -0700493 */
Fabrice Di Meglio93b77b72014-05-17 00:01:07 +0000494 public static void startWithFragment(Context context, String fragmentName, Bundle args,
Alexandra Gherghina62464b82014-08-11 12:40:13 +0100495 Fragment resultTo, int resultRequestCode, int titleResId,
Fan Zhangc6ca3142017-02-14 15:02:35 -0800496 CharSequence title, int metricsCategory) {
Fabrice Di Meglio0d643fd2014-06-16 20:11:27 -0700497 startWithFragment(context, fragmentName, args, resultTo, resultRequestCode,
Fan Zhangc6ca3142017-02-14 15:02:35 -0800498 null /* titleResPackageName */, titleResId, title, false /* not a shortcut */,
499 metricsCategory);
Alexandra Gherghina62464b82014-08-11 12:40:13 +0100500 }
501
502 /**
503 * Start a new instance of the activity, showing only the given fragment.
504 * When launched in this mode, the given preference fragment will be instantiated and fill the
505 * entire activity.
506 *
507 * @param context The context.
508 * @param fragmentName The name of the fragment to display.
509 * @param args Optional arguments to supply to the fragment.
510 * @param resultTo Option fragment that should receive the result of the activity launch.
511 * @param resultRequestCode If resultTo is non-null, this is the request code in which
512 * to report the result.
513 * @param titleResPackageName Optional package name for the resource id of the title.
514 * @param titleResId resource id for the String to display for the title of this set
515 * of preferences.
516 * @param title String to display for the title of this set of preferences.
Fan Zhangc6ca3142017-02-14 15:02:35 -0800517 * @param metricsCategory The current metricsCategory for logging source when fragment starts
Alexandra Gherghina62464b82014-08-11 12:40:13 +0100518 */
519 public static void startWithFragment(Context context, String fragmentName, Bundle args,
520 Fragment resultTo, int resultRequestCode, String titleResPackageName, int titleResId,
Fan Zhangc6ca3142017-02-14 15:02:35 -0800521 CharSequence title, int metricsCategory) {
Alexandra Gherghina62464b82014-08-11 12:40:13 +0100522 startWithFragment(context, fragmentName, args, resultTo, resultRequestCode,
Fan Zhangc6ca3142017-02-14 15:02:35 -0800523 titleResPackageName, titleResId, title, false /* not a shortcut */,
524 metricsCategory);
Fabrice Di Meglio0d643fd2014-06-16 20:11:27 -0700525 }
526
527 public static void startWithFragment(Context context, String fragmentName, Bundle args,
Alexandra Gherghina62464b82014-08-11 12:40:13 +0100528 Fragment resultTo, int resultRequestCode, int titleResId,
Fan Zhangc6ca3142017-02-14 15:02:35 -0800529 CharSequence title, boolean isShortcut, int metricsCategory) {
Alexandra Gherghina62464b82014-08-11 12:40:13 +0100530 Intent intent = onBuildStartFragmentIntent(context, fragmentName, args,
Fan Zhangc6ca3142017-02-14 15:02:35 -0800531 null /* titleResPackageName */, titleResId, title, isShortcut, metricsCategory);
Alexandra Gherghina62464b82014-08-11 12:40:13 +0100532 if (resultTo == null) {
533 context.startActivity(intent);
534 } else {
Doris Ling36e953f2016-08-12 15:25:00 -0700535 resultTo.getActivity().startActivityForResult(intent, resultRequestCode);
Alexandra Gherghina62464b82014-08-11 12:40:13 +0100536 }
537 }
538
539 public static void startWithFragment(Context context, String fragmentName, Bundle args,
540 Fragment resultTo, int resultRequestCode, String titleResPackageName, int titleResId,
Fan Zhangc6ca3142017-02-14 15:02:35 -0800541 CharSequence title, boolean isShortcut, int metricsCategory) {
Alexandra Gherghina62464b82014-08-11 12:40:13 +0100542 Intent intent = onBuildStartFragmentIntent(context, fragmentName, args, titleResPackageName,
Fan Zhangc6ca3142017-02-14 15:02:35 -0800543 titleResId, title, isShortcut, metricsCategory);
Fabrice Di Meglio769630c2014-04-24 14:48:48 -0700544 if (resultTo == null) {
545 context.startActivity(intent);
546 } else {
547 resultTo.startActivityForResult(intent, resultRequestCode);
548 }
549 }
550
Zoltan Szatmary-Ban7a2ccf22014-09-18 10:26:11 +0100551 public static void startWithFragmentAsUser(Context context, String fragmentName, Bundle args,
Fan Zhangc6ca3142017-02-14 15:02:35 -0800552 int titleResId, CharSequence title, boolean isShortcut, int metricsCategory,
Alexandra Gherghina62464b82014-08-11 12:40:13 +0100553 UserHandle userHandle) {
Victor Chang16da2aa2016-03-11 19:44:56 +0000554 // workaround to avoid crash in b/17523189
555 if (userHandle.getIdentifier() == UserHandle.myUserId()) {
Fan Zhangc6ca3142017-02-14 15:02:35 -0800556 startWithFragment(context, fragmentName, args, null, 0, titleResId, title, isShortcut,
557 metricsCategory);
Victor Chang16da2aa2016-03-11 19:44:56 +0000558 } else {
559 Intent intent = onBuildStartFragmentIntent(context, fragmentName, args,
Fan Zhangc6ca3142017-02-14 15:02:35 -0800560 null /* titleResPackageName */, titleResId, title, isShortcut, metricsCategory);
Victor Chang16da2aa2016-03-11 19:44:56 +0000561 intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
562 intent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TASK);
563 context.startActivityAsUser(intent, userHandle);
564 }
Zoltan Szatmary-Ban7a2ccf22014-09-18 10:26:11 +0100565 }
566
Fabrice Di Meglio769630c2014-04-24 14:48:48 -0700567 /**
568 * Build an Intent to launch a new activity showing the selected fragment.
569 * The implementation constructs an Intent that re-launches the current activity with the
570 * appropriate arguments to display the fragment.
571 *
Fabrice Di Meglio0d643fd2014-06-16 20:11:27 -0700572 *
Fabrice Di Meglio769630c2014-04-24 14:48:48 -0700573 * @param context The Context.
Fabrice Di Meglio93b77b72014-05-17 00:01:07 +0000574 * @param fragmentName The name of the fragment to display.
Fabrice Di Meglio769630c2014-04-24 14:48:48 -0700575 * @param args Optional arguments to supply to the fragment.
Alexandra Gherghina62464b82014-08-11 12:40:13 +0100576 * @param titleResPackageName Optional package name for the resource id of the title.
Fabrice Di Meglioa9e77992014-06-09 12:52:24 -0700577 * @param titleResId Optional title resource id to show for this item.
Fabrice Di Meglio769630c2014-04-24 14:48:48 -0700578 * @param title Optional title to show for this item.
Fabrice Di Meglio0d643fd2014-06-16 20:11:27 -0700579 * @param isShortcut tell if this is a Launcher Shortcut or not
Fan Zhangc6ca3142017-02-14 15:02:35 -0800580 * @param sourceMetricsCategory The context (source) from which an action is performed
Fabrice Di Meglio769630c2014-04-24 14:48:48 -0700581 * @return Returns an Intent that can be launched to display the given
582 * fragment.
583 */
Fabrice Di Meglio93b77b72014-05-17 00:01:07 +0000584 public static Intent onBuildStartFragmentIntent(Context context, String fragmentName,
Alexandra Gherghina62464b82014-08-11 12:40:13 +0100585 Bundle args, String titleResPackageName, int titleResId, CharSequence title,
Fan Zhangc6ca3142017-02-14 15:02:35 -0800586 boolean isShortcut, int sourceMetricsCategory) {
Fabrice Di Meglio769630c2014-04-24 14:48:48 -0700587 Intent intent = new Intent(Intent.ACTION_MAIN);
588 intent.setClass(context, SubSettings.class);
Fabrice Di Meglio93b77b72014-05-17 00:01:07 +0000589 intent.putExtra(SettingsActivity.EXTRA_SHOW_FRAGMENT, fragmentName);
Fabrice Di Meglio769630c2014-04-24 14:48:48 -0700590 intent.putExtra(SettingsActivity.EXTRA_SHOW_FRAGMENT_ARGUMENTS, args);
Alexandra Gherghina62464b82014-08-11 12:40:13 +0100591 intent.putExtra(SettingsActivity.EXTRA_SHOW_FRAGMENT_TITLE_RES_PACKAGE_NAME,
592 titleResPackageName);
Fabrice Di Meglioa9e77992014-06-09 12:52:24 -0700593 intent.putExtra(SettingsActivity.EXTRA_SHOW_FRAGMENT_TITLE_RESID, titleResId);
Fabrice Di Meglio769630c2014-04-24 14:48:48 -0700594 intent.putExtra(SettingsActivity.EXTRA_SHOW_FRAGMENT_TITLE, title);
Fabrice Di Meglio0d643fd2014-06-16 20:11:27 -0700595 intent.putExtra(SettingsActivity.EXTRA_SHOW_FRAGMENT_AS_SHORTCUT, isShortcut);
Fan Zhangc6ca3142017-02-14 15:02:35 -0800596 intent.putExtra(SettingsActivity.EXTRA_SOURCE_METRICS_CATEGORY, sourceMetricsCategory);
Fabrice Di Meglio769630c2014-04-24 14:48:48 -0700597 return intent;
598 }
Alexandra Gherghina3939cd72014-06-04 10:02:55 +0100599
600 /**
601 * Returns the managed profile of the current user or null if none found.
602 */
603 public static UserHandle getManagedProfile(UserManager userManager) {
604 List<UserHandle> userProfiles = userManager.getUserProfiles();
605 final int count = userProfiles.size();
606 for (int i = 0; i < count; i++) {
607 final UserHandle profile = userProfiles.get(i);
608 if (profile.getIdentifier() == userManager.getUserHandle()) {
609 continue;
610 }
611 final UserInfo userInfo = userManager.getUserInfo(profile.getIdentifier());
612 if (userInfo.isManagedProfile()) {
613 return profile;
614 }
615 }
616 return null;
617 }
618
619 /**
Clara Bayarri462cce12016-02-18 12:09:21 +0000620 * Retrieves the id for the given user's managed profile.
621 *
622 * @return the managed profile id or UserHandle.USER_NULL if there is none.
623 */
624 public static int getManagedProfileId(UserManager um, int parentUserId) {
Fyodor Kupolov4a4af5a2016-04-07 16:46:18 -0700625 int[] profileIds = um.getProfileIdsWithDisabled(parentUserId);
626 for (int profileId : profileIds) {
627 if (profileId != parentUserId) {
628 return profileId;
Clara Bayarri462cce12016-02-18 12:09:21 +0000629 }
630 }
631 return UserHandle.USER_NULL;
632 }
633
634 /**
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100635 * Returns the target user for a Settings activity.
Tony Mak8f41b9b2016-11-23 11:36:18 +0000636 * <p>
637 * User would be retrieved in this order:
638 * <ul>
639 * <li> If this activity is launched from other user, return that user id.
640 * <li> If this is launched from the Settings app in same user, return the user contained as an
641 * extra in the arguments or intent extras.
642 * <li> Otherwise, return UserHandle.myUserId().
643 * </ul>
644 * <p>
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100645 * Note: This is secure in the sense that it only returns a target user different to the current
646 * one if the app launching this activity is the Settings app itself, running in the same user
647 * 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 +0100648 */
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100649 public static UserHandle getSecureTargetUser(IBinder activityToken,
Tony Mak8f41b9b2016-11-23 11:36:18 +0000650 UserManager um, @Nullable Bundle arguments, @Nullable Bundle intentExtras) {
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100651 UserHandle currentUser = new UserHandle(UserHandle.myUserId());
Sudheer Shankaacb1a612016-11-10 15:30:14 -0800652 IActivityManager am = ActivityManager.getService();
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100653 try {
654 String launchedFromPackage = am.getLaunchedFromPackage(activityToken);
655 boolean launchedFromSettingsApp = SETTINGS_PACKAGE_NAME.equals(launchedFromPackage);
656
657 UserHandle launchedFromUser = new UserHandle(UserHandle.getUserId(
658 am.getLaunchedFromUid(activityToken)));
659 if (launchedFromUser != null && !launchedFromUser.equals(currentUser)) {
660 // Check it's secure
661 if (isProfileOf(um, launchedFromUser)) {
662 return launchedFromUser;
663 }
664 }
Tony Mak8f41b9b2016-11-23 11:36:18 +0000665 UserHandle extrasUser = getUserHandleFromBundle(intentExtras);
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100666 if (extrasUser != null && !extrasUser.equals(currentUser)) {
667 // Check it's secure
668 if (launchedFromSettingsApp && isProfileOf(um, extrasUser)) {
669 return extrasUser;
670 }
671 }
Tony Mak8f41b9b2016-11-23 11:36:18 +0000672 UserHandle argumentsUser = getUserHandleFromBundle(arguments);
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100673 if (argumentsUser != null && !argumentsUser.equals(currentUser)) {
674 // Check it's secure
675 if (launchedFromSettingsApp && isProfileOf(um, argumentsUser)) {
676 return argumentsUser;
677 }
678 }
679 } catch (RemoteException e) {
680 // Should not happen
681 Log.v(TAG, "Could not talk to activity manager.", e);
682 }
683 return currentUser;
Tony Mak8f41b9b2016-11-23 11:36:18 +0000684 }
685
686 /**
687 * Lookup both {@link Intent#EXTRA_USER} and {@link Intent#EXTRA_USER_ID} in the bundle
688 * and return the {@link UserHandle} object. Return {@code null} if nothing is found.
689 */
690 private static @Nullable UserHandle getUserHandleFromBundle(Bundle bundle) {
691 if (bundle == null) {
692 return null;
693 }
694 final UserHandle user = bundle.getParcelable(EXTRA_USER);
695 if (user != null) {
696 return user;
697 }
698 final int userId = bundle.getInt(EXTRA_USER_ID, -1);
699 if (userId != -1) {
700 return UserHandle.of(userId);
701 }
702 return null;
703 }
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100704
705 /**
706 * Returns the target user for a Settings activity.
707 *
708 * The target user can be either the current user, the user that launched this activity or
709 * the user contained as an extra in the arguments or intent extras.
710 *
711 * You should use {@link #getSecureTargetUser(IBinder, UserManager, Bundle, Bundle)} if
712 * possible.
713 *
714 * @see #getInsecureTargetUser(IBinder, Bundle, Bundle)
715 */
716 public static UserHandle getInsecureTargetUser(IBinder activityToken, @Nullable Bundle arguments,
717 @Nullable Bundle intentExtras) {
718 UserHandle currentUser = new UserHandle(UserHandle.myUserId());
Sudheer Shankaacb1a612016-11-10 15:30:14 -0800719 IActivityManager am = ActivityManager.getService();
Alexandra Gherghina1eb3f312014-06-10 14:01:10 +0100720 try {
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100721 UserHandle launchedFromUser = new UserHandle(UserHandle.getUserId(
722 am.getLaunchedFromUid(activityToken)));
723 if (launchedFromUser != null && !launchedFromUser.equals(currentUser)) {
724 return launchedFromUser;
725 }
726 UserHandle extrasUser = intentExtras != null
727 ? (UserHandle) intentExtras.getParcelable(EXTRA_USER) : null;
728 if (extrasUser != null && !extrasUser.equals(currentUser)) {
729 return extrasUser;
730 }
731 UserHandle argumentsUser = arguments != null
732 ? (UserHandle) arguments.getParcelable(EXTRA_USER) : null;
733 if (argumentsUser != null && !argumentsUser.equals(currentUser)) {
734 return argumentsUser;
Alexandra Gherghina1eb3f312014-06-10 14:01:10 +0100735 }
736 } catch (RemoteException e) {
737 // Should not happen
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100738 Log.v(TAG, "Could not talk to activity manager.", e);
739 return null;
Alexandra Gherghina1eb3f312014-06-10 14:01:10 +0100740 }
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100741 return currentUser;
742 }
Alexandra Gherghina1eb3f312014-06-10 14:01:10 +0100743
Alexandra Gherghina7d748c02014-06-27 12:33:42 +0100744 /**
745 * Returns true if the user provided is in the same profiles group as the current user.
746 */
747 private static boolean isProfileOf(UserManager um, UserHandle otherUser) {
748 if (um == null || otherUser == null) return false;
749 return (UserHandle.myUserId() == otherUser.getIdentifier())
750 || um.getUserProfiles().contains(otherUser);
Alexandra Gherghina1eb3f312014-06-10 14:01:10 +0100751 }
Amith Yamasani51c6dac2014-07-02 00:06:37 +0530752
Alexandra Gherghina95b86a52014-07-24 19:13:25 +0100753 /**
Fabrice Di Meglio22a2a492014-08-08 12:27:57 -0700754 * Return whether or not the user should have a SIM Cards option in Settings.
755 * TODO: Change back to returning true if count is greater than one after testing.
756 * TODO: See bug 16533525.
757 */
758 public static boolean showSimCardTile(Context context) {
759 final TelephonyManager tm =
760 (TelephonyManager) context.getSystemService(Context.TELEPHONY_SERVICE);
761
PauloftheWestdbd03822014-12-04 11:56:35 -0800762 return tm.getSimCount() > 1;
Fabrice Di Meglio22a2a492014-08-08 12:27:57 -0700763 }
Dan Sandlerb58b5122014-09-02 18:31:49 +0200764
765 /**
Elliott Hughes7253df32014-09-02 17:10:14 -0700766 * Returns elapsed time for the given millis, in the following format:
767 * 2d 5h 40m 29s
768 * @param context the application context
769 * @param millis the elapsed time in milli seconds
770 * @param withSeconds include seconds?
771 * @return the formatted elapsed time
772 */
773 public static String formatElapsedTime(Context context, double millis, boolean withSeconds) {
774 StringBuilder sb = new StringBuilder();
775 int seconds = (int) Math.floor(millis / 1000);
776 if (!withSeconds) {
777 // Round up.
778 seconds += 30;
779 }
780
781 int days = 0, hours = 0, minutes = 0;
782 if (seconds >= SECONDS_PER_DAY) {
783 days = seconds / SECONDS_PER_DAY;
784 seconds -= days * SECONDS_PER_DAY;
785 }
786 if (seconds >= SECONDS_PER_HOUR) {
787 hours = seconds / SECONDS_PER_HOUR;
788 seconds -= hours * SECONDS_PER_HOUR;
789 }
790 if (seconds >= SECONDS_PER_MINUTE) {
791 minutes = seconds / SECONDS_PER_MINUTE;
792 seconds -= minutes * SECONDS_PER_MINUTE;
793 }
794 if (withSeconds) {
795 if (days > 0) {
796 sb.append(context.getString(R.string.battery_history_days,
797 days, hours, minutes, seconds));
798 } else if (hours > 0) {
799 sb.append(context.getString(R.string.battery_history_hours,
800 hours, minutes, seconds));
801 } else if (minutes > 0) {
802 sb.append(context.getString(R.string.battery_history_minutes, minutes, seconds));
803 } else {
804 sb.append(context.getString(R.string.battery_history_seconds, seconds));
805 }
806 } else {
807 if (days > 0) {
808 sb.append(context.getString(R.string.battery_history_days_no_seconds,
809 days, hours, minutes));
810 } else if (hours > 0) {
811 sb.append(context.getString(R.string.battery_history_hours_no_seconds,
812 hours, minutes));
813 } else {
814 sb.append(context.getString(R.string.battery_history_minutes_no_seconds, minutes));
815 }
816 }
817 return sb.toString();
818 }
PauloftheWest0a0daca2014-11-06 15:02:58 -0800819
820 /**
Amith Yamasani45f86232014-11-19 17:12:46 -0800821 * Queries for the UserInfo of a user. Returns null if the user doesn't exist (was removed).
822 * @param userManager Instance of UserManager
823 * @param checkUser The user to check the existence of.
824 * @return UserInfo of the user or null for non-existent user.
825 */
826 public static UserInfo getExistingUser(UserManager userManager, UserHandle checkUser) {
827 final List<UserInfo> users = userManager.getUsers(true /* excludeDying */);
828 final int checkUserId = checkUser.getIdentifier();
829 for (UserInfo user : users) {
830 if (user.id == checkUserId) {
831 return user;
832 }
833 }
834 return null;
835 }
836
Zoltan Szatmary-Ban3af2e4c2014-12-19 17:17:23 +0000837 public static View inflateCategoryHeader(LayoutInflater inflater, ViewGroup parent) {
838 final TypedArray a = inflater.getContext().obtainStyledAttributes(null,
839 com.android.internal.R.styleable.Preference,
840 com.android.internal.R.attr.preferenceCategoryStyle, 0);
841 final int resId = a.getResourceId(com.android.internal.R.styleable.Preference_layout,
842 0);
843 a.recycle();
844 return inflater.inflate(resId, parent, false);
845 }
846
Fabrice Di Megliodff3faa2015-02-27 11:14:11 -0800847 /**
848 * Return if we are running low on storage space or not.
849 *
850 * @param context The context
851 * @return true if we are running low on storage space
852 */
853 public static boolean isLowStorage(Context context) {
854 final StorageManager sm = StorageManager.from(context);
855 return (sm.getStorageBytesUntilLow(context.getFilesDir()) < 0);
856 }
857
Zoltan Szatmary-Bane5814ff2014-12-19 16:27:45 +0000858 /**
859 * Returns a default user icon (as a {@link Bitmap}) for the given user.
860 *
861 * Note that for guest users, you should pass in {@code UserHandle.USER_NULL}.
862 * @param userId the user id or {@code UserHandle.USER_NULL} for a non-user specific icon
863 */
864 public static Bitmap getDefaultUserIconAsBitmap(int userId) {
865 Bitmap bitmap = null;
866 // Try finding the corresponding bitmap in the dark bitmap cache
867 bitmap = sDarkDefaultUserBitmapCache.get(userId);
868 if (bitmap == null) {
869 bitmap = UserIcons.convertToBitmap(UserIcons.getDefaultUserIcon(userId, false));
870 // Save it to cache
871 sDarkDefaultUserBitmapCache.put(userId, bitmap);
872 }
873 return bitmap;
874 }
Fabrice Di Meglio8b2ea392015-01-23 19:03:22 -0800875
Fabrice Di Meglio8b2ea392015-01-23 19:03:22 -0800876 public static boolean hasPreferredActivities(PackageManager pm, String packageName) {
877 // Get list of preferred activities
878 List<ComponentName> prefActList = new ArrayList<>();
879 // Intent list cannot be null. so pass empty list
880 List<IntentFilter> intentList = new ArrayList<>();
881 pm.getPreferredActivities(intentList, prefActList, packageName);
882 Log.d(TAG, "Have " + prefActList.size() + " number of activities in preferred list");
883 return prefActList.size() > 0;
884 }
885
Christopher Tatea08a2252015-07-01 16:52:43 -0700886 public static ArraySet<String> getHandledDomains(PackageManager pm, String packageName) {
887 List<IntentFilterVerificationInfo> iviList = pm.getIntentFilterVerifications(packageName);
888 List<IntentFilter> filters = pm.getAllIntentFilters(packageName);
889
890 ArraySet<String> result = new ArraySet<>();
891 if (iviList.size() > 0) {
892 for (IntentFilterVerificationInfo ivi : iviList) {
893 for (String host : ivi.getDomains()) {
894 result.add(host);
895 }
896 }
897 }
898 if (filters != null && filters.size() > 0) {
899 for (IntentFilter filter : filters) {
Christopher Tateddaa1422015-07-16 16:00:49 -0700900 if (filter.hasCategory(Intent.CATEGORY_BROWSABLE)
901 && (filter.hasDataScheme(IntentFilter.SCHEME_HTTP) ||
902 filter.hasDataScheme(IntentFilter.SCHEME_HTTPS))) {
Christopher Tatea08a2252015-07-01 16:52:43 -0700903 result.addAll(filter.getHostsList());
904 }
905 }
906 }
907 return result;
908 }
909
Jason Monkb5aa73f2015-03-31 12:59:33 -0400910 public static void handleLoadingContainer(View loading, View doneLoading, boolean done,
911 boolean animate) {
912 setViewShown(loading, !done, animate);
913 setViewShown(doneLoading, done, animate);
914 }
915
916 private static void setViewShown(final View view, boolean shown, boolean animate) {
917 if (animate) {
918 Animation animation = AnimationUtils.loadAnimation(view.getContext(),
919 shown ? android.R.anim.fade_in : android.R.anim.fade_out);
920 if (shown) {
921 view.setVisibility(View.VISIBLE);
922 } else {
923 animation.setAnimationListener(new AnimationListener() {
924 @Override
925 public void onAnimationStart(Animation animation) {
926 }
927
928 @Override
929 public void onAnimationRepeat(Animation animation) {
930 }
931
932 @Override
933 public void onAnimationEnd(Animation animation) {
934 view.setVisibility(View.INVISIBLE);
935 }
936 });
937 }
938 view.startAnimation(animation);
939 } else {
940 view.clearAnimation();
941 view.setVisibility(shown ? View.VISIBLE : View.INVISIBLE);
942 }
943 }
Sudheer Shankabc956302015-04-09 12:19:53 +0100944
945 /**
946 * Returns the application info of the currently installed MDM package.
947 */
948 public static ApplicationInfo getAdminApplicationInfo(Context context, int profileId) {
949 DevicePolicyManager dpm =
950 (DevicePolicyManager) context.getSystemService(Context.DEVICE_POLICY_SERVICE);
951 ComponentName mdmPackage = dpm.getProfileOwnerAsUser(profileId);
952 if (mdmPackage == null) {
953 return null;
954 }
955 String mdmPackageName = mdmPackage.getPackageName();
956 try {
957 IPackageManager ipm = AppGlobals.getPackageManager();
958 ApplicationInfo mdmApplicationInfo =
959 ipm.getApplicationInfo(mdmPackageName, 0, profileId);
960 return mdmApplicationInfo;
961 } catch (RemoteException e) {
962 Log.e(TAG, "Error while retrieving application info for package " + mdmPackageName
963 + ", userId " + profileId, e);
964 return null;
965 }
966 }
Jason Monkb45e27b2015-05-20 13:35:43 -0400967
968 public static boolean isBandwidthControlEnabled() {
969 final INetworkManagementService netManager = INetworkManagementService.Stub
970 .asInterface(ServiceManager.getService(Context.NETWORKMANAGEMENT_SERVICE));
971 try {
972 return netManager.isBandwidthControlEnabled();
973 } catch (RemoteException e) {
974 return false;
975 }
976 }
Julia Reynoldsce25af42015-07-08 16:56:31 -0400977
978 /**
979 * Returns an accessible SpannableString.
980 * @param displayText the text to display
981 * @param accessibileText the text text-to-speech engines should read
982 */
983 public static SpannableString createAccessibleSequence(CharSequence displayText,
984 String accessibileText) {
985 SpannableString str = new SpannableString(displayText);
986 str.setSpan(new TtsSpan.TextBuilder(accessibileText).build(), 0,
987 displayText.length(),
988 Spannable.SPAN_INCLUSIVE_INCLUSIVE);
989 return str;
990 }
Andres Morales7bdffd82015-08-04 16:55:00 -0700991
Clara Bayarrife432e82015-10-12 12:07:02 +0100992 /**
Benjamin Franz194300d2016-01-13 12:16:25 +0000993 * Returns the user id present in the bundle with {@link Intent#EXTRA_USER_ID} if it
Clara Bayarrife432e82015-10-12 12:07:02 +0100994 * belongs to the current user.
995 *
996 * @throws SecurityException if the given userId does not belong to the current user group.
997 */
Benjamin Franz194300d2016-01-13 12:16:25 +0000998 public static int getUserIdFromBundle(Context context, Bundle bundle) {
Clara Bayarrife432e82015-10-12 12:07:02 +0100999 if (bundle == null) {
Benjamin Franz194300d2016-01-13 12:16:25 +00001000 return getCredentialOwnerUserId(context);
Clara Bayarrife432e82015-10-12 12:07:02 +01001001 }
Clara Bayarri6934a042015-10-14 11:07:35 +01001002 int userId = bundle.getInt(Intent.EXTRA_USER_ID, UserHandle.myUserId());
Benjamin Franz194300d2016-01-13 12:16:25 +00001003 return enforceSameOwner(context, userId);
Clara Bayarrife432e82015-10-12 12:07:02 +01001004 }
1005
1006 /**
1007 * Returns the given user id if it belongs to the current user.
1008 *
1009 * @throws SecurityException if the given userId does not belong to the current user group.
1010 */
Benjamin Franz194300d2016-01-13 12:16:25 +00001011 public static int enforceSameOwner(Context context, int userId) {
Ricky Wai72500162016-06-07 16:54:25 +01001012 final UserManager um = getUserManager(context);
1013 final int[] profileIds = um.getProfileIdsWithDisabled(UserHandle.myUserId());
1014 if (ArrayUtils.contains(profileIds, userId)) {
1015 return userId;
Clara Bayarrife432e82015-10-12 12:07:02 +01001016 }
Ricky Wai72500162016-06-07 16:54:25 +01001017 throw new SecurityException("Given user id " + userId + " does not belong to user "
1018 + UserHandle.myUserId());
Clara Bayarrife432e82015-10-12 12:07:02 +01001019 }
1020
Benjamin Franz194300d2016-01-13 12:16:25 +00001021 /**
1022 * Returns the effective credential owner of the calling user.
1023 */
1024 public static int getCredentialOwnerUserId(Context context) {
1025 return getCredentialOwnerUserId(context, UserHandle.myUserId());
1026 }
1027
1028 /**
1029 * Returns the user id of the credential owner of the given user id.
1030 */
1031 public static int getCredentialOwnerUserId(Context context, int userId) {
1032 UserManager um = getUserManager(context);
1033 return um.getCredentialOwnerProfile(userId);
Andres Morales7bdffd82015-08-04 16:55:00 -07001034 }
Jason Monkdb4ed192015-12-11 16:48:31 -05001035
1036 public static int resolveResource(Context context, int attr) {
1037 TypedValue value = new TypedValue();
1038 context.getTheme().resolveAttribute(attr, value, true);
1039 return value.resourceId;
1040 }
Jason Monkb37e2882016-01-11 14:27:20 -05001041
1042 private static final StringBuilder sBuilder = new StringBuilder(50);
1043 private static final java.util.Formatter sFormatter = new java.util.Formatter(
1044 sBuilder, Locale.getDefault());
1045
1046 public static String formatDateRange(Context context, long start, long end) {
1047 final int flags = FORMAT_SHOW_DATE | FORMAT_ABBREV_MONTH;
1048
1049 synchronized (sBuilder) {
1050 sBuilder.setLength(0);
1051 return DateUtils.formatDateRange(context, sFormatter, start, end, flags, null)
1052 .toString();
1053 }
1054 }
Jason Monk91e2f892016-02-23 15:31:09 -05001055
1056 public static List<String> getNonIndexable(int xml, Context context) {
Jason Monkbe941212016-05-27 12:58:53 -04001057 if (Looper.myLooper() == null) {
1058 // Hack to make sure Preferences can initialize. Prefs expect a looper, but
1059 // don't actually use it for the basic stuff here.
1060 Looper.prepare();
1061 }
Jason Monk9ee80cd2016-03-03 11:21:42 -05001062 final List<String> ret = new ArrayList<>();
Jason Monkbe941212016-05-27 12:58:53 -04001063 PreferenceManager manager = new PreferenceManager(context);
1064 PreferenceScreen screen = manager.inflateFromResource(context, xml, null);
1065 checkPrefs(screen, ret);
Jason Monk91e2f892016-02-23 15:31:09 -05001066
1067 return ret;
1068 }
1069
1070 private static void checkPrefs(PreferenceGroup group, List<String> ret) {
1071 if (group == null) return;
1072 for (int i = 0; i < group.getPreferenceCount(); i++) {
1073 Preference pref = group.getPreference(i);
1074 if (pref instanceof SelfAvailablePreference
1075 && !((SelfAvailablePreference) pref).isAvailable(group.getContext())) {
1076 ret.add(pref.getKey());
1077 if (pref instanceof PreferenceGroup) {
1078 addAll((PreferenceGroup) pref, ret);
1079 }
1080 } else if (pref instanceof PreferenceGroup) {
1081 checkPrefs((PreferenceGroup) pref, ret);
1082 }
1083 }
1084 }
1085
1086 private static void addAll(PreferenceGroup group, List<String> ret) {
1087 if (group == null) return;
1088 for (int i = 0; i < group.getPreferenceCount(); i++) {
1089 Preference pref = group.getPreference(i);
1090 ret.add(pref.getKey());
1091 if (pref instanceof PreferenceGroup) {
1092 addAll((PreferenceGroup) pref, ret);
1093 }
1094 }
1095 }
Udam Saini679f7ad2016-03-25 10:47:00 -07001096
1097 public static boolean isDeviceProvisioned(Context context) {
1098 return Settings.Global.getInt(context.getContentResolver(),
1099 Settings.Global.DEVICE_PROVISIONED, 0) != 0;
1100 }
Ricky Wai616342b2016-04-13 10:40:22 +01001101
Bernard Chau88d523b2016-04-14 15:08:28 +01001102 public static boolean startQuietModeDialogIfNecessary(Context context, UserManager um,
Ricky Wai616342b2016-04-13 10:40:22 +01001103 int userId) {
1104 if (um.isQuietModeEnabled(UserHandle.of(userId))) {
1105 final Intent intent = UnlaunchableAppActivity.createInQuietModeDialogIntent(userId);
1106 context.startActivity(intent);
1107 return true;
1108 }
1109 return false;
1110 }
Sudheer Shankac3eb16e2016-04-21 12:51:43 -07001111
Rubin Xu3231afe2016-08-24 10:15:07 +01001112 public static boolean unlockWorkProfileIfNecessary(Context context, int userId) {
1113 try {
Sudheer Shankaacb1a612016-11-10 15:30:14 -08001114 if (!ActivityManager.getService().isUserRunning(userId,
Rubin Xu3231afe2016-08-24 10:15:07 +01001115 ActivityManager.FLAG_AND_LOCKED)) {
1116 return false;
1117 }
1118 } catch (RemoteException e) {
1119 return false;
1120 }
1121 if (!(new LockPatternUtils(context)).isSecure(userId)) {
1122 return false;
1123 }
Robin Leecccf3242017-02-10 15:32:49 +00001124 return confirmWorkProfileCredentials(context, userId);
1125 }
1126
1127 public static boolean confirmWorkProfileCredentialsIfNecessary(Context context, int userId) {
1128 KeyguardManager km = (KeyguardManager) context.getSystemService(Context.KEYGUARD_SERVICE);
1129 if (!km.isDeviceLocked(userId)) {
1130 return false;
1131 }
1132 return confirmWorkProfileCredentials(context, userId);
1133 }
1134
1135 private static boolean confirmWorkProfileCredentials(Context context, int userId) {
Rubin Xu3231afe2016-08-24 10:15:07 +01001136 final KeyguardManager km = (KeyguardManager) context.getSystemService(
1137 Context.KEYGUARD_SERVICE);
1138 final Intent unlockIntent = km.createConfirmDeviceCredentialIntent(null, null, userId);
1139 if (unlockIntent != null) {
1140 context.startActivity(unlockIntent);
1141 return true;
1142 } else {
1143 return false;
1144 }
Rubin Xu3231afe2016-08-24 10:15:07 +01001145 }
1146
Sudheer Shankac3eb16e2016-04-21 12:51:43 -07001147 public static CharSequence getApplicationLabel(Context context, String packageName) {
1148 try {
1149 final ApplicationInfo appInfo = context.getPackageManager().getApplicationInfo(
1150 packageName,
1151 PackageManager.MATCH_DISABLED_COMPONENTS
Amith Yamasani21556cd2016-11-01 15:49:21 -07001152 | PackageManager.MATCH_ANY_USER);
Sudheer Shankac3eb16e2016-04-21 12:51:43 -07001153 return appInfo.loadLabel(context.getPackageManager());
1154 } catch (PackageManager.NameNotFoundException e) {
1155 Log.w(TAG, "Unable to find info for package: " + packageName);
1156 }
1157 return null;
1158 }
Jason Monk75199542016-05-06 15:09:32 -04001159
Jeff Sharkey4a8136b2016-07-27 12:53:34 -06001160 public static boolean isPackageDirectBootAware(Context context, String packageName) {
1161 try {
1162 final ApplicationInfo ai = context.getPackageManager().getApplicationInfo(
1163 packageName, 0);
1164 return ai.isDirectBootAware() || ai.isPartiallyDirectBootAware();
1165 } catch (NameNotFoundException ignored) {
1166 }
1167 return false;
1168 }
Andre Lago3e398c82016-07-25 14:12:28 +01001169
1170 /**
1171 * Returns a context created from the given context for the given user, or null if it fails
1172 */
1173 public static Context createPackageContextAsUser(Context context, int userId) {
1174 try {
1175 return context.createPackageContextAsUser(
1176 context.getPackageName(), 0 /* flags */, UserHandle.of(userId));
1177 } catch (PackageManager.NameNotFoundException e) {
1178 Log.e(TAG, "Failed to create user context", e);
1179 }
1180 return null;
1181 }
Jeff Sharkeyab508072016-10-11 14:25:22 -06001182
1183 public static FingerprintManager getFingerprintManagerOrNull(Context context) {
1184 if (context.getPackageManager().hasSystemFeature(PackageManager.FEATURE_FINGERPRINT)) {
1185 return context.getSystemService(FingerprintManager.class);
1186 } else {
1187 return null;
1188 }
1189 }
Daniel Nishi31027da2017-01-19 14:03:57 -08001190
1191 /**
1192 * Launches an intent which may optionally have a user id defined.
1193 * @param fragment Fragment to use to launch the activity.
1194 * @param intent Intent to launch.
1195 */
1196 public static void launchIntent(Fragment fragment, Intent intent) {
1197 try {
1198 final int userId = intent.getIntExtra(Intent.EXTRA_USER_ID, -1);
1199
1200 if (userId == -1) {
1201 fragment.startActivity(intent);
1202 } else {
1203 fragment.getActivity().startActivityAsUser(intent, new UserHandle(userId));
1204 }
1205 } catch (ActivityNotFoundException e) {
1206 Log.w(TAG, "No activity found for " + intent);
1207 }
1208 }
1209
Christine Franks14782222017-01-23 16:44:02 -08001210 public static boolean isCarrierDemoUser(Context context) {
1211 final String carrierDemoModeSetting =
1212 context.getString(com.android.internal.R.string.config_carrierDemoModeSetting);
1213 return UserManager.isDeviceInDemoMode(context)
1214 && getUserManager(context).isDemoUser()
1215 && !TextUtils.isEmpty(carrierDemoModeSetting)
1216 && (Settings.Secure.getInt(context.getContentResolver(),
1217 carrierDemoModeSetting, 0) == 1);
1218 }
Daniel Nishidfed8a22017-01-19 16:32:41 -08001219
1220 /**
1221 * Returns if a given user is a profile of another user.
1222 * @param user The user whose profiles will be checked.
1223 * @param profile The (potential) profile.
1224 * @return if the profile is actually a profile
1225 */
1226 public static boolean isProfileOf(UserInfo user, UserInfo profile) {
1227 return user.id == profile.id ||
1228 (user.profileGroupId != UserInfo.NO_PROFILE_GROUP_ID
1229 && user.profileGroupId == profile.profileGroupId);
1230 }
Daniel Nishi9f60f422017-02-15 15:25:48 -08001231
1232 /**
1233 * Tries to initalize a volume with the given bundle. If it is a valid, private, and readable
1234 * {@link VolumeInfo}, it is returned. If it is not valid, null is returned.
1235 */
1236 @Nullable
1237 public static VolumeInfo maybeInitializeVolume(StorageManager sm, Bundle bundle) {
1238 final String volumeId = bundle.getString(VolumeInfo.EXTRA_VOLUME_ID,
1239 VolumeInfo.ID_PRIVATE_INTERNAL);
1240 VolumeInfo volume = sm.findVolumeById(volumeId);
1241 return isVolumeValid(volume) ? volume : null;
1242 }
1243
jackqdyuleiddba9662017-03-08 19:35:02 -08001244 /**
1245 * Return the resource id to represent the install status for an app
1246 */
1247 @StringRes
1248 public static int getInstallationStatus(ApplicationInfo info) {
1249 if ((info.flags & ApplicationInfo.FLAG_INSTALLED) == 0) {
1250 return R.string.not_installed;
1251 }
1252 return info.enabled ? R.string.installed : R.string.disabled;
1253 }
1254
Daniel Nishi9f60f422017-02-15 15:25:48 -08001255 private static boolean isVolumeValid(VolumeInfo volume) {
1256 return (volume != null) && (volume.getType() == VolumeInfo.TYPE_PRIVATE)
1257 && volume.isMountedReadable();
1258 }
Jeff Sharkey4a8136b2016-07-27 12:53:34 -06001259}