安卓原生任务栈的集成方式决定了跨端框架页面跳转的最终行为,将跨端页面统一挂在单Activity多Fragment架构下是当前主流且最可控的做法。跨端框架如Flutter、React Native在渲染层各自独立,但页面导航最终仍要落到Activity与Fragment的任务栈管理上。理解任务栈集成,本质上是在解决"跨端路由"与"安卓原生返回栈"两套体系如何对齐的问题。
跨端框架自带路由栈,安卓原生任务栈则由系统管理,两者对"返回"的定义并不一致。跨端路由栈是一个纯内存的页面数组,push和pop由框架自身控制;而安卓任务栈由ActivityRecord组成,受系统、启动模式、Intent Flag共同影响。当跨端页面与原生页面混合存在时,如果不做集成,会出现返回键行为错乱、页面重复创建、状态丢失等问题。
集成方案的核心目标,是让跨端路由栈的深度变化能被安卓任务栈感知,同时让系统返回事件能正确回传给跨端框架。常见做法包括单Activity承载所有跨端页面、多Activity按模块拆分、以及混合承载三种。
单Activity架构把整个跨端应用收敛到一个宿主Activity中,跨端页面以Fragment或自定义ViewGroup形式挂载,导航完全交给跨端路由处理。这种模式的优势在于任务栈结构简单,系统返回事件只需在唯一Activity中统一分发。
宿主Activity需要在onBackPressed或OnBackPressedDispatcher中拦截返回事件,先询问跨端路由是否能pop,能则交给框架处理,不能则交还系统。代码结构大致如下:
class HostActivity : AppCompatActivity() {
override fun onBackPressed() {
val router = FlutterRouter.instance
if (router.canPop()) {
router.pop()
} else {
super.onBackPressed()
}
}
}该方案下,任务栈深度始终为1,跨端内部页面切换不产生新的ActivityRecord。缺点是无法利用系统的多任务卡片展示,不适合需要每个页面独立出现在最近任务列表中的应用。
涉及原生与跨端混合跳转时,Activity的启动模式直接决定任务栈是否会产生重复实例。standard模式每次启动都新建实例,singleTop在栈顶复用时不会重建,singleTask会清理其上的所有Activity,singleInstance则独占一个任务栈。跨端跳转到原生页面时,若目标Activity声明了singleTask,原有跨端页面可能被整体弹出栈,造成用户返回时页面丢失。
| 启动模式 | 任务栈行为 | 跨端混合场景风险 |
|---|---|---|
| standard | 每次新建实例 | 返回时出现重复页面 |
| singleTop | 栈顶复用 | 跨端跳原生时行为基本可控 |
| singleTask | 清理其上实例 | 跨端页面被意外弹出 |
| singleInstance | 独占任务栈 | 返回链路断裂 |
实践中,宿主Activity通常使用singleTask配合launchMode与taskAffinity控制,而跨端内部页面跳转一律不走Activity,避免触发系统任务栈的清理逻辑。
跨端框架通过Platform Channel或JSI向原生注册路由监听,原生在收到系统返回事件后,需要判断当前是否处于跨端页面的栈底。若处于栈底,则交还系统执行退出;若不在栈底,则通知跨端执行pop。
同步机制需要处理三类边界情况:
推荐以跨端路由栈为唯一权威来源,原生侧只保留一个宿主Activity,所有导航状态均由跨端框架维护。这种约定能显著降低混合栈的状态同步复杂度。
安卓系统在内存紧张时会回收后台进程,应用恢复时Activity会被重建,但跨端框架的Dart VM或JS上下文可能已经丢失。此时若直接恢复路由栈,会出现页面白屏或状态错乱。处理方式是在宿主Activity的onSaveInstanceState中保存当前路由路径与必要参数,在onCreate中判断是否为重建场景,若是则通过跨端框架的路由API恢复到对应页面。
需要注意的是,恢复路由栈不等于恢复页面内部状态。跨端页面的滚动位置、表单输入等需要业务层自行持久化,框架只能保证路由层级的正确性。这也是任务栈集成中容易被忽视的工程细节。
如果应用需要每个页面独立出现在最近任务列表中,单Activity方案就不适用,必须采用多Activity承载跨端页面的方式,并通过taskAffinity与documentLaunchMode精细控制任务栈。这类场景多见于文档编辑、浏览器类应用。
对于大多数社交、电商、工具类应用,单Activity多Fragment架构配合跨端统一路由,是任务栈集成复杂度最低、行为最可控的方案。集成时优先统一导航权威来源,再处理进程重建与状态恢复,最后根据最近任务展示需求决定是否拆分Activity。
评论
加载中...