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