AppsCustomizePagedView.java revision d52f3d84fc1df6b4c1ae1101eb937ae4eeb32e75
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
389    private void beginDraggingApplication(View v) {
390        mLauncher.getWorkspace().onDragStartedWithItem(v);
391        mLauncher.getWorkspace().beginDragShared(v, this);
392    }
393
394    private void beginDraggingWidget(View v) {
395        // Get the widget preview as the drag representation
396        ImageView image = (ImageView) v.findViewById(R.id.widget_preview);
397        PendingAddItemInfo createItemInfo = (PendingAddItemInfo) v.getTag();
398
399        // Compose the drag image
400        Bitmap b;
401        Drawable preview = image.getDrawable();
402        int w = preview.getIntrinsicWidth();
403        int h = preview.getIntrinsicHeight();
404        if (createItemInfo instanceof PendingAddWidgetInfo) {
405            PendingAddWidgetInfo createWidgetInfo = (PendingAddWidgetInfo) createItemInfo;
406            int[] spanXY = CellLayout.rectToCell(getResources(),
407                    createWidgetInfo.minWidth, createWidgetInfo.minHeight, null);
408            createItemInfo.spanX = spanXY[0];
409            createItemInfo.spanY = spanXY[1];
410
411            b = Bitmap.createBitmap(w, h, Bitmap.Config.ARGB_8888);
412            renderDrawableToBitmap(preview, b, 0, 0, w, h, 1, 1);
413        } else {
414            // Workaround for the fact that we don't keep the original ResolveInfo associated with
415            // the shortcut around.  To get the icon, we just render the preview image (which has
416            // the shortcut icon) to a new drag bitmap that clips the non-icon space.
417            b = Bitmap.createBitmap(mWidgetPreviewIconPaddedDimension,
418                    mWidgetPreviewIconPaddedDimension, Bitmap.Config.ARGB_8888);
419            mCanvas.setBitmap(b);
420            mCanvas.save();
421            preview.draw(mCanvas);
422            mCanvas.restore();
423            createItemInfo.spanX = createItemInfo.spanY = 1;
424        }
425
426        // Start the drag
427        mLauncher.lockScreenOrientation();
428        mLauncher.getWorkspace().onDragStartedWithItemSpans(createItemInfo.spanX,
429                createItemInfo.spanY, b);
430        mDragController.startDrag(image, b, this, createItemInfo,
431                DragController.DRAG_ACTION_COPY, null);
432        b.recycle();
433    }
434    @Override
435    protected boolean beginDragging(View v) {
436        if (!super.beginDragging(v)) return false;
437
438        // Go into spring loaded mode (must happen before we startDrag())
439        int currentPageIndex = mLauncher.getWorkspace().getCurrentPage();
440        CellLayout currentPage = (CellLayout) mLauncher.getWorkspace().getChildAt(currentPageIndex);
441        mLauncher.enterSpringLoadedDragMode(currentPage);
442
443        if (v instanceof PagedViewIcon) {
444            beginDraggingApplication(v);
445        } else if (v instanceof PagedViewWidget) {
446            beginDraggingWidget(v);
447        }
448        return true;
449    }
450    private void endDragging(View target, boolean success) {
451        mLauncher.getWorkspace().onDragStopped(success);
452        if (!success || target != mLauncher.getWorkspace()) {
453            // Exit spring loaded mode if we have not successfully dropped or have not handled the
454            // drop in Workspace
455            mLauncher.exitSpringLoadedDragMode();
456        }
457        mLauncher.unlockScreenOrientation();
458
459    }
460
461    /*
462     * DragSource implementation
463     */
464    @Override
465    public void onDragViewVisible() {}
466    @Override
467    public void onDropCompleted(View target, DragObject d, boolean success) {
468        endDragging(target, success);
469
470        // Display an error message if the drag failed due to there not being enough space on the
471        // target layout we were dropping on.
472        if (!success) {
473            boolean showOutOfSpaceMessage = false;
474            if (target instanceof Workspace) {
475                int currentScreen = mLauncher.getCurrentWorkspaceScreen();
476                Workspace workspace = (Workspace) target;
477                CellLayout layout = (CellLayout) workspace.getChildAt(currentScreen);
478                ItemInfo itemInfo = (ItemInfo) d.dragInfo;
479                if (layout != null) {
480                    layout.calculateSpans(itemInfo);
481                    showOutOfSpaceMessage =
482                            !layout.findCellForSpan(null, itemInfo.spanX, itemInfo.spanY);
483                }
484            }
485            // TODO-APPS_CUSTOMIZE: We need to handle this for folders as well later.
486            if (showOutOfSpaceMessage) {
487                mLauncher.showOutOfSpaceMessage();
488            }
489        }
490    }
491
492    public void setContentType(ContentType type) {
493        mContentType = type;
494        setCurrentPage(0);
495        invalidatePageData();
496    }
497
498    public boolean isContentType(ContentType type) {
499        return (mContentType == type);
500    }
501
502    /*
503     * Apps PagedView implementation
504     */
505    private void setVisibilityOnChildren(ViewGroup layout, int visibility) {
506        int childCount = layout.getChildCount();
507        for (int i = 0; i < childCount; ++i) {
508            layout.getChildAt(i).setVisibility(visibility);
509        }
510    }
511    private void setupPage(PagedViewCellLayout layout) {
512        layout.setCellCount(mCellCountX, mCellCountY);
513        layout.setGap(mPageLayoutWidthGap, mPageLayoutHeightGap);
514        layout.setPadding(mPageLayoutPaddingLeft, mPageLayoutPaddingTop,
515                mPageLayoutPaddingRight, mPageLayoutPaddingBottom);
516
517        // Note: We force a measure here to get around the fact that when we do layout calculations
518        // immediately after syncing, we don't have a proper width.  That said, we already know the
519        // expected page width, so we can actually optimize by hiding all the TextView-based
520        // children that are expensive to measure, and let that happen naturally later.
521        setVisibilityOnChildren(layout, View.GONE);
522        int widthSpec = MeasureSpec.makeMeasureSpec(getMeasuredWidth(), MeasureSpec.AT_MOST);
523        int heightSpec = MeasureSpec.makeMeasureSpec(getMeasuredHeight(), MeasureSpec.AT_MOST);
524        layout.setMinimumWidth(getPageContentWidth());
525        layout.measure(widthSpec, heightSpec);
526        setVisibilityOnChildren(layout, View.VISIBLE);
527    }
528    public void syncAppsPages() {
529        // Ensure that we have the right number of pages
530        Context context = getContext();
531        int numPages = (int) Math.ceil((float) mApps.size() / (mCellCountX * mCellCountY));
532        for (int i = 0; i < numPages; ++i) {
533            PagedViewCellLayout layout = new PagedViewCellLayout(context);
534            setupPage(layout);
535            addView(layout);
536        }
537    }
538    public void syncAppsPageItems(int page) {
539        // ensure that we have the right number of items on the pages
540        int numPages = getPageCount();
541        int numCells = mCellCountX * mCellCountY;
542        int startIndex = page * numCells;
543        int endIndex = Math.min(startIndex + numCells, mApps.size());
544        PagedViewCellLayout layout = (PagedViewCellLayout) getChildAt(page);
545
546        layout.removeAllViewsOnPage();
547        ArrayList<Object> items = new ArrayList<Object>();
548        ArrayList<Bitmap> images = new ArrayList<Bitmap>();
549        for (int i = startIndex; i < endIndex; ++i) {
550            ApplicationInfo info = mApps.get(i);
551            PagedViewIcon icon = (PagedViewIcon) mLayoutInflater.inflate(
552                    R.layout.apps_customize_application, layout, false);
553            icon.applyFromApplicationInfo(info, true, mHolographicOutlineHelper);
554            icon.setOnClickListener(this);
555            icon.setOnLongClickListener(this);
556            icon.setOnTouchListener(this);
557
558            int index = i - startIndex;
559            int x = index % mCellCountX;
560            int y = index / mCellCountX;
561            layout.addViewToCellLayout(icon, -1, i, new PagedViewCellLayout.LayoutParams(x,y, 1,1));
562
563            items.add(info);
564            images.add(info.iconBitmap);
565        }
566
567        // Create the hardware layers
568        layout.allowHardwareLayerCreation();
569        layout.createHardwareLayers();
570
571        prepareGenerateHoloOutlinesTask(page, items, images);
572    }
573
574    /**
575     * Return the appropriate thread priority for loading for a given page (we give the current
576     * page much higher priority)
577     */
578    private int getThreadPriorityForPage(int page) {
579        // TODO-APPS_CUSTOMIZE: detect number of cores and set thread priorities accordingly below
580        int pageDiff = Math.abs(page - mCurrentPage);
581        if (pageDiff <= 0) {
582            // return Process.THREAD_PRIORITY_DEFAULT;
583            return Process.THREAD_PRIORITY_MORE_FAVORABLE;
584        } else if (pageDiff <= 1) {
585            // return Process.THREAD_PRIORITY_BACKGROUND;
586            return Process.THREAD_PRIORITY_DEFAULT;
587        } else {
588            // return Process.THREAD_PRIORITY_LOWEST;
589            return Process.THREAD_PRIORITY_DEFAULT;
590        }
591    }
592    /**
593     * Creates and executes a new AsyncTask to load a page of widget previews.
594     */
595    private void prepareLoadWidgetPreviewsTask(int page, ArrayList<Object> widgets,
596            int cellWidth, int cellHeight, int cellCountX) {
597        // Prune all tasks that are no longer needed
598        Iterator<AppsCustomizeAsyncTask> iter = mRunningTasks.iterator();
599        while (iter.hasNext()) {
600            AppsCustomizeAsyncTask task = (AppsCustomizeAsyncTask) iter.next();
601            int taskPage = task.page;
602            if ((taskPage == page) ||
603                    taskPage < getAssociatedLowerPageBound(mCurrentPage) ||
604                    taskPage > getAssociatedUpperPageBound(mCurrentPage)) {
605                task.cancel(false);
606                iter.remove();
607            } else {
608                task.setThreadPriority(getThreadPriorityForPage(taskPage));
609            }
610        }
611
612        AsyncTaskPageData pageData = new AsyncTaskPageData(page, widgets, cellWidth, cellHeight,
613            cellCountX, new AsyncTaskCallback() {
614                @Override
615                public void run(AppsCustomizeAsyncTask task, AsyncTaskPageData data) {
616                    // Ensure that this task starts running at the correct priority
617                    task.syncThreadPriority();
618
619                    // Load each of the widget/shortcut previews
620                    ArrayList<Object> items = data.items;
621                    ArrayList<Bitmap> images = data.generatedImages;
622                    int count = items.size();
623                    int cellWidth = data.cellWidth;
624                    int cellHeight = data.cellHeight;
625                    for (int i = 0; i < count && !task.isCancelled(); ++i) {
626                        // Before work on each item, ensure that this task is running at the correct
627                        // priority
628                        task.syncThreadPriority();
629
630                        Object rawInfo = items.get(i);
631                        if (rawInfo instanceof AppWidgetProviderInfo) {
632                            AppWidgetProviderInfo info = (AppWidgetProviderInfo) rawInfo;
633                            int[] cellSpans = CellLayout.rectToCell(getResources(),
634                                    info.minWidth, info.minHeight, null);
635                            images.add(getWidgetPreview(info, cellSpans[0],cellSpans[1],
636                                    cellWidth, cellHeight));
637                        } else if (rawInfo instanceof ResolveInfo) {
638                            // Fill in the shortcuts information
639                            ResolveInfo info = (ResolveInfo) rawInfo;
640                            images.add(getShortcutPreview(info, cellWidth, cellHeight));
641                        }
642                    }
643                }
644            },
645            new AsyncTaskCallback() {
646                @Override
647                public void run(AppsCustomizeAsyncTask task, AsyncTaskPageData data) {
648                    mRunningTasks.remove(task);
649                    if (task.isCancelled()) return;
650                    if (task.page > getPageCount()) return;
651                    if (task.pageContentType != mContentType) return;
652                    onSyncWidgetPageItems(data);
653                }
654        });
655
656        // Ensure that the task is appropriately prioritized and runs in parallel
657        AppsCustomizeAsyncTask t = new AppsCustomizeAsyncTask(page, mContentType,
658                AsyncTaskPageData.Type.LoadWidgetPreviewData);
659        t.setThreadPriority(getThreadPriorityForPage(page));
660        t.executeOnExecutor(AsyncTask.THREAD_POOL_EXECUTOR, pageData);
661        mRunningTasks.add(t);
662    }
663    /**
664     * Creates and executes a new AsyncTask to load the outlines for a page of content.
665     */
666    private void prepareGenerateHoloOutlinesTask(int page, ArrayList<Object> items,
667            ArrayList<Bitmap> images) {
668        // Prune old tasks for this page
669        Iterator<AppsCustomizeAsyncTask> iter = mRunningTasks.iterator();
670        while (iter.hasNext()) {
671            AppsCustomizeAsyncTask task = (AppsCustomizeAsyncTask) iter.next();
672            int taskPage = task.page;
673            if ((taskPage == page) &&
674                    (task.dataType == AsyncTaskPageData.Type.LoadHolographicIconsData)) {
675                task.cancel(false);
676                iter.remove();
677            }
678        }
679
680        AsyncTaskPageData pageData = new AsyncTaskPageData(page, items, images,
681            new AsyncTaskCallback() {
682                @Override
683                public void run(AppsCustomizeAsyncTask task, AsyncTaskPageData data) {
684                    // Ensure that this task starts running at the correct priority
685                    task.syncThreadPriority();
686
687                    ArrayList<Bitmap> images = data.generatedImages;
688                    ArrayList<Bitmap> srcImages = data.sourceImages;
689                    int count = srcImages.size();
690                    Canvas c = new Canvas();
691                    for (int i = 0; i < count && !task.isCancelled(); ++i) {
692                        // Before work on each item, ensure that this task is running at the correct
693                        // priority
694                        task.syncThreadPriority();
695
696                        Bitmap b = srcImages.get(i);
697                        Bitmap outline = Bitmap.createBitmap(b.getWidth(), b.getHeight(),
698                                Bitmap.Config.ARGB_8888);
699
700                        c.setBitmap(outline);
701                        c.save();
702                        c.drawBitmap(b, 0, 0, null);
703                        c.restore();
704
705                        images.add(outline);
706                    }
707                }
708            },
709            new AsyncTaskCallback() {
710                @Override
711                public void run(AppsCustomizeAsyncTask task, AsyncTaskPageData data) {
712                    mRunningTasks.remove(task);
713                    if (task.isCancelled()) return;
714                    if (task.page > getPageCount()) return;
715                    if (task.pageContentType != mContentType) return;
716                    onHolographicPageItemsLoaded(data);
717                }
718            });
719
720        // Ensure that the outline task always runs in the background, serially
721        AppsCustomizeAsyncTask t =
722            new AppsCustomizeAsyncTask(page, mContentType,
723                    AsyncTaskPageData.Type.LoadHolographicIconsData);
724        t.setThreadPriority(Process.THREAD_PRIORITY_BACKGROUND);
725        t.executeOnExecutor(AsyncTask.SERIAL_EXECUTOR, pageData);
726        mRunningTasks.add(t);
727    }
728
729    /*
730     * Widgets PagedView implementation
731     */
732    private void setupPage(PagedViewGridLayout layout) {
733        layout.setPadding(mPageLayoutPaddingLeft, mPageLayoutPaddingTop,
734                mPageLayoutPaddingRight, mPageLayoutPaddingBottom);
735
736        // Note: We force a measure here to get around the fact that when we do layout calculations
737        // immediately after syncing, we don't have a proper width.
738        int widthSpec = MeasureSpec.makeMeasureSpec(getMeasuredWidth(), MeasureSpec.AT_MOST);
739        int heightSpec = MeasureSpec.makeMeasureSpec(getMeasuredHeight(), MeasureSpec.AT_MOST);
740        layout.setMinimumWidth(getPageContentWidth());
741        layout.measure(widthSpec, heightSpec);
742    }
743    private void renderDrawableToBitmap(Drawable d, Bitmap bitmap, int x, int y, int w, int h,
744            float scaleX, float scaleY) {
745        if (bitmap != null) {
746            Canvas c = new Canvas(bitmap);
747            c.scale(scaleX, scaleY);
748            Rect oldBounds = d.copyBounds();
749            d.setBounds(x, y, x + w, y + h);
750            d.draw(c);
751            d.setBounds(oldBounds); // Restore the bounds
752        }
753    }
754    private Bitmap getShortcutPreview(ResolveInfo info, int cellWidth, int cellHeight) {
755        // Render the icon
756        Bitmap preview = Bitmap.createBitmap(cellWidth, mAppIconSize, Config.ARGB_8888);
757        Drawable icon = mIconCache.getFullResIcon(info, mPackageManager);
758        renderDrawableToBitmap(icon, preview, 0, 0, mAppIconSize, mAppIconSize, 1f, 1f);
759        return preview;
760    }
761    private Bitmap getWidgetPreview(AppWidgetProviderInfo info,
762            int cellHSpan, int cellVSpan, int cellWidth, int cellHeight) {
763
764        // Calculate the size of the drawable
765        cellHSpan = Math.max(mMinWidgetSpan, Math.min(mMaxWidgetSpan, cellHSpan));
766        cellVSpan = Math.max(mMinWidgetSpan, Math.min(mMaxWidgetSpan, cellVSpan));
767        int expectedWidth = mWidgetSpacingLayout.estimateCellWidth(cellHSpan);
768        int expectedHeight = mWidgetSpacingLayout.estimateCellHeight(cellVSpan);
769
770        // Scale down the bitmap to fit the space
771        float widgetPreviewScale = (float) cellWidth / expectedWidth;
772        expectedWidth = (int) (widgetPreviewScale * expectedWidth);
773        expectedHeight = (int) (widgetPreviewScale * expectedHeight);
774
775        // Load the preview image if possible
776        String packageName = info.provider.getPackageName();
777        Drawable drawable = null;
778        Bitmap preview = null;
779        if (info.previewImage != 0) {
780            drawable = mPackageManager.getDrawable(packageName, info.previewImage, null);
781            if (drawable == null) {
782                Log.w(LOG_TAG, "Can't load icon drawable 0x" + Integer.toHexString(info.icon)
783                        + " for provider: " + info.provider);
784            } else {
785                // Scale down the preview to the dimensions we want
786                int imageWidth = drawable.getIntrinsicWidth();
787                int imageHeight = drawable.getIntrinsicHeight();
788                float aspect = (float) imageWidth / imageHeight;
789                int newWidth = imageWidth;
790                int newHeight = imageHeight;
791                if (aspect > 1f) {
792                    newWidth = expectedWidth;
793                    newHeight = (int) (imageHeight * ((float) expectedWidth / imageWidth));
794                } else {
795                    newHeight = expectedHeight;
796                    newWidth = (int) (imageWidth * ((float) expectedHeight / imageHeight));
797                }
798
799                preview = Bitmap.createBitmap(newWidth, newHeight, Config.ARGB_8888);
800                renderDrawableToBitmap(drawable, preview, 0, 0, newWidth, newHeight, 1f, 1f);
801            }
802        }
803
804        // Generate a preview image if we couldn't load one
805        if (drawable == null) {
806            Resources resources = mLauncher.getResources();
807            int bitmapWidth;
808            int bitmapHeight;
809
810            // Specify the dimensions of the bitmap (since we are using a default preview bg with
811            // the full icon, we only imply the aspect ratio of the widget)
812            if (cellHSpan == cellVSpan) {
813                bitmapWidth = bitmapHeight = cellWidth;
814                expectedWidth = expectedHeight = mWidgetPreviewIconPaddedDimension;
815            } else if (cellHSpan >= cellVSpan) {
816                bitmapWidth = expectedWidth = cellWidth;
817                bitmapHeight = expectedHeight = mWidgetPreviewIconPaddedDimension;
818            } else {
819                // Note that in vertical widgets, we might not have enough space due to the text
820                // label, so be conservative and use the width as a height bound
821                bitmapWidth = expectedWidth = mWidgetPreviewIconPaddedDimension;
822                bitmapHeight = expectedHeight = cellWidth;
823            }
824
825            preview = Bitmap.createBitmap(bitmapWidth, bitmapHeight, Config.ARGB_8888);
826            renderDrawableToBitmap(mDefaultWidgetBackground, preview, 0, 0, expectedWidth,
827                    expectedHeight, 1f,1f);
828
829            // Draw the icon in the top left corner
830            try {
831                Drawable icon = null;
832                if (info.icon > 0) icon = mPackageManager.getDrawable(packageName, info.icon, null);
833                if (icon == null) icon = resources.getDrawable(R.drawable.ic_launcher_application);
834
835                int offset = (int) (mAppIconSize * sWidgetPreviewIconPaddingPercentage);
836                renderDrawableToBitmap(icon, preview, offset, offset,
837                        mAppIconSize, mAppIconSize, 1f, 1f);
838            } catch (Resources.NotFoundException e) {}
839        }
840        return preview;
841    }
842    public void syncWidgetPages() {
843        // Ensure that we have the right number of pages
844        Context context = getContext();
845        int[] countX = { mWidgetCountX, mShortcutCountX };
846        int[] countY = { mWidgetCountY, mShortcutCountY };
847        Object[] collection = { mWidgets, mShortcuts };
848        for (int i = 0; i < 2; ++i) {
849            ArrayList<Object> list = (ArrayList<Object>) collection[i];
850            int numItemsPerPage = countX[i] * countY[i];
851            int numItemPages = (int) Math.ceil(list.size() / (float) numItemsPerPage);
852            for (int j = 0; j < numItemPages; ++j) {
853                PagedViewGridLayout layout = new PagedViewGridLayout(context, countX[i],
854                        countY[i]);
855                setupPage(layout);
856                addView(layout);
857            }
858        }
859    }
860    public void syncWidgetPageItems(int page) {
861        int[] countX = { mWidgetCountX, mShortcutCountX };
862        int[] countY = { mWidgetCountY, mShortcutCountY };
863        int[] widthGap = { mWidgetWidthGap, mWidgetWidthGap };
864        int[] heightGap = { mWidgetHeightGap, mWidgetHeightGap };
865        int[] numItemsPerPage = { mWidgetCountX * mWidgetCountY,
866                mShortcutCountX * mShortcutCountY };
867        Object[] collection = { mWidgets, mShortcuts };
868        int contentWidth = mWidgetSpacingLayout.getContentWidth();
869        int contentHeight = mWidgetSpacingLayout.getContentHeight();
870        int numWidgetPages = (int) Math.ceil(mWidgets.size() / (float) numItemsPerPage[0]);
871        int[] offsets = { page * numItemsPerPage[0], (page - numWidgetPages) * numItemsPerPage[1] };
872        int index = (page < numWidgetPages ? 0 : 1);
873
874        // Calculate the dimensions of each cell we are giving to each widget
875        ArrayList<Object> list = (ArrayList<Object>) collection[index];
876        ArrayList<Object> items = new ArrayList<Object>();
877        int cellWidth = ((contentWidth - mPageLayoutPaddingLeft - mPageLayoutPaddingRight
878                - ((countX[index] - 1) * widthGap[index])) / countX[index]);
879        int cellHeight = ((contentHeight - mPageLayoutPaddingTop - mPageLayoutPaddingBottom
880                - ((countY[index] - 1) * heightGap[index])) / countY[index]);
881
882        int offset = offsets[index];
883        for (int i = offset; i < Math.min(offset + numItemsPerPage[index], list.size()); ++i) {
884            items.add(list.get(i));
885        }
886
887        prepareLoadWidgetPreviewsTask(page, items, cellWidth, cellHeight, countX[index]);
888    }
889    private void onSyncWidgetPageItems(AsyncTaskPageData data) {
890        int page = data.page;
891        PagedViewGridLayout layout = (PagedViewGridLayout) getChildAt(page);
892        // Only set the column count once we have items
893        layout.setColumnCount(layout.getCellCountX());
894
895        ArrayList<Object> items = data.items;
896        int count = items.size();
897        int cellWidth = data.cellWidth;
898        int cellHeight = data.cellHeight;
899        int cellCountX = data.cellCountX;
900        for (int i = 0; i < count; ++i) {
901            Object rawInfo = items.get(i);
902            PendingAddItemInfo createItemInfo = null;
903            PagedViewWidget widget = (PagedViewWidget) mLayoutInflater.inflate(
904                    R.layout.apps_customize_widget, layout, false);
905            if (rawInfo instanceof AppWidgetProviderInfo) {
906                // Fill in the widget information
907                AppWidgetProviderInfo info = (AppWidgetProviderInfo) rawInfo;
908                createItemInfo = new PendingAddWidgetInfo(info, null, null);
909                int[] cellSpans = CellLayout.rectToCell(getResources(),
910                        info.minWidth, info.minHeight, null);
911                FastBitmapDrawable preview = new FastBitmapDrawable(data.generatedImages.get(i));
912                widget.applyFromAppWidgetProviderInfo(info, preview, -1, cellSpans,
913                        mHolographicOutlineHelper);
914                widget.setTag(createItemInfo);
915            } else if (rawInfo instanceof ResolveInfo) {
916                // Fill in the shortcuts information
917                ResolveInfo info = (ResolveInfo) rawInfo;
918                createItemInfo = new PendingAddItemInfo();
919                createItemInfo.itemType = LauncherSettings.Favorites.ITEM_TYPE_SHORTCUT;
920                createItemInfo.componentName = new ComponentName(info.activityInfo.packageName,
921                        info.activityInfo.name);
922                FastBitmapDrawable preview = new FastBitmapDrawable(data.generatedImages.get(i));
923                widget.applyFromResolveInfo(mPackageManager, info, preview,
924                        mHolographicOutlineHelper);
925                widget.setTag(createItemInfo);
926            }
927            widget.setOnClickListener(this);
928            widget.setOnLongClickListener(this);
929            widget.setOnTouchListener(this);
930
931            // Layout each widget
932            int ix = i % cellCountX;
933            int iy = i / cellCountX;
934            GridLayout.LayoutParams lp = new GridLayout.LayoutParams(
935                    GridLayout.spec(iy, GridLayout.LEFT, GridLayout.CAN_STRETCH),
936                    GridLayout.spec(ix, GridLayout.TOP, GridLayout.CAN_STRETCH));
937            lp.width = cellWidth;
938            lp.height = cellHeight;
939            if (ix > 0) lp.leftMargin = mWidgetWidthGap;
940            if (iy > 0) lp.topMargin = mWidgetHeightGap;
941            layout.addView(widget, lp);
942        }
943
944        invalidate();
945        forceUpdateAdjacentPagesAlpha();
946        prepareGenerateHoloOutlinesTask(data.page, data.items, data.generatedImages);
947    }
948    private void onHolographicPageItemsLoaded(AsyncTaskPageData data) {
949        // Invalidate early to short-circuit children invalidates
950        invalidate();
951
952        int page = data.page;
953        ViewGroup layout = (ViewGroup) getChildAt(page);
954        if (layout instanceof PagedViewCellLayout) {
955            PagedViewCellLayout cl = (PagedViewCellLayout) layout;
956            int count = cl.getPageChildCount();
957            if (count != data.generatedImages.size()) return;
958            for (int i = 0; i < count; ++i) {
959                PagedViewIcon icon = (PagedViewIcon) cl.getChildOnPageAt(i);
960                icon.setHolographicOutline(data.generatedImages.get(i));
961            }
962        } else {
963            int count = layout.getChildCount();
964            if (count != data.generatedImages.size()) return;
965            for (int i = 0; i < count; ++i) {
966                View v = layout.getChildAt(i);
967                ((PagedViewWidget) v).setHolographicOutline(data.generatedImages.get(i));
968            }
969        }
970    }
971
972    @Override
973    public void syncPages() {
974        removeAllViews();
975
976        // Remove all background asyc tasks if we are loading content anew
977        Iterator<AppsCustomizeAsyncTask> iter = mRunningTasks.iterator();
978        while (iter.hasNext()) {
979            AppsCustomizeAsyncTask task = (AppsCustomizeAsyncTask) iter.next();
980            task.cancel(false);
981            iter.remove();
982        }
983
984        switch (mContentType) {
985        case Applications:
986            syncAppsPages();
987            break;
988        case Widgets:
989            syncWidgetPages();
990            break;
991        }
992    }
993    @Override
994    public void syncPageItems(int page) {
995        switch (mContentType) {
996        case Applications:
997            syncAppsPageItems(page);
998            break;
999        case Widgets:
1000            syncWidgetPageItems(page);
1001            break;
1002        }
1003    }
1004
1005    /**
1006     * Used by the parent to get the content width to set the tab bar to
1007     * @return
1008     */
1009    public int getPageContentWidth() {
1010        return mContentWidth;
1011    }
1012
1013    @Override
1014    protected void onPageBeginMoving() {
1015        /* TO BE ENABLED LATER
1016        setChildrenDrawnWithCacheEnabled(true);
1017        for (int i = 0; i < getChildCount(); ++i) {
1018            View v = getChildAt(i);
1019            if (v instanceof PagedViewCellLayout) {
1020                ((PagedViewCellLayout) v).setChildrenDrawingCacheEnabled(true);
1021            }
1022        }
1023        */
1024        super.onPageBeginMoving();
1025    }
1026
1027    @Override
1028    protected void onPageEndMoving() {
1029        /* TO BE ENABLED LATER
1030        for (int i = 0; i < getChildCount(); ++i) {
1031            View v = getChildAt(i);
1032            if (v instanceof PagedViewCellLayout) {
1033                ((PagedViewCellLayout) v).setChildrenDrawingCacheEnabled(false);
1034            }
1035        }
1036        setChildrenDrawnWithCacheEnabled(false);
1037        */
1038        super.onPageEndMoving();
1039    }
1040
1041    /*
1042     * AllAppsView implementation
1043     */
1044    @Override
1045    public void setup(Launcher launcher, DragController dragController) {
1046        mLauncher = launcher;
1047        mDragController = dragController;
1048    }
1049    @Override
1050    public void zoom(float zoom, boolean animate) {
1051        // TODO-APPS_CUSTOMIZE: Call back to mLauncher.zoomed()
1052    }
1053    @Override
1054    public boolean isVisible() {
1055        return (getVisibility() == VISIBLE);
1056    }
1057    @Override
1058    public boolean isAnimating() {
1059        return false;
1060    }
1061    @Override
1062    public void setApps(ArrayList<ApplicationInfo> list) {
1063        mApps = list;
1064        Collections.sort(mApps, LauncherModel.APP_NAME_COMPARATOR);
1065
1066        // The next layout pass will trigger data-ready if both widgets and apps are set, so
1067        // request a layout to do this test and invalidate the page data when ready.
1068        if (testDataReady()) requestLayout();
1069    }
1070    private void addAppsWithoutInvalidate(ArrayList<ApplicationInfo> list) {
1071        // We add it in place, in alphabetical order
1072        int count = list.size();
1073        for (int i = 0; i < count; ++i) {
1074            ApplicationInfo info = list.get(i);
1075            int index = Collections.binarySearch(mApps, info, LauncherModel.APP_NAME_COMPARATOR);
1076            if (index < 0) {
1077                mApps.add(-(index + 1), info);
1078            }
1079        }
1080    }
1081    @Override
1082    public void addApps(ArrayList<ApplicationInfo> list) {
1083        addAppsWithoutInvalidate(list);
1084        invalidatePageData();
1085    }
1086    private int findAppByComponent(List<ApplicationInfo> list, ApplicationInfo item) {
1087        ComponentName removeComponent = item.intent.getComponent();
1088        int length = list.size();
1089        for (int i = 0; i < length; ++i) {
1090            ApplicationInfo info = list.get(i);
1091            if (info.intent.getComponent().equals(removeComponent)) {
1092                return i;
1093            }
1094        }
1095        return -1;
1096    }
1097    private void removeAppsWithoutInvalidate(ArrayList<ApplicationInfo> list) {
1098        // loop through all the apps and remove apps that have the same component
1099        int length = list.size();
1100        for (int i = 0; i < length; ++i) {
1101            ApplicationInfo info = list.get(i);
1102            int removeIndex = findAppByComponent(mApps, info);
1103            if (removeIndex > -1) {
1104                mApps.remove(removeIndex);
1105            }
1106        }
1107    }
1108    @Override
1109    public void removeApps(ArrayList<ApplicationInfo> list) {
1110        removeAppsWithoutInvalidate(list);
1111        invalidatePageData();
1112    }
1113    @Override
1114    public void updateApps(ArrayList<ApplicationInfo> list) {
1115        // We remove and re-add the updated applications list because it's properties may have
1116        // changed (ie. the title), and this will ensure that the items will be in their proper
1117        // place in the list.
1118        removeAppsWithoutInvalidate(list);
1119        addAppsWithoutInvalidate(list);
1120        invalidatePageData();
1121    }
1122
1123    @Override
1124    public void reset() {
1125        if (mContentType != ContentType.Applications) {
1126            // Reset to the first page of the Apps pane
1127            AppsCustomizeTabHost tabs = (AppsCustomizeTabHost)
1128                    mLauncher.findViewById(R.id.apps_customize_pane);
1129            tabs.setCurrentTabByTag(tabs.getTabTagForContentType(ContentType.Applications));
1130        } else if (getCurrentPage() != 0) {
1131            setCurrentPage(0);
1132            invalidatePageData();
1133        }
1134    }
1135    @Override
1136    public void dumpState() {
1137        // TODO: Dump information related to current list of Applications, Widgets, etc.
1138        ApplicationInfo.dumpApplicationInfoList(LOG_TAG, "mApps", mApps);
1139        dumpAppWidgetProviderInfoList(LOG_TAG, "mWidgets", mWidgets);
1140        dumpAppWidgetProviderInfoList(LOG_TAG, "mShortcuts", mShortcuts);
1141    }
1142    private void dumpAppWidgetProviderInfoList(String tag, String label,
1143            ArrayList<Object> list) {
1144        Log.d(tag, label + " size=" + list.size());
1145        for (Object i: list) {
1146            if (i instanceof AppWidgetProviderInfo) {
1147                AppWidgetProviderInfo info = (AppWidgetProviderInfo) i;
1148                Log.d(tag, "   label=\"" + info.label + "\" previewImage=" + info.previewImage
1149                        + " resizeMode=" + info.resizeMode + " configure=" + info.configure
1150                        + " initialLayout=" + info.initialLayout
1151                        + " minWidth=" + info.minWidth + " minHeight=" + info.minHeight);
1152            } else if (i instanceof ResolveInfo) {
1153                ResolveInfo info = (ResolveInfo) i;
1154                Log.d(tag, "   label=\"" + info.loadLabel(mPackageManager) + "\" icon="
1155                        + info.icon);
1156            }
1157        }
1158    }
1159    @Override
1160    public void surrender() {
1161        // TODO: If we are in the middle of any process (ie. for holographic outlines, etc) we
1162        // should stop this now.
1163    }
1164
1165    /*
1166     * We load an extra page on each side to prevent flashes from scrolling and loading of the
1167     * widget previews in the background with the AsyncTasks.
1168     */
1169    protected int getAssociatedLowerPageBound(int page) {
1170        return Math.max(0, page - 2);
1171    }
1172    protected int getAssociatedUpperPageBound(int page) {
1173        final int count = getChildCount();
1174        return Math.min(page + 2, count - 1);
1175    }
1176
1177    @Override
1178    protected String getCurrentPageDescription() {
1179        int page = (mNextPage != INVALID_PAGE) ? mNextPage : mCurrentPage;
1180        int stringId = R.string.default_scroll_format;
1181        switch (mContentType) {
1182        case Applications:
1183            stringId = R.string.apps_customize_apps_scroll_format;
1184            break;
1185        case Widgets:
1186            stringId = R.string.apps_customize_widgets_scroll_format;
1187            break;
1188        }
1189        return String.format(mContext.getString(stringId), page + 1, getChildCount());
1190    }
1191}
1192