ActivityStack.java revision 76e2a765b495f15a718dc4dfd9d81e9539a7074b
1/*
2 * Copyright (C) 2010 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 com.android.server.am;
18
19import static com.android.server.am.ActivityManagerService.TAG;
20import static com.android.server.am.ActivityManagerService.localLOGV;
21import static com.android.server.am.ActivityManagerService.DEBUG_CLEANUP;
22import static com.android.server.am.ActivityManagerService.DEBUG_CONFIGURATION;
23import static com.android.server.am.ActivityManagerService.DEBUG_PAUSE;
24import static com.android.server.am.ActivityManagerService.DEBUG_RESULTS;
25import static com.android.server.am.ActivityManagerService.DEBUG_STACK;
26import static com.android.server.am.ActivityManagerService.DEBUG_SWITCH;
27import static com.android.server.am.ActivityManagerService.DEBUG_TASKS;
28import static com.android.server.am.ActivityManagerService.DEBUG_TRANSITION;
29import static com.android.server.am.ActivityManagerService.DEBUG_USER_LEAVING;
30import static com.android.server.am.ActivityManagerService.DEBUG_VISBILITY;
31import static com.android.server.am.ActivityManagerService.VALIDATE_TOKENS;
32
33import static com.android.server.am.ActivityRecord.HOME_ACTIVITY_TYPE;
34import static com.android.server.am.ActivityRecord.APPLICATION_ACTIVITY_TYPE;
35import static com.android.server.am.ActivityRecord.RECENTS_ACTIVITY_TYPE;
36
37import static com.android.server.am.ActivityStackSupervisor.DEBUG_ADD_REMOVE;
38import static com.android.server.am.ActivityStackSupervisor.DEBUG_APP;
39import static com.android.server.am.ActivityStackSupervisor.DEBUG_CONTAINERS;
40import static com.android.server.am.ActivityStackSupervisor.DEBUG_SAVED_STATE;
41import static com.android.server.am.ActivityStackSupervisor.DEBUG_SCREENSHOTS;
42import static com.android.server.am.ActivityStackSupervisor.DEBUG_STATES;
43import static com.android.server.am.ActivityStackSupervisor.HOME_STACK_ID;
44
45import com.android.internal.app.IVoiceInteractor;
46import com.android.internal.os.BatteryStatsImpl;
47import com.android.server.Watchdog;
48import com.android.server.am.ActivityManagerService.ItemMatcher;
49import com.android.server.am.ActivityStackSupervisor.ActivityContainer;
50import com.android.server.wm.AppTransition;
51import com.android.server.wm.TaskGroup;
52import com.android.server.wm.WindowManagerService;
53
54import android.app.Activity;
55import android.app.ActivityManager;
56import android.app.ActivityOptions;
57import android.app.AppGlobals;
58import android.app.IActivityController;
59import android.app.ResultInfo;
60import android.app.ActivityManager.RunningTaskInfo;
61import android.content.ComponentName;
62import android.content.Intent;
63import android.content.pm.ActivityInfo;
64import android.content.pm.PackageManager;
65import android.content.res.Configuration;
66import android.content.res.Resources;
67import android.graphics.Bitmap;
68import android.net.Uri;
69import android.os.Binder;
70import android.os.Bundle;
71import android.os.Debug;
72import android.os.Handler;
73import android.os.IBinder;
74import android.os.Looper;
75import android.os.Message;
76import android.os.PersistableBundle;
77import android.os.RemoteException;
78import android.os.SystemClock;
79import android.os.Trace;
80import android.os.UserHandle;
81import android.service.voice.IVoiceInteractionSession;
82import android.util.EventLog;
83import android.util.Slog;
84import android.view.Display;
85
86import java.io.FileDescriptor;
87import java.io.PrintWriter;
88import java.lang.ref.WeakReference;
89import java.util.ArrayList;
90import java.util.Iterator;
91import java.util.List;
92import java.util.Objects;
93
94/**
95 * State and management of a single stack of activities.
96 */
97final class ActivityStack {
98
99    // Ticks during which we check progress while waiting for an app to launch.
100    static final int LAUNCH_TICK = 500;
101
102    // How long we wait until giving up on the last activity to pause.  This
103    // is short because it directly impacts the responsiveness of starting the
104    // next activity.
105    static final int PAUSE_TIMEOUT = 500;
106
107    // How long we wait for the activity to tell us it has stopped before
108    // giving up.  This is a good amount of time because we really need this
109    // from the application in order to get its saved state.
110    static final int STOP_TIMEOUT = 10*1000;
111
112    // How long we wait until giving up on an activity telling us it has
113    // finished destroying itself.
114    static final int DESTROY_TIMEOUT = 10*1000;
115
116    // How long until we reset a task when the user returns to it.  Currently
117    // disabled.
118    static final long ACTIVITY_INACTIVE_RESET_TIME = 0;
119
120    // How long between activity launches that we consider safe to not warn
121    // the user about an unexpected activity being launched on top.
122    static final long START_WARN_TIME = 5*1000;
123
124    // Set to false to disable the preview that is shown while a new activity
125    // is being started.
126    static final boolean SHOW_APP_STARTING_PREVIEW = true;
127
128    // How long to wait for all background Activities to redraw following a call to
129    // convertToTranslucent().
130    static final long TRANSLUCENT_CONVERSION_TIMEOUT = 2000;
131
132    static final boolean SCREENSHOT_FORCE_565 = ActivityManager.isLowRamDeviceStatic();
133
134    enum ActivityState {
135        INITIALIZING,
136        RESUMED,
137        PAUSING,
138        PAUSED,
139        STOPPING,
140        STOPPED,
141        FINISHING,
142        DESTROYING,
143        DESTROYED
144    }
145
146    final ActivityManagerService mService;
147    final WindowManagerService mWindowManager;
148
149    /**
150     * The back history of all previous (and possibly still
151     * running) activities.  It contains #TaskRecord objects.
152     */
153    private ArrayList<TaskRecord> mTaskHistory = new ArrayList<TaskRecord>();
154
155    /**
156     * Used for validating app tokens with window manager.
157     */
158    final ArrayList<TaskGroup> mValidateAppTokens = new ArrayList<TaskGroup>();
159
160    /**
161     * List of running activities, sorted by recent usage.
162     * The first entry in the list is the least recently used.
163     * It contains HistoryRecord objects.
164     */
165    final ArrayList<ActivityRecord> mLRUActivities = new ArrayList<ActivityRecord>();
166
167    /**
168     * Animations that for the current transition have requested not to
169     * be considered for the transition animation.
170     */
171    final ArrayList<ActivityRecord> mNoAnimActivities = new ArrayList<ActivityRecord>();
172
173    /**
174     * When we are in the process of pausing an activity, before starting the
175     * next one, this variable holds the activity that is currently being paused.
176     */
177    ActivityRecord mPausingActivity = null;
178
179    /**
180     * This is the last activity that we put into the paused state.  This is
181     * used to determine if we need to do an activity transition while sleeping,
182     * when we normally hold the top activity paused.
183     */
184    ActivityRecord mLastPausedActivity = null;
185
186    /**
187     * Activities that specify No History must be removed once the user navigates away from them.
188     * If the device goes to sleep with such an activity in the paused state then we save it here
189     * and finish it later if another activity replaces it on wakeup.
190     */
191    ActivityRecord mLastNoHistoryActivity = null;
192
193    /**
194     * Current activity that is resumed, or null if there is none.
195     */
196    ActivityRecord mResumedActivity = null;
197
198    /**
199     * This is the last activity that has been started.  It is only used to
200     * identify when multiple activities are started at once so that the user
201     * can be warned they may not be in the activity they think they are.
202     */
203    ActivityRecord mLastStartedActivity = null;
204
205    // The topmost Activity passed to convertToTranslucent(). When non-null it means we are
206    // waiting for all Activities in mUndrawnActivitiesBelowTopTranslucent to be removed as they
207    // are drawn. When the last member of mUndrawnActivitiesBelowTopTranslucent is removed the
208    // Activity in mTranslucentActivityWaiting is notified via
209    // Activity.onTranslucentConversionComplete(false). If a timeout occurs prior to the last
210    // background activity being drawn then the same call will be made with a true value.
211    ActivityRecord mTranslucentActivityWaiting = null;
212    ArrayList<ActivityRecord> mUndrawnActivitiesBelowTopTranslucent =
213            new ArrayList<ActivityRecord>();
214    // Options passed from the caller of the convertToTranslucent to the activity that will
215    // appear below it.
216    ActivityOptions mReturningActivityOptions = null;
217
218    /**
219     * Set when we know we are going to be calling updateConfiguration()
220     * soon, so want to skip intermediate config checks.
221     */
222    boolean mConfigWillChange;
223
224    long mLaunchStartTime = 0;
225    long mFullyDrawnStartTime = 0;
226
227    /**
228     * Save the most recent screenshot for reuse. This keeps Recents from taking two identical
229     * screenshots, one for the Recents thumbnail and one for the pauseActivity thumbnail.
230     */
231    private ActivityRecord mLastScreenshotActivity = null;
232    private Bitmap mLastScreenshotBitmap = null;
233
234    int mThumbnailWidth = -1;
235    int mThumbnailHeight = -1;
236
237    int mCurrentUser;
238
239    final int mStackId;
240    final ActivityContainer mActivityContainer;
241    /** The other stacks, in order, on the attached display. Updated at attach/detach time. */
242    ArrayList<ActivityStack> mStacks;
243    /** The attached Display's unique identifier, or -1 if detached */
244    int mDisplayId;
245
246    /** Run all ActivityStacks through this */
247    final ActivityStackSupervisor mStackSupervisor;
248
249    static final int PAUSE_TIMEOUT_MSG = ActivityManagerService.FIRST_ACTIVITY_STACK_MSG + 1;
250    static final int DESTROY_TIMEOUT_MSG = ActivityManagerService.FIRST_ACTIVITY_STACK_MSG + 2;
251    static final int LAUNCH_TICK_MSG = ActivityManagerService.FIRST_ACTIVITY_STACK_MSG + 3;
252    static final int STOP_TIMEOUT_MSG = ActivityManagerService.FIRST_ACTIVITY_STACK_MSG + 4;
253    static final int DESTROY_ACTIVITIES_MSG = ActivityManagerService.FIRST_ACTIVITY_STACK_MSG + 5;
254    static final int TRANSLUCENT_TIMEOUT_MSG = ActivityManagerService.FIRST_ACTIVITY_STACK_MSG + 6;
255
256    static class ScheduleDestroyArgs {
257        final ProcessRecord mOwner;
258        final boolean mOomAdj;
259        final String mReason;
260        ScheduleDestroyArgs(ProcessRecord owner, boolean oomAdj, String reason) {
261            mOwner = owner;
262            mOomAdj = oomAdj;
263            mReason = reason;
264        }
265    }
266
267    final Handler mHandler;
268
269    final class ActivityStackHandler extends Handler {
270        //public Handler() {
271        //    if (localLOGV) Slog.v(TAG, "Handler started!");
272        //}
273        ActivityStackHandler(Looper looper) {
274            super(looper);
275        }
276
277        @Override
278        public void handleMessage(Message msg) {
279            switch (msg.what) {
280                case PAUSE_TIMEOUT_MSG: {
281                    ActivityRecord r = (ActivityRecord)msg.obj;
282                    // We don't at this point know if the activity is fullscreen,
283                    // so we need to be conservative and assume it isn't.
284                    Slog.w(TAG, "Activity pause timeout for " + r);
285                    synchronized (mService) {
286                        if (r.app != null) {
287                            mService.logAppTooSlow(r.app, r.pauseTime, "pausing " + r);
288                        }
289                        activityPausedLocked(r.appToken, true, r.persistentState);
290                    }
291                } break;
292                case LAUNCH_TICK_MSG: {
293                    ActivityRecord r = (ActivityRecord)msg.obj;
294                    synchronized (mService) {
295                        if (r.continueLaunchTickingLocked()) {
296                            mService.logAppTooSlow(r.app, r.launchTickTime, "launching " + r);
297                        }
298                    }
299                } break;
300                case DESTROY_TIMEOUT_MSG: {
301                    ActivityRecord r = (ActivityRecord)msg.obj;
302                    // We don't at this point know if the activity is fullscreen,
303                    // so we need to be conservative and assume it isn't.
304                    Slog.w(TAG, "Activity destroy timeout for " + r);
305                    synchronized (mService) {
306                        activityDestroyedLocked(r != null ? r.appToken : null);
307                    }
308                } break;
309                case STOP_TIMEOUT_MSG: {
310                    ActivityRecord r = (ActivityRecord)msg.obj;
311                    // We don't at this point know if the activity is fullscreen,
312                    // so we need to be conservative and assume it isn't.
313                    Slog.w(TAG, "Activity stop timeout for " + r);
314                    synchronized (mService) {
315                        if (r.isInHistory()) {
316                            activityStoppedLocked(r, null, null, null);
317                        }
318                    }
319                } break;
320                case DESTROY_ACTIVITIES_MSG: {
321                    ScheduleDestroyArgs args = (ScheduleDestroyArgs)msg.obj;
322                    synchronized (mService) {
323                        destroyActivitiesLocked(args.mOwner, args.mOomAdj, args.mReason);
324                    }
325                } break;
326                case TRANSLUCENT_TIMEOUT_MSG: {
327                    synchronized (mService) {
328                        notifyActivityDrawnLocked(null);
329                    }
330                } break;
331            }
332        }
333    }
334
335    int numActivities() {
336        int count = 0;
337        for (int taskNdx = mTaskHistory.size() - 1; taskNdx >= 0; --taskNdx) {
338            count += mTaskHistory.get(taskNdx).mActivities.size();
339        }
340        return count;
341    }
342
343    ActivityStack(ActivityStackSupervisor.ActivityContainer activityContainer) {
344        mActivityContainer = activityContainer;
345        mStackSupervisor = activityContainer.getOuter();
346        mService = mStackSupervisor.mService;
347        mHandler = new ActivityStackHandler(mService.mHandler.getLooper());
348        mWindowManager = mService.mWindowManager;
349        mStackId = activityContainer.mStackId;
350        mCurrentUser = mService.mCurrentUserId;
351        // Get the activity screenshot thumbnail dimensions
352        Resources res = mService.mContext.getResources();
353        mThumbnailWidth = res.getDimensionPixelSize(com.android.internal.R.dimen.thumbnail_width);
354        mThumbnailHeight = res.getDimensionPixelSize(com.android.internal.R.dimen.thumbnail_height);
355    }
356
357    /**
358     * Checks whether the userid is a profile of the current user.
359     */
360    private boolean isCurrentProfileLocked(int userId) {
361        if (userId == mCurrentUser) return true;
362        for (int i = 0; i < mService.mCurrentProfileIds.length; i++) {
363            if (mService.mCurrentProfileIds[i] == userId) return true;
364        }
365        return false;
366    }
367
368    boolean okToShowLocked(ActivityRecord r) {
369        return isCurrentProfileLocked(r.userId)
370                || (r.info.flags & ActivityInfo.FLAG_SHOW_ON_LOCK_SCREEN) != 0;
371    }
372
373    final ActivityRecord topRunningActivityLocked(ActivityRecord notTop) {
374        for (int taskNdx = mTaskHistory.size() - 1; taskNdx >= 0; --taskNdx) {
375            ActivityRecord r = mTaskHistory.get(taskNdx).topRunningActivityLocked(notTop);
376            if (r != null) {
377                return r;
378            }
379        }
380        return null;
381    }
382
383    final ActivityRecord topRunningNonDelayedActivityLocked(ActivityRecord notTop) {
384        for (int taskNdx = mTaskHistory.size() - 1; taskNdx >= 0; --taskNdx) {
385            final TaskRecord task = mTaskHistory.get(taskNdx);
386            final ArrayList<ActivityRecord> activities = task.mActivities;
387            for (int activityNdx = activities.size() - 1; activityNdx >= 0; --activityNdx) {
388                ActivityRecord r = activities.get(activityNdx);
389                if (!r.finishing && !r.delayedResume && r != notTop && okToShowLocked(r)) {
390                    return r;
391                }
392            }
393        }
394        return null;
395    }
396
397    /**
398     * This is a simplified version of topRunningActivityLocked that provides a number of
399     * optional skip-over modes.  It is intended for use with the ActivityController hook only.
400     *
401     * @param token If non-null, any history records matching this token will be skipped.
402     * @param taskId If non-zero, we'll attempt to skip over records with the same task ID.
403     *
404     * @return Returns the HistoryRecord of the next activity on the stack.
405     */
406    final ActivityRecord topRunningActivityLocked(IBinder token, int taskId) {
407        for (int taskNdx = mTaskHistory.size() - 1; taskNdx >= 0; --taskNdx) {
408            TaskRecord task = mTaskHistory.get(taskNdx);
409            if (task.taskId == taskId) {
410                continue;
411            }
412            ArrayList<ActivityRecord> activities = task.mActivities;
413            for (int i = activities.size() - 1; i >= 0; --i) {
414                final ActivityRecord r = activities.get(i);
415                // Note: the taskId check depends on real taskId fields being non-zero
416                if (!r.finishing && (token != r.appToken) && okToShowLocked(r)) {
417                    return r;
418                }
419            }
420        }
421        return null;
422    }
423
424    final ActivityRecord topActivity() {
425        // Iterate to find the first non-empty task stack. Note that this code can
426        // be simplified once we stop storing tasks with empty mActivities lists.
427        for (int taskNdx = mTaskHistory.size() - 1; taskNdx >= 0; --taskNdx) {
428            ArrayList<ActivityRecord> activities = mTaskHistory.get(taskNdx).mActivities;
429            final int topActivityNdx = activities.size() - 1;
430            if (topActivityNdx >= 0) {
431                return activities.get(topActivityNdx);
432            }
433        }
434        return null;
435    }
436
437    final TaskRecord topTask() {
438        final int size = mTaskHistory.size();
439        if (size > 0) {
440            return mTaskHistory.get(size - 1);
441        }
442        return null;
443    }
444
445    TaskRecord taskForIdLocked(int id) {
446        for (int taskNdx = mTaskHistory.size() - 1; taskNdx >= 0; --taskNdx) {
447            final TaskRecord task = mTaskHistory.get(taskNdx);
448            if (task.taskId == id) {
449                return task;
450            }
451        }
452        return null;
453    }
454
455    ActivityRecord isInStackLocked(IBinder token) {
456        final ActivityRecord r = ActivityRecord.forToken(token);
457        if (r != null) {
458            final TaskRecord task = r.task;
459            if (task.mActivities.contains(r) && mTaskHistory.contains(task)) {
460                if (task.stack != this) Slog.w(TAG,
461                    "Illegal state! task does not point to stack it is in.");
462                return r;
463            }
464        }
465        return null;
466    }
467
468    final boolean updateLRUListLocked(ActivityRecord r) {
469        final boolean hadit = mLRUActivities.remove(r);
470        mLRUActivities.add(r);
471        return hadit;
472    }
473
474    final boolean isHomeStack() {
475        return mStackId == HOME_STACK_ID;
476    }
477
478    final boolean isOnHomeDisplay() {
479        return isAttached() &&
480                mActivityContainer.mActivityDisplay.mDisplayId == Display.DEFAULT_DISPLAY;
481    }
482
483    final void moveToFront() {
484        if (isAttached()) {
485            if (isOnHomeDisplay()) {
486                mStackSupervisor.moveHomeStack(isHomeStack());
487            }
488            mStacks.remove(this);
489            mStacks.add(this);
490        }
491    }
492
493    final boolean isAttached() {
494        return mStacks != null;
495    }
496
497    /**
498     * Returns the top activity in any existing task matching the given
499     * Intent.  Returns null if no such task is found.
500     */
501    ActivityRecord findTaskLocked(ActivityRecord target) {
502        Intent intent = target.intent;
503        ActivityInfo info = target.info;
504        ComponentName cls = intent.getComponent();
505        if (info.targetActivity != null) {
506            cls = new ComponentName(info.packageName, info.targetActivity);
507        }
508        final int userId = UserHandle.getUserId(info.applicationInfo.uid);
509        boolean isDocument = intent != null & intent.isDocument();
510        // If documentData is non-null then it must match the existing task data.
511        Uri documentData = isDocument ? intent.getData() : null;
512
513        if (DEBUG_TASKS) Slog.d(TAG, "Looking for task of " + target + " in " + this);
514        for (int taskNdx = mTaskHistory.size() - 1; taskNdx >= 0; --taskNdx) {
515            final TaskRecord task = mTaskHistory.get(taskNdx);
516            if (task.voiceSession != null) {
517                // We never match voice sessions; those always run independently.
518                if (DEBUG_TASKS) Slog.d(TAG, "Skipping " + task + ": voice session");
519                continue;
520            }
521            if (task.userId != userId) {
522                // Looking for a different task.
523                if (DEBUG_TASKS) Slog.d(TAG, "Skipping " + task + ": different user");
524                continue;
525            }
526            final ActivityRecord r = task.getTopActivity();
527            if (r == null || r.finishing || r.userId != userId ||
528                    r.launchMode == ActivityInfo.LAUNCH_SINGLE_INSTANCE) {
529                if (DEBUG_TASKS) Slog.d(TAG, "Skipping " + task + ": mismatch root " + r);
530                continue;
531            }
532
533            final Intent taskIntent = task.intent;
534            final Intent affinityIntent = task.affinityIntent;
535            final boolean taskIsDocument;
536            final Uri taskDocumentData;
537            if (taskIntent != null && taskIntent.isDocument()) {
538                taskIsDocument = true;
539                taskDocumentData = taskIntent.getData();
540            } else if (affinityIntent != null && affinityIntent.isDocument()) {
541                taskIsDocument = true;
542                taskDocumentData = affinityIntent.getData();
543            } else {
544                taskIsDocument = false;
545                taskDocumentData = null;
546            }
547
548            if (DEBUG_TASKS) Slog.d(TAG, "Comparing existing cls="
549                    + taskIntent.getComponent().flattenToShortString()
550                    + "/aff=" + r.task.affinity + " to new cls="
551                    + intent.getComponent().flattenToShortString() + "/aff=" + info.taskAffinity);
552            if (!isDocument && !taskIsDocument && task.affinity != null) {
553                if (task.affinity.equals(target.taskAffinity)) {
554                    if (DEBUG_TASKS) Slog.d(TAG, "Found matching affinity!");
555                    return r;
556                }
557            } else if (taskIntent != null && taskIntent.getComponent() != null &&
558                    taskIntent.getComponent().compareTo(cls) == 0 &&
559                    Objects.equals(documentData, taskDocumentData)) {
560                if (DEBUG_TASKS) Slog.d(TAG, "Found matching class!");
561                //dump();
562                if (DEBUG_TASKS) Slog.d(TAG, "For Intent " + intent + " bringing to top: "
563                        + r.intent);
564                return r;
565            } else if (affinityIntent != null && affinityIntent.getComponent() != null &&
566                    affinityIntent.getComponent().compareTo(cls) == 0 &&
567                    Objects.equals(documentData, taskDocumentData)) {
568                if (DEBUG_TASKS) Slog.d(TAG, "Found matching class!");
569                //dump();
570                if (DEBUG_TASKS) Slog.d(TAG, "For Intent " + intent + " bringing to top: "
571                        + r.intent);
572                return r;
573            } else if (DEBUG_TASKS) {
574                Slog.d(TAG, "Not a match: " + task);
575            }
576        }
577
578        return null;
579    }
580
581    /**
582     * Returns the first activity (starting from the top of the stack) that
583     * is the same as the given activity.  Returns null if no such activity
584     * is found.
585     */
586    ActivityRecord findActivityLocked(Intent intent, ActivityInfo info) {
587        ComponentName cls = intent.getComponent();
588        if (info.targetActivity != null) {
589            cls = new ComponentName(info.packageName, info.targetActivity);
590        }
591        final int userId = UserHandle.getUserId(info.applicationInfo.uid);
592
593        for (int taskNdx = mTaskHistory.size() - 1; taskNdx >= 0; --taskNdx) {
594            TaskRecord task = mTaskHistory.get(taskNdx);
595            if (!isCurrentProfileLocked(task.userId)) {
596                return null;
597            }
598            final ArrayList<ActivityRecord> activities = task.mActivities;
599            for (int activityNdx = activities.size() - 1; activityNdx >= 0; --activityNdx) {
600                ActivityRecord r = activities.get(activityNdx);
601                if (!r.finishing && r.intent.getComponent().equals(cls) && r.userId == userId) {
602                    //Slog.i(TAG, "Found matching class!");
603                    //dump();
604                    //Slog.i(TAG, "For Intent " + intent + " bringing to top: " + r.intent);
605                    return r;
606                }
607            }
608        }
609
610        return null;
611    }
612
613    /*
614     * Move the activities around in the stack to bring a user to the foreground.
615     */
616    final void switchUserLocked(int userId) {
617        if (mCurrentUser == userId) {
618            return;
619        }
620        mCurrentUser = userId;
621
622        // Move userId's tasks to the top.
623        int index = mTaskHistory.size();
624        for (int i = 0; i < index; ) {
625            TaskRecord task = mTaskHistory.get(i);
626            if (isCurrentProfileLocked(task.userId)) {
627                if (DEBUG_TASKS) Slog.d(TAG, "switchUserLocked: stack=" + getStackId() +
628                        " moving " + task + " to top");
629                mTaskHistory.remove(i);
630                mTaskHistory.add(task);
631                --index;
632                // Use same value for i.
633            } else {
634                ++i;
635            }
636        }
637        if (VALIDATE_TOKENS) {
638            validateAppTokensLocked();
639        }
640    }
641
642    void minimalResumeActivityLocked(ActivityRecord r) {
643        r.state = ActivityState.RESUMED;
644        if (DEBUG_STATES) Slog.v(TAG, "Moving to RESUMED: " + r
645                + " (starting new instance)");
646        r.stopped = false;
647        mResumedActivity = r;
648        r.task.touchActiveTime();
649        mService.addRecentTaskLocked(r.task);
650        completeResumeLocked(r);
651        mStackSupervisor.checkReadyForSleepLocked();
652        setLaunchTime(r);
653        if (DEBUG_SAVED_STATE) Slog.i(TAG, "Launch completed; removing icicle of " + r.icicle);
654    }
655
656    private void startLaunchTraces() {
657        if (mFullyDrawnStartTime != 0)  {
658            Trace.asyncTraceEnd(Trace.TRACE_TAG_ACTIVITY_MANAGER, "drawing", 0);
659        }
660        Trace.asyncTraceBegin(Trace.TRACE_TAG_ACTIVITY_MANAGER, "launching", 0);
661        Trace.asyncTraceBegin(Trace.TRACE_TAG_ACTIVITY_MANAGER, "drawing", 0);
662    }
663
664    private void stopFullyDrawnTraceIfNeeded() {
665        if (mFullyDrawnStartTime != 0 && mLaunchStartTime == 0) {
666            Trace.asyncTraceEnd(Trace.TRACE_TAG_ACTIVITY_MANAGER, "drawing", 0);
667            mFullyDrawnStartTime = 0;
668        }
669    }
670
671    void setLaunchTime(ActivityRecord r) {
672        if (r.displayStartTime == 0) {
673            r.fullyDrawnStartTime = r.displayStartTime = SystemClock.uptimeMillis();
674            if (mLaunchStartTime == 0) {
675                startLaunchTraces();
676                mLaunchStartTime = mFullyDrawnStartTime = r.displayStartTime;
677            }
678        } else if (mLaunchStartTime == 0) {
679            startLaunchTraces();
680            mLaunchStartTime = mFullyDrawnStartTime = SystemClock.uptimeMillis();
681        }
682    }
683
684    void clearLaunchTime(ActivityRecord r) {
685        // Make sure that there is no activity waiting for this to launch.
686        if (mStackSupervisor.mWaitingActivityLaunched.isEmpty()) {
687            r.displayStartTime = r.fullyDrawnStartTime = 0;
688        } else {
689            mStackSupervisor.removeTimeoutsForActivityLocked(r);
690            mStackSupervisor.scheduleIdleTimeoutLocked(r);
691        }
692    }
693
694    void awakeFromSleepingLocked() {
695        // Ensure activities are no longer sleeping.
696        for (int taskNdx = mTaskHistory.size() - 1; taskNdx >= 0; --taskNdx) {
697            final ArrayList<ActivityRecord> activities = mTaskHistory.get(taskNdx).mActivities;
698            for (int activityNdx = activities.size() - 1; activityNdx >= 0; --activityNdx) {
699                activities.get(activityNdx).setSleeping(false);
700            }
701        }
702    }
703
704    /**
705     * @return true if something must be done before going to sleep.
706     */
707    boolean checkReadyForSleepLocked() {
708        if (mResumedActivity != null) {
709            // Still have something resumed; can't sleep until it is paused.
710            if (DEBUG_PAUSE) Slog.v(TAG, "Sleep needs to pause " + mResumedActivity);
711            if (DEBUG_USER_LEAVING) Slog.v(TAG, "Sleep => pause with userLeaving=false");
712            startPausingLocked(false, true);
713            return true;
714        }
715        if (mPausingActivity != null) {
716            // Still waiting for something to pause; can't sleep yet.
717            if (DEBUG_PAUSE) Slog.v(TAG, "Sleep still waiting to pause " + mPausingActivity);
718            return true;
719        }
720
721        return false;
722    }
723
724    void goToSleep() {
725        ensureActivitiesVisibleLocked(null, 0);
726
727        // Make sure any stopped but visible activities are now sleeping.
728        // This ensures that the activity's onStop() is called.
729        for (int taskNdx = mTaskHistory.size() - 1; taskNdx >= 0; --taskNdx) {
730            final ArrayList<ActivityRecord> activities = mTaskHistory.get(taskNdx).mActivities;
731            for (int activityNdx = activities.size() - 1; activityNdx >= 0; --activityNdx) {
732                final ActivityRecord r = activities.get(activityNdx);
733                if (r.state == ActivityState.STOPPING || r.state == ActivityState.STOPPED) {
734                    r.setSleeping(true);
735                }
736            }
737        }
738    }
739
740    /**
741     * This resets the saved state from the last screenshot, forcing a new screenshot to be taken
742     * again when requested.
743     */
744    private void invalidateLastScreenshot() {
745        mLastScreenshotActivity = null;
746        if (mLastScreenshotBitmap != null) {
747            mLastScreenshotBitmap.recycle();
748        }
749        mLastScreenshotBitmap = null;
750    }
751
752    public final Bitmap screenshotActivities(ActivityRecord who) {
753        if (DEBUG_SCREENSHOTS) Slog.d(TAG, "screenshotActivities: " + who);
754        if (who.noDisplay) {
755            if (DEBUG_SCREENSHOTS) Slog.d(TAG, "\tNo display");
756            return null;
757        }
758
759        TaskRecord tr = who.task;
760        if (mService.getMostRecentTask() != tr || isHomeStack()) {
761            // This is an optimization -- since we never show Home or Recents within Recents itself,
762            // we can just go ahead and skip taking the screenshot if this is the home stack.  In
763            // the case where the most recent task is not the task that was supplied, then the stack
764            // has changed, so invalidate the last screenshot().
765            invalidateLastScreenshot();
766            if (DEBUG_SCREENSHOTS) Slog.d(TAG, "\tIs Home stack? " + isHomeStack());
767            return null;
768        }
769
770        int w = mThumbnailWidth;
771        int h = mThumbnailHeight;
772        if (w > 0) {
773            if (who != mLastScreenshotActivity || mLastScreenshotBitmap == null
774                    || mLastScreenshotActivity.state == ActivityState.RESUMED
775                    || mLastScreenshotBitmap.getWidth() != w
776                    || mLastScreenshotBitmap.getHeight() != h) {
777                if (DEBUG_SCREENSHOTS) Slog.d(TAG, "\tUpdating screenshot");
778                mLastScreenshotActivity = who;
779                mLastScreenshotBitmap = mWindowManager.screenshotApplications(
780                        who.appToken, Display.DEFAULT_DISPLAY, w, h, SCREENSHOT_FORCE_565);
781            }
782            if (mLastScreenshotBitmap != null) {
783                if (DEBUG_SCREENSHOTS) Slog.d(TAG, "\tReusing last screenshot");
784                return mLastScreenshotBitmap.copy(mLastScreenshotBitmap.getConfig(), true);
785            }
786        }
787        Slog.e(TAG, "Invalid thumbnail dimensions: " + w + "x" + h);
788        return null;
789    }
790
791    final void startPausingLocked(boolean userLeaving, boolean uiSleeping) {
792        if (mPausingActivity != null) {
793            Slog.e(TAG, "Trying to pause when pause is already pending for "
794                  + mPausingActivity, new RuntimeException("here").fillInStackTrace());
795        }
796        ActivityRecord prev = mResumedActivity;
797        if (prev == null) {
798            Slog.e(TAG, "Trying to pause when nothing is resumed",
799                    new RuntimeException("here").fillInStackTrace());
800            mStackSupervisor.resumeTopActivitiesLocked();
801            return;
802        }
803
804        if (mActivityContainer.mParentActivity == null) {
805            // Top level stack, not a child. Look for child stacks.
806            mStackSupervisor.pauseChildStacks(prev, userLeaving, uiSleeping);
807        }
808
809        if (DEBUG_STATES) Slog.v(TAG, "Moving to PAUSING: " + prev);
810        else if (DEBUG_PAUSE) Slog.v(TAG, "Start pausing: " + prev);
811        mResumedActivity = null;
812        mPausingActivity = prev;
813        mLastPausedActivity = prev;
814        mLastNoHistoryActivity = (prev.intent.getFlags() & Intent.FLAG_ACTIVITY_NO_HISTORY) != 0
815                || (prev.info.flags & ActivityInfo.FLAG_NO_HISTORY) != 0 ? prev : null;
816        prev.state = ActivityState.PAUSING;
817        prev.task.touchActiveTime();
818        clearLaunchTime(prev);
819        final ActivityRecord next = mStackSupervisor.topRunningActivityLocked();
820        if (next == null || next.noDisplay || next.task != prev.task) {
821            prev.updateThumbnail(screenshotActivities(prev), null);
822        }
823        stopFullyDrawnTraceIfNeeded();
824
825        mService.updateCpuStats();
826
827        if (prev.app != null && prev.app.thread != null) {
828            if (DEBUG_PAUSE) Slog.v(TAG, "Enqueueing pending pause: " + prev);
829            try {
830                EventLog.writeEvent(EventLogTags.AM_PAUSE_ACTIVITY,
831                        prev.userId, System.identityHashCode(prev),
832                        prev.shortComponentName);
833                mService.updateUsageStats(prev, false);
834                prev.app.thread.schedulePauseActivity(prev.appToken, prev.finishing,
835                        userLeaving, prev.configChangeFlags);
836            } catch (Exception e) {
837                // Ignore exception, if process died other code will cleanup.
838                Slog.w(TAG, "Exception thrown during pause", e);
839                mPausingActivity = null;
840                mLastPausedActivity = null;
841                mLastNoHistoryActivity = null;
842            }
843        } else {
844            mPausingActivity = null;
845            mLastPausedActivity = null;
846            mLastNoHistoryActivity = null;
847        }
848
849        // If we are not going to sleep, we want to ensure the device is
850        // awake until the next activity is started.
851        if (!mService.isSleepingOrShuttingDown()) {
852            mStackSupervisor.acquireLaunchWakelock();
853        }
854
855        if (mPausingActivity != null) {
856            // Have the window manager pause its key dispatching until the new
857            // activity has started.  If we're pausing the activity just because
858            // the screen is being turned off and the UI is sleeping, don't interrupt
859            // key dispatch; the same activity will pick it up again on wakeup.
860            if (!uiSleeping) {
861                prev.pauseKeyDispatchingLocked();
862            } else {
863                if (DEBUG_PAUSE) Slog.v(TAG, "Key dispatch not paused for screen off");
864            }
865
866            // Schedule a pause timeout in case the app doesn't respond.
867            // We don't give it much time because this directly impacts the
868            // responsiveness seen by the user.
869            Message msg = mHandler.obtainMessage(PAUSE_TIMEOUT_MSG);
870            msg.obj = prev;
871            prev.pauseTime = SystemClock.uptimeMillis();
872            mHandler.sendMessageDelayed(msg, PAUSE_TIMEOUT);
873            if (DEBUG_PAUSE) Slog.v(TAG, "Waiting for pause to complete...");
874        } else {
875            // This activity failed to schedule the
876            // pause, so just treat it as being paused now.
877            if (DEBUG_PAUSE) Slog.v(TAG, "Activity not running, resuming next.");
878            mStackSupervisor.getFocusedStack().resumeTopActivityLocked(null);
879        }
880    }
881
882    final void activityPausedLocked(IBinder token, boolean timeout,
883            PersistableBundle persistentState) {
884        if (DEBUG_PAUSE) Slog.v(
885            TAG, "Activity paused: token=" + token + ", timeout=" + timeout);
886
887        final ActivityRecord r = isInStackLocked(token);
888        if (r != null) {
889            mHandler.removeMessages(PAUSE_TIMEOUT_MSG, r);
890            if (persistentState != null) {
891                r.persistentState = persistentState;
892                mService.notifyTaskPersisterLocked(r.task, false);
893            }
894            if (mPausingActivity == r) {
895                if (DEBUG_STATES) Slog.v(TAG, "Moving to PAUSED: " + r
896                        + (timeout ? " (due to timeout)" : " (pause complete)"));
897                r.state = ActivityState.PAUSED;
898                completePauseLocked();
899            } else {
900                EventLog.writeEvent(EventLogTags.AM_FAILED_TO_PAUSE,
901                        r.userId, System.identityHashCode(r), r.shortComponentName,
902                        mPausingActivity != null
903                            ? mPausingActivity.shortComponentName : "(none)");
904            }
905        }
906    }
907
908    final void activityStoppedLocked(ActivityRecord r, Bundle icicle,
909            PersistableBundle persistentState, CharSequence description) {
910        if (r.state != ActivityState.STOPPING) {
911            Slog.i(TAG, "Activity reported stop, but no longer stopping: " + r);
912            mHandler.removeMessages(STOP_TIMEOUT_MSG, r);
913            return;
914        }
915        if (persistentState != null) {
916            r.persistentState = persistentState;
917            mService.notifyTaskPersisterLocked(r.task, false);
918        }
919        if (DEBUG_SAVED_STATE) Slog.i(TAG, "Saving icicle of " + r + ": " + icicle);
920        if (icicle != null) {
921            // If icicle is null, this is happening due to a timeout, so we
922            // haven't really saved the state.
923            r.icicle = icicle;
924            r.haveState = true;
925            r.launchCount = 0;
926            r.updateThumbnail(null, description);
927        }
928        if (!r.stopped) {
929            if (DEBUG_STATES) Slog.v(TAG, "Moving to STOPPED: " + r + " (stop complete)");
930            mHandler.removeMessages(STOP_TIMEOUT_MSG, r);
931            r.stopped = true;
932            r.state = ActivityState.STOPPED;
933            if (r.finishing) {
934                r.clearOptionsLocked();
935            } else {
936                if (r.configDestroy) {
937                    destroyActivityLocked(r, true, false, "stop-config");
938                    mStackSupervisor.resumeTopActivitiesLocked();
939                } else {
940                    mStackSupervisor.updatePreviousProcessLocked(r);
941                }
942            }
943        }
944    }
945
946    private void completePauseLocked() {
947        ActivityRecord prev = mPausingActivity;
948        if (DEBUG_PAUSE) Slog.v(TAG, "Complete pause: " + prev);
949
950        if (prev != null) {
951            if (prev.finishing) {
952                if (DEBUG_PAUSE) Slog.v(TAG, "Executing finish of activity: " + prev);
953                prev = finishCurrentActivityLocked(prev, FINISH_AFTER_VISIBLE, false);
954            } else if (prev.app != null) {
955                if (DEBUG_PAUSE) Slog.v(TAG, "Enqueueing pending stop: " + prev);
956                if (prev.waitingVisible) {
957                    prev.waitingVisible = false;
958                    mStackSupervisor.mWaitingVisibleActivities.remove(prev);
959                    if (DEBUG_SWITCH || DEBUG_PAUSE) Slog.v(
960                            TAG, "Complete pause, no longer waiting: " + prev);
961                }
962                if (prev.configDestroy) {
963                    // The previous is being paused because the configuration
964                    // is changing, which means it is actually stopping...
965                    // To juggle the fact that we are also starting a new
966                    // instance right now, we need to first completely stop
967                    // the current instance before starting the new one.
968                    if (DEBUG_PAUSE) Slog.v(TAG, "Destroying after pause: " + prev);
969                    destroyActivityLocked(prev, true, false, "pause-config");
970                } else {
971                    mStackSupervisor.mStoppingActivities.add(prev);
972                    if (mStackSupervisor.mStoppingActivities.size() > 3 ||
973                            prev.frontOfTask && mTaskHistory.size() <= 1) {
974                        // If we already have a few activities waiting to stop,
975                        // then give up on things going idle and start clearing
976                        // them out. Or if r is the last of activity of the last task the stack
977                        // will be empty and must be cleared immediately.
978                        if (DEBUG_PAUSE) Slog.v(TAG, "To many pending stops, forcing idle");
979                        mStackSupervisor.scheduleIdleLocked();
980                    } else {
981                        mStackSupervisor.checkReadyForSleepLocked();
982                    }
983                }
984            } else {
985                if (DEBUG_PAUSE) Slog.v(TAG, "App died during pause, not stopping: " + prev);
986                prev = null;
987            }
988            mPausingActivity = null;
989        }
990
991        final ActivityStack topStack = mStackSupervisor.getFocusedStack();
992        if (!mService.isSleepingOrShuttingDown()) {
993            mStackSupervisor.resumeTopActivitiesLocked(topStack, prev, null);
994        } else {
995            mStackSupervisor.checkReadyForSleepLocked();
996            ActivityRecord top = topStack.topRunningActivityLocked(null);
997            if (top == null || (prev != null && top != prev)) {
998                // If there are no more activities available to run,
999                // do resume anyway to start something.  Also if the top
1000                // activity on the stack is not the just paused activity,
1001                // we need to go ahead and resume it to ensure we complete
1002                // an in-flight app switch.
1003                mStackSupervisor.resumeTopActivitiesLocked(topStack, null, null);
1004            }
1005        }
1006
1007        if (prev != null) {
1008            prev.resumeKeyDispatchingLocked();
1009
1010            if (prev.app != null && prev.cpuTimeAtResume > 0
1011                    && mService.mBatteryStatsService.isOnBattery()) {
1012                long diff;
1013                synchronized (mService.mProcessCpuThread) {
1014                    diff = mService.mProcessCpuTracker.getCpuTimeForPid(prev.app.pid)
1015                            - prev.cpuTimeAtResume;
1016                }
1017                if (diff > 0) {
1018                    BatteryStatsImpl bsi = mService.mBatteryStatsService.getActiveStatistics();
1019                    synchronized (bsi) {
1020                        BatteryStatsImpl.Uid.Proc ps =
1021                                bsi.getProcessStatsLocked(prev.info.applicationInfo.uid,
1022                                        prev.info.packageName);
1023                        if (ps != null) {
1024                            ps.addForegroundTimeLocked(diff);
1025                        }
1026                    }
1027                }
1028            }
1029            prev.cpuTimeAtResume = 0; // reset it
1030        }
1031    }
1032
1033    /**
1034     * Once we know that we have asked an application to put an activity in
1035     * the resumed state (either by launching it or explicitly telling it),
1036     * this function updates the rest of our state to match that fact.
1037     */
1038    private void completeResumeLocked(ActivityRecord next) {
1039        next.idle = false;
1040        next.results = null;
1041        next.newIntents = null;
1042        if (next.nowVisible) {
1043            // We won't get a call to reportActivityVisibleLocked() so dismiss lockscreen now.
1044            mStackSupervisor.dismissKeyguard();
1045        }
1046
1047        // schedule an idle timeout in case the app doesn't do it for us.
1048        mStackSupervisor.scheduleIdleTimeoutLocked(next);
1049
1050        mStackSupervisor.reportResumedActivityLocked(next);
1051
1052        next.resumeKeyDispatchingLocked();
1053        mNoAnimActivities.clear();
1054
1055        // Mark the point when the activity is resuming
1056        // TODO: To be more accurate, the mark should be before the onCreate,
1057        //       not after the onResume. But for subsequent starts, onResume is fine.
1058        if (next.app != null) {
1059            synchronized (mService.mProcessCpuThread) {
1060                next.cpuTimeAtResume = mService.mProcessCpuTracker.getCpuTimeForPid(next.app.pid);
1061            }
1062        } else {
1063            next.cpuTimeAtResume = 0; // Couldn't get the cpu time of process
1064        }
1065
1066        // If we are resuming the activity that we had last screenshotted, then we know it will be
1067        // updated, so invalidate the last screenshot to ensure we take a fresh one when requested
1068        if (next == mLastScreenshotActivity) {
1069            invalidateLastScreenshot();
1070        }
1071    }
1072
1073    private void setVisibile(ActivityRecord r, boolean visible) {
1074        r.visible = visible;
1075        mWindowManager.setAppVisibility(r.appToken, visible);
1076        final ArrayList<ActivityContainer> containers = r.mChildContainers;
1077        for (int containerNdx = containers.size() - 1; containerNdx >= 0; --containerNdx) {
1078            ActivityContainer container = containers.get(containerNdx);
1079            container.setVisible(visible);
1080        }
1081    }
1082
1083    // Checks if any of the stacks above this one has a fullscreen activity behind it.
1084    // If so, this stack is hidden, otherwise it is visible.
1085    private boolean isStackVisible() {
1086        if (!isAttached()) {
1087            return false;
1088        }
1089
1090        if (mStackSupervisor.isFrontStack(this)) {
1091            return true;
1092        }
1093
1094        /**
1095         * Start at the task above this one and go up, looking for a visible
1096         * fullscreen activity, or a translucent activity that requested the
1097         * wallpaper to be shown behind it.
1098         */
1099        for (int i = mStacks.indexOf(this) + 1; i < mStacks.size(); i++) {
1100            final ArrayList<TaskRecord> tasks = mStacks.get(i).getAllTasks();
1101            for (int taskNdx = 0; taskNdx < tasks.size(); taskNdx++) {
1102                final TaskRecord task = tasks.get(taskNdx);
1103                final ArrayList<ActivityRecord> activities = task.mActivities;
1104                for (int activityNdx = 0; activityNdx < activities.size(); activityNdx++) {
1105                    final ActivityRecord r = activities.get(activityNdx);
1106
1107                    // Conditions for an activity to obscure the stack we're
1108                    // examining:
1109                    // 1. Not Finishing AND Visible AND:
1110                    // 2. Either:
1111                    // - Full Screen Activity OR
1112                    // - On top of Home and our stack is NOT home
1113                    if (!r.finishing && r.visible && (r.fullscreen ||
1114                            (!isHomeStack() && r.frontOfTask && task.isOverHomeStack()))) {
1115                        return false;
1116                    }
1117                }
1118            }
1119        }
1120
1121        return true;
1122    }
1123
1124    final void ensureActivitiesVisibleLocked(ActivityRecord starting, int configChanges) {
1125        ActivityRecord r = topRunningActivityLocked(null);
1126        if (r != null) {
1127            ensureActivitiesVisibleLocked(r, starting, null, configChanges);
1128        }
1129    }
1130
1131    /**
1132     * Make sure that all activities that need to be visible (that is, they
1133     * currently can be seen by the user) actually are.
1134     */
1135    final void ensureActivitiesVisibleLocked(ActivityRecord top, ActivityRecord starting,
1136            String onlyThisProcess, int configChanges) {
1137        if (DEBUG_VISBILITY) Slog.v(
1138                TAG, "ensureActivitiesVisible behind " + top
1139                + " configChanges=0x" + Integer.toHexString(configChanges));
1140
1141        if (mTranslucentActivityWaiting != top) {
1142            mUndrawnActivitiesBelowTopTranslucent.clear();
1143            if (mTranslucentActivityWaiting != null) {
1144                // Call the callback with a timeout indication.
1145                notifyActivityDrawnLocked(null);
1146                mTranslucentActivityWaiting = null;
1147            }
1148            mHandler.removeMessages(TRANSLUCENT_TIMEOUT_MSG);
1149        }
1150
1151        // If the top activity is not fullscreen, then we need to
1152        // make sure any activities under it are now visible.
1153        boolean aboveTop = true;
1154        boolean behindFullscreen = !isStackVisible();
1155
1156        for (int taskNdx = mTaskHistory.size() - 1; taskNdx >= 0; --taskNdx) {
1157            final TaskRecord task = mTaskHistory.get(taskNdx);
1158            final ArrayList<ActivityRecord> activities = task.mActivities;
1159            for (int activityNdx = activities.size() - 1; activityNdx >= 0; --activityNdx) {
1160                final ActivityRecord r = activities.get(activityNdx);
1161                if (r.finishing) {
1162                    continue;
1163                }
1164                if (aboveTop && r != top) {
1165                    continue;
1166                }
1167                aboveTop = false;
1168                if (!behindFullscreen) {
1169                    if (DEBUG_VISBILITY) Slog.v(
1170                            TAG, "Make visible? " + r + " finishing=" + r.finishing
1171                            + " state=" + r.state);
1172
1173                    final boolean doThisProcess = onlyThisProcess == null
1174                            || onlyThisProcess.equals(r.processName);
1175
1176                    // First: if this is not the current activity being started, make
1177                    // sure it matches the current configuration.
1178                    if (r != starting && doThisProcess) {
1179                        ensureActivityConfigurationLocked(r, 0);
1180                    }
1181
1182                    if (r.app == null || r.app.thread == null) {
1183                        if (onlyThisProcess == null || onlyThisProcess.equals(r.processName)) {
1184                            // This activity needs to be visible, but isn't even
1185                            // running...  get it started, but don't resume it
1186                            // at this point.
1187                            if (DEBUG_VISBILITY) Slog.v(TAG, "Start and freeze screen for " + r);
1188                            if (r != starting) {
1189                                r.startFreezingScreenLocked(r.app, configChanges);
1190                            }
1191                            if (!r.visible) {
1192                                if (DEBUG_VISBILITY) Slog.v(
1193                                        TAG, "Starting and making visible: " + r);
1194                                setVisibile(r, true);
1195                            }
1196                            if (r != starting) {
1197                                mStackSupervisor.startSpecificActivityLocked(r, false, false);
1198                            }
1199                        }
1200
1201                    } else if (r.visible) {
1202                        // If this activity is already visible, then there is nothing
1203                        // else to do here.
1204                        if (DEBUG_VISBILITY) Slog.v(TAG, "Skipping: already visible at " + r);
1205                        r.stopFreezingScreenLocked(false);
1206
1207                    } else if (onlyThisProcess == null) {
1208                        // This activity is not currently visible, but is running.
1209                        // Tell it to become visible.
1210                        r.visible = true;
1211                        if (r.state != ActivityState.RESUMED && r != starting) {
1212                            // If this activity is paused, tell it
1213                            // to now show its window.
1214                            if (DEBUG_VISBILITY) Slog.v(
1215                                    TAG, "Making visible and scheduling visibility: " + r);
1216                            try {
1217                                if (mTranslucentActivityWaiting != null) {
1218                                    r.updateOptionsLocked(mReturningActivityOptions);
1219                                    mUndrawnActivitiesBelowTopTranslucent.add(r);
1220                                }
1221                                setVisibile(r, true);
1222                                r.sleeping = false;
1223                                r.app.pendingUiClean = true;
1224                                r.app.thread.scheduleWindowVisibility(r.appToken, true);
1225                                r.stopFreezingScreenLocked(false);
1226                            } catch (Exception e) {
1227                                // Just skip on any failure; we'll make it
1228                                // visible when it next restarts.
1229                                Slog.w(TAG, "Exception thrown making visibile: "
1230                                        + r.intent.getComponent(), e);
1231                            }
1232                        }
1233                    }
1234
1235                    // Aggregate current change flags.
1236                    configChanges |= r.configChangeFlags;
1237
1238                    if (r.fullscreen) {
1239                        // At this point, nothing else needs to be shown
1240                        if (DEBUG_VISBILITY) Slog.v(TAG, "Fullscreen: at " + r);
1241                        behindFullscreen = true;
1242                    } else if (!isHomeStack() && r.frontOfTask && task.isOverHomeStack()) {
1243                        if (DEBUG_VISBILITY) Slog.v(TAG, "Showing home: at " + r);
1244                        behindFullscreen = true;
1245                    }
1246                } else {
1247                    if (DEBUG_VISBILITY) Slog.v(
1248                        TAG, "Make invisible? " + r + " finishing=" + r.finishing
1249                        + " state=" + r.state
1250                        + " behindFullscreen=" + behindFullscreen);
1251                    // Now for any activities that aren't visible to the user, make
1252                    // sure they no longer are keeping the screen frozen.
1253                    if (r.visible) {
1254                        if (DEBUG_VISBILITY) Slog.v(TAG, "Making invisible: " + r);
1255                        try {
1256                            setVisibile(r, false);
1257                            switch (r.state) {
1258                                case STOPPING:
1259                                case STOPPED:
1260                                    if (r.app != null && r.app.thread != null) {
1261                                        if (DEBUG_VISBILITY) Slog.v(
1262                                                TAG, "Scheduling invisibility: " + r);
1263                                        r.app.thread.scheduleWindowVisibility(r.appToken, false);
1264                                    }
1265                                    break;
1266
1267                                case INITIALIZING:
1268                                case RESUMED:
1269                                case PAUSING:
1270                                case PAUSED:
1271                                    // This case created for transitioning activities from
1272                                    // translucent to opaque {@link Activity#convertToOpaque}.
1273                                    if (!mStackSupervisor.mStoppingActivities.contains(r)) {
1274                                        mStackSupervisor.mStoppingActivities.add(r);
1275                                    }
1276                                    mStackSupervisor.scheduleIdleLocked();
1277                                    break;
1278
1279                                default:
1280                                    break;
1281                            }
1282                        } catch (Exception e) {
1283                            // Just skip on any failure; we'll make it
1284                            // visible when it next restarts.
1285                            Slog.w(TAG, "Exception thrown making hidden: "
1286                                    + r.intent.getComponent(), e);
1287                        }
1288                    } else {
1289                        if (DEBUG_VISBILITY) Slog.v(TAG, "Already invisible: " + r);
1290                    }
1291                }
1292            }
1293        }
1294    }
1295
1296    void convertToTranslucent(ActivityRecord r, ActivityOptions options) {
1297        mTranslucentActivityWaiting = r;
1298        mUndrawnActivitiesBelowTopTranslucent.clear();
1299        mReturningActivityOptions = options;
1300        mHandler.sendEmptyMessageDelayed(TRANSLUCENT_TIMEOUT_MSG, TRANSLUCENT_CONVERSION_TIMEOUT);
1301    }
1302
1303    /**
1304     * Called as activities below the top translucent activity are redrawn. When the last one is
1305     * redrawn notify the top activity by calling
1306     * {@link Activity#onTranslucentConversionComplete}.
1307     *
1308     * @param r The most recent background activity to be drawn. Or, if r is null then a timeout
1309     * occurred and the activity will be notified immediately.
1310     */
1311    void notifyActivityDrawnLocked(ActivityRecord r) {
1312        mActivityContainer.setDrawn();
1313        if ((r == null)
1314                || (mUndrawnActivitiesBelowTopTranslucent.remove(r) &&
1315                        mUndrawnActivitiesBelowTopTranslucent.isEmpty())) {
1316            // The last undrawn activity below the top has just been drawn. If there is an
1317            // opaque activity at the top, notify it that it can become translucent safely now.
1318            final ActivityRecord waitingActivity = mTranslucentActivityWaiting;
1319            mTranslucentActivityWaiting = null;
1320            mUndrawnActivitiesBelowTopTranslucent.clear();
1321            mHandler.removeMessages(TRANSLUCENT_TIMEOUT_MSG);
1322
1323            if (waitingActivity != null) {
1324                mWindowManager.setWindowOpaque(waitingActivity.appToken, false);
1325                if (waitingActivity.app != null && waitingActivity.app.thread != null) {
1326                    try {
1327                        waitingActivity.app.thread.scheduleTranslucentConversionComplete(
1328                                waitingActivity.appToken, r != null);
1329                    } catch (RemoteException e) {
1330                    }
1331                }
1332            }
1333        }
1334    }
1335
1336    /** If any activities below the top running one are in the INITIALIZING state and they have a
1337     * starting window displayed then remove that starting window. It is possible that the activity
1338     * in this state will never resumed in which case that starting window will be orphaned. */
1339    void cancelInitializingActivities() {
1340        final ActivityRecord topActivity = topRunningActivityLocked(null);
1341        boolean aboveTop = true;
1342        for (int taskNdx = mTaskHistory.size() - 1; taskNdx >= 0; --taskNdx) {
1343            final ArrayList<ActivityRecord> activities = mTaskHistory.get(taskNdx).mActivities;
1344            for (int activityNdx = activities.size() - 1; activityNdx >= 0; --activityNdx) {
1345                final ActivityRecord r = activities.get(activityNdx);
1346                if (aboveTop) {
1347                    if (r == topActivity) {
1348                        aboveTop = false;
1349                    }
1350                    continue;
1351                }
1352
1353                if (r.state == ActivityState.INITIALIZING && r.mStartingWindowShown) {
1354                    if (DEBUG_VISBILITY) Slog.w(TAG, "Found orphaned starting window " + r);
1355                    r.mStartingWindowShown = false;
1356                    mWindowManager.removeAppStartingWindow(r.appToken);
1357                }
1358            }
1359        }
1360    }
1361
1362    /**
1363     * Ensure that the top activity in the stack is resumed.
1364     *
1365     * @param prev The previously resumed activity, for when in the process
1366     * of pausing; can be null to call from elsewhere.
1367     *
1368     * @return Returns true if something is being resumed, or false if
1369     * nothing happened.
1370     */
1371    final boolean resumeTopActivityLocked(ActivityRecord prev) {
1372        return resumeTopActivityLocked(prev, null);
1373    }
1374
1375    final boolean resumeTopActivityLocked(ActivityRecord prev, Bundle options) {
1376        if (ActivityManagerService.DEBUG_LOCKSCREEN) mService.logLockScreen("");
1377
1378        ActivityRecord parent = mActivityContainer.mParentActivity;
1379        if ((parent != null && parent.state != ActivityState.RESUMED) ||
1380                !mActivityContainer.isAttachedLocked()) {
1381            // Do not resume this stack if its parent is not resumed.
1382            // TODO: If in a loop, make sure that parent stack resumeTopActivity is called 1st.
1383            return false;
1384        }
1385
1386        cancelInitializingActivities();
1387
1388        // Find the first activity that is not finishing.
1389        ActivityRecord next = topRunningActivityLocked(null);
1390
1391        // Remember how we'll process this pause/resume situation, and ensure
1392        // that the state is reset however we wind up proceeding.
1393        final boolean userLeaving = mStackSupervisor.mUserLeaving;
1394        mStackSupervisor.mUserLeaving = false;
1395
1396        final TaskRecord prevTask = prev != null ? prev.task : null;
1397        if (next == null) {
1398            // There are no more activities!  Let's just start up the
1399            // Launcher...
1400            ActivityOptions.abort(options);
1401            if (DEBUG_STATES) Slog.d(TAG, "resumeTopActivityLocked: No more activities go home");
1402            if (DEBUG_STACK) mStackSupervisor.validateTopActivitiesLocked();
1403            // Only resume home if on home display
1404            final int returnTaskType = prevTask == null || !prevTask.isOverHomeStack() ?
1405                    HOME_ACTIVITY_TYPE : prevTask.getTaskToReturnTo();
1406            return isOnHomeDisplay() &&
1407                    mStackSupervisor.resumeHomeStackTask(returnTaskType, prev);
1408        }
1409
1410        next.delayedResume = false;
1411
1412        // If the top activity is the resumed one, nothing to do.
1413        if (mResumedActivity == next && next.state == ActivityState.RESUMED &&
1414                    mStackSupervisor.allResumedActivitiesComplete()) {
1415            // Make sure we have executed any pending transitions, since there
1416            // should be nothing left to do at this point.
1417            mWindowManager.executeAppTransition();
1418            mNoAnimActivities.clear();
1419            ActivityOptions.abort(options);
1420            if (DEBUG_STATES) Slog.d(TAG, "resumeTopActivityLocked: Top activity resumed " + next);
1421            if (DEBUG_STACK) mStackSupervisor.validateTopActivitiesLocked();
1422            return false;
1423        }
1424
1425        final TaskRecord nextTask = next.task;
1426        if (prevTask != null && prevTask.stack == this &&
1427                prevTask.isOverHomeStack() && prev.finishing && prev.frontOfTask) {
1428            if (DEBUG_STACK)  mStackSupervisor.validateTopActivitiesLocked();
1429            if (prevTask == nextTask) {
1430                prevTask.setFrontOfTask();
1431            } else if (prevTask != topTask()) {
1432                // This task is going away but it was supposed to return to the home stack.
1433                // Now the task above it has to return to the home task instead.
1434                final int taskNdx = mTaskHistory.indexOf(prevTask) + 1;
1435                mTaskHistory.get(taskNdx).setTaskToReturnTo(HOME_ACTIVITY_TYPE);
1436            } else {
1437                if (DEBUG_STATES && isOnHomeDisplay()) Slog.d(TAG,
1438                        "resumeTopActivityLocked: Launching home next");
1439                // Only resume home if on home display
1440                final int returnTaskType = prevTask == null || !prevTask.isOverHomeStack() ?
1441                        HOME_ACTIVITY_TYPE : prevTask.getTaskToReturnTo();
1442                return isOnHomeDisplay() &&
1443                        mStackSupervisor.resumeHomeStackTask(returnTaskType, prev);
1444            }
1445        }
1446
1447        // If we are sleeping, and there is no resumed activity, and the top
1448        // activity is paused, well that is the state we want.
1449        if (mService.isSleepingOrShuttingDown()
1450                && mLastPausedActivity == next
1451                && mStackSupervisor.allPausedActivitiesComplete()) {
1452            // Make sure we have executed any pending transitions, since there
1453            // should be nothing left to do at this point.
1454            mWindowManager.executeAppTransition();
1455            mNoAnimActivities.clear();
1456            ActivityOptions.abort(options);
1457            if (DEBUG_STATES) Slog.d(TAG, "resumeTopActivityLocked: Going to sleep and all paused");
1458            if (DEBUG_STACK) mStackSupervisor.validateTopActivitiesLocked();
1459            return false;
1460        }
1461
1462        // Make sure that the user who owns this activity is started.  If not,
1463        // we will just leave it as is because someone should be bringing
1464        // another user's activities to the top of the stack.
1465        if (mService.mStartedUsers.get(next.userId) == null) {
1466            Slog.w(TAG, "Skipping resume of top activity " + next
1467                    + ": user " + next.userId + " is stopped");
1468            if (DEBUG_STACK) mStackSupervisor.validateTopActivitiesLocked();
1469            return false;
1470        }
1471
1472        // The activity may be waiting for stop, but that is no longer
1473        // appropriate for it.
1474        mStackSupervisor.mStoppingActivities.remove(next);
1475        mStackSupervisor.mGoingToSleepActivities.remove(next);
1476        next.sleeping = false;
1477        mStackSupervisor.mWaitingVisibleActivities.remove(next);
1478
1479        if (DEBUG_SWITCH) Slog.v(TAG, "Resuming " + next);
1480
1481        // If we are currently pausing an activity, then don't do anything
1482        // until that is done.
1483        if (!mStackSupervisor.allPausedActivitiesComplete()) {
1484            if (DEBUG_SWITCH || DEBUG_PAUSE || DEBUG_STATES) Slog.v(TAG,
1485                    "resumeTopActivityLocked: Skip resume: some activity pausing.");
1486            if (DEBUG_STACK) mStackSupervisor.validateTopActivitiesLocked();
1487            return false;
1488        }
1489
1490        // Okay we are now going to start a switch, to 'next'.  We may first
1491        // have to pause the current activity, but this is an important point
1492        // where we have decided to go to 'next' so keep track of that.
1493        // XXX "App Redirected" dialog is getting too many false positives
1494        // at this point, so turn off for now.
1495        if (false) {
1496            if (mLastStartedActivity != null && !mLastStartedActivity.finishing) {
1497                long now = SystemClock.uptimeMillis();
1498                final boolean inTime = mLastStartedActivity.startTime != 0
1499                        && (mLastStartedActivity.startTime + START_WARN_TIME) >= now;
1500                final int lastUid = mLastStartedActivity.info.applicationInfo.uid;
1501                final int nextUid = next.info.applicationInfo.uid;
1502                if (inTime && lastUid != nextUid
1503                        && lastUid != next.launchedFromUid
1504                        && mService.checkPermission(
1505                                android.Manifest.permission.STOP_APP_SWITCHES,
1506                                -1, next.launchedFromUid)
1507                        != PackageManager.PERMISSION_GRANTED) {
1508                    mService.showLaunchWarningLocked(mLastStartedActivity, next);
1509                } else {
1510                    next.startTime = now;
1511                    mLastStartedActivity = next;
1512                }
1513            } else {
1514                next.startTime = SystemClock.uptimeMillis();
1515                mLastStartedActivity = next;
1516            }
1517        }
1518
1519        // We need to start pausing the current activity so the top one
1520        // can be resumed...
1521        boolean pausing = mStackSupervisor.pauseBackStacks(userLeaving);
1522        if (mResumedActivity != null) {
1523            pausing = true;
1524            startPausingLocked(userLeaving, false);
1525            if (DEBUG_STATES) Slog.d(TAG, "resumeTopActivityLocked: Pausing " + mResumedActivity);
1526        }
1527        if (pausing) {
1528            if (DEBUG_SWITCH || DEBUG_STATES) Slog.v(TAG,
1529                    "resumeTopActivityLocked: Skip resume: need to start pausing");
1530            // At this point we want to put the upcoming activity's process
1531            // at the top of the LRU list, since we know we will be needing it
1532            // very soon and it would be a waste to let it get killed if it
1533            // happens to be sitting towards the end.
1534            if (next.app != null && next.app.thread != null) {
1535                // No reason to do full oom adj update here; we'll let that
1536                // happen whenever it needs to later.
1537                mService.updateLruProcessLocked(next.app, true, null);
1538            }
1539            if (DEBUG_STACK) mStackSupervisor.validateTopActivitiesLocked();
1540            return true;
1541        }
1542
1543        // If the most recent activity was noHistory but was only stopped rather
1544        // than stopped+finished because the device went to sleep, we need to make
1545        // sure to finish it as we're making a new activity topmost.
1546        if (mService.isSleeping() && mLastNoHistoryActivity != null &&
1547                !mLastNoHistoryActivity.finishing) {
1548            if (DEBUG_STATES) Slog.d(TAG, "no-history finish of " + mLastNoHistoryActivity +
1549                    " on new resume");
1550            requestFinishActivityLocked(mLastNoHistoryActivity.appToken, Activity.RESULT_CANCELED,
1551                    null, "no-history", false);
1552            mLastNoHistoryActivity = null;
1553        }
1554
1555        if (prev != null && prev != next) {
1556            if (!prev.waitingVisible && next != null && !next.nowVisible) {
1557                prev.waitingVisible = true;
1558                mStackSupervisor.mWaitingVisibleActivities.add(prev);
1559                if (DEBUG_SWITCH) Slog.v(
1560                        TAG, "Resuming top, waiting visible to hide: " + prev);
1561            } else {
1562                // The next activity is already visible, so hide the previous
1563                // activity's windows right now so we can show the new one ASAP.
1564                // We only do this if the previous is finishing, which should mean
1565                // it is on top of the one being resumed so hiding it quickly
1566                // is good.  Otherwise, we want to do the normal route of allowing
1567                // the resumed activity to be shown so we can decide if the
1568                // previous should actually be hidden depending on whether the
1569                // new one is found to be full-screen or not.
1570                if (prev.finishing) {
1571                    mWindowManager.setAppVisibility(prev.appToken, false);
1572                    if (DEBUG_SWITCH) Slog.v(TAG, "Not waiting for visible to hide: "
1573                            + prev + ", waitingVisible="
1574                            + (prev != null ? prev.waitingVisible : null)
1575                            + ", nowVisible=" + next.nowVisible);
1576                } else {
1577                    if (DEBUG_SWITCH) Slog.v(TAG, "Previous already visible but still waiting to hide: "
1578                        + prev + ", waitingVisible="
1579                        + (prev != null ? prev.waitingVisible : null)
1580                        + ", nowVisible=" + next.nowVisible);
1581                }
1582            }
1583        }
1584
1585        // Launching this app's activity, make sure the app is no longer
1586        // considered stopped.
1587        try {
1588            AppGlobals.getPackageManager().setPackageStoppedState(
1589                    next.packageName, false, next.userId); /* TODO: Verify if correct userid */
1590        } catch (RemoteException e1) {
1591        } catch (IllegalArgumentException e) {
1592            Slog.w(TAG, "Failed trying to unstop package "
1593                    + next.packageName + ": " + e);
1594        }
1595
1596        // We are starting up the next activity, so tell the window manager
1597        // that the previous one will be hidden soon.  This way it can know
1598        // to ignore it when computing the desired screen orientation.
1599        boolean anim = true;
1600        if (prev != null) {
1601            if (prev.finishing) {
1602                if (DEBUG_TRANSITION) Slog.v(TAG,
1603                        "Prepare close transition: prev=" + prev);
1604                if (mNoAnimActivities.contains(prev)) {
1605                    anim = false;
1606                    mWindowManager.prepareAppTransition(AppTransition.TRANSIT_NONE, false);
1607                } else {
1608                    mWindowManager.prepareAppTransition(prev.task == next.task
1609                            ? AppTransition.TRANSIT_ACTIVITY_CLOSE
1610                            : AppTransition.TRANSIT_TASK_CLOSE, false);
1611                }
1612                mWindowManager.setAppWillBeHidden(prev.appToken);
1613                mWindowManager.setAppVisibility(prev.appToken, false);
1614            } else {
1615                if (DEBUG_TRANSITION) Slog.v(TAG, "Prepare open transition: prev=" + prev);
1616                if (mNoAnimActivities.contains(next)) {
1617                    anim = false;
1618                    mWindowManager.prepareAppTransition(AppTransition.TRANSIT_NONE, false);
1619                } else {
1620                    mWindowManager.prepareAppTransition(prev.task == next.task
1621                            ? AppTransition.TRANSIT_ACTIVITY_OPEN
1622                            : AppTransition.TRANSIT_TASK_OPEN, false);
1623                }
1624            }
1625            if (false) {
1626                mWindowManager.setAppWillBeHidden(prev.appToken);
1627                mWindowManager.setAppVisibility(prev.appToken, false);
1628            }
1629        } else {
1630            if (DEBUG_TRANSITION) Slog.v(TAG, "Prepare open transition: no previous");
1631            if (mNoAnimActivities.contains(next)) {
1632                anim = false;
1633                mWindowManager.prepareAppTransition(AppTransition.TRANSIT_NONE, false);
1634            } else {
1635                mWindowManager.prepareAppTransition(AppTransition.TRANSIT_ACTIVITY_OPEN, false);
1636            }
1637        }
1638
1639        Bundle resumeAnimOptions = null;
1640        if (anim) {
1641            ActivityOptions opts = next.getOptionsForTargetActivityLocked();
1642            if (opts != null) {
1643                resumeAnimOptions = opts.toBundle();
1644            }
1645            next.applyOptionsLocked();
1646        } else {
1647            next.clearOptionsLocked();
1648        }
1649
1650        ActivityStack lastStack = mStackSupervisor.getLastStack();
1651        if (next.app != null && next.app.thread != null) {
1652            if (DEBUG_SWITCH) Slog.v(TAG, "Resume running: " + next);
1653
1654            // This activity is now becoming visible.
1655            mWindowManager.setAppVisibility(next.appToken, true);
1656
1657            // schedule launch ticks to collect information about slow apps.
1658            next.startLaunchTickingLocked();
1659
1660            ActivityRecord lastResumedActivity =
1661                    lastStack == null ? null :lastStack.mResumedActivity;
1662            ActivityState lastState = next.state;
1663
1664            mService.updateCpuStats();
1665
1666            if (DEBUG_STATES) Slog.v(TAG, "Moving to RESUMED: " + next + " (in existing)");
1667            next.state = ActivityState.RESUMED;
1668            mResumedActivity = next;
1669            next.task.touchActiveTime();
1670            mService.addRecentTaskLocked(next.task);
1671            mService.updateLruProcessLocked(next.app, true, null);
1672            updateLRUListLocked(next);
1673            mService.updateOomAdjLocked();
1674
1675            // Have the window manager re-evaluate the orientation of
1676            // the screen based on the new activity order.
1677            boolean notUpdated = true;
1678            if (mStackSupervisor.isFrontStack(this)) {
1679                Configuration config = mWindowManager.updateOrientationFromAppTokens(
1680                        mService.mConfiguration,
1681                        next.mayFreezeScreenLocked(next.app) ? next.appToken : null);
1682                if (config != null) {
1683                    next.frozenBeforeDestroy = true;
1684                }
1685                notUpdated = !mService.updateConfigurationLocked(config, next, false, false);
1686            }
1687
1688            if (notUpdated) {
1689                // The configuration update wasn't able to keep the existing
1690                // instance of the activity, and instead started a new one.
1691                // We should be all done, but let's just make sure our activity
1692                // is still at the top and schedule another run if something
1693                // weird happened.
1694                ActivityRecord nextNext = topRunningActivityLocked(null);
1695                if (DEBUG_SWITCH || DEBUG_STATES) Slog.i(TAG,
1696                        "Activity config changed during resume: " + next
1697                        + ", new next: " + nextNext);
1698                if (nextNext != next) {
1699                    // Do over!
1700                    mStackSupervisor.scheduleResumeTopActivities();
1701                }
1702                if (mStackSupervisor.reportResumedActivityLocked(next)) {
1703                    mNoAnimActivities.clear();
1704                    if (DEBUG_STACK) mStackSupervisor.validateTopActivitiesLocked();
1705                    return true;
1706                }
1707                if (DEBUG_STACK) mStackSupervisor.validateTopActivitiesLocked();
1708                return false;
1709            }
1710
1711            try {
1712                // Deliver all pending results.
1713                ArrayList<ResultInfo> a = next.results;
1714                if (a != null) {
1715                    final int N = a.size();
1716                    if (!next.finishing && N > 0) {
1717                        if (DEBUG_RESULTS) Slog.v(
1718                                TAG, "Delivering results to " + next
1719                                + ": " + a);
1720                        next.app.thread.scheduleSendResult(next.appToken, a);
1721                    }
1722                }
1723
1724                if (next.newIntents != null) {
1725                    next.app.thread.scheduleNewIntent(next.newIntents, next.appToken);
1726                }
1727
1728                EventLog.writeEvent(EventLogTags.AM_RESUME_ACTIVITY,
1729                        next.userId, System.identityHashCode(next),
1730                        next.task.taskId, next.shortComponentName);
1731
1732                next.sleeping = false;
1733                mService.showAskCompatModeDialogLocked(next);
1734                next.app.pendingUiClean = true;
1735                next.app.forceProcessStateUpTo(ActivityManager.PROCESS_STATE_TOP);
1736                next.clearOptionsLocked();
1737                next.app.thread.scheduleResumeActivity(next.appToken, next.app.repProcState,
1738                        mService.isNextTransitionForward(), resumeAnimOptions);
1739
1740                mStackSupervisor.checkReadyForSleepLocked();
1741
1742                if (DEBUG_STATES) Slog.d(TAG, "resumeTopActivityLocked: Resumed " + next);
1743            } catch (Exception e) {
1744                // Whoops, need to restart this activity!
1745                if (DEBUG_STATES) Slog.v(TAG, "Resume failed; resetting state to "
1746                        + lastState + ": " + next);
1747                next.state = lastState;
1748                if (lastStack != null) {
1749                    lastStack.mResumedActivity = lastResumedActivity;
1750                }
1751                Slog.i(TAG, "Restarting because process died: " + next);
1752                if (!next.hasBeenLaunched) {
1753                    next.hasBeenLaunched = true;
1754                } else  if (SHOW_APP_STARTING_PREVIEW && lastStack != null &&
1755                        mStackSupervisor.isFrontStack(lastStack)) {
1756                    mWindowManager.setAppStartingWindow(
1757                            next.appToken, next.packageName, next.theme,
1758                            mService.compatibilityInfoForPackageLocked(next.info.applicationInfo),
1759                            next.nonLocalizedLabel, next.labelRes, next.icon, next.logo,
1760                            next.windowFlags, null, true);
1761                }
1762                mStackSupervisor.startSpecificActivityLocked(next, true, false);
1763                if (DEBUG_STACK) mStackSupervisor.validateTopActivitiesLocked();
1764                return true;
1765            }
1766
1767            // From this point on, if something goes wrong there is no way
1768            // to recover the activity.
1769            try {
1770                next.visible = true;
1771                completeResumeLocked(next);
1772            } catch (Exception e) {
1773                // If any exception gets thrown, toss away this
1774                // activity and try the next one.
1775                Slog.w(TAG, "Exception thrown during resume of " + next, e);
1776                requestFinishActivityLocked(next.appToken, Activity.RESULT_CANCELED, null,
1777                        "resume-exception", true);
1778                if (DEBUG_STACK) mStackSupervisor.validateTopActivitiesLocked();
1779                return true;
1780            }
1781            next.stopped = false;
1782
1783        } else {
1784            // Whoops, need to restart this activity!
1785            if (!next.hasBeenLaunched) {
1786                next.hasBeenLaunched = true;
1787            } else {
1788                if (SHOW_APP_STARTING_PREVIEW) {
1789                    mWindowManager.setAppStartingWindow(
1790                            next.appToken, next.packageName, next.theme,
1791                            mService.compatibilityInfoForPackageLocked(
1792                                    next.info.applicationInfo),
1793                            next.nonLocalizedLabel,
1794                            next.labelRes, next.icon, next.logo, next.windowFlags,
1795                            null, true);
1796                }
1797                if (DEBUG_SWITCH) Slog.v(TAG, "Restarting: " + next);
1798            }
1799            if (DEBUG_STATES) Slog.d(TAG, "resumeTopActivityLocked: Restarting " + next);
1800            mStackSupervisor.startSpecificActivityLocked(next, true, true);
1801        }
1802
1803        if (DEBUG_STACK) mStackSupervisor.validateTopActivitiesLocked();
1804        return true;
1805    }
1806
1807    private void insertTaskAtTop(TaskRecord task) {
1808        // If this is being moved to the top by another activity or being launched from the home
1809        // activity, set mOnTopOfHome accordingly.
1810        if (isOnHomeDisplay()) {
1811            ActivityStack lastStack = mStackSupervisor.getLastStack();
1812            final boolean fromHome = lastStack.isHomeStack();
1813            if (!isHomeStack() && (fromHome || topTask() != task)) {
1814                task.setTaskToReturnTo(fromHome ?
1815                        lastStack.topTask().taskType : APPLICATION_ACTIVITY_TYPE);
1816            }
1817        } else {
1818            task.setTaskToReturnTo(APPLICATION_ACTIVITY_TYPE);
1819        }
1820
1821        mTaskHistory.remove(task);
1822        // Now put task at top.
1823        int stackNdx = mTaskHistory.size();
1824        if (!isCurrentProfileLocked(task.userId)) {
1825            // Put non-current user tasks below current user tasks.
1826            while (--stackNdx >= 0) {
1827                if (!isCurrentProfileLocked(mTaskHistory.get(stackNdx).userId)) {
1828                    break;
1829                }
1830            }
1831            ++stackNdx;
1832        }
1833        mTaskHistory.add(stackNdx, task);
1834        updateTaskMovement(task, true);
1835    }
1836
1837    final void startActivityLocked(ActivityRecord r, boolean newTask,
1838            boolean doResume, boolean keepCurTransition, Bundle options) {
1839        TaskRecord rTask = r.task;
1840        final int taskId = rTask.taskId;
1841        if (taskForIdLocked(taskId) == null || newTask) {
1842            // Last activity in task had been removed or ActivityManagerService is reusing task.
1843            // Insert or replace.
1844            // Might not even be in.
1845            insertTaskAtTop(rTask);
1846            mWindowManager.moveTaskToTop(taskId);
1847        }
1848        TaskRecord task = null;
1849        if (!newTask) {
1850            // If starting in an existing task, find where that is...
1851            boolean startIt = true;
1852            for (int taskNdx = mTaskHistory.size() - 1; taskNdx >= 0; --taskNdx) {
1853                task = mTaskHistory.get(taskNdx);
1854                if (task == r.task) {
1855                    // Here it is!  Now, if this is not yet visible to the
1856                    // user, then just add it without starting; it will
1857                    // get started when the user navigates back to it.
1858                    if (!startIt) {
1859                        if (DEBUG_ADD_REMOVE) Slog.i(TAG, "Adding activity " + r + " to task "
1860                                + task, new RuntimeException("here").fillInStackTrace());
1861                        task.addActivityToTop(r);
1862                        r.putInHistory();
1863                        mWindowManager.addAppToken(task.mActivities.indexOf(r), r.appToken,
1864                                r.task.taskId, mStackId, r.info.screenOrientation, r.fullscreen,
1865                                (r.info.flags & ActivityInfo.FLAG_SHOW_ON_LOCK_SCREEN) != 0,
1866                                r.userId, r.info.configChanges, task.voiceSession != null);
1867                        if (VALIDATE_TOKENS) {
1868                            validateAppTokensLocked();
1869                        }
1870                        ActivityOptions.abort(options);
1871                        return;
1872                    }
1873                    break;
1874                } else if (task.numFullscreen > 0) {
1875                    startIt = false;
1876                }
1877            }
1878        }
1879
1880        // Place a new activity at top of stack, so it is next to interact
1881        // with the user.
1882
1883        // If we are not placing the new activity frontmost, we do not want
1884        // to deliver the onUserLeaving callback to the actual frontmost
1885        // activity
1886        if (task == r.task && mTaskHistory.indexOf(task) != (mTaskHistory.size() - 1)) {
1887            mStackSupervisor.mUserLeaving = false;
1888            if (DEBUG_USER_LEAVING) Slog.v(TAG,
1889                    "startActivity() behind front, mUserLeaving=false");
1890        }
1891
1892        task = r.task;
1893
1894        // Slot the activity into the history stack and proceed
1895        if (DEBUG_ADD_REMOVE) Slog.i(TAG, "Adding activity " + r + " to stack to task " + task,
1896                new RuntimeException("here").fillInStackTrace());
1897        task.addActivityToTop(r);
1898        task.setFrontOfTask();
1899
1900        r.putInHistory();
1901        if (!isHomeStack() || numActivities() > 0) {
1902            // We want to show the starting preview window if we are
1903            // switching to a new task, or the next activity's process is
1904            // not currently running.
1905            boolean showStartingIcon = newTask;
1906            ProcessRecord proc = r.app;
1907            if (proc == null) {
1908                proc = mService.mProcessNames.get(r.processName, r.info.applicationInfo.uid);
1909            }
1910            if (proc == null || proc.thread == null) {
1911                showStartingIcon = true;
1912            }
1913            if (DEBUG_TRANSITION) Slog.v(TAG,
1914                    "Prepare open transition: starting " + r);
1915            if ((r.intent.getFlags()&Intent.FLAG_ACTIVITY_NO_ANIMATION) != 0) {
1916                mWindowManager.prepareAppTransition(AppTransition.TRANSIT_NONE, keepCurTransition);
1917                mNoAnimActivities.add(r);
1918            } else {
1919                mWindowManager.prepareAppTransition(newTask
1920                        ? AppTransition.TRANSIT_TASK_OPEN
1921                        : AppTransition.TRANSIT_ACTIVITY_OPEN, keepCurTransition);
1922                mNoAnimActivities.remove(r);
1923            }
1924            mWindowManager.addAppToken(task.mActivities.indexOf(r),
1925                    r.appToken, r.task.taskId, mStackId, r.info.screenOrientation, r.fullscreen,
1926                    (r.info.flags & ActivityInfo.FLAG_SHOW_ON_LOCK_SCREEN) != 0, r.userId,
1927                    r.info.configChanges, task.voiceSession != null);
1928            boolean doShow = true;
1929            if (newTask) {
1930                // Even though this activity is starting fresh, we still need
1931                // to reset it to make sure we apply affinities to move any
1932                // existing activities from other tasks in to it.
1933                // If the caller has requested that the target task be
1934                // reset, then do so.
1935                if ((r.intent.getFlags() & Intent.FLAG_ACTIVITY_RESET_TASK_IF_NEEDED) != 0) {
1936                    resetTaskIfNeededLocked(r, r);
1937                    doShow = topRunningNonDelayedActivityLocked(null) == r;
1938                }
1939            }
1940            if (SHOW_APP_STARTING_PREVIEW && doShow) {
1941                // Figure out if we are transitioning from another activity that is
1942                // "has the same starting icon" as the next one.  This allows the
1943                // window manager to keep the previous window it had previously
1944                // created, if it still had one.
1945                ActivityRecord prev = mResumedActivity;
1946                if (prev != null) {
1947                    // We don't want to reuse the previous starting preview if:
1948                    // (1) The current activity is in a different task.
1949                    if (prev.task != r.task) {
1950                        prev = null;
1951                    }
1952                    // (2) The current activity is already displayed.
1953                    else if (prev.nowVisible) {
1954                        prev = null;
1955                    }
1956                }
1957                mWindowManager.setAppStartingWindow(
1958                        r.appToken, r.packageName, r.theme,
1959                        mService.compatibilityInfoForPackageLocked(
1960                                r.info.applicationInfo), r.nonLocalizedLabel,
1961                        r.labelRes, r.icon, r.logo, r.windowFlags,
1962                        prev != null ? prev.appToken : null, showStartingIcon);
1963                r.mStartingWindowShown = true;
1964            }
1965        } else {
1966            // If this is the first activity, don't do any fancy animations,
1967            // because there is nothing for it to animate on top of.
1968            mWindowManager.addAppToken(task.mActivities.indexOf(r), r.appToken,
1969                    r.task.taskId, mStackId, r.info.screenOrientation, r.fullscreen,
1970                    (r.info.flags & ActivityInfo.FLAG_SHOW_ON_LOCK_SCREEN) != 0, r.userId,
1971                    r.info.configChanges, task.voiceSession != null);
1972            ActivityOptions.abort(options);
1973            options = null;
1974        }
1975        if (VALIDATE_TOKENS) {
1976            validateAppTokensLocked();
1977        }
1978
1979        if (doResume) {
1980            mStackSupervisor.resumeTopActivitiesLocked(this, r, options);
1981        }
1982    }
1983
1984    final void validateAppTokensLocked() {
1985        mValidateAppTokens.clear();
1986        mValidateAppTokens.ensureCapacity(numActivities());
1987        final int numTasks = mTaskHistory.size();
1988        for (int taskNdx = 0; taskNdx < numTasks; ++taskNdx) {
1989            TaskRecord task = mTaskHistory.get(taskNdx);
1990            final ArrayList<ActivityRecord> activities = task.mActivities;
1991            if (activities.isEmpty()) {
1992                continue;
1993            }
1994            TaskGroup group = new TaskGroup();
1995            group.taskId = task.taskId;
1996            mValidateAppTokens.add(group);
1997            final int numActivities = activities.size();
1998            for (int activityNdx = 0; activityNdx < numActivities; ++activityNdx) {
1999                final ActivityRecord r = activities.get(activityNdx);
2000                group.tokens.add(r.appToken);
2001            }
2002        }
2003        mWindowManager.validateAppTokens(mStackId, mValidateAppTokens);
2004    }
2005
2006    /**
2007     * Perform a reset of the given task, if needed as part of launching it.
2008     * Returns the new HistoryRecord at the top of the task.
2009     */
2010    /**
2011     * Helper method for #resetTaskIfNeededLocked.
2012     * We are inside of the task being reset...  we'll either finish this activity, push it out
2013     * for another task, or leave it as-is.
2014     * @param task The task containing the Activity (taskTop) that might be reset.
2015     * @param forceReset
2016     * @return An ActivityOptions that needs to be processed.
2017     */
2018    final ActivityOptions resetTargetTaskIfNeededLocked(TaskRecord task, boolean forceReset) {
2019        ActivityOptions topOptions = null;
2020
2021        int replyChainEnd = -1;
2022        boolean canMoveOptions = true;
2023
2024        // We only do this for activities that are not the root of the task (since if we finish
2025        // the root, we may no longer have the task!).
2026        final ArrayList<ActivityRecord> activities = task.mActivities;
2027        final int numActivities = activities.size();
2028        final int rootActivityNdx = task.findEffectiveRootIndex();
2029        for (int i = numActivities - 1; i > rootActivityNdx; --i ) {
2030            ActivityRecord target = activities.get(i);
2031
2032            final int flags = target.info.flags;
2033            final boolean finishOnTaskLaunch =
2034                    (flags & ActivityInfo.FLAG_FINISH_ON_TASK_LAUNCH) != 0;
2035            final boolean allowTaskReparenting =
2036                    (flags & ActivityInfo.FLAG_ALLOW_TASK_REPARENTING) != 0;
2037            final boolean clearWhenTaskReset =
2038                    (target.intent.getFlags() & Intent.FLAG_ACTIVITY_CLEAR_WHEN_TASK_RESET) != 0;
2039
2040            if (!finishOnTaskLaunch
2041                    && !clearWhenTaskReset
2042                    && target.resultTo != null) {
2043                // If this activity is sending a reply to a previous
2044                // activity, we can't do anything with it now until
2045                // we reach the start of the reply chain.
2046                // XXX note that we are assuming the result is always
2047                // to the previous activity, which is almost always
2048                // the case but we really shouldn't count on.
2049                if (replyChainEnd < 0) {
2050                    replyChainEnd = i;
2051                }
2052            } else if (!finishOnTaskLaunch
2053                    && !clearWhenTaskReset
2054                    && allowTaskReparenting
2055                    && target.taskAffinity != null
2056                    && !target.taskAffinity.equals(task.affinity)) {
2057                // If this activity has an affinity for another
2058                // task, then we need to move it out of here.  We will
2059                // move it as far out of the way as possible, to the
2060                // bottom of the activity stack.  This also keeps it
2061                // correctly ordered with any activities we previously
2062                // moved.
2063                final ThumbnailHolder newThumbHolder;
2064                final TaskRecord targetTask;
2065                final ActivityRecord bottom =
2066                        !mTaskHistory.isEmpty() && !mTaskHistory.get(0).mActivities.isEmpty() ?
2067                                mTaskHistory.get(0).mActivities.get(0) : null;
2068                if (bottom != null && target.taskAffinity != null
2069                        && target.taskAffinity.equals(bottom.task.affinity)) {
2070                    // If the activity currently at the bottom has the
2071                    // same task affinity as the one we are moving,
2072                    // then merge it into the same task.
2073                    targetTask = bottom.task;
2074                    newThumbHolder = bottom.thumbHolder == null ? targetTask : bottom.thumbHolder;
2075                    if (DEBUG_TASKS) Slog.v(TAG, "Start pushing activity " + target
2076                            + " out to bottom task " + bottom.task);
2077                } else {
2078                    targetTask = createTaskRecord(mStackSupervisor.getNextTaskId(), target.info,
2079                            null, null, null, false);
2080                    newThumbHolder = targetTask;
2081                    targetTask.affinityIntent = target.intent;
2082                    if (DEBUG_TASKS) Slog.v(TAG, "Start pushing activity " + target
2083                            + " out to new task " + target.task);
2084                }
2085
2086                target.thumbHolder = newThumbHolder;
2087
2088                final int targetTaskId = targetTask.taskId;
2089                mWindowManager.setAppGroupId(target.appToken, targetTaskId);
2090
2091                boolean noOptions = canMoveOptions;
2092                final int start = replyChainEnd < 0 ? i : replyChainEnd;
2093                for (int srcPos = start; srcPos >= i; --srcPos) {
2094                    final ActivityRecord p = activities.get(srcPos);
2095                    if (p.finishing) {
2096                        continue;
2097                    }
2098
2099                    ThumbnailHolder curThumbHolder = p.thumbHolder;
2100                    canMoveOptions = false;
2101                    if (noOptions && topOptions == null) {
2102                        topOptions = p.takeOptionsLocked();
2103                        if (topOptions != null) {
2104                            noOptions = false;
2105                        }
2106                    }
2107                    if (DEBUG_ADD_REMOVE) Slog.i(TAG, "Removing activity " + p + " from task="
2108                            + task + " adding to task=" + targetTask
2109                            + " Callers=" + Debug.getCallers(4));
2110                    if (DEBUG_TASKS) Slog.v(TAG, "Pushing next activity " + p
2111                            + " out to target's task " + target.task);
2112                    p.setTask(targetTask, curThumbHolder, false);
2113                    targetTask.addActivityAtBottom(p);
2114
2115                    mWindowManager.setAppGroupId(p.appToken, targetTaskId);
2116                }
2117
2118                mWindowManager.moveTaskToBottom(targetTaskId);
2119                if (VALIDATE_TOKENS) {
2120                    validateAppTokensLocked();
2121                }
2122
2123                replyChainEnd = -1;
2124            } else if (forceReset || finishOnTaskLaunch || clearWhenTaskReset) {
2125                // If the activity should just be removed -- either
2126                // because it asks for it, or the task should be
2127                // cleared -- then finish it and anything that is
2128                // part of its reply chain.
2129                int end;
2130                if (clearWhenTaskReset) {
2131                    // In this case, we want to finish this activity
2132                    // and everything above it, so be sneaky and pretend
2133                    // like these are all in the reply chain.
2134                    end = numActivities - 1;
2135                } else if (replyChainEnd < 0) {
2136                    end = i;
2137                } else {
2138                    end = replyChainEnd;
2139                }
2140                boolean noOptions = canMoveOptions;
2141                for (int srcPos = i; srcPos <= end; srcPos++) {
2142                    ActivityRecord p = activities.get(srcPos);
2143                    if (p.finishing) {
2144                        continue;
2145                    }
2146                    canMoveOptions = false;
2147                    if (noOptions && topOptions == null) {
2148                        topOptions = p.takeOptionsLocked();
2149                        if (topOptions != null) {
2150                            noOptions = false;
2151                        }
2152                    }
2153                    if (DEBUG_TASKS) Slog.w(TAG,
2154                            "resetTaskIntendedTask: calling finishActivity on " + p);
2155                    if (finishActivityLocked(p, Activity.RESULT_CANCELED, null, "reset", false)) {
2156                        end--;
2157                        srcPos--;
2158                    }
2159                }
2160                replyChainEnd = -1;
2161            } else {
2162                // If we were in the middle of a chain, well the
2163                // activity that started it all doesn't want anything
2164                // special, so leave it all as-is.
2165                replyChainEnd = -1;
2166            }
2167        }
2168
2169        return topOptions;
2170    }
2171
2172    /**
2173     * Helper method for #resetTaskIfNeededLocked. Processes all of the activities in a given
2174     * TaskRecord looking for an affinity with the task of resetTaskIfNeededLocked.taskTop.
2175     * @param affinityTask The task we are looking for an affinity to.
2176     * @param task Task that resetTaskIfNeededLocked.taskTop belongs to.
2177     * @param topTaskIsHigher True if #task has already been processed by resetTaskIfNeededLocked.
2178     * @param forceReset Flag passed in to resetTaskIfNeededLocked.
2179     */
2180    private int resetAffinityTaskIfNeededLocked(TaskRecord affinityTask, TaskRecord task,
2181            boolean topTaskIsHigher, boolean forceReset, int taskInsertionPoint) {
2182        int replyChainEnd = -1;
2183        final int taskId = task.taskId;
2184        final String taskAffinity = task.affinity;
2185
2186        final ArrayList<ActivityRecord> activities = affinityTask.mActivities;
2187        final int numActivities = activities.size();
2188        final int rootActivityNdx = affinityTask.findEffectiveRootIndex();
2189
2190        // Do not operate on or below the effective root Activity.
2191        for (int i = numActivities - 1; i > rootActivityNdx; --i) {
2192            ActivityRecord target = activities.get(i);
2193
2194            final int flags = target.info.flags;
2195            boolean finishOnTaskLaunch = (flags & ActivityInfo.FLAG_FINISH_ON_TASK_LAUNCH) != 0;
2196            boolean allowTaskReparenting = (flags & ActivityInfo.FLAG_ALLOW_TASK_REPARENTING) != 0;
2197
2198            if (target.resultTo != null) {
2199                // If this activity is sending a reply to a previous
2200                // activity, we can't do anything with it now until
2201                // we reach the start of the reply chain.
2202                // XXX note that we are assuming the result is always
2203                // to the previous activity, which is almost always
2204                // the case but we really shouldn't count on.
2205                if (replyChainEnd < 0) {
2206                    replyChainEnd = i;
2207                }
2208            } else if (topTaskIsHigher
2209                    && allowTaskReparenting
2210                    && taskAffinity != null
2211                    && taskAffinity.equals(target.taskAffinity)) {
2212                // This activity has an affinity for our task. Either remove it if we are
2213                // clearing or move it over to our task.  Note that
2214                // we currently punt on the case where we are resetting a
2215                // task that is not at the top but who has activities above
2216                // with an affinity to it...  this is really not a normal
2217                // case, and we will need to later pull that task to the front
2218                // and usually at that point we will do the reset and pick
2219                // up those remaining activities.  (This only happens if
2220                // someone starts an activity in a new task from an activity
2221                // in a task that is not currently on top.)
2222                if (forceReset || finishOnTaskLaunch) {
2223                    final int start = replyChainEnd >= 0 ? replyChainEnd : i;
2224                    if (DEBUG_TASKS) Slog.v(TAG, "Finishing task at index " + start + " to " + i);
2225                    for (int srcPos = start; srcPos >= i; --srcPos) {
2226                        final ActivityRecord p = activities.get(srcPos);
2227                        if (p.finishing) {
2228                            continue;
2229                        }
2230                        finishActivityLocked(p, Activity.RESULT_CANCELED, null, "reset", false);
2231                    }
2232                } else {
2233                    if (taskInsertionPoint < 0) {
2234                        taskInsertionPoint = task.mActivities.size();
2235
2236                    }
2237
2238                    final int start = replyChainEnd >= 0 ? replyChainEnd : i;
2239                    if (DEBUG_TASKS) Slog.v(TAG, "Reparenting from task=" + affinityTask + ":"
2240                            + start + "-" + i + " to task=" + task + ":" + taskInsertionPoint);
2241                    for (int srcPos = start; srcPos >= i; --srcPos) {
2242                        final ActivityRecord p = activities.get(srcPos);
2243                        p.setTask(task, null, false);
2244                        task.addActivityAtIndex(taskInsertionPoint, p);
2245
2246                        if (DEBUG_ADD_REMOVE) Slog.i(TAG, "Removing and adding activity " + p
2247                                + " to stack at " + task,
2248                                new RuntimeException("here").fillInStackTrace());
2249                        if (DEBUG_TASKS) Slog.v(TAG, "Pulling activity " + p + " from " + srcPos
2250                                + " in to resetting task " + task);
2251                        mWindowManager.setAppGroupId(p.appToken, taskId);
2252                    }
2253                    mWindowManager.moveTaskToTop(taskId);
2254                    if (VALIDATE_TOKENS) {
2255                        validateAppTokensLocked();
2256                    }
2257
2258                    // Now we've moved it in to place...  but what if this is
2259                    // a singleTop activity and we have put it on top of another
2260                    // instance of the same activity?  Then we drop the instance
2261                    // below so it remains singleTop.
2262                    if (target.info.launchMode == ActivityInfo.LAUNCH_SINGLE_TOP) {
2263                        ArrayList<ActivityRecord> taskActivities = task.mActivities;
2264                        int targetNdx = taskActivities.indexOf(target);
2265                        if (targetNdx > 0) {
2266                            ActivityRecord p = taskActivities.get(targetNdx - 1);
2267                            if (p.intent.getComponent().equals(target.intent.getComponent())) {
2268                                finishActivityLocked(p, Activity.RESULT_CANCELED, null, "replace",
2269                                        false);
2270                            }
2271                        }
2272                    }
2273                }
2274
2275                replyChainEnd = -1;
2276            }
2277        }
2278        return taskInsertionPoint;
2279    }
2280
2281    final ActivityRecord resetTaskIfNeededLocked(ActivityRecord taskTop,
2282            ActivityRecord newActivity) {
2283        boolean forceReset =
2284                (newActivity.info.flags & ActivityInfo.FLAG_CLEAR_TASK_ON_LAUNCH) != 0;
2285        if (ACTIVITY_INACTIVE_RESET_TIME > 0
2286                && taskTop.task.getInactiveDuration() > ACTIVITY_INACTIVE_RESET_TIME) {
2287            if ((newActivity.info.flags & ActivityInfo.FLAG_ALWAYS_RETAIN_TASK_STATE) == 0) {
2288                forceReset = true;
2289            }
2290        }
2291
2292        final TaskRecord task = taskTop.task;
2293
2294        /** False until we evaluate the TaskRecord associated with taskTop. Switches to true
2295         * for remaining tasks. Used for later tasks to reparent to task. */
2296        boolean taskFound = false;
2297
2298        /** If ActivityOptions are moved out and need to be aborted or moved to taskTop. */
2299        ActivityOptions topOptions = null;
2300
2301        // Preserve the location for reparenting in the new task.
2302        int reparentInsertionPoint = -1;
2303
2304        for (int i = mTaskHistory.size() - 1; i >= 0; --i) {
2305            final TaskRecord targetTask = mTaskHistory.get(i);
2306
2307            if (targetTask == task) {
2308                topOptions = resetTargetTaskIfNeededLocked(task, forceReset);
2309                taskFound = true;
2310            } else {
2311                reparentInsertionPoint = resetAffinityTaskIfNeededLocked(targetTask, task,
2312                        taskFound, forceReset, reparentInsertionPoint);
2313            }
2314        }
2315
2316        int taskNdx = mTaskHistory.indexOf(task);
2317        do {
2318            taskTop = mTaskHistory.get(taskNdx--).getTopActivity();
2319        } while (taskTop == null && taskNdx >= 0);
2320
2321        if (topOptions != null) {
2322            // If we got some ActivityOptions from an activity on top that
2323            // was removed from the task, propagate them to the new real top.
2324            if (taskTop != null) {
2325                taskTop.updateOptionsLocked(topOptions);
2326            } else {
2327                topOptions.abort();
2328            }
2329        }
2330
2331        return taskTop;
2332    }
2333
2334    void sendActivityResultLocked(int callingUid, ActivityRecord r,
2335            String resultWho, int requestCode, int resultCode, Intent data) {
2336
2337        if (callingUid > 0) {
2338            mService.grantUriPermissionFromIntentLocked(callingUid, r.packageName,
2339                    data, r.getUriPermissionsLocked(), r.userId);
2340        }
2341
2342        if (DEBUG_RESULTS) Slog.v(TAG, "Send activity result to " + r
2343                + " : who=" + resultWho + " req=" + requestCode
2344                + " res=" + resultCode + " data=" + data);
2345        if (mResumedActivity == r && r.app != null && r.app.thread != null) {
2346            try {
2347                ArrayList<ResultInfo> list = new ArrayList<ResultInfo>();
2348                list.add(new ResultInfo(resultWho, requestCode,
2349                        resultCode, data));
2350                r.app.thread.scheduleSendResult(r.appToken, list);
2351                return;
2352            } catch (Exception e) {
2353                Slog.w(TAG, "Exception thrown sending result to " + r, e);
2354            }
2355        }
2356
2357        r.addResultLocked(null, resultWho, requestCode, resultCode, data);
2358    }
2359
2360    private void adjustFocusedActivityLocked(ActivityRecord r) {
2361        if (mStackSupervisor.isFrontStack(this) && mService.mFocusedActivity == r) {
2362            ActivityRecord next = topRunningActivityLocked(null);
2363            if (next != r) {
2364                final TaskRecord task = r.task;
2365                if (r.frontOfTask && task == topTask() && task.isOverHomeStack()) {
2366                    mStackSupervisor.moveHomeStackTaskToTop(task.getTaskToReturnTo());
2367                }
2368            }
2369            ActivityRecord top = mStackSupervisor.topRunningActivityLocked();
2370            if (top != null) {
2371                mService.setFocusedActivityLocked(top);
2372            }
2373        }
2374    }
2375
2376    final void stopActivityLocked(ActivityRecord r) {
2377        if (DEBUG_SWITCH) Slog.d(TAG, "Stopping: " + r);
2378        if ((r.intent.getFlags()&Intent.FLAG_ACTIVITY_NO_HISTORY) != 0
2379                || (r.info.flags&ActivityInfo.FLAG_NO_HISTORY) != 0) {
2380            if (!r.finishing) {
2381                if (!mService.isSleeping()) {
2382                    if (DEBUG_STATES) {
2383                        Slog.d(TAG, "no-history finish of " + r);
2384                    }
2385                    requestFinishActivityLocked(r.appToken, Activity.RESULT_CANCELED, null,
2386                            "no-history", false);
2387                } else {
2388                    if (DEBUG_STATES) Slog.d(TAG, "Not finishing noHistory " + r
2389                            + " on stop because we're just sleeping");
2390                }
2391            }
2392        }
2393
2394        if (r.app != null && r.app.thread != null) {
2395            adjustFocusedActivityLocked(r);
2396            r.resumeKeyDispatchingLocked();
2397            try {
2398                r.stopped = false;
2399                if (DEBUG_STATES) Slog.v(TAG, "Moving to STOPPING: " + r
2400                        + " (stop requested)");
2401                r.state = ActivityState.STOPPING;
2402                if (DEBUG_VISBILITY) Slog.v(
2403                        TAG, "Stopping visible=" + r.visible + " for " + r);
2404                if (!r.visible) {
2405                    mWindowManager.setAppVisibility(r.appToken, false);
2406                }
2407                r.app.thread.scheduleStopActivity(r.appToken, r.visible, r.configChangeFlags);
2408                if (mService.isSleepingOrShuttingDown()) {
2409                    r.setSleeping(true);
2410                }
2411                Message msg = mHandler.obtainMessage(STOP_TIMEOUT_MSG, r);
2412                mHandler.sendMessageDelayed(msg, STOP_TIMEOUT);
2413            } catch (Exception e) {
2414                // Maybe just ignore exceptions here...  if the process
2415                // has crashed, our death notification will clean things
2416                // up.
2417                Slog.w(TAG, "Exception thrown during pause", e);
2418                // Just in case, assume it to be stopped.
2419                r.stopped = true;
2420                if (DEBUG_STATES) Slog.v(TAG, "Stop failed; moving to STOPPED: " + r);
2421                r.state = ActivityState.STOPPED;
2422                if (r.configDestroy) {
2423                    destroyActivityLocked(r, true, false, "stop-except");
2424                }
2425            }
2426        }
2427    }
2428
2429    /**
2430     * @return Returns true if the activity is being finished, false if for
2431     * some reason it is being left as-is.
2432     */
2433    final boolean requestFinishActivityLocked(IBinder token, int resultCode,
2434            Intent resultData, String reason, boolean oomAdj) {
2435        ActivityRecord r = isInStackLocked(token);
2436        if (DEBUG_RESULTS || DEBUG_STATES) Slog.v(
2437                TAG, "Finishing activity token=" + token + " r="
2438                + ", result=" + resultCode + ", data=" + resultData
2439                + ", reason=" + reason);
2440        if (r == null) {
2441            return false;
2442        }
2443
2444        finishActivityLocked(r, resultCode, resultData, reason, oomAdj);
2445        return true;
2446    }
2447
2448    final void finishSubActivityLocked(ActivityRecord self, String resultWho, int requestCode) {
2449        for (int taskNdx = mTaskHistory.size() - 1; taskNdx >= 0; --taskNdx) {
2450            ArrayList<ActivityRecord> activities = mTaskHistory.get(taskNdx).mActivities;
2451            for (int activityNdx = activities.size() - 1; activityNdx >= 0; --activityNdx) {
2452                ActivityRecord r = activities.get(activityNdx);
2453                if (r.resultTo == self && r.requestCode == requestCode) {
2454                    if ((r.resultWho == null && resultWho == null) ||
2455                        (r.resultWho != null && r.resultWho.equals(resultWho))) {
2456                        finishActivityLocked(r, Activity.RESULT_CANCELED, null, "request-sub",
2457                                false);
2458                    }
2459                }
2460            }
2461        }
2462        mService.updateOomAdjLocked();
2463    }
2464
2465    final void finishTopRunningActivityLocked(ProcessRecord app) {
2466        ActivityRecord r = topRunningActivityLocked(null);
2467        if (r != null && r.app == app) {
2468            // If the top running activity is from this crashing
2469            // process, then terminate it to avoid getting in a loop.
2470            Slog.w(TAG, "  Force finishing activity "
2471                    + r.intent.getComponent().flattenToShortString());
2472            int taskNdx = mTaskHistory.indexOf(r.task);
2473            int activityNdx = r.task.mActivities.indexOf(r);
2474            finishActivityLocked(r, Activity.RESULT_CANCELED, null, "crashed", false);
2475            // Also terminate any activities below it that aren't yet
2476            // stopped, to avoid a situation where one will get
2477            // re-start our crashing activity once it gets resumed again.
2478            --activityNdx;
2479            if (activityNdx < 0) {
2480                do {
2481                    --taskNdx;
2482                    if (taskNdx < 0) {
2483                        break;
2484                    }
2485                    activityNdx = mTaskHistory.get(taskNdx).mActivities.size() - 1;
2486                } while (activityNdx < 0);
2487            }
2488            if (activityNdx >= 0) {
2489                r = mTaskHistory.get(taskNdx).mActivities.get(activityNdx);
2490                if (r.state == ActivityState.RESUMED
2491                        || r.state == ActivityState.PAUSING
2492                        || r.state == ActivityState.PAUSED) {
2493                    if (!r.isHomeActivity() || mService.mHomeProcess != r.app) {
2494                        Slog.w(TAG, "  Force finishing activity "
2495                                + r.intent.getComponent().flattenToShortString());
2496                        finishActivityLocked(r, Activity.RESULT_CANCELED, null, "crashed", false);
2497                    }
2498                }
2499            }
2500        }
2501    }
2502
2503    final boolean finishActivityAffinityLocked(ActivityRecord r) {
2504        ArrayList<ActivityRecord> activities = r.task.mActivities;
2505        for (int index = activities.indexOf(r); index >= 0; --index) {
2506            ActivityRecord cur = activities.get(index);
2507            if (!Objects.equals(cur.taskAffinity, r.taskAffinity)) {
2508                break;
2509            }
2510            finishActivityLocked(cur, Activity.RESULT_CANCELED, null, "request-affinity", true);
2511        }
2512        return true;
2513    }
2514
2515    final void finishActivityResultsLocked(ActivityRecord r, int resultCode, Intent resultData) {
2516        // send the result
2517        ActivityRecord resultTo = r.resultTo;
2518        if (resultTo != null) {
2519            if (DEBUG_RESULTS) Slog.v(TAG, "Adding result to " + resultTo
2520                    + " who=" + r.resultWho + " req=" + r.requestCode
2521                    + " res=" + resultCode + " data=" + resultData);
2522            if (resultTo.userId != r.userId) {
2523                if (resultData != null) {
2524                    resultData.prepareToLeaveUser(r.userId);
2525                }
2526            }
2527            if (r.info.applicationInfo.uid > 0) {
2528                mService.grantUriPermissionFromIntentLocked(r.info.applicationInfo.uid,
2529                        resultTo.packageName, resultData,
2530                        resultTo.getUriPermissionsLocked(), resultTo.userId);
2531            }
2532            resultTo.addResultLocked(r, r.resultWho, r.requestCode, resultCode,
2533                                     resultData);
2534            r.resultTo = null;
2535        }
2536        else if (DEBUG_RESULTS) Slog.v(TAG, "No result destination from " + r);
2537
2538        // Make sure this HistoryRecord is not holding on to other resources,
2539        // because clients have remote IPC references to this object so we
2540        // can't assume that will go away and want to avoid circular IPC refs.
2541        r.results = null;
2542        r.pendingResults = null;
2543        r.newIntents = null;
2544        r.icicle = null;
2545    }
2546
2547    /**
2548     * @return Returns true if this activity has been removed from the history
2549     * list, or false if it is still in the list and will be removed later.
2550     */
2551    final boolean finishActivityLocked(ActivityRecord r, int resultCode, Intent resultData,
2552            String reason, boolean oomAdj) {
2553        if (r.finishing) {
2554            Slog.w(TAG, "Duplicate finish request for " + r);
2555            return false;
2556        }
2557
2558        r.makeFinishing();
2559        final TaskRecord task = r.task;
2560        EventLog.writeEvent(EventLogTags.AM_FINISH_ACTIVITY,
2561                r.userId, System.identityHashCode(r),
2562                task.taskId, r.shortComponentName, reason);
2563        final ArrayList<ActivityRecord> activities = task.mActivities;
2564        final int index = activities.indexOf(r);
2565        if (index < (activities.size() - 1)) {
2566            task.setFrontOfTask();
2567            if ((r.intent.getFlags() & Intent.FLAG_ACTIVITY_CLEAR_WHEN_TASK_RESET) != 0) {
2568                // If the caller asked that this activity (and all above it)
2569                // be cleared when the task is reset, don't lose that information,
2570                // but propagate it up to the next activity.
2571                ActivityRecord next = activities.get(index+1);
2572                next.intent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_WHEN_TASK_RESET);
2573            }
2574        }
2575
2576        r.pauseKeyDispatchingLocked();
2577
2578        adjustFocusedActivityLocked(r);
2579
2580        finishActivityResultsLocked(r, resultCode, resultData);
2581
2582        if (mResumedActivity == r) {
2583            boolean endTask = index <= 0;
2584            if (DEBUG_VISBILITY || DEBUG_TRANSITION) Slog.v(TAG,
2585                    "Prepare close transition: finishing " + r);
2586            mWindowManager.prepareAppTransition(endTask
2587                    ? AppTransition.TRANSIT_TASK_CLOSE
2588                    : AppTransition.TRANSIT_ACTIVITY_CLOSE, false);
2589
2590            // Tell window manager to prepare for this one to be removed.
2591            mWindowManager.setAppVisibility(r.appToken, false);
2592
2593            if (mPausingActivity == null) {
2594                if (DEBUG_PAUSE) Slog.v(TAG, "Finish needs to pause: " + r);
2595                if (DEBUG_USER_LEAVING) Slog.v(TAG, "finish() => pause with userLeaving=false");
2596                startPausingLocked(false, false);
2597            }
2598
2599            if (endTask) {
2600                mStackSupervisor.endLockTaskModeIfTaskEnding(task);
2601            }
2602        } else if (r.state != ActivityState.PAUSING) {
2603            // If the activity is PAUSING, we will complete the finish once
2604            // it is done pausing; else we can just directly finish it here.
2605            if (DEBUG_PAUSE) Slog.v(TAG, "Finish not pausing: " + r);
2606            return finishCurrentActivityLocked(r, FINISH_AFTER_PAUSE, oomAdj) == null;
2607        } else {
2608            if (DEBUG_PAUSE) Slog.v(TAG, "Finish waiting for pause of: " + r);
2609        }
2610
2611        return false;
2612    }
2613
2614    static final int FINISH_IMMEDIATELY = 0;
2615    static final int FINISH_AFTER_PAUSE = 1;
2616    static final int FINISH_AFTER_VISIBLE = 2;
2617
2618    final ActivityRecord finishCurrentActivityLocked(ActivityRecord r, int mode, boolean oomAdj) {
2619        // First things first: if this activity is currently visible,
2620        // and the resumed activity is not yet visible, then hold off on
2621        // finishing until the resumed one becomes visible.
2622        if (mode == FINISH_AFTER_VISIBLE && r.nowVisible) {
2623            if (!mStackSupervisor.mStoppingActivities.contains(r)) {
2624                mStackSupervisor.mStoppingActivities.add(r);
2625                if (mStackSupervisor.mStoppingActivities.size() > 3
2626                        || r.frontOfTask && mTaskHistory.size() <= 1) {
2627                    // If we already have a few activities waiting to stop,
2628                    // then give up on things going idle and start clearing
2629                    // them out. Or if r is the last of activity of the last task the stack
2630                    // will be empty and must be cleared immediately.
2631                    mStackSupervisor.scheduleIdleLocked();
2632                } else {
2633                    mStackSupervisor.checkReadyForSleepLocked();
2634                }
2635            }
2636            if (DEBUG_STATES) Slog.v(TAG, "Moving to STOPPING: " + r
2637                    + " (finish requested)");
2638            r.state = ActivityState.STOPPING;
2639            if (oomAdj) {
2640                mService.updateOomAdjLocked();
2641            }
2642            return r;
2643        }
2644
2645        // make sure the record is cleaned out of other places.
2646        mStackSupervisor.mStoppingActivities.remove(r);
2647        mStackSupervisor.mGoingToSleepActivities.remove(r);
2648        mStackSupervisor.mWaitingVisibleActivities.remove(r);
2649        if (mResumedActivity == r) {
2650            mResumedActivity = null;
2651        }
2652        final ActivityState prevState = r.state;
2653        if (DEBUG_STATES) Slog.v(TAG, "Moving to FINISHING: " + r);
2654        r.state = ActivityState.FINISHING;
2655
2656        if (mode == FINISH_IMMEDIATELY
2657                || prevState == ActivityState.STOPPED
2658                || prevState == ActivityState.INITIALIZING) {
2659            // If this activity is already stopped, we can just finish
2660            // it right now.
2661            r.makeFinishing();
2662            boolean activityRemoved = destroyActivityLocked(r, true, oomAdj, "finish-imm");
2663            if (activityRemoved) {
2664                mStackSupervisor.resumeTopActivitiesLocked();
2665            }
2666            if (DEBUG_CONTAINERS) Slog.d(TAG,
2667                    "destroyActivityLocked: finishCurrentActivityLocked r=" + r +
2668                    " destroy returned removed=" + activityRemoved);
2669            return activityRemoved ? null : r;
2670        }
2671
2672        // Need to go through the full pause cycle to get this
2673        // activity into the stopped state and then finish it.
2674        if (localLOGV) Slog.v(TAG, "Enqueueing pending finish: " + r);
2675        mStackSupervisor.mFinishingActivities.add(r);
2676        r.resumeKeyDispatchingLocked();
2677        mStackSupervisor.getFocusedStack().resumeTopActivityLocked(null);
2678        return r;
2679    }
2680
2681    void finishAllActivitiesLocked() {
2682        for (int taskNdx = mTaskHistory.size() - 1; taskNdx >= 0; --taskNdx) {
2683            final ArrayList<ActivityRecord> activities = mTaskHistory.get(taskNdx).mActivities;
2684            for (int activityNdx = activities.size() - 1; activityNdx >= 0; --activityNdx) {
2685                final ActivityRecord r = activities.get(activityNdx);
2686                if (r.finishing) {
2687                    continue;
2688                }
2689                Slog.d(TAG, "finishAllActivitiesLocked: finishing " + r);
2690                finishCurrentActivityLocked(r, FINISH_IMMEDIATELY, false);
2691            }
2692        }
2693    }
2694
2695    final boolean navigateUpToLocked(IBinder token, Intent destIntent, int resultCode,
2696            Intent resultData) {
2697        final ActivityRecord srec = ActivityRecord.forToken(token);
2698        final TaskRecord task = srec.task;
2699        final ArrayList<ActivityRecord> activities = task.mActivities;
2700        final int start = activities.indexOf(srec);
2701        if (!mTaskHistory.contains(task) || (start < 0)) {
2702            return false;
2703        }
2704        int finishTo = start - 1;
2705        ActivityRecord parent = finishTo < 0 ? null : activities.get(finishTo);
2706        boolean foundParentInTask = false;
2707        final ComponentName dest = destIntent.getComponent();
2708        if (start > 0 && dest != null) {
2709            for (int i = finishTo; i >= 0; i--) {
2710                ActivityRecord r = activities.get(i);
2711                if (r.info.packageName.equals(dest.getPackageName()) &&
2712                        r.info.name.equals(dest.getClassName())) {
2713                    finishTo = i;
2714                    parent = r;
2715                    foundParentInTask = true;
2716                    break;
2717                }
2718            }
2719        }
2720
2721        IActivityController controller = mService.mController;
2722        if (controller != null) {
2723            ActivityRecord next = topRunningActivityLocked(srec.appToken, 0);
2724            if (next != null) {
2725                // ask watcher if this is allowed
2726                boolean resumeOK = true;
2727                try {
2728                    resumeOK = controller.activityResuming(next.packageName);
2729                } catch (RemoteException e) {
2730                    mService.mController = null;
2731                    Watchdog.getInstance().setActivityController(null);
2732                }
2733
2734                if (!resumeOK) {
2735                    return false;
2736                }
2737            }
2738        }
2739        final long origId = Binder.clearCallingIdentity();
2740        for (int i = start; i > finishTo; i--) {
2741            ActivityRecord r = activities.get(i);
2742            requestFinishActivityLocked(r.appToken, resultCode, resultData, "navigate-up", true);
2743            // Only return the supplied result for the first activity finished
2744            resultCode = Activity.RESULT_CANCELED;
2745            resultData = null;
2746        }
2747
2748        if (parent != null && foundParentInTask) {
2749            final int parentLaunchMode = parent.info.launchMode;
2750            final int destIntentFlags = destIntent.getFlags();
2751            if (parentLaunchMode == ActivityInfo.LAUNCH_SINGLE_INSTANCE ||
2752                    parentLaunchMode == ActivityInfo.LAUNCH_SINGLE_TASK ||
2753                    parentLaunchMode == ActivityInfo.LAUNCH_SINGLE_TOP ||
2754                    (destIntentFlags & Intent.FLAG_ACTIVITY_CLEAR_TOP) != 0) {
2755                parent.deliverNewIntentLocked(srec.info.applicationInfo.uid, destIntent);
2756            } else {
2757                try {
2758                    ActivityInfo aInfo = AppGlobals.getPackageManager().getActivityInfo(
2759                            destIntent.getComponent(), 0, srec.userId);
2760                    int res = mStackSupervisor.startActivityLocked(srec.app.thread, destIntent,
2761                            null, aInfo, null, null, parent.appToken, null,
2762                            0, -1, parent.launchedFromUid, parent.launchedFromPackage,
2763                            0, null, true, null, null);
2764                    foundParentInTask = res == ActivityManager.START_SUCCESS;
2765                } catch (RemoteException e) {
2766                    foundParentInTask = false;
2767                }
2768                requestFinishActivityLocked(parent.appToken, resultCode,
2769                        resultData, "navigate-up", true);
2770            }
2771        }
2772        Binder.restoreCallingIdentity(origId);
2773        return foundParentInTask;
2774    }
2775    /**
2776     * Perform the common clean-up of an activity record.  This is called both
2777     * as part of destroyActivityLocked() (when destroying the client-side
2778     * representation) and cleaning things up as a result of its hosting
2779     * processing going away, in which case there is no remaining client-side
2780     * state to destroy so only the cleanup here is needed.
2781     */
2782    final void cleanUpActivityLocked(ActivityRecord r, boolean cleanServices,
2783            boolean setState) {
2784        if (mResumedActivity == r) {
2785            mResumedActivity = null;
2786        }
2787        if (mPausingActivity == r) {
2788            mPausingActivity = null;
2789        }
2790        mService.clearFocusedActivity(r);
2791
2792        r.configDestroy = false;
2793        r.frozenBeforeDestroy = false;
2794
2795        if (setState) {
2796            if (DEBUG_STATES) Slog.v(TAG, "Moving to DESTROYED: " + r + " (cleaning up)");
2797            r.state = ActivityState.DESTROYED;
2798            if (DEBUG_APP) Slog.v(TAG, "Clearing app during cleanUp for activity " + r);
2799            r.app = null;
2800        }
2801
2802        // Make sure this record is no longer in the pending finishes list.
2803        // This could happen, for example, if we are trimming activities
2804        // down to the max limit while they are still waiting to finish.
2805        mStackSupervisor.mFinishingActivities.remove(r);
2806        mStackSupervisor.mWaitingVisibleActivities.remove(r);
2807
2808        // Remove any pending results.
2809        if (r.finishing && r.pendingResults != null) {
2810            for (WeakReference<PendingIntentRecord> apr : r.pendingResults) {
2811                PendingIntentRecord rec = apr.get();
2812                if (rec != null) {
2813                    mService.cancelIntentSenderLocked(rec, false);
2814                }
2815            }
2816            r.pendingResults = null;
2817        }
2818
2819        if (cleanServices) {
2820            cleanUpActivityServicesLocked(r);
2821        }
2822
2823        // Get rid of any pending idle timeouts.
2824        removeTimeoutsForActivityLocked(r);
2825    }
2826
2827    private void removeTimeoutsForActivityLocked(ActivityRecord r) {
2828        mStackSupervisor.removeTimeoutsForActivityLocked(r);
2829        mHandler.removeMessages(PAUSE_TIMEOUT_MSG, r);
2830        mHandler.removeMessages(STOP_TIMEOUT_MSG, r);
2831        mHandler.removeMessages(DESTROY_TIMEOUT_MSG, r);
2832        r.finishLaunchTickingLocked();
2833    }
2834
2835    private void removeActivityFromHistoryLocked(ActivityRecord r) {
2836        mStackSupervisor.removeChildActivityContainers(r);
2837        finishActivityResultsLocked(r, Activity.RESULT_CANCELED, null);
2838        r.makeFinishing();
2839        if (DEBUG_ADD_REMOVE) {
2840            RuntimeException here = new RuntimeException("here");
2841            here.fillInStackTrace();
2842            Slog.i(TAG, "Removing activity " + r + " from stack");
2843        }
2844        r.takeFromHistory();
2845        removeTimeoutsForActivityLocked(r);
2846        if (DEBUG_STATES) Slog.v(TAG, "Moving to DESTROYED: " + r + " (removed from history)");
2847        r.state = ActivityState.DESTROYED;
2848        if (DEBUG_APP) Slog.v(TAG, "Clearing app during remove for activity " + r);
2849        r.app = null;
2850        mWindowManager.removeAppToken(r.appToken);
2851        if (VALIDATE_TOKENS) {
2852            validateAppTokensLocked();
2853        }
2854        final TaskRecord task = r.task;
2855        if (task != null && task.removeActivity(r)) {
2856            if (DEBUG_STACK) Slog.i(TAG,
2857                    "removeActivityFromHistoryLocked: last activity removed from " + this);
2858            if (mStackSupervisor.isFrontStack(this) && task == topTask() &&
2859                    task.isOverHomeStack()) {
2860                mStackSupervisor.moveHomeStackTaskToTop(task.getTaskToReturnTo());
2861            }
2862            removeTask(task);
2863        }
2864        cleanUpActivityServicesLocked(r);
2865        r.removeUriPermissionsLocked();
2866    }
2867
2868    /**
2869     * Perform clean-up of service connections in an activity record.
2870     */
2871    final void cleanUpActivityServicesLocked(ActivityRecord r) {
2872        // Throw away any services that have been bound by this activity.
2873        if (r.connections != null) {
2874            Iterator<ConnectionRecord> it = r.connections.iterator();
2875            while (it.hasNext()) {
2876                ConnectionRecord c = it.next();
2877                mService.mServices.removeConnectionLocked(c, null, r);
2878            }
2879            r.connections = null;
2880        }
2881    }
2882
2883    final void scheduleDestroyActivities(ProcessRecord owner, boolean oomAdj, String reason) {
2884        Message msg = mHandler.obtainMessage(DESTROY_ACTIVITIES_MSG);
2885        msg.obj = new ScheduleDestroyArgs(owner, oomAdj, reason);
2886        mHandler.sendMessage(msg);
2887    }
2888
2889    final void destroyActivitiesLocked(ProcessRecord owner, boolean oomAdj, String reason) {
2890        boolean lastIsOpaque = false;
2891        boolean activityRemoved = false;
2892        for (int taskNdx = mTaskHistory.size() - 1; taskNdx >= 0; --taskNdx) {
2893            final ArrayList<ActivityRecord> activities = mTaskHistory.get(taskNdx).mActivities;
2894            for (int activityNdx = activities.size() - 1; activityNdx >= 0; --activityNdx) {
2895                final ActivityRecord r = activities.get(activityNdx);
2896                if (r.finishing) {
2897                    continue;
2898                }
2899                if (r.fullscreen) {
2900                    lastIsOpaque = true;
2901                }
2902                if (owner != null && r.app != owner) {
2903                    continue;
2904                }
2905                if (!lastIsOpaque) {
2906                    continue;
2907                }
2908                // We can destroy this one if we have its icicle saved and
2909                // it is not in the process of pausing/stopping/finishing.
2910                if (r.app != null && r != mResumedActivity && r != mPausingActivity
2911                        && r.haveState && !r.visible && r.stopped
2912                        && r.state != ActivityState.DESTROYING
2913                        && r.state != ActivityState.DESTROYED) {
2914                    if (DEBUG_SWITCH) Slog.v(TAG, "Destroying " + r + " in state " + r.state
2915                            + " resumed=" + mResumedActivity
2916                            + " pausing=" + mPausingActivity);
2917                    if (destroyActivityLocked(r, true, oomAdj, reason)) {
2918                        activityRemoved = true;
2919                    }
2920                }
2921            }
2922        }
2923        if (activityRemoved) {
2924            mStackSupervisor.resumeTopActivitiesLocked();
2925        }
2926    }
2927
2928    /**
2929     * Destroy the current CLIENT SIDE instance of an activity.  This may be
2930     * called both when actually finishing an activity, or when performing
2931     * a configuration switch where we destroy the current client-side object
2932     * but then create a new client-side object for this same HistoryRecord.
2933     */
2934    final boolean destroyActivityLocked(ActivityRecord r,
2935            boolean removeFromApp, boolean oomAdj, String reason) {
2936        if (DEBUG_SWITCH || DEBUG_CLEANUP) Slog.v(
2937            TAG, "Removing activity from " + reason + ": token=" + r
2938              + ", app=" + (r.app != null ? r.app.processName : "(null)"));
2939        EventLog.writeEvent(EventLogTags.AM_DESTROY_ACTIVITY,
2940                r.userId, System.identityHashCode(r),
2941                r.task.taskId, r.shortComponentName, reason);
2942
2943        boolean removedFromHistory = false;
2944
2945        cleanUpActivityLocked(r, false, false);
2946
2947        final boolean hadApp = r.app != null;
2948
2949        if (hadApp) {
2950            if (removeFromApp) {
2951                r.app.activities.remove(r);
2952                if (mService.mHeavyWeightProcess == r.app && r.app.activities.size() <= 0) {
2953                    mService.mHeavyWeightProcess = null;
2954                    mService.mHandler.sendEmptyMessage(
2955                            ActivityManagerService.CANCEL_HEAVY_NOTIFICATION_MSG);
2956                }
2957                if (r.app.activities.isEmpty()) {
2958                    // No longer have activities, so update LRU list and oom adj.
2959                    mService.updateLruProcessLocked(r.app, false, null);
2960                    mService.updateOomAdjLocked();
2961                }
2962            }
2963
2964            boolean skipDestroy = false;
2965
2966            try {
2967                if (DEBUG_SWITCH) Slog.i(TAG, "Destroying: " + r);
2968                r.app.thread.scheduleDestroyActivity(r.appToken, r.finishing,
2969                        r.configChangeFlags);
2970            } catch (Exception e) {
2971                // We can just ignore exceptions here...  if the process
2972                // has crashed, our death notification will clean things
2973                // up.
2974                //Slog.w(TAG, "Exception thrown during finish", e);
2975                if (r.finishing) {
2976                    removeActivityFromHistoryLocked(r);
2977                    removedFromHistory = true;
2978                    skipDestroy = true;
2979                }
2980            }
2981
2982            r.nowVisible = false;
2983
2984            // If the activity is finishing, we need to wait on removing it
2985            // from the list to give it a chance to do its cleanup.  During
2986            // that time it may make calls back with its token so we need to
2987            // be able to find it on the list and so we don't want to remove
2988            // it from the list yet.  Otherwise, we can just immediately put
2989            // it in the destroyed state since we are not removing it from the
2990            // list.
2991            if (r.finishing && !skipDestroy) {
2992                if (DEBUG_STATES) Slog.v(TAG, "Moving to DESTROYING: " + r
2993                        + " (destroy requested)");
2994                r.state = ActivityState.DESTROYING;
2995                Message msg = mHandler.obtainMessage(DESTROY_TIMEOUT_MSG, r);
2996                mHandler.sendMessageDelayed(msg, DESTROY_TIMEOUT);
2997            } else {
2998                if (DEBUG_STATES) Slog.v(TAG, "Moving to DESTROYED: " + r + " (destroy skipped)");
2999                r.state = ActivityState.DESTROYED;
3000                if (DEBUG_APP) Slog.v(TAG, "Clearing app during destroy for activity " + r);
3001                r.app = null;
3002            }
3003        } else {
3004            // remove this record from the history.
3005            if (r.finishing) {
3006                removeActivityFromHistoryLocked(r);
3007                removedFromHistory = true;
3008            } else {
3009                if (DEBUG_STATES) Slog.v(TAG, "Moving to DESTROYED: " + r + " (no app)");
3010                r.state = ActivityState.DESTROYED;
3011                if (DEBUG_APP) Slog.v(TAG, "Clearing app during destroy for activity " + r);
3012                r.app = null;
3013            }
3014        }
3015
3016        r.configChangeFlags = 0;
3017
3018        if (!mLRUActivities.remove(r) && hadApp) {
3019            Slog.w(TAG, "Activity " + r + " being finished, but not in LRU list");
3020        }
3021
3022        return removedFromHistory;
3023    }
3024
3025    final void activityDestroyedLocked(IBinder token) {
3026        final long origId = Binder.clearCallingIdentity();
3027        try {
3028            ActivityRecord r = ActivityRecord.forToken(token);
3029            if (r != null) {
3030                mHandler.removeMessages(DESTROY_TIMEOUT_MSG, r);
3031            }
3032            if (DEBUG_CONTAINERS) Slog.d(TAG, "activityDestroyedLocked: r=" + r);
3033
3034            if (isInStackLocked(token) != null) {
3035                if (r.state == ActivityState.DESTROYING) {
3036                    cleanUpActivityLocked(r, true, false);
3037                    removeActivityFromHistoryLocked(r);
3038                }
3039            }
3040            mStackSupervisor.resumeTopActivitiesLocked();
3041        } finally {
3042            Binder.restoreCallingIdentity(origId);
3043        }
3044    }
3045
3046    private void removeHistoryRecordsForAppLocked(ArrayList<ActivityRecord> list,
3047            ProcessRecord app, String listName) {
3048        int i = list.size();
3049        if (DEBUG_CLEANUP) Slog.v(
3050            TAG, "Removing app " + app + " from list " + listName
3051            + " with " + i + " entries");
3052        while (i > 0) {
3053            i--;
3054            ActivityRecord r = list.get(i);
3055            if (DEBUG_CLEANUP) Slog.v(TAG, "Record #" + i + " " + r);
3056            if (r.app == app) {
3057                if (DEBUG_CLEANUP) Slog.v(TAG, "---> REMOVING this entry!");
3058                list.remove(i);
3059                removeTimeoutsForActivityLocked(r);
3060            }
3061        }
3062    }
3063
3064    boolean removeHistoryRecordsForAppLocked(ProcessRecord app) {
3065        removeHistoryRecordsForAppLocked(mLRUActivities, app, "mLRUActivities");
3066        removeHistoryRecordsForAppLocked(mStackSupervisor.mStoppingActivities, app,
3067                "mStoppingActivities");
3068        removeHistoryRecordsForAppLocked(mStackSupervisor.mGoingToSleepActivities, app,
3069                "mGoingToSleepActivities");
3070        removeHistoryRecordsForAppLocked(mStackSupervisor.mWaitingVisibleActivities, app,
3071                "mWaitingVisibleActivities");
3072        removeHistoryRecordsForAppLocked(mStackSupervisor.mFinishingActivities, app,
3073                "mFinishingActivities");
3074
3075        boolean hasVisibleActivities = false;
3076
3077        // Clean out the history list.
3078        int i = numActivities();
3079        if (DEBUG_CLEANUP) Slog.v(
3080            TAG, "Removing app " + app + " from history with " + i + " entries");
3081        for (int taskNdx = mTaskHistory.size() - 1; taskNdx >= 0; --taskNdx) {
3082            final ArrayList<ActivityRecord> activities = mTaskHistory.get(taskNdx).mActivities;
3083            for (int activityNdx = activities.size() - 1; activityNdx >= 0; --activityNdx) {
3084                final ActivityRecord r = activities.get(activityNdx);
3085                --i;
3086                if (DEBUG_CLEANUP) Slog.v(
3087                    TAG, "Record #" + i + " " + r + ": app=" + r.app);
3088                if (r.app == app) {
3089                    boolean remove;
3090                    if ((!r.haveState && !r.stateNotNeeded) || r.finishing) {
3091                        // Don't currently have state for the activity, or
3092                        // it is finishing -- always remove it.
3093                        remove = true;
3094                    } else if (r.launchCount > 2 &&
3095                            r.lastLaunchTime > (SystemClock.uptimeMillis()-60000)) {
3096                        // We have launched this activity too many times since it was
3097                        // able to run, so give up and remove it.
3098                        remove = true;
3099                    } else {
3100                        // The process may be gone, but the activity lives on!
3101                        remove = false;
3102                    }
3103                    if (remove) {
3104                        if (DEBUG_ADD_REMOVE || DEBUG_CLEANUP) {
3105                            RuntimeException here = new RuntimeException("here");
3106                            here.fillInStackTrace();
3107                            Slog.i(TAG, "Removing activity " + r + " from stack at " + i
3108                                    + ": haveState=" + r.haveState
3109                                    + " stateNotNeeded=" + r.stateNotNeeded
3110                                    + " finishing=" + r.finishing
3111                                    + " state=" + r.state, here);
3112                        }
3113                        if (!r.finishing) {
3114                            Slog.w(TAG, "Force removing " + r + ": app died, no saved state");
3115                            EventLog.writeEvent(EventLogTags.AM_FINISH_ACTIVITY,
3116                                    r.userId, System.identityHashCode(r),
3117                                    r.task.taskId, r.shortComponentName,
3118                                    "proc died without state saved");
3119                            if (r.state == ActivityState.RESUMED) {
3120                                mService.updateUsageStats(r, false);
3121                            }
3122                        }
3123                        removeActivityFromHistoryLocked(r);
3124
3125                    } else {
3126                        // We have the current state for this activity, so
3127                        // it can be restarted later when needed.
3128                        if (localLOGV) Slog.v(
3129                            TAG, "Keeping entry, setting app to null");
3130                        if (r.visible) {
3131                            hasVisibleActivities = true;
3132                        }
3133                        if (DEBUG_APP) Slog.v(TAG, "Clearing app during removeHistory for activity "
3134                                + r);
3135                        r.app = null;
3136                        r.nowVisible = false;
3137                        if (!r.haveState) {
3138                            if (DEBUG_SAVED_STATE) Slog.i(TAG,
3139                                    "App died, clearing saved state of " + r);
3140                            r.icicle = null;
3141                        }
3142                    }
3143
3144                    cleanUpActivityLocked(r, true, true);
3145                }
3146            }
3147        }
3148
3149        return hasVisibleActivities;
3150    }
3151
3152    final void updateTransitLocked(int transit, Bundle options) {
3153        if (options != null) {
3154            ActivityRecord r = topRunningActivityLocked(null);
3155            if (r != null && r.state != ActivityState.RESUMED) {
3156                r.updateOptionsLocked(options);
3157            } else {
3158                ActivityOptions.abort(options);
3159            }
3160        }
3161        mWindowManager.prepareAppTransition(transit, false);
3162    }
3163
3164    void updateTaskMovement(TaskRecord task, boolean toFront) {
3165        if (task.isPersistable) {
3166            task.mLastTimeMoved = System.currentTimeMillis();
3167            // Sign is used to keep tasks sorted when persisted. Tasks sent to the bottom most
3168            // recently will be most negative, tasks sent to the bottom before that will be less
3169            // negative. Similarly for recent tasks moved to the top which will be most positive.
3170            if (!toFront) {
3171                task.mLastTimeMoved *= -1;
3172            }
3173        }
3174    }
3175
3176    void moveHomeStackTaskToTop(int homeStackTaskType) {
3177        final int top = mTaskHistory.size() - 1;
3178        for (int taskNdx = top; taskNdx >= 0; --taskNdx) {
3179            final TaskRecord task = mTaskHistory.get(taskNdx);
3180            if (task.taskType == homeStackTaskType) {
3181                if (DEBUG_TASKS || DEBUG_STACK)
3182                    Slog.d(TAG, "moveHomeStackTaskToTop: moving " + task);
3183                mTaskHistory.remove(taskNdx);
3184                mTaskHistory.add(top, task);
3185                updateTaskMovement(task, true);
3186                mWindowManager.moveTaskToTop(task.taskId);
3187                return;
3188            }
3189        }
3190    }
3191
3192    final void moveTaskToFrontLocked(TaskRecord tr, ActivityRecord reason, Bundle options) {
3193        if (DEBUG_SWITCH) Slog.v(TAG, "moveTaskToFront: " + tr);
3194
3195        final int numTasks = mTaskHistory.size();
3196        final int index = mTaskHistory.indexOf(tr);
3197        if (numTasks == 0 || index < 0)  {
3198            // nothing to do!
3199            if (reason != null &&
3200                    (reason.intent.getFlags()&Intent.FLAG_ACTIVITY_NO_ANIMATION) != 0) {
3201                ActivityOptions.abort(options);
3202            } else {
3203                updateTransitLocked(AppTransition.TRANSIT_TASK_TO_FRONT, options);
3204            }
3205            return;
3206        }
3207
3208        moveToFront();
3209
3210        // Shift all activities with this task up to the top
3211        // of the stack, keeping them in the same internal order.
3212        insertTaskAtTop(tr);
3213
3214        if (DEBUG_TRANSITION) Slog.v(TAG, "Prepare to front transition: task=" + tr);
3215        if (reason != null &&
3216                (reason.intent.getFlags()&Intent.FLAG_ACTIVITY_NO_ANIMATION) != 0) {
3217            mWindowManager.prepareAppTransition(AppTransition.TRANSIT_NONE, false);
3218            ActivityRecord r = topRunningActivityLocked(null);
3219            if (r != null) {
3220                mNoAnimActivities.add(r);
3221            }
3222            ActivityOptions.abort(options);
3223        } else {
3224            updateTransitLocked(AppTransition.TRANSIT_TASK_TO_FRONT, options);
3225        }
3226
3227        mWindowManager.moveTaskToTop(tr.taskId);
3228
3229        mStackSupervisor.resumeTopActivitiesLocked();
3230        EventLog.writeEvent(EventLogTags.AM_TASK_TO_FRONT, tr.userId, tr.taskId);
3231
3232        if (VALIDATE_TOKENS) {
3233            validateAppTokensLocked();
3234        }
3235    }
3236
3237    /**
3238     * Worker method for rearranging history stack. Implements the function of moving all
3239     * activities for a specific task (gathering them if disjoint) into a single group at the
3240     * bottom of the stack.
3241     *
3242     * If a watcher is installed, the action is preflighted and the watcher has an opportunity
3243     * to premeptively cancel the move.
3244     *
3245     * @param taskId The taskId to collect and move to the bottom.
3246     * @return Returns true if the move completed, false if not.
3247     */
3248    final boolean moveTaskToBackLocked(int taskId, ActivityRecord reason) {
3249        final TaskRecord tr = taskForIdLocked(taskId);
3250        if (tr == null) {
3251            Slog.i(TAG, "moveTaskToBack: bad taskId=" + taskId);
3252            return false;
3253        }
3254
3255        Slog.i(TAG, "moveTaskToBack: " + tr);
3256
3257        mStackSupervisor.endLockTaskModeIfTaskEnding(tr);
3258
3259        // If we have a watcher, preflight the move before committing to it.  First check
3260        // for *other* available tasks, but if none are available, then try again allowing the
3261        // current task to be selected.
3262        if (mStackSupervisor.isFrontStack(this) && mService.mController != null) {
3263            ActivityRecord next = topRunningActivityLocked(null, taskId);
3264            if (next == null) {
3265                next = topRunningActivityLocked(null, 0);
3266            }
3267            if (next != null) {
3268                // ask watcher if this is allowed
3269                boolean moveOK = true;
3270                try {
3271                    moveOK = mService.mController.activityResuming(next.packageName);
3272                } catch (RemoteException e) {
3273                    mService.mController = null;
3274                    Watchdog.getInstance().setActivityController(null);
3275                }
3276                if (!moveOK) {
3277                    return false;
3278                }
3279            }
3280        }
3281
3282        if (DEBUG_TRANSITION) Slog.v(TAG,
3283                "Prepare to back transition: task=" + taskId);
3284
3285        mTaskHistory.remove(tr);
3286        mTaskHistory.add(0, tr);
3287        updateTaskMovement(tr, false);
3288
3289        // There is an assumption that moving a task to the back moves it behind the home activity.
3290        // We make sure here that some activity in the stack will launch home.
3291        int numTasks = mTaskHistory.size();
3292        for (int taskNdx = numTasks - 1; taskNdx >= 1; --taskNdx) {
3293            final TaskRecord task = mTaskHistory.get(taskNdx);
3294            if (task.isOverHomeStack()) {
3295                break;
3296            }
3297            if (taskNdx == 1) {
3298                // Set the last task before tr to go to home.
3299                task.setTaskToReturnTo(HOME_ACTIVITY_TYPE);
3300            }
3301        }
3302
3303        if (reason != null &&
3304                (reason.intent.getFlags() & Intent.FLAG_ACTIVITY_NO_ANIMATION) != 0) {
3305            mWindowManager.prepareAppTransition(AppTransition.TRANSIT_NONE, false);
3306            ActivityRecord r = topRunningActivityLocked(null);
3307            if (r != null) {
3308                mNoAnimActivities.add(r);
3309            }
3310        } else {
3311            mWindowManager.prepareAppTransition(AppTransition.TRANSIT_TASK_TO_BACK, false);
3312        }
3313        mWindowManager.moveTaskToBottom(taskId);
3314
3315        if (VALIDATE_TOKENS) {
3316            validateAppTokensLocked();
3317        }
3318
3319        final TaskRecord task = mResumedActivity != null ? mResumedActivity.task : null;
3320        if (task == tr && tr.isOverHomeStack() || numTasks <= 1 && isOnHomeDisplay()) {
3321            final int taskToReturnTo = tr.getTaskToReturnTo();
3322            tr.setTaskToReturnTo(APPLICATION_ACTIVITY_TYPE);
3323            return mStackSupervisor.resumeHomeStackTask(taskToReturnTo, null);
3324        }
3325
3326        mStackSupervisor.resumeTopActivitiesLocked();
3327        return true;
3328    }
3329
3330    static final void logStartActivity(int tag, ActivityRecord r,
3331            TaskRecord task) {
3332        final Uri data = r.intent.getData();
3333        final String strData = data != null ? data.toSafeString() : null;
3334
3335        EventLog.writeEvent(tag,
3336                r.userId, System.identityHashCode(r), task.taskId,
3337                r.shortComponentName, r.intent.getAction(),
3338                r.intent.getType(), strData, r.intent.getFlags());
3339    }
3340
3341    /**
3342     * Make sure the given activity matches the current configuration.  Returns
3343     * false if the activity had to be destroyed.  Returns true if the
3344     * configuration is the same, or the activity will remain running as-is
3345     * for whatever reason.  Ensures the HistoryRecord is updated with the
3346     * correct configuration and all other bookkeeping is handled.
3347     */
3348    final boolean ensureActivityConfigurationLocked(ActivityRecord r,
3349            int globalChanges) {
3350        if (mConfigWillChange) {
3351            if (DEBUG_SWITCH || DEBUG_CONFIGURATION) Slog.v(TAG,
3352                    "Skipping config check (will change): " + r);
3353            return true;
3354        }
3355
3356        if (DEBUG_SWITCH || DEBUG_CONFIGURATION) Slog.v(TAG,
3357                "Ensuring correct configuration: " + r);
3358
3359        // Short circuit: if the two configurations are the exact same
3360        // object (the common case), then there is nothing to do.
3361        Configuration newConfig = mService.mConfiguration;
3362        if (r.configuration == newConfig && !r.forceNewConfig) {
3363            if (DEBUG_SWITCH || DEBUG_CONFIGURATION) Slog.v(TAG,
3364                    "Configuration unchanged in " + r);
3365            return true;
3366        }
3367
3368        // We don't worry about activities that are finishing.
3369        if (r.finishing) {
3370            if (DEBUG_SWITCH || DEBUG_CONFIGURATION) Slog.v(TAG,
3371                    "Configuration doesn't matter in finishing " + r);
3372            r.stopFreezingScreenLocked(false);
3373            return true;
3374        }
3375
3376        // Okay we now are going to make this activity have the new config.
3377        // But then we need to figure out how it needs to deal with that.
3378        Configuration oldConfig = r.configuration;
3379        r.configuration = newConfig;
3380
3381        // Determine what has changed.  May be nothing, if this is a config
3382        // that has come back from the app after going idle.  In that case
3383        // we just want to leave the official config object now in the
3384        // activity and do nothing else.
3385        final int changes = oldConfig.diff(newConfig);
3386        if (changes == 0 && !r.forceNewConfig) {
3387            if (DEBUG_SWITCH || DEBUG_CONFIGURATION) Slog.v(TAG,
3388                    "Configuration no differences in " + r);
3389            return true;
3390        }
3391
3392        // If the activity isn't currently running, just leave the new
3393        // configuration and it will pick that up next time it starts.
3394        if (r.app == null || r.app.thread == null) {
3395            if (DEBUG_SWITCH || DEBUG_CONFIGURATION) Slog.v(TAG,
3396                    "Configuration doesn't matter not running " + r);
3397            r.stopFreezingScreenLocked(false);
3398            r.forceNewConfig = false;
3399            return true;
3400        }
3401
3402        // Figure out how to handle the changes between the configurations.
3403        if (DEBUG_SWITCH || DEBUG_CONFIGURATION) {
3404            Slog.v(TAG, "Checking to restart " + r.info.name + ": changed=0x"
3405                    + Integer.toHexString(changes) + ", handles=0x"
3406                    + Integer.toHexString(r.info.getRealConfigChanged())
3407                    + ", newConfig=" + newConfig);
3408        }
3409        if ((changes&(~r.info.getRealConfigChanged())) != 0 || r.forceNewConfig) {
3410            // Aha, the activity isn't handling the change, so DIE DIE DIE.
3411            r.configChangeFlags |= changes;
3412            r.startFreezingScreenLocked(r.app, globalChanges);
3413            r.forceNewConfig = false;
3414            if (r.app == null || r.app.thread == null) {
3415                if (DEBUG_SWITCH || DEBUG_CONFIGURATION) Slog.v(TAG,
3416                        "Config is destroying non-running " + r);
3417                destroyActivityLocked(r, true, false, "config");
3418            } else if (r.state == ActivityState.PAUSING) {
3419                // A little annoying: we are waiting for this activity to
3420                // finish pausing.  Let's not do anything now, but just
3421                // flag that it needs to be restarted when done pausing.
3422                if (DEBUG_SWITCH || DEBUG_CONFIGURATION) Slog.v(TAG,
3423                        "Config is skipping already pausing " + r);
3424                r.configDestroy = true;
3425                return true;
3426            } else if (r.state == ActivityState.RESUMED) {
3427                // Try to optimize this case: the configuration is changing
3428                // and we need to restart the top, resumed activity.
3429                // Instead of doing the normal handshaking, just say
3430                // "restart!".
3431                if (DEBUG_SWITCH || DEBUG_CONFIGURATION) Slog.v(TAG,
3432                        "Config is relaunching resumed " + r);
3433                relaunchActivityLocked(r, r.configChangeFlags, true);
3434                r.configChangeFlags = 0;
3435            } else {
3436                if (DEBUG_SWITCH || DEBUG_CONFIGURATION) Slog.v(TAG,
3437                        "Config is relaunching non-resumed " + r);
3438                relaunchActivityLocked(r, r.configChangeFlags, false);
3439                r.configChangeFlags = 0;
3440            }
3441
3442            // All done...  tell the caller we weren't able to keep this
3443            // activity around.
3444            return false;
3445        }
3446
3447        // Default case: the activity can handle this new configuration, so
3448        // hand it over.  Note that we don't need to give it the new
3449        // configuration, since we always send configuration changes to all
3450        // process when they happen so it can just use whatever configuration
3451        // it last got.
3452        if (r.app != null && r.app.thread != null) {
3453            try {
3454                if (DEBUG_CONFIGURATION) Slog.v(TAG, "Sending new config to " + r);
3455                r.app.thread.scheduleActivityConfigurationChanged(r.appToken);
3456            } catch (RemoteException e) {
3457                // If process died, whatever.
3458            }
3459        }
3460        r.stopFreezingScreenLocked(false);
3461
3462        return true;
3463    }
3464
3465    private boolean relaunchActivityLocked(ActivityRecord r,
3466            int changes, boolean andResume) {
3467        List<ResultInfo> results = null;
3468        List<Intent> newIntents = null;
3469        if (andResume) {
3470            results = r.results;
3471            newIntents = r.newIntents;
3472        }
3473        if (DEBUG_SWITCH) Slog.v(TAG, "Relaunching: " + r
3474                + " with results=" + results + " newIntents=" + newIntents
3475                + " andResume=" + andResume);
3476        EventLog.writeEvent(andResume ? EventLogTags.AM_RELAUNCH_RESUME_ACTIVITY
3477                : EventLogTags.AM_RELAUNCH_ACTIVITY, r.userId, System.identityHashCode(r),
3478                r.task.taskId, r.shortComponentName);
3479
3480        r.startFreezingScreenLocked(r.app, 0);
3481
3482        mStackSupervisor.removeChildActivityContainers(r);
3483
3484        try {
3485            if (DEBUG_SWITCH || DEBUG_STATES) Slog.i(TAG,
3486                    (andResume ? "Relaunching to RESUMED " : "Relaunching to PAUSED ")
3487                    + r);
3488            r.forceNewConfig = false;
3489            r.app.thread.scheduleRelaunchActivity(r.appToken, results, newIntents,
3490                    changes, !andResume, new Configuration(mService.mConfiguration));
3491            // Note: don't need to call pauseIfSleepingLocked() here, because
3492            // the caller will only pass in 'andResume' if this activity is
3493            // currently resumed, which implies we aren't sleeping.
3494        } catch (RemoteException e) {
3495            if (DEBUG_SWITCH || DEBUG_STATES) Slog.i(TAG, "Relaunch failed", e);
3496        }
3497
3498        if (andResume) {
3499            r.results = null;
3500            r.newIntents = null;
3501            r.state = ActivityState.RESUMED;
3502        } else {
3503            mHandler.removeMessages(PAUSE_TIMEOUT_MSG, r);
3504            r.state = ActivityState.PAUSED;
3505        }
3506
3507        return true;
3508    }
3509
3510    boolean willActivityBeVisibleLocked(IBinder token) {
3511        for (int taskNdx = mTaskHistory.size() - 1; taskNdx >= 0; --taskNdx) {
3512            final ArrayList<ActivityRecord> activities = mTaskHistory.get(taskNdx).mActivities;
3513            for (int activityNdx = activities.size() - 1; activityNdx >= 0; --activityNdx) {
3514                final ActivityRecord r = activities.get(activityNdx);
3515                if (r.appToken == token) {
3516                    return true;
3517                }
3518                if (r.fullscreen && !r.finishing) {
3519                    return false;
3520                }
3521            }
3522        }
3523        final ActivityRecord r = ActivityRecord.forToken(token);
3524        if (r == null) {
3525            return false;
3526        }
3527        if (r.finishing) Slog.e(TAG, "willActivityBeVisibleLocked: Returning false,"
3528                + " would have returned true for r=" + r);
3529        return !r.finishing;
3530    }
3531
3532    void closeSystemDialogsLocked() {
3533        for (int taskNdx = mTaskHistory.size() - 1; taskNdx >= 0; --taskNdx) {
3534            final ArrayList<ActivityRecord> activities = mTaskHistory.get(taskNdx).mActivities;
3535            for (int activityNdx = activities.size() - 1; activityNdx >= 0; --activityNdx) {
3536                final ActivityRecord r = activities.get(activityNdx);
3537                if ((r.info.flags&ActivityInfo.FLAG_FINISH_ON_CLOSE_SYSTEM_DIALOGS) != 0) {
3538                    finishActivityLocked(r, Activity.RESULT_CANCELED, null, "close-sys", true);
3539                }
3540            }
3541        }
3542    }
3543
3544    boolean forceStopPackageLocked(String name, boolean doit, boolean evenPersistent, int userId) {
3545        boolean didSomething = false;
3546        TaskRecord lastTask = null;
3547        for (int taskNdx = mTaskHistory.size() - 1; taskNdx >= 0; --taskNdx) {
3548            final ArrayList<ActivityRecord> activities = mTaskHistory.get(taskNdx).mActivities;
3549            int numActivities = activities.size();
3550            for (int activityNdx = 0; activityNdx < numActivities; ++activityNdx) {
3551                ActivityRecord r = activities.get(activityNdx);
3552                final boolean samePackage = r.packageName.equals(name)
3553                        || (name == null && r.userId == userId);
3554                if ((userId == UserHandle.USER_ALL || r.userId == userId)
3555                        && (samePackage || r.task == lastTask)
3556                        && (r.app == null || evenPersistent || !r.app.persistent)) {
3557                    if (!doit) {
3558                        if (r.finishing) {
3559                            // If this activity is just finishing, then it is not
3560                            // interesting as far as something to stop.
3561                            continue;
3562                        }
3563                        return true;
3564                    }
3565                    didSomething = true;
3566                    Slog.i(TAG, "  Force finishing activity " + r);
3567                    if (samePackage) {
3568                        if (r.app != null) {
3569                            r.app.removed = true;
3570                        }
3571                        r.app = null;
3572                    }
3573                    lastTask = r.task;
3574                    if (finishActivityLocked(r, Activity.RESULT_CANCELED, null, "force-stop",
3575                            true)) {
3576                        // r has been deleted from mActivities, accommodate.
3577                        --numActivities;
3578                        --activityNdx;
3579                    }
3580                }
3581            }
3582        }
3583        return didSomething;
3584    }
3585
3586    void getTasksLocked(List<RunningTaskInfo> list, int callingUid, boolean allowed) {
3587        for (int taskNdx = mTaskHistory.size() - 1; taskNdx >= 0; --taskNdx) {
3588            final TaskRecord task = mTaskHistory.get(taskNdx);
3589            ActivityRecord r = null;
3590            ActivityRecord top = null;
3591            int numActivities = 0;
3592            int numRunning = 0;
3593            final ArrayList<ActivityRecord> activities = task.mActivities;
3594            if (activities.isEmpty()) {
3595                continue;
3596            }
3597            if (!allowed && !task.isHomeTask() && task.creatorUid != callingUid) {
3598                continue;
3599            }
3600            for (int activityNdx = activities.size() - 1; activityNdx >= 0; --activityNdx) {
3601                r = activities.get(activityNdx);
3602
3603                // Initialize state for next task if needed.
3604                if (top == null || (top.state == ActivityState.INITIALIZING)) {
3605                    top = r;
3606                    numActivities = numRunning = 0;
3607                }
3608
3609                // Add 'r' into the current task.
3610                numActivities++;
3611                if (r.app != null && r.app.thread != null) {
3612                    numRunning++;
3613                }
3614
3615                if (localLOGV) Slog.v(
3616                    TAG, r.intent.getComponent().flattenToShortString()
3617                    + ": task=" + r.task);
3618            }
3619
3620            RunningTaskInfo ci = new RunningTaskInfo();
3621            ci.id = task.taskId;
3622            ci.baseActivity = r.intent.getComponent();
3623            ci.topActivity = top.intent.getComponent();
3624            ci.lastActiveTime = task.lastActiveTime;
3625
3626            if (top.thumbHolder != null) {
3627                ci.description = top.thumbHolder.lastDescription;
3628            }
3629            ci.numActivities = numActivities;
3630            ci.numRunning = numRunning;
3631            //System.out.println(
3632            //    "#" + maxNum + ": " + " descr=" + ci.description);
3633            list.add(ci);
3634        }
3635    }
3636
3637    public void unhandledBackLocked() {
3638        final int top = mTaskHistory.size() - 1;
3639        if (DEBUG_SWITCH) Slog.d(
3640            TAG, "Performing unhandledBack(): top activity at " + top);
3641        if (top >= 0) {
3642            final ArrayList<ActivityRecord> activities = mTaskHistory.get(top).mActivities;
3643            int activityTop = activities.size() - 1;
3644            if (activityTop > 0) {
3645                finishActivityLocked(activities.get(activityTop), Activity.RESULT_CANCELED, null,
3646                        "unhandled-back", true);
3647            }
3648        }
3649    }
3650
3651    /**
3652     * Reset local parameters because an app's activity died.
3653     * @param app The app of the activity that died.
3654     * @return result from removeHistoryRecordsForAppLocked.
3655     */
3656    boolean handleAppDiedLocked(ProcessRecord app) {
3657        if (mPausingActivity != null && mPausingActivity.app == app) {
3658            if (DEBUG_PAUSE || DEBUG_CLEANUP) Slog.v(TAG,
3659                    "App died while pausing: " + mPausingActivity);
3660            mPausingActivity = null;
3661        }
3662        if (mLastPausedActivity != null && mLastPausedActivity.app == app) {
3663            mLastPausedActivity = null;
3664            mLastNoHistoryActivity = null;
3665        }
3666
3667        return removeHistoryRecordsForAppLocked(app);
3668    }
3669
3670    void handleAppCrashLocked(ProcessRecord app) {
3671        for (int taskNdx = mTaskHistory.size() - 1; taskNdx >= 0; --taskNdx) {
3672            final ArrayList<ActivityRecord> activities = mTaskHistory.get(taskNdx).mActivities;
3673            for (int activityNdx = activities.size() - 1; activityNdx >= 0; --activityNdx) {
3674                final ActivityRecord r = activities.get(activityNdx);
3675                if (r.app == app) {
3676                    Slog.w(TAG, "  Force finishing activity "
3677                            + r.intent.getComponent().flattenToShortString());
3678                    finishActivityLocked(r, Activity.RESULT_CANCELED, null, "crashed", false);
3679                }
3680            }
3681        }
3682    }
3683
3684    boolean dumpActivitiesLocked(FileDescriptor fd, PrintWriter pw, boolean dumpAll,
3685            boolean dumpClient, String dumpPackage, boolean needSep, String header) {
3686        boolean printed = false;
3687        for (int taskNdx = mTaskHistory.size() - 1; taskNdx >= 0; --taskNdx) {
3688            final TaskRecord task = mTaskHistory.get(taskNdx);
3689            printed |= ActivityStackSupervisor.dumpHistoryList(fd, pw,
3690                    mTaskHistory.get(taskNdx).mActivities, "    ", "Hist", true, !dumpAll,
3691                    dumpClient, dumpPackage, needSep, header,
3692                    "    Task id #" + task.taskId);
3693            if (printed) {
3694                header = null;
3695            }
3696        }
3697        return printed;
3698    }
3699
3700    ArrayList<ActivityRecord> getDumpActivitiesLocked(String name) {
3701        ArrayList<ActivityRecord> activities = new ArrayList<ActivityRecord>();
3702
3703        if ("all".equals(name)) {
3704            for (int taskNdx = mTaskHistory.size() - 1; taskNdx >= 0; --taskNdx) {
3705                activities.addAll(mTaskHistory.get(taskNdx).mActivities);
3706            }
3707        } else if ("top".equals(name)) {
3708            final int top = mTaskHistory.size() - 1;
3709            if (top >= 0) {
3710                final ArrayList<ActivityRecord> list = mTaskHistory.get(top).mActivities;
3711                int listTop = list.size() - 1;
3712                if (listTop >= 0) {
3713                    activities.add(list.get(listTop));
3714                }
3715            }
3716        } else {
3717            ItemMatcher matcher = new ItemMatcher();
3718            matcher.build(name);
3719
3720            for (int taskNdx = mTaskHistory.size() - 1; taskNdx >= 0; --taskNdx) {
3721                for (ActivityRecord r1 : mTaskHistory.get(taskNdx).mActivities) {
3722                    if (matcher.match(r1, r1.intent.getComponent())) {
3723                        activities.add(r1);
3724                    }
3725                }
3726            }
3727        }
3728
3729        return activities;
3730    }
3731
3732    ActivityRecord restartPackage(String packageName) {
3733        ActivityRecord starting = topRunningActivityLocked(null);
3734
3735        // All activities that came from the package must be
3736        // restarted as if there was a config change.
3737        for (int taskNdx = mTaskHistory.size() - 1; taskNdx >= 0; --taskNdx) {
3738            final ArrayList<ActivityRecord> activities = mTaskHistory.get(taskNdx).mActivities;
3739            for (int activityNdx = activities.size() - 1; activityNdx >= 0; --activityNdx) {
3740                final ActivityRecord a = activities.get(activityNdx);
3741                if (a.info.packageName.equals(packageName)) {
3742                    a.forceNewConfig = true;
3743                    if (starting != null && a == starting && a.visible) {
3744                        a.startFreezingScreenLocked(starting.app,
3745                                ActivityInfo.CONFIG_SCREEN_LAYOUT);
3746                    }
3747                }
3748            }
3749        }
3750
3751        return starting;
3752    }
3753
3754    void removeTask(TaskRecord task) {
3755        mStackSupervisor.endLockTaskModeIfTaskEnding(task);
3756        mWindowManager.removeTask(task.taskId);
3757        final ActivityRecord r = mResumedActivity;
3758        if (r != null && r.task == task) {
3759            mResumedActivity = null;
3760        }
3761
3762        final int taskNdx = mTaskHistory.indexOf(task);
3763        final int topTaskNdx = mTaskHistory.size() - 1;
3764        if (task.isOverHomeStack() && taskNdx < topTaskNdx) {
3765            final TaskRecord nextTask = mTaskHistory.get(taskNdx + 1);
3766            if (!nextTask.isOverHomeStack()) {
3767                nextTask.setTaskToReturnTo(HOME_ACTIVITY_TYPE);
3768            }
3769        }
3770        mTaskHistory.remove(task);
3771        updateTaskMovement(task, true);
3772
3773        if (task.mActivities.isEmpty()) {
3774            final boolean isVoiceSession = task.voiceSession != null;
3775            if (isVoiceSession) {
3776                try {
3777                    task.voiceSession.taskFinished(task.intent, task.taskId);
3778                } catch (RemoteException e) {
3779                }
3780            }
3781            if (task.autoRemoveFromRecents() || isVoiceSession) {
3782                // Task creator asked to remove this when done, or this task was a voice
3783                // interaction, so it should not remain on the recent tasks list.
3784                mService.mRecentTasks.remove(task);
3785            }
3786        }
3787
3788        if (mTaskHistory.isEmpty()) {
3789            if (DEBUG_STACK) Slog.i(TAG, "removeTask: moving to back stack=" + this);
3790            if (isOnHomeDisplay()) {
3791                mStackSupervisor.moveHomeStack(!isHomeStack());
3792            }
3793            if (mStacks != null) {
3794                mStacks.remove(this);
3795                mStacks.add(0, this);
3796            }
3797            mActivityContainer.onTaskListEmptyLocked();
3798        }
3799    }
3800
3801    TaskRecord createTaskRecord(int taskId, ActivityInfo info, Intent intent,
3802            IVoiceInteractionSession voiceSession, IVoiceInteractor voiceInteractor,
3803            boolean toTop) {
3804        TaskRecord task = new TaskRecord(mService, taskId, info, intent, voiceSession,
3805                voiceInteractor);
3806        addTask(task, toTop, false);
3807        return task;
3808    }
3809
3810    ArrayList<TaskRecord> getAllTasks() {
3811        return new ArrayList<TaskRecord>(mTaskHistory);
3812    }
3813
3814    void addTask(final TaskRecord task, final boolean toTop, boolean moving) {
3815        task.stack = this;
3816        if (toTop) {
3817            insertTaskAtTop(task);
3818        } else {
3819            mTaskHistory.add(0, task);
3820            updateTaskMovement(task, false);
3821        }
3822        if (!moving && task.voiceSession != null) {
3823            try {
3824                task.voiceSession.taskStarted(task.intent, task.taskId);
3825            } catch (RemoteException e) {
3826            }
3827        }
3828    }
3829
3830    public int getStackId() {
3831        return mStackId;
3832    }
3833
3834    @Override
3835    public String toString() {
3836        return "ActivityStack{" + Integer.toHexString(System.identityHashCode(this))
3837                + " stackId=" + mStackId + ", " + mTaskHistory.size() + " tasks}";
3838    }
3839}
3840