AppsCustomizePagedView.java revision be69cc8ed86b7f22e7e4cf0c5a1500f45993075f
1/*
2 * Copyright (C) 2011 The Android Open Source Project
3 *
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
7 *
8 *      http://www.apache.org/licenses/LICENSE-2.0
9 *
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
15 */
16
17package com.android.launcher2;
18
19import android.animation.AnimatorSet;
20import android.animation.ObjectAnimator;
21import android.animation.ValueAnimator;
22import android.appwidget.AppWidgetManager;
23import android.appwidget.AppWidgetProviderInfo;
24import android.content.ComponentName;
25import android.content.Context;
26import android.content.Intent;
27import android.content.pm.ActivityInfo;
28import android.content.pm.PackageManager;
29import android.content.pm.ResolveInfo;
30import android.content.res.Configuration;
31import android.content.res.Resources;
32import android.content.res.TypedArray;
33import android.graphics.Bitmap;
34import android.graphics.Bitmap.Config;
35import android.graphics.Canvas;
36import android.graphics.Rect;
37import android.graphics.drawable.Drawable;
38import android.os.AsyncTask;
39import android.os.Process;
40import android.util.AttributeSet;
41import android.util.Log;
42import android.view.LayoutInflater;
43import android.view.View;
44import android.view.ViewGroup;
45import android.view.animation.AccelerateInterpolator;
46import android.widget.GridLayout;
47import android.widget.ImageView;
48import android.widget.TextView;
49import android.widget.Toast;
50
51import com.android.launcher.R;
52import com.android.launcher2.DropTarget.DragObject;
53
54import java.util.ArrayList;
55import java.util.Collections;
56import java.util.Iterator;
57import java.util.List;
58
59/**
60 * A simple callback interface which also provides the results of the task.
61 */
62interface AsyncTaskCallback {
63    void run(AppsCustomizeAsyncTask task, AsyncTaskPageData data);
64}
65
66/**
67 * The data needed to perform either of the custom AsyncTasks.
68 */
69class AsyncTaskPageData {
70    enum Type {
71        LoadWidgetPreviewData,
72        LoadHolographicIconsData
73    }
74
75    AsyncTaskPageData(int p, ArrayList<Object> l, ArrayList<Bitmap> si, AsyncTaskCallback bgR,
76            AsyncTaskCallback postR) {
77        page = p;
78        items = l;
79        sourceImages = si;
80        generatedImages = new ArrayList<Bitmap>();
81        cellWidth = cellHeight = -1;
82        doInBackgroundCallback = bgR;
83        postExecuteCallback = postR;
84    }
85    AsyncTaskPageData(int p, ArrayList<Object> l, int cw, int ch, int ccx, AsyncTaskCallback bgR,
86            AsyncTaskCallback postR) {
87        page = p;
88        items = l;
89        generatedImages = new ArrayList<Bitmap>();
90        cellWidth = cw;
91        cellHeight = ch;
92        cellCountX = ccx;
93        doInBackgroundCallback = bgR;
94        postExecuteCallback = postR;
95    }
96    int page;
97    ArrayList<Object> items;
98    ArrayList<Bitmap> sourceImages;
99    ArrayList<Bitmap> generatedImages;
100    int cellWidth;
101    int cellHeight;
102    int cellCountX;
103    AsyncTaskCallback doInBackgroundCallback;
104    AsyncTaskCallback postExecuteCallback;
105}
106
107/**
108 * A generic template for an async task used in AppsCustomize.
109 */
110class AppsCustomizeAsyncTask extends AsyncTask<AsyncTaskPageData, Void, AsyncTaskPageData> {
111    AppsCustomizeAsyncTask(int p, AppsCustomizePagedView.ContentType t, AsyncTaskPageData.Type ty) {
112        page = p;
113        pageContentType = t;
114        threadPriority = Process.THREAD_PRIORITY_DEFAULT;
115        dataType = ty;
116    }
117    @Override
118    protected AsyncTaskPageData doInBackground(AsyncTaskPageData... params) {
119        if (params.length != 1) return null;
120        // Load each of the widget previews in the background
121        params[0].doInBackgroundCallback.run(this, params[0]);
122        return params[0];
123    }
124    @Override
125    protected void onPostExecute(AsyncTaskPageData result) {
126        // All the widget previews are loaded, so we can just callback to inflate the page
127        result.postExecuteCallback.run(this, result);
128    }
129
130    void setThreadPriority(int p) {
131        threadPriority = p;
132    }
133    void syncThreadPriority() {
134        Process.setThreadPriority(threadPriority);
135    }
136
137    // The page that this async task is associated with
138    AsyncTaskPageData.Type dataType;
139    int page;
140    AppsCustomizePagedView.ContentType pageContentType;
141    int threadPriority;
142}
143
144/**
145 * The Apps/Customize page that displays all the applications, widgets, and shortcuts.
146 */
147public class AppsCustomizePagedView extends PagedViewWithDraggableItems implements
148        AllAppsView, View.OnClickListener, DragSource {
149    static final String LOG_TAG = "AppsCustomizePagedView";
150
151    /**
152     * The different content types that this paged view can show.
153     */
154    public enum ContentType {
155        Applications,
156        Widgets
157    }
158
159    // Refs
160    private Launcher mLauncher;
161    private DragController mDragController;
162    private final LayoutInflater mLayoutInflater;
163    private final PackageManager mPackageManager;
164
165    // Content
166    private ContentType mContentType;
167    private ArrayList<ApplicationInfo> mApps;
168    private ArrayList<Object> mWidgets;
169    private ArrayList<Object> mShortcuts;
170
171    // Caching
172    private Canvas mCanvas;
173    private Drawable mDefaultWidgetBackground;
174    private IconCache mIconCache;
175
176    // Dimens
177    private int mContentWidth;
178    private int mAppIconSize;
179    private int mMaxWidgetSpan, mMinWidgetSpan;
180    private int mWidgetCountX, mWidgetCountY;
181    private int mWidgetWidthGap, mWidgetHeightGap;
182    private int mShortcutCountX, mShortcutCountY;
183    private int mShortcutWidthGap, mShortcutHeightGap;
184    private final int mWidgetPreviewIconPaddedDimension;
185    private final float sWidgetPreviewIconPaddingPercentage = 0.25f;
186    private PagedViewCellLayout mWidgetSpacingLayout;
187
188    // Previews & outlines
189    ArrayList<AppsCustomizeAsyncTask> mRunningTasks;
190    private HolographicOutlineHelper mHolographicOutlineHelper;
191
192    public AppsCustomizePagedView(Context context, AttributeSet attrs) {
193        super(context, attrs);
194        mLayoutInflater = LayoutInflater.from(context);
195        mPackageManager = context.getPackageManager();
196        mContentType = ContentType.Applications;
197        mApps = new ArrayList<ApplicationInfo>();
198        mWidgets = new ArrayList<Object>();
199        mShortcuts = new ArrayList<Object>();
200        mIconCache = ((LauncherApplication) context.getApplicationContext()).getIconCache();
201        mHolographicOutlineHelper = new HolographicOutlineHelper();
202        mCanvas = new Canvas();
203        mRunningTasks = new ArrayList<AppsCustomizeAsyncTask>();
204
205        // Save the default widget preview background
206        Resources resources = context.getResources();
207        mDefaultWidgetBackground = resources.getDrawable(R.drawable.default_widget_preview_holo);
208        mAppIconSize = getResources().getDimensionPixelSize(R.dimen.app_icon_size);
209
210        TypedArray a = context.obtainStyledAttributes(attrs, R.styleable.PagedView, 0, 0);
211        // TODO-APPS_CUSTOMIZE: remove these unnecessary attrs after
212        mCellCountX = a.getInt(R.styleable.PagedView_cellCountX, 6);
213        mCellCountY = a.getInt(R.styleable.PagedView_cellCountY, 4);
214        a.recycle();
215        a = context.obtainStyledAttributes(attrs, R.styleable.AppsCustomizePagedView, 0, 0);
216        mWidgetWidthGap =
217            a.getDimensionPixelSize(R.styleable.AppsCustomizePagedView_widgetCellWidthGap, 0);
218        mWidgetHeightGap =
219            a.getDimensionPixelSize(R.styleable.AppsCustomizePagedView_widgetCellHeightGap, 0);
220        mWidgetCountX = a.getInt(R.styleable.AppsCustomizePagedView_widgetCountX, 2);
221        mWidgetCountY = a.getInt(R.styleable.AppsCustomizePagedView_widgetCountY, 2);
222        a.recycle();
223        mWidgetSpacingLayout = new PagedViewCellLayout(getContext());
224
225        // The max widget span is the length N, such that NxN is the largest bounds that the widget
226        // preview can be before applying the widget scaling
227        mMinWidgetSpan = 1;
228        mMaxWidgetSpan = 3;
229
230        // The padding on the non-matched dimension for the default widget preview icons
231        // (top + bottom)
232        mWidgetPreviewIconPaddedDimension =
233            (int) (mAppIconSize * (1 + (2 * sWidgetPreviewIconPaddingPercentage)));
234    }
235
236    @Override
237    protected void init() {
238        super.init();
239        mCenterPagesVertically = false;
240
241        Context context = getContext();
242        Resources r = context.getResources();
243        setDragSlopeThreshold(r.getInteger(R.integer.config_appsCustomizeDragSlopeThreshold)/100f);
244    }
245
246    @Override
247    protected void onWallpaperTap(android.view.MotionEvent ev) {
248        mLauncher.showWorkspace(true);
249    }
250
251    /**
252     * This differs from isDataReady as this is the test done if isDataReady is not set.
253     */
254    private boolean testDataReady() {
255        // We only do this test once, and we default to the Applications page, so we only really
256        // have to wait for there to be apps.
257        return !mApps.isEmpty();
258    }
259
260    protected void onDataReady(int width, int height) {
261        // Note that we transpose the counts in portrait so that we get a similar layout
262        boolean isLandscape = getResources().getConfiguration().orientation ==
263            Configuration.ORIENTATION_LANDSCAPE;
264        int maxCellCountX = Integer.MAX_VALUE;
265        int maxCellCountY = Integer.MAX_VALUE;
266        if (LauncherApplication.isScreenLarge()) {
267            maxCellCountX = (isLandscape ? LauncherModel.getCellCountX() :
268                LauncherModel.getCellCountY());
269            maxCellCountY = (isLandscape ? LauncherModel.getCellCountY() :
270                LauncherModel.getCellCountX());
271        }
272
273        // Now that the data is ready, we can calculate the content width, the number of cells to
274        // use for each page
275        mWidgetSpacingLayout.setGap(mPageLayoutWidthGap, mPageLayoutHeightGap);
276        mWidgetSpacingLayout.setPadding(mPageLayoutPaddingLeft, mPageLayoutPaddingTop,
277                mPageLayoutPaddingRight, mPageLayoutPaddingBottom);
278        mWidgetSpacingLayout.calculateCellCount(width, height, maxCellCountX, maxCellCountY);
279        mCellCountX = mWidgetSpacingLayout.getCellCountX();
280        mCellCountY = mWidgetSpacingLayout.getCellCountY();
281        mWidgetCountX = Math.max(1, (int) Math.round(mCellCountX / 2f));
282        mWidgetCountY = Math.max(1, (int) Math.round(mCellCountY / 3f));
283        mShortcutCountX = Math.max(1, (int) Math.round(mCellCountX / 2f));
284        mShortcutCountY = Math.max(1, (int) Math.round(mCellCountY / 2f));
285
286        // Force a measure to update recalculate the gaps
287        int widthSpec = MeasureSpec.makeMeasureSpec(getMeasuredWidth(), MeasureSpec.AT_MOST);
288        int heightSpec = MeasureSpec.makeMeasureSpec(getMeasuredHeight(), MeasureSpec.AT_MOST);
289        mWidgetSpacingLayout.measure(widthSpec, heightSpec);
290        mContentWidth = mWidgetSpacingLayout.getContentWidth();
291
292        invalidatePageData();
293    }
294
295    @Override
296    protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {
297        int width = MeasureSpec.getSize(widthMeasureSpec);
298        int height = MeasureSpec.getSize(heightMeasureSpec);
299        if (!isDataReady()) {
300            if (testDataReady()) {
301                setDataIsReady();
302                setMeasuredDimension(width, height);
303                onDataReady(width, height);
304            }
305        }
306
307        super.onMeasure(widthMeasureSpec, heightMeasureSpec);
308    }
309
310    /** Removes and returns the ResolveInfo with the specified ComponentName */
311    private ResolveInfo removeResolveInfoWithComponentName(List<ResolveInfo> list,
312            ComponentName cn) {
313        Iterator<ResolveInfo> iter = list.iterator();
314        while (iter.hasNext()) {
315            ResolveInfo rinfo = iter.next();
316            ActivityInfo info = rinfo.activityInfo;
317            ComponentName c = new ComponentName(info.packageName, info.name);
318            if (c.equals(cn)) {
319                iter.remove();
320                return rinfo;
321            }
322        }
323        return null;
324    }
325
326    public void onPackagesUpdated() {
327        // Get the list of widgets and shortcuts
328        boolean wasEmpty = mWidgets.isEmpty() && mShortcuts.isEmpty();
329        mWidgets.clear();
330        mShortcuts.clear();
331        List<AppWidgetProviderInfo> widgets =
332            AppWidgetManager.getInstance(mLauncher).getInstalledProviders();
333        Collections.sort(widgets,
334                new LauncherModel.WidgetAndShortcutNameComparator(mPackageManager));
335        Intent shortcutsIntent = new Intent(Intent.ACTION_CREATE_SHORTCUT);
336        List<ResolveInfo> shortcuts = mPackageManager.queryIntentActivities(shortcutsIntent, 0);
337        Collections.sort(shortcuts,
338                new LauncherModel.WidgetAndShortcutNameComparator(mPackageManager));
339        mWidgets.addAll(widgets);
340        mShortcuts.addAll(shortcuts);
341
342        if (wasEmpty) {
343            // The next layout pass will trigger data-ready if both widgets and apps are set, so request
344            // a layout to do this test and invalidate the page data when ready.
345            if (testDataReady()) requestLayout();
346        } else {
347            invalidatePageData();
348        }
349    }
350
351    @Override
352    public void onClick(View v) {
353        if (v instanceof PagedViewIcon) {
354            // Animate some feedback to the click
355            final ApplicationInfo appInfo = (ApplicationInfo) v.getTag();
356            animateClickFeedback(v, new Runnable() {
357                @Override
358                public void run() {
359                    mLauncher.startActivitySafely(appInfo.intent, appInfo);
360                }
361            });
362        } else if (v instanceof PagedViewWidget) {
363            // Let the user know that they have to long press to add a widget
364            Toast.makeText(getContext(), R.string.long_press_widget_to_add,
365                    Toast.LENGTH_SHORT).show();
366
367            // Create a little animation to show that the widget can move
368            float offsetY = getResources().getDimensionPixelSize(R.dimen.dragViewOffsetY);
369            final ImageView p = (ImageView) v.findViewById(R.id.widget_preview);
370            AnimatorSet bounce = new AnimatorSet();
371            ValueAnimator tyuAnim = ObjectAnimator.ofFloat(p, "translationY", offsetY);
372            tyuAnim.setDuration(125);
373            ValueAnimator tydAnim = ObjectAnimator.ofFloat(p, "translationY", 0f);
374            tydAnim.setDuration(100);
375            bounce.play(tyuAnim).before(tydAnim);
376            bounce.setInterpolator(new AccelerateInterpolator());
377            bounce.start();
378        }
379    }
380
381    /*
382     * PagedViewWithDraggableItems implementation
383     */
384    @Override
385    protected void determineDraggingStart(android.view.MotionEvent ev) {
386        // Disable dragging by pulling an app down for now.
387    }
388    private void beginDraggingApplication(View v) {
389        // Make a copy of the ApplicationInfo
390        ApplicationInfo appInfo = new ApplicationInfo((ApplicationInfo) v.getTag());
391
392        // Compose the drag image (top compound drawable, index is 1)
393        final TextView tv = (TextView) v;
394        final Drawable icon = tv.getCompoundDrawables()[1];
395        Bitmap b = Bitmap.createBitmap(v.getWidth(), v.getHeight(),
396                Bitmap.Config.ARGB_8888);
397        mCanvas.setBitmap(b);
398        mCanvas.save();
399        mCanvas.translate((v.getWidth() - icon.getIntrinsicWidth()) / 2, v.getPaddingTop());
400        icon.draw(mCanvas);
401        mCanvas.restore();
402
403        // Compose the visible rect of the drag image
404        Rect dragRect = null;
405        if (v instanceof TextView) {
406            int top = v.getPaddingTop();
407            int left = (b.getWidth() - mAppIconSize) / 2;
408            int right = left + mAppIconSize;
409            int bottom = top + mAppIconSize;
410            dragRect = new Rect(left, top, right, bottom);
411        }
412
413        // Start the drag
414        mLauncher.lockScreenOrientation();
415        mLauncher.getWorkspace().onDragStartedWithItemSpans(1, 1, b);
416        mDragController.startDrag(v, b, this, appInfo, DragController.DRAG_ACTION_COPY, dragRect);
417        b.recycle();
418    }
419    private void beginDraggingWidget(View v) {
420        // Get the widget preview as the drag representation
421        ImageView image = (ImageView) v.findViewById(R.id.widget_preview);
422        PendingAddItemInfo createItemInfo = (PendingAddItemInfo) v.getTag();
423
424        // Compose the drag image
425        Bitmap b;
426        Drawable preview = image.getDrawable();
427        int w = preview.getIntrinsicWidth();
428        int h = preview.getIntrinsicHeight();
429        if (createItemInfo instanceof PendingAddWidgetInfo) {
430            PendingAddWidgetInfo createWidgetInfo = (PendingAddWidgetInfo) createItemInfo;
431            int[] spanXY = CellLayout.rectToCell(getResources(),
432                    createWidgetInfo.minWidth, createWidgetInfo.minHeight, null);
433            createItemInfo.spanX = spanXY[0];
434            createItemInfo.spanY = spanXY[1];
435
436            b = Bitmap.createBitmap(w, h, Bitmap.Config.ARGB_8888);
437            renderDrawableToBitmap(preview, b, 0, 0, w, h, 1, 1);
438        } else {
439            // Workaround for the fact that we don't keep the original ResolveInfo associated with
440            // the shortcut around.  To get the icon, we just render the preview image (which has
441            // the shortcut icon) to a new drag bitmap that clips the non-icon space.
442            b = Bitmap.createBitmap(mWidgetPreviewIconPaddedDimension,
443                    mWidgetPreviewIconPaddedDimension, Bitmap.Config.ARGB_8888);
444            mCanvas.setBitmap(b);
445            mCanvas.save();
446            preview.draw(mCanvas);
447            mCanvas.restore();
448            createItemInfo.spanX = createItemInfo.spanY = 1;
449        }
450
451        // Start the drag
452        mLauncher.lockScreenOrientation();
453        mLauncher.getWorkspace().onDragStartedWithItemSpans(createItemInfo.spanX,
454                createItemInfo.spanY, b);
455        mDragController.startDrag(image, b, this, createItemInfo,
456                DragController.DRAG_ACTION_COPY, null);
457        b.recycle();
458    }
459    @Override
460    protected boolean beginDragging(View v) {
461        if (!super.beginDragging(v)) return false;
462
463        // Go into spring loaded mode (must happen before we startDrag())
464        int currentPageIndex = mLauncher.getWorkspace().getCurrentPage();
465        CellLayout currentPage = (CellLayout) mLauncher.getWorkspace().getChildAt(currentPageIndex);
466        mLauncher.enterSpringLoadedDragMode(currentPage);
467
468        if (v instanceof PagedViewIcon) {
469            beginDraggingApplication(v);
470        } else if (v instanceof PagedViewWidget) {
471            beginDraggingWidget(v);
472        }
473        return true;
474    }
475    private void endDragging(boolean success) {
476        mLauncher.getWorkspace().onDragStopped(success);
477        mLauncher.exitSpringLoadedDragMode();
478        mLauncher.unlockScreenOrientation();
479
480    }
481
482    /*
483     * DragSource implementation
484     */
485    @Override
486    public void onDragViewVisible() {}
487    @Override
488    public void onDropCompleted(View target, DragObject d, boolean success) {
489        endDragging(success);
490
491        // Display an error message if the drag failed due to there not being enough space on the
492        // target layout we were dropping on.
493        if (!success) {
494            boolean showOutOfSpaceMessage = false;
495            if (target instanceof Workspace) {
496                int currentScreen = mLauncher.getCurrentWorkspaceScreen();
497                Workspace workspace = (Workspace) target;
498                CellLayout layout = (CellLayout) workspace.getChildAt(currentScreen);
499                ItemInfo itemInfo = (ItemInfo) d.dragInfo;
500                if (layout != null) {
501                    layout.calculateSpans(itemInfo);
502                    showOutOfSpaceMessage =
503                            !layout.findCellForSpan(null, itemInfo.spanX, itemInfo.spanY);
504                }
505            }
506            // TODO-APPS_CUSTOMIZE: We need to handle this for folders as well later.
507            if (showOutOfSpaceMessage) {
508                mLauncher.showOutOfSpaceMessage();
509            }
510        }
511    }
512
513    public void setContentType(ContentType type) {
514        mContentType = type;
515        setCurrentPage(0);
516        invalidatePageData();
517    }
518
519    public boolean isContentType(ContentType type) {
520        return (mContentType == type);
521    }
522
523    /*
524     * Apps PagedView implementation
525     */
526    private void setVisibilityOnChildren(ViewGroup layout, int visibility) {
527        int childCount = layout.getChildCount();
528        for (int i = 0; i < childCount; ++i) {
529            layout.getChildAt(i).setVisibility(visibility);
530        }
531    }
532    private void setupPage(PagedViewCellLayout layout) {
533        layout.setCellCount(mCellCountX, mCellCountY);
534        layout.setGap(mPageLayoutWidthGap, mPageLayoutHeightGap);
535        layout.setPadding(mPageLayoutPaddingLeft, mPageLayoutPaddingTop,
536                mPageLayoutPaddingRight, mPageLayoutPaddingBottom);
537
538        // Note: We force a measure here to get around the fact that when we do layout calculations
539        // immediately after syncing, we don't have a proper width.  That said, we already know the
540        // expected page width, so we can actually optimize by hiding all the TextView-based
541        // children that are expensive to measure, and let that happen naturally later.
542        setVisibilityOnChildren(layout, View.GONE);
543        int widthSpec = MeasureSpec.makeMeasureSpec(getMeasuredWidth(), MeasureSpec.AT_MOST);
544        int heightSpec = MeasureSpec.makeMeasureSpec(getMeasuredHeight(), MeasureSpec.AT_MOST);
545        layout.setMinimumWidth(getPageContentWidth());
546        layout.measure(widthSpec, heightSpec);
547        setVisibilityOnChildren(layout, View.VISIBLE);
548    }
549    public void syncAppsPages() {
550        // Ensure that we have the right number of pages
551        Context context = getContext();
552        int numPages = (int) Math.ceil((float) mApps.size() / (mCellCountX * mCellCountY));
553        for (int i = 0; i < numPages; ++i) {
554            PagedViewCellLayout layout = new PagedViewCellLayout(context);
555            setupPage(layout);
556            addView(layout);
557        }
558    }
559    public void syncAppsPageItems(int page) {
560        // ensure that we have the right number of items on the pages
561        int numPages = getPageCount();
562        int numCells = mCellCountX * mCellCountY;
563        int startIndex = page * numCells;
564        int endIndex = Math.min(startIndex + numCells, mApps.size());
565        PagedViewCellLayout layout = (PagedViewCellLayout) getChildAt(page);
566
567        layout.removeAllViewsOnPage();
568        ArrayList<Object> items = new ArrayList<Object>();
569        ArrayList<Bitmap> images = new ArrayList<Bitmap>();
570        for (int i = startIndex; i < endIndex; ++i) {
571            ApplicationInfo info = mApps.get(i);
572            PagedViewIcon icon = (PagedViewIcon) mLayoutInflater.inflate(
573                    R.layout.apps_customize_application, layout, false);
574            icon.applyFromApplicationInfo(info, true, mHolographicOutlineHelper);
575            icon.setOnClickListener(this);
576            icon.setOnLongClickListener(this);
577            icon.setOnTouchListener(this);
578
579            int index = i - startIndex;
580            int x = index % mCellCountX;
581            int y = index / mCellCountX;
582            layout.addViewToCellLayout(icon, -1, i, new PagedViewCellLayout.LayoutParams(x,y, 1,1));
583
584            items.add(info);
585            images.add(info.iconBitmap);
586        }
587
588        // Create the hardware layers
589        layout.allowHardwareLayerCreation();
590        layout.createHardwareLayers();
591
592        prepareGenerateHoloOutlinesTask(page, items, images);
593    }
594
595    /**
596     * Return the appropriate thread priority for loading for a given page (we give the current
597     * page much higher priority)
598     */
599    private int getThreadPriorityForPage(int page) {
600        // TODO-APPS_CUSTOMIZE: detect number of cores and set thread priorities accordingly below
601        int pageDiff = Math.abs(page - mCurrentPage);
602        if (pageDiff <= 0) {
603            // return Process.THREAD_PRIORITY_DEFAULT;
604            return Process.THREAD_PRIORITY_MORE_FAVORABLE;
605        } else if (pageDiff <= 1) {
606            // return Process.THREAD_PRIORITY_BACKGROUND;
607            return Process.THREAD_PRIORITY_DEFAULT;
608        } else {
609            // return Process.THREAD_PRIORITY_LOWEST;
610            return Process.THREAD_PRIORITY_DEFAULT;
611        }
612    }
613    /**
614     * Creates and executes a new AsyncTask to load a page of widget previews.
615     */
616    private void prepareLoadWidgetPreviewsTask(int page, ArrayList<Object> widgets,
617            int cellWidth, int cellHeight, int cellCountX) {
618        // Prune all tasks that are no longer needed
619        Iterator<AppsCustomizeAsyncTask> iter = mRunningTasks.iterator();
620        while (iter.hasNext()) {
621            AppsCustomizeAsyncTask task = (AppsCustomizeAsyncTask) iter.next();
622            int taskPage = task.page;
623            if ((taskPage == page) ||
624                    taskPage < getAssociatedLowerPageBound(mCurrentPage) ||
625                    taskPage > getAssociatedUpperPageBound(mCurrentPage)) {
626                task.cancel(false);
627                iter.remove();
628            } else {
629                task.setThreadPriority(getThreadPriorityForPage(taskPage));
630            }
631        }
632
633        AsyncTaskPageData pageData = new AsyncTaskPageData(page, widgets, cellWidth, cellHeight,
634            cellCountX, new AsyncTaskCallback() {
635                @Override
636                public void run(AppsCustomizeAsyncTask task, AsyncTaskPageData data) {
637                    // Ensure that this task starts running at the correct priority
638                    task.syncThreadPriority();
639
640                    // Load each of the widget/shortcut previews
641                    ArrayList<Object> items = data.items;
642                    ArrayList<Bitmap> images = data.generatedImages;
643                    int count = items.size();
644                    int cellWidth = data.cellWidth;
645                    int cellHeight = data.cellHeight;
646                    for (int i = 0; i < count && !task.isCancelled(); ++i) {
647                        // Before work on each item, ensure that this task is running at the correct
648                        // priority
649                        task.syncThreadPriority();
650
651                        Object rawInfo = items.get(i);
652                        if (rawInfo instanceof AppWidgetProviderInfo) {
653                            AppWidgetProviderInfo info = (AppWidgetProviderInfo) rawInfo;
654                            int[] cellSpans = CellLayout.rectToCell(getResources(),
655                                    info.minWidth, info.minHeight, null);
656                            images.add(getWidgetPreview(info, cellSpans[0],cellSpans[1],
657                                    cellWidth, cellHeight));
658                        } else if (rawInfo instanceof ResolveInfo) {
659                            // Fill in the shortcuts information
660                            ResolveInfo info = (ResolveInfo) rawInfo;
661                            images.add(getShortcutPreview(info, cellWidth, cellHeight));
662                        }
663                    }
664                }
665            },
666            new AsyncTaskCallback() {
667                @Override
668                public void run(AppsCustomizeAsyncTask task, AsyncTaskPageData data) {
669                    mRunningTasks.remove(task);
670                    if (task.isCancelled()) return;
671                    if (task.page > getPageCount()) return;
672                    if (task.pageContentType != mContentType) return;
673                    onSyncWidgetPageItems(data);
674                }
675        });
676
677        // Ensure that the task is appropriately prioritized and runs in parallel
678        AppsCustomizeAsyncTask t = new AppsCustomizeAsyncTask(page, mContentType,
679                AsyncTaskPageData.Type.LoadWidgetPreviewData);
680        t.setThreadPriority(getThreadPriorityForPage(page));
681        t.executeOnExecutor(AsyncTask.THREAD_POOL_EXECUTOR, pageData);
682        mRunningTasks.add(t);
683    }
684    /**
685     * Creates and executes a new AsyncTask to load the outlines for a page of content.
686     */
687    private void prepareGenerateHoloOutlinesTask(int page, ArrayList<Object> items,
688            ArrayList<Bitmap> images) {
689        // Prune old tasks for this page
690        Iterator<AppsCustomizeAsyncTask> iter = mRunningTasks.iterator();
691        while (iter.hasNext()) {
692            AppsCustomizeAsyncTask task = (AppsCustomizeAsyncTask) iter.next();
693            int taskPage = task.page;
694            if ((taskPage == page) &&
695                    (task.dataType == AsyncTaskPageData.Type.LoadHolographicIconsData)) {
696                task.cancel(false);
697                iter.remove();
698            }
699        }
700
701        AsyncTaskPageData pageData = new AsyncTaskPageData(page, items, images,
702            new AsyncTaskCallback() {
703                @Override
704                public void run(AppsCustomizeAsyncTask task, AsyncTaskPageData data) {
705                    // Ensure that this task starts running at the correct priority
706                    task.syncThreadPriority();
707
708                    ArrayList<Bitmap> images = data.generatedImages;
709                    ArrayList<Bitmap> srcImages = data.sourceImages;
710                    int count = srcImages.size();
711                    Canvas c = new Canvas();
712                    for (int i = 0; i < count && !task.isCancelled(); ++i) {
713                        // Before work on each item, ensure that this task is running at the correct
714                        // priority
715                        task.syncThreadPriority();
716
717                        Bitmap b = srcImages.get(i);
718                        Bitmap outline = Bitmap.createBitmap(b.getWidth(), b.getHeight(),
719                                Bitmap.Config.ARGB_8888);
720
721                        c.setBitmap(outline);
722                        c.save();
723                        c.drawBitmap(b, 0, 0, null);
724                        c.restore();
725
726                        images.add(outline);
727                    }
728                }
729            },
730            new AsyncTaskCallback() {
731                @Override
732                public void run(AppsCustomizeAsyncTask task, AsyncTaskPageData data) {
733                    mRunningTasks.remove(task);
734                    if (task.isCancelled()) return;
735                    if (task.page > getPageCount()) return;
736                    if (task.pageContentType != mContentType) return;
737                    onHolographicPageItemsLoaded(data);
738                }
739            });
740
741        // Ensure that the outline task always runs in the background, serially
742        AppsCustomizeAsyncTask t =
743            new AppsCustomizeAsyncTask(page, mContentType,
744                    AsyncTaskPageData.Type.LoadHolographicIconsData);
745        t.setThreadPriority(Process.THREAD_PRIORITY_BACKGROUND);
746        t.executeOnExecutor(AsyncTask.SERIAL_EXECUTOR, pageData);
747        mRunningTasks.add(t);
748    }
749
750    /*
751     * Widgets PagedView implementation
752     */
753    private void setupPage(PagedViewGridLayout layout) {
754        layout.setPadding(mPageLayoutPaddingLeft, mPageLayoutPaddingTop,
755                mPageLayoutPaddingRight, mPageLayoutPaddingBottom);
756
757        // Note: We force a measure here to get around the fact that when we do layout calculations
758        // immediately after syncing, we don't have a proper width.  That said, we already know the
759        // expected page width, so we can actually optimize by hiding all the TextView-based
760        // children that are expensive to measure, and let that happen naturally later.
761        setVisibilityOnChildren(layout, View.GONE);
762        int widthSpec = MeasureSpec.makeMeasureSpec(getMeasuredWidth(), MeasureSpec.AT_MOST);
763        int heightSpec = MeasureSpec.makeMeasureSpec(getMeasuredHeight(), MeasureSpec.AT_MOST);
764        layout.setMinimumWidth(getPageContentWidth());
765        layout.measure(widthSpec, heightSpec);
766        setVisibilityOnChildren(layout, View.VISIBLE);
767    }
768    private void renderDrawableToBitmap(Drawable d, Bitmap bitmap, int x, int y, int w, int h,
769            float scaleX, float scaleY) {
770        if (bitmap != null) {
771            Canvas c = new Canvas(bitmap);
772            c.scale(scaleX, scaleY);
773            Rect oldBounds = d.copyBounds();
774            d.setBounds(x, y, x + w, y + h);
775            d.draw(c);
776            d.setBounds(oldBounds); // Restore the bounds
777        }
778    }
779    private Bitmap getShortcutPreview(ResolveInfo info, int cellWidth, int cellHeight) {
780        // Render the icon
781        Bitmap preview = Bitmap.createBitmap(cellWidth, mAppIconSize, Config.ARGB_8888);
782        Drawable icon = mIconCache.getFullResIcon(info, mPackageManager);
783        renderDrawableToBitmap(icon, preview, 0, 0, mAppIconSize, mAppIconSize, 1f, 1f);
784        return preview;
785    }
786    private Bitmap getWidgetPreview(AppWidgetProviderInfo info,
787            int cellHSpan, int cellVSpan, int cellWidth, int cellHeight) {
788
789        // Calculate the size of the drawable
790        cellHSpan = Math.max(mMinWidgetSpan, Math.min(mMaxWidgetSpan, cellHSpan));
791        cellVSpan = Math.max(mMinWidgetSpan, Math.min(mMaxWidgetSpan, cellVSpan));
792        int expectedWidth = mWidgetSpacingLayout.estimateCellWidth(cellHSpan);
793        int expectedHeight = mWidgetSpacingLayout.estimateCellHeight(cellVSpan);
794
795        // Scale down the bitmap to fit the space
796        float widgetPreviewScale = (float) cellWidth / expectedWidth;
797        expectedWidth = (int) (widgetPreviewScale * expectedWidth);
798        expectedHeight = (int) (widgetPreviewScale * expectedHeight);
799
800        // Load the preview image if possible
801        String packageName = info.provider.getPackageName();
802        Drawable drawable = null;
803        Bitmap preview = null;
804        if (info.previewImage != 0) {
805            drawable = mPackageManager.getDrawable(packageName, info.previewImage, null);
806            if (drawable == null) {
807                Log.w(LOG_TAG, "Can't load icon drawable 0x" + Integer.toHexString(info.icon)
808                        + " for provider: " + info.provider);
809            } else {
810                // Scale down the preview to the dimensions we want
811                int imageWidth = drawable.getIntrinsicWidth();
812                int imageHeight = drawable.getIntrinsicHeight();
813                float aspect = (float) imageWidth / imageHeight;
814                int newWidth = imageWidth;
815                int newHeight = imageHeight;
816                if (aspect > 1f) {
817                    newWidth = expectedWidth;
818                    newHeight = (int) (imageHeight * ((float) expectedWidth / imageWidth));
819                } else {
820                    newHeight = expectedHeight;
821                    newWidth = (int) (imageWidth * ((float) expectedHeight / imageHeight));
822                }
823
824                preview = Bitmap.createBitmap(newWidth, newHeight, Config.ARGB_8888);
825                renderDrawableToBitmap(drawable, preview, 0, 0, newWidth, newHeight, 1f, 1f);
826            }
827        }
828
829        // Generate a preview image if we couldn't load one
830        if (drawable == null) {
831            Resources resources = mLauncher.getResources();
832
833            // Specify the dimensions of the bitmap
834            if (info.minWidth >= info.minHeight) {
835                expectedWidth = cellWidth;
836                expectedHeight = mWidgetPreviewIconPaddedDimension;
837            } else {
838                // Note that in vertical widgets, we might not have enough space due to the text
839                // label, so be conservative and use the width as a height bound
840                expectedWidth = mWidgetPreviewIconPaddedDimension;
841                expectedHeight = cellWidth;
842            }
843
844            preview = Bitmap.createBitmap(expectedWidth, expectedHeight, Config.ARGB_8888);
845            renderDrawableToBitmap(mDefaultWidgetBackground, preview, 0, 0, expectedWidth,
846                    expectedHeight, 1f,1f);
847
848            // Draw the icon in the top left corner
849            try {
850                Drawable icon = null;
851                if (info.icon > 0) icon = mPackageManager.getDrawable(packageName, info.icon, null);
852                if (icon == null) icon = resources.getDrawable(R.drawable.ic_launcher_application);
853
854                int offset = (int) (mAppIconSize * sWidgetPreviewIconPaddingPercentage);
855                renderDrawableToBitmap(icon, preview, offset, offset,
856                        mAppIconSize, mAppIconSize, 1f, 1f);
857            } catch (Resources.NotFoundException e) {}
858        }
859        return preview;
860    }
861    public void syncWidgetPages() {
862        // Ensure that we have the right number of pages
863        Context context = getContext();
864        int[] countX = { mWidgetCountX, mShortcutCountX };
865        int[] countY = { mWidgetCountY, mShortcutCountY };
866        Object[] collection = { mWidgets, mShortcuts };
867        for (int i = 0; i < 2; ++i) {
868            ArrayList<Object> list = (ArrayList<Object>) collection[i];
869            int numItemsPerPage = countX[i] * countY[i];
870            int numItemPages = (int) Math.ceil(list.size() / (float) numItemsPerPage);
871            for (int j = 0; j < numItemPages; ++j) {
872                PagedViewGridLayout layout = new PagedViewGridLayout(context, countX[i],
873                        countY[i]);
874                setupPage(layout);
875                addView(layout);
876            }
877        }
878    }
879    public void syncWidgetPageItems(int page) {
880        int[] countX = { mWidgetCountX, mShortcutCountX };
881        int[] countY = { mWidgetCountY, mShortcutCountY };
882        int[] widthGap = { mWidgetWidthGap, mWidgetWidthGap };
883        int[] heightGap = { mWidgetHeightGap, mWidgetHeightGap };
884        int[] numItemsPerPage = { mWidgetCountX * mWidgetCountY,
885                mShortcutCountX * mShortcutCountY };
886        Object[] collection = { mWidgets, mShortcuts };
887        int contentWidth = mWidgetSpacingLayout.getContentWidth();
888        int contentHeight = mWidgetSpacingLayout.getContentHeight();
889        int numWidgetPages = (int) Math.ceil(mWidgets.size() / (float) numItemsPerPage[0]);
890        int[] offsets = { page * numItemsPerPage[0], (page - numWidgetPages) * numItemsPerPage[1] };
891        int index = (page < numWidgetPages ? 0 : 1);
892
893        // Calculate the dimensions of each cell we are giving to each widget
894        ArrayList<Object> list = (ArrayList<Object>) collection[index];
895        ArrayList<Object> items = new ArrayList<Object>();
896        int cellWidth = ((contentWidth - mPageLayoutPaddingLeft - mPageLayoutPaddingRight
897                - ((countX[index] - 1) * widthGap[index])) / countX[index]);
898        int cellHeight = ((contentHeight - mPageLayoutPaddingTop - mPageLayoutPaddingBottom
899                - ((countY[index] - 1) * heightGap[index])) / countY[index]);
900
901        int offset = offsets[index];
902        for (int i = offset; i < Math.min(offset + numItemsPerPage[index], list.size()); ++i) {
903            items.add(list.get(i));
904        }
905
906        prepareLoadWidgetPreviewsTask(page, items, cellWidth, cellHeight, countX[index]);
907    }
908    private void onSyncWidgetPageItems(AsyncTaskPageData data) {
909        int page = data.page;
910        PagedViewGridLayout layout = (PagedViewGridLayout) getChildAt(page);
911        layout.removeAllViews();
912
913        ArrayList<Object> items = data.items;
914        int count = items.size();
915        int cellWidth = data.cellWidth;
916        int cellHeight = data.cellHeight;
917        int cellCountX = data.cellCountX;
918        for (int i = 0; i < count; ++i) {
919            Object rawInfo = items.get(i);
920            PendingAddItemInfo createItemInfo = null;
921            PagedViewWidget widget = (PagedViewWidget) mLayoutInflater.inflate(
922                    R.layout.apps_customize_widget, layout, false);
923            if (rawInfo instanceof AppWidgetProviderInfo) {
924                // Fill in the widget information
925                AppWidgetProviderInfo info = (AppWidgetProviderInfo) rawInfo;
926                createItemInfo = new PendingAddWidgetInfo(info, null, null);
927                int[] cellSpans = CellLayout.rectToCell(getResources(),
928                        info.minWidth, info.minHeight, null);
929                FastBitmapDrawable preview = new FastBitmapDrawable(data.generatedImages.get(i));
930                widget.applyFromAppWidgetProviderInfo(info, preview, -1, cellSpans,
931                        mHolographicOutlineHelper);
932                widget.setTag(createItemInfo);
933            } else if (rawInfo instanceof ResolveInfo) {
934                // Fill in the shortcuts information
935                ResolveInfo info = (ResolveInfo) rawInfo;
936                createItemInfo = new PendingAddItemInfo();
937                createItemInfo.itemType = LauncherSettings.Favorites.ITEM_TYPE_SHORTCUT;
938                createItemInfo.componentName = new ComponentName(info.activityInfo.packageName,
939                        info.activityInfo.name);
940                FastBitmapDrawable preview = new FastBitmapDrawable(data.generatedImages.get(i));
941                widget.applyFromResolveInfo(mPackageManager, info, preview,
942                        mHolographicOutlineHelper);
943                widget.setTag(createItemInfo);
944            }
945            widget.setOnClickListener(this);
946            widget.setOnLongClickListener(this);
947            widget.setOnTouchListener(this);
948
949            // Layout each widget
950            int ix = i % cellCountX;
951            int iy = i / cellCountX;
952            GridLayout.LayoutParams lp = new GridLayout.LayoutParams(
953                    new GridLayout.Group(iy, 1, GridLayout.LEFT),
954                    new GridLayout.Group(ix, 1, GridLayout.TOP));
955            lp.width = cellWidth;
956            lp.height = cellHeight;
957            if (ix > 0) lp.leftMargin = mWidgetWidthGap;
958            if (iy > 0) lp.topMargin = mWidgetHeightGap;
959            layout.addView(widget, lp);
960        }
961
962        invalidate();
963        forceUpdateAdjacentPagesAlpha();
964        prepareGenerateHoloOutlinesTask(data.page, data.items, data.generatedImages);
965    }
966    private void onHolographicPageItemsLoaded(AsyncTaskPageData data) {
967        // Invalidate early to short-circuit children invalidates
968        invalidate();
969
970        int page = data.page;
971        ViewGroup layout = (ViewGroup) getChildAt(page);
972        if (layout instanceof PagedViewCellLayout) {
973            PagedViewCellLayout cl = (PagedViewCellLayout) layout;
974            int count = cl.getPageChildCount();
975            if (count != data.generatedImages.size()) return;
976            for (int i = 0; i < count; ++i) {
977                PagedViewIcon icon = (PagedViewIcon) cl.getChildOnPageAt(i);
978                icon.setHolographicOutline(data.generatedImages.get(i));
979            }
980        } else {
981            int count = layout.getChildCount();
982            if (count != data.generatedImages.size()) return;
983            for (int i = 0; i < count; ++i) {
984                View v = layout.getChildAt(i);
985                ((PagedViewWidget) v).setHolographicOutline(data.generatedImages.get(i));
986            }
987        }
988    }
989
990    @Override
991    public void syncPages() {
992        removeAllViews();
993
994        // Remove all background asyc tasks if we are loading content anew
995        Iterator<AppsCustomizeAsyncTask> iter = mRunningTasks.iterator();
996        while (iter.hasNext()) {
997            AppsCustomizeAsyncTask task = (AppsCustomizeAsyncTask) iter.next();
998            task.cancel(false);
999            iter.remove();
1000        }
1001
1002        switch (mContentType) {
1003        case Applications:
1004            syncAppsPages();
1005            break;
1006        case Widgets:
1007            syncWidgetPages();
1008            break;
1009        }
1010    }
1011    @Override
1012    public void syncPageItems(int page) {
1013        switch (mContentType) {
1014        case Applications:
1015            syncAppsPageItems(page);
1016            break;
1017        case Widgets:
1018            syncWidgetPageItems(page);
1019            break;
1020        }
1021    }
1022
1023    /**
1024     * Used by the parent to get the content width to set the tab bar to
1025     * @return
1026     */
1027    public int getPageContentWidth() {
1028        return mContentWidth;
1029    }
1030
1031    @Override
1032    protected void onPageBeginMoving() {
1033        /* TO BE ENABLED LATER
1034        setChildrenDrawnWithCacheEnabled(true);
1035        for (int i = 0; i < getChildCount(); ++i) {
1036            View v = getChildAt(i);
1037            if (v instanceof PagedViewCellLayout) {
1038                ((PagedViewCellLayout) v).setChildrenDrawingCacheEnabled(true);
1039            }
1040        }
1041        */
1042        super.onPageBeginMoving();
1043    }
1044
1045    @Override
1046    protected void onPageEndMoving() {
1047        /* TO BE ENABLED LATER
1048        for (int i = 0; i < getChildCount(); ++i) {
1049            View v = getChildAt(i);
1050            if (v instanceof PagedViewCellLayout) {
1051                ((PagedViewCellLayout) v).setChildrenDrawingCacheEnabled(false);
1052            }
1053        }
1054        setChildrenDrawnWithCacheEnabled(false);
1055        */
1056        super.onPageEndMoving();
1057    }
1058
1059    /*
1060     * AllAppsView implementation
1061     */
1062    @Override
1063    public void setup(Launcher launcher, DragController dragController) {
1064        mLauncher = launcher;
1065        mDragController = dragController;
1066    }
1067    @Override
1068    public void zoom(float zoom, boolean animate) {
1069        // TODO-APPS_CUSTOMIZE: Call back to mLauncher.zoomed()
1070    }
1071    @Override
1072    public boolean isVisible() {
1073        return (getVisibility() == VISIBLE);
1074    }
1075    @Override
1076    public boolean isAnimating() {
1077        return false;
1078    }
1079    @Override
1080    public void setApps(ArrayList<ApplicationInfo> list) {
1081        mApps = list;
1082        Collections.sort(mApps, LauncherModel.APP_NAME_COMPARATOR);
1083
1084        // The next layout pass will trigger data-ready if both widgets and apps are set, so
1085        // request a layout to do this test and invalidate the page data when ready.
1086        if (testDataReady()) requestLayout();
1087    }
1088    private void addAppsWithoutInvalidate(ArrayList<ApplicationInfo> list) {
1089        // We add it in place, in alphabetical order
1090        int count = list.size();
1091        for (int i = 0; i < count; ++i) {
1092            ApplicationInfo info = list.get(i);
1093            int index = Collections.binarySearch(mApps, info, LauncherModel.APP_NAME_COMPARATOR);
1094            if (index < 0) {
1095                mApps.add(-(index + 1), info);
1096            }
1097        }
1098    }
1099    @Override
1100    public void addApps(ArrayList<ApplicationInfo> list) {
1101        addAppsWithoutInvalidate(list);
1102        invalidatePageData();
1103    }
1104    private int findAppByComponent(List<ApplicationInfo> list, ApplicationInfo item) {
1105        ComponentName removeComponent = item.intent.getComponent();
1106        int length = list.size();
1107        for (int i = 0; i < length; ++i) {
1108            ApplicationInfo info = list.get(i);
1109            if (info.intent.getComponent().equals(removeComponent)) {
1110                return i;
1111            }
1112        }
1113        return -1;
1114    }
1115    private void removeAppsWithoutInvalidate(ArrayList<ApplicationInfo> list) {
1116        // loop through all the apps and remove apps that have the same component
1117        int length = list.size();
1118        for (int i = 0; i < length; ++i) {
1119            ApplicationInfo info = list.get(i);
1120            int removeIndex = findAppByComponent(mApps, info);
1121            if (removeIndex > -1) {
1122                mApps.remove(removeIndex);
1123            }
1124        }
1125    }
1126    @Override
1127    public void removeApps(ArrayList<ApplicationInfo> list) {
1128        removeAppsWithoutInvalidate(list);
1129        invalidatePageData();
1130    }
1131    @Override
1132    public void updateApps(ArrayList<ApplicationInfo> list) {
1133        // We remove and re-add the updated applications list because it's properties may have
1134        // changed (ie. the title), and this will ensure that the items will be in their proper
1135        // place in the list.
1136        removeAppsWithoutInvalidate(list);
1137        addAppsWithoutInvalidate(list);
1138        invalidatePageData();
1139    }
1140    @Override
1141    public void reset() {
1142        if (mContentType != ContentType.Applications) {
1143            // Reset to the first page of the Apps pane
1144            AppsCustomizeTabHost tabs = (AppsCustomizeTabHost)
1145                    mLauncher.findViewById(R.id.apps_customize_pane);
1146            tabs.setCurrentTabByTag(tabs.getTabTagForContentType(ContentType.Applications));
1147        } else {
1148            setCurrentPage(0);
1149            invalidatePageData();
1150        }
1151    }
1152    @Override
1153    public void dumpState() {
1154        // TODO: Dump information related to current list of Applications, Widgets, etc.
1155        ApplicationInfo.dumpApplicationInfoList(LOG_TAG, "mApps", mApps);
1156        dumpAppWidgetProviderInfoList(LOG_TAG, "mWidgets", mWidgets);
1157        dumpAppWidgetProviderInfoList(LOG_TAG, "mShortcuts", mShortcuts);
1158    }
1159    private void dumpAppWidgetProviderInfoList(String tag, String label,
1160            ArrayList<Object> list) {
1161        Log.d(tag, label + " size=" + list.size());
1162        for (Object i: list) {
1163            if (i instanceof AppWidgetProviderInfo) {
1164                AppWidgetProviderInfo info = (AppWidgetProviderInfo) i;
1165                Log.d(tag, "   label=\"" + info.label + "\" previewImage=" + info.previewImage
1166                        + " resizeMode=" + info.resizeMode + " configure=" + info.configure
1167                        + " initialLayout=" + info.initialLayout
1168                        + " minWidth=" + info.minWidth + " minHeight=" + info.minHeight);
1169            } else if (i instanceof ResolveInfo) {
1170                ResolveInfo info = (ResolveInfo) i;
1171                Log.d(tag, "   label=\"" + info.loadLabel(mPackageManager) + "\" icon="
1172                        + info.icon);
1173            }
1174        }
1175    }
1176    @Override
1177    public void surrender() {
1178        // TODO: If we are in the middle of any process (ie. for holographic outlines, etc) we
1179        // should stop this now.
1180    }
1181
1182    /*
1183     * We load an extra page on each side to prevent flashes from scrolling and loading of the
1184     * widget previews in the background with the AsyncTasks.
1185     */
1186    protected int getAssociatedLowerPageBound(int page) {
1187        return Math.max(0, page - 2);
1188    }
1189    protected int getAssociatedUpperPageBound(int page) {
1190        final int count = getChildCount();
1191        return Math.min(page + 2, count - 1);
1192    }
1193
1194    @Override
1195    protected String getCurrentPageDescription() {
1196        int page = (mNextPage != INVALID_PAGE) ? mNextPage : mCurrentPage;
1197        int stringId = R.string.default_scroll_format;
1198        switch (mContentType) {
1199        case Applications:
1200            stringId = R.string.apps_customize_apps_scroll_format;
1201            break;
1202        case Widgets:
1203            stringId = R.string.apps_customize_widgets_scroll_format;
1204            break;
1205        }
1206        return String.format(mContext.getString(stringId), page + 1, getChildCount());
1207    }
1208}
1209