shizukurunner 中文文档 下载 App

MIUI ColorOS EMUI 等系统兼容性调整

为什么要单独调系统

Android 原生的无线调试和权限授予在各品牌定制系统上被做了不同程度的修改——小米的 MIUI 加了安全扫描、OPPO 的 ColorOS 有权限监控、华为的 EMUI 在充电模式下禁用 adb。这些修改会直接导致 Shizuku 配对失败或服务无法启动。

小米 MIUI / Redmi

必做：关闭安全扫描

MIUI 的手机管家安全扫描功能会自动关闭开发者选项：

  1. 进入「手机管家」
  2. 找到「安全扫描」或「病毒查杀」
  3. 关闭「自动扫描」功能
  4. 或者直接关闭「开发者选项」里的「显示开发者选项」后重新打开（让手机管家重新扫描时跳过）

额外：USB 调试设置

MIUI 11+ 首次开启 USB 调试后，需要手动授予应用权限：

  1. 开发者选项 → 找到「USB 调试（安全设置）」开关，打开
  2. 授予 Shizuku Runner 的所有权限请求

注意：MIUI 的系统更新可能重置这些设置，更新后需要重新检查。

OPPO ColorOS / OnePlus OxygenOS

必做：关闭权限监控

ColorOS 的权限监控会拦截 Shizuku 的 Binder 通信：

  1. 开发者选项 → 找到「权限监控」开关，关闭
  2. 或者进入「设置」→「隐私」→「权限管理」，找到 Shizuku 主应用和 Runner，手动授予所有权限

华为 EMUI / HarmonyOS

必做：开启充电模式 adb

EMUI 默认只在 USB 调试开启时允许 adb，且要求：

  1. 开发者选项 → 找到「仅充电模式下允许 ADB 调试」开关，打开
  2. 鸿蒙系统进入「设置」→「关于手机」→ 连续点击版本号开启开发者模式后，同样要找这个开关

HarmonyOS 特别注意：鸿蒙对系统 API 的限制比 EMUI 更严，如果遇到 Runner 命令执行失败，先确认鸿蒙版本——早期 HarmonyOS 可能不完整支持 Android 11+ 的无线调试协议。

vivo OriginOS

必做：强制调整活动大小

OriginOS 默认限制分屏和小窗的显示比例，可能影响无线调试配对弹窗的显示：

  1. 开发者选项 → 找到「强制调整活动大小」开关，打开
  2. 如果配对弹窗在屏幕边缘或被遮挡，尝试横屏操作或在应用设置里强制横屏

魅族 Flyme

必做：禁用 Flyme 支付保护

Flyme 的支付保护会限制权限授予流程：

  1. 开发者选项 → 找到「Flyme 支付保护」相关选项，禁用
  2. 或者进入「设置」→「安全」→「支付保护中心」，移除 Shizuku 主应用

通用建议

不管哪个系统，配对时都建议：