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