Shizuku：让普通应用调用系统 API

项目简介

Shizuku 是一个 Android 应用，它让其他应用能够使用原本需要 ADB / root 权限才能访问的系统级 API。它的原理是通过 app_process 启动一个 Java 进程，从而在普通应用中以 ADB/root 的身份调用系统接口。

本仓库是 Shizuku 的 FORK（分支版本），原始版本位于 RikkaApps/Shizuku。作者已说明目前暂停维护，因为这只是一个没有时间继续投入的业余项目。

主要功能

相比原版，这个分支版本增加了一些功能：

• 更稳健的开机自启： 在启动 Shizuku 服务前先等待 Wi-Fi 连接
• TCP 模式：（即 adb tcpip 命令）重启后借助 Wi-Fi 成功启动过一次 Shizuku 后，即使没有 Wi-Fi 连接也能停止/重启 Shizuku
• 看门狗服务： Shizuku 意外停止时自动重启，并提示崩溃信息或可能的修复方式
• 启动/停止 Intent： 可通过 Tasker、MacroDroid、Automate 等自动化应用按需开关 Shizuku
• [BETA] 隐身模式： 对因安装了 Shizuku 而无法正常工作的其他应用隐藏 Shizuku
• [BETA] 应用内更新： 可自动检查新版本，并从 GitHub 自动下载/安装最新版
• Android/Google TV 与 VR 头显支持： UI 兼容 D-Pad 遥控器，支持所有电视（包括需要配对的 Android 14+ 电视），VR 头显可在设置中开关多窗口配对对话框
• MediaTek 支持： 修复了原版 v13.6.0 中导致 Shizuku 在 MediaTek 设备上无法工作的严重问题

安装与使用

下载

稳定版：最新稳定版

测试版：全部版本

所有版本都通过 GitHub Releases 分发。

使用要求

最低系统版本：Android 7+

• Root 模式： 需要已 root 的设备
• 无线调试模式： 适用于 Android 11+ 及所有 Android TV
• PC 模式： 适用于所有设备
• 开机自启： 仅在无线调试模式或 Root 模式下可用

配置方法、说明与故障排查步骤请阅读 wiki。

从源码构建

git clone --recurse-submodules

然后运行 Gradle 任务 :manager:assembleDebug 或 :manager:assembleRelease。

:manager:assembleDebug 任务会生成可调试的 server，你可以把调试器附加到 shizuku_server 上调试 server。在 Android Studio 中请确保勾选 Run/Debug configurations > Always install with package manager，以便 server 使用最新代码。

开发者说明

API 指南与示例项目位于 Shizuku-API 仓库。使用时注意：

1. Shizuku 在 root 与 ADB 模式下的权限不同。如果你的应用需要 root 权限，可用 ShizukuService#getUid 判断 Shizuku 是以 root 还是 ADB 运行，或用 ShizukuService#checkPermission 检查 server 是否拥有足够权限。
2. 在 Android 8 或更低版本的设备上，如果需要在可能不由 Activity 启动的 Service 或 Broadcast Receiver 中使用 Shizuku，请通过启动一个透明 Activity 来触发发送 binder。
3. 尽可能优先使用 ShizukuBinderWrapper 而不是直接使用 transactRemote，因为 API 调用可能随 Android 版本变化。

注意事项

• 这是 Shizuku 的 FORK 版本，不是原作者发布的原始版本。
• 作者已表示暂时暂停维护。
• 当前版本的 server 版本仍为 v13.6，因此主页显示的版本号会与「关于」页中的不同。
• 隐私方面：无跟踪与分析、无遥测、无专有库、不依赖 Google Play Services，代码开源且构建可复现；网络访问仅用于无线调试连接和从 GitHub 获取更新。
• 权限用途：INTERNET（无线调试与检查更新）、ACCESS_NETWORK_STATE（判断 Wi-Fi 是否可用）、POST_NOTIFICATIONS（配对通知与其他提醒）、RECEIVE_BOOT_COMPLETED（开机自启）、FOREGROUND_SERVICE（防止看门狗被杀死）、REQUEST_IGNORE_BATTERY_OPTIMIZATIONS（防止开机自启与看门狗服务被杀死）、WRITE_SECURE_SETTINGS（启动/停止 Shizuku 时后台切换 USB 与无线调试）、REQUEST_DELETE_PACKAGES（隐身模式下请求卸载 Shizuku/stub）、REQUEST_INSTALL_PACKAGES（应用更新及隐身模式下安装 Shizuku stub）。

---

本作品整理自 GitHub 开源项目 thedjchi/Shizuku，原作者 @thedjchi，许可证 Apache-2.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。