blob: 0bfe56797d2217dd930e2946c2a262607b8f8781 [file] [log] [blame]
Kenny Root15a4d2f2010-03-11 18:20:12 -08001/*
2 * Copyright (C) 2007 The Android Open Source Project
3 *
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy 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,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
15 */
16
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080017package android.content.pm;
18
Jeff Sharkey9bc89af2017-01-11 11:25:50 -070019import static android.os.Build.VERSION_CODES.DONUT;
20
21import android.annotation.IntDef;
Jeff Sharkey8a372a02016-03-16 16:25:45 -060022import android.annotation.SystemApi;
Jeff Sharkeya73b8fd2016-01-06 17:02:08 -070023import android.annotation.TestApi;
Jeff Sharkey8a372a02016-03-16 16:25:45 -060024import android.content.Context;
Jeff Brown07330792010-03-30 19:57:08 -070025import android.content.pm.PackageManager.NameNotFoundException;
26import android.content.res.Resources;
27import android.graphics.drawable.Drawable;
Jeff Sharkey15447792015-11-05 16:18:51 -080028import android.os.Environment;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080029import android.os.Parcel;
30import android.os.Parcelable;
Jeff Sharkey15447792015-11-05 16:18:51 -080031import android.os.UserHandle;
Jeff Sharkey789a8fc2017-04-16 13:18:35 -060032import android.os.storage.StorageManager;
Jeff Sharkeye2d45be2015-04-15 17:14:12 -070033import android.text.TextUtils;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080034import android.util.Printer;
Adam Lesinski1665d0f2017-03-10 14:46:57 -080035import android.util.SparseArray;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080036
Jeff Sharkey8a4c9722014-06-16 13:48:42 -070037import com.android.internal.util.ArrayUtils;
38
Jeff Sharkey9bc89af2017-01-11 11:25:50 -070039import java.lang.annotation.Retention;
40import java.lang.annotation.RetentionPolicy;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080041import java.text.Collator;
Jeff Sharkey8a4c9722014-06-16 13:48:42 -070042import java.util.Arrays;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080043import java.util.Comparator;
Jeff Sharkey8a4c9722014-06-16 13:48:42 -070044import java.util.Objects;
Jeff Sharkey789a8fc2017-04-16 13:18:35 -060045import java.util.UUID;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080046
47/**
48 * Information you can retrieve about a particular application. This
49 * corresponds to information collected from the AndroidManifest.xml's
50 * <application> tag.
51 */
52public class ApplicationInfo extends PackageItemInfo implements Parcelable {
53
54 /**
55 * Default task affinity of all activities in this application. See
56 * {@link ActivityInfo#taskAffinity} for more information. This comes
57 * from the "taskAffinity" attribute.
58 */
59 public String taskAffinity;
60
61 /**
62 * Optional name of a permission required to be able to access this
63 * application's components. From the "permission" attribute.
64 */
65 public String permission;
66
67 /**
68 * The name of the process this application should run in. From the
69 * "process" attribute or, if not set, the same as
70 * <var>packageName</var>.
71 */
72 public String processName;
73
74 /**
75 * Class implementing the Application object. From the "class"
76 * attribute.
77 */
78 public String className;
79
80 /**
81 * A style resource identifier (in the package's resources) of the
82 * description of an application. From the "description" attribute
83 * or, if not set, 0.
84 */
85 public int descriptionRes;
86
87 /**
88 * A style resource identifier (in the package's resources) of the
89 * default visual theme of the application. From the "theme" attribute
90 * or, if not set, 0.
91 */
92 public int theme;
93
94 /**
95 * Class implementing the Application's manage space
96 * functionality. From the "manageSpaceActivity"
97 * attribute. This is an optional attribute and will be null if
Christopher Tate181fafa2009-05-14 11:12:14 -070098 * applications don't specify it in their manifest
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080099 */
100 public String manageSpaceActivityName;
101
102 /**
Christopher Tate181fafa2009-05-14 11:12:14 -0700103 * Class implementing the Application's backup functionality. From
104 * the "backupAgent" attribute. This is an optional attribute and
105 * will be null if the application does not specify it in its manifest.
106 *
107 * <p>If android:allowBackup is set to false, this attribute is ignored.
Christopher Tate181fafa2009-05-14 11:12:14 -0700108 */
109 public String backupAgentName;
Christopher Tate4a627c72011-04-01 14:43:32 -0700110
111 /**
Matthew Williams303650c2015-04-17 18:22:51 -0700112 * An optional attribute that indicates the app supports automatic backup of app data.
113 * <p>0 is the default and means the app's entire data folder + managed external storage will
114 * be backed up;
115 * Any negative value indicates the app does not support full-data backup, though it may still
116 * want to participate via the traditional key/value backup API;
117 * A positive number specifies an xml resource in which the application has defined its backup
118 * include/exclude criteria.
119 * <p>If android:allowBackup is set to false, this attribute is ignored.
120 *
Jeff Sharkey8a372a02016-03-16 16:25:45 -0600121 * @see android.content.Context#getNoBackupFilesDir()
122 * @see #FLAG_ALLOW_BACKUP
Christopher Tate98fa6562015-05-14 13:20:10 -0700123 *
124 * @hide
Matthew Williams303650c2015-04-17 18:22:51 -0700125 */
126 public int fullBackupContent = 0;
127
128 /**
Adam Powell269248d2011-08-02 10:26:54 -0700129 * The default extra UI options for activities in this application.
130 * Set from the {@link android.R.attr#uiOptions} attribute in the
131 * activity's manifest.
132 */
133 public int uiOptions = 0;
134
135 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800136 * Value for {@link #flags}: if set, this application is installed in the
137 * device's system image.
138 */
139 public static final int FLAG_SYSTEM = 1<<0;
140
141 /**
142 * Value for {@link #flags}: set to true if this application would like to
143 * allow debugging of its
144 * code, even when installed on a non-development system. Comes
145 * from {@link android.R.styleable#AndroidManifestApplication_debuggable
146 * android:debuggable} of the &lt;application&gt; tag.
147 */
148 public static final int FLAG_DEBUGGABLE = 1<<1;
149
150 /**
151 * Value for {@link #flags}: set to true if this application has code
152 * associated with it. Comes
153 * from {@link android.R.styleable#AndroidManifestApplication_hasCode
154 * android:hasCode} of the &lt;application&gt; tag.
155 */
156 public static final int FLAG_HAS_CODE = 1<<2;
157
158 /**
159 * Value for {@link #flags}: set to true if this application is persistent.
160 * Comes from {@link android.R.styleable#AndroidManifestApplication_persistent
161 * android:persistent} of the &lt;application&gt; tag.
162 */
163 public static final int FLAG_PERSISTENT = 1<<3;
164
165 /**
Christopher Tate181fafa2009-05-14 11:12:14 -0700166 * Value for {@link #flags}: set to true if this application holds the
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800167 * {@link android.Manifest.permission#FACTORY_TEST} permission and the
168 * device is running in factory test mode.
169 */
170 public static final int FLAG_FACTORY_TEST = 1<<4;
171
172 /**
173 * Value for {@link #flags}: default value for the corresponding ActivityInfo flag.
174 * Comes from {@link android.R.styleable#AndroidManifestApplication_allowTaskReparenting
175 * android:allowTaskReparenting} of the &lt;application&gt; tag.
176 */
177 public static final int FLAG_ALLOW_TASK_REPARENTING = 1<<5;
178
179 /**
180 * Value for {@link #flags}: default value for the corresponding ActivityInfo flag.
181 * Comes from {@link android.R.styleable#AndroidManifestApplication_allowClearUserData
182 * android:allowClearUserData} of the &lt;application&gt; tag.
183 */
184 public static final int FLAG_ALLOW_CLEAR_USER_DATA = 1<<6;
185
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800186 /**
Dianne Hackborn851a5412009-05-08 12:06:44 -0700187 * Value for {@link #flags}: this is set if this application has been
Kweku Adams8de29ca2016-01-22 12:30:26 -0800188 * installed as an update to a built-in system application.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800189 */
190 public static final int FLAG_UPDATED_SYSTEM_APP = 1<<7;
Dianne Hackborn851a5412009-05-08 12:06:44 -0700191
192 /**
Svet Ganov354cd3c2015-12-17 11:35:04 -0800193 * Value for {@link #flags}: this is set if the application has specified
Dianne Hackborn7f205432009-07-28 00:13:47 -0700194 * {@link android.R.styleable#AndroidManifestApplication_testOnly
195 * android:testOnly} to be true.
Dianne Hackborn851a5412009-05-08 12:06:44 -0700196 */
Dianne Hackborna96cbb42009-05-13 15:06:13 -0700197 public static final int FLAG_TEST_ONLY = 1<<8;
Dianne Hackbornade3eca2009-05-11 18:54:45 -0700198
199 /**
Dianne Hackborn5c1e00b2009-06-18 17:10:57 -0700200 * Value for {@link #flags}: true when the application's window can be
Dianne Hackborn723738c2009-06-25 19:48:04 -0700201 * reduced in size for smaller screens. Corresponds to
202 * {@link android.R.styleable#AndroidManifestSupportsScreens_smallScreens
203 * android:smallScreens}.
Dianne Hackborn5c1e00b2009-06-18 17:10:57 -0700204 */
Dianne Hackborn723738c2009-06-25 19:48:04 -0700205 public static final int FLAG_SUPPORTS_SMALL_SCREENS = 1<<9;
206
207 /**
208 * Value for {@link #flags}: true when the application's window can be
209 * displayed on normal screens. Corresponds to
210 * {@link android.R.styleable#AndroidManifestSupportsScreens_normalScreens
211 * android:normalScreens}.
212 */
213 public static final int FLAG_SUPPORTS_NORMAL_SCREENS = 1<<10;
214
215 /**
216 * Value for {@link #flags}: true when the application's window can be
217 * increased in size for larger screens. Corresponds to
218 * {@link android.R.styleable#AndroidManifestSupportsScreens_largeScreens
Dianne Hackborn22ec9ab2010-04-29 17:56:03 -0700219 * android:largeScreens}.
Dianne Hackborn723738c2009-06-25 19:48:04 -0700220 */
221 public static final int FLAG_SUPPORTS_LARGE_SCREENS = 1<<11;
Dianne Hackborn5c1e00b2009-06-18 17:10:57 -0700222
223 /**
Dianne Hackbornc4db95c2009-07-21 17:46:02 -0700224 * Value for {@link #flags}: true when the application knows how to adjust
225 * its UI for different screen sizes. Corresponds to
226 * {@link android.R.styleable#AndroidManifestSupportsScreens_resizeable
227 * android:resizeable}.
228 */
229 public static final int FLAG_RESIZEABLE_FOR_SCREENS = 1<<12;
230
231 /**
Dianne Hackborn11b822d2009-07-21 20:03:02 -0700232 * Value for {@link #flags}: true when the application knows how to
233 * accomodate different screen densities. Corresponds to
234 * {@link android.R.styleable#AndroidManifestSupportsScreens_anyDensity
235 * android:anyDensity}.
236 */
237 public static final int FLAG_SUPPORTS_SCREEN_DENSITIES = 1<<13;
238
239 /**
Ben Cheng23085b72010-02-08 16:06:32 -0800240 * Value for {@link #flags}: set to true if this application would like to
241 * request the VM to operate under the safe mode. Comes from
Ben Chengef3f5dd2010-03-29 15:47:26 -0700242 * {@link android.R.styleable#AndroidManifestApplication_vmSafeMode
243 * android:vmSafeMode} of the &lt;application&gt; tag.
Ben Cheng23085b72010-02-08 16:06:32 -0800244 */
245 public static final int FLAG_VM_SAFE_MODE = 1<<14;
246
247 /**
Christopher Tate3de55bc2010-03-12 17:28:08 -0800248 * Value for {@link #flags}: set to <code>false</code> if the application does not wish
249 * to permit any OS-driven backups of its data; <code>true</code> otherwise.
Christopher Tate181fafa2009-05-14 11:12:14 -0700250 *
Christopher Tate3de55bc2010-03-12 17:28:08 -0800251 * <p>Comes from the
252 * {@link android.R.styleable#AndroidManifestApplication_allowBackup android:allowBackup}
253 * attribute of the &lt;application&gt; tag.
Christopher Tate181fafa2009-05-14 11:12:14 -0700254 */
Ben Cheng23085b72010-02-08 16:06:32 -0800255 public static final int FLAG_ALLOW_BACKUP = 1<<15;
Christopher Tate5e1ab332009-09-01 20:32:49 -0700256
257 /**
Christopher Tate3de55bc2010-03-12 17:28:08 -0800258 * Value for {@link #flags}: set to <code>false</code> if the application must be kept
259 * in memory following a full-system restore operation; <code>true</code> otherwise.
260 * Ordinarily, during a full system restore operation each application is shut down
261 * following execution of its agent's onRestore() method. Setting this attribute to
262 * <code>false</code> prevents this. Most applications will not need to set this attribute.
Christopher Tate5e1ab332009-09-01 20:32:49 -0700263 *
Christopher Tate3de55bc2010-03-12 17:28:08 -0800264 * <p>If
265 * {@link android.R.styleable#AndroidManifestApplication_allowBackup android:allowBackup}
266 * is set to <code>false</code> or no
267 * {@link android.R.styleable#AndroidManifestApplication_backupAgent android:backupAgent}
Christopher Tate5e1ab332009-09-01 20:32:49 -0700268 * is specified, this flag will be ignored.
269 *
Christopher Tate3de55bc2010-03-12 17:28:08 -0800270 * <p>Comes from the
271 * {@link android.R.styleable#AndroidManifestApplication_killAfterRestore android:killAfterRestore}
272 * attribute of the &lt;application&gt; tag.
Christopher Tate5e1ab332009-09-01 20:32:49 -0700273 */
Ben Cheng23085b72010-02-08 16:06:32 -0800274 public static final int FLAG_KILL_AFTER_RESTORE = 1<<16;
Christopher Tate5e1ab332009-09-01 20:32:49 -0700275
276 /**
Christopher Tate3de55bc2010-03-12 17:28:08 -0800277 * Value for {@link #flags}: Set to <code>true</code> if the application's backup
278 * agent claims to be able to handle restore data even "from the future,"
279 * i.e. from versions of the application with a versionCode greater than
280 * the one currently installed on the device. <i>Use with caution!</i> By default
281 * this attribute is <code>false</code> and the Backup Manager will ensure that data
282 * from "future" versions of the application are never supplied during a restore operation.
Christopher Tate5e1ab332009-09-01 20:32:49 -0700283 *
Christopher Tate3de55bc2010-03-12 17:28:08 -0800284 * <p>If
285 * {@link android.R.styleable#AndroidManifestApplication_allowBackup android:allowBackup}
286 * is set to <code>false</code> or no
287 * {@link android.R.styleable#AndroidManifestApplication_backupAgent android:backupAgent}
Christopher Tate5e1ab332009-09-01 20:32:49 -0700288 * is specified, this flag will be ignored.
289 *
Christopher Tate3de55bc2010-03-12 17:28:08 -0800290 * <p>Comes from the
291 * {@link android.R.styleable#AndroidManifestApplication_restoreAnyVersion android:restoreAnyVersion}
292 * attribute of the &lt;application&gt; tag.
Christopher Tate5e1ab332009-09-01 20:32:49 -0700293 */
Christopher Tate3de55bc2010-03-12 17:28:08 -0800294 public static final int FLAG_RESTORE_ANY_VERSION = 1<<17;
Christopher Tate5e1ab332009-09-01 20:32:49 -0700295
Christopher Tate181fafa2009-05-14 11:12:14 -0700296 /**
Dianne Hackborn3202d382010-04-26 17:51:34 -0700297 * Value for {@link #flags}: Set to true if the application is
298 * currently installed on external/removable/unprotected storage. Such
299 * applications may not be available if their storage is not currently
300 * mounted. When the storage it is on is not available, it will look like
301 * the application has been uninstalled (its .apk is no longer available)
302 * but its persistent data is not removed.
Suchi Amalapurapuaf8e9f42010-01-12 10:17:28 -0800303 */
Dianne Hackborn94c567e2010-04-26 18:13:10 -0700304 public static final int FLAG_EXTERNAL_STORAGE = 1<<18;
Suchi Amalapurapuaf8e9f42010-01-12 10:17:28 -0800305
306 /**
Dianne Hackborn14cee9f2010-04-23 17:51:26 -0700307 * Value for {@link #flags}: true when the application's window can be
308 * increased in size for extra large screens. Corresponds to
309 * {@link android.R.styleable#AndroidManifestSupportsScreens_xlargeScreens
Dianne Hackborn22ec9ab2010-04-29 17:56:03 -0700310 * android:xlargeScreens}.
Dianne Hackborn14cee9f2010-04-23 17:51:26 -0700311 */
312 public static final int FLAG_SUPPORTS_XLARGE_SCREENS = 1<<19;
313
314 /**
Dianne Hackborn3b81bc12011-01-15 11:50:52 -0800315 * Value for {@link #flags}: true when the application has requested a
316 * large heap for its processes. Corresponds to
317 * {@link android.R.styleable#AndroidManifestApplication_largeHeap
318 * android:largeHeap}.
Jason parksa3cdaa52011-01-13 14:15:43 -0600319 */
Dianne Hackborn3b81bc12011-01-15 11:50:52 -0800320 public static final int FLAG_LARGE_HEAP = 1<<20;
Jason parksa3cdaa52011-01-13 14:15:43 -0600321
322 /**
Dianne Hackborne7f97212011-02-24 14:40:20 -0800323 * Value for {@link #flags}: true if this application's package is in
324 * the stopped state.
325 */
326 public static final int FLAG_STOPPED = 1<<21;
327
328 /**
Fabrice Di Meglio59dfce82012-04-02 16:17:20 -0700329 * Value for {@link #flags}: true when the application is willing to support
330 * RTL (right to left). All activities will inherit this value.
331 *
332 * Set from the {@link android.R.attr#supportsRtl} attribute in the
333 * activity's manifest.
334 *
335 * Default value is false (no support for RTL).
336 */
337 public static final int FLAG_SUPPORTS_RTL = 1<<22;
338
339 /**
Dianne Hackborn7767eac2012-08-23 18:25:40 -0700340 * Value for {@link #flags}: true if the application is currently
341 * installed for the calling user.
342 */
343 public static final int FLAG_INSTALLED = 1<<23;
344
345 /**
Dianne Hackborn5e03e2c2012-09-06 14:21:19 -0700346 * Value for {@link #flags}: true if the application only has its
347 * data installed; the application package itself does not currently
348 * exist on the device.
349 */
350 public static final int FLAG_IS_DATA_ONLY = 1<<24;
351
352 /**
Jeff Sharkey9bc89af2017-01-11 11:25:50 -0700353 * Value for {@link #flags}: true if the application was declared to be a
354 * game, or false if it is a non-game application.
355 *
356 * @deprecated use {@link #CATEGORY_GAME} instead.
Jose Lima12d0b4c2014-03-14 16:55:12 -0700357 */
Jeff Sharkey9bc89af2017-01-11 11:25:50 -0700358 @Deprecated
Jose Lima12d0b4c2014-03-14 16:55:12 -0700359 public static final int FLAG_IS_GAME = 1<<25;
360
361 /**
Christopher Tated1de2562014-06-17 17:12:35 -0700362 * Value for {@link #flags}: {@code true} if the application asks that only
363 * full-data streaming backups of its data be performed even though it defines
364 * a {@link android.app.backup.BackupAgent BackupAgent}, which normally
365 * indicates that the app will manage its backed-up data via incremental
366 * key/value updates.
367 */
368 public static final int FLAG_FULL_BACKUP_ONLY = 1<<26;
369
370 /**
Alex Klyubin01a959d2015-03-18 10:05:45 -0700371 * Value for {@link #flags}: {@code true} if the application may use cleartext network traffic
372 * (e.g., HTTP rather than HTTPS; WebSockets rather than WebSockets Secure; XMPP, IMAP, STMP
373 * without STARTTLS or TLS). If {@code false}, the app declares that it does not intend to use
374 * cleartext network traffic, in which case platform components (e.g., HTTP stacks,
Alex Klyubinfbf45992015-04-21 13:44:29 -0700375 * {@code DownloadManager}, {@code MediaPlayer}) will refuse app's requests to use cleartext
376 * traffic. Third-party libraries are encouraged to honor this flag as well.
377 *
378 * <p>NOTE: {@code WebView} does not honor this flag.
379 *
Chad Brubaker2df5ba72016-04-11 13:31:24 -0700380 * <p>This flag is ignored on Android N and above if an Android Network Security Config is
381 * present.
382 *
Alex Klyubinfbf45992015-04-21 13:44:29 -0700383 * <p>This flag comes from
384 * {@link android.R.styleable#AndroidManifestApplication_usesCleartextTraffic
385 * android:usesCleartextTraffic} of the &lt;application&gt; tag.
Alex Klyubin01a959d2015-03-18 10:05:45 -0700386 */
387 public static final int FLAG_USES_CLEARTEXT_TRAFFIC = 1<<27;
388
389 /**
Dmitriy Ivanovff193d62014-09-30 15:10:48 -0700390 * When set installer extracts native libs from .apk files.
391 */
392 public static final int FLAG_EXTRACT_NATIVE_LIBS = 1<<28;
393
394 /**
Alan Viveretted70b9e72015-05-27 14:29:20 -0700395 * Value for {@link #flags}: {@code true} when the application's rendering
396 * should be hardware accelerated.
397 */
398 public static final int FLAG_HARDWARE_ACCELERATED = 1<<29;
399
400 /**
Andrei Stingaceanu1e283912015-11-26 15:26:28 +0000401 * Value for {@link #flags}: true if this application's package is in
402 * the suspended state.
403 */
404 public static final int FLAG_SUSPENDED = 1<<30;
405
406 /**
Narayan Kamath589a1bc2014-07-03 14:43:26 +0100407 * Value for {@link #flags}: true if code from this application will need to be
408 * loaded into other applications' processes. On devices that support multiple
409 * instruction sets, this implies the code might be loaded into a process that's
410 * using any of the devices supported instruction sets.
411 *
412 * <p> The system might treat such applications specially, for eg., by
413 * extracting the application's native libraries for all supported instruction
414 * sets or by compiling the application's dex code for all supported instruction
415 * sets.
416 */
417 public static final int FLAG_MULTIARCH = 1 << 31;
Amith Yamasani655d0e22013-06-12 14:19:10 -0700418
419 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800420 * Flags associated with the application. Any combination of
421 * {@link #FLAG_SYSTEM}, {@link #FLAG_DEBUGGABLE}, {@link #FLAG_HAS_CODE},
422 * {@link #FLAG_PERSISTENT}, {@link #FLAG_FACTORY_TEST}, and
423 * {@link #FLAG_ALLOW_TASK_REPARENTING}
Dianne Hackborn851a5412009-05-08 12:06:44 -0700424 * {@link #FLAG_ALLOW_CLEAR_USER_DATA}, {@link #FLAG_UPDATED_SYSTEM_APP},
Dianne Hackborn723738c2009-06-25 19:48:04 -0700425 * {@link #FLAG_TEST_ONLY}, {@link #FLAG_SUPPORTS_SMALL_SCREENS},
426 * {@link #FLAG_SUPPORTS_NORMAL_SCREENS},
Dianne Hackborn14cee9f2010-04-23 17:51:26 -0700427 * {@link #FLAG_SUPPORTS_LARGE_SCREENS}, {@link #FLAG_SUPPORTS_XLARGE_SCREENS},
428 * {@link #FLAG_RESIZEABLE_FOR_SCREENS},
Dianne Hackborn7767eac2012-08-23 18:25:40 -0700429 * {@link #FLAG_SUPPORTS_SCREEN_DENSITIES}, {@link #FLAG_VM_SAFE_MODE},
Alex Klyubinb9f8a522015-02-03 11:12:59 -0800430 * {@link #FLAG_ALLOW_BACKUP}, {@link #FLAG_KILL_AFTER_RESTORE},
431 * {@link #FLAG_RESTORE_ANY_VERSION}, {@link #FLAG_EXTERNAL_STORAGE},
432 * {@link #FLAG_LARGE_HEAP}, {@link #FLAG_STOPPED},
433 * {@link #FLAG_SUPPORTS_RTL}, {@link #FLAG_INSTALLED},
434 * {@link #FLAG_IS_DATA_ONLY}, {@link #FLAG_IS_GAME},
Alex Klyubin7cb000f2015-03-26 11:00:04 -0700435 * {@link #FLAG_FULL_BACKUP_ONLY}, {@link #FLAG_USES_CLEARTEXT_TRAFFIC},
436 * {@link #FLAG_MULTIARCH}.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800437 */
438 public int flags = 0;
Amith Yamasani655d0e22013-06-12 14:19:10 -0700439
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800440 /**
Alex Klyubinb9f8a522015-02-03 11:12:59 -0800441 * Value for {@link #privateFlags}: true if the application is hidden via restrictions and for
442 * most purposes is considered as not installed.
443 * {@hide}
444 */
445 public static final int PRIVATE_FLAG_HIDDEN = 1<<0;
446
447 /**
448 * Value for {@link #privateFlags}: set to <code>true</code> if the application
449 * has reported that it is heavy-weight, and thus can not participate in
450 * the normal application lifecycle.
451 *
452 * <p>Comes from the
453 * android.R.styleable#AndroidManifestApplication_cantSaveState
454 * attribute of the &lt;application&gt; tag.
455 *
456 * {@hide}
457 */
458 public static final int PRIVATE_FLAG_CANT_SAVE_STATE = 1<<1;
459
460 /**
461 * Value for {@link #privateFlags}: Set to true if the application has been
462 * installed using the forward lock option.
463 *
464 * NOTE: DO NOT CHANGE THIS VALUE! It is saved in packages.xml.
465 *
466 * {@hide}
467 */
468 public static final int PRIVATE_FLAG_FORWARD_LOCK = 1<<2;
469
470 /**
471 * Value for {@link #privateFlags}: set to {@code true} if the application
472 * is permitted to hold privileged permissions.
473 *
474 * {@hide}
475 */
476 public static final int PRIVATE_FLAG_PRIVILEGED = 1<<3;
477
478 /**
Svet Ganov2acf0632015-11-24 19:10:59 -0800479 * Value for {@link #privateFlags}: {@code true} if the application has any IntentFiler
480 * with some data URI using HTTP or HTTPS with an associated VIEW action.
Fabrice Di Megliod3d8a322015-04-01 15:58:47 -0700481 *
482 * {@hide}
483 */
484 public static final int PRIVATE_FLAG_HAS_DOMAIN_URLS = 1<<4;
485
486 /**
Jeff Sharkey8a372a02016-03-16 16:25:45 -0600487 * When set, the default data storage directory for this app is pointed at
488 * the device-protected location.
Jeff Sharkey15447792015-11-05 16:18:51 -0800489 *
490 * @hide
491 */
Jeff Sharkey8a372a02016-03-16 16:25:45 -0600492 public static final int PRIVATE_FLAG_DEFAULT_TO_DEVICE_PROTECTED_STORAGE = 1 << 5;
Jeff Sharkey15447792015-11-05 16:18:51 -0800493
494 /**
Jeff Sharkey8a372a02016-03-16 16:25:45 -0600495 * When set, assume that all components under the given app are direct boot
Jeff Sharkeyf9fc6d62015-11-08 16:46:05 -0800496 * aware, unless otherwise specified.
497 *
498 * @hide
499 */
Jeff Sharkey8a372a02016-03-16 16:25:45 -0600500 public static final int PRIVATE_FLAG_DIRECT_BOOT_AWARE = 1 << 6;
Jeff Sharkeyf9fc6d62015-11-08 16:46:05 -0800501
502 /**
Todd Kennedybe0b8892017-02-15 14:13:52 -0800503 * Value for {@link #privateFlags}: {@code true} if the application is installed
504 * as instant app.
505 *
506 * @hide
Chad Brubaker4389c232016-11-04 14:50:50 -0700507 */
Todd Kennedybe0b8892017-02-15 14:13:52 -0800508 public static final int PRIVATE_FLAG_INSTANT = 1 << 7;
Chad Brubaker4389c232016-11-04 14:50:50 -0700509
510 /**
Jeff Sharkey8a372a02016-03-16 16:25:45 -0600511 * When set, at least one component inside this application is direct boot
512 * aware.
Jeff Sharkey8924e872015-11-30 12:52:10 -0700513 *
514 * @hide
515 */
Jeff Sharkey8a372a02016-03-16 16:25:45 -0600516 public static final int PRIVATE_FLAG_PARTIALLY_DIRECT_BOOT_AWARE = 1 << 8;
Jeff Sharkey8924e872015-11-30 12:52:10 -0700517
Fyodor Kupolovf99104d2015-12-14 11:31:29 -0800518
519 /**
Fyodor Kupolovbdbc9692015-12-14 13:11:13 -0800520 * When set, signals that the application is required for the system user and should not be
521 * uninstalled.
522 *
523 * @hide
524 */
Chad Brubaker4389c232016-11-04 14:50:50 -0700525 public static final int PRIVATE_FLAG_REQUIRED_FOR_SYSTEM_USER = 1 << 9;
Fyodor Kupolovbdbc9692015-12-14 13:11:13 -0800526
527 /**
Wale Ogunwalee633eb02017-03-30 12:57:29 -0700528 * When set, the application explicitly requested that its activities be resizeable by default.
Wale Ogunwale6afdf912016-01-30 13:01:33 -0800529 * @see android.R.styleable#AndroidManifestActivity_resizeableActivity
530 *
531 * @hide
532 */
Wale Ogunwalee633eb02017-03-30 12:57:29 -0700533 public static final int PRIVATE_FLAG_ACTIVITIES_RESIZE_MODE_RESIZEABLE = 1 << 10;
534
535 /**
536 * When set, the application explicitly requested that its activities *not* be resizeable by
537 * default.
538 * @see android.R.styleable#AndroidManifestActivity_resizeableActivity
539 *
540 * @hide
541 */
542 public static final int PRIVATE_FLAG_ACTIVITIES_RESIZE_MODE_UNRESIZEABLE = 1 << 11;
Wale Ogunwale72a73e32016-10-13 12:16:39 -0700543
544 /**
545 * The application isn't requesting explicitly requesting for its activities to be resizeable or
546 * non-resizeable by default. So, we are making it activities resizeable by default based on the
547 * target SDK version of the app.
548 * @see android.R.styleable#AndroidManifestActivity_resizeableActivity
549 *
550 * NOTE: This only affects apps with target SDK >= N where the resizeableActivity attribute was
551 * introduced. It shouldn't be confused with {@link ActivityInfo#RESIZE_MODE_FORCE_RESIZEABLE}
552 * where certain pre-N apps are forced to the resizeable.
553 *
554 * @hide
555 */
Wale Ogunwalee633eb02017-03-30 12:57:29 -0700556 public static final int PRIVATE_FLAG_ACTIVITIES_RESIZE_MODE_RESIZEABLE_VIA_SDK_VERSION =
557 1 << 12;
Wale Ogunwale6afdf912016-01-30 13:01:33 -0800558
559 /**
Christopher Tate43fbc5f2016-02-17 18:00:48 -0800560 * Value for {@link #privateFlags}: {@code true} means the OS should go ahead and
561 * run full-data backup operations for the app even when it is in a
562 * foreground-equivalent run state. Defaults to {@code false} if unspecified.
563 * @hide
564 */
Wale Ogunwalee633eb02017-03-30 12:57:29 -0700565 public static final int PRIVATE_FLAG_BACKUP_IN_FOREGROUND = 1 << 13;
Christopher Tate43fbc5f2016-02-17 18:00:48 -0800566
567 /**
Svet Ganov67882122016-12-11 16:36:34 -0800568 * Value for {@link #privateFlags}: {@code true} means this application
569 * contains a static shared library. Defaults to {@code false} if unspecified.
570 * @hide
571 */
Wale Ogunwalee633eb02017-03-30 12:57:29 -0700572 public static final int PRIVATE_FLAG_STATIC_SHARED_LIBRARY = 1 << 14;
Svet Ganov67882122016-12-11 16:36:34 -0800573
574 /**
Adam Lesinski4e862812016-11-21 16:02:24 -0800575 * Value for {@linl #privateFlags}: When set, the application will only have its splits loaded
576 * if they are required to load a component. Splits can be loaded on demand using the
577 * {@link Context#createContextForSplit(String)} API.
578 * @hide
579 */
Wale Ogunwalee633eb02017-03-30 12:57:29 -0700580 public static final int PRIVATE_FLAG_ISOLATED_SPLIT_LOADING = 1 << 15;
Adam Lesinski4e862812016-11-21 16:02:24 -0800581
582 /**
Alex Klyubinb9f8a522015-02-03 11:12:59 -0800583 * Private/hidden flags. See {@code PRIVATE_FLAG_...} constants.
584 * {@hide}
585 */
586 public int privateFlags;
587
588 /**
Clara Bayarri4b5a4d22017-01-27 20:15:45 +0000589 * @hide
590 */
591 public static final String METADATA_PRELOADED_FONTS = "preloaded_fonts";
592
593 /**
Dianne Hackborndf6e9802011-05-26 14:20:23 -0700594 * The required smallest screen width the application can run on. If 0,
595 * nothing has been specified. Comes from
596 * {@link android.R.styleable#AndroidManifestSupportsScreens_requiresSmallestWidthDp
597 * android:requiresSmallestWidthDp} attribute of the &lt;supports-screens&gt; tag.
598 */
599 public int requiresSmallestWidthDp = 0;
600
601 /**
602 * The maximum smallest screen width the application is designed for. If 0,
603 * nothing has been specified. Comes from
604 * {@link android.R.styleable#AndroidManifestSupportsScreens_compatibleWidthLimitDp
605 * android:compatibleWidthLimitDp} attribute of the &lt;supports-screens&gt; tag.
606 */
607 public int compatibleWidthLimitDp = 0;
608
609 /**
Dianne Hackborn2762ff32011-06-01 21:27:05 -0700610 * The maximum smallest screen width the application will work on. If 0,
611 * nothing has been specified. Comes from
612 * {@link android.R.styleable#AndroidManifestSupportsScreens_largestWidthLimitDp
613 * android:largestWidthLimitDp} attribute of the &lt;supports-screens&gt; tag.
614 */
615 public int largestWidthLimitDp = 0;
616
Jeff Sharkey61128602017-01-26 17:07:35 -0700617 /**
Wale Ogunwale55ddf8f2017-03-20 08:56:38 -0700618 * Value indicating the maximum aspect ratio the application supports.
619 * <p>
620 * 0 means unset.
621 * @See {@link android.R.attr#maxAspectRatio}.
622 * @hide
623 */
624 public float maxAspectRatio;
625
Jeff Sharkey789a8fc2017-04-16 13:18:35 -0600626 /** @removed */
627 @Deprecated
628 public String volumeUuid;
629
Wale Ogunwale55ddf8f2017-03-20 08:56:38 -0700630 /**
Jeff Sharkey61128602017-01-26 17:07:35 -0700631 * UUID of the storage volume on which this application is being hosted. For
632 * apps hosted on the default internal storage at
Jeff Sharkey789a8fc2017-04-16 13:18:35 -0600633 * {@link Environment#getDataDirectory()}, the UUID value is
634 * {@link StorageManager#UUID_DEFAULT}.
Jeff Sharkey61128602017-01-26 17:07:35 -0700635 */
Jeff Sharkey789a8fc2017-04-16 13:18:35 -0600636 public UUID storageUuid;
Jeff Sharkey61128602017-01-26 17:07:35 -0700637
Jeff Sharkeyb2b9ab82015-04-05 21:10:42 -0700638 /** {@hide} */
Jeff Sharkeyd7460572014-07-06 20:44:55 -0700639 public String scanSourceDir;
640 /** {@hide} */
641 public String scanPublicSourceDir;
642
Dianne Hackborn2762ff32011-06-01 21:27:05 -0700643 /**
Jeff Sharkey8a4c9722014-06-16 13:48:42 -0700644 * Full path to the base APK for this application.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800645 */
646 public String sourceDir;
647
648 /**
Jeff Sharkey8a4c9722014-06-16 13:48:42 -0700649 * Full path to the publicly available parts of {@link #sourceDir},
650 * including resources and manifest. This may be different from
651 * {@link #sourceDir} if an application is forward locked.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800652 */
653 public String publicSourceDir;
Jeff Sharkey8a4c9722014-06-16 13:48:42 -0700654
655 /**
Adam Lesinski4e862812016-11-21 16:02:24 -0800656 * The names of all installed split APKs, ordered lexicographically.
657 */
658 public String[] splitNames;
659
660 /**
661 * Full paths to zero or more split APKs, indexed by the same order as {@link #splitNames}.
Jeff Sharkey8a4c9722014-06-16 13:48:42 -0700662 */
663 public String[] splitSourceDirs;
664
665 /**
666 * Full path to the publicly available parts of {@link #splitSourceDirs},
667 * including resources and manifest. This may be different from
668 * {@link #splitSourceDirs} if an application is forward locked.
Adam Lesinski4e862812016-11-21 16:02:24 -0800669 *
670 * @see #splitSourceDirs
Jeff Sharkey8a4c9722014-06-16 13:48:42 -0700671 */
672 public String[] splitPublicSourceDirs;
673
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800674 /**
Adam Lesinski4e862812016-11-21 16:02:24 -0800675 * Maps the dependencies between split APKs. All splits implicitly depend on the base APK.
676 *
677 * Available since platform version O.
678 *
679 * Only populated if the application opts in to isolated split loading via the
680 * {@link android.R.attr.isolatedSplits} attribute in the &lt;manifest&gt; tag of the app's
681 * AndroidManifest.xml.
682 *
683 * The keys and values are all indices into the {@link #splitNames}, {@link #splitSourceDirs},
684 * and {@link #splitPublicSourceDirs} arrays.
Adam Lesinski1665d0f2017-03-10 14:46:57 -0800685 * Each key represents a split and its value is an array of splits. The first element of this
686 * array is the parent split, and the rest are configuration splits. These configuration splits
687 * have no dependencies themselves.
Adam Lesinski4e862812016-11-21 16:02:24 -0800688 * Cycles do not exist because they are illegal and screened for during installation.
689 *
690 * May be null if no splits are installed, or if no dependencies exist between them.
691 * @hide
692 */
Adam Lesinski1665d0f2017-03-10 14:46:57 -0800693 public SparseArray<int[]> splitDependencies;
Adam Lesinski4e862812016-11-21 16:02:24 -0800694
695 /**
696 * Full paths to the locations of extra resource packages (runtime overlays)
697 * this application uses. This field is only used if there are extra resource
698 * packages, otherwise it is null.
699 *
Kenny Rootace5a3f2010-02-05 12:59:28 -0800700 * {@hide}
Kenny Rootd1ab0162010-01-21 17:27:14 -0800701 */
702 public String[] resourceDirs;
703
704 /**
Robert Craig0f40dc92013-03-25 06:33:03 -0400705 * String retrieved from the seinfo tag found in selinux policy. This value
Robert Craig5e16bc52015-08-28 12:11:41 -0400706 * can be overridden with a value set through the mac_permissions.xml policy
707 * construct. This value is useful in setting an SELinux security context on
708 * the process as well as its data directory. The String default is being used
709 * here to represent a catchall label when no policy matches.
Robert Craig0f40dc92013-03-25 06:33:03 -0400710 *
711 * {@hide}
712 */
Todd Kennedybe0b8892017-02-15 14:13:52 -0800713 public String seInfo = "default";
714
715 /**
716 * The seinfo tag generated per-user. This value may change based upon the
717 * user's configuration. For example, when an instant app is installed for
718 * a user. It is an error if this field is ever {@code null} when trying to
719 * start a new process.
720 * <p>NOTE: We need to separate this out because we modify per-user values
721 * multiple times. This needs to be refactored since we're performing more
722 * work than necessary and these values should only be set once. When that
723 * happens, we can merge the per-user value with the seInfo state above.
724 *
725 * {@hide}
726 */
727 public String seInfoUser;
Robert Craig0f40dc92013-03-25 06:33:03 -0400728
729 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800730 * Paths to all shared libraries this application is linked against. This
731 * field is only set if the {@link PackageManager#GET_SHARED_LIBRARY_FILES
732 * PackageManager.GET_SHARED_LIBRARY_FILES} flag was used when retrieving
733 * the structure.
734 */
735 public String[] sharedLibraryFiles;
736
737 /**
Jeff Sharkey7a30a302015-12-08 14:20:06 -0700738 * Full path to the default directory assigned to the package for its
739 * persistent data.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800740 */
741 public String dataDir;
Kenny Root85387d72010-08-26 10:13:11 -0700742
Jeff Sharkey7a30a302015-12-08 14:20:06 -0700743 /**
Jeff Sharkey8a372a02016-03-16 16:25:45 -0600744 * Full path to the device-protected directory assigned to the package for
Jeff Sharkey7a30a302015-12-08 14:20:06 -0700745 * its persistent data.
Jeff Sharkey8a372a02016-03-16 16:25:45 -0600746 *
747 * @see Context#createDeviceProtectedStorageContext()
Jeff Sharkey7a30a302015-12-08 14:20:06 -0700748 */
Jeff Sharkey8a372a02016-03-16 16:25:45 -0600749 public String deviceProtectedDataDir;
750
Jeff Sharkey7a30a302015-12-08 14:20:06 -0700751 /**
Jeff Sharkey8a372a02016-03-16 16:25:45 -0600752 * Full path to the credential-protected directory assigned to the package
Jeff Sharkey7a30a302015-12-08 14:20:06 -0700753 * for its persistent data.
Jeff Sharkey8a372a02016-03-16 16:25:45 -0600754 *
755 * @hide
Jeff Sharkey7a30a302015-12-08 14:20:06 -0700756 */
Jeff Sharkey8a372a02016-03-16 16:25:45 -0600757 @SystemApi
758 public String credentialProtectedDataDir;
759
Kenny Root85387d72010-08-26 10:13:11 -0700760 /**
761 * Full path to the directory where native JNI libraries are stored.
Kenny Root85387d72010-08-26 10:13:11 -0700762 */
763 public String nativeLibraryDir;
764
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800765 /**
Narayan Kamath7dba6eb2014-07-16 08:53:30 +0100766 * Full path where unpacked native libraries for {@link #secondaryCpuAbi}
767 * are stored, if present.
768 *
769 * The main reason this exists is for bundled multi-arch apps, where
770 * it's not trivial to calculate the location of libs for the secondary abi
771 * given the location of the primary.
772 *
773 * TODO: Change the layout of bundled installs so that we can use
774 * nativeLibraryRootDir & nativeLibraryRootRequiresIsa there as well.
775 * (e.g {@code [ "/system/app-lib/Foo/arm", "/system/app-lib/Foo/arm64" ]}
776 * instead of {@code [ "/system/lib/Foo", "/system/lib64/Foo" ]}.
777 *
778 * @hide
779 */
780 public String secondaryNativeLibraryDir;
781
782 /**
Jeff Sharkey84f12942014-07-10 17:48:11 -0700783 * The root path where unpacked native libraries are stored.
784 * <p>
785 * When {@link #nativeLibraryRootRequiresIsa} is set, the libraries are
786 * placed in ISA-specific subdirectories under this path, otherwise the
787 * libraries are placed directly at this path.
Narayan Kamathff110bd2014-07-04 18:30:45 +0100788 *
Jeff Sharkey84f12942014-07-10 17:48:11 -0700789 * @hide
Narayan Kamathff110bd2014-07-04 18:30:45 +0100790 */
Jeff Sharkey84f12942014-07-10 17:48:11 -0700791 public String nativeLibraryRootDir;
792
793 /**
794 * Flag indicating that ISA must be appended to
795 * {@link #nativeLibraryRootDir} to be useful.
796 *
797 * @hide
798 */
799 public boolean nativeLibraryRootRequiresIsa;
Narayan Kamathff110bd2014-07-04 18:30:45 +0100800
801 /**
802 * The primary ABI that this application requires, This is inferred from the ABIs
Ramin Zaghiff0c4702014-04-01 15:02:29 +0100803 * of the native JNI libraries the application bundles. Will be {@code null}
804 * if this application does not require any particular ABI.
805 *
Narayan Kamathff110bd2014-07-04 18:30:45 +0100806 * If non-null, the application will always be launched with this ABI.
807 *
Ramin Zaghiff0c4702014-04-01 15:02:29 +0100808 * {@hide}
809 */
Narayan Kamathff110bd2014-07-04 18:30:45 +0100810 public String primaryCpuAbi;
811
812 /**
813 * The secondary ABI for this application. Might be non-null for multi-arch
814 * installs. The application itself never uses this ABI, but other applications that
815 * use its code might.
816 *
817 * {@hide}
818 */
819 public String secondaryCpuAbi;
820
821 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800822 * The kernel user-ID that has been assigned to this application;
823 * currently this is not a unique ID (multiple applications can have
824 * the same uid).
825 */
826 public int uid;
827
Mitsuru Oshima8d112672009-04-27 12:01:23 -0700828 /**
Todd Kennedy89d60182016-03-11 11:18:32 -0800829 * The minimum SDK version this application can run on. It will not run
830 * on earlier versions.
831 */
Todd Kennedy6e2e7f52016-05-02 14:56:45 -0700832 public int minSdkVersion;
Todd Kennedy89d60182016-03-11 11:18:32 -0800833
834 /**
Dianne Hackborn3b3e1452009-09-24 19:22:12 -0700835 * The minimum SDK version this application targets. It may run on earlier
Dianne Hackborna96cbb42009-05-13 15:06:13 -0700836 * versions, but it knows how to work with any new behavior added at this
837 * version. Will be {@link android.os.Build.VERSION_CODES#CUR_DEVELOPMENT}
838 * if this is a development build and the app is targeting that. You should
839 * compare that this number is >= the SDK version number at which your
840 * behavior was introduced.
841 */
842 public int targetSdkVersion;
Dianne Hackborn8472e612014-01-23 17:57:20 -0800843
844 /**
845 * The app's declared version code.
846 * @hide
847 */
848 public int versionCode;
849
Dianne Hackborna96cbb42009-05-13 15:06:13 -0700850 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800851 * When false, indicates that all components within this application are
852 * considered disabled, regardless of their individually set enabled status.
853 */
854 public boolean enabled = true;
855
Dianne Hackborn54e570f2010-10-04 18:32:32 -0700856 /**
Dianne Hackborn0ac30312011-06-17 14:49:23 -0700857 * For convenient access to the current enabled setting of this app.
858 * @hide
859 */
860 public int enabledSetting = PackageManager.COMPONENT_ENABLED_STATE_DEFAULT;
861
862 /**
Dianne Hackborn54e570f2010-10-04 18:32:32 -0700863 * For convenient access to package's install location.
864 * @hide
865 */
866 public int installLocation = PackageInfo.INSTALL_LOCATION_UNSPECIFIED;
Jose Lima12d0b4c2014-03-14 16:55:12 -0700867
Chad Brubakerc845b2a2016-05-13 14:09:27 -0700868 /**
869 * Resource file providing the application's Network Security Config.
870 * @hide
871 */
872 public int networkSecurityConfigRes;
873
Jeff Sharkey9bc89af2017-01-11 11:25:50 -0700874 /**
Todd Kennedy11e45072017-01-25 13:24:21 -0800875 * Version of the sandbox the application wants to run in.
876 * @hide
877 */
878 public int targetSandboxVersion;
879
880 /**
Jeff Sharkey9bc89af2017-01-11 11:25:50 -0700881 * The category of this app. Categories are used to cluster multiple apps
882 * together into meaningful groups, such as when summarizing battery,
883 * network, or disk usage. Apps should only define this value when they fit
884 * well into one of the specific categories.
885 * <p>
886 * Set from the {@link android.R.attr#appCategory} attribute in the
887 * manifest. If the manifest doesn't define a category, this value may have
888 * been provided by the installer via
889 * {@link PackageManager#setApplicationCategoryHint(String, int)}.
890 */
891 public @Category int category = CATEGORY_UNDEFINED;
892
893 /** {@hide} */
Jeff Sharkey4347f812017-04-21 12:08:39 -0600894 @IntDef(prefix = { "CATEGORY_" }, value = {
Jeff Sharkey9bc89af2017-01-11 11:25:50 -0700895 CATEGORY_UNDEFINED,
896 CATEGORY_GAME,
897 CATEGORY_AUDIO,
898 CATEGORY_VIDEO,
899 CATEGORY_IMAGE,
900 CATEGORY_SOCIAL,
901 CATEGORY_NEWS,
902 CATEGORY_MAPS,
903 CATEGORY_PRODUCTIVITY
904 })
905 @Retention(RetentionPolicy.SOURCE)
906 public @interface Category {
907 }
908
909 /**
910 * Value when category is undefined.
911 *
912 * @see #category
913 */
914 public static final int CATEGORY_UNDEFINED = -1;
915
916 /**
917 * Category for apps which are primarily games.
918 *
919 * @see #category
920 */
921 public static final int CATEGORY_GAME = 0;
922
923 /**
924 * Category for apps which primarily work with audio or music, such as music
925 * players.
926 *
927 * @see #category
928 */
929 public static final int CATEGORY_AUDIO = 1;
930
931 /**
932 * Category for apps which primarily work with video or movies, such as
933 * streaming video apps.
934 *
935 * @see #category
936 */
937 public static final int CATEGORY_VIDEO = 2;
938
939 /**
940 * Category for apps which primarily work with images or photos, such as
941 * camera or gallery apps.
942 *
943 * @see #category
944 */
945 public static final int CATEGORY_IMAGE = 3;
946
947 /**
948 * Category for apps which are primarily social apps, such as messaging,
Jeff Sharkeyd2b69102017-03-21 19:40:38 -0600949 * communication, email, or social network apps.
Jeff Sharkey9bc89af2017-01-11 11:25:50 -0700950 *
951 * @see #category
952 */
953 public static final int CATEGORY_SOCIAL = 4;
954
955 /**
956 * Category for apps which are primarily news apps, such as newspapers,
957 * magazines, or sports apps.
958 *
959 * @see #category
960 */
961 public static final int CATEGORY_NEWS = 5;
962
963 /**
964 * Category for apps which are primarily maps apps, such as navigation apps.
965 *
966 * @see #category
967 */
968 public static final int CATEGORY_MAPS = 6;
969
970 /**
971 * Category for apps which are primarily productivity apps, such as cloud
972 * storage or workplace apps.
973 *
974 * @see #category
975 */
976 public static final int CATEGORY_PRODUCTIVITY = 7;
977
978 /**
979 * Return a concise, localized title for the given
980 * {@link ApplicationInfo#category} value, or {@code null} for unknown
981 * values such as {@link #CATEGORY_UNDEFINED}.
982 *
983 * @see #category
984 */
985 public static CharSequence getCategoryTitle(Context context, @Category int category) {
986 switch (category) {
987 case ApplicationInfo.CATEGORY_GAME:
988 return context.getText(com.android.internal.R.string.app_category_game);
989 case ApplicationInfo.CATEGORY_AUDIO:
990 return context.getText(com.android.internal.R.string.app_category_audio);
991 case ApplicationInfo.CATEGORY_VIDEO:
992 return context.getText(com.android.internal.R.string.app_category_video);
993 case ApplicationInfo.CATEGORY_IMAGE:
994 return context.getText(com.android.internal.R.string.app_category_image);
995 case ApplicationInfo.CATEGORY_SOCIAL:
996 return context.getText(com.android.internal.R.string.app_category_social);
997 case ApplicationInfo.CATEGORY_NEWS:
998 return context.getText(com.android.internal.R.string.app_category_news);
999 case ApplicationInfo.CATEGORY_MAPS:
1000 return context.getText(com.android.internal.R.string.app_category_maps);
1001 case ApplicationInfo.CATEGORY_PRODUCTIVITY:
1002 return context.getText(com.android.internal.R.string.app_category_productivity);
1003 default:
1004 return null;
1005 }
1006 }
1007
Narayan Kamathf9419f02017-06-15 11:35:38 +01001008 /** @hide */
1009 public String classLoaderName;
1010
1011 /** @hide */
1012 public String[] splitClassLoaderNames;
1013
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001014 public void dump(Printer pw, String prefix) {
Dianne Hackborn6ac42ae2015-12-08 17:22:10 -08001015 dump(pw, prefix, DUMP_FLAG_ALL);
1016 }
1017
1018 /** @hide */
1019 public void dump(Printer pw, String prefix, int flags) {
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001020 super.dumpFront(pw, prefix);
Dianne Hackborn6ac42ae2015-12-08 17:22:10 -08001021 if ((flags&DUMP_FLAG_DETAILS) != 0 && className != null) {
Dianne Hackborn12527f92009-11-11 17:39:50 -08001022 pw.println(prefix + "className=" + className);
1023 }
1024 if (permission != null) {
1025 pw.println(prefix + "permission=" + permission);
1026 }
Dianne Hackborn39792d22010-08-19 18:01:52 -07001027 pw.println(prefix + "processName=" + processName);
Dianne Hackborn6ac42ae2015-12-08 17:22:10 -08001028 if ((flags&DUMP_FLAG_DETAILS) != 0) {
1029 pw.println(prefix + "taskAffinity=" + taskAffinity);
1030 }
Dianne Hackborn39792d22010-08-19 18:01:52 -07001031 pw.println(prefix + "uid=" + uid + " flags=0x" + Integer.toHexString(flags)
Alex Klyubinb9f8a522015-02-03 11:12:59 -08001032 + " privateFlags=0x" + Integer.toHexString(privateFlags)
Dianne Hackborn39792d22010-08-19 18:01:52 -07001033 + " theme=0x" + Integer.toHexString(theme));
Dianne Hackborn6ac42ae2015-12-08 17:22:10 -08001034 if ((flags&DUMP_FLAG_DETAILS) != 0) {
1035 pw.println(prefix + "requiresSmallestWidthDp=" + requiresSmallestWidthDp
1036 + " compatibleWidthLimitDp=" + compatibleWidthLimitDp
1037 + " largestWidthLimitDp=" + largestWidthLimitDp);
1038 }
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001039 pw.println(prefix + "sourceDir=" + sourceDir);
Jeff Sharkey8a4c9722014-06-16 13:48:42 -07001040 if (!Objects.equals(sourceDir, publicSourceDir)) {
Dianne Hackborn39792d22010-08-19 18:01:52 -07001041 pw.println(prefix + "publicSourceDir=" + publicSourceDir);
1042 }
Jeff Sharkey8a4c9722014-06-16 13:48:42 -07001043 if (!ArrayUtils.isEmpty(splitSourceDirs)) {
1044 pw.println(prefix + "splitSourceDirs=" + Arrays.toString(splitSourceDirs));
1045 }
1046 if (!ArrayUtils.isEmpty(splitPublicSourceDirs)
1047 && !Arrays.equals(splitSourceDirs, splitPublicSourceDirs)) {
1048 pw.println(prefix + "splitPublicSourceDirs=" + Arrays.toString(splitPublicSourceDirs));
1049 }
Dianne Hackborn39792d22010-08-19 18:01:52 -07001050 if (resourceDirs != null) {
Andreas Gampee6748ce2015-12-11 18:00:38 -08001051 pw.println(prefix + "resourceDirs=" + Arrays.toString(resourceDirs));
Dianne Hackborn39792d22010-08-19 18:01:52 -07001052 }
Todd Kennedybe0b8892017-02-15 14:13:52 -08001053 if ((flags&DUMP_FLAG_DETAILS) != 0 && seInfo != null) {
1054 pw.println(prefix + "seinfo=" + seInfo);
1055 pw.println(prefix + "seinfoUser=" + seInfoUser);
Robert Craig0f40dc92013-03-25 06:33:03 -04001056 }
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001057 pw.println(prefix + "dataDir=" + dataDir);
Dianne Hackborn6ac42ae2015-12-08 17:22:10 -08001058 if ((flags&DUMP_FLAG_DETAILS) != 0) {
Jeff Sharkey8a372a02016-03-16 16:25:45 -06001059 pw.println(prefix + "deviceProtectedDataDir=" + deviceProtectedDataDir);
1060 pw.println(prefix + "credentialProtectedDataDir=" + credentialProtectedDataDir);
Dianne Hackborn6ac42ae2015-12-08 17:22:10 -08001061 if (sharedLibraryFiles != null) {
1062 pw.println(prefix + "sharedLibraryFiles=" + Arrays.toString(sharedLibraryFiles));
1063 }
Dianne Hackborn12527f92009-11-11 17:39:50 -08001064 }
Narayan Kamathf9419f02017-06-15 11:35:38 +01001065 if (classLoaderName != null) {
1066 pw.println(prefix + "classLoaderName=" + classLoaderName);
1067 }
1068 if (!ArrayUtils.isEmpty(splitClassLoaderNames)) {
1069 pw.println(prefix + "splitClassLoaderNames=" + Arrays.toString(splitClassLoaderNames));
1070 }
1071
Todd Kennedy89d60182016-03-11 11:18:32 -08001072 pw.println(prefix + "enabled=" + enabled
1073 + " minSdkVersion=" + minSdkVersion
1074 + " targetSdkVersion=" + targetSdkVersion
Todd Kennedy11e45072017-01-25 13:24:21 -08001075 + " versionCode=" + versionCode
1076 + " targetSandboxVersion=" + targetSandboxVersion);
Dianne Hackborn6ac42ae2015-12-08 17:22:10 -08001077 if ((flags&DUMP_FLAG_DETAILS) != 0) {
1078 if (manageSpaceActivityName != null) {
1079 pw.println(prefix + "manageSpaceActivityName=" + manageSpaceActivityName);
1080 }
1081 if (descriptionRes != 0) {
1082 pw.println(prefix + "description=0x" + Integer.toHexString(descriptionRes));
1083 }
1084 if (uiOptions != 0) {
1085 pw.println(prefix + "uiOptions=0x" + Integer.toHexString(uiOptions));
1086 }
1087 pw.println(prefix + "supportsRtl=" + (hasRtlSupport() ? "true" : "false"));
1088 if (fullBackupContent > 0) {
1089 pw.println(prefix + "fullBackupContent=@xml/" + fullBackupContent);
1090 } else {
1091 pw.println(prefix + "fullBackupContent="
1092 + (fullBackupContent < 0 ? "false" : "true"));
1093 }
Chad Brubakerc845b2a2016-05-13 14:09:27 -07001094 if (networkSecurityConfigRes != 0) {
1095 pw.println(prefix + "networkSecurityConfigRes=0x"
1096 + Integer.toHexString(networkSecurityConfigRes));
1097 }
Jeff Sharkey9bc89af2017-01-11 11:25:50 -07001098 if (category != CATEGORY_UNDEFINED) {
1099 pw.println(prefix + "category=" + category);
1100 }
Matthew Williams303650c2015-04-17 18:22:51 -07001101 }
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001102 super.dumpBack(pw, prefix);
1103 }
Fabrice Di Meglio59dfce82012-04-02 16:17:20 -07001104
1105 /**
1106 * @return true if "supportsRtl" has been set to true in the AndroidManifest
1107 * @hide
1108 */
1109 public boolean hasRtlSupport() {
1110 return (flags & FLAG_SUPPORTS_RTL) == FLAG_SUPPORTS_RTL;
1111 }
Jeff Sharkeyba75a9b2016-01-07 11:51:33 -07001112
1113 /** {@hide} */
1114 public boolean hasCode() {
1115 return (flags & FLAG_HAS_CODE) != 0;
1116 }
1117
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001118 public static class DisplayNameComparator
1119 implements Comparator<ApplicationInfo> {
1120 public DisplayNameComparator(PackageManager pm) {
1121 mPM = pm;
1122 }
1123
1124 public final int compare(ApplicationInfo aa, ApplicationInfo ab) {
1125 CharSequence sa = mPM.getApplicationLabel(aa);
1126 if (sa == null) {
1127 sa = aa.packageName;
1128 }
1129 CharSequence sb = mPM.getApplicationLabel(ab);
1130 if (sb == null) {
1131 sb = ab.packageName;
1132 }
1133
1134 return sCollator.compare(sa.toString(), sb.toString());
1135 }
1136
1137 private final Collator sCollator = Collator.getInstance();
1138 private PackageManager mPM;
1139 }
1140
1141 public ApplicationInfo() {
1142 }
1143
1144 public ApplicationInfo(ApplicationInfo orig) {
1145 super(orig);
1146 taskAffinity = orig.taskAffinity;
1147 permission = orig.permission;
1148 processName = orig.processName;
1149 className = orig.className;
1150 theme = orig.theme;
1151 flags = orig.flags;
Alex Klyubinb9f8a522015-02-03 11:12:59 -08001152 privateFlags = orig.privateFlags;
Dianne Hackborndf6e9802011-05-26 14:20:23 -07001153 requiresSmallestWidthDp = orig.requiresSmallestWidthDp;
1154 compatibleWidthLimitDp = orig.compatibleWidthLimitDp;
Dianne Hackborn2762ff32011-06-01 21:27:05 -07001155 largestWidthLimitDp = orig.largestWidthLimitDp;
Jeff Sharkeyb2b9ab82015-04-05 21:10:42 -07001156 volumeUuid = orig.volumeUuid;
Jeff Sharkey789a8fc2017-04-16 13:18:35 -06001157 storageUuid = orig.storageUuid;
Jeff Sharkey7f1a57a2014-10-08 10:14:53 -07001158 scanSourceDir = orig.scanSourceDir;
1159 scanPublicSourceDir = orig.scanPublicSourceDir;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001160 sourceDir = orig.sourceDir;
1161 publicSourceDir = orig.publicSourceDir;
Adam Lesinski4e862812016-11-21 16:02:24 -08001162 splitNames = orig.splitNames;
Jeff Sharkey8a4c9722014-06-16 13:48:42 -07001163 splitSourceDirs = orig.splitSourceDirs;
1164 splitPublicSourceDirs = orig.splitPublicSourceDirs;
Adam Lesinski4e862812016-11-21 16:02:24 -08001165 splitDependencies = orig.splitDependencies;
Kenny Root85387d72010-08-26 10:13:11 -07001166 nativeLibraryDir = orig.nativeLibraryDir;
Narayan Kamath7dba6eb2014-07-16 08:53:30 +01001167 secondaryNativeLibraryDir = orig.secondaryNativeLibraryDir;
Jeff Sharkey84f12942014-07-10 17:48:11 -07001168 nativeLibraryRootDir = orig.nativeLibraryRootDir;
1169 nativeLibraryRootRequiresIsa = orig.nativeLibraryRootRequiresIsa;
Narayan Kamathff110bd2014-07-04 18:30:45 +01001170 primaryCpuAbi = orig.primaryCpuAbi;
1171 secondaryCpuAbi = orig.secondaryCpuAbi;
Kenny Rootd1ab0162010-01-21 17:27:14 -08001172 resourceDirs = orig.resourceDirs;
Todd Kennedybe0b8892017-02-15 14:13:52 -08001173 seInfo = orig.seInfo;
1174 seInfoUser = orig.seInfoUser;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001175 sharedLibraryFiles = orig.sharedLibraryFiles;
1176 dataDir = orig.dataDir;
Jeff Sharkeydd9bda82017-02-23 17:38:31 -07001177 deviceProtectedDataDir = orig.deviceProtectedDataDir;
1178 credentialProtectedDataDir = orig.credentialProtectedDataDir;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001179 uid = orig.uid;
Todd Kennedy89d60182016-03-11 11:18:32 -08001180 minSdkVersion = orig.minSdkVersion;
Dianne Hackborna96cbb42009-05-13 15:06:13 -07001181 targetSdkVersion = orig.targetSdkVersion;
Dianne Hackborn8472e612014-01-23 17:57:20 -08001182 versionCode = orig.versionCode;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001183 enabled = orig.enabled;
Dianne Hackborn0ac30312011-06-17 14:49:23 -07001184 enabledSetting = orig.enabledSetting;
Dianne Hackborn54e570f2010-10-04 18:32:32 -07001185 installLocation = orig.installLocation;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001186 manageSpaceActivityName = orig.manageSpaceActivityName;
1187 descriptionRes = orig.descriptionRes;
Adam Powell269248d2011-08-02 10:26:54 -07001188 uiOptions = orig.uiOptions;
Christopher Tatebcb02552012-10-16 17:14:34 -07001189 backupAgentName = orig.backupAgentName;
Matthew Williams303650c2015-04-17 18:22:51 -07001190 fullBackupContent = orig.fullBackupContent;
Chad Brubakerc845b2a2016-05-13 14:09:27 -07001191 networkSecurityConfigRes = orig.networkSecurityConfigRes;
Jeff Sharkey9bc89af2017-01-11 11:25:50 -07001192 category = orig.category;
Todd Kennedy11e45072017-01-25 13:24:21 -08001193 targetSandboxVersion = orig.targetSandboxVersion;
Narayan Kamathf9419f02017-06-15 11:35:38 +01001194 classLoaderName = orig.classLoaderName;
1195 splitClassLoaderNames = orig.splitClassLoaderNames;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001196 }
1197
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001198 public String toString() {
1199 return "ApplicationInfo{"
1200 + Integer.toHexString(System.identityHashCode(this))
1201 + " " + packageName + "}";
1202 }
1203
1204 public int describeContents() {
1205 return 0;
1206 }
1207
Adam Lesinski4e862812016-11-21 16:02:24 -08001208 @SuppressWarnings("unchecked")
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001209 public void writeToParcel(Parcel dest, int parcelableFlags) {
1210 super.writeToParcel(dest, parcelableFlags);
1211 dest.writeString(taskAffinity);
1212 dest.writeString(permission);
1213 dest.writeString(processName);
1214 dest.writeString(className);
1215 dest.writeInt(theme);
1216 dest.writeInt(flags);
Alex Klyubinb9f8a522015-02-03 11:12:59 -08001217 dest.writeInt(privateFlags);
Dianne Hackborndf6e9802011-05-26 14:20:23 -07001218 dest.writeInt(requiresSmallestWidthDp);
1219 dest.writeInt(compatibleWidthLimitDp);
Dianne Hackborn2762ff32011-06-01 21:27:05 -07001220 dest.writeInt(largestWidthLimitDp);
Jeff Sharkey67c8c1e2017-04-19 11:22:02 -06001221 if (storageUuid != null) {
1222 dest.writeInt(1);
Jeff Sharkeya4d34d92017-04-27 11:21:41 -06001223 dest.writeLong(storageUuid.getMostSignificantBits());
1224 dest.writeLong(storageUuid.getLeastSignificantBits());
Jeff Sharkey67c8c1e2017-04-19 11:22:02 -06001225 } else {
1226 dest.writeInt(0);
1227 }
Jeff Sharkey7f1a57a2014-10-08 10:14:53 -07001228 dest.writeString(scanSourceDir);
1229 dest.writeString(scanPublicSourceDir);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001230 dest.writeString(sourceDir);
1231 dest.writeString(publicSourceDir);
Adam Lesinski4e862812016-11-21 16:02:24 -08001232 dest.writeStringArray(splitNames);
Jeff Sharkey8a4c9722014-06-16 13:48:42 -07001233 dest.writeStringArray(splitSourceDirs);
1234 dest.writeStringArray(splitPublicSourceDirs);
Adam Lesinski1665d0f2017-03-10 14:46:57 -08001235 dest.writeSparseArray((SparseArray) splitDependencies);
Kenny Root85387d72010-08-26 10:13:11 -07001236 dest.writeString(nativeLibraryDir);
Narayan Kamath7dba6eb2014-07-16 08:53:30 +01001237 dest.writeString(secondaryNativeLibraryDir);
Jeff Sharkey84f12942014-07-10 17:48:11 -07001238 dest.writeString(nativeLibraryRootDir);
1239 dest.writeInt(nativeLibraryRootRequiresIsa ? 1 : 0);
Narayan Kamathff110bd2014-07-04 18:30:45 +01001240 dest.writeString(primaryCpuAbi);
1241 dest.writeString(secondaryCpuAbi);
Kenny Rootd1ab0162010-01-21 17:27:14 -08001242 dest.writeStringArray(resourceDirs);
Todd Kennedybe0b8892017-02-15 14:13:52 -08001243 dest.writeString(seInfo);
1244 dest.writeString(seInfoUser);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001245 dest.writeStringArray(sharedLibraryFiles);
1246 dest.writeString(dataDir);
Jeff Sharkey8a372a02016-03-16 16:25:45 -06001247 dest.writeString(deviceProtectedDataDir);
1248 dest.writeString(credentialProtectedDataDir);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001249 dest.writeInt(uid);
Todd Kennedy6e2e7f52016-05-02 14:56:45 -07001250 dest.writeInt(minSdkVersion);
Dianne Hackborna96cbb42009-05-13 15:06:13 -07001251 dest.writeInt(targetSdkVersion);
Dianne Hackborn8472e612014-01-23 17:57:20 -08001252 dest.writeInt(versionCode);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001253 dest.writeInt(enabled ? 1 : 0);
Dianne Hackborn0ac30312011-06-17 14:49:23 -07001254 dest.writeInt(enabledSetting);
Dianne Hackborn54e570f2010-10-04 18:32:32 -07001255 dest.writeInt(installLocation);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001256 dest.writeString(manageSpaceActivityName);
Christopher Tate181fafa2009-05-14 11:12:14 -07001257 dest.writeString(backupAgentName);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001258 dest.writeInt(descriptionRes);
Adam Powell269248d2011-08-02 10:26:54 -07001259 dest.writeInt(uiOptions);
Matthew Williams303650c2015-04-17 18:22:51 -07001260 dest.writeInt(fullBackupContent);
Chad Brubakerc845b2a2016-05-13 14:09:27 -07001261 dest.writeInt(networkSecurityConfigRes);
Jeff Sharkey9bc89af2017-01-11 11:25:50 -07001262 dest.writeInt(category);
Todd Kennedy11e45072017-01-25 13:24:21 -08001263 dest.writeInt(targetSandboxVersion);
Narayan Kamathf9419f02017-06-15 11:35:38 +01001264 dest.writeString(classLoaderName);
1265 dest.writeStringArray(splitClassLoaderNames);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001266 }
1267
1268 public static final Parcelable.Creator<ApplicationInfo> CREATOR
1269 = new Parcelable.Creator<ApplicationInfo>() {
1270 public ApplicationInfo createFromParcel(Parcel source) {
1271 return new ApplicationInfo(source);
1272 }
1273 public ApplicationInfo[] newArray(int size) {
1274 return new ApplicationInfo[size];
1275 }
1276 };
1277
Adam Lesinski4e862812016-11-21 16:02:24 -08001278 @SuppressWarnings("unchecked")
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001279 private ApplicationInfo(Parcel source) {
1280 super(source);
1281 taskAffinity = source.readString();
1282 permission = source.readString();
1283 processName = source.readString();
1284 className = source.readString();
1285 theme = source.readInt();
1286 flags = source.readInt();
Alex Klyubinb9f8a522015-02-03 11:12:59 -08001287 privateFlags = source.readInt();
Dianne Hackborndf6e9802011-05-26 14:20:23 -07001288 requiresSmallestWidthDp = source.readInt();
1289 compatibleWidthLimitDp = source.readInt();
Dianne Hackborn2762ff32011-06-01 21:27:05 -07001290 largestWidthLimitDp = source.readInt();
Jeff Sharkey67c8c1e2017-04-19 11:22:02 -06001291 if (source.readInt() != 0) {
Jeff Sharkeya4d34d92017-04-27 11:21:41 -06001292 storageUuid = new UUID(source.readLong(), source.readLong());
Jeff Sharkey67c8c1e2017-04-19 11:22:02 -06001293 volumeUuid = StorageManager.convert(storageUuid);
1294 }
Jeff Sharkey7f1a57a2014-10-08 10:14:53 -07001295 scanSourceDir = source.readString();
1296 scanPublicSourceDir = source.readString();
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001297 sourceDir = source.readString();
1298 publicSourceDir = source.readString();
Adam Lesinski4e862812016-11-21 16:02:24 -08001299 splitNames = source.readStringArray();
Jeff Sharkey8a4c9722014-06-16 13:48:42 -07001300 splitSourceDirs = source.readStringArray();
1301 splitPublicSourceDirs = source.readStringArray();
Adam Lesinski1665d0f2017-03-10 14:46:57 -08001302 splitDependencies = source.readSparseArray(null);
Kenny Root85387d72010-08-26 10:13:11 -07001303 nativeLibraryDir = source.readString();
Narayan Kamath7dba6eb2014-07-16 08:53:30 +01001304 secondaryNativeLibraryDir = source.readString();
Jeff Sharkey84f12942014-07-10 17:48:11 -07001305 nativeLibraryRootDir = source.readString();
1306 nativeLibraryRootRequiresIsa = source.readInt() != 0;
Narayan Kamathff110bd2014-07-04 18:30:45 +01001307 primaryCpuAbi = source.readString();
1308 secondaryCpuAbi = source.readString();
Kenny Rootd1ab0162010-01-21 17:27:14 -08001309 resourceDirs = source.readStringArray();
Todd Kennedybe0b8892017-02-15 14:13:52 -08001310 seInfo = source.readString();
1311 seInfoUser = source.readString();
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001312 sharedLibraryFiles = source.readStringArray();
1313 dataDir = source.readString();
Jeff Sharkeydd9bda82017-02-23 17:38:31 -07001314 deviceProtectedDataDir = source.readString();
1315 credentialProtectedDataDir = source.readString();
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001316 uid = source.readInt();
Todd Kennedy6e2e7f52016-05-02 14:56:45 -07001317 minSdkVersion = source.readInt();
Dianne Hackborna96cbb42009-05-13 15:06:13 -07001318 targetSdkVersion = source.readInt();
Dianne Hackborn8472e612014-01-23 17:57:20 -08001319 versionCode = source.readInt();
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001320 enabled = source.readInt() != 0;
Dianne Hackborn0ac30312011-06-17 14:49:23 -07001321 enabledSetting = source.readInt();
Dianne Hackborn54e570f2010-10-04 18:32:32 -07001322 installLocation = source.readInt();
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001323 manageSpaceActivityName = source.readString();
Christopher Tate181fafa2009-05-14 11:12:14 -07001324 backupAgentName = source.readString();
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001325 descriptionRes = source.readInt();
Adam Powell269248d2011-08-02 10:26:54 -07001326 uiOptions = source.readInt();
Matthew Williams303650c2015-04-17 18:22:51 -07001327 fullBackupContent = source.readInt();
Chad Brubakerc845b2a2016-05-13 14:09:27 -07001328 networkSecurityConfigRes = source.readInt();
Jeff Sharkey9bc89af2017-01-11 11:25:50 -07001329 category = source.readInt();
Todd Kennedy11e45072017-01-25 13:24:21 -08001330 targetSandboxVersion = source.readInt();
Narayan Kamathf9419f02017-06-15 11:35:38 +01001331 classLoaderName = source.readString();
1332 splitClassLoaderNames = source.readStringArray();
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001333 }
Mitsuru Oshima8d112672009-04-27 12:01:23 -07001334
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001335 /**
1336 * Retrieve the textual description of the application. This
1337 * will call back on the given PackageManager to load the description from
1338 * the application.
1339 *
1340 * @param pm A PackageManager from which the label can be loaded; usually
1341 * the PackageManager from which you originally retrieved this item.
1342 *
1343 * @return Returns a CharSequence containing the application's description.
1344 * If there is no description, null is returned.
1345 */
1346 public CharSequence loadDescription(PackageManager pm) {
1347 if (descriptionRes != 0) {
Jeff Brown07330792010-03-30 19:57:08 -07001348 CharSequence label = pm.getText(packageName, descriptionRes, this);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001349 if (label != null) {
1350 return label;
1351 }
1352 }
1353 return null;
1354 }
Mitsuru Oshimae5fb3282009-06-09 21:16:08 -07001355
1356 /**
1357 * Disable compatibility mode
1358 *
1359 * @hide
1360 */
1361 public void disableCompatibilityMode() {
Mitsuru Oshima69fff4a2009-07-21 09:51:05 -07001362 flags |= (FLAG_SUPPORTS_LARGE_SCREENS | FLAG_SUPPORTS_NORMAL_SCREENS |
Dianne Hackborn11b822d2009-07-21 20:03:02 -07001363 FLAG_SUPPORTS_SMALL_SCREENS | FLAG_RESIZEABLE_FOR_SCREENS |
Dianne Hackborn14cee9f2010-04-23 17:51:26 -07001364 FLAG_SUPPORTS_SCREEN_DENSITIES | FLAG_SUPPORTS_XLARGE_SCREENS);
Mitsuru Oshimae5fb3282009-06-09 21:16:08 -07001365 }
Jeff Sharkey15447792015-11-05 16:18:51 -08001366
skuhne@google.com7e85eb02017-01-04 13:49:54 -08001367 /**
1368 * Is using compatibility mode for non densty aware legacy applications.
1369 *
1370 * @hide
1371 */
1372 public boolean usesCompatibilityMode() {
1373 return targetSdkVersion < DONUT ||
1374 (flags & (FLAG_SUPPORTS_LARGE_SCREENS | FLAG_SUPPORTS_NORMAL_SCREENS |
1375 FLAG_SUPPORTS_SMALL_SCREENS | FLAG_RESIZEABLE_FOR_SCREENS |
1376 FLAG_SUPPORTS_SCREEN_DENSITIES | FLAG_SUPPORTS_XLARGE_SCREENS)) == 0;
1377 }
1378
Jeff Sharkey15447792015-11-05 16:18:51 -08001379 /** {@hide} */
1380 public void initForUser(int userId) {
1381 uid = UserHandle.getUid(userId, UserHandle.getAppId(uid));
1382
1383 if ("android".equals(packageName)) {
1384 dataDir = Environment.getDataSystemDirectory().getAbsolutePath();
1385 return;
1386 }
1387
Jeff Sharkeydd9bda82017-02-23 17:38:31 -07001388 deviceProtectedDataDir = Environment
Jeff Sharkey8212ae02016-02-10 14:46:43 -07001389 .getDataUserDePackageDirectory(volumeUuid, userId, packageName)
Jeff Sharkey15447792015-11-05 16:18:51 -08001390 .getAbsolutePath();
Jeff Sharkeydd9bda82017-02-23 17:38:31 -07001391 credentialProtectedDataDir = Environment
Jeff Sharkey8212ae02016-02-10 14:46:43 -07001392 .getDataUserCePackageDirectory(volumeUuid, userId, packageName)
Jeff Sharkey15447792015-11-05 16:18:51 -08001393 .getAbsolutePath();
1394
Jeff Sharkey8a372a02016-03-16 16:25:45 -06001395 if ((privateFlags & PRIVATE_FLAG_DEFAULT_TO_DEVICE_PROTECTED_STORAGE) != 0
1396 && PackageManager.APPLY_DEFAULT_TO_DEVICE_PROTECTED_STORAGE) {
1397 dataDir = deviceProtectedDataDir;
Jeff Sharkey15447792015-11-05 16:18:51 -08001398 } else {
Jeff Sharkey8a372a02016-03-16 16:25:45 -06001399 dataDir = credentialProtectedDataDir;
Jeff Sharkey15447792015-11-05 16:18:51 -08001400 }
1401 }
1402
Jeff Brown07330792010-03-30 19:57:08 -07001403 /**
1404 * @hide
1405 */
Alexandra Gherghinaa7093142014-07-30 13:43:39 +01001406 @Override
1407 public Drawable loadDefaultIcon(PackageManager pm) {
Jeff Brown07330792010-03-30 19:57:08 -07001408 if ((flags & FLAG_EXTERNAL_STORAGE) != 0
1409 && isPackageUnavailable(pm)) {
1410 return Resources.getSystem().getDrawable(
1411 com.android.internal.R.drawable.sym_app_on_sd_unavailable_icon);
1412 }
1413 return pm.getDefaultActivityIcon();
1414 }
1415
1416 private boolean isPackageUnavailable(PackageManager pm) {
1417 try {
1418 return pm.getPackageInfo(packageName, 0) == null;
1419 } catch (NameNotFoundException ex) {
1420 return true;
1421 }
1422 }
Jeff Sharkeyd7460572014-07-06 20:44:55 -07001423
Jeff Brown07330792010-03-30 19:57:08 -07001424 /**
1425 * @hide
1426 */
Fyodor Kupoloveeea67b2015-02-23 17:14:45 -08001427 public boolean isForwardLocked() {
1428 return (privateFlags & ApplicationInfo.PRIVATE_FLAG_FORWARD_LOCK) != 0;
1429 }
1430
1431 /**
1432 * @hide
1433 */
Jeff Sharkeya73b8fd2016-01-06 17:02:08 -07001434 @TestApi
Fyodor Kupolovb94c1652015-03-03 12:25:30 -08001435 public boolean isSystemApp() {
1436 return (flags & ApplicationInfo.FLAG_SYSTEM) != 0;
1437 }
1438
1439 /**
1440 * @hide
1441 */
Jeff Sharkeya73b8fd2016-01-06 17:02:08 -07001442 @TestApi
Svet Ganovadc1cf42015-06-15 16:36:24 -07001443 public boolean isPrivilegedApp() {
1444 return (privateFlags & ApplicationInfo.PRIVATE_FLAG_PRIVILEGED) != 0;
1445 }
1446
1447 /**
1448 * @hide
1449 */
Fyodor Kupolovb94c1652015-03-03 12:25:30 -08001450 public boolean isUpdatedSystemApp() {
1451 return (flags & ApplicationInfo.FLAG_UPDATED_SYSTEM_APP) != 0;
1452 }
1453
Jeff Sharkeye2d45be2015-04-15 17:14:12 -07001454 /** @hide */
1455 public boolean isInternal() {
1456 return (flags & ApplicationInfo.FLAG_EXTERNAL_STORAGE) == 0;
1457 }
1458
1459 /** @hide */
1460 public boolean isExternalAsec() {
1461 return TextUtils.isEmpty(volumeUuid)
1462 && (flags & ApplicationInfo.FLAG_EXTERNAL_STORAGE) != 0;
1463 }
1464
Jeff Sharkeyf9fc6d62015-11-08 16:46:05 -08001465 /** @hide */
Jeff Sharkey8a372a02016-03-16 16:25:45 -06001466 public boolean isDefaultToDeviceProtectedStorage() {
1467 return (privateFlags
1468 & ApplicationInfo.PRIVATE_FLAG_DEFAULT_TO_DEVICE_PROTECTED_STORAGE) != 0;
Jeff Sharkeye4697132016-02-06 19:46:15 -07001469 }
1470
1471 /** @hide */
Jeff Sharkey8a372a02016-03-16 16:25:45 -06001472 public boolean isDirectBootAware() {
1473 return (privateFlags & ApplicationInfo.PRIVATE_FLAG_DIRECT_BOOT_AWARE) != 0;
Jeff Sharkeyf9fc6d62015-11-08 16:46:05 -08001474 }
1475
Jeff Sharkey8924e872015-11-30 12:52:10 -07001476 /** @hide */
Jeff Sharkey8a372a02016-03-16 16:25:45 -06001477 public boolean isPartiallyDirectBootAware() {
1478 return (privateFlags & ApplicationInfo.PRIVATE_FLAG_PARTIALLY_DIRECT_BOOT_AWARE) != 0;
Jeff Sharkey8924e872015-11-30 12:52:10 -07001479 }
1480
Fyodor Kupolovb94c1652015-03-03 12:25:30 -08001481 /**
1482 * @hide
1483 */
Svetoslav Ganov096d3042017-01-30 16:34:13 -08001484 public boolean isInstantApp() {
Todd Kennedybe0b8892017-02-15 14:13:52 -08001485 return (privateFlags & ApplicationInfo.PRIVATE_FLAG_INSTANT) != 0;
Svet Ganov2acf0632015-11-24 19:10:59 -08001486 }
1487
1488 /**
1489 * @hide
1490 */
Fyodor Kupolovbdbc9692015-12-14 13:11:13 -08001491 public boolean isRequiredForSystemUser() {
1492 return (privateFlags & ApplicationInfo.PRIVATE_FLAG_REQUIRED_FOR_SYSTEM_USER) != 0;
1493 }
1494
1495 /**
Adam Lesinski4e862812016-11-21 16:02:24 -08001496 * Returns true if the app has declared in its manifest that it wants its split APKs to be
1497 * loaded into isolated Contexts, with their own ClassLoaders and Resources objects.
1498 * @hide
1499 */
1500 public boolean requestsIsolatedSplitLoading() {
1501 return (privateFlags & ApplicationInfo.PRIVATE_FLAG_ISOLATED_SPLIT_LOADING) != 0;
1502 }
1503
1504 /**
Fyodor Kupolovbdbc9692015-12-14 13:11:13 -08001505 * @hide
1506 */
Svet Ganov67882122016-12-11 16:36:34 -08001507 public boolean isStaticSharedLibrary() {
1508 return (privateFlags & ApplicationInfo.PRIVATE_FLAG_STATIC_SHARED_LIBRARY) != 0;
1509 }
1510
1511 /**
1512 * @hide
1513 */
Jeff Brown07330792010-03-30 19:57:08 -07001514 @Override protected ApplicationInfo getApplicationInfo() {
1515 return this;
1516 }
Jeff Sharkeyd7460572014-07-06 20:44:55 -07001517
1518 /** {@hide} */ public void setCodePath(String codePath) { scanSourceDir = codePath; }
1519 /** {@hide} */ public void setBaseCodePath(String baseCodePath) { sourceDir = baseCodePath; }
1520 /** {@hide} */ public void setSplitCodePaths(String[] splitCodePaths) { splitSourceDirs = splitCodePaths; }
1521 /** {@hide} */ public void setResourcePath(String resourcePath) { scanPublicSourceDir = resourcePath; }
1522 /** {@hide} */ public void setBaseResourcePath(String baseResourcePath) { publicSourceDir = baseResourcePath; }
1523 /** {@hide} */ public void setSplitResourcePaths(String[] splitResourcePaths) { splitPublicSourceDirs = splitResourcePaths; }
1524
1525 /** {@hide} */ public String getCodePath() { return scanSourceDir; }
1526 /** {@hide} */ public String getBaseCodePath() { return sourceDir; }
1527 /** {@hide} */ public String[] getSplitCodePaths() { return splitSourceDirs; }
1528 /** {@hide} */ public String getResourcePath() { return scanPublicSourceDir; }
1529 /** {@hide} */ public String getBaseResourcePath() { return publicSourceDir; }
Jeff Sharkeya3a43b02016-11-15 17:54:23 -07001530 /** {@hide} */ public String[] getSplitResourcePaths() { return splitPublicSourceDirs; }
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001531}