一朵翔云的博客

学之广在于不倦,不倦在于固志

Overview Screen-Android 6.0开发者文档

原文地址:Overview Screen

一、前言

主页(overview screen)也叫recent screen、recent task list、recent apps,是一个系统级UI,能够列举最近访问的activity和task。用户可以在这个UI中选择或者移除task。从Android 5.0(API 21)开始,Android支持同一个activity的不同实例在overview screen中显示为多个task。例如,Google Drive可以有一个task显示多个Google documents,而每个document也可以在overview screen中显示为一个task,如图1(个人理解:document是某个activity在overview screen的UI显示,它可以独占一个task单独显示,也可以有多个document显示在同一task中)。

图1

通常,由系统定义你的task跟activity如何显示在overview screen上即可,你不需要改变这些行为。当然,你也可以自定义activity怎样和什么时候显示在overview screen上:使用ActivityManager.AppTask可以管理task,使用intent的flag可以指定什么时候activity加入overview screen或者从overview screen移除(在manifest文件中指定<activity>的属性也可以)。


二、向overview screen添加task

通过intent添加flag可以很好的控制什么时候/怎样在overview screen打开或者重新打开document。通过<activity>添加属性,你可以控制是在新的task打开document还是在已存在的task打开document。

2.1 使用intent的flag添加task

通过ActivityManager.AppTask的startActivity()方法,并传入一个intent(在此intent中通过addFlags()方法添加FLAG_ACTIVITY_NEW_DOCUMENT),可以让系统在overview screen中将你的activity视为一个新的task。

注意:FLAG_ACTIVITY_NEW_DOCUMENT替代了FLAG_ACTIVITY_CLEAR_WHEN_TASK_RESET,后者从Android 5.0(API 21)开始废弃

如果你在新建document时加入了FLAG_ACTIVITY_MULTIPLE_TASK,那么系统会新建一个task,并将目标activity作为根activity。此flag可以让同一个document在多个task中打开。下面是main activity的一些代码:

public void createNewDocument(View view) {
      final Intent newDocumentIntent = newDocumentIntent();
      if (useMultipleTasks) {
          newDocumentIntent.addFlags(Intent.FLAG_ACTIVITY_MULTIPLE_TASK);
      }
      startActivity(newDocumentIntent);
  }
  private Intent newDocumentIntent() {
      boolean useMultipleTasks = mCheckbox.isChecked();
      final Intent newDocumentIntent = new Intent(this, NewDocumentActivity.class);
      newDocumentIntent.addFlags(Intent.FLAG_ACTIVITY_NEW_DOCUMENT);
      newDocumentIntent.putExtra(KEY_EXTRA_NEW_DOCUMENT_COUNTER, incrementAndGet());
      return newDocumentIntent;
  }
  private static int incrementAndGet() {
      Log.d(TAG, "incrementAndGet(): " + mDocumentCounter);
      return mDocumentCounter++;
  }
}

注意:使用FLAG_ACTIVITY_NEW_DOCUMENT的前提是,目标activity在manifest中指定的launchMode为standard(android:launchMode=”standard”)

在上面的示例中,当main activity启动新activity时,系统会在已存在的task中寻找符合intent指定的组件名称(component name)和intent数据的activity。如果没有找到这样的task,或者intent中包含FLAG_ACTIVITY_MULTIPLE_TASK,那么系统会新建一个task并将目标activity作为此task根activity;如果找到了这样的task,那么系统会将此task放到前台,并将新的intent传递给目标activity的onNewIntent()方法。新的activity得到此intent后会在overview screen中新建一个document,代码如下:

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_new_document);
    mDocumentCount = getIntent()
            .getIntExtra(DocumentCentricActivity.KEY_EXTRA_NEW_DOCUMENT_COUNTER, 0);
    mDocumentCounterTextView = (TextView) findViewById(
            R.id.hello_new_document_text_view);
    setDocumentCounterText(R.string.hello_new_document_counter);
}
@Override
protected void onNewIntent(Intent intent) {
    super.onNewIntent(intent);
    /* If FLAG_ACTIVITY_MULTIPLE_TASK has not been used, this activity
    is reused to create a new document.
     */
    setDocumentCounterText(R.string.reusing_document_counter);
}

