Launcher.java revision 31ce073f6a4a6e3e71d533ea4a2a423c2509ad89
1
2/*
3 * Copyright (C) 2008 The Android Open Source Project
4 *
5 * Licensed under the Apache License, Version 2.0 (the "License");
6 * you may not use this file except in compliance with the License.
7 * You may obtain a copy of the License at
8 *
9 *      http://www.apache.org/licenses/LICENSE-2.0
10 *
11 * Unless required by applicable law or agreed to in writing, software
12 * distributed under the License is distributed on an "AS IS" BASIS,
13 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 * See the License for the specific language governing permissions and
15 * limitations under the License.
16 */
17
18package com.android.launcher2;
19
20import android.animation.Animator;
21import android.animation.AnimatorListenerAdapter;
22import android.animation.AnimatorSet;
23import android.animation.ObjectAnimator;
24import android.animation.PropertyValuesHolder;
25import android.animation.ValueAnimator;
26import android.animation.ValueAnimator.AnimatorUpdateListener;
27import android.app.Activity;
28import android.app.ActivityManager;
29import android.app.ActivityOptions;
30import android.app.SearchManager;
31import android.appwidget.AppWidgetHostView;
32import android.appwidget.AppWidgetManager;
33import android.appwidget.AppWidgetProviderInfo;
34import android.content.ActivityNotFoundException;
35import android.content.BroadcastReceiver;
36import android.content.ClipData;
37import android.content.ClipDescription;
38import android.content.ComponentCallbacks2;
39import android.content.ComponentName;
40import android.content.ContentResolver;
41import android.content.Context;
42import android.content.Intent;
43import android.content.IntentFilter;
44import android.content.SharedPreferences;
45import android.content.pm.ActivityInfo;
46import android.content.pm.PackageManager;
47import android.content.pm.PackageManager.NameNotFoundException;
48import android.content.res.Configuration;
49import android.content.res.Resources;
50import android.database.ContentObserver;
51import android.graphics.Rect;
52import android.graphics.drawable.Drawable;
53import android.net.Uri;
54import android.os.AsyncTask;
55import android.os.Bundle;
56import android.os.Environment;
57import android.os.Handler;
58import android.os.Message;
59import android.os.StrictMode;
60import android.os.SystemClock;
61import android.os.SystemProperties;
62import android.provider.Settings;
63import android.speech.RecognizerIntent;
64import android.text.Selection;
65import android.text.SpannableStringBuilder;
66import android.text.method.TextKeyListener;
67import android.util.Log;
68import android.view.Display;
69import android.view.HapticFeedbackConstants;
70import android.view.KeyEvent;
71import android.view.LayoutInflater;
72import android.view.Menu;
73import android.view.MenuItem;
74import android.view.MotionEvent;
75import android.view.Surface;
76import android.view.View;
77import android.view.View.OnLongClickListener;
78import android.view.ViewGroup;
79import android.view.ViewTreeObserver;
80import android.view.ViewTreeObserver.OnGlobalLayoutListener;
81import android.view.WindowManager;
82import android.view.accessibility.AccessibilityEvent;
83import android.view.animation.AccelerateDecelerateInterpolator;
84import android.view.animation.AccelerateInterpolator;
85import android.view.animation.DecelerateInterpolator;
86import android.view.inputmethod.InputMethodManager;
87import android.widget.Advanceable;
88import android.widget.ImageView;
89import android.widget.TextView;
90import android.widget.Toast;
91
92import com.android.common.Search;
93import com.android.launcher.R;
94import com.android.launcher2.DropTarget.DragObject;
95
96import java.io.DataInputStream;
97import java.io.DataOutputStream;
98import java.io.FileDescriptor;
99import java.io.FileNotFoundException;
100import java.io.IOException;
101import java.io.PrintWriter;
102import java.util.ArrayList;
103import java.util.Collection;
104import java.util.Collections;
105import java.util.Comparator;
106import java.util.HashMap;
107import java.util.HashSet;
108import java.util.List;
109import java.util.Set;
110
111/**
112 * Default launcher application.
113 */
114public final class Launcher extends Activity
115        implements View.OnClickListener, OnLongClickListener, LauncherModel.Callbacks,
116                   AllAppsView.Watcher, View.OnTouchListener {
117    static final String TAG = "Launcher";
118    static final boolean LOGD = false;
119
120    static final boolean PROFILE_STARTUP = false;
121    static final boolean DEBUG_WIDGETS = false;
122    static final boolean DEBUG_STRICT_MODE = false;
123
124    private static final int MENU_GROUP_WALLPAPER = 1;
125    private static final int MENU_WALLPAPER_SETTINGS = Menu.FIRST + 1;
126    private static final int MENU_MANAGE_APPS = MENU_WALLPAPER_SETTINGS + 1;
127    private static final int MENU_SYSTEM_SETTINGS = MENU_MANAGE_APPS + 1;
128    private static final int MENU_HELP = MENU_SYSTEM_SETTINGS + 1;
129
130    private static final int REQUEST_CREATE_SHORTCUT = 1;
131    private static final int REQUEST_CREATE_APPWIDGET = 5;
132    private static final int REQUEST_PICK_APPLICATION = 6;
133    private static final int REQUEST_PICK_SHORTCUT = 7;
134    private static final int REQUEST_PICK_APPWIDGET = 9;
135    private static final int REQUEST_PICK_WALLPAPER = 10;
136
137    private static final int REQUEST_BIND_APPWIDGET = 11;
138
139    static final String EXTRA_SHORTCUT_DUPLICATE = "duplicate";
140
141    static final int SCREEN_COUNT = 5;
142    static final int DEFAULT_SCREEN = 2;
143
144    private static final String PREFERENCES = "launcher.preferences";
145    static final String FORCE_ENABLE_ROTATION_PROPERTY = "launcher.force_enable_rotation";
146
147    // Type: int
148    private static final String RUNTIME_STATE_CURRENT_SCREEN = "launcher.current_screen";
149    // Type: int
150    private static final String RUNTIME_STATE = "launcher.state";
151    // Type: int
152    private static final String RUNTIME_STATE_PENDING_ADD_CONTAINER = "launcher.add_container";
153    // Type: int
154    private static final String RUNTIME_STATE_PENDING_ADD_SCREEN = "launcher.add_screen";
155    // Type: int
156    private static final String RUNTIME_STATE_PENDING_ADD_CELL_X = "launcher.add_cell_x";
157    // Type: int
158    private static final String RUNTIME_STATE_PENDING_ADD_CELL_Y = "launcher.add_cell_y";
159    // Type: boolean
160    private static final String RUNTIME_STATE_PENDING_FOLDER_RENAME = "launcher.rename_folder";
161    // Type: long
162    private static final String RUNTIME_STATE_PENDING_FOLDER_RENAME_ID = "launcher.rename_folder_id";
163
164    private static final String TOOLBAR_ICON_METADATA_NAME = "com.android.launcher.toolbar_icon";
165    private static final String TOOLBAR_SEARCH_ICON_METADATA_NAME =
166            "com.android.launcher.toolbar_search_icon";
167    private static final String TOOLBAR_VOICE_SEARCH_ICON_METADATA_NAME =
168            "com.android.launcher.toolbar_voice_search_icon";
169
170    /** The different states that Launcher can be in. */
171    private enum State { WORKSPACE, APPS_CUSTOMIZE, APPS_CUSTOMIZE_SPRING_LOADED };
172    private State mState = State.WORKSPACE;
173    private AnimatorSet mStateAnimation;
174    private AnimatorSet mDividerAnimator;
175
176    static final int APPWIDGET_HOST_ID = 1024;
177    private static final int EXIT_SPRINGLOADED_MODE_SHORT_TIMEOUT = 300;
178    private static final int EXIT_SPRINGLOADED_MODE_LONG_TIMEOUT = 600;
179    private static final int SHOW_CLING_DURATION = 550;
180    private static final int DISMISS_CLING_DURATION = 250;
181
182    private static final Object sLock = new Object();
183    private static int sScreen = DEFAULT_SCREEN;
184
185    // How long to wait before the new-shortcut animation automatically pans the workspace
186    private static int NEW_APPS_ANIMATION_INACTIVE_TIMEOUT_SECONDS = 10;
187
188    private final BroadcastReceiver mCloseSystemDialogsReceiver
189            = new CloseSystemDialogsIntentReceiver();
190    private final ContentObserver mWidgetObserver = new AppWidgetResetObserver();
191
192    private LayoutInflater mInflater;
193
194    private Workspace mWorkspace;
195    private View mQsbDivider;
196    private View mDockDivider;
197    private DragLayer mDragLayer;
198    private DragController mDragController;
199
200    private AppWidgetManager mAppWidgetManager;
201    private LauncherAppWidgetHost mAppWidgetHost;
202
203    private ItemInfo mPendingAddInfo = new ItemInfo();
204    private int[] mTmpAddItemCellCoordinates = new int[2];
205
206    private FolderInfo mFolderInfo;
207
208    private Hotseat mHotseat;
209    private View mAllAppsButton;
210
211    private SearchDropTargetBar mSearchDropTargetBar;
212    private AppsCustomizeTabHost mAppsCustomizeTabHost;
213    private AppsCustomizePagedView mAppsCustomizeContent;
214    private boolean mAutoAdvanceRunning = false;
215
216    private Bundle mSavedState;
217
218    private SpannableStringBuilder mDefaultKeySsb = null;
219
220    private boolean mWorkspaceLoading = true;
221
222    private boolean mPaused = true;
223    private boolean mRestoring;
224    private boolean mWaitingForResult;
225    private boolean mOnResumeNeedsLoad;
226
227    private Bundle mSavedInstanceState;
228
229    private LauncherModel mModel;
230    private IconCache mIconCache;
231    private boolean mUserPresent = true;
232    private boolean mVisible = false;
233    private boolean mAttached = false;
234
235    private static LocaleConfiguration sLocaleConfiguration = null;
236
237    private static HashMap<Long, FolderInfo> sFolders = new HashMap<Long, FolderInfo>();
238
239    private Intent mAppMarketIntent = null;
240
241    // Related to the auto-advancing of widgets
242    private final int ADVANCE_MSG = 1;
243    private final int mAdvanceInterval = 20000;
244    private final int mAdvanceStagger = 250;
245    private long mAutoAdvanceSentTime;
246    private long mAutoAdvanceTimeLeft = -1;
247    private HashMap<View, AppWidgetProviderInfo> mWidgetsToAdvance =
248        new HashMap<View, AppWidgetProviderInfo>();
249
250    // Determines how long to wait after a rotation before restoring the screen orientation to
251    // match the sensor state.
252    private final int mRestoreScreenOrientationDelay = 500;
253
254    // External icons saved in case of resource changes, orientation, etc.
255    private static Drawable.ConstantState[] sGlobalSearchIcon = new Drawable.ConstantState[2];
256    private static Drawable.ConstantState[] sVoiceSearchIcon = new Drawable.ConstantState[2];
257    private static Drawable.ConstantState[] sAppMarketIcon = new Drawable.ConstantState[2];
258
259    static final ArrayList<String> sDumpLogs = new ArrayList<String>();
260    PendingAddWidgetInfo mWidgetBeingBoundOrConfigured = null;
261
262    // We only want to get the SharedPreferences once since it does an FS stat each time we get
263    // it from the context.
264    private SharedPreferences mSharedPrefs;
265
266    // Holds the page that we need to animate to, and the icon views that we need to animate up
267    // when we scroll to that page on resume.
268    private int mNewShortcutAnimatePage = -1;
269    private ArrayList<View> mNewShortcutAnimateViews = new ArrayList<View>();
270
271    private BubbleTextView mWaitingForResume;
272
273    private Runnable mBuildLayersRunnable = new Runnable() {
274        public void run() {
275            if (mWorkspace != null) {
276                mWorkspace.buildPageHardwareLayers();
277            }
278        }
279    };
280
281    private static ArrayList<PendingAddArguments> sPendingAddList
282            = new ArrayList<PendingAddArguments>();
283
284    private static class PendingAddArguments {
285        int requestCode;
286        Intent intent;
287        long container;
288        int screen;
289        int cellX;
290        int cellY;
291    }
292
293    @Override
294    protected void onCreate(Bundle savedInstanceState) {
295        if (DEBUG_STRICT_MODE) {
296            StrictMode.setThreadPolicy(new StrictMode.ThreadPolicy.Builder()
297                    .detectDiskReads()
298                    .detectDiskWrites()
299                    .detectNetwork()   // or .detectAll() for all detectable problems
300                    .penaltyLog()
301                    .build());
302            StrictMode.setVmPolicy(new StrictMode.VmPolicy.Builder()
303                    .detectLeakedSqlLiteObjects()
304                    .detectLeakedClosableObjects()
305                    .penaltyLog()
306                    .penaltyDeath()
307                    .build());
308        }
309
310        super.onCreate(savedInstanceState);
311        LauncherApplication app = ((LauncherApplication)getApplication());
312        mSharedPrefs = getSharedPreferences(LauncherApplication.getSharedPreferencesKey(),
313                Context.MODE_PRIVATE);
314        mModel = app.setLauncher(this);
315        mIconCache = app.getIconCache();
316        mDragController = new DragController(this);
317        mInflater = getLayoutInflater();
318
319        mAppWidgetManager = AppWidgetManager.getInstance(this);
320        mAppWidgetHost = new LauncherAppWidgetHost(this, APPWIDGET_HOST_ID);
321        mAppWidgetHost.startListening();
322
323        if (PROFILE_STARTUP) {
324            android.os.Debug.startMethodTracing(
325                    Environment.getExternalStorageDirectory() + "/launcher");
326        }
327
328        checkForLocaleChange();
329        setContentView(R.layout.launcher);
330        setupViews();
331        showFirstRunWorkspaceCling();
332
333        registerContentObservers();
334
335        lockAllApps();
336
337        mSavedState = savedInstanceState;
338        restoreState(mSavedState);
339
340        // Update customization drawer _after_ restoring the states
341        if (mAppsCustomizeContent != null) {
342            mAppsCustomizeContent.onPackagesUpdated();
343        }
344
345        if (PROFILE_STARTUP) {
346            android.os.Debug.stopMethodTracing();
347        }
348
349        if (!mRestoring) {
350            mModel.startLoader(true);
351        }
352
353        if (!mModel.isAllAppsLoaded()) {
354            ViewGroup appsCustomizeContentParent = (ViewGroup) mAppsCustomizeContent.getParent();
355            mInflater.inflate(R.layout.apps_customize_progressbar, appsCustomizeContentParent);
356        }
357
358        // For handling default keys
359        mDefaultKeySsb = new SpannableStringBuilder();
360        Selection.setSelection(mDefaultKeySsb, 0);
361
362        IntentFilter filter = new IntentFilter(Intent.ACTION_CLOSE_SYSTEM_DIALOGS);
363        registerReceiver(mCloseSystemDialogsReceiver, filter);
364
365        boolean searchVisible = false;
366        boolean voiceVisible = false;
367        // If we have a saved version of these external icons, we load them up immediately
368        int coi = getCurrentOrientationIndexForGlobalIcons();
369        if (sGlobalSearchIcon[coi] == null || sVoiceSearchIcon[coi] == null ||
370                sAppMarketIcon[coi] == null) {
371            updateAppMarketIcon();
372            searchVisible = updateGlobalSearchIcon();
373            voiceVisible = updateVoiceSearchIcon(searchVisible);
374        }
375        if (sGlobalSearchIcon[coi] != null) {
376             updateGlobalSearchIcon(sGlobalSearchIcon[coi]);
377             searchVisible = true;
378        }
379        if (sVoiceSearchIcon[coi] != null) {
380            updateVoiceSearchIcon(sVoiceSearchIcon[coi]);
381            voiceVisible = true;
382        }
383        if (sAppMarketIcon[coi] != null) {
384            updateAppMarketIcon(sAppMarketIcon[coi]);
385        }
386        mSearchDropTargetBar.onSearchPackagesChanged(searchVisible, voiceVisible);
387
388        // On large interfaces, we want the screen to auto-rotate based on the current orientation
389        unlockScreenOrientation(true);
390    }
391
392    private void checkForLocaleChange() {
393        if (sLocaleConfiguration == null) {
394            new AsyncTask<Void, Void, LocaleConfiguration>() {
395                @Override
396                protected LocaleConfiguration doInBackground(Void... unused) {
397                    LocaleConfiguration localeConfiguration = new LocaleConfiguration();
398                    readConfiguration(Launcher.this, localeConfiguration);
399                    return localeConfiguration;
400                }
401
402                @Override
403                protected void onPostExecute(LocaleConfiguration result) {
404                    sLocaleConfiguration = result;
405                    checkForLocaleChange();  // recursive, but now with a locale configuration
406                }
407            }.execute();
408            return;
409        }
410
411        final Configuration configuration = getResources().getConfiguration();
412
413        final String previousLocale = sLocaleConfiguration.locale;
414        final String locale = configuration.locale.toString();
415
416        final int previousMcc = sLocaleConfiguration.mcc;
417        final int mcc = configuration.mcc;
418
419        final int previousMnc = sLocaleConfiguration.mnc;
420        final int mnc = configuration.mnc;
421
422        boolean localeChanged = !locale.equals(previousLocale) || mcc != previousMcc || mnc != previousMnc;
423
424        if (localeChanged) {
425            sLocaleConfiguration.locale = locale;
426            sLocaleConfiguration.mcc = mcc;
427            sLocaleConfiguration.mnc = mnc;
428
429            mIconCache.flush();
430
431            final LocaleConfiguration localeConfiguration = sLocaleConfiguration;
432            new Thread("WriteLocaleConfiguration") {
433                @Override
434                public void run() {
435                    writeConfiguration(Launcher.this, localeConfiguration);
436                }
437            }.start();
438        }
439    }
440
441    private static class LocaleConfiguration {
442        public String locale;
443        public int mcc = -1;
444        public int mnc = -1;
445    }
446
447    private static void readConfiguration(Context context, LocaleConfiguration configuration) {
448        DataInputStream in = null;
449        try {
450            in = new DataInputStream(context.openFileInput(PREFERENCES));
451            configuration.locale = in.readUTF();
452            configuration.mcc = in.readInt();
453            configuration.mnc = in.readInt();
454        } catch (FileNotFoundException e) {
455            // Ignore
456        } catch (IOException e) {
457            // Ignore
458        } finally {
459            if (in != null) {
460                try {
461                    in.close();
462                } catch (IOException e) {
463                    // Ignore
464                }
465            }
466        }
467    }
468
469    private static void writeConfiguration(Context context, LocaleConfiguration configuration) {
470        DataOutputStream out = null;
471        try {
472            out = new DataOutputStream(context.openFileOutput(PREFERENCES, MODE_PRIVATE));
473            out.writeUTF(configuration.locale);
474            out.writeInt(configuration.mcc);
475            out.writeInt(configuration.mnc);
476            out.flush();
477        } catch (FileNotFoundException e) {
478            // Ignore
479        } catch (IOException e) {
480            //noinspection ResultOfMethodCallIgnored
481            context.getFileStreamPath(PREFERENCES).delete();
482        } finally {
483            if (out != null) {
484                try {
485                    out.close();
486                } catch (IOException e) {
487                    // Ignore
488                }
489            }
490        }
491    }
492
493    public DragLayer getDragLayer() {
494        return mDragLayer;
495    }
496
497    static int getScreen() {
498        synchronized (sLock) {
499            return sScreen;
500        }
501    }
502
503    static void setScreen(int screen) {
504        synchronized (sLock) {
505            sScreen = screen;
506        }
507    }
508
509    /**
510     * Returns whether we should delay spring loaded mode -- for shortcuts and widgets that have
511     * a configuration step, this allows the proper animations to run after other transitions.
512     */
513    private boolean completeAdd(PendingAddArguments args) {
514        boolean result = false;
515        switch (args.requestCode) {
516            case REQUEST_PICK_APPLICATION:
517                completeAddApplication(args.intent, args.container, args.screen, args.cellX,
518                        args.cellY);
519                break;
520            case REQUEST_PICK_SHORTCUT:
521                processShortcut(args.intent);
522                break;
523            case REQUEST_CREATE_SHORTCUT:
524                completeAddShortcut(args.intent, args.container, args.screen, args.cellX,
525                        args.cellY);
526                result = true;
527                break;
528            case REQUEST_PICK_APPWIDGET:
529                addAppWidgetFromPick(args.intent);
530                break;
531            case REQUEST_CREATE_APPWIDGET:
532                int appWidgetId = args.intent.getIntExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, -1);
533                completeAddAppWidget(appWidgetId, args.container, args.screen, null, null);
534                result = true;
535                break;
536            case REQUEST_PICK_WALLPAPER:
537                // We just wanted the activity result here so we can clear mWaitingForResult
538                break;
539        }
540        // Before adding this resetAddInfo(), after a shortcut was added to a workspace screen,
541        // if you turned the screen off and then back while in All Apps, Launcher would not
542        // return to the workspace. Clearing mAddInfo.container here fixes this issue
543        resetAddInfo();
544        return result;
545    }
546
547    @Override
548    protected void onActivityResult(
549            final int requestCode, final int resultCode, final Intent data) {
550        if (requestCode == REQUEST_BIND_APPWIDGET) {
551            int appWidgetId = data != null ?
552                    data.getIntExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, -1) : -1;
553            if (resultCode == RESULT_CANCELED) {
554                completeTwoStageWidgetDrop(RESULT_CANCELED, appWidgetId);
555            } else if (resultCode == RESULT_OK) {
556                addAppWidgetImpl(appWidgetId, mWidgetBeingBoundOrConfigured);
557            }
558            return;
559        }
560        boolean delayExitSpringLoadedMode = false;
561        boolean isWidgetDrop = (requestCode == REQUEST_PICK_APPWIDGET ||
562                requestCode == REQUEST_CREATE_APPWIDGET);
563        mWaitingForResult = false;
564
565        // We have special handling for widgets
566        if (isWidgetDrop) {
567            int appWidgetId = data != null ?
568                    data.getIntExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, -1) : -1;
569            if (appWidgetId < 0) {
570                Log.e(TAG, "Error: appWidgetId (EXTRA_APPWIDGET_ID) was not returned from the \\" +
571                        "widget configuration activity.");
572                completeTwoStageWidgetDrop(RESULT_CANCELED, appWidgetId);
573            } else {
574                completeTwoStageWidgetDrop(resultCode, appWidgetId);
575            }
576            return;
577        }
578
579        // The pattern used here is that a user PICKs a specific application,
580        // which, depending on the target, might need to CREATE the actual target.
581
582        // For example, the user would PICK_SHORTCUT for "Music playlist", and we
583        // launch over to the Music app to actually CREATE_SHORTCUT.
584        if (resultCode == RESULT_OK && mPendingAddInfo.container != ItemInfo.NO_ID) {
585            final PendingAddArguments args = new PendingAddArguments();
586            args.requestCode = requestCode;
587            args.intent = data;
588            args.container = mPendingAddInfo.container;
589            args.screen = mPendingAddInfo.screen;
590            args.cellX = mPendingAddInfo.cellX;
591            args.cellY = mPendingAddInfo.cellY;
592            if (isWorkspaceLocked()) {
593                sPendingAddList.add(args);
594            } else {
595                delayExitSpringLoadedMode = completeAdd(args);
596            }
597        }
598        mDragLayer.clearAnimatedView();
599        // Exit spring loaded mode if necessary after cancelling the configuration of a widget
600        exitSpringLoadedDragModeDelayed((resultCode != RESULT_CANCELED), delayExitSpringLoadedMode,
601                null);
602    }
603
604    private void completeTwoStageWidgetDrop(final int resultCode, final int appWidgetId) {
605        CellLayout cellLayout =
606                (CellLayout) mWorkspace.getChildAt(mWidgetBeingBoundOrConfigured.screen);
607        Runnable onCompleteRunnable = null;
608        int animationType = 0;
609
610        if (resultCode == RESULT_OK) {
611            animationType = Workspace.COMPLETE_TWO_STAGE_WIDGET_DROP_ANIMATION;
612            final AppWidgetHostView layout = mAppWidgetHost.createView(this, appWidgetId,
613                    mWidgetBeingBoundOrConfigured.info);
614            mWidgetBeingBoundOrConfigured.boundWidget = layout;
615            onCompleteRunnable = new Runnable() {
616                @Override
617                public void run() {
618                    completeAddAppWidget(appWidgetId, mPendingAddInfo.container,
619                            mPendingAddInfo.screen, layout, null);
620                    exitSpringLoadedDragModeDelayed((resultCode != RESULT_CANCELED), false,
621                            null);
622                }
623            };
624        } else if (resultCode == RESULT_CANCELED) {
625            animationType = Workspace.CANCEL_TWO_STAGE_WIDGET_DROP_ANIMATION;
626            onCompleteRunnable = new Runnable() {
627                @Override
628                public void run() {
629                    exitSpringLoadedDragModeDelayed((resultCode != RESULT_CANCELED), false,
630                            null);
631                }
632            };
633        }
634        mWorkspace.animateWidgetDrop(mWidgetBeingBoundOrConfigured, cellLayout,
635                (DragView) mDragLayer.getAnimatedView(), onCompleteRunnable,
636                animationType, mWidgetBeingBoundOrConfigured.boundWidget, true);
637        mWidgetBeingBoundOrConfigured = null;
638    }
639
640    @Override
641    protected void onResume() {
642        super.onResume();
643
644        mPaused = false;
645        if (mRestoring || mOnResumeNeedsLoad) {
646            mWorkspaceLoading = true;
647            mModel.startLoader(true);
648            mRestoring = false;
649            mOnResumeNeedsLoad = false;
650        }
651
652        // Reset the pressed state of icons that were locked in the press state while activities
653        // were launching
654        if (mWaitingForResume != null) {
655            // Resets the previous workspace icon press state
656            mWaitingForResume.setStayPressed(false);
657        }
658        if (mAppsCustomizeContent != null) {
659            // Resets the previous all apps icon press state
660            mAppsCustomizeContent.resetDrawableState();
661        }
662    }
663
664    @Override
665    protected void onPause() {
666        super.onPause();
667        mPaused = true;
668        mDragController.cancelDrag();
669        mDragController.resetLastGestureUpTime();
670    }
671
672    @Override
673    public Object onRetainNonConfigurationInstance() {
674        // Flag the loader to stop early before switching
675        mModel.stopLoader();
676        if (mAppsCustomizeContent != null) {
677            mAppsCustomizeContent.surrender();
678        }
679        return Boolean.TRUE;
680    }
681
682    // We can't hide the IME if it was forced open.  So don't bother
683    /*
684    @Override
685    public void onWindowFocusChanged(boolean hasFocus) {
686        super.onWindowFocusChanged(hasFocus);
687
688        if (hasFocus) {
689            final InputMethodManager inputManager = (InputMethodManager)
690                    getSystemService(Context.INPUT_METHOD_SERVICE);
691            WindowManager.LayoutParams lp = getWindow().getAttributes();
692            inputManager.hideSoftInputFromWindow(lp.token, 0, new android.os.ResultReceiver(new
693                        android.os.Handler()) {
694                        protected void onReceiveResult(int resultCode, Bundle resultData) {
695                            Log.d(TAG, "ResultReceiver got resultCode=" + resultCode);
696                        }
697                    });
698            Log.d(TAG, "called hideSoftInputFromWindow from onWindowFocusChanged");
699        }
700    }
701    */
702
703    private boolean acceptFilter() {
704        final InputMethodManager inputManager = (InputMethodManager)
705                getSystemService(Context.INPUT_METHOD_SERVICE);
706        return !inputManager.isFullscreenMode();
707    }
708
709    @Override
710    public boolean onKeyDown(int keyCode, KeyEvent event) {
711        final int uniChar = event.getUnicodeChar();
712        final boolean handled = super.onKeyDown(keyCode, event);
713        final boolean isKeyNotWhitespace = uniChar > 0 && !Character.isWhitespace(uniChar);
714        if (!handled && acceptFilter() && isKeyNotWhitespace) {
715            boolean gotKey = TextKeyListener.getInstance().onKeyDown(mWorkspace, mDefaultKeySsb,
716                    keyCode, event);
717            if (gotKey && mDefaultKeySsb != null && mDefaultKeySsb.length() > 0) {
718                // something usable has been typed - start a search
719                // the typed text will be retrieved and cleared by
720                // showSearchDialog()
721                // If there are multiple keystrokes before the search dialog takes focus,
722                // onSearchRequested() will be called for every keystroke,
723                // but it is idempotent, so it's fine.
724                return onSearchRequested();
725            }
726        }
727
728        // Eat the long press event so the keyboard doesn't come up.
729        if (keyCode == KeyEvent.KEYCODE_MENU && event.isLongPress()) {
730            return true;
731        }
732
733        return handled;
734    }
735
736    private String getTypedText() {
737        return mDefaultKeySsb.toString();
738    }
739
740    private void clearTypedText() {
741        mDefaultKeySsb.clear();
742        mDefaultKeySsb.clearSpans();
743        Selection.setSelection(mDefaultKeySsb, 0);
744    }
745
746    /**
747     * Given the integer (ordinal) value of a State enum instance, convert it to a variable of type
748     * State
749     */
750    private static State intToState(int stateOrdinal) {
751        State state = State.WORKSPACE;
752        final State[] stateValues = State.values();
753        for (int i = 0; i < stateValues.length; i++) {
754            if (stateValues[i].ordinal() == stateOrdinal) {
755                state = stateValues[i];
756                break;
757            }
758        }
759        return state;
760    }
761
762    /**
763     * Restores the previous state, if it exists.
764     *
765     * @param savedState The previous state.
766     */
767    private void restoreState(Bundle savedState) {
768        if (savedState == null) {
769            return;
770        }
771
772        State state = intToState(savedState.getInt(RUNTIME_STATE, State.WORKSPACE.ordinal()));
773        if (state == State.APPS_CUSTOMIZE) {
774            showAllApps(false);
775        }
776
777        int currentScreen = savedState.getInt(RUNTIME_STATE_CURRENT_SCREEN, -1);
778        if (currentScreen > -1) {
779            mWorkspace.setCurrentPage(currentScreen);
780        }
781
782        final long pendingAddContainer = savedState.getLong(RUNTIME_STATE_PENDING_ADD_CONTAINER, -1);
783        final int pendingAddScreen = savedState.getInt(RUNTIME_STATE_PENDING_ADD_SCREEN, -1);
784
785        if (pendingAddContainer != ItemInfo.NO_ID && pendingAddScreen > -1) {
786            mPendingAddInfo.container = pendingAddContainer;
787            mPendingAddInfo.screen = pendingAddScreen;
788            mPendingAddInfo.cellX = savedState.getInt(RUNTIME_STATE_PENDING_ADD_CELL_X);
789            mPendingAddInfo.cellY = savedState.getInt(RUNTIME_STATE_PENDING_ADD_CELL_Y);
790            mRestoring = true;
791        }
792
793        boolean renameFolder = savedState.getBoolean(RUNTIME_STATE_PENDING_FOLDER_RENAME, false);
794        if (renameFolder) {
795            long id = savedState.getLong(RUNTIME_STATE_PENDING_FOLDER_RENAME_ID);
796            mFolderInfo = mModel.getFolderById(this, sFolders, id);
797            mRestoring = true;
798        }
799
800
801        // Restore the AppsCustomize tab
802        if (mAppsCustomizeTabHost != null) {
803            String curTab = savedState.getString("apps_customize_currentTab");
804            if (curTab != null) {
805                // We set this directly so that there is no delay before the tab is set
806                mAppsCustomizeContent.setContentType(
807                        mAppsCustomizeTabHost.getContentTypeForTabTag(curTab));
808                mAppsCustomizeTabHost.setCurrentTabByTag(curTab);
809                mAppsCustomizeContent.loadAssociatedPages(
810                        mAppsCustomizeContent.getCurrentPage());
811            }
812
813            int currentIndex = savedState.getInt("apps_customize_currentIndex");
814            mAppsCustomizeContent.restorePageForIndex(currentIndex);
815        }
816    }
817
818    /**
819     * Finds all the views we need and configure them properly.
820     */
821    private void setupViews() {
822        final DragController dragController = mDragController;
823
824        mDragLayer = (DragLayer) findViewById(R.id.drag_layer);
825        mWorkspace = (Workspace) mDragLayer.findViewById(R.id.workspace);
826        mQsbDivider = (ImageView) findViewById(R.id.qsb_divider);
827        mDockDivider = (ImageView) findViewById(R.id.dock_divider);
828
829        // Setup the drag layer
830        mDragLayer.setup(this, dragController);
831
832        // Setup the hotseat
833        mHotseat = (Hotseat) findViewById(R.id.hotseat);
834        if (mHotseat != null) {
835            mHotseat.setup(this);
836        }
837
838        // Setup the workspace
839        mWorkspace.setHapticFeedbackEnabled(false);
840        mWorkspace.setOnLongClickListener(this);
841        mWorkspace.setup(dragController);
842        dragController.addDragListener(mWorkspace);
843
844        // Get the search/delete bar
845        mSearchDropTargetBar = (SearchDropTargetBar) mDragLayer.findViewById(R.id.qsb_bar);
846
847        // Setup AppsCustomize
848        mAppsCustomizeTabHost = (AppsCustomizeTabHost)
849                findViewById(R.id.apps_customize_pane);
850        mAppsCustomizeContent = (AppsCustomizePagedView)
851                mAppsCustomizeTabHost.findViewById(R.id.apps_customize_pane_content);
852        mAppsCustomizeTabHost.setup(this);
853        mAppsCustomizeContent.setup(this, dragController);
854
855        // Get the all apps button
856        mAllAppsButton = findViewById(R.id.all_apps_button);
857        if (mAllAppsButton != null) {
858            mAllAppsButton.setOnTouchListener(new View.OnTouchListener() {
859                @Override
860                public boolean onTouch(View v, MotionEvent event) {
861                    if ((event.getAction() & MotionEvent.ACTION_MASK) == MotionEvent.ACTION_DOWN) {
862                        onTouchDownAllAppsButton(v);
863                    }
864                    return false;
865                }
866            });
867        }
868        // Setup the drag controller (drop targets have to be added in reverse order in priority)
869        dragController.setDragScoller(mWorkspace);
870        dragController.setScrollView(mDragLayer);
871        dragController.setMoveTarget(mWorkspace);
872        dragController.addDropTarget(mWorkspace);
873        if (mSearchDropTargetBar != null) {
874            mSearchDropTargetBar.setup(this, dragController);
875        }
876    }
877
878    /**
879     * Creates a view representing a shortcut.
880     *
881     * @param info The data structure describing the shortcut.
882     *
883     * @return A View inflated from R.layout.application.
884     */
885    View createShortcut(ShortcutInfo info) {
886        return createShortcut(R.layout.application,
887                (ViewGroup) mWorkspace.getChildAt(mWorkspace.getCurrentPage()), info);
888    }
889
890    /**
891     * Creates a view representing a shortcut inflated from the specified resource.
892     *
893     * @param layoutResId The id of the XML layout used to create the shortcut.
894     * @param parent The group the shortcut belongs to.
895     * @param info The data structure describing the shortcut.
896     *
897     * @return A View inflated from layoutResId.
898     */
899    View createShortcut(int layoutResId, ViewGroup parent, ShortcutInfo info) {
900        BubbleTextView favorite = (BubbleTextView) mInflater.inflate(layoutResId, parent, false);
901        favorite.applyFromShortcutInfo(info, mIconCache);
902        favorite.setOnClickListener(this);
903        return favorite;
904    }
905
906    /**
907     * Add an application shortcut to the workspace.
908     *
909     * @param data The intent describing the application.
910     * @param cellInfo The position on screen where to create the shortcut.
911     */
912    void completeAddApplication(Intent data, long container, int screen, int cellX, int cellY) {
913        final int[] cellXY = mTmpAddItemCellCoordinates;
914        final CellLayout layout = getCellLayout(container, screen);
915
916        // First we check if we already know the exact location where we want to add this item.
917        if (cellX >= 0 && cellY >= 0) {
918            cellXY[0] = cellX;
919            cellXY[1] = cellY;
920        } else if (!layout.findCellForSpan(cellXY, 1, 1)) {
921            showOutOfSpaceMessage(isHotseatLayout(layout));
922            return;
923        }
924
925        final ShortcutInfo info = mModel.getShortcutInfo(getPackageManager(), data, this);
926
927        if (info != null) {
928            info.setActivity(data.getComponent(), Intent.FLAG_ACTIVITY_NEW_TASK |
929                    Intent.FLAG_ACTIVITY_RESET_TASK_IF_NEEDED);
930            info.container = ItemInfo.NO_ID;
931            mWorkspace.addApplicationShortcut(info, layout, container, screen, cellXY[0], cellXY[1],
932                    isWorkspaceLocked(), cellX, cellY);
933        } else {
934            Log.e(TAG, "Couldn't find ActivityInfo for selected application: " + data);
935        }
936    }
937
938    /**
939     * Add a shortcut to the workspace.
940     *
941     * @param data The intent describing the shortcut.
942     * @param cellInfo The position on screen where to create the shortcut.
943     */
944    private void completeAddShortcut(Intent data, long container, int screen, int cellX,
945            int cellY) {
946        int[] cellXY = mTmpAddItemCellCoordinates;
947        int[] touchXY = mPendingAddInfo.dropPos;
948        CellLayout layout = getCellLayout(container, screen);
949
950        boolean foundCellSpan = false;
951
952        ShortcutInfo info = mModel.infoFromShortcutIntent(this, data, null);
953        if (info == null) {
954            return;
955        }
956        final View view = createShortcut(info);
957
958        // First we check if we already know the exact location where we want to add this item.
959        if (cellX >= 0 && cellY >= 0) {
960            cellXY[0] = cellX;
961            cellXY[1] = cellY;
962            foundCellSpan = true;
963
964            // If appropriate, either create a folder or add to an existing folder
965            if (mWorkspace.createUserFolderIfNecessary(view, container, layout, cellXY, 0,
966                    true, null,null)) {
967                return;
968            }
969            DragObject dragObject = new DragObject();
970            dragObject.dragInfo = info;
971            if (mWorkspace.addToExistingFolderIfNecessary(view, layout, cellXY, 0, dragObject,
972                    true)) {
973                return;
974            }
975        } else if (touchXY != null) {
976            // when dragging and dropping, just find the closest free spot
977            int[] result = layout.findNearestVacantArea(touchXY[0], touchXY[1], 1, 1, cellXY);
978            foundCellSpan = (result != null);
979        } else {
980            foundCellSpan = layout.findCellForSpan(cellXY, 1, 1);
981        }
982
983        if (!foundCellSpan) {
984            showOutOfSpaceMessage(isHotseatLayout(layout));
985            return;
986        }
987
988        LauncherModel.addItemToDatabase(this, info, container, screen, cellXY[0], cellXY[1], false);
989
990        if (!mRestoring) {
991            mWorkspace.addInScreen(view, container, screen, cellXY[0], cellXY[1], 1, 1,
992                    isWorkspaceLocked());
993        }
994    }
995
996    static int[] getSpanForWidget(Context context, ComponentName component, int minWidth,
997            int minHeight) {
998        Rect padding = AppWidgetHostView.getDefaultPaddingForWidget(context, component, null);
999        // We want to account for the extra amount of padding that we are adding to the widget
1000        // to ensure that it gets the full amount of space that it has requested
1001        int requiredWidth = minWidth + padding.left + padding.right;
1002        int requiredHeight = minHeight + padding.top + padding.bottom;
1003        return CellLayout.rectToCell(context.getResources(), requiredWidth, requiredHeight, null);
1004    }
1005
1006    static int[] getSpanForWidget(Context context, AppWidgetProviderInfo info) {
1007        return getSpanForWidget(context, info.provider, info.minWidth, info.minHeight);
1008    }
1009
1010    static int[] getMinSpanForWidget(Context context, AppWidgetProviderInfo info) {
1011        return getSpanForWidget(context, info.provider, info.minResizeWidth, info.minResizeHeight);
1012    }
1013
1014    static int[] getSpanForWidget(Context context, PendingAddWidgetInfo info) {
1015        return getSpanForWidget(context, info.componentName, info.minWidth, info.minHeight);
1016    }
1017
1018    static int[] getMinSpanForWidget(Context context, PendingAddWidgetInfo info) {
1019        return getSpanForWidget(context, info.componentName, info.minResizeWidth,
1020                info.minResizeHeight);
1021    }
1022
1023    /**
1024     * Add a widget to the workspace.
1025     *
1026     * @param appWidgetId The app widget id
1027     * @param cellInfo The position on screen where to create the widget.
1028     */
1029    private void completeAddAppWidget(final int appWidgetId, long container, int screen,
1030            AppWidgetHostView hostView, AppWidgetProviderInfo appWidgetInfo) {
1031        if (appWidgetInfo == null) {
1032            appWidgetInfo = mAppWidgetManager.getAppWidgetInfo(appWidgetId);
1033        }
1034
1035        // Calculate the grid spans needed to fit this widget
1036        CellLayout layout = getCellLayout(container, screen);
1037
1038        int[] minSpanXY = getMinSpanForWidget(this, appWidgetInfo);
1039        int[] spanXY = getSpanForWidget(this, appWidgetInfo);
1040
1041        // Try finding open space on Launcher screen
1042        // We have saved the position to which the widget was dragged-- this really only matters
1043        // if we are placing widgets on a "spring-loaded" screen
1044        int[] cellXY = mTmpAddItemCellCoordinates;
1045        int[] touchXY = mPendingAddInfo.dropPos;
1046        int[] finalSpan = new int[2];
1047        boolean foundCellSpan = false;
1048        if (mPendingAddInfo.cellX >= 0 && mPendingAddInfo.cellY >= 0) {
1049            cellXY[0] = mPendingAddInfo.cellX;
1050            cellXY[1] = mPendingAddInfo.cellY;
1051            spanXY[0] = mPendingAddInfo.spanX;
1052            spanXY[1] = mPendingAddInfo.spanY;
1053            foundCellSpan = true;
1054        } else if (touchXY != null) {
1055            // when dragging and dropping, just find the closest free spot
1056            int[] result = layout.findNearestVacantArea(
1057                    touchXY[0], touchXY[1], minSpanXY[0], minSpanXY[1], spanXY[0],
1058                    spanXY[1], cellXY, finalSpan);
1059            spanXY[0] = finalSpan[0];
1060            spanXY[1] = finalSpan[1];
1061            foundCellSpan = (result != null);
1062        } else {
1063            foundCellSpan = layout.findCellForSpan(cellXY, minSpanXY[0], minSpanXY[1]);
1064        }
1065
1066        if (!foundCellSpan) {
1067            if (appWidgetId != -1) {
1068                // Deleting an app widget ID is a void call but writes to disk before returning
1069                // to the caller...
1070                new Thread("deleteAppWidgetId") {
1071                    public void run() {
1072                        mAppWidgetHost.deleteAppWidgetId(appWidgetId);
1073                    }
1074                }.start();
1075            }
1076            showOutOfSpaceMessage(isHotseatLayout(layout));
1077            return;
1078        }
1079
1080        // Build Launcher-specific widget info and save to database
1081        LauncherAppWidgetInfo launcherInfo = new LauncherAppWidgetInfo(appWidgetId,
1082                appWidgetInfo.provider);
1083        launcherInfo.spanX = spanXY[0];
1084        launcherInfo.spanY = spanXY[1];
1085        launcherInfo.minSpanX = mPendingAddInfo.minSpanX;
1086        launcherInfo.minSpanY = mPendingAddInfo.minSpanY;
1087
1088        LauncherModel.addItemToDatabase(this, launcherInfo,
1089                container, screen, cellXY[0], cellXY[1], false);
1090
1091        if (!mRestoring) {
1092            if (hostView == null) {
1093                // Perform actual inflation because we're live
1094                launcherInfo.hostView = mAppWidgetHost.createView(this, appWidgetId, appWidgetInfo);
1095                launcherInfo.hostView.setAppWidget(appWidgetId, appWidgetInfo);
1096            } else {
1097                // The AppWidgetHostView has already been inflated and instantiated
1098                launcherInfo.hostView = hostView;
1099            }
1100
1101            launcherInfo.hostView.setTag(launcherInfo);
1102            launcherInfo.hostView.setVisibility(View.VISIBLE);
1103            AppWidgetResizeFrame.updateWidgetSizeRanges(launcherInfo.hostView,
1104                    this, launcherInfo.spanX, launcherInfo.spanY);
1105            mWorkspace.addInScreen(launcherInfo.hostView, container, screen, cellXY[0], cellXY[1],
1106                    launcherInfo.spanX, launcherInfo.spanY, isWorkspaceLocked());
1107
1108            addWidgetToAutoAdvanceIfNeeded(launcherInfo.hostView, appWidgetInfo);
1109        }
1110        resetAddInfo();
1111    }
1112
1113    private final BroadcastReceiver mReceiver = new BroadcastReceiver() {
1114        @Override
1115        public void onReceive(Context context, Intent intent) {
1116            final String action = intent.getAction();
1117            if (Intent.ACTION_SCREEN_OFF.equals(action)) {
1118                mUserPresent = false;
1119                mDragLayer.clearAllResizeFrames();
1120                updateRunning();
1121
1122                // Reset AllApps to its initial state only if we are not in the middle of
1123                // processing a multi-step drop
1124                if (mAppsCustomizeTabHost != null && mPendingAddInfo.container == ItemInfo.NO_ID) {
1125                    mAppsCustomizeTabHost.reset();
1126                    showWorkspace(false);
1127                }
1128            } else if (Intent.ACTION_USER_PRESENT.equals(action)) {
1129                mUserPresent = true;
1130                updateRunning();
1131            }
1132        }
1133    };
1134
1135    @Override
1136    public void onAttachedToWindow() {
1137        super.onAttachedToWindow();
1138
1139        // Listen for broadcasts related to user-presence
1140        final IntentFilter filter = new IntentFilter();
1141        filter.addAction(Intent.ACTION_SCREEN_OFF);
1142        filter.addAction(Intent.ACTION_USER_PRESENT);
1143        registerReceiver(mReceiver, filter);
1144
1145        mAttached = true;
1146        mVisible = true;
1147    }
1148
1149    @Override
1150    public void onDetachedFromWindow() {
1151        super.onDetachedFromWindow();
1152        mVisible = false;
1153
1154        if (mAttached) {
1155            unregisterReceiver(mReceiver);
1156            mAttached = false;
1157        }
1158        updateRunning();
1159    }
1160
1161    public void onWindowVisibilityChanged(int visibility) {
1162        mVisible = visibility == View.VISIBLE;
1163        updateRunning();
1164        // The following code used to be in onResume, but it turns out onResume is called when
1165        // you're in All Apps and click home to go to the workspace. onWindowVisibilityChanged
1166        // is a more appropriate event to handle
1167        if (mVisible) {
1168            mAppsCustomizeTabHost.onWindowVisible();
1169            if (!mWorkspaceLoading) {
1170                final ViewTreeObserver observer = mWorkspace.getViewTreeObserver();
1171                // We want to let Launcher draw itself at least once before we force it to build
1172                // layers on all the workspace pages, so that transitioning to Launcher from other
1173                // apps is nice and speedy. Usually the first call to preDraw doesn't correspond to
1174                // a true draw so we wait until the second preDraw call to be safe
1175                observer.addOnPreDrawListener(new ViewTreeObserver.OnPreDrawListener() {
1176                    public boolean onPreDraw() {
1177                        // We delay the layer building a bit in order to give
1178                        // other message processing a time to run.  In particular
1179                        // this avoids a delay in hiding the IME if it was
1180                        // currently shown, because doing that may involve
1181                        // some communication back with the app.
1182                        mWorkspace.postDelayed(mBuildLayersRunnable, 500);
1183
1184                        // We had to enable the wallpaper visibility when launching apps from all
1185                        // apps (so that the transitions would be the same as when launching from
1186                        // workspace) so take this time to see if we need to re-disable the
1187                        // wallpaper visibility to ensure performance.
1188                        mWorkspace.post(new Runnable() {
1189                            @Override
1190                            public void run() {
1191                                if (mState == State.APPS_CUSTOMIZE) {
1192                                    if (mAppsCustomizeTabHost != null &&
1193                                            !mAppsCustomizeTabHost.isTransitioning()) {
1194                                        updateWallpaperVisibility(false);
1195                                    }
1196                                }
1197                            }
1198                        });
1199
1200                        observer.removeOnPreDrawListener(this);
1201                        return true;
1202                    }
1203                });
1204            }
1205            // When Launcher comes back to foreground, a different Activity might be responsible for
1206            // the app market intent, so refresh the icon
1207            updateAppMarketIcon();
1208            clearTypedText();
1209        }
1210    }
1211
1212    private void sendAdvanceMessage(long delay) {
1213        mHandler.removeMessages(ADVANCE_MSG);
1214        Message msg = mHandler.obtainMessage(ADVANCE_MSG);
1215        mHandler.sendMessageDelayed(msg, delay);
1216        mAutoAdvanceSentTime = System.currentTimeMillis();
1217    }
1218
1219    private void updateRunning() {
1220        boolean autoAdvanceRunning = mVisible && mUserPresent && !mWidgetsToAdvance.isEmpty();
1221        if (autoAdvanceRunning != mAutoAdvanceRunning) {
1222            mAutoAdvanceRunning = autoAdvanceRunning;
1223            if (autoAdvanceRunning) {
1224                long delay = mAutoAdvanceTimeLeft == -1 ? mAdvanceInterval : mAutoAdvanceTimeLeft;
1225                sendAdvanceMessage(delay);
1226            } else {
1227                if (!mWidgetsToAdvance.isEmpty()) {
1228                    mAutoAdvanceTimeLeft = Math.max(0, mAdvanceInterval -
1229                            (System.currentTimeMillis() - mAutoAdvanceSentTime));
1230                }
1231                mHandler.removeMessages(ADVANCE_MSG);
1232                mHandler.removeMessages(0); // Remove messages sent using postDelayed()
1233            }
1234        }
1235    }
1236
1237    private final Handler mHandler = new Handler() {
1238        @Override
1239        public void handleMessage(Message msg) {
1240            if (msg.what == ADVANCE_MSG) {
1241                int i = 0;
1242                for (View key: mWidgetsToAdvance.keySet()) {
1243                    final View v = key.findViewById(mWidgetsToAdvance.get(key).autoAdvanceViewId);
1244                    final int delay = mAdvanceStagger * i;
1245                    if (v instanceof Advanceable) {
1246                       postDelayed(new Runnable() {
1247                           public void run() {
1248                               ((Advanceable) v).advance();
1249                           }
1250                       }, delay);
1251                    }
1252                    i++;
1253                }
1254                sendAdvanceMessage(mAdvanceInterval);
1255            }
1256        }
1257    };
1258
1259    void addWidgetToAutoAdvanceIfNeeded(View hostView, AppWidgetProviderInfo appWidgetInfo) {
1260        if (appWidgetInfo == null || appWidgetInfo.autoAdvanceViewId == -1) return;
1261        View v = hostView.findViewById(appWidgetInfo.autoAdvanceViewId);
1262        if (v instanceof Advanceable) {
1263            mWidgetsToAdvance.put(hostView, appWidgetInfo);
1264            ((Advanceable) v).fyiWillBeAdvancedByHostKThx();
1265            updateRunning();
1266        }
1267    }
1268
1269    void removeWidgetToAutoAdvance(View hostView) {
1270        if (mWidgetsToAdvance.containsKey(hostView)) {
1271            mWidgetsToAdvance.remove(hostView);
1272            updateRunning();
1273        }
1274    }
1275
1276    public void removeAppWidget(LauncherAppWidgetInfo launcherInfo) {
1277        removeWidgetToAutoAdvance(launcherInfo.hostView);
1278        launcherInfo.hostView = null;
1279    }
1280
1281    void showOutOfSpaceMessage(boolean isHotseatLayout) {
1282        int strId = (isHotseatLayout ? R.string.hotseat_out_of_space : R.string.out_of_space);
1283        Toast.makeText(this, getString(strId), Toast.LENGTH_SHORT).show();
1284    }
1285
1286    public LauncherAppWidgetHost getAppWidgetHost() {
1287        return mAppWidgetHost;
1288    }
1289
1290    public LauncherModel getModel() {
1291        return mModel;
1292    }
1293
1294    void closeSystemDialogs() {
1295        getWindow().closeAllPanels();
1296
1297        // Whatever we were doing is hereby canceled.
1298        mWaitingForResult = false;
1299    }
1300
1301    @Override
1302    protected void onNewIntent(Intent intent) {
1303        super.onNewIntent(intent);
1304
1305        // Close the menu
1306        if (Intent.ACTION_MAIN.equals(intent.getAction())) {
1307            // also will cancel mWaitingForResult.
1308            closeSystemDialogs();
1309
1310            boolean alreadyOnHome = ((intent.getFlags() & Intent.FLAG_ACTIVITY_BROUGHT_TO_FRONT)
1311                        != Intent.FLAG_ACTIVITY_BROUGHT_TO_FRONT);
1312
1313            Folder openFolder = mWorkspace.getOpenFolder();
1314            // In all these cases, only animate if we're already on home
1315            mWorkspace.exitWidgetResizeMode();
1316            if (alreadyOnHome && mState == State.WORKSPACE && !mWorkspace.isTouchActive() &&
1317                    openFolder == null) {
1318                mWorkspace.moveToDefaultScreen(true);
1319            }
1320
1321            closeFolder();
1322            exitSpringLoadedDragMode();
1323            showWorkspace(alreadyOnHome);
1324
1325            final View v = getWindow().peekDecorView();
1326            if (v != null && v.getWindowToken() != null) {
1327                InputMethodManager imm = (InputMethodManager)getSystemService(
1328                        INPUT_METHOD_SERVICE);
1329                imm.hideSoftInputFromWindow(v.getWindowToken(), 0);
1330            }
1331
1332            // Reset AllApps to its initial state
1333            if (!alreadyOnHome && mAppsCustomizeTabHost != null) {
1334                mAppsCustomizeTabHost.reset();
1335            }
1336        }
1337    }
1338
1339    @Override
1340    protected void onRestoreInstanceState(Bundle savedInstanceState) {
1341        // Do not call super here
1342        mSavedInstanceState = savedInstanceState;
1343    }
1344
1345    @Override
1346    protected void onSaveInstanceState(Bundle outState) {
1347        outState.putInt(RUNTIME_STATE_CURRENT_SCREEN, mWorkspace.getCurrentPage());
1348        super.onSaveInstanceState(outState);
1349
1350        outState.putInt(RUNTIME_STATE, mState.ordinal());
1351        // We close any open folder since it will not be re-opened, and we need to make sure
1352        // this state is reflected.
1353        closeFolder();
1354
1355        if (mPendingAddInfo.container != ItemInfo.NO_ID && mPendingAddInfo.screen > -1 &&
1356                mWaitingForResult) {
1357            outState.putLong(RUNTIME_STATE_PENDING_ADD_CONTAINER, mPendingAddInfo.container);
1358            outState.putInt(RUNTIME_STATE_PENDING_ADD_SCREEN, mPendingAddInfo.screen);
1359            outState.putInt(RUNTIME_STATE_PENDING_ADD_CELL_X, mPendingAddInfo.cellX);
1360            outState.putInt(RUNTIME_STATE_PENDING_ADD_CELL_Y, mPendingAddInfo.cellY);
1361        }
1362
1363        if (mFolderInfo != null && mWaitingForResult) {
1364            outState.putBoolean(RUNTIME_STATE_PENDING_FOLDER_RENAME, true);
1365            outState.putLong(RUNTIME_STATE_PENDING_FOLDER_RENAME_ID, mFolderInfo.id);
1366        }
1367
1368        // Save the current AppsCustomize tab
1369        if (mAppsCustomizeTabHost != null) {
1370            String currentTabTag = mAppsCustomizeTabHost.getCurrentTabTag();
1371            if (currentTabTag != null) {
1372                outState.putString("apps_customize_currentTab", currentTabTag);
1373            }
1374            int currentIndex = mAppsCustomizeContent.getSaveInstanceStateIndex();
1375            outState.putInt("apps_customize_currentIndex", currentIndex);
1376        }
1377    }
1378
1379    @Override
1380    public void onDestroy() {
1381        super.onDestroy();
1382
1383        // Remove all pending runnables
1384        mHandler.removeMessages(ADVANCE_MSG);
1385        mHandler.removeMessages(0);
1386        mWorkspace.removeCallbacks(mBuildLayersRunnable);
1387
1388        // Stop callbacks from LauncherModel
1389        LauncherApplication app = ((LauncherApplication) getApplication());
1390        mModel.stopLoader();
1391        app.setLauncher(null);
1392
1393        try {
1394            mAppWidgetHost.stopListening();
1395        } catch (NullPointerException ex) {
1396            Log.w(TAG, "problem while stopping AppWidgetHost during Launcher destruction", ex);
1397        }
1398        mAppWidgetHost = null;
1399
1400        mWidgetsToAdvance.clear();
1401
1402        TextKeyListener.getInstance().release();
1403
1404
1405        unbindWorkspaceAndHotseatItems();
1406
1407        getContentResolver().unregisterContentObserver(mWidgetObserver);
1408        unregisterReceiver(mCloseSystemDialogsReceiver);
1409
1410        mDragLayer.clearAllResizeFrames();
1411        ((ViewGroup) mWorkspace.getParent()).removeAllViews();
1412        mWorkspace.removeAllViews();
1413        mWorkspace = null;
1414        mDragController = null;
1415
1416        ValueAnimator.clearAllAnimations();
1417    }
1418
1419    public DragController getDragController() {
1420        return mDragController;
1421    }
1422
1423    @Override
1424    public void startActivityForResult(Intent intent, int requestCode) {
1425        if (requestCode >= 0) mWaitingForResult = true;
1426        super.startActivityForResult(intent, requestCode);
1427    }
1428
1429    /**
1430     * Indicates that we want global search for this activity by setting the globalSearch
1431     * argument for {@link #startSearch} to true.
1432     */
1433    @Override
1434    public void startSearch(String initialQuery, boolean selectInitialQuery,
1435            Bundle appSearchData, boolean globalSearch) {
1436
1437        showWorkspace(true);
1438
1439        if (initialQuery == null) {
1440            // Use any text typed in the launcher as the initial query
1441            initialQuery = getTypedText();
1442        }
1443        if (appSearchData == null) {
1444            appSearchData = new Bundle();
1445            appSearchData.putString(Search.SOURCE, "launcher-search");
1446        }
1447        Rect sourceBounds = mSearchDropTargetBar.getSearchBarBounds();
1448
1449        final SearchManager searchManager =
1450                (SearchManager) getSystemService(Context.SEARCH_SERVICE);
1451        searchManager.startSearch(initialQuery, selectInitialQuery, getComponentName(),
1452            appSearchData, globalSearch, sourceBounds);
1453    }
1454
1455    @Override
1456    public boolean onCreateOptionsMenu(Menu menu) {
1457        if (isWorkspaceLocked()) {
1458            return false;
1459        }
1460
1461        super.onCreateOptionsMenu(menu);
1462
1463        Intent manageApps = new Intent(Settings.ACTION_MANAGE_ALL_APPLICATIONS_SETTINGS);
1464        manageApps.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK
1465                | Intent.FLAG_ACTIVITY_EXCLUDE_FROM_RECENTS);
1466        Intent settings = new Intent(android.provider.Settings.ACTION_SETTINGS);
1467        settings.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK
1468                | Intent.FLAG_ACTIVITY_RESET_TASK_IF_NEEDED);
1469        String helpUrl = getString(R.string.help_url);
1470        Intent help = new Intent(Intent.ACTION_VIEW, Uri.parse(helpUrl));
1471        help.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK
1472                | Intent.FLAG_ACTIVITY_EXCLUDE_FROM_RECENTS);
1473
1474        menu.add(MENU_GROUP_WALLPAPER, MENU_WALLPAPER_SETTINGS, 0, R.string.menu_wallpaper)
1475            .setIcon(android.R.drawable.ic_menu_gallery)
1476            .setAlphabeticShortcut('W');
1477        menu.add(0, MENU_MANAGE_APPS, 0, R.string.menu_manage_apps)
1478            .setIcon(android.R.drawable.ic_menu_manage)
1479            .setIntent(manageApps)
1480            .setAlphabeticShortcut('M');
1481        menu.add(0, MENU_SYSTEM_SETTINGS, 0, R.string.menu_settings)
1482            .setIcon(android.R.drawable.ic_menu_preferences)
1483            .setIntent(settings)
1484            .setAlphabeticShortcut('P');
1485        if (!helpUrl.isEmpty()) {
1486            menu.add(0, MENU_HELP, 0, R.string.menu_help)
1487                .setIcon(android.R.drawable.ic_menu_help)
1488                .setIntent(help)
1489                .setAlphabeticShortcut('H');
1490        }
1491        return true;
1492    }
1493
1494    @Override
1495    public boolean onPrepareOptionsMenu(Menu menu) {
1496        super.onPrepareOptionsMenu(menu);
1497
1498        if (mAppsCustomizeTabHost.isTransitioning()) {
1499            return false;
1500        }
1501        boolean allAppsVisible = (mAppsCustomizeTabHost.getVisibility() == View.VISIBLE);
1502        menu.setGroupVisible(MENU_GROUP_WALLPAPER, !allAppsVisible);
1503
1504        return true;
1505    }
1506
1507    @Override
1508    public boolean onOptionsItemSelected(MenuItem item) {
1509        switch (item.getItemId()) {
1510        case MENU_WALLPAPER_SETTINGS:
1511            startWallpaper();
1512            return true;
1513        }
1514
1515        return super.onOptionsItemSelected(item);
1516    }
1517
1518    @Override
1519    public boolean onSearchRequested() {
1520        startSearch(null, false, null, true);
1521        // Use a custom animation for launching search
1522        overridePendingTransition(R.anim.fade_in_fast, R.anim.fade_out_fast);
1523        return true;
1524    }
1525
1526    public boolean isWorkspaceLocked() {
1527        return mWorkspaceLoading || mWaitingForResult;
1528    }
1529
1530    private void resetAddInfo() {
1531        mPendingAddInfo.container = ItemInfo.NO_ID;
1532        mPendingAddInfo.screen = -1;
1533        mPendingAddInfo.cellX = mPendingAddInfo.cellY = -1;
1534        mPendingAddInfo.spanX = mPendingAddInfo.spanY = -1;
1535        mPendingAddInfo.minSpanX = mPendingAddInfo.minSpanY = -1;
1536        mPendingAddInfo.dropPos = null;
1537    }
1538
1539    void addAppWidgetFromPick(Intent data) {
1540        // TODO: catch bad widget exception when sent
1541        int appWidgetId = data.getIntExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, -1);
1542        // TODO: Is this log message meaningful?
1543        if (LOGD) Log.d(TAG, "dumping extras content=" + data.getExtras());
1544        addAppWidgetImpl(appWidgetId, null);
1545    }
1546
1547    void addAppWidgetImpl(final int appWidgetId, final PendingAddWidgetInfo info) {
1548        final AppWidgetProviderInfo appWidget = info.info;
1549        if (appWidget.configure != null) {
1550            // Launch over to configure widget, if needed
1551            Intent intent = new Intent(AppWidgetManager.ACTION_APPWIDGET_CONFIGURE);
1552            intent.setComponent(appWidget.configure);
1553            intent.putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, appWidgetId);
1554            startActivityForResultSafely(intent, REQUEST_CREATE_APPWIDGET);
1555            mWidgetBeingBoundOrConfigured = info;
1556        } else {
1557            // Otherwise just add it
1558            completeAddAppWidget(appWidgetId, info.container, info.screen, info.boundWidget, appWidget);
1559            // Exit spring loaded mode if necessary after adding the widget
1560            exitSpringLoadedDragModeDelayed(true, false, null);
1561        }
1562    }
1563
1564    /**
1565     * Process a shortcut drop.
1566     *
1567     * @param componentName The name of the component
1568     * @param screen The screen where it should be added
1569     * @param cell The cell it should be added to, optional
1570     * @param position The location on the screen where it was dropped, optional
1571     */
1572    void processShortcutFromDrop(ComponentName componentName, long container, int screen,
1573            int[] cell, int[] loc) {
1574        resetAddInfo();
1575        mPendingAddInfo.container = container;
1576        mPendingAddInfo.screen = screen;
1577        mPendingAddInfo.dropPos = loc;
1578
1579        if (cell != null) {
1580            mPendingAddInfo.cellX = cell[0];
1581            mPendingAddInfo.cellY = cell[1];
1582        }
1583
1584        Intent createShortcutIntent = new Intent(Intent.ACTION_CREATE_SHORTCUT);
1585        createShortcutIntent.setComponent(componentName);
1586        processShortcut(createShortcutIntent);
1587    }
1588
1589    /**
1590     * Process a widget drop.
1591     *
1592     * @param info The PendingAppWidgetInfo of the widget being added.
1593     * @param screen The screen where it should be added
1594     * @param cell The cell it should be added to, optional
1595     * @param position The location on the screen where it was dropped, optional
1596     */
1597    void addAppWidgetFromDrop(PendingAddWidgetInfo info, long container, int screen,
1598            int[] cell, int[] span, int[] loc) {
1599        resetAddInfo();
1600        mPendingAddInfo.container = info.container = container;
1601        mPendingAddInfo.screen = info.screen = screen;
1602        mPendingAddInfo.dropPos = loc;
1603        mPendingAddInfo.minSpanX = info.minSpanX;
1604        mPendingAddInfo.minSpanY = info.minSpanY;
1605
1606        if (cell != null) {
1607            mPendingAddInfo.cellX = cell[0];
1608            mPendingAddInfo.cellY = cell[1];
1609        }
1610        if (span != null) {
1611            mPendingAddInfo.spanX = span[0];
1612            mPendingAddInfo.spanY = span[1];
1613        }
1614
1615        AppWidgetHostView hostView = info.boundWidget;
1616        int appWidgetId;
1617        if (hostView != null) {
1618            appWidgetId = hostView.getAppWidgetId();
1619            addAppWidgetImpl(appWidgetId, info);
1620        } else {
1621            appWidgetId = getAppWidgetHost().allocateAppWidgetId();
1622            mWidgetBeingBoundOrConfigured = info;
1623            if (mAppWidgetManager.bindAppWidgetIdIfAllowed(appWidgetId, info.componentName)) {
1624                addAppWidgetImpl(appWidgetId, info);
1625            } else {
1626                Intent intent = new Intent(AppWidgetManager.ACTION_APPWIDGET_BIND);
1627                intent.putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, appWidgetId);
1628                intent.putExtra(AppWidgetManager.EXTRA_APPWIDGET_PROVIDER, info.componentName);
1629                startActivityForResult(intent, REQUEST_BIND_APPWIDGET);
1630            }
1631        }
1632    }
1633
1634    void processShortcut(Intent intent) {
1635        // Handle case where user selected "Applications"
1636        String applicationName = getResources().getString(R.string.group_applications);
1637        String shortcutName = intent.getStringExtra(Intent.EXTRA_SHORTCUT_NAME);
1638
1639        if (applicationName != null && applicationName.equals(shortcutName)) {
1640            Intent mainIntent = new Intent(Intent.ACTION_MAIN, null);
1641            mainIntent.addCategory(Intent.CATEGORY_LAUNCHER);
1642
1643            Intent pickIntent = new Intent(Intent.ACTION_PICK_ACTIVITY);
1644            pickIntent.putExtra(Intent.EXTRA_INTENT, mainIntent);
1645            pickIntent.putExtra(Intent.EXTRA_TITLE, getText(R.string.title_select_application));
1646            startActivityForResultSafely(pickIntent, REQUEST_PICK_APPLICATION);
1647        } else {
1648            startActivityForResultSafely(intent, REQUEST_CREATE_SHORTCUT);
1649        }
1650    }
1651
1652    void processWallpaper(Intent intent) {
1653        startActivityForResult(intent, REQUEST_PICK_WALLPAPER);
1654    }
1655
1656    FolderIcon addFolder(CellLayout layout, long container, final int screen, int cellX,
1657            int cellY) {
1658        final FolderInfo folderInfo = new FolderInfo();
1659        folderInfo.title = getText(R.string.folder_name);
1660
1661        // Update the model
1662        LauncherModel.addItemToDatabase(Launcher.this, folderInfo, container, screen, cellX, cellY,
1663                false);
1664        sFolders.put(folderInfo.id, folderInfo);
1665
1666        // Create the view
1667        FolderIcon newFolder =
1668            FolderIcon.fromXml(R.layout.folder_icon, this, layout, folderInfo, mIconCache);
1669        mWorkspace.addInScreen(newFolder, container, screen, cellX, cellY, 1, 1,
1670                isWorkspaceLocked());
1671        return newFolder;
1672    }
1673
1674    void removeFolder(FolderInfo folder) {
1675        sFolders.remove(folder.id);
1676    }
1677
1678    private void startWallpaper() {
1679        showWorkspace(true);
1680        final Intent pickWallpaper = new Intent(Intent.ACTION_SET_WALLPAPER);
1681        Intent chooser = Intent.createChooser(pickWallpaper,
1682                getText(R.string.chooser_wallpaper));
1683        // NOTE: Adds a configure option to the chooser if the wallpaper supports it
1684        //       Removed in Eclair MR1
1685//        WallpaperManager wm = (WallpaperManager)
1686//                getSystemService(Context.WALLPAPER_SERVICE);
1687//        WallpaperInfo wi = wm.getWallpaperInfo();
1688//        if (wi != null && wi.getSettingsActivity() != null) {
1689//            LabeledIntent li = new LabeledIntent(getPackageName(),
1690//                    R.string.configure_wallpaper, 0);
1691//            li.setClassName(wi.getPackageName(), wi.getSettingsActivity());
1692//            chooser.putExtra(Intent.EXTRA_INITIAL_INTENTS, new Intent[] { li });
1693//        }
1694        startActivityForResult(chooser, REQUEST_PICK_WALLPAPER);
1695    }
1696
1697    /**
1698     * Registers various content observers. The current implementation registers
1699     * only a favorites observer to keep track of the favorites applications.
1700     */
1701    private void registerContentObservers() {
1702        ContentResolver resolver = getContentResolver();
1703        resolver.registerContentObserver(LauncherProvider.CONTENT_APPWIDGET_RESET_URI,
1704                true, mWidgetObserver);
1705    }
1706
1707    @Override
1708    public boolean dispatchKeyEvent(KeyEvent event) {
1709        if (event.getAction() == KeyEvent.ACTION_DOWN) {
1710            switch (event.getKeyCode()) {
1711                case KeyEvent.KEYCODE_HOME:
1712                    return true;
1713                case KeyEvent.KEYCODE_VOLUME_DOWN:
1714                    if (SystemProperties.getInt("debug.launcher2.dumpstate", 0) != 0) {
1715                        dumpState();
1716                        return true;
1717                    }
1718                    break;
1719            }
1720        } else if (event.getAction() == KeyEvent.ACTION_UP) {
1721            switch (event.getKeyCode()) {
1722                case KeyEvent.KEYCODE_HOME:
1723                    return true;
1724            }
1725        }
1726
1727        return super.dispatchKeyEvent(event);
1728    }
1729
1730    @Override
1731    public void onBackPressed() {
1732        if (mState == State.APPS_CUSTOMIZE) {
1733            showWorkspace(true);
1734        } else if (mWorkspace.getOpenFolder() != null) {
1735            Folder openFolder = mWorkspace.getOpenFolder();
1736            if (openFolder.isEditingName()) {
1737                openFolder.dismissEditingName();
1738            } else {
1739                closeFolder();
1740            }
1741        } else {
1742            mWorkspace.exitWidgetResizeMode();
1743
1744            // Back button is a no-op here, but give at least some feedback for the button press
1745            mWorkspace.showOutlinesTemporarily();
1746        }
1747    }
1748
1749    /**
1750     * Re-listen when widgets are reset.
1751     */
1752    private void onAppWidgetReset() {
1753        if (mAppWidgetHost != null) {
1754            mAppWidgetHost.startListening();
1755        }
1756    }
1757
1758    /**
1759     * Go through the and disconnect any of the callbacks in the drawables and the views or we
1760     * leak the previous Home screen on orientation change.
1761     */
1762    private void unbindWorkspaceAndHotseatItems() {
1763        if (mModel != null) {
1764            mModel.unbindWorkspaceItems();
1765        }
1766    }
1767
1768    /**
1769     * Launches the intent referred by the clicked shortcut.
1770     *
1771     * @param v The view representing the clicked shortcut.
1772     */
1773    public void onClick(View v) {
1774        // Make sure that rogue clicks don't get through while allapps is launching, or after the
1775        // view has detached (it's possible for this to happen if the view is removed mid touch).
1776        if (v.getWindowToken() == null) {
1777            return;
1778        }
1779
1780        if (!mWorkspace.isFinishedSwitchingState()) {
1781            return;
1782        }
1783
1784        Object tag = v.getTag();
1785        if (tag instanceof ShortcutInfo) {
1786            // Open shortcut
1787            final Intent intent = ((ShortcutInfo) tag).intent;
1788            int[] pos = new int[2];
1789            v.getLocationOnScreen(pos);
1790            intent.setSourceBounds(new Rect(pos[0], pos[1],
1791                    pos[0] + v.getWidth(), pos[1] + v.getHeight()));
1792
1793            boolean success = startActivitySafely(v, intent, tag);
1794
1795            if (success && v instanceof BubbleTextView) {
1796                mWaitingForResume = (BubbleTextView) v;
1797                mWaitingForResume.setStayPressed(true);
1798            }
1799        } else if (tag instanceof FolderInfo) {
1800            if (v instanceof FolderIcon) {
1801                FolderIcon fi = (FolderIcon) v;
1802                handleFolderClick(fi);
1803            }
1804        } else if (v == mAllAppsButton) {
1805            if (mState == State.APPS_CUSTOMIZE) {
1806                showWorkspace(true);
1807            } else {
1808                onClickAllAppsButton(v);
1809            }
1810        }
1811    }
1812
1813    public boolean onTouch(View v, MotionEvent event) {
1814        // this is an intercepted event being forwarded from mWorkspace;
1815        // clicking anywhere on the workspace causes the customization drawer to slide down
1816        showWorkspace(true);
1817        return false;
1818    }
1819
1820    /**
1821     * Event handler for the search button
1822     *
1823     * @param v The view that was clicked.
1824     */
1825    public void onClickSearchButton(View v) {
1826        v.performHapticFeedback(HapticFeedbackConstants.VIRTUAL_KEY);
1827
1828        onSearchRequested();
1829    }
1830
1831    /**
1832     * Event handler for the voice button
1833     *
1834     * @param v The view that was clicked.
1835     */
1836    public void onClickVoiceButton(View v) {
1837        v.performHapticFeedback(HapticFeedbackConstants.VIRTUAL_KEY);
1838
1839        try {
1840            final SearchManager searchManager =
1841                    (SearchManager) getSystemService(Context.SEARCH_SERVICE);
1842            ComponentName activityName = searchManager.getGlobalSearchActivity();
1843            Intent intent = new Intent(RecognizerIntent.ACTION_WEB_SEARCH);
1844            intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK
1845                    | Intent.FLAG_ACTIVITY_EXCLUDE_FROM_RECENTS);
1846            if (activityName != null) {
1847                intent.setPackage(activityName.getPackageName());
1848            }
1849            startActivitySafely(null, intent, "onClickVoiceButton");
1850        } catch (ActivityNotFoundException e) {
1851            Intent intent = new Intent(RecognizerIntent.ACTION_WEB_SEARCH);
1852            intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK
1853                    | Intent.FLAG_ACTIVITY_EXCLUDE_FROM_RECENTS);
1854            startActivitySafely(null, intent, "onClickVoiceButton");
1855        }
1856    }
1857
1858    /**
1859     * Event handler for the "grid" button that appears on the home screen, which
1860     * enters all apps mode.
1861     *
1862     * @param v The view that was clicked.
1863     */
1864    public void onClickAllAppsButton(View v) {
1865        showAllApps(true);
1866    }
1867
1868    public void onTouchDownAllAppsButton(View v) {
1869        // Provide the same haptic feedback that the system offers for virtual keys.
1870        v.performHapticFeedback(HapticFeedbackConstants.VIRTUAL_KEY);
1871    }
1872
1873    public void onClickAppMarketButton(View v) {
1874        if (mAppMarketIntent != null) {
1875            startActivitySafely(v, mAppMarketIntent, "app market");
1876        } else {
1877            Log.e(TAG, "Invalid app market intent.");
1878        }
1879    }
1880
1881    void startApplicationDetailsActivity(ComponentName componentName) {
1882        String packageName = componentName.getPackageName();
1883        Intent intent = new Intent(Settings.ACTION_APPLICATION_DETAILS_SETTINGS,
1884                Uri.fromParts("package", packageName, null));
1885        intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_EXCLUDE_FROM_RECENTS);
1886        startActivitySafely(null, intent, "startApplicationDetailsActivity");
1887    }
1888
1889    void startApplicationUninstallActivity(ApplicationInfo appInfo) {
1890        if ((appInfo.flags & ApplicationInfo.DOWNLOADED_FLAG) == 0) {
1891            // System applications cannot be installed. For now, show a toast explaining that.
1892            // We may give them the option of disabling apps this way.
1893            int messageId = R.string.uninstall_system_app_text;
1894            Toast.makeText(this, messageId, Toast.LENGTH_SHORT).show();
1895        } else {
1896            String packageName = appInfo.componentName.getPackageName();
1897            String className = appInfo.componentName.getClassName();
1898            Intent intent = new Intent(
1899                    Intent.ACTION_DELETE, Uri.fromParts("package", packageName, className));
1900            intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK |
1901                    Intent.FLAG_ACTIVITY_EXCLUDE_FROM_RECENTS);
1902            startActivity(intent);
1903        }
1904    }
1905
1906    boolean startActivitySafely(View v, Intent intent, Object tag) {
1907        intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
1908
1909        try {
1910            if (v != null) {
1911                ActivityOptions opts = ActivityOptions.makeScaleUpAnimation(v, 0, 0,
1912                        v.getMeasuredWidth(), v.getMeasuredHeight());
1913
1914                startActivity(intent, opts.toBundle());
1915            } else {
1916                startActivity(intent);
1917            }
1918            return true;
1919        } catch (ActivityNotFoundException e) {
1920            Toast.makeText(this, R.string.activity_not_found, Toast.LENGTH_SHORT).show();
1921            Log.e(TAG, "Unable to launch. tag=" + tag + " intent=" + intent, e);
1922        } catch (SecurityException e) {
1923            Toast.makeText(this, R.string.activity_not_found, Toast.LENGTH_SHORT).show();
1924            Log.e(TAG, "Launcher does not have the permission to launch " + intent +
1925                    ". Make sure to create a MAIN intent-filter for the corresponding activity " +
1926                    "or use the exported attribute for this activity. "
1927                    + "tag="+ tag + " intent=" + intent, e);
1928        }
1929        return false;
1930    }
1931
1932    void startActivityForResultSafely(Intent intent, int requestCode) {
1933        try {
1934            startActivityForResult(intent, requestCode);
1935        } catch (ActivityNotFoundException e) {
1936            Toast.makeText(this, R.string.activity_not_found, Toast.LENGTH_SHORT).show();
1937        } catch (SecurityException e) {
1938            Toast.makeText(this, R.string.activity_not_found, Toast.LENGTH_SHORT).show();
1939            Log.e(TAG, "Launcher does not have the permission to launch " + intent +
1940                    ". Make sure to create a MAIN intent-filter for the corresponding activity " +
1941                    "or use the exported attribute for this activity.", e);
1942        }
1943    }
1944
1945    private void handleFolderClick(FolderIcon folderIcon) {
1946        final FolderInfo info = folderIcon.mInfo;
1947        Folder openFolder = mWorkspace.getFolderForTag(info);
1948
1949        // If the folder info reports that the associated folder is open, then verify that
1950        // it is actually opened. There have been a few instances where this gets out of sync.
1951        if (info.opened && openFolder == null) {
1952            Log.d(TAG, "Folder info marked as open, but associated folder is not open. Screen: "
1953                    + info.screen + " (" + info.cellX + ", " + info.cellY + ")");
1954            info.opened = false;
1955        }
1956
1957        if (!info.opened) {
1958            // Close any open folder
1959            closeFolder();
1960            // Open the requested folder
1961            openFolder(folderIcon);
1962        } else {
1963            // Find the open folder...
1964            int folderScreen;
1965            if (openFolder != null) {
1966                folderScreen = mWorkspace.getPageForView(openFolder);
1967                // .. and close it
1968                closeFolder(openFolder);
1969                if (folderScreen != mWorkspace.getCurrentPage()) {
1970                    // Close any folder open on the current screen
1971                    closeFolder();
1972                    // Pull the folder onto this screen
1973                    openFolder(folderIcon);
1974                }
1975            }
1976        }
1977    }
1978
1979    private void growAndFadeOutFolderIcon(FolderIcon fi) {
1980        if (fi == null) return;
1981        PropertyValuesHolder alpha = PropertyValuesHolder.ofFloat("alpha", 0);
1982        PropertyValuesHolder scaleX = PropertyValuesHolder.ofFloat("scaleX", 1.5f);
1983        PropertyValuesHolder scaleY = PropertyValuesHolder.ofFloat("scaleY", 1.5f);
1984
1985        FolderInfo info = (FolderInfo) fi.getTag();
1986        if (info.container == LauncherSettings.Favorites.CONTAINER_HOTSEAT) {
1987            CellLayout cl = (CellLayout) fi.getParent().getParent();
1988            CellLayout.LayoutParams lp = (CellLayout.LayoutParams) fi.getLayoutParams();
1989            cl.setFolderLeaveBehindCell(lp.cellX, lp.cellY);
1990        }
1991
1992        ObjectAnimator oa = ObjectAnimator.ofPropertyValuesHolder(fi, alpha, scaleX, scaleY);
1993        oa.setDuration(getResources().getInteger(R.integer.config_folderAnimDuration));
1994        oa.start();
1995    }
1996
1997    private void shrinkAndFadeInFolderIcon(FolderIcon fi) {
1998        if (fi == null) return;
1999        PropertyValuesHolder alpha = PropertyValuesHolder.ofFloat("alpha", 1.0f);
2000        PropertyValuesHolder scaleX = PropertyValuesHolder.ofFloat("scaleX", 1.0f);
2001        PropertyValuesHolder scaleY = PropertyValuesHolder.ofFloat("scaleY", 1.0f);
2002
2003        FolderInfo info = (FolderInfo) fi.getTag();
2004        CellLayout cl = null;
2005        if (info.container == LauncherSettings.Favorites.CONTAINER_HOTSEAT) {
2006            cl = (CellLayout) fi.getParent().getParent();
2007        }
2008
2009        final CellLayout layout = cl;
2010        ObjectAnimator oa = ObjectAnimator.ofPropertyValuesHolder(fi, alpha, scaleX, scaleY);
2011        oa.setDuration(getResources().getInteger(R.integer.config_folderAnimDuration));
2012        oa.addListener(new AnimatorListenerAdapter() {
2013            @Override
2014            public void onAnimationEnd(Animator animation) {
2015                if (layout != null) {
2016                    layout.clearFolderLeaveBehind();
2017                }
2018            }
2019        });
2020        oa.start();
2021    }
2022
2023    /**
2024     * Opens the user folder described by the specified tag. The opening of the folder
2025     * is animated relative to the specified View. If the View is null, no animation
2026     * is played.
2027     *
2028     * @param folderInfo The FolderInfo describing the folder to open.
2029     */
2030    public void openFolder(FolderIcon folderIcon) {
2031        Folder folder = folderIcon.mFolder;
2032        FolderInfo info = folder.mInfo;
2033
2034        growAndFadeOutFolderIcon(folderIcon);
2035        info.opened = true;
2036
2037        // Just verify that the folder hasn't already been added to the DragLayer.
2038        // There was a one-off crash where the folder had a parent already.
2039        if (folder.getParent() == null) {
2040            mDragLayer.addView(folder);
2041            mDragController.addDropTarget((DropTarget) folder);
2042        } else {
2043            Log.w(TAG, "Opening folder (" + folder + ") which already has a parent (" +
2044                    folder.getParent() + ").");
2045        }
2046        folder.animateOpen();
2047    }
2048
2049    public void closeFolder() {
2050        Folder folder = mWorkspace.getOpenFolder();
2051        if (folder != null) {
2052            if (folder.isEditingName()) {
2053                folder.dismissEditingName();
2054            }
2055            closeFolder(folder);
2056
2057            // Dismiss the folder cling
2058            dismissFolderCling(null);
2059        }
2060    }
2061
2062    void closeFolder(Folder folder) {
2063        folder.getInfo().opened = false;
2064
2065        ViewGroup parent = (ViewGroup) folder.getParent().getParent();
2066        if (parent != null) {
2067            FolderIcon fi = (FolderIcon) mWorkspace.getViewForTag(folder.mInfo);
2068            shrinkAndFadeInFolderIcon(fi);
2069        }
2070        folder.animateClosed();
2071    }
2072
2073    public boolean onLongClick(View v) {
2074
2075        if (mState != State.WORKSPACE) {
2076            return false;
2077        }
2078
2079        if (isWorkspaceLocked()) {
2080            return false;
2081        }
2082
2083        if (!(v instanceof CellLayout)) {
2084            v = (View) v.getParent().getParent();
2085        }
2086
2087        resetAddInfo();
2088        CellLayout.CellInfo longClickCellInfo = (CellLayout.CellInfo) v.getTag();
2089        // This happens when long clicking an item with the dpad/trackball
2090        if (longClickCellInfo == null) {
2091            return true;
2092        }
2093
2094        // The hotseat touch handling does not go through Workspace, and we always allow long press
2095        // on hotseat items.
2096        final View itemUnderLongClick = longClickCellInfo.cell;
2097        boolean allowLongPress = isHotseatLayout(v) || mWorkspace.allowLongPress();
2098        if (allowLongPress && !mDragController.isDragging()) {
2099            if (itemUnderLongClick == null) {
2100                // User long pressed on empty space
2101                mWorkspace.performHapticFeedback(HapticFeedbackConstants.LONG_PRESS,
2102                        HapticFeedbackConstants.FLAG_IGNORE_VIEW_SETTING);
2103                startWallpaper();
2104            } else {
2105                if (!(itemUnderLongClick instanceof Folder)) {
2106                    // User long pressed on an item
2107                    mWorkspace.startDrag(longClickCellInfo);
2108                }
2109            }
2110        }
2111        return true;
2112    }
2113
2114    boolean isHotseatLayout(View layout) {
2115        return mHotseat != null && layout != null &&
2116                (layout instanceof CellLayout) && (layout == mHotseat.getLayout());
2117    }
2118    Hotseat getHotseat() {
2119        return mHotseat;
2120    }
2121    SearchDropTargetBar getSearchBar() {
2122        return mSearchDropTargetBar;
2123    }
2124
2125    /**
2126     * Returns the CellLayout of the specified container at the specified screen.
2127     */
2128    CellLayout getCellLayout(long container, int screen) {
2129        if (container == LauncherSettings.Favorites.CONTAINER_HOTSEAT) {
2130            if (mHotseat != null) {
2131                return mHotseat.getLayout();
2132            } else {
2133                return null;
2134            }
2135        } else {
2136            return (CellLayout) mWorkspace.getChildAt(screen);
2137        }
2138    }
2139
2140    Workspace getWorkspace() {
2141        return mWorkspace;
2142    }
2143
2144    // Now a part of LauncherModel.Callbacks. Used to reorder loading steps.
2145    public boolean isAllAppsVisible() {
2146        return (mState == State.APPS_CUSTOMIZE);
2147    }
2148
2149    public boolean isAllAppsButtonRank(int rank) {
2150        return mHotseat.isAllAppsButtonRank(rank);
2151    }
2152
2153    // AllAppsView.Watcher
2154    public void zoomed(float zoom) {
2155        if (zoom == 1.0f) {
2156            mWorkspace.setVisibility(View.GONE);
2157        }
2158    }
2159
2160    /**
2161     * Helper method for the cameraZoomIn/cameraZoomOut animations
2162     * @param view The view being animated
2163     * @param state The state that we are moving in or out of (eg. APPS_CUSTOMIZE)
2164     * @param scaleFactor The scale factor used for the zoom
2165     */
2166    private void setPivotsForZoom(View view, float scaleFactor) {
2167        view.setPivotX(view.getWidth() / 2.0f);
2168        view.setPivotY(view.getHeight() / 2.0f);
2169    }
2170
2171    void updateWallpaperVisibility(boolean visible) {
2172        int wpflags = visible ? WindowManager.LayoutParams.FLAG_SHOW_WALLPAPER : 0;
2173        int curflags = getWindow().getAttributes().flags
2174                & WindowManager.LayoutParams.FLAG_SHOW_WALLPAPER;
2175        if (wpflags != curflags) {
2176            getWindow().setFlags(wpflags, WindowManager.LayoutParams.FLAG_SHOW_WALLPAPER);
2177        }
2178    }
2179
2180    private void dispatchOnLauncherTransitionPrepare(View v, boolean animated, boolean toWorkspace) {
2181        if (v instanceof LauncherTransitionable) {
2182            ((LauncherTransitionable) v).onLauncherTransitionPrepare(this, animated, toWorkspace);
2183        }
2184    }
2185
2186    private void dispatchOnLauncherTransitionStart(View v, boolean animated, boolean toWorkspace) {
2187        if (v instanceof LauncherTransitionable) {
2188            ((LauncherTransitionable) v).onLauncherTransitionStart(this, animated, toWorkspace);
2189        }
2190
2191        // Update the workspace transition step as well
2192        dispatchOnLauncherTransitionStep(v, 0f);
2193    }
2194
2195    private void dispatchOnLauncherTransitionStep(View v, float t) {
2196        if (v instanceof LauncherTransitionable) {
2197            ((LauncherTransitionable) v).onLauncherTransitionStep(this, t);
2198        }
2199    }
2200
2201    private void dispatchOnLauncherTransitionEnd(View v, boolean animated, boolean toWorkspace) {
2202        if (v instanceof LauncherTransitionable) {
2203            ((LauncherTransitionable) v).onLauncherTransitionEnd(this, animated, toWorkspace);
2204        }
2205
2206        // Update the workspace transition step as well
2207        dispatchOnLauncherTransitionStep(v, 1f);
2208    }
2209
2210    /**
2211     * Things to test when changing the following seven functions.
2212     *   - Home from workspace
2213     *          - from center screen
2214     *          - from other screens
2215     *   - Home from all apps
2216     *          - from center screen
2217     *          - from other screens
2218     *   - Back from all apps
2219     *          - from center screen
2220     *          - from other screens
2221     *   - Launch app from workspace and quit
2222     *          - with back
2223     *          - with home
2224     *   - Launch app from all apps and quit
2225     *          - with back
2226     *          - with home
2227     *   - Go to a screen that's not the default, then all
2228     *     apps, and launch and app, and go back
2229     *          - with back
2230     *          -with home
2231     *   - On workspace, long press power and go back
2232     *          - with back
2233     *          - with home
2234     *   - On all apps, long press power and go back
2235     *          - with back
2236     *          - with home
2237     *   - On workspace, power off
2238     *   - On all apps, power off
2239     *   - Launch an app and turn off the screen while in that app
2240     *          - Go back with home key
2241     *          - Go back with back key  TODO: make this not go to workspace
2242     *          - From all apps
2243     *          - From workspace
2244     *   - Enter and exit car mode (becuase it causes an extra configuration changed)
2245     *          - From all apps
2246     *          - From the center workspace
2247     *          - From another workspace
2248     */
2249
2250    /**
2251     * Zoom the camera out from the workspace to reveal 'toView'.
2252     * Assumes that the view to show is anchored at either the very top or very bottom
2253     * of the screen.
2254     */
2255    private void showAppsCustomizeHelper(final boolean animated, final boolean springLoaded) {
2256        if (mStateAnimation != null) {
2257            mStateAnimation.cancel();
2258            mStateAnimation = null;
2259        }
2260        final Resources res = getResources();
2261
2262        final int duration = res.getInteger(R.integer.config_appsCustomizeZoomInTime);
2263        final int fadeDuration = res.getInteger(R.integer.config_appsCustomizeFadeInTime);
2264        final float scale = (float) res.getInteger(R.integer.config_appsCustomizeZoomScaleFactor);
2265        final View fromView = mWorkspace;
2266        final AppsCustomizeTabHost toView = mAppsCustomizeTabHost;
2267        final int startDelay =
2268                res.getInteger(R.integer.config_workspaceAppsCustomizeAnimationStagger);
2269
2270        setPivotsForZoom(toView, scale);
2271
2272        // Shrink workspaces away if going to AppsCustomize from workspace
2273        Animator workspaceAnim =
2274                mWorkspace.getChangeStateAnimation(Workspace.State.SMALL, animated);
2275
2276        if (animated) {
2277            toView.setScaleX(scale);
2278            toView.setScaleY(scale);
2279            final LauncherViewPropertyAnimator scaleAnim = new LauncherViewPropertyAnimator(toView);
2280            scaleAnim.
2281                scaleX(1f).scaleY(1f).
2282                setDuration(duration).
2283                setInterpolator(new Workspace.ZoomOutInterpolator());
2284
2285            toView.setVisibility(View.VISIBLE);
2286            toView.setAlpha(0f);
2287            final ObjectAnimator alphaAnim = ObjectAnimator
2288                .ofFloat(toView, "alpha", 0f, 1f)
2289                .setDuration(fadeDuration);
2290            alphaAnim.setInterpolator(new DecelerateInterpolator(1.5f));
2291            alphaAnim.addUpdateListener(new AnimatorUpdateListener() {
2292                @Override
2293                public void onAnimationUpdate(ValueAnimator animation) {
2294                    float t = (Float) animation.getAnimatedValue();
2295                    dispatchOnLauncherTransitionStep(fromView, t);
2296                    dispatchOnLauncherTransitionStep(toView, t);
2297                }
2298            });
2299
2300            // toView should appear right at the end of the workspace shrink
2301            // animation
2302            mStateAnimation = new AnimatorSet();
2303            mStateAnimation.play(scaleAnim).after(startDelay);
2304            mStateAnimation.play(alphaAnim).after(startDelay);
2305
2306            mStateAnimation.addListener(new AnimatorListenerAdapter() {
2307                boolean animationCancelled = false;
2308
2309                @Override
2310                public void onAnimationStart(Animator animation) {
2311                    updateWallpaperVisibility(true);
2312                    // Prepare the position
2313                    toView.setTranslationX(0.0f);
2314                    toView.setTranslationY(0.0f);
2315                    toView.setVisibility(View.VISIBLE);
2316                    toView.bringToFront();
2317                }
2318                @Override
2319                public void onAnimationEnd(Animator animation) {
2320                    dispatchOnLauncherTransitionEnd(fromView, animated, false);
2321                    dispatchOnLauncherTransitionEnd(toView, animated, false);
2322
2323                    if (!springLoaded && !LauncherApplication.isScreenLarge()) {
2324                        // Hide the workspace scrollbar
2325                        mWorkspace.hideScrollingIndicator(true);
2326                        hideDockDivider();
2327                    }
2328                    if (!animationCancelled) {
2329                        updateWallpaperVisibility(false);
2330                    }
2331                }
2332
2333                @Override
2334                public void onAnimationCancel(Animator animation) {
2335                    animationCancelled = true;
2336                }
2337            });
2338
2339            if (workspaceAnim != null) {
2340                mStateAnimation.play(workspaceAnim);
2341            }
2342
2343            boolean delayAnim = false;
2344            final ViewTreeObserver observer;
2345
2346            dispatchOnLauncherTransitionPrepare(fromView, animated, false);
2347            dispatchOnLauncherTransitionPrepare(toView, animated, false);
2348
2349            // If any of the objects being animated haven't been measured/laid out
2350            // yet, delay the animation until we get a layout pass
2351            if ((((LauncherTransitionable) toView).getContent().getMeasuredWidth() == 0) ||
2352                    (mWorkspace.getMeasuredWidth() == 0) ||
2353                    (toView.getMeasuredWidth() == 0)) {
2354                observer = mWorkspace.getViewTreeObserver();
2355                delayAnim = true;
2356            } else {
2357                observer = null;
2358            }
2359
2360            if (delayAnim) {
2361                final AnimatorSet stateAnimation = mStateAnimation;
2362                final OnGlobalLayoutListener delayedStart = new OnGlobalLayoutListener() {
2363                    public void onGlobalLayout() {
2364                        mWorkspace.post(new Runnable() {
2365                            public void run() {
2366                                // Check that mStateAnimation hasn't changed while
2367                                // we waited for a layout pass
2368                                if (mStateAnimation == stateAnimation) {
2369                                    // Need to update pivots for zoom if layout changed
2370                                    setPivotsForZoom(toView, scale);
2371                                    dispatchOnLauncherTransitionStart(fromView, animated, false);
2372                                    dispatchOnLauncherTransitionStart(toView, animated, false);
2373                                    mStateAnimation.start();
2374                                }
2375                            }
2376                        });
2377                        observer.removeOnGlobalLayoutListener(this);
2378                    }
2379                };
2380                observer.addOnGlobalLayoutListener(delayedStart);
2381            } else {
2382                setPivotsForZoom(toView, scale);
2383                dispatchOnLauncherTransitionStart(fromView, animated, false);
2384                dispatchOnLauncherTransitionStart(toView, animated, false);
2385                mStateAnimation.start();
2386            }
2387        } else {
2388            toView.setTranslationX(0.0f);
2389            toView.setTranslationY(0.0f);
2390            toView.setScaleX(1.0f);
2391            toView.setScaleY(1.0f);
2392            toView.setVisibility(View.VISIBLE);
2393            toView.bringToFront();
2394
2395            if (!springLoaded && !LauncherApplication.isScreenLarge()) {
2396                // Hide the workspace scrollbar
2397                mWorkspace.hideScrollingIndicator(true);
2398                hideDockDivider();
2399            }
2400            dispatchOnLauncherTransitionPrepare(fromView, animated, false);
2401            dispatchOnLauncherTransitionStart(fromView, animated, false);
2402            dispatchOnLauncherTransitionEnd(fromView, animated, false);
2403            dispatchOnLauncherTransitionPrepare(toView, animated, false);
2404            dispatchOnLauncherTransitionStart(toView, animated, false);
2405            dispatchOnLauncherTransitionEnd(toView, animated, false);
2406            updateWallpaperVisibility(false);
2407        }
2408    }
2409
2410    /**
2411     * Zoom the camera back into the workspace, hiding 'fromView'.
2412     * This is the opposite of showAppsCustomizeHelper.
2413     * @param animated If true, the transition will be animated.
2414     */
2415    private void hideAppsCustomizeHelper(State toState, final boolean animated,
2416            final boolean springLoaded, final Runnable onCompleteRunnable) {
2417
2418        if (mStateAnimation != null) {
2419            mStateAnimation.cancel();
2420            mStateAnimation = null;
2421        }
2422        Resources res = getResources();
2423
2424        final int duration = res.getInteger(R.integer.config_appsCustomizeZoomOutTime);
2425        final int fadeOutDuration =
2426                res.getInteger(R.integer.config_appsCustomizeFadeOutTime);
2427        final float scaleFactor = (float)
2428                res.getInteger(R.integer.config_appsCustomizeZoomScaleFactor);
2429        final View fromView = mAppsCustomizeTabHost;
2430        final View toView = mWorkspace;
2431        Animator workspaceAnim = null;
2432
2433        if (toState == State.WORKSPACE) {
2434            int stagger = res.getInteger(R.integer.config_appsCustomizeWorkspaceAnimationStagger);
2435            workspaceAnim = mWorkspace.getChangeStateAnimation(
2436                    Workspace.State.NORMAL, animated, stagger);
2437        } else if (toState == State.APPS_CUSTOMIZE_SPRING_LOADED) {
2438            workspaceAnim = mWorkspace.getChangeStateAnimation(
2439                    Workspace.State.SPRING_LOADED, animated);
2440        }
2441
2442        setPivotsForZoom(fromView, scaleFactor);
2443        updateWallpaperVisibility(true);
2444        showHotseat(animated);
2445        if (animated) {
2446            final LauncherViewPropertyAnimator scaleAnim =
2447                    new LauncherViewPropertyAnimator(fromView);
2448            scaleAnim.
2449                scaleX(scaleFactor).scaleY(scaleFactor).
2450                setDuration(duration).
2451                setInterpolator(new Workspace.ZoomInInterpolator());
2452
2453            final ObjectAnimator alphaAnim = ObjectAnimator
2454                .ofFloat(fromView, "alpha", 1f, 0f)
2455                .setDuration(fadeOutDuration);
2456            alphaAnim.setInterpolator(new AccelerateDecelerateInterpolator());
2457            alphaAnim.addUpdateListener(new AnimatorUpdateListener() {
2458                @Override
2459                public void onAnimationUpdate(ValueAnimator animation) {
2460                    float t = 1f - (Float) animation.getAnimatedValue();
2461                    dispatchOnLauncherTransitionStep(fromView, t);
2462                    dispatchOnLauncherTransitionStep(toView, t);
2463                }
2464            });
2465
2466            mStateAnimation = new AnimatorSet();
2467
2468            dispatchOnLauncherTransitionPrepare(fromView, animated, true);
2469            dispatchOnLauncherTransitionPrepare(toView, animated, true);
2470
2471            mStateAnimation.addListener(new AnimatorListenerAdapter() {
2472                @Override
2473                public void onAnimationEnd(Animator animation) {
2474                    updateWallpaperVisibility(true);
2475                    fromView.setVisibility(View.GONE);
2476                    dispatchOnLauncherTransitionEnd(fromView, animated, true);
2477                    dispatchOnLauncherTransitionEnd(toView, animated, true);
2478                    if (mWorkspace != null) {
2479                        mWorkspace.hideScrollingIndicator(false);
2480                    }
2481                    if (onCompleteRunnable != null) {
2482                        onCompleteRunnable.run();
2483                    }
2484                }
2485            });
2486
2487            mStateAnimation.playTogether(scaleAnim, alphaAnim);
2488            if (workspaceAnim != null) {
2489                mStateAnimation.play(workspaceAnim);
2490            }
2491            dispatchOnLauncherTransitionStart(fromView, animated, true);
2492            dispatchOnLauncherTransitionStart(toView, animated, true);
2493            mStateAnimation.start();
2494        } else {
2495            fromView.setVisibility(View.GONE);
2496            dispatchOnLauncherTransitionPrepare(fromView, animated, true);
2497            dispatchOnLauncherTransitionStart(fromView, animated, true);
2498            dispatchOnLauncherTransitionEnd(fromView, animated, true);
2499            dispatchOnLauncherTransitionPrepare(toView, animated, true);
2500            dispatchOnLauncherTransitionStart(toView, animated, true);
2501            dispatchOnLauncherTransitionEnd(toView, animated, true);
2502            mWorkspace.hideScrollingIndicator(false);
2503        }
2504    }
2505
2506    @Override
2507    public void onTrimMemory(int level) {
2508        super.onTrimMemory(level);
2509        if (level >= ComponentCallbacks2.TRIM_MEMORY_MODERATE) {
2510            mAppsCustomizeTabHost.onTrimMemory();
2511        }
2512    }
2513
2514    void showWorkspace(boolean animated) {
2515        showWorkspace(animated, null);
2516    }
2517
2518    void showWorkspace(boolean animated, Runnable onCompleteRunnable) {
2519        if (mState != State.WORKSPACE) {
2520            mWorkspace.setVisibility(View.VISIBLE);
2521            hideAppsCustomizeHelper(State.WORKSPACE, animated, false, onCompleteRunnable);
2522
2523            // Show the search bar and hotseat
2524            mSearchDropTargetBar.showSearchBar(animated);
2525            // We only need to animate in the dock divider if we're going from spring loaded mode
2526            showDockDivider(animated && mState == State.APPS_CUSTOMIZE_SPRING_LOADED);
2527
2528            // Set focus to the AppsCustomize button
2529            if (mAllAppsButton != null) {
2530                mAllAppsButton.requestFocus();
2531            }
2532        }
2533
2534        mWorkspace.flashScrollingIndicator(animated);
2535
2536        // Change the state *after* we've called all the transition code
2537        mState = State.WORKSPACE;
2538
2539        // Resume the auto-advance of widgets
2540        mUserPresent = true;
2541        updateRunning();
2542
2543        // send an accessibility event to announce the context change
2544        getWindow().getDecorView().sendAccessibilityEvent(AccessibilityEvent.TYPE_VIEW_SELECTED);
2545    }
2546
2547    void showAllApps(boolean animated) {
2548        if (mState != State.WORKSPACE) return;
2549
2550        showAppsCustomizeHelper(animated, false);
2551        mAppsCustomizeTabHost.requestFocus();
2552
2553        // Hide the search bar and hotseat
2554        mSearchDropTargetBar.hideSearchBar(animated);
2555
2556        // Change the state *after* we've called all the transition code
2557        mState = State.APPS_CUSTOMIZE;
2558
2559        // Pause the auto-advance of widgets until we are out of AllApps
2560        mUserPresent = false;
2561        updateRunning();
2562        closeFolder();
2563
2564        // Send an accessibility event to announce the context change
2565        getWindow().getDecorView().sendAccessibilityEvent(AccessibilityEvent.TYPE_VIEW_SELECTED);
2566    }
2567
2568    void enterSpringLoadedDragMode() {
2569        if (mState == State.APPS_CUSTOMIZE) {
2570            hideAppsCustomizeHelper(State.APPS_CUSTOMIZE_SPRING_LOADED, true, true, null);
2571            hideDockDivider();
2572            mState = State.APPS_CUSTOMIZE_SPRING_LOADED;
2573        }
2574    }
2575
2576    void exitSpringLoadedDragModeDelayed(final boolean successfulDrop, boolean extendedDelay,
2577            final Runnable onCompleteRunnable) {
2578        if (mState != State.APPS_CUSTOMIZE_SPRING_LOADED) return;
2579
2580        mHandler.postDelayed(new Runnable() {
2581            @Override
2582            public void run() {
2583                if (successfulDrop) {
2584                    // Before we show workspace, hide all apps again because
2585                    // exitSpringLoadedDragMode made it visible. This is a bit hacky; we should
2586                    // clean up our state transition functions
2587                    mAppsCustomizeTabHost.setVisibility(View.GONE);
2588                    mSearchDropTargetBar.showSearchBar(true);
2589                    showWorkspace(true, onCompleteRunnable);
2590                } else {
2591                    exitSpringLoadedDragMode();
2592                }
2593            }
2594        }, (extendedDelay ?
2595                EXIT_SPRINGLOADED_MODE_LONG_TIMEOUT :
2596                EXIT_SPRINGLOADED_MODE_SHORT_TIMEOUT));
2597    }
2598
2599    void exitSpringLoadedDragMode() {
2600        if (mState == State.APPS_CUSTOMIZE_SPRING_LOADED) {
2601            final boolean animated = true;
2602            final boolean springLoaded = true;
2603            showAppsCustomizeHelper(animated, springLoaded);
2604            mState = State.APPS_CUSTOMIZE;
2605        }
2606        // Otherwise, we are not in spring loaded mode, so don't do anything.
2607    }
2608
2609    void hideDockDivider() {
2610        if (mQsbDivider != null && mDockDivider != null) {
2611            mQsbDivider.setVisibility(View.INVISIBLE);
2612            mDockDivider.setVisibility(View.INVISIBLE);
2613        }
2614    }
2615
2616    void showDockDivider(boolean animated) {
2617        if (mQsbDivider != null && mDockDivider != null) {
2618            mQsbDivider.setVisibility(View.VISIBLE);
2619            mDockDivider.setVisibility(View.VISIBLE);
2620            if (mDividerAnimator != null) {
2621                mDividerAnimator.cancel();
2622                mQsbDivider.setAlpha(1f);
2623                mDockDivider.setAlpha(1f);
2624                mDividerAnimator = null;
2625            }
2626            if (animated) {
2627                mDividerAnimator = new AnimatorSet();
2628                mDividerAnimator.playTogether(ObjectAnimator.ofFloat(mQsbDivider, "alpha", 1f),
2629                        ObjectAnimator.ofFloat(mDockDivider, "alpha", 1f));
2630                mDividerAnimator.setDuration(mSearchDropTargetBar.getTransitionInDuration());
2631                mDividerAnimator.start();
2632            }
2633        }
2634    }
2635
2636    void lockAllApps() {
2637        // TODO
2638    }
2639
2640    void unlockAllApps() {
2641        // TODO
2642    }
2643
2644    public boolean isAllAppsCustomizeOpen() {
2645        return mState == State.APPS_CUSTOMIZE;
2646    }
2647
2648    /**
2649     * Shows the hotseat area.
2650     */
2651    void showHotseat(boolean animated) {
2652        if (!LauncherApplication.isScreenLarge()) {
2653            if (animated) {
2654                if (mHotseat.getAlpha() != 1f) {
2655                    int duration = mSearchDropTargetBar.getTransitionInDuration();
2656                    mHotseat.animate().alpha(1f).setDuration(duration);
2657                }
2658            } else {
2659                mHotseat.setAlpha(1f);
2660            }
2661        }
2662    }
2663
2664    /**
2665     * Hides the hotseat area.
2666     */
2667    void hideHotseat(boolean animated) {
2668        if (!LauncherApplication.isScreenLarge()) {
2669            if (animated) {
2670                if (mHotseat.getAlpha() != 0f) {
2671                    int duration = mSearchDropTargetBar.getTransitionOutDuration();
2672                    mHotseat.animate().alpha(0f).setDuration(duration);
2673                }
2674            } else {
2675                mHotseat.setAlpha(0f);
2676            }
2677        }
2678    }
2679
2680    /**
2681     * Add an item from all apps or customize onto the given workspace screen.
2682     * If layout is null, add to the current screen.
2683     */
2684    void addExternalItemToScreen(ItemInfo itemInfo, final CellLayout layout) {
2685        if (!mWorkspace.addExternalItemToScreen(itemInfo, layout)) {
2686            showOutOfSpaceMessage(isHotseatLayout(layout));
2687        }
2688    }
2689
2690    /** Maps the current orientation to an index for referencing orientation correct global icons */
2691    private int getCurrentOrientationIndexForGlobalIcons() {
2692        // default - 0, landscape - 1
2693        switch (getResources().getConfiguration().orientation) {
2694        case Configuration.ORIENTATION_LANDSCAPE:
2695            return 1;
2696        default:
2697            return 0;
2698        }
2699    }
2700
2701    private Drawable getExternalPackageToolbarIcon(ComponentName activityName, String resourceName) {
2702        try {
2703            PackageManager packageManager = getPackageManager();
2704            // Look for the toolbar icon specified in the activity meta-data
2705            Bundle metaData = packageManager.getActivityInfo(
2706                    activityName, PackageManager.GET_META_DATA).metaData;
2707            if (metaData != null) {
2708                int iconResId = metaData.getInt(resourceName);
2709                if (iconResId != 0) {
2710                    Resources res = packageManager.getResourcesForActivity(activityName);
2711                    return res.getDrawable(iconResId);
2712                }
2713            }
2714        } catch (NameNotFoundException e) {
2715            // This can happen if the activity defines an invalid drawable
2716            Log.w(TAG, "Failed to load toolbar icon; " + activityName.flattenToShortString() +
2717                    " not found", e);
2718        } catch (Resources.NotFoundException nfe) {
2719            // This can happen if the activity defines an invalid drawable
2720            Log.w(TAG, "Failed to load toolbar icon from " + activityName.flattenToShortString(),
2721                    nfe);
2722        }
2723        return null;
2724    }
2725
2726    // if successful in getting icon, return it; otherwise, set button to use default drawable
2727    private Drawable.ConstantState updateTextButtonWithIconFromExternalActivity(
2728            int buttonId, ComponentName activityName, int fallbackDrawableId,
2729            String toolbarResourceName) {
2730        Drawable toolbarIcon = getExternalPackageToolbarIcon(activityName, toolbarResourceName);
2731        Resources r = getResources();
2732        int w = r.getDimensionPixelSize(R.dimen.toolbar_external_icon_width);
2733        int h = r.getDimensionPixelSize(R.dimen.toolbar_external_icon_height);
2734
2735        TextView button = (TextView) findViewById(buttonId);
2736        // If we were unable to find the icon via the meta-data, use a generic one
2737        if (toolbarIcon == null) {
2738            toolbarIcon = r.getDrawable(fallbackDrawableId);
2739            toolbarIcon.setBounds(0, 0, w, h);
2740            if (button != null) {
2741                button.setCompoundDrawables(toolbarIcon, null, null, null);
2742            }
2743            return null;
2744        } else {
2745            toolbarIcon.setBounds(0, 0, w, h);
2746            if (button != null) {
2747                button.setCompoundDrawables(toolbarIcon, null, null, null);
2748            }
2749            return toolbarIcon.getConstantState();
2750        }
2751    }
2752
2753    // if successful in getting icon, return it; otherwise, set button to use default drawable
2754    private Drawable.ConstantState updateButtonWithIconFromExternalActivity(
2755            int buttonId, ComponentName activityName, int fallbackDrawableId,
2756            String toolbarResourceName) {
2757        ImageView button = (ImageView) findViewById(buttonId);
2758        Drawable toolbarIcon = getExternalPackageToolbarIcon(activityName, toolbarResourceName);
2759
2760        if (button != null) {
2761            // If we were unable to find the icon via the meta-data, use a
2762            // generic one
2763            if (toolbarIcon == null) {
2764                button.setImageResource(fallbackDrawableId);
2765            } else {
2766                button.setImageDrawable(toolbarIcon);
2767            }
2768        }
2769
2770        return toolbarIcon != null ? toolbarIcon.getConstantState() : null;
2771
2772    }
2773
2774    private void updateTextButtonWithDrawable(int buttonId, Drawable.ConstantState d) {
2775        TextView button = (TextView) findViewById(buttonId);
2776        button.setCompoundDrawables(d.newDrawable(getResources()), null, null, null);
2777    }
2778
2779    private void updateButtonWithDrawable(int buttonId, Drawable.ConstantState d) {
2780        ImageView button = (ImageView) findViewById(buttonId);
2781        button.setImageDrawable(d.newDrawable(getResources()));
2782    }
2783
2784    private void invalidatePressedFocusedStates(View container, View button) {
2785        if (container instanceof HolographicLinearLayout) {
2786            HolographicLinearLayout layout = (HolographicLinearLayout) container;
2787            layout.invalidatePressedFocusedStates();
2788        } else if (button instanceof HolographicImageView) {
2789            HolographicImageView view = (HolographicImageView) button;
2790            view.invalidatePressedFocusedStates();
2791        }
2792    }
2793
2794    private boolean updateGlobalSearchIcon() {
2795        final View searchButtonContainer = findViewById(R.id.search_button_container);
2796        final ImageView searchButton = (ImageView) findViewById(R.id.search_button);
2797        final View searchDivider = findViewById(R.id.search_divider);
2798        final View voiceButtonContainer = findViewById(R.id.voice_button_container);
2799        final View voiceButton = findViewById(R.id.voice_button);
2800        final View voiceButtonProxy = findViewById(R.id.voice_button_proxy);
2801
2802        final SearchManager searchManager =
2803                (SearchManager) getSystemService(Context.SEARCH_SERVICE);
2804        ComponentName activityName = searchManager.getGlobalSearchActivity();
2805        if (activityName != null) {
2806            int coi = getCurrentOrientationIndexForGlobalIcons();
2807            sGlobalSearchIcon[coi] = updateButtonWithIconFromExternalActivity(
2808                    R.id.search_button, activityName, R.drawable.ic_home_search_normal_holo,
2809                    TOOLBAR_SEARCH_ICON_METADATA_NAME);
2810            if (sGlobalSearchIcon[coi] == null) {
2811                sGlobalSearchIcon[coi] = updateButtonWithIconFromExternalActivity(
2812                        R.id.search_button, activityName, R.drawable.ic_home_search_normal_holo,
2813                        TOOLBAR_ICON_METADATA_NAME);
2814            }
2815
2816            if (searchDivider != null) searchDivider.setVisibility(View.VISIBLE);
2817            if (searchButtonContainer != null) searchButtonContainer.setVisibility(View.VISIBLE);
2818            searchButton.setVisibility(View.VISIBLE);
2819            invalidatePressedFocusedStates(searchButtonContainer, searchButton);
2820            return true;
2821        } else {
2822            // We disable both search and voice search when there is no global search provider
2823            if (searchDivider != null) searchDivider.setVisibility(View.GONE);
2824            if (searchButtonContainer != null) searchButtonContainer.setVisibility(View.GONE);
2825            if (voiceButtonContainer != null) voiceButtonContainer.setVisibility(View.GONE);
2826            searchButton.setVisibility(View.GONE);
2827            voiceButton.setVisibility(View.GONE);
2828            voiceButtonProxy.setVisibility(View.GONE);
2829            return false;
2830        }
2831    }
2832
2833    private void updateGlobalSearchIcon(Drawable.ConstantState d) {
2834        final View searchButtonContainer = findViewById(R.id.search_button_container);
2835        final View searchButton = (ImageView) findViewById(R.id.search_button);
2836        updateButtonWithDrawable(R.id.search_button, d);
2837        invalidatePressedFocusedStates(searchButtonContainer, searchButton);
2838    }
2839
2840    private boolean updateVoiceSearchIcon(boolean searchVisible) {
2841        final View searchDivider = findViewById(R.id.search_divider);
2842        final View voiceButtonContainer = findViewById(R.id.voice_button_container);
2843        final View voiceButton = findViewById(R.id.voice_button);
2844        final View voiceButtonProxy = findViewById(R.id.voice_button_proxy);
2845
2846        // We only show/update the voice search icon if the search icon is enabled as well
2847        final SearchManager searchManager =
2848                (SearchManager) getSystemService(Context.SEARCH_SERVICE);
2849        ComponentName globalSearchActivity = searchManager.getGlobalSearchActivity();
2850
2851        ComponentName activityName = null;
2852        if (globalSearchActivity != null) {
2853            // Check if the global search activity handles voice search
2854            Intent intent = new Intent(RecognizerIntent.ACTION_WEB_SEARCH);
2855            intent.setPackage(globalSearchActivity.getPackageName());
2856            activityName = intent.resolveActivity(getPackageManager());
2857        }
2858
2859        if (activityName == null) {
2860            // Fallback: check if an activity other than the global search activity
2861            // resolves this
2862            Intent intent = new Intent(RecognizerIntent.ACTION_WEB_SEARCH);
2863            activityName = intent.resolveActivity(getPackageManager());
2864        }
2865        if (searchVisible && activityName != null) {
2866            int coi = getCurrentOrientationIndexForGlobalIcons();
2867            sVoiceSearchIcon[coi] = updateButtonWithIconFromExternalActivity(
2868                    R.id.voice_button, activityName, R.drawable.ic_home_voice_search_holo,
2869                    TOOLBAR_VOICE_SEARCH_ICON_METADATA_NAME);
2870            if (sVoiceSearchIcon[coi] == null) {
2871                sVoiceSearchIcon[coi] = updateButtonWithIconFromExternalActivity(
2872                        R.id.voice_button, activityName, R.drawable.ic_home_voice_search_holo,
2873                        TOOLBAR_ICON_METADATA_NAME);
2874            }
2875            if (searchDivider != null) searchDivider.setVisibility(View.VISIBLE);
2876            if (voiceButtonContainer != null) voiceButtonContainer.setVisibility(View.VISIBLE);
2877            voiceButton.setVisibility(View.VISIBLE);
2878            if (voiceButtonProxy != null) {
2879                voiceButtonProxy.setVisibility(View.VISIBLE);
2880            }
2881            invalidatePressedFocusedStates(voiceButtonContainer, voiceButton);
2882            return true;
2883        } else {
2884            if (searchDivider != null) searchDivider.setVisibility(View.GONE);
2885            if (voiceButtonContainer != null) voiceButtonContainer.setVisibility(View.GONE);
2886            voiceButton.setVisibility(View.GONE);
2887            if (voiceButtonProxy != null) {
2888                voiceButtonProxy.setVisibility(View.GONE);
2889            }
2890            return false;
2891        }
2892    }
2893
2894    private void updateVoiceSearchIcon(Drawable.ConstantState d) {
2895        final View voiceButtonContainer = findViewById(R.id.voice_button_container);
2896        final View voiceButton = findViewById(R.id.voice_button);
2897        updateButtonWithDrawable(R.id.voice_button, d);
2898        invalidatePressedFocusedStates(voiceButtonContainer, voiceButton);
2899    }
2900
2901    /**
2902     * Sets the app market icon
2903     */
2904    private void updateAppMarketIcon() {
2905        final View marketButton = findViewById(R.id.market_button);
2906        Intent intent = new Intent(Intent.ACTION_MAIN).addCategory(Intent.CATEGORY_APP_MARKET);
2907        // Find the app market activity by resolving an intent.
2908        // (If multiple app markets are installed, it will return the ResolverActivity.)
2909        ComponentName activityName = intent.resolveActivity(getPackageManager());
2910        if (activityName != null) {
2911            int coi = getCurrentOrientationIndexForGlobalIcons();
2912            mAppMarketIntent = intent;
2913            sAppMarketIcon[coi] = updateTextButtonWithIconFromExternalActivity(
2914                    R.id.market_button, activityName, R.drawable.ic_launcher_market_holo,
2915                    TOOLBAR_ICON_METADATA_NAME);
2916            marketButton.setVisibility(View.VISIBLE);
2917        } else {
2918            // We should hide and disable the view so that we don't try and restore the visibility
2919            // of it when we swap between drag & normal states from IconDropTarget subclasses.
2920            marketButton.setVisibility(View.GONE);
2921            marketButton.setEnabled(false);
2922        }
2923    }
2924
2925    private void updateAppMarketIcon(Drawable.ConstantState d) {
2926        updateTextButtonWithDrawable(R.id.market_button, d);
2927    }
2928
2929    @Override
2930    public boolean dispatchPopulateAccessibilityEvent(AccessibilityEvent event) {
2931        boolean result = super.dispatchPopulateAccessibilityEvent(event);
2932        final List<CharSequence> text = event.getText();
2933        text.clear();
2934        text.add(getString(R.string.home));
2935        return result;
2936    }
2937
2938    /**
2939     * Receives notifications when system dialogs are to be closed.
2940     */
2941    private class CloseSystemDialogsIntentReceiver extends BroadcastReceiver {
2942        @Override
2943        public void onReceive(Context context, Intent intent) {
2944            closeSystemDialogs();
2945        }
2946    }
2947
2948    /**
2949     * Receives notifications whenever the appwidgets are reset.
2950     */
2951    private class AppWidgetResetObserver extends ContentObserver {
2952        public AppWidgetResetObserver() {
2953            super(new Handler());
2954        }
2955
2956        @Override
2957        public void onChange(boolean selfChange) {
2958            onAppWidgetReset();
2959        }
2960    }
2961
2962    /**
2963     * If the activity is currently paused, signal that we need to re-run the loader
2964     * in onResume.
2965     *
2966     * This needs to be called from incoming places where resources might have been loaded
2967     * while we are paused.  That is becaues the Configuration might be wrong
2968     * when we're not running, and if it comes back to what it was when we
2969     * were paused, we are not restarted.
2970     *
2971     * Implementation of the method from LauncherModel.Callbacks.
2972     *
2973     * @return true if we are currently paused.  The caller might be able to
2974     * skip some work in that case since we will come back again.
2975     */
2976    public boolean setLoadOnResume() {
2977        if (mPaused) {
2978            Log.i(TAG, "setLoadOnResume");
2979            mOnResumeNeedsLoad = true;
2980            return true;
2981        } else {
2982            return false;
2983        }
2984    }
2985
2986    /**
2987     * Implementation of the method from LauncherModel.Callbacks.
2988     */
2989    public int getCurrentWorkspaceScreen() {
2990        if (mWorkspace != null) {
2991            return mWorkspace.getCurrentPage();
2992        } else {
2993            return SCREEN_COUNT / 2;
2994        }
2995    }
2996
2997    /**
2998     * Refreshes the shortcuts shown on the workspace.
2999     *
3000     * Implementation of the method from LauncherModel.Callbacks.
3001     */
3002    public void startBinding() {
3003        final Workspace workspace = mWorkspace;
3004
3005        mNewShortcutAnimatePage = -1;
3006        mNewShortcutAnimateViews.clear();
3007        mWorkspace.clearDropTargets();
3008        int count = workspace.getChildCount();
3009        for (int i = 0; i < count; i++) {
3010            // Use removeAllViewsInLayout() to avoid an extra requestLayout() and invalidate().
3011            final CellLayout layoutParent = (CellLayout) workspace.getChildAt(i);
3012            layoutParent.removeAllViewsInLayout();
3013        }
3014        mWidgetsToAdvance.clear();
3015        if (mHotseat != null) {
3016            mHotseat.resetLayout();
3017        }
3018    }
3019
3020    /**
3021     * Bind the items start-end from the list.
3022     *
3023     * Implementation of the method from LauncherModel.Callbacks.
3024     */
3025    public void bindItems(ArrayList<ItemInfo> shortcuts, int start, int end) {
3026        setLoadOnResume();
3027
3028        // Get the list of added shortcuts and intersect them with the set of shortcuts here
3029        Set<String> newApps = new HashSet<String>();
3030        newApps = mSharedPrefs.getStringSet(InstallShortcutReceiver.NEW_APPS_LIST_KEY, newApps);
3031
3032        Workspace workspace = mWorkspace;
3033        for (int i = start; i < end; i++) {
3034            final ItemInfo item = shortcuts.get(i);
3035
3036            // Short circuit if we are loading dock items for a configuration which has no dock
3037            if (item.container == LauncherSettings.Favorites.CONTAINER_HOTSEAT &&
3038                    mHotseat == null) {
3039                continue;
3040            }
3041
3042            switch (item.itemType) {
3043                case LauncherSettings.Favorites.ITEM_TYPE_APPLICATION:
3044                case LauncherSettings.Favorites.ITEM_TYPE_SHORTCUT:
3045                    ShortcutInfo info = (ShortcutInfo) item;
3046                    String uri = info.intent.toUri(0).toString();
3047                    View shortcut = createShortcut(info);
3048                    workspace.addInScreen(shortcut, item.container, item.screen, item.cellX,
3049                            item.cellY, 1, 1, false);
3050                    if (newApps.contains(uri)) {
3051                        newApps.remove(uri);
3052
3053                        // Prepare the view to be animated up
3054                        shortcut.setAlpha(0f);
3055                        shortcut.setScaleX(0f);
3056                        shortcut.setScaleY(0f);
3057                        mNewShortcutAnimatePage = item.screen;
3058                        if (!mNewShortcutAnimateViews.contains(shortcut)) {
3059                            mNewShortcutAnimateViews.add(shortcut);
3060                        }
3061                    }
3062                    break;
3063                case LauncherSettings.Favorites.ITEM_TYPE_FOLDER:
3064                    FolderIcon newFolder = FolderIcon.fromXml(R.layout.folder_icon, this,
3065                            (ViewGroup) workspace.getChildAt(workspace.getCurrentPage()),
3066                            (FolderInfo) item, mIconCache);
3067                    workspace.addInScreen(newFolder, item.container, item.screen, item.cellX,
3068                            item.cellY, 1, 1, false);
3069                    break;
3070            }
3071        }
3072
3073        workspace.requestLayout();
3074    }
3075
3076    /**
3077     * Implementation of the method from LauncherModel.Callbacks.
3078     */
3079    public void bindFolders(HashMap<Long, FolderInfo> folders) {
3080        setLoadOnResume();
3081        sFolders.clear();
3082        sFolders.putAll(folders);
3083    }
3084
3085    /**
3086     * Add the views for a widget to the workspace.
3087     *
3088     * Implementation of the method from LauncherModel.Callbacks.
3089     */
3090    public void bindAppWidget(LauncherAppWidgetInfo item) {
3091        setLoadOnResume();
3092
3093        final long start = DEBUG_WIDGETS ? SystemClock.uptimeMillis() : 0;
3094        if (DEBUG_WIDGETS) {
3095            Log.d(TAG, "bindAppWidget: " + item);
3096        }
3097        final Workspace workspace = mWorkspace;
3098
3099        final int appWidgetId = item.appWidgetId;
3100        final AppWidgetProviderInfo appWidgetInfo = mAppWidgetManager.getAppWidgetInfo(appWidgetId);
3101        if (DEBUG_WIDGETS) {
3102            Log.d(TAG, "bindAppWidget: id=" + item.appWidgetId + " belongs to component " + appWidgetInfo.provider);
3103        }
3104
3105        item.hostView = mAppWidgetHost.createView(this, appWidgetId, appWidgetInfo);
3106
3107        item.hostView.setAppWidget(appWidgetId, appWidgetInfo);
3108        item.hostView.setTag(item);
3109
3110        workspace.addInScreen(item.hostView, item.container, item.screen, item.cellX,
3111                item.cellY, item.spanX, item.spanY, false);
3112
3113        addWidgetToAutoAdvanceIfNeeded(item.hostView, appWidgetInfo);
3114
3115        workspace.requestLayout();
3116
3117        AppWidgetResizeFrame.updateWidgetSizeRanges(item.hostView,
3118                this, item.spanX, item.spanY);
3119
3120        if (DEBUG_WIDGETS) {
3121            Log.d(TAG, "bound widget id="+item.appWidgetId+" in "
3122                    + (SystemClock.uptimeMillis()-start) + "ms");
3123        }
3124    }
3125
3126    /**
3127     * Callback saying that there aren't any more items to bind.
3128     *
3129     * Implementation of the method from LauncherModel.Callbacks.
3130     */
3131    public void finishBindingItems() {
3132        setLoadOnResume();
3133
3134        if (mSavedState != null) {
3135            if (!mWorkspace.hasFocus()) {
3136                mWorkspace.getChildAt(mWorkspace.getCurrentPage()).requestFocus();
3137            }
3138            mSavedState = null;
3139        }
3140
3141        if (mSavedInstanceState != null) {
3142            super.onRestoreInstanceState(mSavedInstanceState);
3143            mSavedInstanceState = null;
3144        }
3145
3146        // If we received the result of any pending adds while the loader was running (e.g. the
3147        // widget configuration forced an orientation change), process them now.
3148        for (int i = 0; i < sPendingAddList.size(); i++) {
3149            completeAdd(sPendingAddList.get(i));
3150        }
3151        sPendingAddList.clear();
3152
3153        // Update the market app icon as necessary (the other icons will be managed in response to
3154        // package changes in bindSearchablesChanged()
3155        updateAppMarketIcon();
3156
3157        // Animate up any icons as necessary
3158        if (mVisible || mWorkspaceLoading) {
3159            Runnable newAppsRunnable = new Runnable() {
3160                @Override
3161                public void run() {
3162                    runNewAppsAnimation(false);
3163                }
3164            };
3165
3166            boolean willSnapPage = mNewShortcutAnimatePage > -1 &&
3167                    mNewShortcutAnimatePage != mWorkspace.getCurrentPage();
3168            if (canRunNewAppsAnimation()) {
3169                // If the user has not interacted recently, then either snap to the new page to show
3170                // the new-apps animation or just run them if they are to appear on the current page
3171                if (willSnapPage) {
3172                    mWorkspace.snapToPage(mNewShortcutAnimatePage, newAppsRunnable);
3173                } else {
3174                    runNewAppsAnimation(false);
3175                }
3176            } else {
3177                // If the user has interacted recently, then just add the items in place if they
3178                // are on another page (or just normally if they are added to the current page)
3179                runNewAppsAnimation(willSnapPage);
3180            }
3181        }
3182
3183        mWorkspaceLoading = false;
3184    }
3185
3186    private boolean canRunNewAppsAnimation() {
3187        long diff = System.currentTimeMillis() - mDragController.getLastGestureUpTime();
3188        return diff > (NEW_APPS_ANIMATION_INACTIVE_TIMEOUT_SECONDS * 1000);
3189    }
3190
3191    /**
3192     * Runs a new animation that scales up icons that were added while Launcher was in the
3193     * background.
3194     *
3195     * @param immediate whether to run the animation or show the results immediately
3196     */
3197    private void runNewAppsAnimation(boolean immediate) {
3198        AnimatorSet anim = new AnimatorSet();
3199        Collection<Animator> bounceAnims = new ArrayList<Animator>();
3200
3201        // Order these new views spatially so that they animate in order
3202        Collections.sort(mNewShortcutAnimateViews, new Comparator<View>() {
3203            @Override
3204            public int compare(View a, View b) {
3205                CellLayout.LayoutParams alp = (CellLayout.LayoutParams) a.getLayoutParams();
3206                CellLayout.LayoutParams blp = (CellLayout.LayoutParams) b.getLayoutParams();
3207                int cellCountX = LauncherModel.getCellCountX();
3208                return (alp.cellY * cellCountX + alp.cellX) - (blp.cellY * cellCountX + blp.cellX);
3209            }
3210        });
3211
3212        // Animate each of the views in place (or show them immediately if requested)
3213        if (immediate) {
3214            for (View v : mNewShortcutAnimateViews) {
3215                v.setAlpha(1f);
3216                v.setScaleX(1f);
3217                v.setScaleY(1f);
3218            }
3219        } else {
3220            for (int i = 0; i < mNewShortcutAnimateViews.size(); ++i) {
3221                View v = mNewShortcutAnimateViews.get(i);
3222                ValueAnimator bounceAnim = ObjectAnimator.ofPropertyValuesHolder(v,
3223                        PropertyValuesHolder.ofFloat("alpha", 1f),
3224                        PropertyValuesHolder.ofFloat("scaleX", 1f),
3225                        PropertyValuesHolder.ofFloat("scaleY", 1f));
3226                bounceAnim.setDuration(InstallShortcutReceiver.NEW_SHORTCUT_BOUNCE_DURATION);
3227                bounceAnim.setStartDelay(i * InstallShortcutReceiver.NEW_SHORTCUT_STAGGER_DELAY);
3228                bounceAnim.setInterpolator(new SmoothPagedView.OvershootInterpolator());
3229                bounceAnims.add(bounceAnim);
3230            }
3231            anim.playTogether(bounceAnims);
3232            anim.addListener(new AnimatorListenerAdapter() {
3233                @Override
3234                public void onAnimationEnd(Animator animation) {
3235                    mWorkspace.postDelayed(mBuildLayersRunnable, 500);
3236                }
3237            });
3238            anim.start();
3239        }
3240
3241        // Clean up
3242        mNewShortcutAnimatePage = -1;
3243        mNewShortcutAnimateViews.clear();
3244        new Thread("clearNewAppsThread") {
3245            public void run() {
3246                mSharedPrefs.edit()
3247                            .putInt(InstallShortcutReceiver.NEW_APPS_PAGE_KEY, -1)
3248                            .putStringSet(InstallShortcutReceiver.NEW_APPS_LIST_KEY, null)
3249                            .commit();
3250            }
3251        }.start();
3252    }
3253
3254    @Override
3255    public void bindSearchablesChanged() {
3256        boolean searchVisible = updateGlobalSearchIcon();
3257        boolean voiceVisible = updateVoiceSearchIcon(searchVisible);
3258        mSearchDropTargetBar.onSearchPackagesChanged(searchVisible, voiceVisible);
3259    }
3260
3261    /**
3262     * Add the icons for all apps.
3263     *
3264     * Implementation of the method from LauncherModel.Callbacks.
3265     */
3266    public void bindAllApplications(final ArrayList<ApplicationInfo> apps) {
3267        // Remove the progress bar entirely; we could also make it GONE
3268        // but better to remove it since we know it's not going to be used
3269        View progressBar = mAppsCustomizeTabHost.
3270            findViewById(R.id.apps_customize_progress_bar);
3271        if (progressBar != null) {
3272            ((ViewGroup)progressBar.getParent()).removeView(progressBar);
3273        }
3274        // We just post the call to setApps so the user sees the progress bar
3275        // disappear-- otherwise, it just looks like the progress bar froze
3276        // which doesn't look great
3277        mAppsCustomizeTabHost.post(new Runnable() {
3278            public void run() {
3279                if (mAppsCustomizeContent != null) {
3280                    mAppsCustomizeContent.setApps(apps);
3281                }
3282            }
3283        });
3284    }
3285
3286    /**
3287     * A package was installed.
3288     *
3289     * Implementation of the method from LauncherModel.Callbacks.
3290     */
3291    public void bindAppsAdded(ArrayList<ApplicationInfo> apps) {
3292        setLoadOnResume();
3293
3294        if (mAppsCustomizeContent != null) {
3295            mAppsCustomizeContent.addApps(apps);
3296        }
3297    }
3298
3299    /**
3300     * A package was updated.
3301     *
3302     * Implementation of the method from LauncherModel.Callbacks.
3303     */
3304    public void bindAppsUpdated(ArrayList<ApplicationInfo> apps) {
3305        setLoadOnResume();
3306        if (mWorkspace != null) {
3307            mWorkspace.updateShortcuts(apps);
3308        }
3309
3310        if (mAppsCustomizeContent != null) {
3311            mAppsCustomizeContent.updateApps(apps);
3312        }
3313    }
3314
3315    /**
3316     * A package was uninstalled.
3317     *
3318     * Implementation of the method from LauncherModel.Callbacks.
3319     */
3320    public void bindAppsRemoved(ArrayList<ApplicationInfo> apps, boolean permanent) {
3321        if (permanent) {
3322            mWorkspace.removeItems(apps);
3323        }
3324
3325        if (mAppsCustomizeContent != null) {
3326            mAppsCustomizeContent.removeApps(apps);
3327        }
3328
3329        // Notify the drag controller
3330        mDragController.onAppsRemoved(apps, this);
3331    }
3332
3333    /**
3334     * A number of packages were updated.
3335     */
3336    public void bindPackagesUpdated() {
3337        if (mAppsCustomizeContent != null) {
3338            mAppsCustomizeContent.onPackagesUpdated();
3339        }
3340    }
3341
3342    private int mapConfigurationOriActivityInfoOri(int configOri) {
3343        final Display d = getWindowManager().getDefaultDisplay();
3344        int naturalOri = Configuration.ORIENTATION_LANDSCAPE;
3345        switch (d.getRotation()) {
3346        case Surface.ROTATION_0:
3347        case Surface.ROTATION_180:
3348            // We are currently in the same basic orientation as the natural orientation
3349            naturalOri = configOri;
3350            break;
3351        case Surface.ROTATION_90:
3352        case Surface.ROTATION_270:
3353            // We are currently in the other basic orientation to the natural orientation
3354            naturalOri = (configOri == Configuration.ORIENTATION_LANDSCAPE) ?
3355                    Configuration.ORIENTATION_PORTRAIT : Configuration.ORIENTATION_LANDSCAPE;
3356            break;
3357        }
3358
3359        int[] oriMap = {
3360                ActivityInfo.SCREEN_ORIENTATION_PORTRAIT,
3361                ActivityInfo.SCREEN_ORIENTATION_LANDSCAPE,
3362                ActivityInfo.SCREEN_ORIENTATION_REVERSE_PORTRAIT,
3363                ActivityInfo.SCREEN_ORIENTATION_REVERSE_LANDSCAPE
3364        };
3365        // Since the map starts at portrait, we need to offset if this device's natural orientation
3366        // is landscape.
3367        int indexOffset = 0;
3368        if (naturalOri == Configuration.ORIENTATION_LANDSCAPE) {
3369            indexOffset = 1;
3370        }
3371        return oriMap[(d.getRotation() + indexOffset) % 4];
3372    }
3373
3374    public boolean isRotationEnabled() {
3375        boolean forceEnableRotation = "true".equalsIgnoreCase(SystemProperties.get(
3376                FORCE_ENABLE_ROTATION_PROPERTY, "false"));
3377        boolean enableRotation = forceEnableRotation ||
3378                getResources().getBoolean(R.bool.allow_rotation);
3379        return enableRotation;
3380    }
3381    public void lockScreenOrientation() {
3382        if (isRotationEnabled()) {
3383            setRequestedOrientation(mapConfigurationOriActivityInfoOri(getResources()
3384                    .getConfiguration().orientation));
3385        }
3386    }
3387    public void unlockScreenOrientation(boolean immediate) {
3388        if (isRotationEnabled()) {
3389            if (immediate) {
3390                setRequestedOrientation(ActivityInfo.SCREEN_ORIENTATION_UNSPECIFIED);
3391            } else {
3392                mHandler.postDelayed(new Runnable() {
3393                    public void run() {
3394                        setRequestedOrientation(ActivityInfo.SCREEN_ORIENTATION_UNSPECIFIED);
3395                    }
3396                }, mRestoreScreenOrientationDelay);
3397            }
3398        }
3399    }
3400
3401    /* Cling related */
3402    private boolean isClingsEnabled() {
3403        // disable clings when running in a test harness
3404        if(ActivityManager.isRunningInTestHarness()) return false;
3405
3406        return true;
3407    }
3408    private Cling initCling(int clingId, int[] positionData, boolean animate, int delay) {
3409        Cling cling = (Cling) findViewById(clingId);
3410        if (cling != null) {
3411            cling.init(this, positionData);
3412            cling.setVisibility(View.VISIBLE);
3413            cling.setLayerType(View.LAYER_TYPE_HARDWARE, null);
3414            if (animate) {
3415                cling.buildLayer();
3416                cling.setAlpha(0f);
3417                cling.animate()
3418                    .alpha(1f)
3419                    .setInterpolator(new AccelerateInterpolator())
3420                    .setDuration(SHOW_CLING_DURATION)
3421                    .setStartDelay(delay)
3422                    .start();
3423            } else {
3424                cling.setAlpha(1f);
3425            }
3426        }
3427        return cling;
3428    }
3429    private void dismissCling(final Cling cling, final String flag, int duration) {
3430        if (cling != null) {
3431            ObjectAnimator anim = ObjectAnimator.ofFloat(cling, "alpha", 0f);
3432            anim.setDuration(duration);
3433            anim.addListener(new AnimatorListenerAdapter() {
3434                public void onAnimationEnd(Animator animation) {
3435                    cling.setVisibility(View.GONE);
3436                    cling.cleanup();
3437                    // We should update the shared preferences on a background thread
3438                    new Thread("dismissClingThread") {
3439                        public void run() {
3440                            SharedPreferences.Editor editor = mSharedPrefs.edit();
3441                            editor.putBoolean(flag, true);
3442                            editor.commit();
3443                        }
3444                    }.start();
3445                };
3446            });
3447            anim.start();
3448        }
3449    }
3450    private void removeCling(int id) {
3451        final View cling = findViewById(id);
3452        if (cling != null) {
3453            final ViewGroup parent = (ViewGroup) cling.getParent();
3454            parent.post(new Runnable() {
3455                @Override
3456                public void run() {
3457                    parent.removeView(cling);
3458                }
3459            });
3460        }
3461    }
3462    public void showFirstRunWorkspaceCling() {
3463        // Enable the clings only if they have not been dismissed before
3464        if (isClingsEnabled() &&
3465                !mSharedPrefs.getBoolean(Cling.WORKSPACE_CLING_DISMISSED_KEY, false)) {
3466            initCling(R.id.workspace_cling, null, false, 0);
3467        } else {
3468            removeCling(R.id.workspace_cling);
3469        }
3470    }
3471    public void showFirstRunAllAppsCling(int[] position) {
3472        // Enable the clings only if they have not been dismissed before
3473        if (isClingsEnabled() &&
3474                !mSharedPrefs.getBoolean(Cling.ALLAPPS_CLING_DISMISSED_KEY, false)) {
3475            initCling(R.id.all_apps_cling, position, true, 0);
3476        } else {
3477            removeCling(R.id.all_apps_cling);
3478        }
3479    }
3480    public Cling showFirstRunFoldersCling() {
3481        // Enable the clings only if they have not been dismissed before
3482        if (isClingsEnabled() &&
3483                !mSharedPrefs.getBoolean(Cling.FOLDER_CLING_DISMISSED_KEY, false)) {
3484            return initCling(R.id.folder_cling, null, true, 0);
3485        } else {
3486            removeCling(R.id.folder_cling);
3487            return null;
3488        }
3489    }
3490    public boolean isFolderClingVisible() {
3491        Cling cling = (Cling) findViewById(R.id.folder_cling);
3492        if (cling != null) {
3493            return cling.getVisibility() == View.VISIBLE;
3494        }
3495        return false;
3496    }
3497    public void dismissWorkspaceCling(View v) {
3498        Cling cling = (Cling) findViewById(R.id.workspace_cling);
3499        dismissCling(cling, Cling.WORKSPACE_CLING_DISMISSED_KEY, DISMISS_CLING_DURATION);
3500    }
3501    public void dismissAllAppsCling(View v) {
3502        Cling cling = (Cling) findViewById(R.id.all_apps_cling);
3503        dismissCling(cling, Cling.ALLAPPS_CLING_DISMISSED_KEY, DISMISS_CLING_DURATION);
3504    }
3505    public void dismissFolderCling(View v) {
3506        Cling cling = (Cling) findViewById(R.id.folder_cling);
3507        dismissCling(cling, Cling.FOLDER_CLING_DISMISSED_KEY, DISMISS_CLING_DURATION);
3508    }
3509
3510    /**
3511     * Prints out out state for debugging.
3512     */
3513    public void dumpState() {
3514        Log.d(TAG, "BEGIN launcher2 dump state for launcher " + this);
3515        Log.d(TAG, "mSavedState=" + mSavedState);
3516        Log.d(TAG, "mWorkspaceLoading=" + mWorkspaceLoading);
3517        Log.d(TAG, "mRestoring=" + mRestoring);
3518        Log.d(TAG, "mWaitingForResult=" + mWaitingForResult);
3519        Log.d(TAG, "mSavedInstanceState=" + mSavedInstanceState);
3520        Log.d(TAG, "sFolders.size=" + sFolders.size());
3521        mModel.dumpState();
3522
3523        if (mAppsCustomizeContent != null) {
3524            mAppsCustomizeContent.dumpState();
3525        }
3526        Log.d(TAG, "END launcher2 dump state");
3527    }
3528
3529    @Override
3530    public void dump(String prefix, FileDescriptor fd, PrintWriter writer, String[] args) {
3531        super.dump(prefix, fd, writer, args);
3532        writer.println(" ");
3533        writer.println("Debug logs: ");
3534        for (int i = 0; i < sDumpLogs.size(); i++) {
3535            writer.println("  " + sDumpLogs.get(i));
3536        }
3537    }
3538}
3539
3540interface LauncherTransitionable {
3541    View getContent();
3542    void onLauncherTransitionPrepare(Launcher l, boolean animated, boolean toWorkspace);
3543    void onLauncherTransitionStart(Launcher l, boolean animated, boolean toWorkspace);
3544    void onLauncherTransitionStep(Launcher l, float t);
3545    void onLauncherTransitionEnd(Launcher l, boolean animated, boolean toWorkspace);
3546}
3547