图解Activity启动模式、flag及其他启动属性-参考官方文档

迷南。 2022-05-12 03:50 224阅读 0赞

### **launchMode：** ###

**1.standard**

如果启动该Activity的context是Activity，则新建一个Activity实例，该target Activity在source Activity的Task中。如果启动改Activity的context不是Activity，则新建一个Activity实例，并创建一个新的TaskRecord。

**2.singleTop**

如果启动该Activity的是Activity，那么看target Activity所在的Task的Top Activity是否与targetActivity同一类型，如果是同一类型，则调用Top Activity的onNewIntent（Intent），如果是不同类型，则创建一个target Activity实例放到Task顶部，并调用器onCreate（）方法。这个模式下，Activity实例不是进程唯一，也不是Task唯一，而是指定Task的Top Activity类型唯一。当然Top Activity如果是pause状态，则在调用onNewIntent（）前，将会调用onResume（）；

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2IxNDgwNTIxODc0_size_16_color_FFFFFF_t_70][]

**3.singleTask**

在进程中只有一个实例。如果启动该Activity的是Activity，且两个Activity是同一应用，且target Activity没有声明taskAffinity属性，则target Activity与sourceActivity在同一task。sourceActivity 所在Task没有Target Activity类型的实例，则创建一个。source Activity所在Task存在一个target Activity类型的实例，则弹出其上的Activity，如下图：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2IxNDgwNTIxODc0_size_16_color_FFFFFF_t_70 1][]

如果ActivityB和Activity A不是在同一个应用定义的，那么ActivityB将在新的Task中。如果Activity B和Activity A是同一应用的，但是ActivityB声明了taskAffinity，那么ActivityB将在声明的task中，如果声明的task已存在，那么就去到那个task，如果不存在，则创建一个。如下图：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2IxNDgwNTIxODc0_size_16_color_FFFFFF_t_70 2][]

**4.singleInstance**

同singleTask类似，在进程中只有一个实例，但singleInstance更严格，即singleInstance=true的Activity，只能自己单独在一个Task。如果启动该Activity的是Activity，则会新创建一个TaskRecord给这个singleInstance实例，如果这个singleInstance需要启动另一个Activity，则会创建一个TaskRecord给这个Activity。如下图：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2IxNDgwNTIxODc0_size_16_color_FFFFFF_t_70 3][]

虽然singleInstance是会在一个独立的Task中，如果source Activity和target Activity属于同一进程的话，这个singleInstance和source Activity只能有一个在recents overview中出现，那么进入的source Activity可以用户从launcher那里进入，但用户可能找不到singleInstance的入口，除非在你的应用中提供一个入口。除以上说明的，其余的和singleTask是一样的。

### **flags：** ###

**1.FLAG\_ACTIVITY\_NEW\_TASK**

如果启动Activity的context是Activity，那么这个flag单独使用时，只对启动别的应用的Activity时有用。否则，如果sourceActivity和Target Activity是属于同一个apk的，需要结合android：taskAffinity属性使用（taskAffinity的值需要以a.b的形式）。

该Activity实例不存在时，则在指定的Task中创建一个。如果已存在，则将该实例所在Task调到前台，即显示该Task的Top Activity，注意，该Top Activity不一定是targetActivity，而且只会调用Top Activity的onResume（），而不会调用任何实例的onNewIntent（）。当然在某些时候需要结合taskAffinity属性才能生效。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2IxNDgwNTIxODc0_size_16_color_FFFFFF_t_70 4][]

上图的状态2只适用于ActivityA和ActivityB属于同一应用。如果AcivityB和ActivityC跟ActivityA不是同一个进程的话，状态2则如下图所示：

![20181203180240710.png][]

如果AcivityB和ActivityC跟ActivityA不是同一个进程，但是想要上上图的效果，则需要Activity B声明如下，且在启动ActivityB是intent加上Activity B声明的action和category，同时带上FLAG\_ACTIVITY\_NEW\_TASK

<intent-filter>
                    <action android:name="android.intent.action.MAIN" />
                    <category android:name="android.intent.category.LAUNCHER" />
                </intent-filter>

所以该flag和singleTask还是有很大区别的。singleTask是 FLAG\_ACTIVITY\_SINGLE\_TOP +FLAG\_ACTIVITY\_NEW\_TASK + FLAG\_ACTIVITY\_CLEAR\_TOP的三者结合。

