Android Intent FLAG标识

迈不过友情╰ 2022-04-02 12:40 421阅读 0赞

最近，好些天都在看源码，现在 对这个Intent的FLAG有一些总结。都是我自己试验的，总结的 ，可能有不对的地方,大家可以评论指出。

## 使用 ##

对intent使用FLAG 大多数人都知道怎么弄。也就是调用`public @NonNull Intent setFlags(@Flags int flags)` 这个方法。但是如果 你同时要设定两个FLAG标识呢？  
这个有两种方式可以解决。  
第一种：

intent.setFlags(Intent.FLAG_ACTIVITY_NO_HISTORY|Intent.FLAG_ACTIVITY_NEW_TASK);

第二种：

intent.addFlags(Intent.FLAG_ACTIVITY_NO_HISTORY|Intent.FLAG_ACTIVITY_NEW_TASK);

第三种： 这种方式**要注意 setFlags()要先被调用，后调用的话，会只有最后setFlags（int flags）里面参数生效。**这个看源码就可以知道 **setFlags会把自己的参数直接赋值给intent的mFlags。addFlags则会将自己的参数 和mFlags做 或运算 ，最后赋值给 mFlags。**

intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
                    intent.addFlags(Intent.FLAG_ACTIVITY_NO_HISTORY);

## 正文 ##

### FLAG\_ACTIVITY\_CLEAR\_TASK ###

![在这里插入图片描述][20181226142801495.png]

## FLAG\_ACTIVITY\_CLEAR\_TOP ##

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2ExMDY0MDcyNTEw_size_16_color_FFFFFF_t_70]

## FLAG\_ACTIVITY\_EXCLUDE\_FROM\_RECENTS ##

![在这里插入图片描述][2018122614404413.png]  
上面这个新task栈，就得要说一下 Android管理activity使用栈来管理的。后进先出。 这个栈呢，就叫做task栈也叫任务栈。 每当你点击桌面图标时候，系统都会默认的创建一个task栈用来存放这个app的activity。 **task栈可以创建多个 。一般通过FLAG\_ACTIVITY\_NEW\_TASK或者FLAG\_ACTIVITY\_MULTIPLE\_TASK**。所以上面这个Flag，单独设置你是看不出效果的。要像下面这样：

intent.setFlags(Intent.FLAG_ACTIVITY_EXCLUDE_FROM_RECENTS|Intent.FLAG_ACTIVITY_CLEAR_TOP);

## FLAG\_ACTIVITY\_BROUGHT\_TO\_FRONT ##

这个标志通常不是由应用程序代码设置的，而是由系统为您设置的，如针对单任务模式的launchMode文档中所述。

## FLAG\_ACTIVITY\_LAUNCHED\_FROM\_HISTORY ##

这个标志通常不是由应用程序代码设置的，而是由系统设置的，如果这个活动是从history (longpress home key)启动的。启动 已存在的和未存在的activity 不会有任何影响。

## FLAG\_ACTIVITY\_FORWARD\_RESULT ##

现在 有A，B，C三个activity，在A中用startActivityForResult(intent,1); 启动B activity，**在B activity中 启动C activity，这时intent加 FLAG\_ACTIVITY\_FORWARD\_RESULT****（不能和startActivityForResult一起使用）**。那么就会将 **需要调用setResult(9999);的activity设为C**。如果C不调用 setResult(9999); 那么 A activity 的回调  
protected void onActivityResult(int requestCode, int resultCode, Intent data)的resultCode 为0。  
B 可以有很多个。  
**也就是说A 需要结果启动了B，但是B不知道怎么回复，B又启动了C，让C来回复A。**

## FLAG\_ACTIVITY\_NEW\_TASK ##

这是一个重要的标识。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2ExMDY0MDcyNTEw_size_16_color_FFFFFF_t_70 1]

## FLAG\_ACTIVITY\_NEW\_DOCUMENT ##

指定活动每次启动时都将成为**新任务的根活动**。**然后最近的任务列表中会显示同一个应用的多个activity。**  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2ExMDY0MDcyNTEw_size_16_color_FFFFFF_t_70 2]

## FLAG\_ACTIVITY\_MULTIPLE\_TASK ##

这个标识 能保证目标activity不会跳到目标activity**已经存在的实例上面**。**这个标志总是与FLAG\_ACTIVITY\_NEW\_DOCUMENT或FLAG\_ACTIVITY\_NEW\_TASK一起使用。**  
这两个标识和FLAG\_ACTIVITY\_MULTIPLE\_TASK一起使用时候。**就不会检查现有的task栈。****总是会创建一个新的task栈 放入目标activity实例。 这样用户 永远不会回到以前的界面上。**

