blob: 1f53c0e36070961161a1ed5d82f77af5cae7a9ea [file] [log] [blame]
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001/*
2 * Copyright (C) 2006 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
17package android.app;
18
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080019import android.content.ComponentName;
20import android.content.ContentProviderNative;
21import android.content.IContentProvider;
Brad Fitzpatrickcb9ceb12010-07-29 14:29:02 -070022import android.content.IIntentReceiver;
23import android.content.IIntentSender;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080024import android.content.Intent;
25import android.content.IntentFilter;
Dianne Hackbornfa82f222009-09-17 15:14:12 -070026import android.content.IntentSender;
Christopher Tate181fafa2009-05-14 11:12:14 -070027import android.content.pm.ApplicationInfo;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080028import android.content.pm.ConfigurationInfo;
29import android.content.pm.IPackageDataObserver;
30import android.content.pm.ProviderInfo;
31import android.content.res.Configuration;
32import android.graphics.Bitmap;
33import android.net.Uri;
Brad Fitzpatrickcb9ceb12010-07-29 14:29:02 -070034import android.os.Bundle;
Dianne Hackborn3025ef32009-08-31 21:31:47 -070035import android.os.Debug;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080036import android.os.IBinder;
37import android.os.IInterface;
38import android.os.Parcel;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080039import android.os.ParcelFileDescriptor;
Brad Fitzpatrickcb9ceb12010-07-29 14:29:02 -070040import android.os.Parcelable;
41import android.os.RemoteException;
42import android.os.StrictMode;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080043
44import java.util.List;
45
46/**
47 * System private API for talking with the activity manager service. This
48 * provides calls from the application back to the activity manager.
49 *
50 * {@hide}
51 */
52public interface IActivityManager extends IInterface {
Dianne Hackborn95fc68f2009-05-19 18:37:45 -070053 /**
54 * Returned by startActivity() if the start request was canceled because
55 * app switches are temporarily canceled to ensure the user's last request
56 * (such as pressing home) is performed.
57 */
58 public static final int START_SWITCHES_CANCELED = 4;
59 /**
60 * Returned by startActivity() if an activity wasn't really started, but
61 * the given Intent was given to the existing top activity.
62 */
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080063 public static final int START_DELIVERED_TO_TOP = 3;
Dianne Hackborn95fc68f2009-05-19 18:37:45 -070064 /**
65 * Returned by startActivity() if an activity wasn't really started, but
66 * a task was simply brought to the foreground.
67 */
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080068 public static final int START_TASK_TO_FRONT = 2;
Dianne Hackborn95fc68f2009-05-19 18:37:45 -070069 /**
70 * Returned by startActivity() if the caller asked that the Intent not
71 * be executed if it is the recipient, and that is indeed the case.
72 */
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080073 public static final int START_RETURN_INTENT_TO_CALLER = 1;
Dianne Hackborn95fc68f2009-05-19 18:37:45 -070074 /**
75 * Activity was started successfully as normal.
76 */
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080077 public static final int START_SUCCESS = 0;
78 public static final int START_INTENT_NOT_RESOLVED = -1;
79 public static final int START_CLASS_NOT_FOUND = -2;
80 public static final int START_FORWARD_AND_REQUEST_CONFLICT = -3;
81 public static final int START_PERMISSION_DENIED = -4;
Dianne Hackbornbcbcaa72009-09-10 10:54:46 -070082 public static final int START_NOT_ACTIVITY = -5;
83 public static final int START_CANCELED = -6;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080084 public int startActivity(IApplicationThread caller,
85 Intent intent, String resolvedType, Uri[] grantedUriPermissions,
86 int grantedMode, IBinder resultTo, String resultWho, int requestCode,
87 boolean onlyIfNeeded, boolean debug) throws RemoteException;
Dianne Hackborn8f7f35e2010-02-25 18:48:12 -080088 public WaitResult startActivityAndWait(IApplicationThread caller,
89 Intent intent, String resolvedType, Uri[] grantedUriPermissions,
90 int grantedMode, IBinder resultTo, String resultWho, int requestCode,
91 boolean onlyIfNeeded, boolean debug) throws RemoteException;
Dianne Hackborn2ccda4d2010-03-22 21:49:15 -070092 public int startActivityWithConfig(IApplicationThread caller,
93 Intent intent, String resolvedType, Uri[] grantedUriPermissions,
94 int grantedMode, IBinder resultTo, String resultWho, int requestCode,
95 boolean onlyIfNeeded, boolean debug, Configuration newConfig) throws RemoteException;
Dianne Hackbornfa82f222009-09-17 15:14:12 -070096 public int startActivityIntentSender(IApplicationThread caller,
97 IntentSender intent, Intent fillInIntent, String resolvedType,
Dianne Hackbornbcbcaa72009-09-10 10:54:46 -070098 IBinder resultTo, String resultWho, int requestCode,
99 int flagsMask, int flagsValues) throws RemoteException;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800100 public boolean startNextMatchingActivity(IBinder callingActivity,
101 Intent intent) throws RemoteException;
102 public boolean finishActivity(IBinder token, int code, Intent data)
103 throws RemoteException;
104 public void finishSubActivity(IBinder token, String resultWho, int requestCode) throws RemoteException;
Dianne Hackborn061d58a2010-03-12 15:07:06 -0800105 public boolean willActivityBeVisible(IBinder token) throws RemoteException;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800106 public Intent registerReceiver(IApplicationThread caller,
107 IIntentReceiver receiver, IntentFilter filter,
108 String requiredPermission) throws RemoteException;
109 public void unregisterReceiver(IIntentReceiver receiver) throws RemoteException;
110 public static final int BROADCAST_SUCCESS = 0;
111 public static final int BROADCAST_STICKY_CANT_HAVE_PERMISSION = -1;
112 public int broadcastIntent(IApplicationThread caller, Intent intent,
113 String resolvedType, IIntentReceiver resultTo, int resultCode,
114 String resultData, Bundle map, String requiredPermission,
115 boolean serialized, boolean sticky) throws RemoteException;
116 public void unbroadcastIntent(IApplicationThread caller, Intent intent) throws RemoteException;
117 /* oneway */
118 public void finishReceiver(IBinder who, int resultCode, String resultData, Bundle map, boolean abortBroadcast) throws RemoteException;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800119 public void attachApplication(IApplicationThread app) throws RemoteException;
120 /* oneway */
Dianne Hackborne88846e2009-09-30 21:34:25 -0700121 public void activityIdle(IBinder token, Configuration config) throws RemoteException;
Dianne Hackborn0aae2d42010-12-07 23:51:29 -0800122 public void activityPaused(IBinder token) throws RemoteException;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800123 /* oneway */
Dianne Hackborn0aae2d42010-12-07 23:51:29 -0800124 public void activityStopped(IBinder token, Bundle state,
125 Bitmap thumbnail, CharSequence description) throws RemoteException;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800126 /* oneway */
Dianne Hackborn4eba96b2011-01-21 13:34:36 -0800127 public void activitySlept(IBinder token) throws RemoteException;
128 /* oneway */
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800129 public void activityDestroyed(IBinder token) throws RemoteException;
130 public String getCallingPackage(IBinder token) throws RemoteException;
131 public ComponentName getCallingActivity(IBinder token) throws RemoteException;
132 public List getTasks(int maxNum, int flags,
133 IThumbnailReceiver receiver) throws RemoteException;
134 public List<ActivityManager.RecentTaskInfo> getRecentTasks(int maxNum,
135 int flags) throws RemoteException;
Dianne Hackbornf26fd992011-04-08 18:14:09 -0700136 public ActivityManager.TaskThumbnails getTaskThumbnails(int taskId) throws RemoteException;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800137 public List getServices(int maxNum, int flags) throws RemoteException;
138 public List<ActivityManager.ProcessErrorStateInfo> getProcessesInErrorState()
139 throws RemoteException;
Dianne Hackborn621e17d2010-11-22 15:59:56 -0800140 public void moveTaskToFront(int task, int flags) throws RemoteException;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800141 public void moveTaskToBack(int task) throws RemoteException;
142 public boolean moveActivityTaskToBack(IBinder token, boolean nonRoot) throws RemoteException;
143 public void moveTaskBackwards(int task) throws RemoteException;
144 public int getTaskForActivity(IBinder token, boolean onlyRoot) throws RemoteException;
145 public void finishOtherInstances(IBinder token, ComponentName className) throws RemoteException;
146 /* oneway */
147 public void reportThumbnail(IBinder token,
Dianne Hackborndd9b82c2009-09-03 00:18:47 -0700148 Bitmap thumbnail, CharSequence description) throws RemoteException;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800149 public ContentProviderHolder getContentProvider(IApplicationThread caller,
Dianne Hackborndd9b82c2009-09-03 00:18:47 -0700150 String name) throws RemoteException;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800151 public void removeContentProvider(IApplicationThread caller,
Dianne Hackborndd9b82c2009-09-03 00:18:47 -0700152 String name) throws RemoteException;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800153 public void publishContentProviders(IApplicationThread caller,
Dianne Hackborndd9b82c2009-09-03 00:18:47 -0700154 List<ContentProviderHolder> providers) throws RemoteException;
155 public PendingIntent getRunningServiceControlPanel(ComponentName service)
156 throws RemoteException;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800157 public ComponentName startService(IApplicationThread caller, Intent service,
158 String resolvedType) throws RemoteException;
159 public int stopService(IApplicationThread caller, Intent service,
160 String resolvedType) throws RemoteException;
161 public boolean stopServiceToken(ComponentName className, IBinder token,
162 int startId) throws RemoteException;
163 public void setServiceForeground(ComponentName className, IBinder token,
Dianne Hackbornd8a43f62009-08-17 23:33:56 -0700164 int id, Notification notification, boolean keepNotification) throws RemoteException;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800165 public int bindService(IApplicationThread caller, IBinder token,
166 Intent service, String resolvedType,
167 IServiceConnection connection, int flags) throws RemoteException;
168 public boolean unbindService(IServiceConnection connection) throws RemoteException;
169 public void publishService(IBinder token,
170 Intent intent, IBinder service) throws RemoteException;
171 public void unbindFinished(IBinder token, Intent service,
172 boolean doRebind) throws RemoteException;
173 /* oneway */
Dianne Hackbornf6f9f2d2009-08-21 16:26:03 -0700174 public void serviceDoneExecuting(IBinder token, int type, int startId,
175 int res) throws RemoteException;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800176 public IBinder peekService(Intent service, String resolvedType) throws RemoteException;
177
Christopher Tate181fafa2009-05-14 11:12:14 -0700178 public boolean bindBackupAgent(ApplicationInfo appInfo, int backupRestoreMode)
179 throws RemoteException;
180 public void backupAgentCreated(String packageName, IBinder agent) throws RemoteException;
181 public void unbindBackupAgent(ApplicationInfo appInfo) throws RemoteException;
Christopher Tate5e1ab332009-09-01 20:32:49 -0700182 public void killApplicationProcess(String processName, int uid) throws RemoteException;
Christopher Tate181fafa2009-05-14 11:12:14 -0700183
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800184 public boolean startInstrumentation(ComponentName className, String profileFile,
185 int flags, Bundle arguments, IInstrumentationWatcher watcher)
186 throws RemoteException;
187 public void finishInstrumentation(IApplicationThread target,
188 int resultCode, Bundle results) throws RemoteException;
189
190 public Configuration getConfiguration() throws RemoteException;
191 public void updateConfiguration(Configuration values) throws RemoteException;
192 public void setRequestedOrientation(IBinder token,
193 int requestedOrientation) throws RemoteException;
194 public int getRequestedOrientation(IBinder token) throws RemoteException;
195
196 public ComponentName getActivityClassForToken(IBinder token) throws RemoteException;
197 public String getPackageForToken(IBinder token) throws RemoteException;
198
199 public static final int INTENT_SENDER_BROADCAST = 1;
200 public static final int INTENT_SENDER_ACTIVITY = 2;
201 public static final int INTENT_SENDER_ACTIVITY_RESULT = 3;
202 public static final int INTENT_SENDER_SERVICE = 4;
203 public IIntentSender getIntentSender(int type,
204 String packageName, IBinder token, String resultWho,
Dianne Hackborn621e17d2010-11-22 15:59:56 -0800205 int requestCode, Intent[] intents, String[] resolvedTypes,
206 int flags) throws RemoteException;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800207 public void cancelIntentSender(IIntentSender sender) throws RemoteException;
208 public boolean clearApplicationUserData(final String packageName,
209 final IPackageDataObserver observer) throws RemoteException;
210 public String getPackageForIntentSender(IIntentSender sender) throws RemoteException;
211
212 public void setProcessLimit(int max) throws RemoteException;
213 public int getProcessLimit() throws RemoteException;
214
Dianne Hackborn621e17d2010-11-22 15:59:56 -0800215 public void setProcessForeground(IBinder token, int pid,
216 boolean isForeground) throws RemoteException;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800217
218 public int checkPermission(String permission, int pid, int uid)
219 throws RemoteException;
220
221 public int checkUriPermission(Uri uri, int pid, int uid, int mode)
222 throws RemoteException;
223 public void grantUriPermission(IApplicationThread caller, String targetPkg,
224 Uri uri, int mode) throws RemoteException;
225 public void revokeUriPermission(IApplicationThread caller, Uri uri,
226 int mode) throws RemoteException;
227
228 public void showWaitingForDebugger(IApplicationThread who, boolean waiting)
229 throws RemoteException;
230
231 public void getMemoryInfo(ActivityManager.MemoryInfo outInfo) throws RemoteException;
232
Dianne Hackborn03abb812010-01-04 18:43:19 -0800233 public void killBackgroundProcesses(final String packageName) throws RemoteException;
234 public void forceStopPackage(final String packageName) throws RemoteException;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800235
236 // Note: probably don't want to allow applications access to these.
237 public void goingToSleep() throws RemoteException;
238 public void wakingUp() throws RemoteException;
239
240 public void unhandledBack() throws RemoteException;
241 public ParcelFileDescriptor openContentUri(Uri uri) throws RemoteException;
242 public void setDebugApp(
243 String packageName, boolean waitForDebugger, boolean persistent)
244 throws RemoteException;
245 public void setAlwaysFinish(boolean enabled) throws RemoteException;
Dianne Hackbornb06ea702009-07-13 13:07:51 -0700246 public void setActivityController(IActivityController watcher)
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800247 throws RemoteException;
248
249 public void enterSafeMode() throws RemoteException;
250
251 public void noteWakeupAlarm(IIntentSender sender) throws RemoteException;
252
Dianne Hackborn64825172011-03-02 21:32:58 -0800253 public boolean killPids(int[] pids, String reason, boolean secure) throws RemoteException;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800254
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800255 // Special low-level communication with activity manager.
256 public void startRunning(String pkg, String cls, String action,
257 String data) throws RemoteException;
Dan Egnor60d87622009-12-16 16:32:58 -0800258 public void handleApplicationCrash(IBinder app,
259 ApplicationErrorReport.CrashInfo crashInfo) throws RemoteException;
260 public boolean handleApplicationWtf(IBinder app, String tag,
Dan Egnorb7f03672009-12-09 16:22:32 -0800261 ApplicationErrorReport.CrashInfo crashInfo) throws RemoteException;
Brad Fitzpatrick46d42382010-06-11 13:57:58 -0700262
263 // A StrictMode violation to be handled. The violationMask is a
264 // subset of the original StrictMode policy bitmask, with only the
265 // bit violated and penalty bits to be executed by the
266 // ActivityManagerService remaining set.
267 public void handleApplicationStrictModeViolation(IBinder app, int violationMask,
Brad Fitzpatrickcb9ceb12010-07-29 14:29:02 -0700268 StrictMode.ViolationInfo crashInfo) throws RemoteException;
Brad Fitzpatrick438d0592010-06-10 12:19:19 -0700269
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800270 /*
271 * This will deliver the specified signal to all the persistent processes. Currently only
272 * SIGUSR1 is delivered. All others are ignored.
273 */
274 public void signalPersistentProcesses(int signal) throws RemoteException;
Suchi Amalapurapuf7f5dda2010-03-23 10:34:28 -0700275 // Retrieve info of applications installed on external media that are currently
276 // running.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800277 public List<ActivityManager.RunningAppProcessInfo> getRunningAppProcesses()
278 throws RemoteException;
Suchi Amalapurapuf7f5dda2010-03-23 10:34:28 -0700279 // Retrieve running application processes in the system
280 public List<ApplicationInfo> getRunningExternalApplications()
281 throws RemoteException;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800282 // Get device configuration
283 public ConfigurationInfo getDeviceConfigurationInfo() throws RemoteException;
284
The Android Open Source Projectf5b4b982009-03-05 20:00:43 -0800285 // Turn on/off profiling in a particular process.
286 public boolean profileControl(String process, boolean start,
Dianne Hackborn9c8dd552009-06-23 19:22:52 -0700287 String path, ParcelFileDescriptor fd) throws RemoteException;
The Android Open Source Projectf5b4b982009-03-05 20:00:43 -0800288
Dianne Hackborn55280a92009-05-07 15:53:46 -0700289 public boolean shutdown(int timeout) throws RemoteException;
290
Dianne Hackborn95fc68f2009-05-19 18:37:45 -0700291 public void stopAppSwitches() throws RemoteException;
292 public void resumeAppSwitches() throws RemoteException;
293
Dianne Hackbornb06ea702009-07-13 13:07:51 -0700294 public void registerActivityWatcher(IActivityWatcher watcher)
295 throws RemoteException;
296 public void unregisterActivityWatcher(IActivityWatcher watcher)
297 throws RemoteException;
298
Dianne Hackborn2d91af02009-07-16 13:34:33 -0700299 public int startActivityInPackage(int uid,
300 Intent intent, String resolvedType, IBinder resultTo,
301 String resultWho, int requestCode, boolean onlyIfNeeded)
302 throws RemoteException;
Suchi Amalapurapu261e66a2009-07-27 15:21:34 -0700303
304 public void killApplicationWithUid(String pkg, int uid) throws RemoteException;
Dianne Hackborna6ddc8a2009-07-28 17:49:55 -0700305
306 public void closeSystemDialogs(String reason) throws RemoteException;
307
Dianne Hackborn4f21c4c2009-09-17 10:24:05 -0700308 public Debug.MemoryInfo[] getProcessMemoryInfo(int[] pids)
Dianne Hackborn3025ef32009-08-31 21:31:47 -0700309 throws RemoteException;
310
Dianne Hackborn3b3e1452009-09-24 19:22:12 -0700311 public void overridePendingTransition(IBinder token, String packageName,
312 int enterAnim, int exitAnim) throws RemoteException;
313
Dianne Hackborn9327f4f2010-01-29 10:38:29 -0800314 public boolean isUserAMonkey() throws RemoteException;
315
Dianne Hackborn860755f2010-06-03 18:47:52 -0700316 public void finishHeavyWeightApp() throws RemoteException;
Daniel Sandler69a48172010-06-23 16:29:36 -0400317
318 public void setImmersive(IBinder token, boolean immersive) throws RemoteException;
319 public boolean isImmersive(IBinder token) throws RemoteException;
320 public boolean isTopActivityImmersive() throws RemoteException;
Dianne Hackborn860755f2010-06-03 18:47:52 -0700321
Dianne Hackborn9d39d0c2010-06-24 15:57:42 -0700322 public void crashApplication(int uid, int initialPid, String packageName,
323 String message) throws RemoteException;
Dianne Hackborncca1f0e2010-09-26 18:34:53 -0700324
325 public String getProviderMimeType(Uri uri) throws RemoteException;
Dianne Hackborn9d39d0c2010-06-24 15:57:42 -0700326
Dianne Hackborn7e269642010-08-25 19:50:20 -0700327 public IBinder newUriPermissionOwner(String name) throws RemoteException;
328 public void grantUriPermissionFromOwner(IBinder owner, int fromUid, String targetPkg,
329 Uri uri, int mode) throws RemoteException;
330 public void revokeUriPermissionFromOwner(IBinder owner, Uri uri,
331 int mode) throws RemoteException;
Andy McFadden824c5102010-07-09 16:26:57 -0700332
Dianne Hackborn90f4aaf2010-09-27 14:58:44 -0700333 public int checkGrantUriPermission(int callingUid, String targetPkg,
334 Uri uri, int modeFlags) throws RemoteException;
335
Andy McFadden824c5102010-07-09 16:26:57 -0700336 // Cause the specified process to dump the specified heap.
337 public boolean dumpHeap(String process, boolean managed, String path,
338 ParcelFileDescriptor fd) throws RemoteException;
339
Dianne Hackborn621e17d2010-11-22 15:59:56 -0800340 public int startActivities(IApplicationThread caller,
341 Intent[] intents, String[] resolvedTypes, IBinder resultTo) throws RemoteException;
342 public int startActivitiesInPackage(int uid,
343 Intent[] intents, String[] resolvedTypes, IBinder resultTo) throws RemoteException;
344
Dianne Hackborn0f1de9a2011-05-11 17:34:49 -0700345 public int getFrontActivityScreenCompatMode() throws RemoteException;
346 public void setFrontActivityScreenCompatMode(int mode) throws RemoteException;
347 public int getPackageScreenCompatMode(String packageName) throws RemoteException;
348 public void setPackageScreenCompatMode(String packageName, int mode)
Dianne Hackborne2515ee2011-04-27 18:52:56 -0400349 throws RemoteException;
Dianne Hackbornaa9d84c2011-05-09 19:00:59 -0700350
Amith Yamasani4b2e9342011-03-31 12:38:53 -0700351 // Multi-user APIs
352 public boolean switchUser(int userid) throws RemoteException;
Dianne Hackborn0c5001d2011-04-12 18:16:08 -0700353
354 public boolean removeSubTask(int taskId, int subTaskIndex) throws RemoteException;
355
356 public boolean removeTask(int taskId, int flags) throws RemoteException;
Amith Yamasani4b2e9342011-03-31 12:38:53 -0700357
Jeff Sharkeya4620792011-05-20 15:29:23 -0700358 public void registerProcessObserver(IProcessObserver observer) throws RemoteException;
359 public void unregisterProcessObserver(IProcessObserver observer) throws RemoteException;
360
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800361 /*
362 * Private non-Binder interfaces
363 */
364 /* package */ boolean testIsSystemReady();
365
366 /** Information you can retrieve about a particular application. */
367 public static class ContentProviderHolder implements Parcelable {
368 public final ProviderInfo info;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800369 public IContentProvider provider;
370 public boolean noReleaseNeeded;
371
372 public ContentProviderHolder(ProviderInfo _info) {
373 info = _info;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800374 }
375
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800376 public int describeContents() {
377 return 0;
378 }
379
380 public void writeToParcel(Parcel dest, int flags) {
381 info.writeToParcel(dest, 0);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800382 if (provider != null) {
383 dest.writeStrongBinder(provider.asBinder());
384 } else {
385 dest.writeStrongBinder(null);
386 }
387 dest.writeInt(noReleaseNeeded ? 1:0);
388 }
389
390 public static final Parcelable.Creator<ContentProviderHolder> CREATOR
391 = new Parcelable.Creator<ContentProviderHolder>() {
392 public ContentProviderHolder createFromParcel(Parcel source) {
393 return new ContentProviderHolder(source);
394 }
395
396 public ContentProviderHolder[] newArray(int size) {
397 return new ContentProviderHolder[size];
398 }
399 };
400
401 private ContentProviderHolder(Parcel source) {
402 info = ProviderInfo.CREATOR.createFromParcel(source);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800403 provider = ContentProviderNative.asInterface(
404 source.readStrongBinder());
405 noReleaseNeeded = source.readInt() != 0;
406 }
407 };
408
Dianne Hackborn8f7f35e2010-02-25 18:48:12 -0800409 /** Information returned after waiting for an activity start. */
410 public static class WaitResult implements Parcelable {
411 public int result;
412 public boolean timeout;
413 public ComponentName who;
414 public long thisTime;
415 public long totalTime;
416
417 public WaitResult() {
418 }
419
420 public int describeContents() {
421 return 0;
422 }
423
424 public void writeToParcel(Parcel dest, int flags) {
425 dest.writeInt(result);
426 dest.writeInt(timeout ? 1 : 0);
427 ComponentName.writeToParcel(who, dest);
428 dest.writeLong(thisTime);
429 dest.writeLong(totalTime);
430 }
431
432 public static final Parcelable.Creator<WaitResult> CREATOR
433 = new Parcelable.Creator<WaitResult>() {
434 public WaitResult createFromParcel(Parcel source) {
435 return new WaitResult(source);
436 }
437
438 public WaitResult[] newArray(int size) {
439 return new WaitResult[size];
440 }
441 };
442
443 private WaitResult(Parcel source) {
444 result = source.readInt();
445 timeout = source.readInt() != 0;
446 who = ComponentName.readFromParcel(source);
447 thisTime = source.readLong();
448 totalTime = source.readLong();
449 }
450 };
451
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800452 String descriptor = "android.app.IActivityManager";
453
454 // Please keep these transaction codes the same -- they are also
455 // sent by C++ code.
456 int START_RUNNING_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION;
Dan Egnor60d87622009-12-16 16:32:58 -0800457 int HANDLE_APPLICATION_CRASH_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+1;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800458 int START_ACTIVITY_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+2;
459 int UNHANDLED_BACK_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+3;
460 int OPEN_CONTENT_URI_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+4;
461
462 // Remaining non-native transaction codes.
463 int FINISH_ACTIVITY_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+10;
464 int REGISTER_RECEIVER_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+11;
465 int UNREGISTER_RECEIVER_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+12;
466 int BROADCAST_INTENT_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+13;
467 int UNBROADCAST_INTENT_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+14;
468 int FINISH_RECEIVER_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+15;
469 int ATTACH_APPLICATION_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+16;
470 int ACTIVITY_IDLE_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+17;
471 int ACTIVITY_PAUSED_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+18;
472 int ACTIVITY_STOPPED_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+19;
473 int GET_CALLING_PACKAGE_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+20;
474 int GET_CALLING_ACTIVITY_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+21;
475 int GET_TASKS_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+22;
476 int MOVE_TASK_TO_FRONT_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+23;
477 int MOVE_TASK_TO_BACK_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+24;
478 int MOVE_TASK_BACKWARDS_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+25;
479 int GET_TASK_FOR_ACTIVITY_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+26;
480 int REPORT_THUMBNAIL_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+27;
481 int GET_CONTENT_PROVIDER_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+28;
482 int PUBLISH_CONTENT_PROVIDERS_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+29;
Dianne Hackborn3c4c2b72010-10-05 18:07:54 -0700483
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800484 int FINISH_SUB_ACTIVITY_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+31;
Dianne Hackborndd9b82c2009-09-03 00:18:47 -0700485 int GET_RUNNING_SERVICE_CONTROL_PANEL_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+32;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800486 int START_SERVICE_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+33;
487 int STOP_SERVICE_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+34;
488 int BIND_SERVICE_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+35;
489 int UNBIND_SERVICE_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+36;
490 int PUBLISH_SERVICE_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+37;
491 int FINISH_OTHER_INSTANCES_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+38;
492 int GOING_TO_SLEEP_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+39;
493 int WAKING_UP_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+40;
494 int SET_DEBUG_APP_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+41;
495 int SET_ALWAYS_FINISH_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+42;
496 int START_INSTRUMENTATION_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+43;
497 int FINISH_INSTRUMENTATION_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+44;
498 int GET_CONFIGURATION_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+45;
499 int UPDATE_CONFIGURATION_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+46;
500 int STOP_SERVICE_TOKEN_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+47;
501 int GET_ACTIVITY_CLASS_FOR_TOKEN_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+48;
502 int GET_PACKAGE_FOR_TOKEN_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+49;
503 int SET_PROCESS_LIMIT_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+50;
504 int GET_PROCESS_LIMIT_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+51;
505 int CHECK_PERMISSION_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+52;
506 int CHECK_URI_PERMISSION_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+53;
507 int GRANT_URI_PERMISSION_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+54;
508 int REVOKE_URI_PERMISSION_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+55;
Dianne Hackbornb06ea702009-07-13 13:07:51 -0700509 int SET_ACTIVITY_CONTROLLER_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+56;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800510 int SHOW_WAITING_FOR_DEBUGGER_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+57;
511 int SIGNAL_PERSISTENT_PROCESSES_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+58;
512 int GET_RECENT_TASKS_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+59;
513 int SERVICE_DONE_EXECUTING_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+60;
514 int ACTIVITY_DESTROYED_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+61;
515 int GET_INTENT_SENDER_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+62;
516 int CANCEL_INTENT_SENDER_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+63;
517 int GET_PACKAGE_FOR_INTENT_SENDER_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+64;
518 int ENTER_SAFE_MODE_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+65;
519 int START_NEXT_MATCHING_ACTIVITY_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+66;
520 int NOTE_WAKEUP_ALARM_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+67;
521 int REMOVE_CONTENT_PROVIDER_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+68;
522 int SET_REQUESTED_ORIENTATION_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+69;
523 int GET_REQUESTED_ORIENTATION_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+70;
524 int UNBIND_FINISHED_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+71;
525 int SET_PROCESS_FOREGROUND_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+72;
526 int SET_SERVICE_FOREGROUND_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+73;
527 int MOVE_ACTIVITY_TASK_TO_BACK_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+74;
528 int GET_MEMORY_INFO_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+75;
529 int GET_PROCESSES_IN_ERROR_STATE_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+76;
530 int CLEAR_APP_DATA_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+77;
Dianne Hackborn03abb812010-01-04 18:43:19 -0800531 int FORCE_STOP_PACKAGE_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+78;
Suchi Amalapurapue99bb5f2010-03-19 14:36:49 -0700532 int KILL_PIDS_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+79;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800533 int GET_SERVICES_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+80;
Dianne Hackbornf26fd992011-04-08 18:14:09 -0700534 int GET_TASK_THUMBNAILS_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+81;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800535 int GET_RUNNING_APP_PROCESSES_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+82;
536 int GET_DEVICE_CONFIGURATION_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+83;
537 int PEEK_SERVICE_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+84;
The Android Open Source Projectf5b4b982009-03-05 20:00:43 -0800538 int PROFILE_CONTROL_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+85;
Dianne Hackborn55280a92009-05-07 15:53:46 -0700539 int SHUTDOWN_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+86;
Dianne Hackborn95fc68f2009-05-19 18:37:45 -0700540 int STOP_APP_SWITCHES_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+87;
541 int RESUME_APP_SWITCHES_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+88;
Christopher Tate181fafa2009-05-14 11:12:14 -0700542 int START_BACKUP_AGENT_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+89;
543 int BACKUP_AGENT_CREATED_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+90;
544 int UNBIND_BACKUP_AGENT_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+91;
Dianne Hackbornb06ea702009-07-13 13:07:51 -0700545 int REGISTER_ACTIVITY_WATCHER_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+92;
546 int UNREGISTER_ACTIVITY_WATCHER_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+93;
Dianne Hackborn2d91af02009-07-16 13:34:33 -0700547 int START_ACTIVITY_IN_PACKAGE_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+94;
Suchi Amalapurapu261e66a2009-07-27 15:21:34 -0700548 int KILL_APPLICATION_WITH_UID_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+95;
Dianne Hackborna6ddc8a2009-07-28 17:49:55 -0700549 int CLOSE_SYSTEM_DIALOGS_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+96;
Dianne Hackborn3025ef32009-08-31 21:31:47 -0700550 int GET_PROCESS_MEMORY_INFO_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+97;
Christopher Tate5e1ab332009-09-01 20:32:49 -0700551 int KILL_APPLICATION_PROCESS_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+98;
Dianne Hackbornfa82f222009-09-17 15:14:12 -0700552 int START_ACTIVITY_INTENT_SENDER_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+99;
Dianne Hackborn3b3e1452009-09-24 19:22:12 -0700553 int OVERRIDE_PENDING_TRANSITION_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+100;
Dan Egnor60d87622009-12-16 16:32:58 -0800554 int HANDLE_APPLICATION_WTF_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+101;
Dianne Hackborn03abb812010-01-04 18:43:19 -0800555 int KILL_BACKGROUND_PROCESSES_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+102;
Dianne Hackborn9327f4f2010-01-29 10:38:29 -0800556 int IS_USER_A_MONKEY_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+103;
Dianne Hackborn8f7f35e2010-02-25 18:48:12 -0800557 int START_ACTIVITY_AND_WAIT_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+104;
Dianne Hackborn061d58a2010-03-12 15:07:06 -0800558 int WILL_ACTIVITY_BE_VISIBLE_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+105;
Dianne Hackborn2ccda4d2010-03-22 21:49:15 -0700559 int START_ACTIVITY_WITH_CONFIG_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+106;
Suchi Amalapurapuf7f5dda2010-03-23 10:34:28 -0700560 int GET_RUNNING_EXTERNAL_APPLICATIONS_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+107;
Dianne Hackborn860755f2010-06-03 18:47:52 -0700561 int FINISH_HEAVY_WEIGHT_APP_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+108;
Brad Fitzpatrick438d0592010-06-10 12:19:19 -0700562 int HANDLE_APPLICATION_STRICT_MODE_VIOLATION_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+109;
Daniel Sandler69a48172010-06-23 16:29:36 -0400563 int IS_IMMERSIVE_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+110;
564 int SET_IMMERSIVE_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+111;
565 int IS_TOP_ACTIVITY_IMMERSIVE_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+112;
Dianne Hackborn9d39d0c2010-06-24 15:57:42 -0700566 int CRASH_APPLICATION_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+113;
Dianne Hackborncca1f0e2010-09-26 18:34:53 -0700567 int GET_PROVIDER_MIME_TYPE_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+114;
568 int NEW_URI_PERMISSION_OWNER_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+115;
569 int GRANT_URI_PERMISSION_FROM_OWNER_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+116;
570 int REVOKE_URI_PERMISSION_FROM_OWNER_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+117;
Dianne Hackborn90f4aaf2010-09-27 14:58:44 -0700571 int CHECK_GRANT_URI_PERMISSION_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+118;
572 int DUMP_HEAP_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+119;
Dianne Hackborn621e17d2010-11-22 15:59:56 -0800573 int START_ACTIVITIES_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+120;
574 int START_ACTIVITIES_IN_PACKAGE_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+121;
Dianne Hackborn4eba96b2011-01-21 13:34:36 -0800575 int ACTIVITY_SLEPT_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+122;
Dianne Hackborn0f1de9a2011-05-11 17:34:49 -0700576 int GET_FRONT_ACTIVITY_SCREEN_COMPAT_MODE_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+123;
577 int SET_FRONT_ACTIVITY_SCREEN_COMPAT_MODE_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+124;
578 int GET_PACKAGE_SCREEN_COMPAT_MODE_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+125;
579 int SET_PACKAGE_SCREEN_COMPAT_MODE_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+126;
Dianne Hackborn3d0724d2011-05-12 15:39:41 -0700580 int SWITCH_USER_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+127;
581 int REMOVE_SUB_TASK_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+128;
582 int REMOVE_TASK_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+129;
Jeff Sharkeya4620792011-05-20 15:29:23 -0700583 int REGISTER_PROCESS_OBSERVER_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+130;
584 int UNREGISTER_PROCESS_OBSERVER_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+131;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800585}