关于Context\#startActivity(Intent,Bundle)注释说的，非Activity的Context，启动Activity都需要加上FLAG\_ACTIVITY\_NEW\_TASK，因为不是从Activity启动的Activity，没有Task，但是实际运行7.0上不加该flag也是可以的。如果receiver是在ActivityA中注册的，那就该receiver启动的Activity就放到ActivityA所在的task。

**2.FLAG\_ACTIVITY\_SINGLE\_TOP**

同launchMdoe中的singleTop

**3.FLAG\_ACTIVITY\_CLEAR\_TOP**

如果是单独使用，且target Activity的launchMode是mutiple（默认的），则如下图：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2IxNDgwNTIxODc0_size_16_color_FFFFFF_t_70 5][]

如果是ActivityB的launchMode为其他值，又或者flag包含了FLAG\_ACTIVITY\_SINGLE\_TOP，那么代替recreate一个实例的是，会去传递intent给onNewIntent（）方法，如果这个实例之前是处于paused状态的，调用onNewIntent前会去调用onResume。

和FLAG\_ACTIVITY\_NEW\_TASK结合使用，如果该实例已存在，那么会将实例所在的task带到前台，并实例本身及其上的activity实例，即recreate，而不是调用onNewIntent。

### **其他属性：** ###

**1.allowTaskReparenting**

如果一个Activity B设置这个属性为true，且声明了taskAffinity="a.b"。此时别的应用从Launcher启动了（Activity A必须声明了android.intent.action.MAIN和android.intent.category.LAUNCHER），启动的这个ActivityB也声明了taskAffinity="a.b",注意这两个Activity必须是不同应用的。那么ActivityA启动后，Activity将从原来的task转移到Activity A所在的Task。只有create Activity A的时Activity B才可以转移。在Activity A非create，只是resume时是不可以转移的如下图：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2IxNDgwNTIxODc0_size_16_color_FFFFFF_t_70 6][]

官方文档举例的用途如下： 例如，如果电子邮件包含网页链接，则点击链接会调出可显示网页的 Activity。 该 Activity 由浏览器应用定义，但作为电子邮件任务的一部分启动。 如果将其父项更改为浏览器任务，它会在浏览器下一次转至前台时显示，当电子邮件任务再次转至前台时则会消失。

**2.clearTaskOnLaunch**

这个属性只对声明了android.intent.action.MAIN和android.intent.category.LAUNCHER的Activity有效。从Launcher启动时，将清除root Activity之上的所有Activity实例，如下图：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2IxNDgwNTIxODc0_size_16_color_FFFFFF_t_70 7][]

如果ActivityB的taskAffinity有值，且allowTaskReparenting="true",那么Activity B会被移到另外一个Task中，ActivityC依然调用onResume，但是在overviews中没有ActivityB的入口。文档是这样描述的：“如果该属性和allowTaskReparenting的值均为“`true`”，则如上所述，任何可以更改父项的 Activity 都将转移到与其有亲和关系的任务；其余 Activity 随即被移除。”

**3.finishOnTaskLaunch**

每当用户再次启动其任务（在主屏幕上选择任务）时，是否应关闭（完成）现有 Activity 实例 —“`true`”表示应关闭，“`false`”表示不应关闭。 默认值为“`false`”。

如果该属性和allowTaskReparenting均为“`true`”，则优先使用该属性。 Activity 的亲和关系会被忽略。 系统不是更改 Activity 的父项，而是将其销毁。

注意：该属性对*非root Activity*有效，即对声明android.intent.action.MAIN和android.intent.category.LAUNCHER的Activity无效。

示意图：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2IxNDgwNTIxODc0_size_16_color_FFFFFF_t_70 8][]

**4.allowRemainTaskState**

系统是否始终保持 Activity 所在任务的状态 —“`true`”表示保持，“`false`”表示允许系统在特定情况下将任务重置到其初始状态。 默认值为“`false`”。该属性只对任务的根 Activity 有意义；对于所有其他 Activity，均忽略该属性。

正常情况下，当用户从主屏幕重新选择某个任务时，系统会在特定情况下清除该任务（从根 Activity 之上的堆栈中移除所有 Activity）。 系统通常会在用户一段时间（如 30 分钟）内未访问任务时执行此操作。

