android源代码 a5,《Android5.1源码探究 —— ActivityManager(5)：addAppTask (Activity activity, Intent intent, Ac...

ActivityManager：addAppTask (Activity activity, Intent intent, ActivityManager.TaskDescription description, Bitmap thumbnail)

1.作用

为应用创建一个新的任务，并放在任务栈的栈顶。

参数：activity ：需要被添加的Activity，用于确定进入任务栈的入口

intent ：用于启动Activity的Intent

description：携带的信息描述

thumbnail ：缩略图资源

2.源码

public int addAppTask(@NonNull Activity activity, @NonNull Intent intent,

@Nullable TaskDescription description, @NonNull Bitmap thumbnail) {

Point size;

synchronized (this) {

ensureAppTaskThumbnailSizeLocked();

size = mAppTaskThumbnailSize;

}

final int tw = thumbnail.getWidth();

final int th = thumbnail.getHeight();

if (tw != size.x || th != size.y) {

Bitmap bm = Bitmap.createBitmap(size.x, size.y, thumbnail.getConfig());

float scale;

float dx = 0, dy = 0;

if (tw * size.x > size.y * th) {

scale = (float) size.x / (float) th;

dx = (size.y - tw * scale) * 0.5f;

} else {

scale = (float) size.y / (float) tw;

dy = (size.x - th * scale) * 0.5f;

}

Matrix matrix = new Matrix();

matrix.setScale(scale, scale);

matrix.postTranslate((int) (dx + 0.5f), 0);

Canvas canvas = new Canvas(bm);

canvas.drawBitmap(thumbnail, matrix, null);

canvas.setBitmap(null);

thumbnail = bm;

}

if (description == null) {

description = new TaskDescription();

}

try {

return ActivityManagerNative.getDefault().addAppTask(activity.getActivityToken(),

intent, description, thumbnail);

} catch (RemoteException e) {

throw new IllegalStateException("System dead?", e);

}

}

3.分析及说明

我们首先来看一下ensureAppTaskThumbnailSizeLocked()

private void ensureAppTaskThumbnailSizeLocked() {

if (mAppTaskThumbnailSize == null) {

try {

mAppTaskThumbnailSize = ActivityManagerNative.getDefault().getAppTaskThumbnailSize();

} catch (RemoteException e) {

throw new IllegalStateException("System dead?", e);

}

}

}

而ActivityManagerNative.getDefault().getAppTaskThumbnailSize()返回的是一个Size，该size是确保addAppTask()中的Bitmap参数所需的Size。

其次我们来看一下addAppTask()的返回值，返回新添加的任务id应用任务,如果添加失败则返回-1；

如果创建失败了，那么极大地原因是没有更多的空间为你的应用程任务服务。