The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 1 | /* |
| 2 | ** |
| 3 | ** Copyright 2007, The Android Open Source Project |
| 4 | ** |
| 5 | ** Licensed under the Apache License, Version 2.0 (the "License"); |
| 6 | ** you may not use this file except in compliance with the License. |
| 7 | ** You may obtain a copy of the License at |
| 8 | ** |
| 9 | ** http://www.apache.org/licenses/LICENSE-2.0 |
| 10 | ** |
| 11 | ** Unless required by applicable law or agreed to in writing, software |
| 12 | ** distributed under the License is distributed on an "AS IS" BASIS, |
| 13 | ** WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| 14 | ** See the License for the specific language governing permissions and |
| 15 | ** limitations under the License. |
| 16 | */ |
| 17 | |
| 18 | package android.content.pm; |
| 19 | |
| 20 | import android.content.ComponentName; |
| 21 | import android.content.Intent; |
| 22 | import android.content.IntentFilter; |
| 23 | import android.content.pm.ActivityInfo; |
| 24 | import android.content.pm.ApplicationInfo; |
Anonymous Coward | ceb1b0b | 2012-04-24 10:35:16 -0700 | [diff] [blame] | 25 | import android.content.pm.ContainerEncryptionParams; |
Dianne Hackborn | 4923734 | 2009-08-27 20:08:01 -0700 | [diff] [blame] | 26 | import android.content.pm.FeatureInfo; |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 27 | import android.content.pm.IPackageInstallObserver; |
Christopher Tate | f1977b4 | 2014-03-24 16:25:51 -0700 | [diff] [blame] | 28 | import android.content.pm.IPackageInstallObserver2; |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 29 | import android.content.pm.IPackageDeleteObserver; |
| 30 | import android.content.pm.IPackageDataObserver; |
Suchi Amalapurapu | 8946dd3 | 2010-02-19 09:19:34 -0800 | [diff] [blame] | 31 | import android.content.pm.IPackageMoveObserver; |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 32 | import android.content.pm.IPackageStatsObserver; |
| 33 | import android.content.pm.InstrumentationInfo; |
| 34 | import android.content.pm.PackageInfo; |
Kenny Root | 5ab2157 | 2011-07-27 11:11:19 -0700 | [diff] [blame] | 35 | import android.content.pm.ManifestDigest; |
Dianne Hackborn | 7767eac | 2012-08-23 18:25:40 -0700 | [diff] [blame] | 36 | import android.content.pm.PackageCleanItem; |
Kenny Root | 0e2c0f3 | 2011-04-15 17:50:10 -0700 | [diff] [blame] | 37 | import android.content.pm.ParceledListSlice; |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 38 | import android.content.pm.ProviderInfo; |
| 39 | import android.content.pm.PermissionGroupInfo; |
| 40 | import android.content.pm.PermissionInfo; |
| 41 | import android.content.pm.ResolveInfo; |
| 42 | import android.content.pm.ServiceInfo; |
Amith Yamasani | 0b28549 | 2011-04-14 17:35:23 -0700 | [diff] [blame] | 43 | import android.content.pm.UserInfo; |
rich cannings | 706e8ba | 2012-08-20 13:20:14 -0700 | [diff] [blame] | 44 | import android.content.pm.VerificationParams; |
Kenny Root | 0aaa0d9 | 2011-09-12 16:42:55 -0700 | [diff] [blame] | 45 | import android.content.pm.VerifierDeviceIdentity; |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 46 | import android.net.Uri; |
Amith Yamasani | b8151ec | 2012-04-18 18:02:48 -0700 | [diff] [blame] | 47 | import android.os.ParcelFileDescriptor; |
Suchi Amalapurapu | 1ccac75 | 2009-06-12 10:09:58 -0700 | [diff] [blame] | 48 | import android.content.IntentSender; |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 49 | |
| 50 | /** |
| 51 | * See {@link PackageManager} for documentation on most of the APIs |
| 52 | * here. |
| 53 | * |
| 54 | * {@hide} |
| 55 | */ |
| 56 | interface IPackageManager { |
Christopher Tate | ba629da | 2013-11-13 17:42:28 -0800 | [diff] [blame] | 57 | boolean isPackageAvailable(String packageName, int userId); |
Amith Yamasani | 483f3b0 | 2012-03-13 16:08:00 -0700 | [diff] [blame] | 58 | PackageInfo getPackageInfo(String packageName, int flags, int userId); |
| 59 | int getPackageUid(String packageName, int userId); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 60 | int[] getPackageGids(String packageName); |
Dianne Hackborn | 4709693 | 2010-02-11 15:57:09 -0800 | [diff] [blame] | 61 | |
| 62 | String[] currentToCanonicalPackageNames(in String[] names); |
| 63 | String[] canonicalToCurrentPackageNames(in String[] names); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 64 | |
| 65 | PermissionInfo getPermissionInfo(String name, int flags); |
| 66 | |
| 67 | List<PermissionInfo> queryPermissionsByGroup(String group, int flags); |
| 68 | |
| 69 | PermissionGroupInfo getPermissionGroupInfo(String name, int flags); |
| 70 | |
| 71 | List<PermissionGroupInfo> getAllPermissionGroups(int flags); |
| 72 | |
Amith Yamasani | 483f3b0 | 2012-03-13 16:08:00 -0700 | [diff] [blame] | 73 | ApplicationInfo getApplicationInfo(String packageName, int flags ,int userId); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 74 | |
Amith Yamasani | 483f3b0 | 2012-03-13 16:08:00 -0700 | [diff] [blame] | 75 | ActivityInfo getActivityInfo(in ComponentName className, int flags, int userId); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 76 | |
Dianne Hackborn | 91097de | 2014-04-04 18:02:06 -0700 | [diff] [blame^] | 77 | boolean activitySupportsIntent(in ComponentName className, in Intent intent, |
| 78 | String resolvedType); |
| 79 | |
Amith Yamasani | 483f3b0 | 2012-03-13 16:08:00 -0700 | [diff] [blame] | 80 | ActivityInfo getReceiverInfo(in ComponentName className, int flags, int userId); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 81 | |
Amith Yamasani | 483f3b0 | 2012-03-13 16:08:00 -0700 | [diff] [blame] | 82 | ServiceInfo getServiceInfo(in ComponentName className, int flags, int userId); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 83 | |
Amith Yamasani | 483f3b0 | 2012-03-13 16:08:00 -0700 | [diff] [blame] | 84 | ProviderInfo getProviderInfo(in ComponentName className, int flags, int userId); |
Dianne Hackborn | 361199b | 2010-08-30 17:42:07 -0700 | [diff] [blame] | 85 | |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 86 | int checkPermission(String permName, String pkgName); |
| 87 | |
| 88 | int checkUidPermission(String permName, int uid); |
| 89 | |
| 90 | boolean addPermission(in PermissionInfo info); |
| 91 | |
| 92 | void removePermission(String name); |
Dianne Hackborn | e639da7 | 2012-02-21 15:11:13 -0800 | [diff] [blame] | 93 | |
| 94 | void grantPermission(String packageName, String permissionName); |
| 95 | |
| 96 | void revokePermission(String packageName, String permissionName); |
| 97 | |
Dianne Hackborn | 854060af | 2009-07-09 18:14:31 -0700 | [diff] [blame] | 98 | boolean isProtectedBroadcast(String actionName); |
| 99 | |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 100 | int checkSignatures(String pkg1, String pkg2); |
| 101 | |
Dianne Hackborn | 766cbfe | 2009-08-12 18:33:39 -0700 | [diff] [blame] | 102 | int checkUidSignatures(int uid1, int uid2); |
| 103 | |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 104 | String[] getPackagesForUid(int uid); |
| 105 | |
| 106 | String getNameForUid(int uid); |
| 107 | |
| 108 | int getUidForSharedUser(String sharedUserName); |
Ben Gruver | dd72c9e | 2013-08-06 12:34:17 -0700 | [diff] [blame] | 109 | |
| 110 | int getFlagsForUid(int uid); |
| 111 | |
Amith Yamasani | 483f3b0 | 2012-03-13 16:08:00 -0700 | [diff] [blame] | 112 | ResolveInfo resolveIntent(in Intent intent, String resolvedType, int flags, int userId); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 113 | |
| 114 | List<ResolveInfo> queryIntentActivities(in Intent intent, |
Amith Yamasani | 483f3b0 | 2012-03-13 16:08:00 -0700 | [diff] [blame] | 115 | String resolvedType, int flags, int userId); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 116 | |
| 117 | List<ResolveInfo> queryIntentActivityOptions( |
| 118 | in ComponentName caller, in Intent[] specifics, |
| 119 | in String[] specificTypes, in Intent intent, |
Amith Yamasani | 483f3b0 | 2012-03-13 16:08:00 -0700 | [diff] [blame] | 120 | String resolvedType, int flags, int userId); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 121 | |
| 122 | List<ResolveInfo> queryIntentReceivers(in Intent intent, |
Amith Yamasani | 483f3b0 | 2012-03-13 16:08:00 -0700 | [diff] [blame] | 123 | String resolvedType, int flags, int userId); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 124 | |
| 125 | ResolveInfo resolveService(in Intent intent, |
Amith Yamasani | 483f3b0 | 2012-03-13 16:08:00 -0700 | [diff] [blame] | 126 | String resolvedType, int flags, int userId); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 127 | |
| 128 | List<ResolveInfo> queryIntentServices(in Intent intent, |
Amith Yamasani | 483f3b0 | 2012-03-13 16:08:00 -0700 | [diff] [blame] | 129 | String resolvedType, int flags, int userId); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 130 | |
Jeff Sharkey | 85f5f81 | 2013-10-07 10:16:12 -0700 | [diff] [blame] | 131 | List<ResolveInfo> queryIntentContentProviders(in Intent intent, |
| 132 | String resolvedType, int flags, int userId); |
| 133 | |
Kenny Root | 0e2c0f3 | 2011-04-15 17:50:10 -0700 | [diff] [blame] | 134 | /** |
| 135 | * This implements getInstalledPackages via a "last returned row" |
| 136 | * mechanism that is not exposed in the API. This is to get around the IPC |
| 137 | * limit that kicks in when flags are included that bloat up the data |
| 138 | * returned. |
| 139 | */ |
Dianne Hackborn | d8e1dbb | 2013-01-17 17:47:37 -0800 | [diff] [blame] | 140 | ParceledListSlice getInstalledPackages(int flags, in int userId); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 141 | |
Kenny Root | 0e2c0f3 | 2011-04-15 17:50:10 -0700 | [diff] [blame] | 142 | /** |
Dianne Hackborn | e799175 | 2013-01-16 17:56:46 -0800 | [diff] [blame] | 143 | * This implements getPackagesHoldingPermissions via a "last returned row" |
| 144 | * mechanism that is not exposed in the API. This is to get around the IPC |
| 145 | * limit that kicks in when flags are included that bloat up the data |
| 146 | * returned. |
| 147 | */ |
| 148 | ParceledListSlice getPackagesHoldingPermissions(in String[] permissions, |
Dianne Hackborn | d8e1dbb | 2013-01-17 17:47:37 -0800 | [diff] [blame] | 149 | int flags, int userId); |
Dianne Hackborn | e799175 | 2013-01-16 17:56:46 -0800 | [diff] [blame] | 150 | |
| 151 | /** |
Kenny Root | 0e2c0f3 | 2011-04-15 17:50:10 -0700 | [diff] [blame] | 152 | * This implements getInstalledApplications via a "last returned row" |
| 153 | * mechanism that is not exposed in the API. This is to get around the IPC |
| 154 | * limit that kicks in when flags are included that bloat up the data |
| 155 | * returned. |
| 156 | */ |
Dianne Hackborn | d8e1dbb | 2013-01-17 17:47:37 -0800 | [diff] [blame] | 157 | ParceledListSlice getInstalledApplications(int flags, int userId); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 158 | |
| 159 | /** |
| 160 | * Retrieve all applications that are marked as persistent. |
| 161 | * |
| 162 | * @return A List<applicationInfo> containing one entry for each persistent |
| 163 | * application. |
| 164 | */ |
| 165 | List<ApplicationInfo> getPersistentApplications(int flags); |
| 166 | |
Amith Yamasani | 483f3b0 | 2012-03-13 16:08:00 -0700 | [diff] [blame] | 167 | ProviderInfo resolveContentProvider(String name, int flags, int userId); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 168 | |
| 169 | /** |
| 170 | * Retrieve sync information for all content providers. |
| 171 | * |
| 172 | * @param outNames Filled in with a list of the root names of the content |
| 173 | * providers that can sync. |
| 174 | * @param outInfo Filled in with a list of the ProviderInfo for each |
| 175 | * name in 'outNames'. |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 176 | */ |
| 177 | void querySyncProviders(inout List<String> outNames, |
| 178 | inout List<ProviderInfo> outInfo); |
| 179 | |
| 180 | List<ProviderInfo> queryContentProviders( |
| 181 | String processName, int uid, int flags); |
| 182 | |
| 183 | InstrumentationInfo getInstrumentationInfo( |
| 184 | in ComponentName className, int flags); |
| 185 | |
| 186 | List<InstrumentationInfo> queryInstrumentation( |
| 187 | String targetPackage, int flags); |
| 188 | |
| 189 | /** |
| 190 | * Install a package. |
| 191 | * |
| 192 | * @param packageURI The location of the package file to install. |
| 193 | * @param observer a callback to use to notify when the package installation in finished. |
| 194 | * @param flags - possible values: {@link #FORWARD_LOCK_PACKAGE}, |
| 195 | * {@link #REPLACE_EXISITING_PACKAGE} |
Jacek Surazski | 65e1317 | 2009-04-28 15:26:38 +0200 | [diff] [blame] | 196 | * @param installerPackageName Optional package name of the application that is performing the |
| 197 | * installation. This identifies which market the package came from. |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 198 | */ |
Jacek Surazski | 65e1317 | 2009-04-28 15:26:38 +0200 | [diff] [blame] | 199 | void installPackage(in Uri packageURI, IPackageInstallObserver observer, int flags, |
| 200 | in String installerPackageName); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 201 | |
Christopher Tate | 1bb6906 | 2010-02-19 17:02:12 -0800 | [diff] [blame] | 202 | void finishPackageInstall(int token); |
| 203 | |
Dianne Hackborn | 880119b | 2010-11-18 22:26:40 -0800 | [diff] [blame] | 204 | void setInstallerPackageName(in String targetPackage, in String installerPackageName); |
| 205 | |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 206 | /** |
Amith Yamasani | 67df64b | 2012-12-14 12:09:36 -0800 | [diff] [blame] | 207 | * Delete a package for a specific user. |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 208 | * |
| 209 | * @param packageName The fully qualified name of the package to delete. |
| 210 | * @param observer a callback to use to notify when the package deletion in finished. |
Amith Yamasani | 67df64b | 2012-12-14 12:09:36 -0800 | [diff] [blame] | 211 | * @param userId the id of the user for whom to delete the package |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 212 | * @param flags - possible values: {@link #DONT_DELETE_DATA} |
| 213 | */ |
Amith Yamasani | 67df64b | 2012-12-14 12:09:36 -0800 | [diff] [blame] | 214 | void deletePackageAsUser(in String packageName, IPackageDeleteObserver observer, |
| 215 | int userId, int flags); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 216 | |
Jacek Surazski | 65e1317 | 2009-04-28 15:26:38 +0200 | [diff] [blame] | 217 | String getInstallerPackageName(in String packageName); |
| 218 | |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 219 | void addPackageToPreferred(String packageName); |
Amith Yamasani | 67df64b | 2012-12-14 12:09:36 -0800 | [diff] [blame] | 220 | |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 221 | void removePackageFromPreferred(String packageName); |
Amith Yamasani | 67df64b | 2012-12-14 12:09:36 -0800 | [diff] [blame] | 222 | |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 223 | List<PackageInfo> getPreferredPackages(int flags); |
| 224 | |
Dianne Hackborn | 8a2ed1d | 2013-01-29 15:18:29 -0800 | [diff] [blame] | 225 | void resetPreferredActivities(int userId); |
| 226 | |
Amith Yamasani | e9ecc8b | 2013-08-22 11:16:27 -0700 | [diff] [blame] | 227 | ResolveInfo getLastChosenActivity(in Intent intent, |
| 228 | String resolvedType, int flags); |
| 229 | |
| 230 | void setLastChosenActivity(in Intent intent, String resolvedType, int flags, |
| 231 | in IntentFilter filter, int match, in ComponentName activity); |
| 232 | |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 233 | void addPreferredActivity(in IntentFilter filter, int match, |
Amith Yamasani | a3f133a | 2012-08-09 17:11:28 -0700 | [diff] [blame] | 234 | in ComponentName[] set, in ComponentName activity, int userId); |
Satish Sampath | 8dbe612 | 2009-06-02 23:35:54 +0100 | [diff] [blame] | 235 | |
| 236 | void replacePreferredActivity(in IntentFilter filter, int match, |
| 237 | in ComponentName[] set, in ComponentName activity); |
| 238 | |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 239 | void clearPackagePreferredActivities(String packageName); |
Satish Sampath | 8dbe612 | 2009-06-02 23:35:54 +0100 | [diff] [blame] | 240 | |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 241 | int getPreferredActivities(out List<IntentFilter> outFilters, |
| 242 | out List<ComponentName> outActivities, String packageName); |
Amith Yamasani | e9ecc8b | 2013-08-22 11:16:27 -0700 | [diff] [blame] | 243 | |
Sander Alewijnse | f475ca3 | 2014-02-17 15:13:58 +0000 | [diff] [blame] | 244 | void addPersistentPreferredActivity(in IntentFilter filter, in ComponentName activity, int userId); |
| 245 | |
| 246 | void clearPackagePersistentPreferredActivities(String packageName, int userId); |
| 247 | |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 248 | /** |
Christopher Tate | a2a0850d | 2013-09-05 16:38:58 -0700 | [diff] [blame] | 249 | * Report the set of 'Home' activity candidates, plus (if any) which of them |
| 250 | * is the current "always use this one" setting. |
| 251 | */ |
| 252 | ComponentName getHomeActivities(out List<ResolveInfo> outHomeCandidates); |
| 253 | |
| 254 | /** |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 255 | * As per {@link android.content.pm.PackageManager#setComponentEnabledSetting}. |
| 256 | */ |
| 257 | void setComponentEnabledSetting(in ComponentName componentName, |
Amith Yamasani | 483f3b0 | 2012-03-13 16:08:00 -0700 | [diff] [blame] | 258 | in int newState, in int flags, int userId); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 259 | |
| 260 | /** |
| 261 | * As per {@link android.content.pm.PackageManager#getComponentEnabledSetting}. |
| 262 | */ |
Amith Yamasani | 483f3b0 | 2012-03-13 16:08:00 -0700 | [diff] [blame] | 263 | int getComponentEnabledSetting(in ComponentName componentName, int userId); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 264 | |
| 265 | /** |
| 266 | * As per {@link android.content.pm.PackageManager#setApplicationEnabledSetting}. |
| 267 | */ |
Dianne Hackborn | 3fa3c28a | 2013-03-26 16:15:41 -0700 | [diff] [blame] | 268 | void setApplicationEnabledSetting(in String packageName, in int newState, int flags, |
| 269 | int userId, String callingPackage); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 270 | |
| 271 | /** |
| 272 | * As per {@link android.content.pm.PackageManager#getApplicationEnabledSetting}. |
| 273 | */ |
Amith Yamasani | 483f3b0 | 2012-03-13 16:08:00 -0700 | [diff] [blame] | 274 | int getApplicationEnabledSetting(in String packageName, int userId); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 275 | |
| 276 | /** |
Dianne Hackborn | e7f9721 | 2011-02-24 14:40:20 -0800 | [diff] [blame] | 277 | * Set whether the given package should be considered stopped, making |
| 278 | * it not visible to implicit intents that filter out stopped packages. |
| 279 | */ |
Amith Yamasani | 483f3b0 | 2012-03-13 16:08:00 -0700 | [diff] [blame] | 280 | void setPackageStoppedState(String packageName, boolean stopped, int userId); |
Dianne Hackborn | e7f9721 | 2011-02-24 14:40:20 -0800 | [diff] [blame] | 281 | |
| 282 | /** |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 283 | * Free storage by deleting LRU sorted list of cache files across |
| 284 | * all applications. If the currently available free storage |
| 285 | * on the device is greater than or equal to the requested |
| 286 | * free storage, no cache files are cleared. If the currently |
| 287 | * available storage on the device is less than the requested |
| 288 | * free storage, some or all of the cache files across |
| 289 | * all applications are deleted (based on last accessed time) |
| 290 | * to increase the free storage space on the device to |
| 291 | * the requested value. There is no guarantee that clearing all |
| 292 | * the cache files from all applications will clear up |
| 293 | * enough storage to achieve the desired value. |
| 294 | * @param freeStorageSize The number of bytes of storage to be |
| 295 | * freed by the system. Say if freeStorageSize is XX, |
| 296 | * and the current free storage is YY, |
| 297 | * if XX is less than YY, just return. if not free XX-YY number |
| 298 | * of bytes if possible. |
| 299 | * @param observer call back used to notify when |
| 300 | * the operation is completed |
| 301 | */ |
| 302 | void freeStorageAndNotify(in long freeStorageSize, |
| 303 | IPackageDataObserver observer); |
| 304 | |
| 305 | /** |
| 306 | * Free storage by deleting LRU sorted list of cache files across |
| 307 | * all applications. If the currently available free storage |
| 308 | * on the device is greater than or equal to the requested |
| 309 | * free storage, no cache files are cleared. If the currently |
| 310 | * available storage on the device is less than the requested |
| 311 | * free storage, some or all of the cache files across |
| 312 | * all applications are deleted (based on last accessed time) |
| 313 | * to increase the free storage space on the device to |
| 314 | * the requested value. There is no guarantee that clearing all |
| 315 | * the cache files from all applications will clear up |
| 316 | * enough storage to achieve the desired value. |
| 317 | * @param freeStorageSize The number of bytes of storage to be |
| 318 | * freed by the system. Say if freeStorageSize is XX, |
| 319 | * and the current free storage is YY, |
| 320 | * if XX is less than YY, just return. if not free XX-YY number |
| 321 | * of bytes if possible. |
Suchi Amalapurapu | 1ccac75 | 2009-06-12 10:09:58 -0700 | [diff] [blame] | 322 | * @param pi IntentSender call back used to |
| 323 | * notify when the operation is completed.May be null |
| 324 | * to indicate that no call back is desired. |
| 325 | */ |
Suchi Amalapurapu | bc806f6 | 2009-06-17 15:18:19 -0700 | [diff] [blame] | 326 | void freeStorage(in long freeStorageSize, |
Suchi Amalapurapu | 1ccac75 | 2009-06-12 10:09:58 -0700 | [diff] [blame] | 327 | in IntentSender pi); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 328 | |
| 329 | /** |
| 330 | * Delete all the cache files in an applications cache directory |
| 331 | * @param packageName The package name of the application whose cache |
| 332 | * files need to be deleted |
| 333 | * @param observer a callback used to notify when the deletion is finished. |
| 334 | */ |
| 335 | void deleteApplicationCacheFiles(in String packageName, IPackageDataObserver observer); |
| 336 | |
| 337 | /** |
| 338 | * Clear the user data directory of an application. |
| 339 | * @param packageName The package name of the application whose cache |
| 340 | * files need to be deleted |
| 341 | * @param observer a callback used to notify when the operation is completed. |
| 342 | */ |
Amith Yamasani | 483f3b0 | 2012-03-13 16:08:00 -0700 | [diff] [blame] | 343 | void clearApplicationUserData(in String packageName, IPackageDataObserver observer, int userId); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 344 | |
| 345 | /** |
| 346 | * Get package statistics including the code, data and cache size for |
| 347 | * an already installed package |
| 348 | * @param packageName The package name of the application |
Dianne Hackborn | 0c38049 | 2012-08-20 17:23:30 -0700 | [diff] [blame] | 349 | * @param userHandle Which user the size should be retrieved for |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 350 | * @param observer a callback to use to notify when the asynchronous |
| 351 | * retrieval of information is complete. |
| 352 | */ |
Dianne Hackborn | 0c38049 | 2012-08-20 17:23:30 -0700 | [diff] [blame] | 353 | void getPackageSizeInfo(in String packageName, int userHandle, IPackageStatsObserver observer); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 354 | |
| 355 | /** |
| 356 | * Get a list of shared libraries that are available on the |
| 357 | * system. |
| 358 | */ |
| 359 | String[] getSystemSharedLibraryNames(); |
| 360 | |
Dianne Hackborn | 4923734 | 2009-08-27 20:08:01 -0700 | [diff] [blame] | 361 | /** |
| 362 | * Get a list of features that are available on the |
| 363 | * system. |
| 364 | */ |
| 365 | FeatureInfo[] getSystemAvailableFeatures(); |
| 366 | |
Dianne Hackborn | 039c68e | 2009-09-26 16:39:23 -0700 | [diff] [blame] | 367 | boolean hasSystemFeature(String name); |
| 368 | |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 369 | void enterSafeMode(); |
| 370 | boolean isSafeMode(); |
| 371 | void systemReady(); |
| 372 | boolean hasSystemUidErrors(); |
Dianne Hackborn | 661cd52 | 2011-08-22 00:26:20 -0700 | [diff] [blame] | 373 | |
| 374 | /** |
| 375 | * Ask the package manager to perform boot-time dex-opt of all |
| 376 | * existing packages. |
| 377 | */ |
| 378 | void performBootDexOpt(); |
| 379 | |
Dianne Hackborn | 5c1e00b | 2009-06-18 17:10:57 -0700 | [diff] [blame] | 380 | /** |
| 381 | * Ask the package manager to perform dex-opt (if needed) on the given |
| 382 | * package, if it already hasn't done mode. Only does this if running |
| 383 | * in the special development "no pre-dexopt" mode. |
| 384 | */ |
| 385 | boolean performDexOpt(String packageName); |
Suchi Amalapurapu | af8e9f4 | 2010-01-12 10:17:28 -0800 | [diff] [blame] | 386 | |
| 387 | /** |
| 388 | * Update status of external media on the package manager to scan and |
| 389 | * install packages installed on the external media. Like say the |
| 390 | * MountService uses this to call into the package manager to update |
| 391 | * status of sdcard. |
| 392 | */ |
Suchi Amalapurapu | e99bb5f | 2010-03-19 14:36:49 -0700 | [diff] [blame] | 393 | void updateExternalMediaStatus(boolean mounted, boolean reportStatus); |
Suchi Amalapurapu | af8e9f4 | 2010-01-12 10:17:28 -0800 | [diff] [blame] | 394 | |
Dianne Hackborn | 7767eac | 2012-08-23 18:25:40 -0700 | [diff] [blame] | 395 | PackageCleanItem nextPackageToClean(in PackageCleanItem lastPackage); |
Suchi Amalapurapu | 8946dd3 | 2010-02-19 09:19:34 -0800 | [diff] [blame] | 396 | |
| 397 | void movePackage(String packageName, IPackageMoveObserver observer, int flags); |
Rich Cannings | e1d7c71 | 2012-08-08 12:46:06 -0700 | [diff] [blame] | 398 | |
Dianne Hackborn | d7c0968 | 2010-03-30 10:42:20 -0700 | [diff] [blame] | 399 | boolean addPermissionAsync(in PermissionInfo info); |
Suchi Amalapurapu | 40e4725 | 2010-04-07 16:15:50 -0700 | [diff] [blame] | 400 | |
| 401 | boolean setInstallLocation(int loc); |
| 402 | int getInstallLocation(); |
Amith Yamasani | 0b28549 | 2011-04-14 17:35:23 -0700 | [diff] [blame] | 403 | |
Kenny Root | 5ab2157 | 2011-07-27 11:11:19 -0700 | [diff] [blame] | 404 | void installPackageWithVerification(in Uri packageURI, in IPackageInstallObserver observer, |
| 405 | int flags, in String installerPackageName, in Uri verificationURI, |
Rich Cannings | e1d7c71 | 2012-08-08 12:46:06 -0700 | [diff] [blame] | 406 | in ManifestDigest manifestDigest, in ContainerEncryptionParams encryptionParams); |
Kenny Root | 5ab2157 | 2011-07-27 11:11:19 -0700 | [diff] [blame] | 407 | |
rich cannings | 706e8ba | 2012-08-20 13:20:14 -0700 | [diff] [blame] | 408 | void installPackageWithVerificationAndEncryption(in Uri packageURI, |
| 409 | in IPackageInstallObserver observer, int flags, in String installerPackageName, |
| 410 | in VerificationParams verificationParams, |
| 411 | in ContainerEncryptionParams encryptionParams); |
| 412 | |
Christopher Tate | f1977b4 | 2014-03-24 16:25:51 -0700 | [diff] [blame] | 413 | /** Expanded observer versions */ |
| 414 | void installPackageEtc(in Uri packageURI, IPackageInstallObserver observer, |
| 415 | IPackageInstallObserver2 observer2, int flags, in String installerPackageName); |
| 416 | |
| 417 | void installPackageWithVerificationEtc(in Uri packageURI, |
| 418 | in IPackageInstallObserver observer, IPackageInstallObserver2 observer2, |
| 419 | int flags, in String installerPackageName, in Uri verificationURI, |
| 420 | in ManifestDigest manifestDigest, in ContainerEncryptionParams encryptionParams); |
| 421 | |
| 422 | void installPackageWithVerificationAndEncryptionEtc(in Uri packageURI, |
| 423 | in IPackageInstallObserver observer, in IPackageInstallObserver2 observer2, |
| 424 | int flags, in String installerPackageName, |
| 425 | in VerificationParams verificationParams, |
| 426 | in ContainerEncryptionParams encryptionParams); |
| 427 | |
Amith Yamasani | 67df64b | 2012-12-14 12:09:36 -0800 | [diff] [blame] | 428 | int installExistingPackageAsUser(String packageName, int userId); |
Dianne Hackborn | 7767eac | 2012-08-23 18:25:40 -0700 | [diff] [blame] | 429 | |
Kenny Root | 3a9b5fb | 2011-09-20 14:15:38 -0700 | [diff] [blame] | 430 | void verifyPendingInstall(int id, int verificationCode); |
rich cannings | d9ef3e5 | 2012-08-22 14:28:05 -0700 | [diff] [blame] | 431 | void extendVerificationTimeout(int id, int verificationCodeAtTimeout, long millisecondsToDelay); |
Kenny Root | 0aaa0d9 | 2011-09-12 16:42:55 -0700 | [diff] [blame] | 432 | |
| 433 | VerifierDeviceIdentity getVerifierDeviceIdentity(); |
Dianne Hackborn | 58f42a5 | 2011-10-10 13:46:34 -0700 | [diff] [blame] | 434 | |
| 435 | boolean isFirstBoot(); |
Dianne Hackborn | 13579ed | 2012-11-28 18:05:36 -0800 | [diff] [blame] | 436 | boolean isOnlyCoreApps(); |
Amith Yamasani | 742a671 | 2011-05-04 14:49:28 -0700 | [diff] [blame] | 437 | |
Jeff Sharkey | 5d32e77 | 2012-04-12 15:59:23 -0700 | [diff] [blame] | 438 | void setPermissionEnforced(String permission, boolean enforced); |
| 439 | boolean isPermissionEnforced(String permission); |
Jeff Sharkey | f6f7f1d | 2012-06-12 17:12:08 -0700 | [diff] [blame] | 440 | |
| 441 | /** Reflects current DeviceStorageMonitorService state */ |
| 442 | boolean isStorageLow(); |
Amith Yamasani | 655d0e2 | 2013-06-12 14:19:10 -0700 | [diff] [blame] | 443 | |
| 444 | boolean setApplicationBlockedSettingAsUser(String packageName, boolean blocked, int userId); |
| 445 | boolean getApplicationBlockedSettingAsUser(String packageName, int userId); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 446 | } |