2.2 使用activity属性添加task

activity可以在manifest文件的<activity>标签下添加属性:android:documentLaunchMode,以控制activity的document。这个属性有四个值:

  • intoExisting

    activity会重用存在的task放置document。相当于添加了FLAG_ACTIVITY_NEW_DOCUMENT,且没有添加FLAG_ACTIVITY_MULTIPLE_TASK
  • always

    activity为document新建一个task,即使这个document已经打开了。相当于添加了FLAG_ACTIVITY_NEW_DOCUMENT和FLAG_ACTIVITY_MULTIPLE_TASK
  • none

    activity不会为document新建task。overview screen会将此activity视为默认状态:为此应用显示单独的task,该任务将从用户上次调用的任意Activity开始继续执行
  • never

    activity不会为document新建task。这个值对应的逻辑重写了FLAG_ACTIVITY_NEW_DOCUMENT与FLAG_ACTIVITY_MULTIPLE_TASK,如果intent中有这两个flag(或之一),那么overview screen会为此应用显示单独的task,该任务将从用户上次调用的任意Activity开始继续执行

注意:“intoExisting”与“always”要求activity的launchMode必须为standard。如果documentLaunchMode未指定,会默认使用“none”


三、移除task

默认情况下,document对应的activity结束时,会自动从overview screen移除。你可以通过在ActivityManager.AppTask类添加intent的flag或使用<activity>属性修改默认行为。

<activity>的android:excludeFromRecents属性设置为true,可以随时将task从overview screen完全移除。

设置<activity>的android:maxRecents可以限制你的应用能在overview screen显示的task的最大数量。默认为16。当task数量达到最大数量时,最早使用的task将会从overview screen移除。android:maxRecents可以设置的最大值为50(小内存设备中是25);小于1的值无效。

3.1 使用AppTask移除task

在新建task的activity中,你可以通过finishAndRemoveTask()方法,移除task和task中所有的activity。

public void onRemoveFromRecents(View view) {
    // The document is no longer needed; remove its task.
    finishAndRemoveTask();
}

注意:finishAndRemoveTask()方法重写了FLAG_ACTIVITY_RETAIN_IN_RECENTS(此flag在后面会讲到)

3.2 保存已结束的task

如果你想要在activity被结束后仍然将task保持在overview screen,可以在启动此activity的intent中通过addFlags()添加FLAG_ACTIVITY_RETAIN_IN_RECENTS。

private Intent newDocumentIntent() {
    final Intent newDocumentIntent = new Intent(this, NewDocumentActivity.class);
    newDocumentIntent.addFlags(Intent.FLAG_ACTIVITY_NEW_DOCUMENT |
      android.content.Intent.FLAG_ACTIVITY_RETAIN_IN_RECENTS);
    newDocumentIntent.putExtra(KEY_EXTRA_NEW_DOCUMENT_COUNTER, incrementAndGet());
    return newDocumentIntent;
}

<activity>的android:autoRemoveFromRecents属性设置为false可以达到同样的效果(document activity的默认值为true,regular activity的默认值为false)。这个属性会重写FLAG_ACTIVITY_RETAIN_IN_RECENTS。

阅读更多
文章标签: overview screen
个人分类: Android开发者文档
想对作者说点什么? 我来说一句

java开发者必备api文档

2018年03月17日 99.9MB 下载

微信公众平台开发者文档

2014年02月23日 1.05MB 下载

没有更多推荐了,返回首页

不良信息举报

Overview Screen-Android 6.0开发者文档

最多只允许输入30个字

加入CSDN,享受更精准的内容推荐,与500万程序员共同成长!
关闭
关闭