blob: 4939fb653301fd14839de07a0927964f4fc68688 [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 Brown07330792010-03-30 19:57:08 -070019import android.content.pm.PackageManager.NameNotFoundException;
20import android.content.res.Resources;
21import android.graphics.drawable.Drawable;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080022import android.os.Parcel;
23import android.os.Parcelable;
24import android.util.Printer;
25
Jeff Sharkey8a4c9722014-06-16 13:48:42 -070026import com.android.internal.util.ArrayUtils;
27
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080028import java.text.Collator;
Jeff Sharkey8a4c9722014-06-16 13:48:42 -070029import java.util.Arrays;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080030import java.util.Comparator;
Jeff Sharkey8a4c9722014-06-16 13:48:42 -070031import java.util.Objects;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080032
33/**
34 * Information you can retrieve about a particular application. This
35 * corresponds to information collected from the AndroidManifest.xml's
36 * <application> tag.
37 */
38public class ApplicationInfo extends PackageItemInfo implements Parcelable {
39
40 /**
41 * Default task affinity of all activities in this application. See
42 * {@link ActivityInfo#taskAffinity} for more information. This comes
43 * from the "taskAffinity" attribute.
44 */
45 public String taskAffinity;
46
47 /**
48 * Optional name of a permission required to be able to access this
49 * application's components. From the "permission" attribute.
50 */
51 public String permission;
52
53 /**
54 * The name of the process this application should run in. From the
55 * "process" attribute or, if not set, the same as
56 * <var>packageName</var>.
57 */
58 public String processName;
59
60 /**
61 * Class implementing the Application object. From the "class"
62 * attribute.
63 */
64 public String className;
65
66 /**
67 * A style resource identifier (in the package's resources) of the
68 * description of an application. From the "description" attribute
69 * or, if not set, 0.
70 */
71 public int descriptionRes;
72
73 /**
74 * A style resource identifier (in the package's resources) of the
75 * default visual theme of the application. From the "theme" attribute
76 * or, if not set, 0.
77 */
78 public int theme;
79
80 /**
81 * Class implementing the Application's manage space
82 * functionality. From the "manageSpaceActivity"
83 * attribute. This is an optional attribute and will be null if
Christopher Tate181fafa2009-05-14 11:12:14 -070084 * applications don't specify it in their manifest
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080085 */
86 public String manageSpaceActivityName;
87
88 /**
Christopher Tate181fafa2009-05-14 11:12:14 -070089 * Class implementing the Application's backup functionality. From
90 * the "backupAgent" attribute. This is an optional attribute and
91 * will be null if the application does not specify it in its manifest.
92 *
93 * <p>If android:allowBackup is set to false, this attribute is ignored.
Christopher Tate181fafa2009-05-14 11:12:14 -070094 */
95 public String backupAgentName;
Christopher Tate4a627c72011-04-01 14:43:32 -070096
97 /**
Adam Powell269248d2011-08-02 10:26:54 -070098 * The default extra UI options for activities in this application.
99 * Set from the {@link android.R.attr#uiOptions} attribute in the
100 * activity's manifest.
101 */
102 public int uiOptions = 0;
103
104 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800105 * Value for {@link #flags}: if set, this application is installed in the
106 * device's system image.
107 */
108 public static final int FLAG_SYSTEM = 1<<0;
109
110 /**
111 * Value for {@link #flags}: set to true if this application would like to
112 * allow debugging of its
113 * code, even when installed on a non-development system. Comes
114 * from {@link android.R.styleable#AndroidManifestApplication_debuggable
115 * android:debuggable} of the &lt;application&gt; tag.
116 */
117 public static final int FLAG_DEBUGGABLE = 1<<1;
118
119 /**
120 * Value for {@link #flags}: set to true if this application has code
121 * associated with it. Comes
122 * from {@link android.R.styleable#AndroidManifestApplication_hasCode
123 * android:hasCode} of the &lt;application&gt; tag.
124 */
125 public static final int FLAG_HAS_CODE = 1<<2;
126
127 /**
128 * Value for {@link #flags}: set to true if this application is persistent.
129 * Comes from {@link android.R.styleable#AndroidManifestApplication_persistent
130 * android:persistent} of the &lt;application&gt; tag.
131 */
132 public static final int FLAG_PERSISTENT = 1<<3;
133
134 /**
Christopher Tate181fafa2009-05-14 11:12:14 -0700135 * Value for {@link #flags}: set to true if this application holds the
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800136 * {@link android.Manifest.permission#FACTORY_TEST} permission and the
137 * device is running in factory test mode.
138 */
139 public static final int FLAG_FACTORY_TEST = 1<<4;
140
141 /**
142 * Value for {@link #flags}: default value for the corresponding ActivityInfo flag.
143 * Comes from {@link android.R.styleable#AndroidManifestApplication_allowTaskReparenting
144 * android:allowTaskReparenting} of the &lt;application&gt; tag.
145 */
146 public static final int FLAG_ALLOW_TASK_REPARENTING = 1<<5;
147
148 /**
149 * Value for {@link #flags}: default value for the corresponding ActivityInfo flag.
150 * Comes from {@link android.R.styleable#AndroidManifestApplication_allowClearUserData
151 * android:allowClearUserData} of the &lt;application&gt; tag.
152 */
153 public static final int FLAG_ALLOW_CLEAR_USER_DATA = 1<<6;
154
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800155 /**
Dianne Hackborn851a5412009-05-08 12:06:44 -0700156 * Value for {@link #flags}: this is set if this application has been
157 * install as an update to a built-in system application.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800158 */
159 public static final int FLAG_UPDATED_SYSTEM_APP = 1<<7;
Dianne Hackborn851a5412009-05-08 12:06:44 -0700160
161 /**
Dianne Hackborn7f205432009-07-28 00:13:47 -0700162 * Value for {@link #flags}: this is set of the application has specified
163 * {@link android.R.styleable#AndroidManifestApplication_testOnly
164 * android:testOnly} to be true.
Dianne Hackborn851a5412009-05-08 12:06:44 -0700165 */
Dianne Hackborna96cbb42009-05-13 15:06:13 -0700166 public static final int FLAG_TEST_ONLY = 1<<8;
Dianne Hackbornade3eca2009-05-11 18:54:45 -0700167
168 /**
Dianne Hackborn5c1e00b2009-06-18 17:10:57 -0700169 * Value for {@link #flags}: true when the application's window can be
Dianne Hackborn723738c2009-06-25 19:48:04 -0700170 * reduced in size for smaller screens. Corresponds to
171 * {@link android.R.styleable#AndroidManifestSupportsScreens_smallScreens
172 * android:smallScreens}.
Dianne Hackborn5c1e00b2009-06-18 17:10:57 -0700173 */
Dianne Hackborn723738c2009-06-25 19:48:04 -0700174 public static final int FLAG_SUPPORTS_SMALL_SCREENS = 1<<9;
175
176 /**
177 * Value for {@link #flags}: true when the application's window can be
178 * displayed on normal screens. Corresponds to
179 * {@link android.R.styleable#AndroidManifestSupportsScreens_normalScreens
180 * android:normalScreens}.
181 */
182 public static final int FLAG_SUPPORTS_NORMAL_SCREENS = 1<<10;
183
184 /**
185 * Value for {@link #flags}: true when the application's window can be
186 * increased in size for larger screens. Corresponds to
187 * {@link android.R.styleable#AndroidManifestSupportsScreens_largeScreens
Dianne Hackborn22ec9ab2010-04-29 17:56:03 -0700188 * android:largeScreens}.
Dianne Hackborn723738c2009-06-25 19:48:04 -0700189 */
190 public static final int FLAG_SUPPORTS_LARGE_SCREENS = 1<<11;
Dianne Hackborn5c1e00b2009-06-18 17:10:57 -0700191
192 /**
Dianne Hackbornc4db95c2009-07-21 17:46:02 -0700193 * Value for {@link #flags}: true when the application knows how to adjust
194 * its UI for different screen sizes. Corresponds to
195 * {@link android.R.styleable#AndroidManifestSupportsScreens_resizeable
196 * android:resizeable}.
197 */
198 public static final int FLAG_RESIZEABLE_FOR_SCREENS = 1<<12;
199
200 /**
Dianne Hackborn11b822d2009-07-21 20:03:02 -0700201 * Value for {@link #flags}: true when the application knows how to
202 * accomodate different screen densities. Corresponds to
203 * {@link android.R.styleable#AndroidManifestSupportsScreens_anyDensity
204 * android:anyDensity}.
205 */
206 public static final int FLAG_SUPPORTS_SCREEN_DENSITIES = 1<<13;
207
208 /**
Ben Cheng23085b72010-02-08 16:06:32 -0800209 * Value for {@link #flags}: set to true if this application would like to
210 * request the VM to operate under the safe mode. Comes from
Ben Chengef3f5dd2010-03-29 15:47:26 -0700211 * {@link android.R.styleable#AndroidManifestApplication_vmSafeMode
212 * android:vmSafeMode} of the &lt;application&gt; tag.
Ben Cheng23085b72010-02-08 16:06:32 -0800213 */
214 public static final int FLAG_VM_SAFE_MODE = 1<<14;
215
216 /**
Christopher Tate3de55bc2010-03-12 17:28:08 -0800217 * Value for {@link #flags}: set to <code>false</code> if the application does not wish
218 * to permit any OS-driven backups of its data; <code>true</code> otherwise.
Christopher Tate181fafa2009-05-14 11:12:14 -0700219 *
Christopher Tate3de55bc2010-03-12 17:28:08 -0800220 * <p>Comes from the
221 * {@link android.R.styleable#AndroidManifestApplication_allowBackup android:allowBackup}
222 * attribute of the &lt;application&gt; tag.
Christopher Tate181fafa2009-05-14 11:12:14 -0700223 */
Ben Cheng23085b72010-02-08 16:06:32 -0800224 public static final int FLAG_ALLOW_BACKUP = 1<<15;
Christopher Tate5e1ab332009-09-01 20:32:49 -0700225
226 /**
Christopher Tate3de55bc2010-03-12 17:28:08 -0800227 * Value for {@link #flags}: set to <code>false</code> if the application must be kept
228 * in memory following a full-system restore operation; <code>true</code> otherwise.
229 * Ordinarily, during a full system restore operation each application is shut down
230 * following execution of its agent's onRestore() method. Setting this attribute to
231 * <code>false</code> prevents this. Most applications will not need to set this attribute.
Christopher Tate5e1ab332009-09-01 20:32:49 -0700232 *
Christopher Tate3de55bc2010-03-12 17:28:08 -0800233 * <p>If
234 * {@link android.R.styleable#AndroidManifestApplication_allowBackup android:allowBackup}
235 * is set to <code>false</code> or no
236 * {@link android.R.styleable#AndroidManifestApplication_backupAgent android:backupAgent}
Christopher Tate5e1ab332009-09-01 20:32:49 -0700237 * is specified, this flag will be ignored.
238 *
Christopher Tate3de55bc2010-03-12 17:28:08 -0800239 * <p>Comes from the
240 * {@link android.R.styleable#AndroidManifestApplication_killAfterRestore android:killAfterRestore}
241 * attribute of the &lt;application&gt; tag.
Christopher Tate5e1ab332009-09-01 20:32:49 -0700242 */
Ben Cheng23085b72010-02-08 16:06:32 -0800243 public static final int FLAG_KILL_AFTER_RESTORE = 1<<16;
Christopher Tate5e1ab332009-09-01 20:32:49 -0700244
245 /**
Christopher Tate3de55bc2010-03-12 17:28:08 -0800246 * Value for {@link #flags}: Set to <code>true</code> if the application's backup
247 * agent claims to be able to handle restore data even "from the future,"
248 * i.e. from versions of the application with a versionCode greater than
249 * the one currently installed on the device. <i>Use with caution!</i> By default
250 * this attribute is <code>false</code> and the Backup Manager will ensure that data
251 * from "future" versions of the application are never supplied during a restore operation.
Christopher Tate5e1ab332009-09-01 20:32:49 -0700252 *
Christopher Tate3de55bc2010-03-12 17:28:08 -0800253 * <p>If
254 * {@link android.R.styleable#AndroidManifestApplication_allowBackup android:allowBackup}
255 * is set to <code>false</code> or no
256 * {@link android.R.styleable#AndroidManifestApplication_backupAgent android:backupAgent}
Christopher Tate5e1ab332009-09-01 20:32:49 -0700257 * is specified, this flag will be ignored.
258 *
Christopher Tate3de55bc2010-03-12 17:28:08 -0800259 * <p>Comes from the
260 * {@link android.R.styleable#AndroidManifestApplication_restoreAnyVersion android:restoreAnyVersion}
261 * attribute of the &lt;application&gt; tag.
Christopher Tate5e1ab332009-09-01 20:32:49 -0700262 */
Christopher Tate3de55bc2010-03-12 17:28:08 -0800263 public static final int FLAG_RESTORE_ANY_VERSION = 1<<17;
Christopher Tate5e1ab332009-09-01 20:32:49 -0700264
Christopher Tate181fafa2009-05-14 11:12:14 -0700265 /**
Dianne Hackborn3202d382010-04-26 17:51:34 -0700266 * Value for {@link #flags}: Set to true if the application is
267 * currently installed on external/removable/unprotected storage. Such
268 * applications may not be available if their storage is not currently
269 * mounted. When the storage it is on is not available, it will look like
270 * the application has been uninstalled (its .apk is no longer available)
271 * but its persistent data is not removed.
Suchi Amalapurapuaf8e9f42010-01-12 10:17:28 -0800272 */
Dianne Hackborn94c567e2010-04-26 18:13:10 -0700273 public static final int FLAG_EXTERNAL_STORAGE = 1<<18;
Suchi Amalapurapuaf8e9f42010-01-12 10:17:28 -0800274
275 /**
Dianne Hackborn14cee9f2010-04-23 17:51:26 -0700276 * Value for {@link #flags}: true when the application's window can be
277 * increased in size for extra large screens. Corresponds to
278 * {@link android.R.styleable#AndroidManifestSupportsScreens_xlargeScreens
Dianne Hackborn22ec9ab2010-04-29 17:56:03 -0700279 * android:xlargeScreens}.
Dianne Hackborn14cee9f2010-04-23 17:51:26 -0700280 */
281 public static final int FLAG_SUPPORTS_XLARGE_SCREENS = 1<<19;
282
283 /**
Dianne Hackborn3b81bc12011-01-15 11:50:52 -0800284 * Value for {@link #flags}: true when the application has requested a
285 * large heap for its processes. Corresponds to
286 * {@link android.R.styleable#AndroidManifestApplication_largeHeap
287 * android:largeHeap}.
Jason parksa3cdaa52011-01-13 14:15:43 -0600288 */
Dianne Hackborn3b81bc12011-01-15 11:50:52 -0800289 public static final int FLAG_LARGE_HEAP = 1<<20;
Jason parksa3cdaa52011-01-13 14:15:43 -0600290
291 /**
Dianne Hackborne7f97212011-02-24 14:40:20 -0800292 * Value for {@link #flags}: true if this application's package is in
293 * the stopped state.
294 */
295 public static final int FLAG_STOPPED = 1<<21;
296
297 /**
Fabrice Di Meglio59dfce82012-04-02 16:17:20 -0700298 * Value for {@link #flags}: true when the application is willing to support
299 * RTL (right to left). All activities will inherit this value.
300 *
301 * Set from the {@link android.R.attr#supportsRtl} attribute in the
302 * activity's manifest.
303 *
304 * Default value is false (no support for RTL).
305 */
306 public static final int FLAG_SUPPORTS_RTL = 1<<22;
307
308 /**
Dianne Hackborn7767eac2012-08-23 18:25:40 -0700309 * Value for {@link #flags}: true if the application is currently
310 * installed for the calling user.
311 */
312 public static final int FLAG_INSTALLED = 1<<23;
313
314 /**
Dianne Hackborn5e03e2c2012-09-06 14:21:19 -0700315 * Value for {@link #flags}: true if the application only has its
316 * data installed; the application package itself does not currently
317 * exist on the device.
318 */
319 public static final int FLAG_IS_DATA_ONLY = 1<<24;
320
321 /**
Jose Lima12d0b4c2014-03-14 16:55:12 -0700322 * Value for {@link #flags}: true if the application was declared to be a game, or
323 * false if it is a non-game application.
324 */
325 public static final int FLAG_IS_GAME = 1<<25;
326
327 /**
Christopher Tated1de2562014-06-17 17:12:35 -0700328 * Value for {@link #flags}: {@code true} if the application asks that only
329 * full-data streaming backups of its data be performed even though it defines
330 * a {@link android.app.backup.BackupAgent BackupAgent}, which normally
331 * indicates that the app will manage its backed-up data via incremental
332 * key/value updates.
333 */
334 public static final int FLAG_FULL_BACKUP_ONLY = 1<<26;
335
336 /**
Narayan Kamath589a1bc2014-07-03 14:43:26 +0100337 * Value for {@link #flags}: true if the application is blocked via restrictions and for
338 * most purposes is considered as not installed.
Christopher Tate4ce55a32013-06-24 16:43:51 -0700339 * {@hide}
340 */
Narayan Kamath589a1bc2014-07-03 14:43:26 +0100341 public static final int FLAG_BLOCKED = 1<<27;
Suchi Amalapurapuaf8e9f42010-01-12 10:17:28 -0800342
343 /**
Dianne Hackborn02486b12010-08-26 14:18:37 -0700344 * Value for {@link #flags}: set to <code>true</code> if the application
345 * has reported that it is heavy-weight, and thus can not participate in
346 * the normal application lifecycle.
347 *
348 * <p>Comes from the
Dianne Hackborn8472e612014-01-23 17:57:20 -0800349 * android.R.styleable#AndroidManifestApplication_cantSaveState
Dianne Hackborn02486b12010-08-26 14:18:37 -0700350 * attribute of the &lt;application&gt; tag.
351 *
352 * {@hide}
353 */
Dianne Hackborn75e616e2011-01-16 13:31:24 -0800354 public static final int FLAG_CANT_SAVE_STATE = 1<<28;
Dianne Hackborn02486b12010-08-26 14:18:37 -0700355
356 /**
Narayan Kamath589a1bc2014-07-03 14:43:26 +0100357 * Value for {@link #flags}: Set to true if the application has been
358 * installed using the forward lock option.
359 *
360 * NOTE: DO NOT CHANGE THIS VALUE! It is saved in packages.xml.
361 *
Amith Yamasani655d0e22013-06-12 14:19:10 -0700362 * {@hide}
363 */
Narayan Kamath589a1bc2014-07-03 14:43:26 +0100364 public static final int FLAG_FORWARD_LOCK = 1<<29;
365
366 /**
367 * Value for {@link #flags}: set to {@code true} if the application
368 * is permitted to hold privileged permissions.
369 *
370 * {@hide}
371 */
372 public static final int FLAG_PRIVILEGED = 1<<30;
373
374 /**
375 * Value for {@link #flags}: true if code from this application will need to be
376 * loaded into other applications' processes. On devices that support multiple
377 * instruction sets, this implies the code might be loaded into a process that's
378 * using any of the devices supported instruction sets.
379 *
380 * <p> The system might treat such applications specially, for eg., by
381 * extracting the application's native libraries for all supported instruction
382 * sets or by compiling the application's dex code for all supported instruction
383 * sets.
384 */
385 public static final int FLAG_MULTIARCH = 1 << 31;
Amith Yamasani655d0e22013-06-12 14:19:10 -0700386
387 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800388 * Flags associated with the application. Any combination of
389 * {@link #FLAG_SYSTEM}, {@link #FLAG_DEBUGGABLE}, {@link #FLAG_HAS_CODE},
390 * {@link #FLAG_PERSISTENT}, {@link #FLAG_FACTORY_TEST}, and
391 * {@link #FLAG_ALLOW_TASK_REPARENTING}
Dianne Hackborn851a5412009-05-08 12:06:44 -0700392 * {@link #FLAG_ALLOW_CLEAR_USER_DATA}, {@link #FLAG_UPDATED_SYSTEM_APP},
Dianne Hackborn723738c2009-06-25 19:48:04 -0700393 * {@link #FLAG_TEST_ONLY}, {@link #FLAG_SUPPORTS_SMALL_SCREENS},
394 * {@link #FLAG_SUPPORTS_NORMAL_SCREENS},
Dianne Hackborn14cee9f2010-04-23 17:51:26 -0700395 * {@link #FLAG_SUPPORTS_LARGE_SCREENS}, {@link #FLAG_SUPPORTS_XLARGE_SCREENS},
396 * {@link #FLAG_RESIZEABLE_FOR_SCREENS},
Dianne Hackborn7767eac2012-08-23 18:25:40 -0700397 * {@link #FLAG_SUPPORTS_SCREEN_DENSITIES}, {@link #FLAG_VM_SAFE_MODE},
Jose Lima12d0b4c2014-03-14 16:55:12 -0700398 * {@link #FLAG_INSTALLED}, {@link #FLAG_IS_GAME}.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800399 */
400 public int flags = 0;
Amith Yamasani655d0e22013-06-12 14:19:10 -0700401
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800402 /**
Dianne Hackborndf6e9802011-05-26 14:20:23 -0700403 * The required smallest screen width the application can run on. If 0,
404 * nothing has been specified. Comes from
405 * {@link android.R.styleable#AndroidManifestSupportsScreens_requiresSmallestWidthDp
406 * android:requiresSmallestWidthDp} attribute of the &lt;supports-screens&gt; tag.
407 */
408 public int requiresSmallestWidthDp = 0;
409
410 /**
411 * The maximum smallest screen width the application is designed for. If 0,
412 * nothing has been specified. Comes from
413 * {@link android.R.styleable#AndroidManifestSupportsScreens_compatibleWidthLimitDp
414 * android:compatibleWidthLimitDp} attribute of the &lt;supports-screens&gt; tag.
415 */
416 public int compatibleWidthLimitDp = 0;
417
418 /**
Dianne Hackborn2762ff32011-06-01 21:27:05 -0700419 * The maximum smallest screen width the application will work on. If 0,
420 * nothing has been specified. Comes from
421 * {@link android.R.styleable#AndroidManifestSupportsScreens_largestWidthLimitDp
422 * android:largestWidthLimitDp} attribute of the &lt;supports-screens&gt; tag.
423 */
424 public int largestWidthLimitDp = 0;
425
Jeff Sharkeyd7460572014-07-06 20:44:55 -0700426 /** {@hide} */
427 public String scanSourceDir;
428 /** {@hide} */
429 public String scanPublicSourceDir;
430
Dianne Hackborn2762ff32011-06-01 21:27:05 -0700431 /**
Jeff Sharkey8a4c9722014-06-16 13:48:42 -0700432 * Full path to the base APK for this application.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800433 */
434 public String sourceDir;
435
436 /**
Jeff Sharkey8a4c9722014-06-16 13:48:42 -0700437 * Full path to the publicly available parts of {@link #sourceDir},
438 * including resources and manifest. This may be different from
439 * {@link #sourceDir} if an application is forward locked.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800440 */
441 public String publicSourceDir;
Jeff Sharkey8a4c9722014-06-16 13:48:42 -0700442
443 /**
444 * Full paths to zero or more split APKs that, when combined with the base
445 * APK defined in {@link #sourceDir}, form a complete application.
446 */
447 public String[] splitSourceDirs;
448
449 /**
450 * Full path to the publicly available parts of {@link #splitSourceDirs},
451 * including resources and manifest. This may be different from
452 * {@link #splitSourceDirs} if an application is forward locked.
453 */
454 public String[] splitPublicSourceDirs;
455
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800456 /**
Kenny Rootd1ab0162010-01-21 17:27:14 -0800457 * Full paths to the locations of extra resource packages this application
458 * uses. This field is only used if there are extra resource packages,
459 * otherwise it is null.
Kenny Rootace5a3f2010-02-05 12:59:28 -0800460 *
461 * {@hide}
Kenny Rootd1ab0162010-01-21 17:27:14 -0800462 */
463 public String[] resourceDirs;
464
465 /**
Robert Craig0f40dc92013-03-25 06:33:03 -0400466 * String retrieved from the seinfo tag found in selinux policy. This value
467 * is useful in setting an SELinux security context on the process as well
468 * as its data directory.
469 *
470 * {@hide}
471 */
472 public String seinfo;
473
474 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800475 * Paths to all shared libraries this application is linked against. This
476 * field is only set if the {@link PackageManager#GET_SHARED_LIBRARY_FILES
477 * PackageManager.GET_SHARED_LIBRARY_FILES} flag was used when retrieving
478 * the structure.
479 */
480 public String[] sharedLibraryFiles;
481
482 /**
483 * Full path to a directory assigned to the package for its persistent
484 * data.
485 */
486 public String dataDir;
Kenny Root85387d72010-08-26 10:13:11 -0700487
488 /**
489 * Full path to the directory where native JNI libraries are stored.
Kenny Root85387d72010-08-26 10:13:11 -0700490 */
491 public String nativeLibraryDir;
492
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800493 /**
Narayan Kamathff110bd2014-07-04 18:30:45 +0100494 * The path under the apps data directory we store unpacked libraries. For
495 * new installs, we create subdirectories under legacyNativeLibraryDir that are
496 * architecture specific. For legacy installs, the shared libraries are
497 * placed directly under this path.
498 *
499 * For "legacy" installs {@code nativeLibraryDir} will be equal to this path.
500 * For newer installs, it will be derived based on the codePath and the primary
501 * cpu abi.
502 *
503 * @hide.
504 */
505 public String legacyNativeLibraryDir;
506
507 /**
508 * The primary ABI that this application requires, This is inferred from the ABIs
Ramin Zaghiff0c4702014-04-01 15:02:29 +0100509 * of the native JNI libraries the application bundles. Will be {@code null}
510 * if this application does not require any particular ABI.
511 *
Narayan Kamathff110bd2014-07-04 18:30:45 +0100512 * If non-null, the application will always be launched with this ABI.
513 *
Ramin Zaghiff0c4702014-04-01 15:02:29 +0100514 * {@hide}
515 */
Narayan Kamathff110bd2014-07-04 18:30:45 +0100516 public String primaryCpuAbi;
517
518 /**
519 * The secondary ABI for this application. Might be non-null for multi-arch
520 * installs. The application itself never uses this ABI, but other applications that
521 * use its code might.
522 *
523 * {@hide}
524 */
525 public String secondaryCpuAbi;
526
527 /**
528 * The derived APK "root" for the given package. Will be non-null for bundled and
529 * updated system apps. This will be a top level path under which apks and libraries
530 * are installed, for eg. {@code /system}, {@code /oem} or {@code /vendor}. This is
531 * used to calculate the location of native code for a given package, for e.g
532 * {@code /vendor/lib} or {@code /vendor/lib64}.
533 *
534 * For app updates or fresh app installs, this will be {@code null} and we will use
535 * {@code legacyNativeLibraryDir}
536 *
537 * NOTE: This can be removed if we have a unified layout for bundled and installed
538 * apps.
539 *
540 * {@hide}
541 */
542 public String apkRoot;
Ramin Zaghiff0c4702014-04-01 15:02:29 +0100543
544 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800545 * The kernel user-ID that has been assigned to this application;
546 * currently this is not a unique ID (multiple applications can have
547 * the same uid).
548 */
549 public int uid;
550
Mitsuru Oshima8d112672009-04-27 12:01:23 -0700551 /**
Dianne Hackborn3b3e1452009-09-24 19:22:12 -0700552 * The minimum SDK version this application targets. It may run on earlier
Dianne Hackborna96cbb42009-05-13 15:06:13 -0700553 * versions, but it knows how to work with any new behavior added at this
554 * version. Will be {@link android.os.Build.VERSION_CODES#CUR_DEVELOPMENT}
555 * if this is a development build and the app is targeting that. You should
556 * compare that this number is >= the SDK version number at which your
557 * behavior was introduced.
558 */
559 public int targetSdkVersion;
Dianne Hackborn8472e612014-01-23 17:57:20 -0800560
561 /**
562 * The app's declared version code.
563 * @hide
564 */
565 public int versionCode;
566
Dianne Hackborna96cbb42009-05-13 15:06:13 -0700567 /**
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800568 * When false, indicates that all components within this application are
569 * considered disabled, regardless of their individually set enabled status.
570 */
571 public boolean enabled = true;
572
Dianne Hackborn54e570f2010-10-04 18:32:32 -0700573 /**
Dianne Hackborn0ac30312011-06-17 14:49:23 -0700574 * For convenient access to the current enabled setting of this app.
575 * @hide
576 */
577 public int enabledSetting = PackageManager.COMPONENT_ENABLED_STATE_DEFAULT;
578
579 /**
Dianne Hackborn54e570f2010-10-04 18:32:32 -0700580 * For convenient access to package's install location.
581 * @hide
582 */
583 public int installLocation = PackageInfo.INSTALL_LOCATION_UNSPECIFIED;
Jose Lima12d0b4c2014-03-14 16:55:12 -0700584
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800585 public void dump(Printer pw, String prefix) {
586 super.dumpFront(pw, prefix);
Dianne Hackborn12527f92009-11-11 17:39:50 -0800587 if (className != null) {
588 pw.println(prefix + "className=" + className);
589 }
590 if (permission != null) {
591 pw.println(prefix + "permission=" + permission);
592 }
Dianne Hackborn39792d22010-08-19 18:01:52 -0700593 pw.println(prefix + "processName=" + processName);
594 pw.println(prefix + "taskAffinity=" + taskAffinity);
595 pw.println(prefix + "uid=" + uid + " flags=0x" + Integer.toHexString(flags)
596 + " theme=0x" + Integer.toHexString(theme));
Dianne Hackborndf6e9802011-05-26 14:20:23 -0700597 pw.println(prefix + "requiresSmallestWidthDp=" + requiresSmallestWidthDp
Dianne Hackborn2762ff32011-06-01 21:27:05 -0700598 + " compatibleWidthLimitDp=" + compatibleWidthLimitDp
599 + " largestWidthLimitDp=" + largestWidthLimitDp);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800600 pw.println(prefix + "sourceDir=" + sourceDir);
Jeff Sharkey8a4c9722014-06-16 13:48:42 -0700601 if (!Objects.equals(sourceDir, publicSourceDir)) {
Dianne Hackborn39792d22010-08-19 18:01:52 -0700602 pw.println(prefix + "publicSourceDir=" + publicSourceDir);
603 }
Jeff Sharkey8a4c9722014-06-16 13:48:42 -0700604 if (!ArrayUtils.isEmpty(splitSourceDirs)) {
605 pw.println(prefix + "splitSourceDirs=" + Arrays.toString(splitSourceDirs));
606 }
607 if (!ArrayUtils.isEmpty(splitPublicSourceDirs)
608 && !Arrays.equals(splitSourceDirs, splitPublicSourceDirs)) {
609 pw.println(prefix + "splitPublicSourceDirs=" + Arrays.toString(splitPublicSourceDirs));
610 }
Dianne Hackborn39792d22010-08-19 18:01:52 -0700611 if (resourceDirs != null) {
612 pw.println(prefix + "resourceDirs=" + resourceDirs);
613 }
Robert Craig0f40dc92013-03-25 06:33:03 -0400614 if (seinfo != null) {
615 pw.println(prefix + "seinfo=" + seinfo);
616 }
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800617 pw.println(prefix + "dataDir=" + dataDir);
Dianne Hackborn12527f92009-11-11 17:39:50 -0800618 if (sharedLibraryFiles != null) {
619 pw.println(prefix + "sharedLibraryFiles=" + sharedLibraryFiles);
620 }
Dianne Hackborn8472e612014-01-23 17:57:20 -0800621 pw.println(prefix + "enabled=" + enabled + " targetSdkVersion=" + targetSdkVersion
622 + " versionCode=" + versionCode);
Dianne Hackborn12527f92009-11-11 17:39:50 -0800623 if (manageSpaceActivityName != null) {
624 pw.println(prefix + "manageSpaceActivityName="+manageSpaceActivityName);
625 }
626 if (descriptionRes != 0) {
627 pw.println(prefix + "description=0x"+Integer.toHexString(descriptionRes));
628 }
Adam Powell269248d2011-08-02 10:26:54 -0700629 if (uiOptions != 0) {
630 pw.println(prefix + "uiOptions=0x" + Integer.toHexString(uiOptions));
631 }
Fabrice Di Meglio59dfce82012-04-02 16:17:20 -0700632 pw.println(prefix + "supportsRtl=" + (hasRtlSupport() ? "true" : "false"));
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800633 super.dumpBack(pw, prefix);
634 }
Fabrice Di Meglio59dfce82012-04-02 16:17:20 -0700635
636 /**
637 * @return true if "supportsRtl" has been set to true in the AndroidManifest
638 * @hide
639 */
640 public boolean hasRtlSupport() {
641 return (flags & FLAG_SUPPORTS_RTL) == FLAG_SUPPORTS_RTL;
642 }
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800643
644 public static class DisplayNameComparator
645 implements Comparator<ApplicationInfo> {
646 public DisplayNameComparator(PackageManager pm) {
647 mPM = pm;
648 }
649
650 public final int compare(ApplicationInfo aa, ApplicationInfo ab) {
651 CharSequence sa = mPM.getApplicationLabel(aa);
652 if (sa == null) {
653 sa = aa.packageName;
654 }
655 CharSequence sb = mPM.getApplicationLabel(ab);
656 if (sb == null) {
657 sb = ab.packageName;
658 }
659
660 return sCollator.compare(sa.toString(), sb.toString());
661 }
662
663 private final Collator sCollator = Collator.getInstance();
664 private PackageManager mPM;
665 }
666
667 public ApplicationInfo() {
668 }
669
670 public ApplicationInfo(ApplicationInfo orig) {
671 super(orig);
672 taskAffinity = orig.taskAffinity;
673 permission = orig.permission;
674 processName = orig.processName;
675 className = orig.className;
676 theme = orig.theme;
677 flags = orig.flags;
Dianne Hackborndf6e9802011-05-26 14:20:23 -0700678 requiresSmallestWidthDp = orig.requiresSmallestWidthDp;
679 compatibleWidthLimitDp = orig.compatibleWidthLimitDp;
Dianne Hackborn2762ff32011-06-01 21:27:05 -0700680 largestWidthLimitDp = orig.largestWidthLimitDp;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800681 sourceDir = orig.sourceDir;
682 publicSourceDir = orig.publicSourceDir;
Jeff Sharkey8a4c9722014-06-16 13:48:42 -0700683 splitSourceDirs = orig.splitSourceDirs;
684 splitPublicSourceDirs = orig.splitPublicSourceDirs;
Kenny Root85387d72010-08-26 10:13:11 -0700685 nativeLibraryDir = orig.nativeLibraryDir;
Narayan Kamathff110bd2014-07-04 18:30:45 +0100686 legacyNativeLibraryDir = orig.legacyNativeLibraryDir;
687 primaryCpuAbi = orig.primaryCpuAbi;
688 secondaryCpuAbi = orig.secondaryCpuAbi;
689 apkRoot = orig.apkRoot;
Kenny Rootd1ab0162010-01-21 17:27:14 -0800690 resourceDirs = orig.resourceDirs;
Robert Craig0f40dc92013-03-25 06:33:03 -0400691 seinfo = orig.seinfo;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800692 sharedLibraryFiles = orig.sharedLibraryFiles;
693 dataDir = orig.dataDir;
694 uid = orig.uid;
Dianne Hackborna96cbb42009-05-13 15:06:13 -0700695 targetSdkVersion = orig.targetSdkVersion;
Dianne Hackborn8472e612014-01-23 17:57:20 -0800696 versionCode = orig.versionCode;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800697 enabled = orig.enabled;
Dianne Hackborn0ac30312011-06-17 14:49:23 -0700698 enabledSetting = orig.enabledSetting;
Dianne Hackborn54e570f2010-10-04 18:32:32 -0700699 installLocation = orig.installLocation;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800700 manageSpaceActivityName = orig.manageSpaceActivityName;
701 descriptionRes = orig.descriptionRes;
Adam Powell269248d2011-08-02 10:26:54 -0700702 uiOptions = orig.uiOptions;
Christopher Tatebcb02552012-10-16 17:14:34 -0700703 backupAgentName = orig.backupAgentName;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800704 }
705
706
707 public String toString() {
708 return "ApplicationInfo{"
709 + Integer.toHexString(System.identityHashCode(this))
710 + " " + packageName + "}";
711 }
712
713 public int describeContents() {
714 return 0;
715 }
716
717 public void writeToParcel(Parcel dest, int parcelableFlags) {
718 super.writeToParcel(dest, parcelableFlags);
719 dest.writeString(taskAffinity);
720 dest.writeString(permission);
721 dest.writeString(processName);
722 dest.writeString(className);
723 dest.writeInt(theme);
724 dest.writeInt(flags);
Dianne Hackborndf6e9802011-05-26 14:20:23 -0700725 dest.writeInt(requiresSmallestWidthDp);
726 dest.writeInt(compatibleWidthLimitDp);
Dianne Hackborn2762ff32011-06-01 21:27:05 -0700727 dest.writeInt(largestWidthLimitDp);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800728 dest.writeString(sourceDir);
729 dest.writeString(publicSourceDir);
Jeff Sharkey8a4c9722014-06-16 13:48:42 -0700730 dest.writeStringArray(splitSourceDirs);
731 dest.writeStringArray(splitPublicSourceDirs);
Kenny Root85387d72010-08-26 10:13:11 -0700732 dest.writeString(nativeLibraryDir);
Narayan Kamathff110bd2014-07-04 18:30:45 +0100733 dest.writeString(legacyNativeLibraryDir);
734 dest.writeString(primaryCpuAbi);
735 dest.writeString(secondaryCpuAbi);
736 dest.writeString(apkRoot);
Kenny Rootd1ab0162010-01-21 17:27:14 -0800737 dest.writeStringArray(resourceDirs);
Robert Craig0f40dc92013-03-25 06:33:03 -0400738 dest.writeString(seinfo);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800739 dest.writeStringArray(sharedLibraryFiles);
740 dest.writeString(dataDir);
741 dest.writeInt(uid);
Dianne Hackborna96cbb42009-05-13 15:06:13 -0700742 dest.writeInt(targetSdkVersion);
Dianne Hackborn8472e612014-01-23 17:57:20 -0800743 dest.writeInt(versionCode);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800744 dest.writeInt(enabled ? 1 : 0);
Dianne Hackborn0ac30312011-06-17 14:49:23 -0700745 dest.writeInt(enabledSetting);
Dianne Hackborn54e570f2010-10-04 18:32:32 -0700746 dest.writeInt(installLocation);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800747 dest.writeString(manageSpaceActivityName);
Christopher Tate181fafa2009-05-14 11:12:14 -0700748 dest.writeString(backupAgentName);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800749 dest.writeInt(descriptionRes);
Adam Powell269248d2011-08-02 10:26:54 -0700750 dest.writeInt(uiOptions);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800751 }
752
753 public static final Parcelable.Creator<ApplicationInfo> CREATOR
754 = new Parcelable.Creator<ApplicationInfo>() {
755 public ApplicationInfo createFromParcel(Parcel source) {
756 return new ApplicationInfo(source);
757 }
758 public ApplicationInfo[] newArray(int size) {
759 return new ApplicationInfo[size];
760 }
761 };
762
763 private ApplicationInfo(Parcel source) {
764 super(source);
765 taskAffinity = source.readString();
766 permission = source.readString();
767 processName = source.readString();
768 className = source.readString();
769 theme = source.readInt();
770 flags = source.readInt();
Dianne Hackborndf6e9802011-05-26 14:20:23 -0700771 requiresSmallestWidthDp = source.readInt();
772 compatibleWidthLimitDp = source.readInt();
Dianne Hackborn2762ff32011-06-01 21:27:05 -0700773 largestWidthLimitDp = source.readInt();
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800774 sourceDir = source.readString();
775 publicSourceDir = source.readString();
Jeff Sharkey8a4c9722014-06-16 13:48:42 -0700776 splitSourceDirs = source.readStringArray();
777 splitPublicSourceDirs = source.readStringArray();
Kenny Root85387d72010-08-26 10:13:11 -0700778 nativeLibraryDir = source.readString();
Narayan Kamathff110bd2014-07-04 18:30:45 +0100779 legacyNativeLibraryDir = source.readString();
780 primaryCpuAbi = source.readString();
781 secondaryCpuAbi = source.readString();
782 apkRoot = source.readString();
Kenny Rootd1ab0162010-01-21 17:27:14 -0800783 resourceDirs = source.readStringArray();
Robert Craig0f40dc92013-03-25 06:33:03 -0400784 seinfo = source.readString();
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800785 sharedLibraryFiles = source.readStringArray();
786 dataDir = source.readString();
787 uid = source.readInt();
Dianne Hackborna96cbb42009-05-13 15:06:13 -0700788 targetSdkVersion = source.readInt();
Dianne Hackborn8472e612014-01-23 17:57:20 -0800789 versionCode = source.readInt();
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800790 enabled = source.readInt() != 0;
Dianne Hackborn0ac30312011-06-17 14:49:23 -0700791 enabledSetting = source.readInt();
Dianne Hackborn54e570f2010-10-04 18:32:32 -0700792 installLocation = source.readInt();
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800793 manageSpaceActivityName = source.readString();
Christopher Tate181fafa2009-05-14 11:12:14 -0700794 backupAgentName = source.readString();
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800795 descriptionRes = source.readInt();
Adam Powell269248d2011-08-02 10:26:54 -0700796 uiOptions = source.readInt();
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800797 }
Mitsuru Oshima8d112672009-04-27 12:01:23 -0700798
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800799 /**
800 * Retrieve the textual description of the application. This
801 * will call back on the given PackageManager to load the description from
802 * the application.
803 *
804 * @param pm A PackageManager from which the label can be loaded; usually
805 * the PackageManager from which you originally retrieved this item.
806 *
807 * @return Returns a CharSequence containing the application's description.
808 * If there is no description, null is returned.
809 */
810 public CharSequence loadDescription(PackageManager pm) {
811 if (descriptionRes != 0) {
Jeff Brown07330792010-03-30 19:57:08 -0700812 CharSequence label = pm.getText(packageName, descriptionRes, this);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800813 if (label != null) {
814 return label;
815 }
816 }
817 return null;
818 }
Mitsuru Oshimae5fb3282009-06-09 21:16:08 -0700819
820 /**
821 * Disable compatibility mode
822 *
823 * @hide
824 */
825 public void disableCompatibilityMode() {
Mitsuru Oshima69fff4a2009-07-21 09:51:05 -0700826 flags |= (FLAG_SUPPORTS_LARGE_SCREENS | FLAG_SUPPORTS_NORMAL_SCREENS |
Dianne Hackborn11b822d2009-07-21 20:03:02 -0700827 FLAG_SUPPORTS_SMALL_SCREENS | FLAG_RESIZEABLE_FOR_SCREENS |
Dianne Hackborn14cee9f2010-04-23 17:51:26 -0700828 FLAG_SUPPORTS_SCREEN_DENSITIES | FLAG_SUPPORTS_XLARGE_SCREENS);
Mitsuru Oshimae5fb3282009-06-09 21:16:08 -0700829 }
Jeff Brown07330792010-03-30 19:57:08 -0700830
831 /**
832 * @hide
833 */
834 @Override protected Drawable loadDefaultIcon(PackageManager pm) {
835 if ((flags & FLAG_EXTERNAL_STORAGE) != 0
836 && isPackageUnavailable(pm)) {
837 return Resources.getSystem().getDrawable(
838 com.android.internal.R.drawable.sym_app_on_sd_unavailable_icon);
839 }
840 return pm.getDefaultActivityIcon();
841 }
842
843 private boolean isPackageUnavailable(PackageManager pm) {
844 try {
845 return pm.getPackageInfo(packageName, 0) == null;
846 } catch (NameNotFoundException ex) {
847 return true;
848 }
849 }
Jeff Sharkeyd7460572014-07-06 20:44:55 -0700850
Jeff Brown07330792010-03-30 19:57:08 -0700851 /**
852 * @hide
853 */
854 @Override protected ApplicationInfo getApplicationInfo() {
855 return this;
856 }
Jeff Sharkeyd7460572014-07-06 20:44:55 -0700857
858 /** {@hide} */ public void setCodePath(String codePath) { scanSourceDir = codePath; }
859 /** {@hide} */ public void setBaseCodePath(String baseCodePath) { sourceDir = baseCodePath; }
860 /** {@hide} */ public void setSplitCodePaths(String[] splitCodePaths) { splitSourceDirs = splitCodePaths; }
861 /** {@hide} */ public void setResourcePath(String resourcePath) { scanPublicSourceDir = resourcePath; }
862 /** {@hide} */ public void setBaseResourcePath(String baseResourcePath) { publicSourceDir = baseResourcePath; }
863 /** {@hide} */ public void setSplitResourcePaths(String[] splitResourcePaths) { splitPublicSourceDirs = splitResourcePaths; }
864
865 /** {@hide} */ public String getCodePath() { return scanSourceDir; }
866 /** {@hide} */ public String getBaseCodePath() { return sourceDir; }
867 /** {@hide} */ public String[] getSplitCodePaths() { return splitSourceDirs; }
868 /** {@hide} */ public String getResourcePath() { return scanPublicSourceDir; }
869 /** {@hide} */ public String getBaseResourcePath() { return publicSourceDir; }
870 /** {@hide} */ public String[] getSplitResourcePaths() { return splitSourceDirs; }
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800871}