LaunchMode & Intent Flag & TaskAffinity
LaunchMode
launchMode分为四种:
standard启动模式为最基本的启动模式,默认为该种启动模式,特点就是每当发送一个intent请求打开该activity时,都会创建一个新的activity实例。实际使用情况分为两种,一种是本应用打开,一种是跨应用打开:
本应用打开,新创建的activity实例放入本应用,即发送intent的task栈的顶部,这个比较简单
跨引用打开,这里有一个需要注意的地方是跨应用打开的时候会在 Recent app 页面显示两个独立项,但是此时它们两个 Activity 仍然是在一个栈中,非常感谢@梦想编制楠灬 的指正,跨应用打开在 Standard 模式下也是在一个栈中,虽然在 Recent app 页面是两个页面:
但是问题来了,又一次我偶然发现使用浏览器打开手机上的bilibili则是在同一个 Recent App 项中:
使用命令adb shell dumpsys activity获取手机的的activity栈的详细信息
如上图所示,com.htc.sense.browser/.BrowserActivity和tv.danmaku.bili/.ui.video.VideoDetailsActivity在同一个 recent app 页面中,这是怎么回事了,最后我发现有一个intent的flag变量有该作用:FLAG_ACTIVITY_RESET_TASK_IF_NEEDED,只要将该flag设置进intent中就会将跨应用的activity打开在同一个 Recent app 中,感兴趣的可以试一下。
singleTop其实和standard几乎一样,和standard算一组,使用singleTop的Activity也可以创建很多个实例。唯一不同的就是,如果调用的目标Activity已经位于调用者的Task的栈顶,则不创建新实例,而是使用当前的这个Activity实例,并调用这个实例的onNewIntent方法。
这个使用场景比较少,可以使用的例子比如用户已经在当前activity,用户点击一条推送消息之后也需要跳转到当前activity,那么为了避免activity的重复打开,则需要将该activity设置为singleTop并且复写onNewIntent即可。
如果是外部程序启动singleTop的Activity,表现都和standard一样。
使用singleTask启动模式的Activity 在系统中 只会存在一个实例。如果这个实例已经存在,intent就会通过onNewIntent传递到这个Activity,并且将栈中该activity之上的activity清除(销毁过程会调用Activity生命周期回调),如果不存在新的Activity实例将被创建。
实际使用情况也分为两组:
本应用启动,在一个应用中启动设置为singleTask的activity,如果该activity在task栈中不存在,则会创建一个新的实例放在栈顶,如果在activity的task栈中已经存在了该activity实例,则会将栈中该activity实例之上的其他activity实例清空,并且会调用该activity的onNewIntent方法。最常用的使用例子就是首页,比如首页上面已经有了很多的activity,回到首页就可以使用这种方式,然后复写首页的onNewIntent方法。使用提示:onNewIntent方法中不能进行fragment的相关操作http://blog.sina.com.cn/s/blog_5da93c8f0101rgb2.html
跨应用启动,由于整个系统只能存在activity的一个实例,所以如果系统中不存在该activity,则会启动一个新的task去启动该activity,并且将该activity放入栈底。如果系统中存在该activity实例,则会直接启动该activity,调用该activity的onNewIntent的方法,同时将该activity task栈上面的其他activity清空(销毁过程会调用Activity生命周期回调),此时如果用户摁下返回键,那么将在singleTask activity的task栈中操作,即返回该栈中singleTask activity的上一个activity直到该栈中无activity时才会返回到最开始启动singleTask activity的activity中。还有一种情况是singleTask Activity所在的应用进程存在,但是singleTask Activity实例不存在,那么从别的应用启动这个Activity,新的Activity实例会被创建,并放入到所属进程所在的Task中,并位于栈顶位置。
注意如果使用了singleTask,FLAG_ACTIVITY_RESET_TASK_IF_NEEDED这个flag将会失效。
需要特别注意的是:
1.在4.x和之前的系统下,A1(startActivityForResult)->A2(singleTask, startActivityForResult)->A3->A4,当A1打开A2之后会立即回调onActivityResult()函数,A2打开A3仍然可以正常回调onActivityResult();但是从5.0开始,A1打开A2的时候 onActivityResult() 函数也能正常的回调,不会立即回调。
2.在4.x和之前的系统下,A1(startActivityForResult)->A2(singleTask, startActivityForResult)->A3,生命周期的流程是
(注:onCreate和onDestroy这两个生命周期没有变化,所以没有加进去,还有一个是A1.onStop生命周期在A2.onResume之后这个是不一定的,视情况而定),上面的变化必须要是startActivityForResult()+5.0之前的系统才会出现,可以推测是由于onActivityResult()函数引起的这个问题。
和singleTask类似,在系统中 只会存在一个实例,唯一的区别就是系统不会在singleInstance activity的task栈中启动任何其他的activity,singleInstance activity栈中仅仅只能有该activity的实例,其他任何从这个activity启动的activity都会在其他的栈中被打开。
虽然使用adb shell dumpsys activity可以看到singleInstance activity在一个独立的task中,但是在任务管理器中,还是显示的一个
需要特别注意的是:
1.A1->A2(SingleInstance),摁下 Home 键之后,点击应用图标再次进入应用,返回的是 A1 页面,这是因为 A2 在另一个单独的 Activity task 栈中,点击图标返回的是主 Activity 栈,所以此时显示的 A1 页面,而不是 A2 页面。
2.注意singleInstance的返回键的处理和上面3个 mode 有区别,如果是使用正常的 startActivity 进行的启动,启动顺序A1->A2->A3(singleInstance)->A4,在A4页面摁下back键,返回的是A2,再返回A1,接着再次摁下back键,返回的才是A3;如果是使用 startActivityForResult 启动的,在4.x和之前的系统下,表现和之前是一样的,但是在5.0开始,A1->A2-A3(singleInstance + startActivityForResult)->A4,在A4摁下返回键,返回的是A3->A2->A1,这个需要着重说明一下。
3.另一个比较重要的是,在4.x和之前的系统下,A1(startActivityForResult)->A2(singleInstance, startActivityForResult)->A3->A4,当A1打开A2之后会立即回调onActivityResult()函数,A2打开A3也会立即回调onActivityResult()函数;但是从5.0开始,A1打开A2和A2打开A3的两种情况下 onActivityResult() 函数都能正常的回调,不会立即回调。
4.还有一个比较重要的是,在4.x和之前的系统下,A1(startActivityForResult)->A2(singleInstance, startActivityForResult)->A3,生命周期的流程是
和singleTask一样,也是必须要是startActivityForResult()+5.0之前的系统才会出现,区别就只是A2打开A3的情况不同。
Intent的flag有很多,介绍一下吧
FLAG_ACTIVITY_BROUGHT_TO_FRONT
比方说我现在有A,在A中启动B,在A中Intent中加上这个标记。此时B就是以FLAG_ACTIVITY_BROUGHT_TO_FRONT 这个启动的,在B中再启动C,D(正常启动C,D),如果这个时候在D中再启动B,这个时候最后的栈的情况是 A,C,D,B.。
如果在调用startActivity时传递这个标记,该task栈中的其他activity会先被清空,然后该activity在该task中启动,也就是说,这个新启动的activity变为了这个空task的根activity。所有老的activity都结束掉。该标志必须和FLAG_ACTIVITY_NEW_TASK一起使用。
如果该activity已经在task中存在,并且设置了该task,系统不会启动新的 Activity 实例,会将task栈里该Activity之上的所有Activity一律结束掉,然后将Intent发给这个已存在的Activity。Activity收到 Intent之后,或者在onNewIntent()里做下一步的处理,或者自行结束然后重新创建自己。如果 Activity 在 AndroidMainifest.xml 里将启动模式设置成默认standard模式,并且 Intent 里也没有设置 FLAG_ACTIVITY_SINGLE_TOP,那么他将会结束并且重启;否则则会传递到onNewIntent方法,FLAG_ACTIVITY_CLEAR_TOP 还可以和 FLAG_ACTIVITY_NEW_TASK 配合使用,用来启动一个task栈的根activity,他将会把该栈清空为根状态,比如从notification manager启动activity。
FLAG_ACTIVITY_CLEAR_WHEN_TASK_RESET
已经废弃,请使用FLAG_ACTIVITY_NEW_DOCUMENT
FLAG_ACTIVITY_EXCLUDE_FROM_RECENTS
设置完之后,新的activity将不会添加到当前activity列表中,当某些情况下我们不希望用户通过历史列表回到我们的Activity的时候这个标记比较有用。他等同于在XML中指定Activity的属性android:excludeFromRecents=”true”。
如果设置,并且这个Intent用于从一个存在的Activity启动一个新的Activity,那么,这个作为答复目标的Activity将会传到这个新的Activity中。这种方式下,新的Activity可以调用setResult(int),并且这个结果值将发送给那个作为答复目标的Activity。
FLAG_ACTIVITY_LAUNCHED_FROM_HISTORY
一般由系统调用,比如长摁home键从历史记录中启动。
这个标识用来创建一个新的task栈,并且在里面启动新的activity(所有情况,不管系统中存在不存在该activity实例),经常和FLAG_ACTIVITY_NEW_DOCUMENT或者FLAG_ACTIVITY_NEW_TASK一起使用。这上面两种使用场景下,如果没有带上FLAG_ACTIVITY_MULTIPLE_TASK标识,他们都会使系统搜索存在的task栈,去寻找匹配intent的一个activity,如果没有找到就会去新建一个task栈;但是当和FLAG_ACTIVITY_MULTIPLE_TASK一起使用的时候,这两种场景都会跳过搜索这步操作无条件的创建一个新的task。和FLAG_ACTIVITY_NEW_TASK一起使用需要注意,尽量不要使用该组合除非你完成了自己的顶部应用启动器,他们的组合使用会禁用已经存在的task栈回到前台的功能。
api 21之后加入的一个标识,用来在intent启动的activity的task栈中打开一个document,和documentLaunchMode效果相等,有着不同的documents的activity的多个实例,将会出现在最近的task列表中。单独使用效果和documentLaunchMode=”intoExisting”一样,如果和FLAG_ACTIVITY_MULTIPLE_TASK一起使用效果就等同于documentLaunchMode=”always”。
设置此状态,记住以下原则,首先会查找是否存在和被启动的Activity具有相同的亲和性的任务栈(即taskAffinity,注意同一个应用程序中的activity的亲和性在没有修改的情况下是一样的,所以下面的a情况会在同一个栈中),如果有,刚直接把这个栈整体移动到前台,并保持栈中的状态不变,即栈中的activity顺序不变,如果没有,则新建一个栈来存放被启动的activity。
a. 前提: Activity A和Activity B在同一个应用中。
操作: Activity A启动开僻Task堆栈(堆栈状态:A),在Activity A中启动Activity B, 启动Activity B的Intent的Flag设为FLAG_ACTIVITY_NEW_TASK,Activity B被压入Activity A所在堆栈(堆栈状态:AB)。
原因: 默认情况下同一个应用中的所有Activity拥有相同的关系(taskAffinity)。
b. 前提: Activity A在名称为”TaskOne应用”的应用中, Activity C和Activity D在名称为”TaskTwo应用”的应用中。
操作1:在Launcher中单击“TaskOne应用”图标,Activity A启动开僻Task堆栈,命名为TaskA(TaskA堆栈状态: A),在Activity A中启动Activity C, 启动Activity C的Intent的Flag设为FLAG_ACTIVITY_NEW_TASK,Android系统会为Activity C开僻一个新的Task,命名为TaskB(TaskB堆栈状态: C), 长按Home键,选择TaskA,Activity A回到前台, 再次启动Activity C(两种情况:1.从桌面启动;2.从Activity A启动,两种情况一样), 这时TaskB回到前台, Activity C显示,供用户使用, 即:包含FLAG_ACTIVITY_NEW_TASK的Intent启动Activity的Task正在运行,则不会为该Activity创建新的Task,而是将原有的Task返回到前台显示。
操作2:在Launcher中单击”TaskOne应用”图标,Activity A启动开僻Task堆栈,命名为TaskA(TaskA堆栈状态: A),在Activity A中启动Activity C,启动Activity C的Intent的Flag设为FLAG_ACTIVITY_NEW_TASK,Android系统会为Activity C开僻一个新的Task,命名为TaskB(TaskB堆栈状态: C), 在Activity C中启动Activity D(TaskB的状态: CD) 长按Home键, 选择TaskA,Activity A回到前台, 再次启动Activity C(从桌面或者ActivityA启动,也是一样的),这时TaskB回到前台, Activity D显示,供用户使用。说明了在此种情况下设置FLAG_ACTIVITY_NEW_TASK后,会先查找是不是有Activity C存在的栈,根据亲和性(taskAffinity),如果有,刚直接把这个栈整体移动到前台,并保持栈中的状态不变,即栈中的顺序不变。
禁止activity之间的切换动画
该Activity将不在stack中保留,用户一离开它,这个Activity就关闭了。
禁止activity调用onUserLeaveHint()函。onUserLeaveHint()作为activity周期的一部分,它在activity因为用户要跳转到别的activity而退到background时使用。比如,在用户按下Home键(用户的操作),它将被调用。比如有电话进来(不属于用户的操作),它就不会被调用。注意:通过调用finish()时该activity销毁时不会调用该函数。
如果给Intent对象设置了这个标记,这个Intent对象被用于从一个存在的Activity中启动一个新的Activity,那么新的这个Activity不能用于接受发送给顶层activity的intent,这个新的activity的前一个activity被作为顶部activity。
FLAG_ACTIVITY_REORDER_TO_FRONT
如果在Intent中设置,并传递给Context.startActivity(),这个标志将引发已经运行的Activity移动到历史stack的顶端。 例如,假设一个Task由四个Activity组成:A,B,C,D。如果D调用startActivity()来启动Activity B,那么,B会移动到历史stack的顶端,现在的次序变成A,C,D,B。如果FLAG_ACTIVITY_CLEAR_TOP标志也设置的话,那么这个标志将被覆盖。
FLAG_ACTIVITY_RESET_TASK_IF_NEEDED
这个标记在以下情况下会生效:1.启动Activity时创建新的task来放置Activity实例;2.已存在的task被放置于前台。系统会根据affinity对指定的task进行重置操作,task会压入某些Activity实例或移除某些Activity实例。我们结合上面的FLAG_ACTIVITY_CLEAR_WHEN_TASK_RESET可以加深理解。
FLAG_ACTIVITY_RETAIN_IN_RECENTS
api21加入。
默认情况下通过FLAG_ACTIVITY_NEW_DOCUMENT启动的activity在关闭之后,task中的记录会相对应的删除。如果为了能够重新启动这个activity你想保留它,就可以使用者个flag,最近的记录将会保留在接口中以便用户去重新启动。接受该flag的activity可以使用autoRemoveFromRecents去复写这个request或者调用Activity.finishAndRemoveTask()方法。
singleTop一样
api11加入。
把当前新启动的任务置于Home任务之上,也就是按back键从这个任务返回的时候会回到home,即使这个不是他们最后看见的activity,注意这个标记必须和FLAG_ACTIVITY_NEW_TASK一起使用。
将log置为可用状态,如果设置了这个flag,那么在处理这个intent的时候,将会打印相关创建日志。
FLAG_EXCLUDE_STOPPED_PACKAGES和FLAG_INCLUDE_STOPPED_PACKAGES
在3.1之后,系统的package manager增加了对处于“stopped state”应用的管理,这个stopped和Activity生命周期中的stop状态是完全两码事,指的是安装后从来没有启动过和被用户手动强制停止的应用,与此同时系统增加了2个Flag:FLAG_INCLUDE_STOPPED_PACKAGES和FLAG_EXCLUDE_STOPPED_PACKAGES ,来标识一个intent是否激活处于“stopped state”的应用。当2个Flag都不设置或者都进行设置的时候,采用的是FLAG_INCLUDE_STOPPED_PACKAGES的效果。
用来标识该intent的操作是一个后端的操作而不是一个直接的用户交互。
FLAG_GRANT_PERSISTABLE_URI_PERMISSION
api19添加
当和FLAG_GRANT_READ_URI_PERMISSION 和/或FLAG_GRANT_WRITE_URI_PERMISSION一起使用时,uri权限在设置重启之后依然存在直到用户调用了revokeUriPermission(Uri, int)方法,这个标识仅为可能的存在状态提供许可,接受的应用必须要调用takePersistableUriPermission(Uri, int)方法去实际的变为存在状态。
FLAG_GRANT_PREFIX_URI_PERMISSION
api21加入。
当和FLAG_GRANT_READ_URI_PERMISSION 和/或FLAG_GRANT_WRITE_URI_PERMISSION一起使用时,uri的许可只用匹配前缀即可(默认为全部匹配)。
FLAG_GRANT_READ_URI_PERMISSION和FLAG_GRANT_WRITE_URI_PERMISSION
如果设置FLAG_GRANT_READ_URI_PERMISSION这个标记,Intent的接受者将会被赋予读取Intent中URI数据的权限和lipData中的URIs的权限。当使用于Intent的ClipData时,所有的URIs和data的所有递归遍历或者其他Intent的ClipData数据都会被授权。FLAG_GRANT_WRITE_URI_PERMISSION同FLAG_GRANT_READ_URI_PERMISSION只是相应的赋予的是写权限。
一个典型的例子就是邮件程序处理带有附件的邮件。进入邮件需要使用permission来保护,因为这些是敏感的用户数据。然而,如果有一个指向图片附件的URI需要传递给图片浏览器,那个图片浏览器是不会有访问附件的权利的,因为他不可能拥有所有的邮件的访问权限。针对这个问题的解决方案就是per-URI permission:当启动一个activity或者给一个activity返回结果的时候,呼叫方可以设置Intent.FLAG_GRANT_READ_URI_PERMISSION和/或Intent.FLAG_GRANT_WRITE_URI_PERMISSION . 这会使接收该intent的activity获取到进入该Intent指定的URI的权限,而不论它是否有权限进入该intent对应的content provider。
api16添加。
当发送广播时,允许其接受者拥有前台的优先级,更短的超时间隔。
api19添加
如果这是一个有序广播,不允许接受者终止这个广播,它仍然能够传递给下面的接受者。
如果设置了这个flag,当发送广播的时,动态注册的接受者才会被调用,在Androidmanifest.xml 里定义的Receiver 是接收不到这样的Intent 的。
api8添加。
如果设置了的话,ActivityManagerService就会在当前的系统中查看有没有相同的intent还未被处理,如果有的话,就由当前这个新的intent来替换旧的intent,所以就会出现在发送一系列的这样的Intent 之后,中间有些Intent 有可能在你还没有来得及处理的时候, 就被替代掉了的情况
每个Activity都有taskAffinity属性,这个属性指出了它希望进入的Task。如果一个Activity没有显式的指明该 Activity的taskAffinity,那么它的这个属性就等于Application指明的taskAffinity,如果 Application也没有指明,那么该taskAffinity的值就等于包名。而Task也有自己的affinity属性,它的值等于它的根 Activity的taskAffinity的值。
TaskAffinity属性主要和SingleTask启动模式或者allowTaskReparenting属性配对使用,在其他情况下没有意义。当TaskAffinity和singleTask启动模式配对使用的时候,他是具有该模式的Activity的目前任务栈的名字,待启动的Activity会运行在名字和TaskAffinity相同的任务栈中。allowTaskReparenting用于配置是否允许该activity可以更换从属task,通常情况二者连在一起使用,用于实现把一个应用程序的Activity移到另一个应用程序的Task中。allowTaskReparenting用来标记Activity能否从启动的Task移动到taskAffinity指定的Task,默认是继承至application中的allowTaskReparenting=false,如果为true,则表示可以更换;false表示不可以。
如果加载某个Activity的intent,Flag被设置成FLAG_ACTIVITY_NEW_TASK时,它会首先检查是否存在与自己taskAffinity相同的Task,如果存在,那么它会直接宿主到该Task中,如果不存在则重新创建Task。
http://droidyue.com/blog/2015/08/16/dive-into-android-activity-launchmode/