启用与禁用兼容层:默认开着,什么时候需要动它
兼容层默认启用,绝大多数用户一辈子不需要碰这个开关。但知道它在哪里、动了会怎样,排查问题时才有底。

开关在哪里
设置页 → Shizuku Compatibility(Shizuku 兼容)。v1.0.11 起这个开关还参与服务运行检测的优化,状态判断更可靠。
什么时候保持开启
- 使用的工具是「提示需要 Shizuku」的应用——这几乎是最常见的场景;
- 从 Shizuku 整体迁移过来、应用全靠兼容层跑——直接关掉等于全停;
- 拿不准 → 保持默认开启,没有副作用。
什么时候会去关它
- 设备上只跑 Stellar 原生应用,想收掉兼容层减少一层转发(收益很小);
- 排查「某应用行为异常」时做隔离变量:关掉兼容层看问题是否与它相关,见兼容层常见报错。
放行应用的操作
兼容层开着的前提下,Shizuku 应用的授权入口就在授权页的「Shizuku 兼容应用」分区,逐个放行即可,操作细节见授权应用页。
禁用后的连锁反应
关掉开关后:所有 Shizuku API 应用立即失去服务连接;已建立的连接会被断开;应用通常提示「Shizuku 未运行」。想再启用,回到设置打开开关并重启服务。
开发者视角:兼容层是为存量应用准备的过渡桥,新写的应用建议直接走 Stellar 原生 API,见集成总览。