安卓启动模式调试的核心难点在于:Intent携带的Flag与AndroidManifest中launchMode的优先级关系以及ActivityRecord在任务栈中的复用判定逻辑,仅靠阅读文档很难建立准确的心智模型。排查启动模式问题时,adb shell dumpsys activity activities输出的Task与ActivityRecord层级才是唯一可靠的真相来源,所有对栈行为的猜测都应回归到这份输出上验证。
launchMode决定系统在启动Activity时是新建实例还是复用已有实例,以及是否创建新任务栈。四种模式的行为差异集中在实例查找范围和栈操作两个维度上。
| 启动模式 | 实例查找范围 | 栈行为 | 是否新建Task |
|---|---|---|---|
| standard | 不查找 | 始终压入当前栈顶 | 否 |
| singleTop | 仅当前栈顶 | 栈顶匹配时复用并回调onNewIntent | 否 |
| singleTask | 整个Task内查找 | 找到则clearTop并回调onNewIntent | 视taskAffinity而定 |
| singleInstance | 全局唯一 | 独占一个Task | 是 |
standard模式下每次startActivity都会创建新实例,这是最容易观察的基线行为。singleTop只在目标Activity恰好位于当前任务栈顶时复用,否则行为等同standard。singleTask的查找范围扩大到整个任务栈,命中后会把该实例之上的所有Activity弹出,这个clearTop动作是调试中最容易产生预期偏差的地方。singleInstance则让目标Activity独占一个任务栈,其他Activity无法进入该栈。
Intent Flag与launchMode同时存在时,Flag的优先级高于manifest中声明的launchMode,但不同Flag的覆盖能力并不一致。FLAG_ACTIVITY_SINGLE_TOP的语义与singleTop等价,FLAG_ACTIVITY_NEW_TASK的语义与singleTask部分重叠但不完全等同,FLAG_ACTIVITY_CLEAR_TOP则会强制清理目标之上的实例。
调试时常见的误区是只改了manifest却没注意调用方传入的Flag。实际判定顺序是:系统先读取Intent中的Flag,再叠加manifest的launchMode配置,最终由ActivityStarter中的computeLaunchingTaskFlags等方法计算出实际生效的启动参数。
定位这类冲突的有效方式是在adb shell dumpsys activity activities的输出中观察目标ActivityRecord的mLaunchMode字段和Intent的flags字段,两者不一致时即可判定Flag覆盖了manifest。
dumpsys activity activities是验证启动模式行为最直接的工具,它完整输出了Task、ActivityRecord、Intent、affinity等关键信息。以下命令组合可以快速定位栈行为异常:
adb shell dumpsys activity activities | grep -E "Task|ActivityRecord|mLaunchMode|affinity|Intent"
输出中需要重点关注的字段包括:Task的taskId和affinity,ActivityRecord的mLaunchMode与state,以及Intent中携带的flags。当发现同一个Activity出现多个ActivityRecord且taskId不同,说明taskAffinity配置导致了任务栈分裂;当目标Activity之上的实例没有被清理,则要检查CLEAR_TOP Flag是否遗漏。
对于需要交互式验证的场景,可以用am命令直接构造带Flag的启动请求:
adb shell am start -n com.example.app/.MainActivity --activity-clear-top --activity-single-top
am命令的--activity-*系列参数能直接映射到对应的Intent Flag,适合在不改代码的前提下复现启动模式问题。
onNewIntent不回调通常意味着系统没有复用已有实例,而是新建了一个ActivityRecord。需要逐项排查的触发条件包括:目标Activity不在当前任务栈顶(singleTop场景)、taskAffinity与当前栈不匹配(singleTask场景)、Intent缺少必要的Flag、以及Activity在manifest中同时配置了launchMode与configChanges导致的重建路径差异。
排查时可先通过dumpsys确认目标Activity是否真的被复用。若ActivityRecord数量增加,说明新建路径被命中,此时再逐一核对Flag与affinity配置。若ActivityRecord数量不变但onNewIntent未回调,则要检查Activity是否覆写了onNewIntent但未调用super,或是否使用了Fragment等间接分发路径。
taskAffinity决定Activity倾向于归入哪个任务栈,它与singleTask组合时会显著改变栈行为。当singleTask的Activity设置了与当前栈不同的taskAffinity,系统会为该Activity创建新的任务栈,此时即使用户从原栈启动,也会跳转到新栈中。
调试这类问题的关键是先用dumpsys确认Task的affinity字段。常见现象是用户以为Activity在同一个栈中被复用,实际系统已经创建了独立Task。修正方式包括统一taskAffinity配置,或改用singleTop配合FLAG_ACTIVITY_CLEAR_TOP来达到类似效果。
启动模式调试的可靠路径始终是:先通过dumpsys观察真实栈状态,再对照Flag与launchMode的优先级规则定位偏差来源,最后用am命令构造最小复现。把栈行为从主观猜测转为可观测数据,是排查这类问题效率提升的关键。
评论
加载中...