IPackageManager.aidl revision abb01dba70fa52b3576fa9f6a175f3840b959fde
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 18package android.content.pm; 19 20import android.content.ComponentName; 21import android.content.Intent; 22import android.content.IntentFilter; 23import android.content.pm.ActivityInfo; 24import android.content.pm.ApplicationInfo; 25import android.content.pm.IPackageInstallObserver; 26import android.content.pm.IPackageDeleteObserver; 27import android.content.pm.IPackageDataObserver; 28import android.content.pm.IPackageStatsObserver; 29import android.content.pm.InstrumentationInfo; 30import android.content.pm.PackageInfo; 31import android.content.pm.ProviderInfo; 32import android.content.pm.PermissionGroupInfo; 33import android.content.pm.PermissionInfo; 34import android.content.pm.ResolveInfo; 35import android.content.pm.ServiceInfo; 36import android.net.Uri; 37import android.app.PendingIntent; 38import android.content.IntentSender; 39 40/** 41 * See {@link PackageManager} for documentation on most of the APIs 42 * here. 43 * 44 * {@hide} 45 */ 46interface IPackageManager { 47 PackageInfo getPackageInfo(String packageName, int flags); 48 int getPackageUid(String packageName); 49 int[] getPackageGids(String packageName); 50 51 PermissionInfo getPermissionInfo(String name, int flags); 52 53 List<PermissionInfo> queryPermissionsByGroup(String group, int flags); 54 55 PermissionGroupInfo getPermissionGroupInfo(String name, int flags); 56 57 List<PermissionGroupInfo> getAllPermissionGroups(int flags); 58 59 ApplicationInfo getApplicationInfo(String packageName, int flags); 60 61 ActivityInfo getActivityInfo(in ComponentName className, int flags); 62 63 ActivityInfo getReceiverInfo(in ComponentName className, int flags); 64 65 ServiceInfo getServiceInfo(in ComponentName className, int flags); 66 67 int checkPermission(String permName, String pkgName); 68 69 int checkUidPermission(String permName, int uid); 70 71 boolean addPermission(in PermissionInfo info); 72 73 void removePermission(String name); 74 75 int checkSignatures(String pkg1, String pkg2); 76 77 String[] getPackagesForUid(int uid); 78 79 String getNameForUid(int uid); 80 81 int getUidForSharedUser(String sharedUserName); 82 83 ResolveInfo resolveIntent(in Intent intent, String resolvedType, int flags); 84 85 List<ResolveInfo> queryIntentActivities(in Intent intent, 86 String resolvedType, int flags); 87 88 List<ResolveInfo> queryIntentActivityOptions( 89 in ComponentName caller, in Intent[] specifics, 90 in String[] specificTypes, in Intent intent, 91 String resolvedType, int flags); 92 93 List<ResolveInfo> queryIntentReceivers(in Intent intent, 94 String resolvedType, int flags); 95 96 ResolveInfo resolveService(in Intent intent, 97 String resolvedType, int flags); 98 99 List<ResolveInfo> queryIntentServices(in Intent intent, 100 String resolvedType, int flags); 101 102 List<PackageInfo> getInstalledPackages(int flags); 103 104 List<ApplicationInfo> getInstalledApplications(int flags); 105 106 /** 107 * Retrieve all applications that are marked as persistent. 108 * 109 * @return A List<applicationInfo> containing one entry for each persistent 110 * application. 111 */ 112 List<ApplicationInfo> getPersistentApplications(int flags); 113 114 ProviderInfo resolveContentProvider(String name, int flags); 115 116 /** 117 * Retrieve sync information for all content providers. 118 * 119 * @param outNames Filled in with a list of the root names of the content 120 * providers that can sync. 121 * @param outInfo Filled in with a list of the ProviderInfo for each 122 * name in 'outNames'. 123 * @deprecated 124 */ 125 void querySyncProviders(inout List<String> outNames, 126 inout List<ProviderInfo> outInfo); 127 128 List<ProviderInfo> queryContentProviders( 129 String processName, int uid, int flags); 130 131 InstrumentationInfo getInstrumentationInfo( 132 in ComponentName className, int flags); 133 134 List<InstrumentationInfo> queryInstrumentation( 135 String targetPackage, int flags); 136 137 /** 138 * Install a package. 139 * 140 * @param packageURI The location of the package file to install. 141 * @param observer a callback to use to notify when the package installation in finished. 142 * @param flags - possible values: {@link #FORWARD_LOCK_PACKAGE}, 143 * {@link #REPLACE_EXISITING_PACKAGE} 144 * @param installerPackageName Optional package name of the application that is performing the 145 * installation. This identifies which market the package came from. 146 */ 147 void installPackage(in Uri packageURI, IPackageInstallObserver observer, int flags, 148 in String installerPackageName); 149 150 /** 151 * Delete a package. 152 * 153 * @param packageName The fully qualified name of the package to delete. 154 * @param observer a callback to use to notify when the package deletion in finished. 155 * @param flags - possible values: {@link #DONT_DELETE_DATA} 156 */ 157 void deletePackage(in String packageName, IPackageDeleteObserver observer, int flags); 158 159 String getInstallerPackageName(in String packageName); 160 161 void addPackageToPreferred(String packageName); 162 163 void removePackageFromPreferred(String packageName); 164 165 List<PackageInfo> getPreferredPackages(int flags); 166 167 void addPreferredActivity(in IntentFilter filter, int match, 168 in ComponentName[] set, in ComponentName activity); 169 170 void replacePreferredActivity(in IntentFilter filter, int match, 171 in ComponentName[] set, in ComponentName activity); 172 173 void clearPackagePreferredActivities(String packageName); 174 175 int getPreferredActivities(out List<IntentFilter> outFilters, 176 out List<ComponentName> outActivities, String packageName); 177 178 /** 179 * As per {@link android.content.pm.PackageManager#setComponentEnabledSetting}. 180 */ 181 void setComponentEnabledSetting(in ComponentName componentName, 182 in int newState, in int flags); 183 184 /** 185 * As per {@link android.content.pm.PackageManager#getComponentEnabledSetting}. 186 */ 187 int getComponentEnabledSetting(in ComponentName componentName); 188 189 /** 190 * As per {@link android.content.pm.PackageManager#setApplicationEnabledSetting}. 191 */ 192 void setApplicationEnabledSetting(in String packageName, in int newState, int flags); 193 194 /** 195 * As per {@link android.content.pm.PackageManager#getApplicationEnabledSetting}. 196 */ 197 int getApplicationEnabledSetting(in String packageName); 198 199 /** 200 * Free storage by deleting LRU sorted list of cache files across 201 * all applications. If the currently available free storage 202 * on the device is greater than or equal to the requested 203 * free storage, no cache files are cleared. If the currently 204 * available storage on the device is less than the requested 205 * free storage, some or all of the cache files across 206 * all applications are deleted (based on last accessed time) 207 * to increase the free storage space on the device to 208 * the requested value. There is no guarantee that clearing all 209 * the cache files from all applications will clear up 210 * enough storage to achieve the desired value. 211 * @param freeStorageSize The number of bytes of storage to be 212 * freed by the system. Say if freeStorageSize is XX, 213 * and the current free storage is YY, 214 * if XX is less than YY, just return. if not free XX-YY number 215 * of bytes if possible. 216 * @param observer call back used to notify when 217 * the operation is completed 218 */ 219 void freeStorageAndNotify(in long freeStorageSize, 220 IPackageDataObserver observer); 221 222 /** 223 * Free storage by deleting LRU sorted list of cache files across 224 * all applications. If the currently available free storage 225 * on the device is greater than or equal to the requested 226 * free storage, no cache files are cleared. If the currently 227 * available storage on the device is less than the requested 228 * free storage, some or all of the cache files across 229 * all applications are deleted (based on last accessed time) 230 * to increase the free storage space on the device to 231 * the requested value. There is no guarantee that clearing all 232 * the cache files from all applications will clear up 233 * enough storage to achieve the desired value. 234 * @param freeStorageSize The number of bytes of storage to be 235 * freed by the system. Say if freeStorageSize is XX, 236 * and the current free storage is YY, 237 * if XX is less than YY, just return. if not free XX-YY number 238 * of bytes if possible. 239 * @param opFinishedIntent PendingIntent call back used to 240 * notify when the operation is completed.May be null 241 * to indicate that no call back is desired. 242 */ 243 void freeStorage(in long freeStorageSize, 244 in PendingIntent opFinishedIntent); 245 246 /** 247 * Free storage by deleting LRU sorted list of cache files across 248 * all applications. If the currently available free storage 249 * on the device is greater than or equal to the requested 250 * free storage, no cache files are cleared. If the currently 251 * available storage on the device is less than the requested 252 * free storage, some or all of the cache files across 253 * all applications are deleted (based on last accessed time) 254 * to increase the free storage space on the device to 255 * the requested value. There is no guarantee that clearing all 256 * the cache files from all applications will clear up 257 * enough storage to achieve the desired value. 258 * @param freeStorageSize The number of bytes of storage to be 259 * freed by the system. Say if freeStorageSize is XX, 260 * and the current free storage is YY, 261 * if XX is less than YY, just return. if not free XX-YY number 262 * of bytes if possible. 263 * @param pi IntentSender call back used to 264 * notify when the operation is completed.May be null 265 * to indicate that no call back is desired. 266 */ 267 void freeStorageWithIntent(in long freeStorageSize, 268 in IntentSender pi); 269 270 /** 271 * Delete all the cache files in an applications cache directory 272 * @param packageName The package name of the application whose cache 273 * files need to be deleted 274 * @param observer a callback used to notify when the deletion is finished. 275 */ 276 void deleteApplicationCacheFiles(in String packageName, IPackageDataObserver observer); 277 278 /** 279 * Clear the user data directory of an application. 280 * @param packageName The package name of the application whose cache 281 * files need to be deleted 282 * @param observer a callback used to notify when the operation is completed. 283 */ 284 void clearApplicationUserData(in String packageName, IPackageDataObserver observer); 285 286 /** 287 * Get package statistics including the code, data and cache size for 288 * an already installed package 289 * @param packageName The package name of the application 290 * @param observer a callback to use to notify when the asynchronous 291 * retrieval of information is complete. 292 */ 293 void getPackageSizeInfo(in String packageName, IPackageStatsObserver observer); 294 295 /** 296 * Get a list of shared libraries that are available on the 297 * system. 298 */ 299 String[] getSystemSharedLibraryNames(); 300 301 void enterSafeMode(); 302 boolean isSafeMode(); 303 void systemReady(); 304 boolean hasSystemUidErrors(); 305} 306