note：如果还没有设置FLAG\_ACTIVITY\_NEW\_TASK或FLAG\_ACTIVITY\_NEW\_DOCUMENT中的一个，则忽略此标志。

## FLAG\_ACTIVITY\_NO\_ANIMATION ##

![在这里插入图片描述][20181226160616631.png]

## FLAG\_ACTIVITY\_NO\_HISTORY ##

当用户离开目标 Activity 并且其在屏幕上不再可见时，是否应从 Activity 堆栈中将其移除并完成 。通俗的讲，**就是你启动activityA的时候 ，加了这个flag。 当activityA启动后。你按了一下home键，回到桌面。那么activityA就会被杀死了。**  
也可以在activity标签 设置noHistory 属性，效果是一样的。

## FLAG\_ACTIVITY\_NO\_USER\_ACTION ##

设置这个FLAG 以后。离开当前activity的时候 不会再调用 onUserLeaveHint()回调。

## FLAG\_ACTIVITY\_PREVIOUS\_IS\_TOP ##

这个没搞懂，现在加这个 和不加 没区别。如果 你知道 可以告诉我。

## FLAG\_ACTIVITY\_LAUNCH\_ADJACENT ##

此标志仅在分屏多窗口模式下使用。新活动将显示在启动它的活动的旁边。这只能与FLAG\_ACTIVITY\_NEW\_TASK一起使用。此外，如果希望创建现有活动的新实例，则需要设置FLAG\_ACTIVITY\_MULTIPLE\_TASK。

## FLAG\_ACTIVITY\_REORDER\_TO\_FRONT ##

假设现在task栈中的 activity顺序是 A，B，C，D。 D是top activity，如果设置了FLAG\_ACTIVITY\_REORDER\_TO\_FRONT，启动B。那么，**将会把B 变成top。走B的 onNewIntent 周期。 其他activity 不变。** 现在task栈的顺 就是A，C，D，B。

如果还指定了FLAG\_ACTIVITY\_CLEAR\_TOP，则忽略此标志。**和FLAG\_ACTIVITY\_CLEAR\_TOP的差别是，FLAG\_ACTIVITY\_REORDER\_TO\_FRONT 不会把在它上面的activity 杀死**

## FLAG\_ACTIVITY\_RESET\_TASK\_IF\_NEEDED ##

task栈重排序  
这个启动器启动应用时候 会默认设置。 **要和android:exported=“true”  
和android:allowTaskReparenting="true"一起用，才有效果**  
**Android会查看任何其他task栈中是否有任何与此新task栈中具有相同的taskAffinity的activity。如果找到了，那么将在另一个task栈中的实例，转移到当前这个task的顶部。**  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2ExMDY0MDcyNTEw_size_16_color_FFFFFF_t_70 3]

## FLAG\_ACTIVITY\_RETAIN\_IN\_RECENTS ##

![在这里插入图片描述][20181226163656373.png]

## FLAG\_ACTIVITY\_SINGLE\_TOP ##

如果设置，则如果activity已经在历史堆栈的顶部运行，则不会启动该活动。

## FLAG\_ACTIVITY\_TASK\_ON\_HOME ##

![在这里插入图片描述][20181226164008190.png]

## FLAG\_DEBUG\_LOG\_RESOLUTION ##

您可以启用调试的标志:设置时，将在解析此意图期间打印日志消息，以显示创建最终解析列表所找到的内容。  
（没用 ，设置 不设置 log 一样的，。，，，，）

## FLAG\_EXCLUDE\_STOPPED\_PACKAGES ##

![在这里插入图片描述][20181226164257729.png]  
Android8.0 对静态注册的组件有了很大的限制。所以 就算不是stopped 状态 ，你也是唤醒不了的。[广播限制][Link 1]

## FLAG\_FROM\_BACKGROUND ##

可由调用方设置，以指示此意图来自后台操作，而不是来自直接用户交互。（用了没效果）

## FLAG\_GRANT\_PERSISTABLE\_URI\_PERMISSION ##

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2ExMDY0MDcyNTEw_size_16_color_FFFFFF_t_70 4]

## FLAG\_GRANT\_PREFIX\_URI\_PERMISSION ##