不过，如果该属性的值是“`true`”，则无论用户如何到达任务，将始终返回到最后状态的任务。 例如，在网络浏览器这类存在大量用户不愿失去的状态（如多个打开的标签）的应用中，该属性会很有用。

### **flag launch conjunction** ###

**1.从Launcher点击应用使用的启动方式：**

如果该在桌面的快捷图标对应的是一个应用，那么启动的Activity是该应用的manifest中声明了android.intent.action.MAIN和android.intent.category.LAUNCHER的Activity，启动的intent包含android.intent.action.MAIN和android.intent.category.LAUNCHER，还必须包含FLAG\_ACTIVITY\_NEW\_TASK，否则该Activity就会在Launcher的Task中。使用Launcher的这种方式，可以把对应Activity所在的Task带到前台，显示Task中的Top Activity。如果不加上android.intent.action.MAIN和android.intent.category.LAUNCHER，则会在对应Task的顶部create一个Activity。如果只加android.intent.action.MAIN和android.intent.category.LAUNCHER而不加上FLAG\_ACTIVITY\_NEW\_TASK，则target Activity会在source Activity所在Task中。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2IxNDgwNTIxODc0_size_16_color_FFFFFF_t_70 9][]

**2.在声明了android.intent.action.MAIN和android.intent.category.LAUNCHER，且使用了singleTask**

Launcher在启动这个Activity时，就完全按照singleTask前面所说的方式了。Android系统自带的设置应用，就是这种情况，所以每次从Launcher进入Settings，都是去到主界面，而不会回到之前的Top Activity。只能从overview中才能去到Top，因为RecentsActivity和Launcher的启动方式不一样，估计使用的是FLAG\_ACTIVITY\_NEW\_TASK和FLAG\_ACTVITY\_SINGLE\_TOP，而且启动的Activity不是声明了MAIN和LAUNCHER的那个，而是启动Top Activity。

**3.注意setFlags和addFlags的区别**

setFlags会把之前的覆盖了，而addFlags是追加。

官方文档：

[https://developer.android.google.cn/guide/components/activities/tasks-and-back-stack\#TaskLaunchModes][https_developer.android.google.cn_guide_components_activities_tasks-and-back-stack_TaskLaunchModes]

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2IxNDgwNTIxODc0_size_16_color_FFFFFF_t_70]: /images/20220512/c36538571d5f4eaeb2c66b86dcb4f54f.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2IxNDgwNTIxODc0_size_16_color_FFFFFF_t_70 1]: /images/20220512/2545c2e23a7a47e09f664277b5268049.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2IxNDgwNTIxODc0_size_16_color_FFFFFF_t_70 2]: /images/20220512/0f6bd3ec287148089377a1675761d1f1.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2IxNDgwNTIxODc0_size_16_color_FFFFFF_t_70 3]: /images/20220512/d20ce75676b14a00a14b6b0a32d1a728.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2IxNDgwNTIxODc0_size_16_color_FFFFFF_t_70 4]: /images/20220512/50ebd076106a4cd9a2a14b8ea7730276.png
[20181203180240710.png]: /images/20220512/6b2210f7d409404388d97c8c48780d65.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2IxNDgwNTIxODc0_size_16_color_FFFFFF_t_70 5]: /images/20220512/e24a50dc827d4cbe8e26fa706f0b283f.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2IxNDgwNTIxODc0_size_16_color_FFFFFF_t_70 6]: /images/20220512/31b6ccfedd1544b392d289baa70c0451.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2IxNDgwNTIxODc0_size_16_color_FFFFFF_t_70 7]: /images/20220512/c04b6edaf52f4a168de8e049d95e58d7.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2IxNDgwNTIxODc0_size_16_color_FFFFFF_t_70 8]: /images/20220512/3b1857c2a8c44209a73970f010a1b9c9.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2IxNDgwNTIxODc0_size_16_color_FFFFFF_t_70 9]: /images/20220512/7775ea7661084f2980df4f315ff90695.png
[https_developer.android.google.cn_guide_components_activities_tasks-and-back-stack_TaskLaunchModes]: https://developer.android.google.cn/guide/components/activities/tasks-and-back-stack#TaskLaunchModes