Launcher.java revision 4e6a976c2d85f7261ae4318a9ccffd2440f73124
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             View.OnKeyListener listener = new IndicatorKeyEventListener();
939             mPreviousView = (ImageView) dragLayer.findViewById(R.id.previous_screen);
940             mPreviousView.setOnKeyListener(listener);
941             mNextView = (ImageView) dragLayer.findViewById(R.id.next_screen);
942             mNextView.setOnKeyListener(listener);
943
944             Drawable previous = mPreviousView.getDrawable();
945             Drawable next = mNextView.getDrawable();
946             mWorkspace.setIndicators(previous, next);
947
948             mPreviousView.setHapticFeedbackEnabled(false);
949             mPreviousView.setOnLongClickListener(this);
950             mNextView.setHapticFeedbackEnabled(false);
951             mNextView.setOnLongClickListener(this);
952        }
953
954        workspace.setOnLongClickListener(this);
955        workspace.setDragController(dragController);
956        workspace.setLauncher(this);
957        workspace.setWallpaperDimension();
958
959        deleteZone.setLauncher(this);
960        deleteZone.setDragController(dragController);
961
962        final View allAppsButton = findViewById(R.id.all_apps_button);
963        final View divider = findViewById(R.id.all_apps_divider);
964        final View configureButton = findViewById(R.id.configure_button);
965
966        if (LauncherApplication.isScreenXLarge()) {
967            deleteZone.setOverlappingViews(new View[] { allAppsButton, divider, configureButton });
968        } else {
969            deleteZone.setOverlappingView(findViewById(R.id.all_apps_button_cluster));
970        }
971        dragController.addDragListener(deleteZone);
972
973        DeleteZone allAppsDeleteZone = (DeleteZone) findViewById(R.id.all_apps_delete_zone);
974        if (allAppsDeleteZone != null) {
975            allAppsDeleteZone.setLauncher(this);
976            allAppsDeleteZone.setDragController(dragController);
977            allAppsDeleteZone.setDragAndDropEnabled(false);
978            dragController.addDragListener(allAppsDeleteZone);
979            dragController.addDropTarget(allAppsDeleteZone);
980        }
981
982        ApplicationInfoDropTarget allAppsInfoTarget = (ApplicationInfoDropTarget)
983                findViewById(R.id.all_apps_info_target);
984        if (allAppsInfoTarget != null) {
985            allAppsInfoTarget.setLauncher(this);
986            dragController.addDragListener(allAppsInfoTarget);
987            allAppsInfoTarget.setDragAndDropEnabled(false);
988        }
989        View marketButton = findViewById(R.id.market_button);
990        if (marketButton != null) {
991            if (allAppsInfoTarget != null) {
992                allAppsInfoTarget.setOverlappingView(marketButton);
993            }
994            marketButton.setOnClickListener(new OnClickListener() {
995                public void onClick(View v) {
996                    onClickAppMarketButton(v);
997                }
998            });
999        }
1000
1001        dragController.setDragScoller(workspace);
1002        dragController.setScrollView(dragLayer);
1003        dragController.setMoveTarget(workspace);
1004
1005        // The order here is bottom to top.
1006        dragController.addDropTarget(workspace);
1007        dragController.addDropTarget(deleteZone);
1008        if (allAppsInfoTarget != null) {
1009            dragController.addDropTarget(allAppsInfoTarget);
1010        }
1011        if (allAppsDeleteZone != null) {
1012            dragController.addDropTarget(allAppsDeleteZone);
1013        }
1014        mButtonCluster = (ViewGroup) findViewById(R.id.all_apps_button_cluster);
1015        View.OnKeyListener listener = null;
1016        if (LauncherApplication.isScreenXLarge()) {
1017            // For tablets, AllApps lives in the button bar at the top
1018            listener = new ButtonBarKeyEventListener();
1019        } else {
1020            // For phones, AppsCustomize lives in the "dock" at the bottom
1021            listener = new DockKeyEventListener();
1022        }
1023        int buttonCount = mButtonCluster.getChildCount();
1024        for (int i = 0; i < buttonCount; ++i) {
1025            mButtonCluster.getChildAt(i).setOnKeyListener(listener);
1026        }
1027
1028        mAllAppsButton = findViewById(R.id.all_apps_button);
1029        mDivider = findViewById(R.id.all_apps_divider);
1030        mConfigureButton = findViewById(R.id.configure_button);
1031
1032        // We had previously set these click handlers in XML, but the first time we launched
1033        // Configure or All Apps we had an extra 50ms of delay while the java reflection methods
1034        // found the right handler. Setting the handlers directly here eliminates that cost.
1035        if (mConfigureButton != null) {
1036            mConfigureButton.setOnClickListener(new OnClickListener() {
1037                public void onClick(View v) {
1038                    onClickConfigureButton(v);
1039                }
1040            });
1041        }
1042        if (mDivider != null) {
1043            mDivider.setOnClickListener(new OnClickListener() {
1044                public void onClick(View v) {
1045                    onClickAllAppsButton(v);
1046                }
1047            });
1048        }
1049        if (mAllAppsButton != null) {
1050            mAllAppsButton.setOnClickListener(new OnClickListener() {
1051                public void onClick(View v) {
1052                    onClickAllAppsButton(v);
1053                }
1054            });
1055        }
1056    }
1057
1058    @SuppressWarnings({"UnusedDeclaration"})
1059    public void previousScreen(View v) {
1060        if (mState != State.ALL_APPS && mState != State.APPS_CUSTOMIZE) {
1061            mWorkspace.scrollLeft();
1062        }
1063    }
1064
1065    @SuppressWarnings({"UnusedDeclaration"})
1066    public void nextScreen(View v) {
1067        if (mState != State.ALL_APPS && mState != State.APPS_CUSTOMIZE) {
1068            mWorkspace.scrollRight();
1069        }
1070    }
1071
1072    @SuppressWarnings({"UnusedDeclaration"})
1073    public void launchHotSeat(View v) {
1074        if (mState == State.ALL_APPS) return;
1075
1076        int index = -1;
1077        if (v.getId() == R.id.hotseat_left) {
1078            index = 0;
1079        } else if (v.getId() == R.id.hotseat_right) {
1080            index = 1;
1081        }
1082
1083        // reload these every tap; you never know when they might change
1084        loadHotseats();
1085        if (index >= 0 && index < mHotseats.length && mHotseats[index] != null) {
1086            startActivitySafely(
1087                mHotseats[index],
1088                "hotseat"
1089            );
1090        }
1091    }
1092
1093    /**
1094     * Creates a view representing a shortcut.
1095     *
1096     * @param info The data structure describing the shortcut.
1097     *
1098     * @return A View inflated from R.layout.application.
1099     */
1100    View createShortcut(ShortcutInfo info) {
1101        return createShortcut(R.layout.application,
1102                (ViewGroup) mWorkspace.getChildAt(mWorkspace.getCurrentPage()), info);
1103    }
1104
1105    /**
1106     * Creates a view representing a shortcut inflated from the specified resource.
1107     *
1108     * @param layoutResId The id of the XML layout used to create the shortcut.
1109     * @param parent The group the shortcut belongs to.
1110     * @param info The data structure describing the shortcut.
1111     *
1112     * @return A View inflated from layoutResId.
1113     */
1114    View createShortcut(int layoutResId, ViewGroup parent, ShortcutInfo info) {
1115        BubbleTextView favorite = (BubbleTextView) mInflater.inflate(layoutResId, parent, false);
1116        favorite.applyFromShortcutInfo(info, mIconCache);
1117        favorite.setOnClickListener(this);
1118        return favorite;
1119    }
1120
1121    /**
1122     * Add an application shortcut to the workspace.
1123     *
1124     * @param data The intent describing the application.
1125     * @param cellInfo The position on screen where to create the shortcut.
1126     */
1127    void completeAddApplication(Intent data, int screen,
1128            int intersectCellX, int intersectCellY) {
1129        final int[] cellXY = mTmpAddItemCellCoordinates;
1130        final CellLayout layout = (CellLayout) mWorkspace.getChildAt(screen);
1131
1132        if (!layout.findCellForSpanThatIntersects(cellXY, 1, 1, intersectCellX, intersectCellY)) {
1133            showOutOfSpaceMessage();
1134            return;
1135        }
1136
1137        final ShortcutInfo info = mModel.getShortcutInfo(getPackageManager(), data, this);
1138
1139        if (info != null) {
1140            info.setActivity(data.getComponent(), Intent.FLAG_ACTIVITY_NEW_TASK |
1141                    Intent.FLAG_ACTIVITY_RESET_TASK_IF_NEEDED);
1142            info.container = ItemInfo.NO_ID;
1143            mWorkspace.addApplicationShortcut(info, screen, cellXY[0], cellXY[1],
1144                    isWorkspaceLocked(), mAddIntersectCellX, mAddIntersectCellY);
1145        } else {
1146            Log.e(TAG, "Couldn't find ActivityInfo for selected application: " + data);
1147        }
1148    }
1149
1150    /**
1151     * Add a shortcut to the workspace.
1152     *
1153     * @param data The intent describing the shortcut.
1154     * @param cellInfo The position on screen where to create the shortcut.
1155     */
1156    private void completeAddShortcut(Intent data, int screen,
1157            int intersectCellX, int intersectCellY) {
1158        final int[] cellXY = mTmpAddItemCellCoordinates;
1159        final CellLayout layout = (CellLayout) mWorkspace.getChildAt(screen);
1160
1161        int[] touchXY = mAddDropPosition;
1162        boolean foundCellSpan = false;
1163        if (touchXY != null) {
1164            // when dragging and dropping, just find the closest free spot
1165            CellLayout screenLayout = (CellLayout) mWorkspace.getChildAt(screen);
1166            int[] result = screenLayout.findNearestVacantArea(
1167                    touchXY[0], touchXY[1], 1, 1, cellXY);
1168            foundCellSpan = (result != null);
1169        } else {
1170            foundCellSpan = layout.findCellForSpanThatIntersects(
1171                    cellXY, 1, 1, intersectCellX, intersectCellY);
1172        }
1173
1174        if (!foundCellSpan) {
1175            showOutOfSpaceMessage();
1176            return;
1177        }
1178
1179        final ShortcutInfo info = mModel.addShortcut(
1180                this, data, screen, cellXY[0], cellXY[1], false);
1181
1182        if (!mRestoring) {
1183            final View view = createShortcut(info);
1184            mWorkspace.addInScreen(view, screen, cellXY[0], cellXY[1], 1, 1, isWorkspaceLocked());
1185        }
1186    }
1187
1188    /**
1189     * Add a widget to the workspace.
1190     *
1191     * @param appWidgetId The app widget id
1192     * @param cellInfo The position on screen where to create the widget.
1193     */
1194    private void completeAddAppWidget(final int appWidgetId, int screen) {
1195        AppWidgetProviderInfo appWidgetInfo = mAppWidgetManager.getAppWidgetInfo(appWidgetId);
1196
1197        // Calculate the grid spans needed to fit this widget
1198        CellLayout layout = (CellLayout) mWorkspace.getChildAt(screen);
1199        int[] spanXY = layout.rectToCell(appWidgetInfo.minWidth, appWidgetInfo.minHeight, null);
1200
1201        // Try finding open space on Launcher screen
1202        // We have saved the position to which the widget was dragged-- this really only matters
1203        // if we are placing widgets on a "spring-loaded" screen
1204        final int[] cellXY = mTmpAddItemCellCoordinates;
1205
1206        int[] touchXY = mAddDropPosition;
1207        boolean foundCellSpan = false;
1208        if (touchXY != null) {
1209            // when dragging and dropping, just find the closest free spot
1210            CellLayout screenLayout = (CellLayout) mWorkspace.getChildAt(screen);
1211            int[] result = screenLayout.findNearestVacantArea(
1212                    touchXY[0], touchXY[1], spanXY[0], spanXY[1], cellXY);
1213            foundCellSpan = (result != null);
1214        } else {
1215            // if we long pressed on an empty cell to bring up a menu,
1216            // make sure we intersect the empty cell
1217            // if mAddIntersectCellX/Y are -1 (e.g. we used menu -> add) then
1218            // findCellForSpanThatIntersects will just ignore them
1219            foundCellSpan = layout.findCellForSpanThatIntersects(cellXY, spanXY[0], spanXY[1],
1220                    mAddIntersectCellX, mAddIntersectCellY);
1221        }
1222
1223        if (!foundCellSpan) {
1224            if (appWidgetId != -1) {
1225                // Deleting an app widget ID is a void call but writes to disk before returning
1226                // to the caller...
1227                final LauncherAppWidgetHost appWidgetHost = mAppWidgetHost;
1228                new Thread("deleteAppWidgetId") {
1229                    public void run() {
1230                        mAppWidgetHost.deleteAppWidgetId(appWidgetId);
1231                    }
1232                }.start();
1233            }
1234            showOutOfSpaceMessage();
1235            return;
1236        }
1237
1238        // Build Launcher-specific widget info and save to database
1239        LauncherAppWidgetInfo launcherInfo = new LauncherAppWidgetInfo(appWidgetId);
1240        launcherInfo.spanX = spanXY[0];
1241        launcherInfo.spanY = spanXY[1];
1242
1243        LauncherModel.addItemToDatabase(this, launcherInfo,
1244                LauncherSettings.Favorites.CONTAINER_DESKTOP,
1245                screen, cellXY[0], cellXY[1], false);
1246
1247        if (!mRestoring) {
1248            mDesktopItems.add(launcherInfo);
1249
1250            // Perform actual inflation because we're live
1251            launcherInfo.hostView = mAppWidgetHost.createView(this, appWidgetId, appWidgetInfo);
1252
1253            launcherInfo.hostView.setAppWidget(appWidgetId, appWidgetInfo);
1254            launcherInfo.hostView.setTag(launcherInfo);
1255
1256            mWorkspace.addInScreen(launcherInfo.hostView, screen, cellXY[0], cellXY[1],
1257                    launcherInfo.spanX, launcherInfo.spanY, isWorkspaceLocked());
1258
1259            addWidgetToAutoAdvanceIfNeeded(launcherInfo.hostView, appWidgetInfo);
1260        }
1261    }
1262
1263    private final BroadcastReceiver mReceiver = new BroadcastReceiver() {
1264        @Override
1265        public void onReceive(Context context, Intent intent) {
1266            final String action = intent.getAction();
1267            if (Intent.ACTION_SCREEN_OFF.equals(action)) {
1268                mUserPresent = false;
1269                updateRunning();
1270
1271                // Reset AllApps to it's initial state
1272                if (mAllAppsGrid != null) {
1273                    mAllAppsGrid.reset();
1274                }
1275                if (mAppsCustomizeContent != null) {
1276                    mAppsCustomizeContent.reset();
1277                }
1278            } else if (Intent.ACTION_USER_PRESENT.equals(action)) {
1279                mUserPresent = true;
1280                updateRunning();
1281            }
1282        }
1283    };
1284
1285    @Override
1286    public void onAttachedToWindow() {
1287        super.onAttachedToWindow();
1288
1289        // Listen for broadcasts related to user-presence
1290        final IntentFilter filter = new IntentFilter();
1291        filter.addAction(Intent.ACTION_SCREEN_OFF);
1292        filter.addAction(Intent.ACTION_USER_PRESENT);
1293        registerReceiver(mReceiver, filter);
1294
1295        mAttached = true;
1296        mVisible = true;
1297    }
1298
1299    @Override
1300    public void onDetachedFromWindow() {
1301        super.onDetachedFromWindow();
1302        mVisible = false;
1303
1304        if (mAttached) {
1305            unregisterReceiver(mReceiver);
1306            mAttached = false;
1307        }
1308        updateRunning();
1309    }
1310
1311    public void onWindowVisibilityChanged(int visibility) {
1312        mVisible = visibility == View.VISIBLE;
1313        updateRunning();
1314    }
1315
1316    private void sendAdvanceMessage(long delay) {
1317        mHandler.removeMessages(ADVANCE_MSG);
1318        Message msg = mHandler.obtainMessage(ADVANCE_MSG);
1319        mHandler.sendMessageDelayed(msg, delay);
1320        mAutoAdvanceSentTime = System.currentTimeMillis();
1321    }
1322
1323    private void updateRunning() {
1324        boolean autoAdvanceRunning = mVisible && mUserPresent && !mWidgetsToAdvance.isEmpty();
1325        if (autoAdvanceRunning != mAutoAdvanceRunning) {
1326            mAutoAdvanceRunning = autoAdvanceRunning;
1327            if (autoAdvanceRunning) {
1328                long delay = mAutoAdvanceTimeLeft == -1 ? mAdvanceInterval : mAutoAdvanceTimeLeft;
1329                sendAdvanceMessage(delay);
1330            } else {
1331                if (!mWidgetsToAdvance.isEmpty()) {
1332                    mAutoAdvanceTimeLeft = Math.max(0, mAdvanceInterval -
1333                            (System.currentTimeMillis() - mAutoAdvanceSentTime));
1334                }
1335                mHandler.removeMessages(ADVANCE_MSG);
1336                mHandler.removeMessages(0); // Remove messages sent using postDelayed()
1337            }
1338        }
1339    }
1340
1341    private final Handler mHandler = new Handler() {
1342        @Override
1343        public void handleMessage(Message msg) {
1344            if (msg.what == ADVANCE_MSG) {
1345                int i = 0;
1346                for (View key: mWidgetsToAdvance.keySet()) {
1347                    final View v = key.findViewById(mWidgetsToAdvance.get(key).autoAdvanceViewId);
1348                    final int delay = mAdvanceStagger * i;
1349                    if (v instanceof Advanceable) {
1350                       postDelayed(new Runnable() {
1351                           public void run() {
1352                               ((Advanceable) v).advance();
1353                           }
1354                       }, delay);
1355                    }
1356                    i++;
1357                }
1358                sendAdvanceMessage(mAdvanceInterval);
1359            }
1360        }
1361    };
1362
1363    void addWidgetToAutoAdvanceIfNeeded(View hostView, AppWidgetProviderInfo appWidgetInfo) {
1364        if (appWidgetInfo.autoAdvanceViewId == -1) return;
1365        View v = hostView.findViewById(appWidgetInfo.autoAdvanceViewId);
1366        if (v instanceof Advanceable) {
1367            mWidgetsToAdvance.put(hostView, appWidgetInfo);
1368            ((Advanceable) v).fyiWillBeAdvancedByHostKThx();
1369            updateRunning();
1370        }
1371    }
1372
1373    void removeWidgetToAutoAdvance(View hostView) {
1374        if (mWidgetsToAdvance.containsKey(hostView)) {
1375            mWidgetsToAdvance.remove(hostView);
1376            updateRunning();
1377        }
1378    }
1379
1380    public void removeAppWidget(LauncherAppWidgetInfo launcherInfo) {
1381        mDesktopItems.remove(launcherInfo);
1382        removeWidgetToAutoAdvance(launcherInfo.hostView);
1383        launcherInfo.hostView = null;
1384    }
1385
1386    void showOutOfSpaceMessage() {
1387        Toast.makeText(this, getString(R.string.out_of_space), Toast.LENGTH_SHORT).show();
1388    }
1389
1390    public LauncherAppWidgetHost getAppWidgetHost() {
1391        return mAppWidgetHost;
1392    }
1393
1394    public LauncherModel getModel() {
1395        return mModel;
1396    }
1397
1398    void closeSystemDialogs() {
1399        getWindow().closeAllPanels();
1400
1401        try {
1402            dismissDialog(DIALOG_CREATE_SHORTCUT);
1403            // Unlock the workspace if the dialog was showing
1404        } catch (Exception e) {
1405            // An exception is thrown if the dialog is not visible, which is fine
1406        }
1407
1408        try {
1409            dismissDialog(DIALOG_RENAME_FOLDER);
1410            // Unlock the workspace if the dialog was showing
1411        } catch (Exception e) {
1412            // An exception is thrown if the dialog is not visible, which is fine
1413        }
1414
1415        // Whatever we were doing is hereby canceled.
1416        mWaitingForResult = false;
1417    }
1418
1419    @Override
1420    protected void onNewIntent(Intent intent) {
1421        super.onNewIntent(intent);
1422
1423        // Close the menu
1424        if (Intent.ACTION_MAIN.equals(intent.getAction())) {
1425            // also will cancel mWaitingForResult.
1426            closeSystemDialogs();
1427
1428            boolean alreadyOnHome = ((intent.getFlags() & Intent.FLAG_ACTIVITY_BROUGHT_TO_FRONT)
1429                        != Intent.FLAG_ACTIVITY_BROUGHT_TO_FRONT);
1430
1431            // In all these cases, only animate if we're already on home
1432            mWorkspace.unshrink(alreadyOnHome);
1433            mWorkspace.exitWidgetResizeMode();
1434            if (alreadyOnHome && mState == State.WORKSPACE && !mWorkspace.isTouchActive()) {
1435                mWorkspace.moveToDefaultScreen(true);
1436            }
1437            showWorkspace(alreadyOnHome);
1438
1439            final View v = getWindow().peekDecorView();
1440            if (v != null && v.getWindowToken() != null) {
1441                InputMethodManager imm = (InputMethodManager)getSystemService(
1442                        INPUT_METHOD_SERVICE);
1443                imm.hideSoftInputFromWindow(v.getWindowToken(), 0);
1444            }
1445
1446            // Reset AllApps to it's initial state
1447            if (mAllAppsGrid != null) {
1448                mAllAppsGrid.reset();
1449            }
1450            if (mAppsCustomizeContent != null) {
1451                mAppsCustomizeContent.reset();
1452            }
1453        }
1454    }
1455
1456    @Override
1457    protected void onRestoreInstanceState(Bundle savedInstanceState) {
1458        // Do not call super here
1459        mSavedInstanceState = savedInstanceState;
1460    }
1461
1462    @Override
1463    protected void onSaveInstanceState(Bundle outState) {
1464        outState.putInt(RUNTIME_STATE_CURRENT_SCREEN, mWorkspace.getCurrentPage());
1465
1466        final ArrayList<Folder> folders = mWorkspace.getOpenFolders();
1467        if (folders.size() > 0) {
1468            final int count = folders.size();
1469            long[] ids = new long[count];
1470            for (int i = 0; i < count; i++) {
1471                final FolderInfo info = folders.get(i).getInfo();
1472                ids[i] = info.id;
1473            }
1474            outState.putLongArray(RUNTIME_STATE_FOLDERS, ids);
1475        } else {
1476            super.onSaveInstanceState(outState);
1477        }
1478
1479        outState.putInt(RUNTIME_STATE, mState.ordinal());
1480
1481        if (mAddScreen > -1 && mWaitingForResult) {
1482            outState.putInt(RUNTIME_STATE_PENDING_ADD_SCREEN, mAddScreen);
1483            outState.putInt(RUNTIME_STATE_PENDING_ADD_CELL_X, mAddIntersectCellX);
1484            outState.putInt(RUNTIME_STATE_PENDING_ADD_CELL_Y, mAddIntersectCellY);
1485        }
1486
1487        if (mFolderInfo != null && mWaitingForResult) {
1488            outState.putBoolean(RUNTIME_STATE_PENDING_FOLDER_RENAME, true);
1489            outState.putLong(RUNTIME_STATE_PENDING_FOLDER_RENAME_ID, mFolderInfo.id);
1490        }
1491
1492        // Save the current AllApps drawer tab
1493        if (mAllAppsGrid != null && mAllAppsGrid instanceof AllAppsTabbed) {
1494            AllAppsTabbed tabhost = (AllAppsTabbed) mAllAppsGrid;
1495            String currentTabTag = tabhost.getCurrentTabTag();
1496            if (currentTabTag != null) {
1497                outState.putString("allapps_currentTab", currentTabTag);
1498                outState.putInt("allapps_currentPage", mAllAppsPagedView.getCurrentPage());
1499            }
1500        }
1501        // Save the current customization drawer tab
1502        if (mHomeCustomizationDrawer != null) {
1503            String currentTabTag = mHomeCustomizationDrawer.getCurrentTabTag();
1504            if (currentTabTag != null) {
1505                outState.putString("customize_currentTab", currentTabTag);
1506            }
1507        }
1508        // Save the current AppsCustomize tab
1509        if (mAppsCustomizeTabHost != null) {
1510            String currentTabTag = mAppsCustomizeTabHost.getCurrentTabTag();
1511            if (currentTabTag != null) {
1512                outState.putString("apps_customize_currentTab", currentTabTag);
1513            }
1514        }
1515    }
1516
1517    @Override
1518    public void onDestroy() {
1519        super.onDestroy();
1520
1521        try {
1522            mAppWidgetHost.stopListening();
1523        } catch (NullPointerException ex) {
1524            Log.w(TAG, "problem while stopping AppWidgetHost during Launcher destruction", ex);
1525        }
1526        mAppWidgetHost = null;
1527
1528        mWidgetsToAdvance.clear();
1529
1530        TextKeyListener.getInstance().release();
1531
1532        mModel.stopLoader();
1533
1534        unbindDesktopItems();
1535
1536        getContentResolver().unregisterContentObserver(mWidgetObserver);
1537
1538        // Some launcher layouts don't have a previous and next view
1539        if (mPreviousView != null) {
1540            dismissPreview(mPreviousView);
1541        }
1542        if (mNextView != null) {
1543            dismissPreview(mNextView);
1544        }
1545
1546        unregisterReceiver(mCloseSystemDialogsReceiver);
1547
1548        ((ViewGroup) mWorkspace.getParent()).removeAllViews();
1549        mWorkspace.removeAllViews();
1550        mWorkspace = null;
1551        mDragController = null;
1552
1553        ValueAnimator.clearAllAnimations();
1554    }
1555
1556    public DragController getDragController() {
1557        return mDragController;
1558    }
1559
1560    @Override
1561    public void startActivityForResult(Intent intent, int requestCode) {
1562        if (requestCode >= 0) mWaitingForResult = true;
1563        super.startActivityForResult(intent, requestCode);
1564    }
1565
1566    @Override
1567    public void startSearch(String initialQuery, boolean selectInitialQuery,
1568            Bundle appSearchData, boolean globalSearch) {
1569
1570        showWorkspace(true);
1571
1572        if (initialQuery == null) {
1573            // Use any text typed in the launcher as the initial query
1574            initialQuery = getTypedText();
1575            clearTypedText();
1576        }
1577        if (appSearchData == null) {
1578            appSearchData = new Bundle();
1579            appSearchData.putString(Search.SOURCE, "launcher-search");
1580        }
1581
1582        final SearchManager searchManager =
1583                (SearchManager) getSystemService(Context.SEARCH_SERVICE);
1584        searchManager.startSearch(initialQuery, selectInitialQuery, getComponentName(),
1585            appSearchData, globalSearch);
1586    }
1587
1588    @Override
1589    public boolean onCreateOptionsMenu(Menu menu) {
1590        if (isWorkspaceLocked()) {
1591            return false;
1592        }
1593
1594        super.onCreateOptionsMenu(menu);
1595
1596        menu.add(MENU_GROUP_ADD, MENU_ADD, 0, R.string.menu_add)
1597                .setIcon(android.R.drawable.ic_menu_add)
1598                .setAlphabeticShortcut('A');
1599        menu.add(0, MENU_MANAGE_APPS, 0, R.string.menu_manage_apps)
1600                .setIcon(android.R.drawable.ic_menu_manage)
1601                .setAlphabeticShortcut('M');
1602        menu.add(MENU_GROUP_WALLPAPER, MENU_WALLPAPER_SETTINGS, 0, R.string.menu_wallpaper)
1603                 .setIcon(android.R.drawable.ic_menu_gallery)
1604                 .setAlphabeticShortcut('W');
1605        menu.add(0, MENU_SEARCH, 0, R.string.menu_search)
1606                .setIcon(android.R.drawable.ic_search_category_default)
1607                .setAlphabeticShortcut(SearchManager.MENU_KEY);
1608        menu.add(0, MENU_NOTIFICATIONS, 0, R.string.menu_notifications)
1609                .setIcon(com.android.internal.R.drawable.ic_menu_notifications)
1610                .setAlphabeticShortcut('N');
1611
1612        final Intent settings = new Intent(android.provider.Settings.ACTION_SETTINGS);
1613        settings.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK |
1614                Intent.FLAG_ACTIVITY_RESET_TASK_IF_NEEDED);
1615
1616        menu.add(0, MENU_SETTINGS, 0, R.string.menu_settings)
1617                .setIcon(android.R.drawable.ic_menu_preferences).setAlphabeticShortcut('P')
1618                .setIntent(settings);
1619
1620        return true;
1621    }
1622
1623    @Override
1624    public boolean onPrepareOptionsMenu(Menu menu) {
1625        super.onPrepareOptionsMenu(menu);
1626
1627        if (mAllAppsGrid != null) {
1628            // If all apps is animating, don't show the menu, because we don't know
1629            // which one to show.
1630            if (mAllAppsGrid.isAnimating()) {
1631                return false;
1632            }
1633
1634            // Only show the add and wallpaper options when we're not in all apps.
1635            boolean visible = !mAllAppsGrid.isVisible();
1636            menu.setGroupVisible(MENU_GROUP_ADD, visible);
1637            menu.setGroupVisible(MENU_GROUP_WALLPAPER, visible);
1638
1639            // Disable add if the workspace is full.
1640            if (visible) {
1641                CellLayout layout = (CellLayout) mWorkspace.getChildAt(mWorkspace.getCurrentPage());
1642                menu.setGroupEnabled(MENU_GROUP_ADD, layout.existsEmptyCell());
1643            }
1644        }
1645
1646        // TODO-APPS_CUSTOMIZE: Remove this for the phone UI at some point, along with all the menu
1647        // related code?
1648        if (mAppsCustomizeContent != null && mAppsCustomizeContent.isAnimating()) return false;
1649
1650        return true;
1651    }
1652
1653    @Override
1654    public boolean onOptionsItemSelected(MenuItem item) {
1655        switch (item.getItemId()) {
1656            case MENU_ADD:
1657                addItems();
1658                return true;
1659            case MENU_MANAGE_APPS:
1660                manageApps();
1661                return true;
1662            case MENU_WALLPAPER_SETTINGS:
1663                startWallpaper();
1664                return true;
1665            case MENU_SEARCH:
1666                onSearchRequested();
1667                return true;
1668            case MENU_NOTIFICATIONS:
1669                showNotifications();
1670                return true;
1671        }
1672
1673        return super.onOptionsItemSelected(item);
1674    }
1675
1676    /**
1677     * Indicates that we want global search for this activity by setting the globalSearch
1678     * argument for {@link #startSearch} to true.
1679     */
1680
1681    @Override
1682    public boolean onSearchRequested() {
1683        startSearch(null, false, null, true);
1684        return true;
1685    }
1686
1687    public boolean isWorkspaceLocked() {
1688        return mWorkspaceLoading || mWaitingForResult;
1689    }
1690
1691    // Is the workspace preview (brought up by long-pressing on a signpost icon) visible?
1692    private boolean isPreviewVisible() {
1693        return (mPreviousView != null && mPreviousView.getTag() != null) ||
1694                (mNextView != null && mNextView.getTag() != null);
1695    }
1696
1697    private void addItems() {
1698        if (LauncherApplication.isScreenXLarge()) {
1699            // Animate the widget chooser up from the bottom of the screen
1700            if (mState != State.CUSTOMIZE) {
1701                showCustomizationDrawer(true);
1702            }
1703        } else {
1704            showWorkspace(true);
1705            showAddDialog(-1, -1);
1706        }
1707    }
1708
1709    private void resetAddInfo() {
1710        mAddScreen = -1;
1711        mAddIntersectCellX = -1;
1712        mAddIntersectCellY = -1;
1713        mAddDropPosition = null;
1714    }
1715
1716    void addAppWidgetFromDrop(PendingAddWidgetInfo info, int screen, int[] position) {
1717        resetAddInfo();
1718        mAddScreen = screen;
1719        mAddDropPosition = position;
1720
1721        int appWidgetId = getAppWidgetHost().allocateAppWidgetId();
1722        AppWidgetManager.getInstance(this).bindAppWidgetId(appWidgetId, info.componentName);
1723        addAppWidgetImpl(appWidgetId, info);
1724    }
1725
1726    private void manageApps() {
1727        startActivity(new Intent(android.provider.Settings.ACTION_MANAGE_ALL_APPLICATIONS_SETTINGS));
1728    }
1729
1730    void addAppWidgetFromPick(Intent data) {
1731        // TODO: catch bad widget exception when sent
1732        int appWidgetId = data.getIntExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, -1);
1733        // TODO: Is this log message meaningful?
1734        if (LOGD) Log.d(TAG, "dumping extras content=" + data.getExtras());
1735        addAppWidgetImpl(appWidgetId, null);
1736    }
1737
1738    void addAppWidgetImpl(int appWidgetId, PendingAddWidgetInfo info) {
1739        AppWidgetProviderInfo appWidget = mAppWidgetManager.getAppWidgetInfo(appWidgetId);
1740
1741        if (appWidget.configure != null) {
1742            // Launch over to configure widget, if needed
1743            Intent intent = new Intent(AppWidgetManager.ACTION_APPWIDGET_CONFIGURE);
1744            intent.setComponent(appWidget.configure);
1745            intent.putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, appWidgetId);
1746            if (info != null) {
1747                if (info.mimeType != null && !info.mimeType.isEmpty()) {
1748                    intent.putExtra(
1749                            InstallWidgetReceiver.EXTRA_APPWIDGET_CONFIGURATION_DATA_MIME_TYPE,
1750                            info.mimeType);
1751
1752                    final String mimeType = info.mimeType;
1753                    final ClipData clipData = (ClipData) info.configurationData;
1754                    final ClipDescription clipDesc = clipData.getDescription();
1755                    for (int i = 0; i < clipDesc.getMimeTypeCount(); ++i) {
1756                        if (clipDesc.getMimeType(i).equals(mimeType)) {
1757                            final ClipData.Item item = clipData.getItemAt(i);
1758                            final CharSequence stringData = item.getText();
1759                            final Uri uriData = item.getUri();
1760                            final Intent intentData = item.getIntent();
1761                            final String key =
1762                                InstallWidgetReceiver.EXTRA_APPWIDGET_CONFIGURATION_DATA;
1763                            if (uriData != null) {
1764                                intent.putExtra(key, uriData);
1765                            } else if (intentData != null) {
1766                                intent.putExtra(key, intentData);
1767                            } else if (stringData != null) {
1768                                intent.putExtra(key, stringData);
1769                            }
1770                            break;
1771                        }
1772                    }
1773                }
1774            }
1775
1776            startActivityForResultSafely(intent, REQUEST_CREATE_APPWIDGET);
1777        } else {
1778            // Otherwise just add it
1779            completeAddAppWidget(appWidgetId, mAddScreen);
1780        }
1781    }
1782
1783    void processShortcutFromDrop(ComponentName componentName, int screen, int[] position) {
1784        resetAddInfo();
1785        mAddScreen = screen;
1786        mAddDropPosition = position;
1787
1788        Intent createShortcutIntent = new Intent(Intent.ACTION_CREATE_SHORTCUT);
1789        createShortcutIntent.setComponent(componentName);
1790        processShortcut(createShortcutIntent);
1791    }
1792
1793    void processShortcut(Intent intent) {
1794        // Handle case where user selected "Applications"
1795        String applicationName = getResources().getString(R.string.group_applications);
1796        String shortcutName = intent.getStringExtra(Intent.EXTRA_SHORTCUT_NAME);
1797
1798        if (applicationName != null && applicationName.equals(shortcutName)) {
1799            Intent mainIntent = new Intent(Intent.ACTION_MAIN, null);
1800            mainIntent.addCategory(Intent.CATEGORY_LAUNCHER);
1801
1802            Intent pickIntent = new Intent(Intent.ACTION_PICK_ACTIVITY);
1803            pickIntent.putExtra(Intent.EXTRA_INTENT, mainIntent);
1804            pickIntent.putExtra(Intent.EXTRA_TITLE, getText(R.string.title_select_application));
1805            startActivityForResultSafely(pickIntent, REQUEST_PICK_APPLICATION);
1806        } else {
1807            startActivityForResultSafely(intent, REQUEST_CREATE_SHORTCUT);
1808        }
1809    }
1810
1811    void processWallpaper(Intent intent) {
1812        startActivityForResult(intent, REQUEST_PICK_WALLPAPER);
1813    }
1814
1815    FolderIcon addFolder(int screen, int intersectCellX, int intersectCellY) {
1816        FolderInfo folderInfo = new FolderInfo();
1817        folderInfo.title = getText(R.string.folder_name);
1818
1819        final CellLayout layout = (CellLayout) mWorkspace.getChildAt(screen);
1820        final int[] cellXY = mTmpAddItemCellCoordinates;
1821        if (!layout.findCellForSpanThatIntersects(cellXY, 1, 1, intersectCellX, intersectCellY)) {
1822            showOutOfSpaceMessage();
1823            return null;
1824        }
1825
1826        // Update the model
1827        LauncherModel.addItemToDatabase(this, folderInfo,
1828                LauncherSettings.Favorites.CONTAINER_DESKTOP,
1829                screen, cellXY[0], cellXY[1], false);
1830        sFolders.put(folderInfo.id, folderInfo);
1831
1832        // Create the view
1833        FolderIcon newFolder = FolderIcon.fromXml(R.layout.folder_icon, this,
1834                (ViewGroup) mWorkspace.getChildAt(mWorkspace.getCurrentPage()),
1835                folderInfo, mIconCache);
1836        mWorkspace.addInScreen(newFolder, screen, cellXY[0], cellXY[1], 1, 1, isWorkspaceLocked());
1837        return newFolder;
1838    }
1839
1840    void removeFolder(FolderInfo folder) {
1841        sFolders.remove(folder.id);
1842    }
1843
1844    private void showNotifications() {
1845        final StatusBarManager statusBar = (StatusBarManager) getSystemService(STATUS_BAR_SERVICE);
1846        if (statusBar != null) {
1847            statusBar.expand();
1848        }
1849    }
1850
1851    private void startWallpaper() {
1852        showWorkspace(true);
1853        final Intent pickWallpaper = new Intent(Intent.ACTION_SET_WALLPAPER);
1854        Intent chooser = Intent.createChooser(pickWallpaper,
1855                getText(R.string.chooser_wallpaper));
1856        // NOTE: Adds a configure option to the chooser if the wallpaper supports it
1857        //       Removed in Eclair MR1
1858//        WallpaperManager wm = (WallpaperManager)
1859//                getSystemService(Context.WALLPAPER_SERVICE);
1860//        WallpaperInfo wi = wm.getWallpaperInfo();
1861//        if (wi != null && wi.getSettingsActivity() != null) {
1862//            LabeledIntent li = new LabeledIntent(getPackageName(),
1863//                    R.string.configure_wallpaper, 0);
1864//            li.setClassName(wi.getPackageName(), wi.getSettingsActivity());
1865//            chooser.putExtra(Intent.EXTRA_INITIAL_INTENTS, new Intent[] { li });
1866//        }
1867        startActivityForResult(chooser, REQUEST_PICK_WALLPAPER);
1868    }
1869
1870    /**
1871     * Registers various content observers. The current implementation registers
1872     * only a favorites observer to keep track of the favorites applications.
1873     */
1874    private void registerContentObservers() {
1875        ContentResolver resolver = getContentResolver();
1876        resolver.registerContentObserver(LauncherProvider.CONTENT_APPWIDGET_RESET_URI,
1877                true, mWidgetObserver);
1878    }
1879
1880    @Override
1881    public boolean dispatchKeyEvent(KeyEvent event) {
1882        if (event.getAction() == KeyEvent.ACTION_DOWN) {
1883            switch (event.getKeyCode()) {
1884                case KeyEvent.KEYCODE_HOME:
1885                    return true;
1886                case KeyEvent.KEYCODE_VOLUME_DOWN:
1887                    if (SystemProperties.getInt("debug.launcher2.dumpstate", 0) != 0) {
1888                        dumpState();
1889                        return true;
1890                    }
1891                    break;
1892            }
1893        } else if (event.getAction() == KeyEvent.ACTION_UP) {
1894            switch (event.getKeyCode()) {
1895                case KeyEvent.KEYCODE_HOME:
1896                    return true;
1897            }
1898        }
1899
1900        return super.dispatchKeyEvent(event);
1901    }
1902
1903    @Override
1904    public void onBackPressed() {
1905        if (mState == State.ALL_APPS || mState == State.CUSTOMIZE || mState == State.APPS_CUSTOMIZE) {
1906            showWorkspace(true);
1907        } else if (mWorkspace.getOpenFolder() != null) {
1908            closeFolder();
1909        } else if (isPreviewVisible()) {
1910            dismissPreview(mPreviousView);
1911            dismissPreview(mNextView);
1912        } else {
1913            mWorkspace.exitWidgetResizeMode();
1914
1915            // Back button is a no-op here, but give at least some feedback for the button press
1916            mWorkspace.showOutlinesTemporarily();
1917        }
1918    }
1919
1920    private void closeFolder() {
1921        Folder folder = mWorkspace.getOpenFolder();
1922        if (folder != null) {
1923            closeFolder(folder);
1924        }
1925    }
1926
1927    void closeFolder(Folder folder) {
1928        folder.getInfo().opened = false;
1929
1930        ViewGroup parent = (ViewGroup) folder.getParent().getParent();
1931        if (parent != null) {
1932            CellLayout cl = (CellLayout) parent;
1933            mDragController.removeDropTarget((DropTarget)folder);
1934        }
1935
1936        folder.animateClosed();
1937        folder.onClose();
1938    }
1939
1940    /**
1941     * Re-listen when widgets are reset.
1942     */
1943    private void onAppWidgetReset() {
1944        if (mAppWidgetHost != null) {
1945            mAppWidgetHost.startListening();
1946        }
1947    }
1948
1949    /**
1950     * Go through the and disconnect any of the callbacks in the drawables and the views or we
1951     * leak the previous Home screen on orientation change.
1952     */
1953    private void unbindDesktopItems() {
1954        for (ItemInfo item: mDesktopItems) {
1955            item.unbind();
1956        }
1957        mDesktopItems.clear();
1958    }
1959
1960    /**
1961     * Launches the intent referred by the clicked shortcut.
1962     *
1963     * @param v The view representing the clicked shortcut.
1964     */
1965    public void onClick(View v) {
1966        Object tag = v.getTag();
1967        if (tag instanceof ShortcutInfo) {
1968            // Open shortcut
1969            final Intent intent = ((ShortcutInfo) tag).intent;
1970            int[] pos = new int[2];
1971            v.getLocationOnScreen(pos);
1972            intent.setSourceBounds(new Rect(pos[0], pos[1],
1973                    pos[0] + v.getWidth(), pos[1] + v.getHeight()));
1974            boolean success = startActivitySafely(intent, tag);
1975
1976            if (success && v instanceof BubbleTextView) {
1977                mWaitingForResume = (BubbleTextView) v;
1978                mWaitingForResume.setStayPressed(true);
1979            }
1980        } else if (tag instanceof FolderInfo) {
1981            if (v instanceof FolderIcon) {
1982                FolderIcon fi = (FolderIcon) v;
1983                handleFolderClick(fi);
1984            }
1985        } else if (v == mHandleView) {
1986            if (mState == State.ALL_APPS) {
1987                showWorkspace(true);
1988            } else {
1989                showAllApps(true);
1990            }
1991        }
1992    }
1993
1994    public boolean onTouch(View v, MotionEvent event) {
1995        // this is an intercepted event being forwarded from mWorkspace;
1996        // clicking anywhere on the workspace causes the customization drawer to slide down
1997        showWorkspace(true);
1998        return false;
1999    }
2000
2001    /**
2002     * Event handler for the search button
2003     *
2004     * @param v The view that was clicked.
2005     */
2006    public void onClickSearchButton(View v) {
2007        startSearch(null, false, null, true);
2008        // Use a custom animation for launching search
2009        overridePendingTransition(R.anim.fade_in_fast, R.anim.fade_out_fast);
2010    }
2011
2012    /**
2013     * Event handler for the voice button
2014     *
2015     * @param v The view that was clicked.
2016     */
2017    public void onClickVoiceButton(View v) {
2018        startVoiceSearch();
2019    }
2020
2021    private void startVoiceSearch() {
2022        Intent intent = new Intent(RecognizerIntent.ACTION_WEB_SEARCH);
2023        intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
2024        startActivity(intent);
2025    }
2026
2027    /**
2028     * Event handler for the "gear" button that appears on the home screen, which
2029     * enters home screen customization mode.
2030     *
2031     * @param v The view that was clicked.
2032     */
2033    public void onClickConfigureButton(View v) {
2034        addItems();
2035    }
2036
2037    /**
2038     * Event handler for the "grid" button that appears on the home screen, which
2039     * enters all apps mode.
2040     *
2041     * @param v The view that was clicked.
2042     */
2043    public void onClickAllAppsButton(View v) {
2044        showAllApps(true);
2045    }
2046
2047    public void onClickAppMarketButton(View v) {
2048        if (mAppMarketIntent != null) {
2049            startActivitySafely(mAppMarketIntent, "app market");
2050        }
2051    }
2052
2053    void startApplicationDetailsActivity(ComponentName componentName) {
2054        String packageName = componentName.getPackageName();
2055        Intent intent = new Intent(Settings.ACTION_APPLICATION_DETAILS_SETTINGS,
2056                Uri.fromParts("package", packageName, null));
2057        startActivity(intent);
2058    }
2059
2060    void startApplicationUninstallActivity(ApplicationInfo appInfo) {
2061        if ((appInfo.flags & ApplicationInfo.DOWNLOADED_FLAG) == 0) {
2062            // System applications cannot be installed. For now, show a toast explaining that.
2063            // We may give them the option of disabling apps this way.
2064            int messageId = R.string.uninstall_system_app_text;
2065            Toast.makeText(this, messageId, Toast.LENGTH_SHORT).show();
2066        } else {
2067            String packageName = appInfo.componentName.getPackageName();
2068            String className = appInfo.componentName.getClassName();
2069            Intent intent = new Intent(
2070                    Intent.ACTION_DELETE, Uri.fromParts("package", packageName, className));
2071            startActivity(intent);
2072        }
2073    }
2074
2075    boolean startActivitySafely(Intent intent, Object tag) {
2076        intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
2077        try {
2078            startActivity(intent);
2079            return true;
2080        } catch (ActivityNotFoundException e) {
2081            Toast.makeText(this, R.string.activity_not_found, Toast.LENGTH_SHORT).show();
2082            Log.e(TAG, "Unable to launch. tag=" + tag + " intent=" + intent, e);
2083        } catch (SecurityException e) {
2084            Toast.makeText(this, R.string.activity_not_found, Toast.LENGTH_SHORT).show();
2085            Log.e(TAG, "Launcher does not have the permission to launch " + intent +
2086                    ". Make sure to create a MAIN intent-filter for the corresponding activity " +
2087                    "or use the exported attribute for this activity. "
2088                    + "tag="+ tag + " intent=" + intent, e);
2089        }
2090        return false;
2091    }
2092
2093    void startActivityForResultSafely(Intent intent, int requestCode) {
2094        try {
2095            startActivityForResult(intent, requestCode);
2096        } catch (ActivityNotFoundException e) {
2097            Toast.makeText(this, R.string.activity_not_found, Toast.LENGTH_SHORT).show();
2098        } catch (SecurityException e) {
2099            Toast.makeText(this, R.string.activity_not_found, Toast.LENGTH_SHORT).show();
2100            Log.e(TAG, "Launcher does not have the permission to launch " + intent +
2101                    ". Make sure to create a MAIN intent-filter for the corresponding activity " +
2102                    "or use the exported attribute for this activity.", e);
2103        }
2104    }
2105
2106    private void handleFolderClick(FolderIcon folderIcon) {
2107        final FolderInfo info = folderIcon.mInfo;
2108        if (!info.opened) {
2109            // Close any open folder
2110            closeFolder();
2111            // Open the requested folder
2112            openFolder(folderIcon);
2113        } else {
2114            // Find the open folder...
2115            Folder openFolder = mWorkspace.getFolderForTag(info);
2116            int folderScreen;
2117            if (openFolder != null) {
2118                folderScreen = mWorkspace.getPageForView(openFolder);
2119                // .. and close it
2120                closeFolder(openFolder);
2121                if (folderScreen != mWorkspace.getCurrentPage()) {
2122                    // Close any folder open on the current screen
2123                    closeFolder();
2124                    // Pull the folder onto this screen
2125                    openFolder(folderIcon);
2126                }
2127            }
2128        }
2129    }
2130
2131    /**
2132     * Opens the user folder described by the specified tag. The opening of the folder
2133     * is animated relative to the specified View. If the View is null, no animation
2134     * is played.
2135     *
2136     * @param folderInfo The FolderInfo describing the folder to open.
2137     */
2138    public void openFolder(FolderIcon folderIcon) {
2139        Folder folder = folderIcon.mFolder;
2140        FolderInfo info = folder.mInfo;
2141
2142        info.opened = true;
2143
2144        mWorkspace.addInFullScreen(folder, info.screen);
2145        folder.animateOpen();
2146        folder.onOpen();
2147    }
2148
2149    public boolean onLongClick(View v) {
2150        if (mState != State.WORKSPACE) {
2151            return false;
2152        }
2153
2154        switch (v.getId()) {
2155            case R.id.previous_screen:
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            case R.id.next_screen:
2163                if (mState != State.ALL_APPS && mState != State.APPS_CUSTOMIZE) {
2164                    mWorkspace.performHapticFeedback(HapticFeedbackConstants.LONG_PRESS,
2165                            HapticFeedbackConstants.FLAG_IGNORE_VIEW_SETTING);
2166                    showPreviews(v);
2167                }
2168                return true;
2169            case R.id.all_apps_button:
2170                if (mState != State.ALL_APPS && mState != State.APPS_CUSTOMIZE) {
2171                    mWorkspace.performHapticFeedback(HapticFeedbackConstants.LONG_PRESS,
2172                            HapticFeedbackConstants.FLAG_IGNORE_VIEW_SETTING);
2173                    showPreviews(v);
2174                }
2175                return true;
2176        }
2177
2178        if (isWorkspaceLocked()) {
2179            return false;
2180        }
2181
2182        if (!(v instanceof CellLayout)) {
2183            v = (View) v.getParent().getParent();
2184        }
2185
2186        resetAddInfo();
2187        CellLayout.CellInfo longClickCellInfo = (CellLayout.CellInfo) v.getTag();
2188        // This happens when long clicking an item with the dpad/trackball
2189        if (longClickCellInfo == null || !longClickCellInfo.valid) {
2190            return true;
2191        }
2192
2193        final View itemUnderLongClick = longClickCellInfo.cell;
2194
2195        if (mWorkspace.allowLongPress() && !mDragController.isDragging()) {
2196            if (itemUnderLongClick == null) {
2197                // User long pressed on empty space
2198                mWorkspace.setAllowLongPress(false);
2199                mWorkspace.performHapticFeedback(HapticFeedbackConstants.LONG_PRESS,
2200                        HapticFeedbackConstants.FLAG_IGNORE_VIEW_SETTING);
2201                if (LauncherApplication.isScreenXLarge()) {
2202                    addItems();
2203                } else {
2204                    startWallpaper();
2205                }
2206            } else {
2207                if (!(itemUnderLongClick instanceof Folder)) {
2208                    // User long pressed on an item
2209                    mWorkspace.performHapticFeedback(HapticFeedbackConstants.LONG_PRESS,
2210                            HapticFeedbackConstants.FLAG_IGNORE_VIEW_SETTING);
2211                    mAddIntersectCellX = longClickCellInfo.cellX;
2212                    mAddIntersectCellY = longClickCellInfo.cellY;
2213                    mWorkspace.startDrag(longClickCellInfo);
2214                }
2215            }
2216        }
2217        return true;
2218    }
2219
2220    @SuppressWarnings({"unchecked"})
2221    private void dismissPreview(final View v) {
2222        final PopupWindow window = (PopupWindow) v.getTag();
2223        if (window != null) {
2224            window.setOnDismissListener(new PopupWindow.OnDismissListener() {
2225                public void onDismiss() {
2226                    ViewGroup group = (ViewGroup) v.getTag(R.id.workspace);
2227                    int count = group.getChildCount();
2228                    for (int i = 0; i < count; i++) {
2229                        ((ImageView) group.getChildAt(i)).setImageDrawable(null);
2230                    }
2231                    ArrayList<Bitmap> bitmaps =
2232                        (ArrayList<Bitmap>) v.getTag(R.id.all_apps_button_cluster);
2233                    for (Bitmap bitmap : bitmaps) bitmap.recycle();
2234
2235                    v.setTag(R.id.workspace, null);
2236                    v.setTag(R.id.all_apps_button_cluster, null);
2237                    window.setOnDismissListener(null);
2238                }
2239            });
2240            window.dismiss();
2241        }
2242        v.setTag(null);
2243    }
2244
2245    private void showPreviews(View anchor) {
2246        showPreviews(anchor, 0, mWorkspace.getChildCount());
2247    }
2248
2249    private void showPreviews(final View anchor, int start, int end) {
2250        final Resources resources = getResources();
2251        final Workspace workspace = mWorkspace;
2252
2253        CellLayout cell = ((CellLayout) workspace.getChildAt(start));
2254
2255        float max = workspace.getChildCount();
2256
2257        final Rect r = new Rect();
2258        resources.getDrawable(R.drawable.preview_background).getPadding(r);
2259        int extraW = (int) ((r.left + r.right) * max);
2260        int extraH = r.top + r.bottom;
2261
2262        int aW = cell.getWidth() - extraW;
2263        float w = aW / max;
2264
2265        int width = cell.getWidth();
2266        int height = cell.getHeight();
2267        int x = cell.getLeftPadding();
2268        int y = cell.getTopPadding();
2269        width -= (x + cell.getRightPadding());
2270        height -= (y + cell.getBottomPadding());
2271
2272        float scale = w / width;
2273
2274        int count = end - start;
2275
2276        final float sWidth = width * scale;
2277        float sHeight = height * scale;
2278
2279        LinearLayout preview = new LinearLayout(this);
2280
2281        PreviewTouchHandler handler = new PreviewTouchHandler(anchor);
2282        ArrayList<Bitmap> bitmaps = new ArrayList<Bitmap>(count);
2283
2284        for (int i = start; i < end; i++) {
2285            ImageView image = new ImageView(this);
2286            cell = (CellLayout) workspace.getChildAt(i);
2287
2288            final Bitmap bitmap = Bitmap.createBitmap((int) sWidth, (int) sHeight,
2289                    Bitmap.Config.ARGB_8888);
2290
2291            final Canvas c = new Canvas(bitmap);
2292            c.scale(scale, scale);
2293            c.translate(-cell.getLeftPadding(), -cell.getTopPadding());
2294            cell.drawChildren(c);
2295
2296            image.setBackgroundDrawable(resources.getDrawable(R.drawable.preview_background));
2297            image.setImageBitmap(bitmap);
2298            image.setTag(i);
2299            image.setOnClickListener(handler);
2300            image.setOnFocusChangeListener(handler);
2301            image.setFocusable(true);
2302            if (i == mWorkspace.getCurrentPage()) image.requestFocus();
2303
2304            preview.addView(image,
2305                    LinearLayout.LayoutParams.WRAP_CONTENT, LinearLayout.LayoutParams.WRAP_CONTENT);
2306
2307            bitmaps.add(bitmap);
2308        }
2309
2310        final PopupWindow p = new PopupWindow(this);
2311        p.setContentView(preview);
2312        p.setWidth((int) (sWidth * count + extraW));
2313        p.setHeight((int) (sHeight + extraH));
2314        p.setAnimationStyle(R.style.AnimationPreview);
2315        p.setOutsideTouchable(true);
2316        p.setFocusable(true);
2317        p.setBackgroundDrawable(new ColorDrawable(0));
2318        p.showAsDropDown(anchor, 0, 0);
2319
2320        p.setOnDismissListener(new PopupWindow.OnDismissListener() {
2321            public void onDismiss() {
2322                dismissPreview(anchor);
2323            }
2324        });
2325
2326        anchor.setTag(p);
2327        anchor.setTag(R.id.workspace, preview);
2328        anchor.setTag(R.id.all_apps_button_cluster, bitmaps);
2329    }
2330
2331    class PreviewTouchHandler implements View.OnClickListener, Runnable, View.OnFocusChangeListener {
2332        private final View mAnchor;
2333
2334        public PreviewTouchHandler(View anchor) {
2335            mAnchor = anchor;
2336        }
2337
2338        public void onClick(View v) {
2339            mWorkspace.snapToPage((Integer) v.getTag());
2340            v.post(this);
2341        }
2342
2343        public void run() {
2344            dismissPreview(mAnchor);
2345        }
2346
2347        public void onFocusChange(View v, boolean hasFocus) {
2348            if (hasFocus) {
2349                mWorkspace.snapToPage((Integer) v.getTag());
2350            }
2351        }
2352    }
2353
2354    Workspace getWorkspace() {
2355        return mWorkspace;
2356    }
2357
2358    TabHost getCustomizationDrawer() {
2359        return mHomeCustomizationDrawer;
2360    }
2361
2362    @Override
2363    protected Dialog onCreateDialog(int id) {
2364        switch (id) {
2365            case DIALOG_CREATE_SHORTCUT:
2366                return new CreateShortcut().createDialog();
2367            case DIALOG_RENAME_FOLDER:
2368                return new RenameFolder().createDialog();
2369        }
2370
2371        return super.onCreateDialog(id);
2372    }
2373
2374    @Override
2375    protected void onPrepareDialog(int id, Dialog dialog) {
2376        switch (id) {
2377            case DIALOG_CREATE_SHORTCUT:
2378                break;
2379            case DIALOG_RENAME_FOLDER:
2380                if (mFolderInfo != null) {
2381                    EditText input = (EditText) dialog.findViewById(R.id.folder_name);
2382                    final CharSequence text = mFolderInfo.title;
2383                    input.setText(text);
2384                    input.setSelection(0, text.length());
2385                }
2386                break;
2387        }
2388    }
2389
2390    void showRenameDialog(FolderInfo info) {
2391        mFolderInfo = info;
2392        mWaitingForResult = true;
2393        showDialog(DIALOG_RENAME_FOLDER);
2394    }
2395
2396    private void showAddDialog(int intersectX, int intersectY) {
2397        resetAddInfo();
2398        mAddIntersectCellX = intersectX;
2399        mAddIntersectCellY = intersectY;
2400        mAddScreen = mWorkspace.getCurrentPage();
2401        mWaitingForResult = true;
2402        showDialog(DIALOG_CREATE_SHORTCUT);
2403    }
2404
2405    private void pickShortcut() {
2406        // Insert extra item to handle picking application
2407        Bundle bundle = new Bundle();
2408
2409        ArrayList<String> shortcutNames = new ArrayList<String>();
2410        shortcutNames.add(getString(R.string.group_applications));
2411        bundle.putStringArrayList(Intent.EXTRA_SHORTCUT_NAME, shortcutNames);
2412
2413        ArrayList<ShortcutIconResource> shortcutIcons = new ArrayList<ShortcutIconResource>();
2414        shortcutIcons.add(ShortcutIconResource.fromContext(Launcher.this,
2415                        R.drawable.ic_launcher_application));
2416        bundle.putParcelableArrayList(Intent.EXTRA_SHORTCUT_ICON_RESOURCE, shortcutIcons);
2417
2418        Intent pickIntent = new Intent(Intent.ACTION_PICK_ACTIVITY);
2419        pickIntent.putExtra(Intent.EXTRA_INTENT, new Intent(Intent.ACTION_CREATE_SHORTCUT));
2420        pickIntent.putExtra(Intent.EXTRA_TITLE, getText(R.string.title_select_shortcut));
2421        pickIntent.putExtras(bundle);
2422
2423        startActivityForResult(pickIntent, REQUEST_PICK_SHORTCUT);
2424    }
2425
2426    private class RenameFolder {
2427        private EditText mInput;
2428
2429        Dialog createDialog() {
2430            final View layout = View.inflate(Launcher.this, R.layout.rename_folder, null);
2431            mInput = (EditText) layout.findViewById(R.id.folder_name);
2432
2433            AlertDialog.Builder builder = new AlertDialog.Builder(Launcher.this);
2434            builder.setIcon(0);
2435            builder.setTitle(getString(R.string.rename_folder_title));
2436            builder.setCancelable(true);
2437            builder.setOnCancelListener(new Dialog.OnCancelListener() {
2438                public void onCancel(DialogInterface dialog) {
2439                    cleanup();
2440                }
2441            });
2442            builder.setNegativeButton(getString(R.string.cancel_action),
2443                new Dialog.OnClickListener() {
2444                    public void onClick(DialogInterface dialog, int which) {
2445                        cleanup();
2446                    }
2447                }
2448            );
2449            builder.setPositiveButton(getString(R.string.rename_action),
2450                new Dialog.OnClickListener() {
2451                    public void onClick(DialogInterface dialog, int which) {
2452                        changeFolderName();
2453                    }
2454                }
2455            );
2456            builder.setView(layout);
2457
2458            final AlertDialog dialog = builder.create();
2459            dialog.setOnShowListener(new DialogInterface.OnShowListener() {
2460                public void onShow(DialogInterface dialog) {
2461                    mWaitingForResult = true;
2462                    mInput.requestFocus();
2463                    InputMethodManager inputManager = (InputMethodManager)
2464                            getSystemService(Context.INPUT_METHOD_SERVICE);
2465                    inputManager.showSoftInput(mInput, 0);
2466                }
2467            });
2468
2469            return dialog;
2470        }
2471
2472        private void changeFolderName() {
2473            final String name = mInput.getText().toString();
2474            if (!TextUtils.isEmpty(name)) {
2475                // Make sure we have the right folder info
2476                mFolderInfo = sFolders.get(mFolderInfo.id);
2477                mFolderInfo.title = name;
2478                LauncherModel.updateItemInDatabase(Launcher.this, mFolderInfo);
2479
2480                if (mWorkspaceLoading) {
2481                    lockAllApps();
2482                    mModel.startLoader(Launcher.this, false);
2483                } else {
2484                    final FolderIcon folderIcon = (FolderIcon)
2485                            mWorkspace.getViewForTag(mFolderInfo);
2486                    if (folderIcon != null) {
2487                        // TODO: At some point we'll probably want some version of setting
2488                        // the text for a folder icon.
2489                        //folderIcon.setText(name);
2490                        getWorkspace().requestLayout();
2491                    } else {
2492                        lockAllApps();
2493                        mWorkspaceLoading = true;
2494                        mModel.startLoader(Launcher.this, false);
2495                    }
2496                }
2497            }
2498            cleanup();
2499        }
2500
2501        private void cleanup() {
2502            dismissDialog(DIALOG_RENAME_FOLDER);
2503            mWaitingForResult = false;
2504            mFolderInfo = null;
2505        }
2506    }
2507
2508    // Now a part of LauncherModel.Callbacks. Used to reorder loading steps.
2509    public boolean isAllAppsVisible() {
2510        return (mState == State.ALL_APPS) || (mState == State.APPS_CUSTOMIZE);
2511    }
2512
2513    // AllAppsView.Watcher
2514    public void zoomed(float zoom) {
2515        // In XLarge view, we zoom down the workspace below all apps so it's still visible
2516        if (zoom == 1.0f && !LauncherApplication.isScreenXLarge()) {
2517            mWorkspace.setVisibility(View.GONE);
2518        }
2519    }
2520
2521    private void showAndEnableToolbarButton(View button) {
2522        button.setVisibility(View.VISIBLE);
2523    }
2524
2525    private void hideToolbarButton(View button) {
2526        // We can't set it to GONE, otherwise the RelativeLayout gets screwed up
2527        button.setVisibility(View.INVISIBLE);
2528        button.setAlpha(0.0f);
2529    }
2530
2531    /**
2532     * Helper function for showing or hiding a toolbar button, possibly animated.
2533     *
2534     * @param show If true, create an animation to the show the item. Otherwise, hide it.
2535     * @param view The toolbar button to be animated
2536     * @param seq A AnimatorSet that will be used to animate the transition. If null, the
2537     * transition will not be animated.
2538     */
2539    private void hideOrShowToolbarButton(boolean show, final View view, AnimatorSet seq) {
2540        final boolean showing = show;
2541        final boolean hiding = !show;
2542
2543        final int duration = show ?
2544                getResources().getInteger(R.integer.config_toolbarButtonFadeInTime) :
2545                getResources().getInteger(R.integer.config_toolbarButtonFadeOutTime);
2546
2547        if (seq != null) {
2548            ValueAnimator anim = ValueAnimator.ofFloat(view.getAlpha(), show ? 1.0f : 0.0f);
2549            anim.setDuration(duration);
2550            anim.addUpdateListener(new AnimatorUpdateListener() {
2551                public void onAnimationUpdate(ValueAnimator animation) {
2552                    view.setAlpha((Float) animation.getAnimatedValue());
2553                }
2554            });
2555            anim.addListener(new AnimatorListenerAdapter() {
2556                @Override
2557                public void onAnimationStart(Animator animation) {
2558                    if (showing) showAndEnableToolbarButton(view);
2559                }
2560                @Override
2561                public void onAnimationEnd(Animator animation) {
2562                    if (hiding) hideToolbarButton(view);
2563                }
2564            });
2565            seq.play(anim);
2566        } else {
2567            if (showing) {
2568                showAndEnableToolbarButton(view);
2569                view.setAlpha(1f);
2570            } else {
2571                hideToolbarButton(view);
2572            }
2573        }
2574    }
2575
2576    /**
2577     * Show/hide the appropriate toolbar buttons for newState.
2578     * If showSeq or hideSeq is null, the transition will be done immediately (not animated).
2579     *
2580     * @param newState The state that is being switched to
2581     * @param showSeq AnimatorSet in which to put "show" animations, or null.
2582     * @param hideSeq AnimatorSet in which to put "hide" animations, or null.
2583     */
2584    private void hideAndShowToolbarButtons(State newState, AnimatorSet showSeq, AnimatorSet hideSeq) {
2585        switch (newState) {
2586        case WORKSPACE:
2587            hideOrShowToolbarButton(true, mButtonCluster, showSeq);
2588            mDeleteZone.setDragAndDropEnabled(true);
2589            if (LauncherApplication.isScreenXLarge()) {
2590                mDeleteZone.setText(getResources().getString(R.string.delete_zone_label_workspace));
2591            }
2592            break;
2593        case ALL_APPS:
2594        case APPS_CUSTOMIZE:
2595            hideOrShowToolbarButton(false, mButtonCluster, hideSeq);
2596            mDeleteZone.setDragAndDropEnabled(false);
2597            if (LauncherApplication.isScreenXLarge()) {
2598                mDeleteZone.setText(getResources().getString(R.string.delete_zone_label_all_apps));
2599            }
2600            break;
2601        case CUSTOMIZE:
2602            hideOrShowToolbarButton(false, mButtonCluster, hideSeq);
2603            mDeleteZone.setDragAndDropEnabled(false);
2604            break;
2605        }
2606    }
2607
2608    /**
2609     * Helper method for the cameraZoomIn/cameraZoomOut animations
2610     * @param view The view being animated
2611     * @param state The state that we are moving in or out of -- either ALL_APPS or CUSTOMIZE
2612     * @param scaleFactor The scale factor used for the zoom
2613     */
2614    private void setPivotsForZoom(View view, State state, float scaleFactor) {
2615        final int height = view.getHeight();
2616
2617        view.setPivotX(view.getWidth() / 2.0f);
2618        // Set pivotY so that at the starting zoom factor, the view is partially
2619        // visible. Modifying initialHeightFactor changes how much of the view is
2620        // initially showing, and hence the perceived angle from which the view enters.
2621        if (state == State.ALL_APPS || state == State.APPS_CUSTOMIZE) {
2622            final float initialHeightFactor = 0.175f;
2623            view.setPivotY((1 - initialHeightFactor) * height);
2624        } else {
2625            final float initialHeightFactor = 0.2f;
2626            view.setPivotY(-initialHeightFactor * height);
2627        }
2628    }
2629
2630    /**
2631     * Zoom the camera out from the workspace to reveal 'toView'.
2632     * Assumes that the view to show is anchored at either the very top or very bottom
2633     * of the screen.
2634     * @param toState The state to zoom out to. Must be ALL_APPS or CUSTOMIZE.
2635     */
2636    private void cameraZoomOut(State toState, boolean animated, boolean springLoaded) {
2637        final Resources res = getResources();
2638        final boolean toAllApps = (toState == State.ALL_APPS)
2639                || (toState == State.APPS_CUSTOMIZE);
2640
2641        final int duration = (toAllApps ?
2642                res.getInteger(R.integer.config_appsCustomizeZoomInTime) :
2643                res.getInteger(R.integer.config_customizeZoomInTime));
2644        final int fadeDuration = (toAllApps ?
2645                res.getInteger(R.integer.config_appsCustomizeFadeInTime) :
2646                res.getInteger(R.integer.config_customizeFadeInTime));
2647
2648        final float scale = toAllApps ?
2649                (float) res.getInteger(R.integer.config_appsCustomizeZoomScaleFactor) :
2650                (float) res.getInteger(R.integer.config_customizeZoomScaleFactor);
2651
2652        View tmpView;
2653        if (toAllApps) {
2654            tmpView = (LauncherApplication.isScreenXLarge())
2655                    ? (View) mAllAppsGrid : mAppsCustomizeTabHost;
2656        } else {
2657            tmpView = mHomeCustomizationDrawer;
2658        }
2659        final View toView = tmpView;
2660
2661        setPivotsForZoom(toView, toState, scale);
2662
2663        if (toAllApps) {
2664            if (!springLoaded) {
2665                mWorkspace.shrink(ShrinkState.BOTTOM_HIDDEN, animated);
2666
2667                if (LauncherApplication.isScreenXLarge()) {
2668                    // Everytime we launch into AllApps, we reset the successful drop flag which
2669                    // controls when it should hide/show the mini workspaces
2670                    mAllAppsPagedView.resetSuccessfulDropFlag();
2671                }
2672            } else {
2673                mWorkspace.shrink(ShrinkState.BOTTOM_VISIBLE, animated);
2674            }
2675        } else {
2676            mWorkspace.shrink(ShrinkState.TOP, animated);
2677        }
2678
2679        if (animated) {
2680            final ValueAnimator scaleAnim = ValueAnimator.ofFloat(0f, 1f).setDuration(duration);
2681            scaleAnim.setInterpolator(new Workspace.ZoomOutInterpolator());
2682            scaleAnim.addUpdateListener(new LauncherAnimatorUpdateListener() {
2683                public void onAnimationUpdate(float a, float b) {
2684                    ((View) toView.getParent()).fastInvalidate();
2685                    toView.setFastScaleX(a * scale + b * 1f);
2686                    toView.setFastScaleY(a * scale + b * 1f);
2687                }
2688            });
2689
2690            if (toAllApps) {
2691                toView.setVisibility(View.VISIBLE);
2692                toView.setFastAlpha(0f);
2693                ValueAnimator alphaAnim = ValueAnimator.ofFloat(0f, 1f).setDuration(fadeDuration);
2694                alphaAnim.setInterpolator(new DecelerateInterpolator(1.5f));
2695                alphaAnim.addUpdateListener(new LauncherAnimatorUpdateListener() {
2696                    public void onAnimationUpdate(float a, float b) {
2697                        // don't need to invalidate because we do so above
2698                        toView.setFastAlpha(a * 0f + b * 1f);
2699                    }
2700                });
2701                alphaAnim.start();
2702            }
2703
2704            if (toView instanceof LauncherTransitionable) {
2705                ((LauncherTransitionable) toView).onLauncherTransitionStart(scaleAnim);
2706            }
2707            scaleAnim.addListener(new AnimatorListenerAdapter() {
2708                @Override
2709                public void onAnimationStart(Animator animation) {
2710                    // Prepare the position
2711                    toView.setTranslationX(0.0f);
2712                    toView.setTranslationY(0.0f);
2713                    toView.setVisibility(View.VISIBLE);
2714                    toView.bringToFront();
2715                    if (!toAllApps) {
2716                        toView.setFastAlpha(1.0f);
2717                    }
2718                }
2719                @Override
2720                public void onAnimationEnd(Animator animation) {
2721                    // If we don't set the final scale values here, if this animation is cancelled
2722                    // it will have the wrong scale value and subsequent cameraPan animations will
2723                    // not fix that
2724                    toView.setScaleX(1.0f);
2725                    toView.setScaleY(1.0f);
2726                    if (toView instanceof LauncherTransitionable) {
2727                        ((LauncherTransitionable) toView).onLauncherTransitionEnd(scaleAnim);
2728                    }
2729                }
2730            });
2731
2732            AnimatorSet toolbarHideAnim = new AnimatorSet();
2733            AnimatorSet toolbarShowAnim = new AnimatorSet();
2734            hideAndShowToolbarButtons(toState, toolbarShowAnim, toolbarHideAnim);
2735
2736            // toView should appear right at the end of the workspace shrink animation
2737            final int startDelay = 0;
2738
2739            if (mStateAnimation != null) mStateAnimation.cancel();
2740            mStateAnimation = new AnimatorSet();
2741            mStateAnimation.playTogether(scaleAnim, toolbarHideAnim);
2742            mStateAnimation.play(scaleAnim).after(startDelay);
2743
2744            // Show the new toolbar buttons just as the main animation is ending
2745            final int fadeInTime = res.getInteger(R.integer.config_toolbarButtonFadeInTime);
2746            mStateAnimation.play(toolbarShowAnim).after(duration + startDelay - fadeInTime);
2747            mStateAnimation.start();
2748        } else {
2749            toView.setTranslationX(0.0f);
2750            toView.setTranslationY(0.0f);
2751            toView.setScaleX(1.0f);
2752            toView.setScaleY(1.0f);
2753            toView.setVisibility(View.VISIBLE);
2754            toView.bringToFront();
2755            if (toView instanceof LauncherTransitionable) {
2756                ((LauncherTransitionable) toView).onLauncherTransitionStart(null);
2757                ((LauncherTransitionable) toView).onLauncherTransitionEnd(null);
2758            }
2759            hideAndShowToolbarButtons(toState, null, null);
2760        }
2761    }
2762
2763    /**
2764     * Zoom the camera back into the workspace, hiding 'fromView'.
2765     * This is the opposite of cameraZoomOut.
2766     * @param fromState The current state (must be ALL_APPS or CUSTOMIZE).
2767     * @param animated If true, the transition will be animated.
2768     */
2769    private void cameraZoomIn(State fromState, boolean animated, boolean springLoaded) {
2770        Resources res = getResources();
2771        final boolean fromAllApps = (fromState == State.ALL_APPS)
2772                || (fromState == State.APPS_CUSTOMIZE);
2773
2774        int duration = fromAllApps ?
2775            res.getInteger(R.integer.config_appsCustomizeZoomOutTime) :
2776            res.getInteger(R.integer.config_customizeZoomOutTime);
2777
2778        final float scaleFactor = fromAllApps ?
2779            (float) res.getInteger(R.integer.config_appsCustomizeZoomScaleFactor) :
2780            (float) res.getInteger(R.integer.config_customizeZoomScaleFactor);
2781
2782        View tmpView;
2783        if (fromAllApps) {
2784            tmpView = (LauncherApplication.isScreenXLarge())
2785                    ? (View) mAllAppsGrid : mAppsCustomizeTabHost;
2786        } else {
2787            tmpView = mHomeCustomizationDrawer;
2788        }
2789        final View fromView = tmpView;
2790
2791        if (LauncherApplication.isScreenXLarge()) {
2792            mCustomizePagedView.endChoiceMode();
2793            mAllAppsPagedView.endChoiceMode();
2794        }
2795
2796        setPivotsForZoom(fromView, fromState, scaleFactor);
2797
2798        if (!springLoaded) {
2799            mWorkspace.unshrink(animated);
2800        }
2801        if (animated) {
2802            if (mStateAnimation != null) mStateAnimation.cancel();
2803            mStateAnimation = new AnimatorSet();
2804
2805            final float oldScaleX = fromView.getScaleX();
2806            final float oldScaleY = fromView.getScaleY();
2807
2808            ValueAnimator scaleAnim = ValueAnimator.ofFloat(0f, 1f).setDuration(duration);
2809            scaleAnim.setInterpolator(new Workspace.ZoomInInterpolator());
2810            scaleAnim.addUpdateListener(new LauncherAnimatorUpdateListener() {
2811                public void onAnimationUpdate(float a, float b) {
2812                    ((View)fromView.getParent()).fastInvalidate();
2813                    fromView.setFastScaleX(a * oldScaleX + b * scaleFactor);
2814                    fromView.setFastScaleY(a * oldScaleY + b * scaleFactor);
2815                }
2816            });
2817            final ValueAnimator alphaAnim = ValueAnimator.ofFloat(0f, 1f);
2818            alphaAnim.setDuration(res.getInteger(R.integer.config_appsCustomizeFadeOutTime));
2819            alphaAnim.setInterpolator(new DecelerateInterpolator(1.5f));
2820            alphaAnim.addUpdateListener(new LauncherAnimatorUpdateListener() {
2821                public void onAnimationUpdate(float a, float b) {
2822                    // don't need to invalidate because we do so above
2823                    fromView.setFastAlpha(a * 1f + b * 0f);
2824                }
2825            });
2826            if (fromView instanceof LauncherTransitionable) {
2827                ((LauncherTransitionable) fromView).onLauncherTransitionStart(alphaAnim);
2828            }
2829            alphaAnim.addListener(new AnimatorListenerAdapter() {
2830                @Override
2831                public void onAnimationEnd(Animator animation) {
2832                    fromView.setVisibility(View.GONE);
2833                    if (fromView instanceof LauncherTransitionable) {
2834                        ((LauncherTransitionable) fromView).onLauncherTransitionEnd(alphaAnim);
2835                    }
2836                }
2837            });
2838
2839            AnimatorSet toolbarHideAnim = new AnimatorSet();
2840            AnimatorSet toolbarShowAnim = new AnimatorSet();
2841            if (!springLoaded) {
2842                hideAndShowToolbarButtons(State.WORKSPACE, toolbarShowAnim, toolbarHideAnim);
2843            }
2844
2845            mStateAnimation.playTogether(scaleAnim, toolbarHideAnim, alphaAnim);
2846
2847            // Show the new toolbar buttons at the very end of the whole animation
2848            final int fadeInTime = res.getInteger(R.integer.config_toolbarButtonFadeInTime);
2849            final int unshrinkTime = res.getInteger(R.integer.config_workspaceUnshrinkTime);
2850            mStateAnimation.play(toolbarShowAnim).after(unshrinkTime - fadeInTime);
2851            mStateAnimation.start();
2852        } else {
2853            fromView.setVisibility(View.GONE);
2854            if (fromView instanceof LauncherTransitionable) {
2855                ((LauncherTransitionable) fromView).onLauncherTransitionStart(null);
2856                ((LauncherTransitionable) fromView).onLauncherTransitionEnd(null);
2857            }
2858            if (!springLoaded) {
2859                hideAndShowToolbarButtons(State.WORKSPACE, null, null);
2860            }
2861        }
2862    }
2863
2864    void showWorkspace(boolean animated) {
2865        showWorkspace(animated, null);
2866    }
2867
2868    void showWorkspace(boolean animated, CellLayout layout) {
2869        if (layout != null) {
2870            // always animated, but that's ok since we never specify a layout and
2871            // want no animation
2872            mWorkspace.unshrink(layout);
2873        } else {
2874            mWorkspace.unshrink(animated);
2875        }
2876        if (mState == State.ALL_APPS || mState == State.APPS_CUSTOMIZE) {
2877            closeAllApps(animated);
2878        } else if (mState == State.CUSTOMIZE) {
2879            hideCustomizationDrawer(animated);
2880        }
2881
2882        // Change the state *after* we've called all the transition code
2883        mState = State.WORKSPACE;
2884
2885        // Resume the auto-advance of widgets
2886        mUserPresent = true;
2887        updateRunning();
2888
2889        // send an accessibility event to announce the context change
2890        getWindow().getDecorView().sendAccessibilityEvent(AccessibilityEvent.TYPE_VIEW_SELECTED);
2891    }
2892
2893    void enterSpringLoadedDragMode(CellLayout layout) {
2894        mWorkspace.enterSpringLoadedDragMode(layout);
2895        if (mState == State.ALL_APPS || mState == State.APPS_CUSTOMIZE) {
2896            mState = State.ALL_APPS_SPRING_LOADED;
2897            if (LauncherApplication.isScreenXLarge()) {
2898                cameraZoomIn(State.ALL_APPS, true, true);
2899            } else {
2900                cameraZoomIn(State.APPS_CUSTOMIZE, true, true);
2901            }
2902        } else if (mState == State.CUSTOMIZE) {
2903            mState = State.CUSTOMIZE_SPRING_LOADED;
2904            cameraZoomIn(State.CUSTOMIZE, true, true);
2905        }/* else {
2906            // we're already in spring loaded mode; don't do anything
2907        }*/
2908    }
2909
2910    void exitSpringLoadedDragMode() {
2911        if (mState == State.ALL_APPS_SPRING_LOADED) {
2912            mWorkspace.exitSpringLoadedDragMode(Workspace.ShrinkState.BOTTOM_VISIBLE);
2913            if (LauncherApplication.isScreenXLarge()) {
2914                cameraZoomOut(State.ALL_APPS, true, true);
2915                mState = State.ALL_APPS;
2916            } else {
2917                cameraZoomOut(State.APPS_CUSTOMIZE, true, true);
2918                mState = State.APPS_CUSTOMIZE;
2919            }
2920        } else if (mState == State.CUSTOMIZE_SPRING_LOADED) {
2921            mWorkspace.exitSpringLoadedDragMode(Workspace.ShrinkState.TOP);
2922            cameraZoomOut(State.CUSTOMIZE, true, true);
2923            mState = State.CUSTOMIZE;
2924        }/* else {
2925            // we're not in spring loaded mode; don't do anything
2926        }*/
2927    }
2928
2929    void showAllApps(boolean animated) {
2930        if (mState != State.WORKSPACE) return;
2931        if (LauncherApplication.isScreenXLarge()) {
2932            cameraZoomOut(State.ALL_APPS, animated, false);
2933            ((View) mAllAppsGrid).requestFocus();
2934
2935            // TODO: fade these two too
2936            mDeleteZone.setVisibility(View.GONE);
2937
2938            // Change the state *after* we've called all the transition code
2939            mState = State.ALL_APPS;
2940        } else {
2941            View appsCustomizePane = findViewById(R.id.apps_customize_pane);
2942            cameraZoomOut(State.APPS_CUSTOMIZE, animated, false);
2943            appsCustomizePane.requestFocus();
2944
2945            // Change the state *after* we've called all the transition code
2946            mState = State.APPS_CUSTOMIZE;
2947        }
2948
2949        // Pause the auto-advance of widgets until we are out of AllApps
2950        mUserPresent = false;
2951        updateRunning();
2952
2953        // Send an accessibility event to announce the context change
2954        getWindow().getDecorView().sendAccessibilityEvent(AccessibilityEvent.TYPE_VIEW_SELECTED);
2955    }
2956
2957    /**
2958     * Things to test when changing this code.
2959     *   - Home from workspace
2960     *          - from center screen
2961     *          - from other screens
2962     *   - Home from all apps
2963     *          - from center screen
2964     *          - from other screens
2965     *   - Back from all apps
2966     *          - from center screen
2967     *          - from other screens
2968     *   - Launch app from workspace and quit
2969     *          - with back
2970     *          - with home
2971     *   - Launch app from all apps and quit
2972     *          - with back
2973     *          - with home
2974     *   - Go to a screen that's not the default, then all
2975     *     apps, and launch and app, and go back
2976     *          - with back
2977     *          -with home
2978     *   - On workspace, long press power and go back
2979     *          - with back
2980     *          - with home
2981     *   - On all apps, long press power and go back
2982     *          - with back
2983     *          - with home
2984     *   - On workspace, power off
2985     *   - On all apps, power off
2986     *   - Launch an app and turn off the screen while in that app
2987     *          - Go back with home key
2988     *          - Go back with back key  TODO: make this not go to workspace
2989     *          - From all apps
2990     *          - From workspace
2991     *   - Enter and exit car mode (becuase it causes an extra configuration changed)
2992     *          - From all apps
2993     *          - From the center workspace
2994     *          - From another workspace
2995     */
2996    void closeAllApps(boolean animated) {
2997        if (LauncherApplication.isScreenXLarge()) {
2998            if (mState == State.ALL_APPS || mState == State.ALL_APPS_SPRING_LOADED) {
2999                mWorkspace.setVisibility(View.VISIBLE);
3000                cameraZoomIn(State.ALL_APPS, animated, false);
3001
3002                // Set focus to the AllApps button
3003                findViewById(R.id.all_apps_button).requestFocus();
3004            }
3005        } else {
3006            if (mState == State.APPS_CUSTOMIZE || mState == State.ALL_APPS_SPRING_LOADED) {
3007                mWorkspace.setVisibility(View.VISIBLE);
3008                cameraZoomIn(State.APPS_CUSTOMIZE, animated, false);
3009
3010                // Set focus to the AllApps button
3011                findViewById(R.id.all_apps_button).requestFocus();
3012            }
3013        }
3014    }
3015
3016    void lockAllApps() {
3017        // TODO
3018    }
3019
3020    void unlockAllApps() {
3021        // TODO
3022    }
3023
3024    // Show the customization drawer (only exists in x-large configuration)
3025    private void showCustomizationDrawer(boolean animated) {
3026        if (mState != State.WORKSPACE) {
3027            return;
3028        }
3029
3030        cameraZoomOut(State.CUSTOMIZE, animated, false);
3031
3032        // Change the state *after* we've called all the transition code
3033        mState = State.CUSTOMIZE;
3034
3035        // Pause the auto-advance of widgets until we are out of Customization drawer
3036        mUserPresent = false;
3037        updateRunning();
3038    }
3039
3040    // Hide the customization drawer (only exists in x-large configuration)
3041    void hideCustomizationDrawer(boolean animated) {
3042        if (mState == State.CUSTOMIZE || mState == State.CUSTOMIZE_SPRING_LOADED) {
3043            cameraZoomIn(State.CUSTOMIZE, animated, false);
3044
3045            // Set focus to the customize button
3046            findViewById(R.id.configure_button).requestFocus();
3047        }
3048    }
3049
3050    /**
3051     * Add an item from all apps or customize onto the given workspace screen.
3052     * If layout is null, add to the current screen.
3053     */
3054    void addExternalItemToScreen(ItemInfo itemInfo, final CellLayout layout) {
3055        if (!mWorkspace.addExternalItemToScreen(itemInfo, layout)) {
3056            showOutOfSpaceMessage();
3057        } else {
3058            layout.animateDrop();
3059        }
3060    }
3061
3062    void onWorkspaceClick(CellLayout layout) {
3063        showWorkspace(true, layout);
3064    }
3065
3066    private Drawable getExternalPackageToolbarIcon(ComponentName activityName) {
3067        try {
3068            PackageManager packageManager = getPackageManager();
3069            // Look for the toolbar icon specified in the activity meta-data
3070            Bundle metaData = packageManager.getActivityInfo(
3071                    activityName, PackageManager.GET_META_DATA).metaData;
3072            if (metaData != null) {
3073                int iconResId = metaData.getInt(TOOLBAR_ICON_METADATA_NAME);
3074                if (iconResId != 0) {
3075                    Resources res = packageManager.getResourcesForActivity(activityName);
3076                    return res.getDrawable(iconResId);
3077                }
3078            }
3079        } catch (NameNotFoundException e) {
3080            // Do nothing
3081        }
3082        return null;
3083    }
3084
3085    // if successful in getting icon, return it; otherwise, set button to use default drawable
3086    private Drawable.ConstantState updateTextButtonWithIconFromExternalActivity(
3087            int buttonId, ComponentName activityName, int fallbackDrawableId) {
3088        TextView button = (TextView) findViewById(buttonId);
3089        Drawable toolbarIcon = getExternalPackageToolbarIcon(activityName);
3090
3091        // If we were unable to find the icon via the meta-data, use a generic one
3092        if (toolbarIcon == null) {
3093            button.setCompoundDrawablesWithIntrinsicBounds(fallbackDrawableId, 0, 0, 0);
3094            return null;
3095        } else {
3096            button.setCompoundDrawablesWithIntrinsicBounds(toolbarIcon, null, null, null);
3097            return toolbarIcon.getConstantState();
3098        }
3099    }
3100
3101    // if successful in getting icon, return it; otherwise, set button to use default drawable
3102    private Drawable.ConstantState updateButtonWithIconFromExternalActivity(
3103            int buttonId, ComponentName activityName, int fallbackDrawableId) {
3104        ImageView button = (ImageView) findViewById(buttonId);
3105        Drawable toolbarIcon = getExternalPackageToolbarIcon(activityName);
3106
3107        // If we were unable to find the icon via the meta-data, use a generic one
3108        if (toolbarIcon == null) {
3109            button.setImageResource(fallbackDrawableId);
3110            return null;
3111        } else {
3112            button.setImageDrawable(toolbarIcon);
3113            return toolbarIcon.getConstantState();
3114        }
3115    }
3116
3117    private void updateTextButtonWithDrawable(int buttonId, Drawable.ConstantState d) {
3118        TextView button = (TextView) findViewById(buttonId);
3119        button.setCompoundDrawables(d.newDrawable(getResources()), null, null, null);
3120    }
3121
3122    private void updateButtonWithDrawable(int buttonId, Drawable.ConstantState d) {
3123        ImageView button = (ImageView) findViewById(buttonId);
3124        button.setImageDrawable(d.newDrawable(getResources()));
3125    }
3126
3127    private void updateGlobalSearchIcon() {
3128        if (LauncherApplication.isScreenXLarge()) {
3129            final View searchButton = findViewById(R.id.search_button);
3130            final View searchDivider = findViewById(R.id.search_divider);
3131
3132            final SearchManager searchManager =
3133                    (SearchManager) getSystemService(Context.SEARCH_SERVICE);
3134            ComponentName activityName = searchManager.getGlobalSearchActivity();
3135            if (activityName != null) {
3136                sGlobalSearchIcon = updateButtonWithIconFromExternalActivity(
3137                        R.id.search_button, activityName, R.drawable.ic_generic_search);
3138                searchButton.setVisibility(View.VISIBLE);
3139                searchDivider.setVisibility(View.VISIBLE);
3140            } else {
3141                searchButton.setVisibility(View.GONE);
3142                searchDivider.setVisibility(View.GONE);
3143            }
3144        }
3145    }
3146
3147    private void updateGlobalSearchIcon(Drawable.ConstantState d) {
3148        updateButtonWithDrawable(R.id.search_button, d);
3149    }
3150
3151    private void updateVoiceSearchIcon() {
3152        if (LauncherApplication.isScreenXLarge()) {
3153            final View searchDivider = findViewById(R.id.search_divider);
3154            final View voiceButton = findViewById(R.id.voice_button);
3155
3156            Intent intent = new Intent(RecognizerIntent.ACTION_WEB_SEARCH);
3157            ComponentName activityName = intent.resolveActivity(getPackageManager());
3158            if (activityName != null) {
3159                sVoiceSearchIcon = updateButtonWithIconFromExternalActivity(
3160                        R.id.voice_button, activityName, R.drawable.ic_voice_search);
3161                searchDivider.setVisibility(View.VISIBLE);
3162                voiceButton.setVisibility(View.VISIBLE);
3163            } else {
3164                searchDivider.setVisibility(View.GONE);
3165                voiceButton.setVisibility(View.GONE);
3166            }
3167        }
3168    }
3169
3170    private void updateVoiceSearchIcon(Drawable.ConstantState d) {
3171        updateButtonWithDrawable(R.id.voice_button, d);
3172    }
3173
3174    /**
3175     * Sets the app market icon (shown when all apps is visible on x-large screens)
3176     */
3177    private void updateAppMarketIcon() {
3178        final View marketButton = findViewById(R.id.market_button);
3179        Intent intent = new Intent(Intent.ACTION_MAIN).addCategory(Intent.CATEGORY_APP_MARKET);
3180        // Find the app market activity by resolving an intent.
3181        // (If multiple app markets are installed, it will return the ResolverActivity.)
3182        ComponentName activityName = intent.resolveActivity(getPackageManager());
3183        if (activityName != null) {
3184            mAppMarketIntent = intent;
3185            sAppMarketIcon = updateTextButtonWithIconFromExternalActivity(
3186                    R.id.market_button, activityName, R.drawable.app_market_generic);
3187            marketButton.setVisibility(View.VISIBLE);
3188        } else {
3189            // We should hide and disable the view so that we don't try and restore the visibility
3190            // of it when we swap between drag & normal states from IconDropTarget subclasses.
3191            marketButton.setVisibility(View.GONE);
3192            marketButton.setEnabled(false);
3193        }
3194    }
3195
3196    private void updateAppMarketIcon(Drawable.ConstantState d) {
3197        updateTextButtonWithDrawable(R.id.market_button, d);
3198    }
3199
3200    /**
3201     * Displays the shortcut creation dialog and launches, if necessary, the
3202     * appropriate activity.
3203     */
3204    private class CreateShortcut implements DialogInterface.OnClickListener,
3205            DialogInterface.OnCancelListener, DialogInterface.OnDismissListener,
3206            DialogInterface.OnShowListener {
3207
3208        private AddAdapter mAdapter;
3209
3210        Dialog createDialog() {
3211            mAdapter = new AddAdapter(Launcher.this);
3212
3213            final AlertDialog.Builder builder = new AlertDialog.Builder(Launcher.this);
3214            builder.setTitle(getString(R.string.menu_item_add_item));
3215            builder.setAdapter(mAdapter, this);
3216
3217            builder.setInverseBackgroundForced(true);
3218
3219            AlertDialog dialog = builder.create();
3220            dialog.setOnCancelListener(this);
3221            dialog.setOnDismissListener(this);
3222            dialog.setOnShowListener(this);
3223
3224            return dialog;
3225        }
3226
3227        public void onCancel(DialogInterface dialog) {
3228            mWaitingForResult = false;
3229            cleanup();
3230        }
3231
3232        public void onDismiss(DialogInterface dialog) {
3233        }
3234
3235        private void cleanup() {
3236            try {
3237                dismissDialog(DIALOG_CREATE_SHORTCUT);
3238            } catch (Exception e) {
3239                // An exception is thrown if the dialog is not visible, which is fine
3240            }
3241        }
3242
3243        /**
3244         * Handle the action clicked in the "Add to home" dialog.
3245         */
3246        public void onClick(DialogInterface dialog, int which) {
3247            Resources res = getResources();
3248            cleanup();
3249
3250            switch (which) {
3251                case AddAdapter.ITEM_SHORTCUT: {
3252                    pickShortcut();
3253                    break;
3254                }
3255
3256                case AddAdapter.ITEM_APPWIDGET: {
3257                    int appWidgetId = Launcher.this.mAppWidgetHost.allocateAppWidgetId();
3258
3259                    Intent pickIntent = new Intent(AppWidgetManager.ACTION_APPWIDGET_PICK);
3260                    pickIntent.putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, appWidgetId);
3261                    // start the pick activity
3262                    startActivityForResult(pickIntent, REQUEST_PICK_APPWIDGET);
3263                    break;
3264                }
3265
3266                case AddAdapter.ITEM_WALLPAPER: {
3267                    startWallpaper();
3268                    break;
3269                }
3270            }
3271        }
3272
3273        public void onShow(DialogInterface dialog) {
3274            mWaitingForResult = true;
3275        }
3276    }
3277
3278    /**
3279     * Receives notifications when applications are added/removed.
3280     */
3281    private class CloseSystemDialogsIntentReceiver extends BroadcastReceiver {
3282        @Override
3283        public void onReceive(Context context, Intent intent) {
3284            closeSystemDialogs();
3285            String reason = intent.getStringExtra("reason");
3286            if (!"homekey".equals(reason)) {
3287                boolean animate = true;
3288                if (mPaused || "lock".equals(reason)) {
3289                    animate = false;
3290                }
3291                showWorkspace(animate);
3292            }
3293        }
3294    }
3295
3296    /**
3297     * Receives notifications whenever the appwidgets are reset.
3298     */
3299    private class AppWidgetResetObserver extends ContentObserver {
3300        public AppWidgetResetObserver() {
3301            super(new Handler());
3302        }
3303
3304        @Override
3305        public void onChange(boolean selfChange) {
3306            onAppWidgetReset();
3307        }
3308    }
3309
3310    /**
3311     * If the activity is currently paused, signal that we need to re-run the loader
3312     * in onResume.
3313     *
3314     * This needs to be called from incoming places where resources might have been loaded
3315     * while we are paused.  That is becaues the Configuration might be wrong
3316     * when we're not running, and if it comes back to what it was when we
3317     * were paused, we are not restarted.
3318     *
3319     * Implementation of the method from LauncherModel.Callbacks.
3320     *
3321     * @return true if we are currently paused.  The caller might be able to
3322     * skip some work in that case since we will come back again.
3323     */
3324    public boolean setLoadOnResume() {
3325        if (mPaused) {
3326            Log.i(TAG, "setLoadOnResume");
3327            mOnResumeNeedsLoad = true;
3328            return true;
3329        } else {
3330            return false;
3331        }
3332    }
3333
3334    /**
3335     * Implementation of the method from LauncherModel.Callbacks.
3336     */
3337    public int getCurrentWorkspaceScreen() {
3338        if (mWorkspace != null) {
3339            return mWorkspace.getCurrentPage();
3340        } else {
3341            return SCREEN_COUNT / 2;
3342        }
3343    }
3344
3345    void setAllAppsPagedView(AllAppsPagedView view) {
3346        mAllAppsPagedView = view;
3347    }
3348
3349    /**
3350     * Refreshes the shortcuts shown on the workspace.
3351     *
3352     * Implementation of the method from LauncherModel.Callbacks.
3353     */
3354    public void startBinding() {
3355        final Workspace workspace = mWorkspace;
3356
3357        mWorkspace.clearDropTargets();
3358        int count = workspace.getChildCount();
3359        for (int i = 0; i < count; i++) {
3360            // Use removeAllViewsInLayout() to avoid an extra requestLayout() and invalidate().
3361            final CellLayout layoutParent = (CellLayout) workspace.getChildAt(i);
3362            layoutParent.removeAllViewsInLayout();
3363        }
3364
3365        if (DEBUG_USER_INTERFACE) {
3366            android.widget.Button finishButton = new android.widget.Button(this);
3367            finishButton.setText("Finish");
3368            workspace.addInScreen(finishButton, 1, 0, 0, 1, 1);
3369
3370            finishButton.setOnClickListener(new android.widget.Button.OnClickListener() {
3371                public void onClick(View v) {
3372                    finish();
3373                }
3374            });
3375        }
3376
3377        // This wasn't being called before which resulted in a leak of AppWidgetHostViews (through
3378        // mDesktopItems -> AppWidgetInfo -> hostView).
3379        unbindDesktopItems();
3380    }
3381
3382    /**
3383     * Bind the items start-end from the list.
3384     *
3385     * Implementation of the method from LauncherModel.Callbacks.
3386     */
3387    public void bindItems(ArrayList<ItemInfo> shortcuts, int start, int end) {
3388
3389        setLoadOnResume();
3390
3391        final Workspace workspace = mWorkspace;
3392
3393        for (int i=start; i<end; i++) {
3394            final ItemInfo item = shortcuts.get(i);
3395            mDesktopItems.add(item);
3396            switch (item.itemType) {
3397                case LauncherSettings.Favorites.ITEM_TYPE_APPLICATION:
3398                case LauncherSettings.Favorites.ITEM_TYPE_SHORTCUT:
3399                    final View shortcut = createShortcut((ShortcutInfo)item);
3400                    workspace.addInScreen(shortcut, item.screen, item.cellX, item.cellY, 1, 1,
3401                            false);
3402                    break;
3403                case LauncherSettings.Favorites.ITEM_TYPE_FOLDER:
3404                    final FolderIcon newFolder = FolderIcon.fromXml(R.layout.folder_icon, this,
3405                            (ViewGroup) workspace.getChildAt(workspace.getCurrentPage()),
3406                            (FolderInfo) item, mIconCache);
3407                    workspace.addInScreen(newFolder, item.screen, item.cellX, item.cellY, 1, 1,
3408                            false);
3409                    break;
3410            }
3411        }
3412
3413        workspace.requestLayout();
3414    }
3415
3416    /**
3417     * Implementation of the method from LauncherModel.Callbacks.
3418     */
3419    public void bindFolders(HashMap<Long, FolderInfo> folders) {
3420        setLoadOnResume();
3421        sFolders.clear();
3422        sFolders.putAll(folders);
3423    }
3424
3425    /**
3426     * Add the views for a widget to the workspace.
3427     *
3428     * Implementation of the method from LauncherModel.Callbacks.
3429     */
3430    public void bindAppWidget(LauncherAppWidgetInfo item) {
3431        setLoadOnResume();
3432
3433        final long start = DEBUG_WIDGETS ? SystemClock.uptimeMillis() : 0;
3434        if (DEBUG_WIDGETS) {
3435            Log.d(TAG, "bindAppWidget: " + item);
3436        }
3437        final Workspace workspace = mWorkspace;
3438
3439        final int appWidgetId = item.appWidgetId;
3440        final AppWidgetProviderInfo appWidgetInfo = mAppWidgetManager.getAppWidgetInfo(appWidgetId);
3441        if (DEBUG_WIDGETS) {
3442            Log.d(TAG, "bindAppWidget: id=" + item.appWidgetId + " belongs to component " + appWidgetInfo.provider);
3443        }
3444
3445        item.hostView = mAppWidgetHost.createView(this, appWidgetId, appWidgetInfo);
3446
3447        item.hostView.setAppWidget(appWidgetId, appWidgetInfo);
3448        item.hostView.setTag(item);
3449
3450        workspace.addInScreen(item.hostView, item.screen, item.cellX,
3451                item.cellY, item.spanX, item.spanY, false);
3452
3453        addWidgetToAutoAdvanceIfNeeded(item.hostView, appWidgetInfo);
3454
3455        workspace.requestLayout();
3456
3457        mDesktopItems.add(item);
3458
3459        if (DEBUG_WIDGETS) {
3460            Log.d(TAG, "bound widget id="+item.appWidgetId+" in "
3461                    + (SystemClock.uptimeMillis()-start) + "ms");
3462        }
3463    }
3464
3465    /**
3466     * Callback saying that there aren't any more items to bind.
3467     *
3468     * Implementation of the method from LauncherModel.Callbacks.
3469     */
3470    public void finishBindingItems() {
3471        setLoadOnResume();
3472
3473        if (mSavedState != null) {
3474            if (!mWorkspace.hasFocus()) {
3475                mWorkspace.getChildAt(mWorkspace.getCurrentPage()).requestFocus();
3476            }
3477
3478            final long[] folders = mSavedState.getLongArray(RUNTIME_STATE_FOLDERS);
3479            if (folders != null) {
3480                for (long folderId : folders) {
3481                    final FolderInfo info = sFolders.get(folderId);
3482                    final FolderIcon folderIcon = (FolderIcon)
3483                        mWorkspace.getViewForTag(info);
3484                    if (folderIcon != null) {
3485                        openFolder(folderIcon);
3486                    }
3487                }
3488                final Folder openFolder = mWorkspace.getOpenFolder();
3489                if (openFolder != null) {
3490                    openFolder.requestFocus();
3491                }
3492            }
3493
3494            mSavedState = null;
3495        }
3496
3497        if (mSavedInstanceState != null) {
3498            super.onRestoreInstanceState(mSavedInstanceState);
3499            mSavedInstanceState = null;
3500        }
3501
3502        // Workaround a bug that occurs when rotating the device while the customization mode is
3503        // open, we trigger a new layout on all the CellLayout children.
3504        if (LauncherApplication.isScreenXLarge() && (mState == State.CUSTOMIZE)) {
3505            final int childCount = mWorkspace.getChildCount();
3506            for (int i = 0; i < childCount; ++i) {
3507                mWorkspace.getChildAt(i).requestLayout();
3508            }
3509        }
3510
3511        mWorkspaceLoading = false;
3512
3513        // If we received the result of any pending adds while the loader was running (e.g. the
3514        // widget configuration forced an orientation change), process them now.
3515        for (int i = 0; i < sPendingAddList.size(); i++) {
3516            completeAdd(sPendingAddList.get(i));
3517        }
3518        sPendingAddList.clear();
3519    }
3520
3521    /**
3522     * Updates the icons on the launcher that are affected by changes to the package list
3523     * on the device.
3524     */
3525    private void updateIconsAffectedByPackageManagerChanges() {
3526        updateAppMarketIcon();
3527        updateGlobalSearchIcon();
3528        updateVoiceSearchIcon();
3529    }
3530
3531    /**
3532     * Add the icons for all apps.
3533     *
3534     * Implementation of the method from LauncherModel.Callbacks.
3535     */
3536    public void bindAllApplications(ArrayList<ApplicationInfo> apps) {
3537        if (mAllAppsGrid != null) {
3538            mAllAppsGrid.setApps(apps);
3539        }
3540        if (mAppsCustomizeContent != null) {
3541            mAppsCustomizeContent.setApps(apps);
3542        }
3543        if (mCustomizePagedView != null) {
3544            mCustomizePagedView.setApps(apps);
3545        }
3546        updateIconsAffectedByPackageManagerChanges();
3547    }
3548
3549    /**
3550     * A package was installed.
3551     *
3552     * Implementation of the method from LauncherModel.Callbacks.
3553     */
3554    public void bindAppsAdded(ArrayList<ApplicationInfo> apps) {
3555        setLoadOnResume();
3556        removeDialog(DIALOG_CREATE_SHORTCUT);
3557        if (mAllAppsGrid != null) {
3558            mAllAppsGrid.addApps(apps);
3559        }
3560        if (mAppsCustomizeContent != null) {
3561            mAppsCustomizeContent.addApps(apps);
3562        }
3563        if (mCustomizePagedView != null) {
3564            mCustomizePagedView.addApps(apps);
3565        }
3566        updateIconsAffectedByPackageManagerChanges();
3567    }
3568
3569    /**
3570     * A package was updated.
3571     *
3572     * Implementation of the method from LauncherModel.Callbacks.
3573     */
3574    public void bindAppsUpdated(ArrayList<ApplicationInfo> apps) {
3575        setLoadOnResume();
3576        removeDialog(DIALOG_CREATE_SHORTCUT);
3577        if (mWorkspace != null) {
3578            mWorkspace.updateShortcuts(apps);
3579        }
3580        if (mAllAppsGrid != null) {
3581            mAllAppsGrid.updateApps(apps);
3582        }
3583        if (mAppsCustomizeContent != null) {
3584            mAppsCustomizeContent.updateApps(apps);
3585        }
3586        if (mCustomizePagedView != null) {
3587            mCustomizePagedView.updateApps(apps);
3588        }
3589        updateIconsAffectedByPackageManagerChanges();
3590    }
3591
3592    /**
3593     * A package was uninstalled.
3594     *
3595     * Implementation of the method from LauncherModel.Callbacks.
3596     */
3597    public void bindAppsRemoved(ArrayList<ApplicationInfo> apps, boolean permanent) {
3598        removeDialog(DIALOG_CREATE_SHORTCUT);
3599        if (permanent) {
3600            mWorkspace.removeItems(apps);
3601        }
3602        if (mAllAppsGrid != null) {
3603            mAllAppsGrid.removeApps(apps);
3604        }
3605        if (mAppsCustomizeContent != null) {
3606            mAppsCustomizeContent.removeApps(apps);
3607        }
3608        if (mCustomizePagedView != null) {
3609            mCustomizePagedView.removeApps(apps);
3610        }
3611        updateIconsAffectedByPackageManagerChanges();
3612    }
3613
3614    /**
3615     * A number of packages were updated.
3616     */
3617    public void bindPackagesUpdated() {
3618        // update the customization drawer contents
3619        if (mCustomizePagedView != null) {
3620            mCustomizePagedView.update();
3621        }
3622        if (mAppsCustomizeContent != null) {
3623            mAppsCustomizeContent.onPackagesUpdated();
3624        }
3625    }
3626
3627    private int mapConfigurationOriActivityInfoOri(int configOri) {
3628        final Display d = getWindowManager().getDefaultDisplay();
3629        int naturalOri = Configuration.ORIENTATION_LANDSCAPE;
3630        switch (d.getRotation()) {
3631        case Surface.ROTATION_0:
3632        case Surface.ROTATION_180:
3633            // We are currently in the same basic orientation as the natural orientation
3634            naturalOri = configOri;
3635            break;
3636        case Surface.ROTATION_90:
3637        case Surface.ROTATION_270:
3638            // We are currently in the other basic orientation to the natural orientation
3639            naturalOri = (configOri == Configuration.ORIENTATION_LANDSCAPE) ?
3640                    Configuration.ORIENTATION_PORTRAIT : Configuration.ORIENTATION_LANDSCAPE;
3641            break;
3642        }
3643
3644        int[] oriMap = {
3645                ActivityInfo.SCREEN_ORIENTATION_PORTRAIT,
3646                ActivityInfo.SCREEN_ORIENTATION_LANDSCAPE,
3647                ActivityInfo.SCREEN_ORIENTATION_REVERSE_PORTRAIT,
3648                ActivityInfo.SCREEN_ORIENTATION_REVERSE_LANDSCAPE
3649        };
3650        // Since the map starts at portrait, we need to offset if this device's natural orientation
3651        // is landscape.
3652        int indexOffset = 0;
3653        if (naturalOri == Configuration.ORIENTATION_LANDSCAPE) {
3654            indexOffset = 1;
3655        }
3656        return oriMap[(d.getRotation() + indexOffset) % 4];
3657    }
3658    public void lockScreenOrientation() {
3659        setRequestedOrientation(mapConfigurationOriActivityInfoOri(getResources()
3660                .getConfiguration().orientation));
3661    }
3662    public void unlockScreenOrientation() {
3663        mHandler.postDelayed(new Runnable() {
3664            public void run() {
3665                setRequestedOrientation(ActivityInfo.SCREEN_ORIENTATION_UNSPECIFIED);
3666            }
3667        }, mRestoreScreenOrientationDelay);
3668    }
3669
3670    /**
3671     * Prints out out state for debugging.
3672     */
3673    public void dumpState() {
3674        Log.d(TAG, "BEGIN launcher2 dump state for launcher " + this);
3675        Log.d(TAG, "mSavedState=" + mSavedState);
3676        Log.d(TAG, "mWorkspaceLoading=" + mWorkspaceLoading);
3677        Log.d(TAG, "mRestoring=" + mRestoring);
3678        Log.d(TAG, "mWaitingForResult=" + mWaitingForResult);
3679        Log.d(TAG, "mSavedInstanceState=" + mSavedInstanceState);
3680        Log.d(TAG, "mDesktopItems.size=" + mDesktopItems.size());
3681        Log.d(TAG, "sFolders.size=" + sFolders.size());
3682        mModel.dumpState();
3683        if (mAllAppsGrid != null) {
3684            mAllAppsGrid.dumpState();
3685        }
3686        if (mAppsCustomizeContent != null) {
3687            mAppsCustomizeContent.dumpState();
3688        }
3689        Log.d(TAG, "END launcher2 dump state");
3690    }
3691}
3692
3693interface LauncherTransitionable {
3694    void onLauncherTransitionStart(Animator animation);
3695    void onLauncherTransitionEnd(Animator animation);
3696}
3697