当与FLAG\_GRANT\_READ\_URI\_PERMISSION和/或FLAG\_GRANT\_WRITE\_URI\_PERMISSION组合在一起时，URI权限授予应用，前缀和原始已授予URL匹配的任何URL。(如果没有这个标志，URI必须与要授予的访问完全匹配。)只有当方案、权限和前缀定义的所有路径段完全匹配时，另一个URI才被认为是前缀匹配。

## FLAG\_GRANT\_READ\_URI\_PERMISSION ##

如果设置，将授予此intent的接收者对intent数据中的URI和其ClipData中指定的任何URI执行读操作的权限。  
当应用于意图的剪贴数据时，所有uri以及通过数据或意图项中的其他剪贴数据的递归遍历都将被授予;只使用顶级意图的grant标志。**就是当Intent 携带URI数据时候（就是文件啊，接收方可以对这个文件 进行读写）**

## FLAG\_GRANT\_WRITE\_URI\_PERMISSION ##

如果设置，将授予此意图的接收者对意图数据中的URI和其ClipData中指定的任何URI执行写操作的权限。当应用于意图的剪贴数据时，所有uri以及通过数据或意图项中的其他剪贴数据的递归遍历都将被授予;只使用顶级意图的grant标志。**就是当Intent 携带URI数据时候（就是文件啊，接收方可以对这个文件 进行读写）**。

## FLAG\_RECEIVER\_FOREGROUND ##

![在这里插入图片描述][20181226165332286.png]

## FLAG\_RECEIVER\_NO\_ABORT ##

**如果这是一个有序的广播，不允许接收器中止广播**。他们仍然可以将结果传播给后来的接收者，但是他们不能阻止后来的接收者看到广播。

这里 有序广播 就是有优先级 这个属性的。并且发送时候 也是通过 sendOrderedBroadcast(); 方法来发送。

## FLAG\_RECEIVER\_REGISTERED\_ONLY ##

![在这里插入图片描述][20181226165613757.png]

## FLAG\_RECEIVER\_REPLACE\_PENDING ##

![在这里插入图片描述][20181226170246601.png]  
好消息是 粘性广播已经 过时了。所以 不用看这个。

## FLAG\_RECEIVER\_VISIBLE\_TO\_INSTANT\_APPS ##

如果设置，则Instant Apps中的接收者可以看到广播。 默认情况下，Instant Apps不会接收广播。 当Instant App使用时，此标志无效。

完结，这个总结耗费了我不少时间，有一些是图片，那是因为 这些都是我OneOnte上面的。博客也只是我一部分知识的表现。

[20181226142801495.png]: /images/20220402/ad6617ead0644f20a727d3bc851fb00d.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2ExMDY0MDcyNTEw_size_16_color_FFFFFF_t_70]: /images/20220402/027594a6c17f48eda241b5ec07f2dfd2.png
[2018122614404413.png]: /images/20220402/4c50d81b6604445984dbe585c7b6beb7.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2ExMDY0MDcyNTEw_size_16_color_FFFFFF_t_70 1]: /images/20220402/239b65dce5ee4aea9c7e60735d78f70a.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2ExMDY0MDcyNTEw_size_16_color_FFFFFF_t_70 2]: /images/20220402/cbdac7022c1c4769a54c16b23f76e01e.png
[20181226160616631.png]: /images/20220402/94bf2ffca81c4b5ebba614cf1bf3c567.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2ExMDY0MDcyNTEw_size_16_color_FFFFFF_t_70 3]: /images/20220402/360ef98f64eb4b298e6ec945b9d0c6a0.png
[20181226163656373.png]: /images/20220402/bcd92ce89ba043ec8434ce4b64b10b61.png
[20181226164008190.png]: /images/20220402/9ffe7c302bf34d3d86a8cca8c1a19e7a.png
[20181226164257729.png]: /images/20220402/fa9471e2cc8a4f64b45348859bb95dbb.png
[Link 1]: https://developer.android.google.cn/about/versions/oreo/background#broadcasts
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2ExMDY0MDcyNTEw_size_16_color_FFFFFF_t_70 4]: /images/20220402/d163b0b328af492eaadfc0eb10467936.png
[20181226165332286.png]: /images/20220402/e2a7d9e3e13240c9a76483bbb1564530.png
[20181226165613757.png]: /images/20220402/ced119aee10e4a028b7fd289f3802c51.png
[20181226170246601.png]: /images/20220402/5547458979b64de084d9a1d534568dbb.png