ComposeUiFlags.isAccessibilityShouldIncludeOffscreenChildrenEnabled = false —— 这行写在极氪车载导航 App.onCreate 开头的代码,藏着一个大多数 Android 开发者从没关注过的性能细节。
事情从一个“多余”的参数说起
这行代码到底控制了什么?
Jetpack Compose 在新版本中改了一条无障碍规则: 默认行为(true) :当 TalkBack 等无障碍服务来“看”你的界面时,Compose 会把 屏幕外的子节点 也塞进无障碍节点树——比如 LazyColumn 里已经组合但滑出视口的 item、被 clip 裁掉的内容。系统拿到的是一棵“全量”语义树。 设为 false 之后 :无障碍树只收录屏幕内可见的节点,屏幕外的直接跳过。 区别在哪?想象一个有 200 个联系人的列表,屏幕只显示 8 个。默认行为下,无障碍服务要处理的信息量远不止 8 个节点;关掉之后,就是 8 个。
为什么车载导航要关它
答案很现实: 车机上没有 TalkBack,这个功能是纯开销、零收益。 具体到这个项目,有三层考量: 1. 场景错配。 这是运行在车机中控上的导航 App,驾驶员用语音助手和方向盘按键交互,屏幕阅读器这类消费方基本不存在。为一个不存在的用户维护一棵庞大的语义树,不划算。 2. 语义树真的很大。 导航界面是“性能重灾区”:地图 annotation、TBT 转向卡片、搜索列表、路线预览……叠加起来节点数不少。每次系统触发无障碍事件、构建虚拟视图结构,遍历的都是主线程。开车场景下主线程每一毫秒都该留给地图渲染。 3. 它不是孤立优化。 同一个项目里,release 包还有这一手:
if (BuildConfig.BUILD_TYPE == "release") { window.decorView.post { SemanticsSuppressor.suppress(binding.mapContent) } }
两层配合形成完整的“语义瘦身”策略: - release 包 : SemanticsSuppressor 把整棵语义树压掉; - 所有包 :这个 flag 保证即便语义树还在构建(debug 调试、e2e 测试需要语义),也只收集屏幕内的节点。
想在自己项目里抄作业?注意这两点:
第一,必须赶在第一个 ComposeView 组合之前设置。 它是全局 var ,影响的是之后所有组合的语义构建策略。所以这段代码放在 App.onCreate 最前面——晚于第一个 setContent 执行就无效了。 第二,评估真实代价。 关掉后,屏幕外的元素对无障碍服务不可见,用户需要滚动到屏内才能被读到。手机 App 里有真实无障碍用户的话,这就是可访问性回退—— 手机端慎用,车机/嵌入式/专用设备场景才适合 。
延伸思考:性能优化藏在“没人用的功能”
这个案例的价值不只是这一行代码,而是它背后的优化思路:做性能优化时,别只盯着“做了什么”,多看看“为谁做的”。
无障碍树、动画回调、日志埋点、溢出保护……框架默认开启的很多能力,是为特定场景设计的。当你的运行环境明确不需要这些场景时,逐个关掉它们,往往能拿到意想不到的收益——而且几乎零风险(不碰业务逻辑)。 车载开发尤其如此:内存预算紧、主线程压力大、用户交互路径固定,每一个“用不上的默认行为”都是可以挤的水分。
总结 :这行代码告诉 Compose——“本应用的无障碍树不需要屏幕外的节点”。对手机 App 它可能是可访问性回退,但对车机导航来说,是一次教科书级的场景化裁剪