搜索你想找的开源项目

输入名称、用途或关键词,也可粘贴 GitHub 仓库链接

分享到微信

当前解读页的微信分享二维码

用微信扫一扫打开,点击右上角「···」分享给朋友或朋友圈。

手机上可截屏后,在微信扫一扫中从相册识别二维码。

为 Android root 应用提供 Shizuku 风格 Java API 与远程 binder 服务的 Magisk 模块。

4,365
488
Java
GPL-3.0
创建于 5 年前

项目介绍

Sui 是一个 Magisk 模块,让已 root 的应用通过 Shizuku API 直接调用 Android 框架 API,并以 root 身份启动应用自己的 AIDL 风格 Java 服务。它不依赖执行 su 命令再解析文本,而是由 root 进程把 binder 交给 system server,应用再从中取回 root 进程的 binder。Sui 有意不向 PATH 添加二进制、也不安装管理器应用,以减少被检测的风险。它不是完整的 root 方案,必须配合 Magisk 使用。

安装

Sui 以 Magisk 模块形式安装。可以直接在 Magisk 中下载安装,也可以从 Release 页面下载 zip 后在 Magisk 里选择 Install from storage。仅支持 su 的现有应用行为不会改变。

打开管理界面

Android 8.0+ 且 Sui 12.1+ 时,在桌面长按系统设置可找到 Sui 快捷方式;Sui 12+ 进入「开发者选项」时系统会提示添加该快捷方式。也可以直接在默认拨号器中输入 *#*#784784#*#*。快捷方式方式依赖桌面支持 Android 7.0/8.0 的快捷方式 API。

交互式 shell

Sui 不会把文件放到 PATH,需要手动复制 shell 相关文件,/data/adb/sui/post-install.example.sh 演示了如何自动完成。复制完成后用 rish 代替 sh。

开发与构建

应用开发请使用 Shizuku API。构建前需带子模块克隆(git clone --recurse-submodules),然后运行 :module:assemble<Flavor><BuildType>,其中 Flavor 为 Riru 或 Zygisk,BuildType 为 Debug 或 Release,生成的 Magisk zip 位于 out。配套任务 push、flash、flashAndReboot 分别用于推送到 /data/local/tmp、通过 magisk --install-module 安装,以及安装后重启。

使用约束

需要 Magisk;非 Zygisk 版本还需要 Riru。它运行在 Android 上并面向已 root 设备,本身不提供 root。项目采用 GPL-3.0 许可。兼容性取决于 Magisk,以及使用快捷方式打开界面时桌面应用的支持情况。

HotRepo 点评

Sui 在 HotRepo 仅有一条快照记录:2026-11-10 的 Java 日榜新增 2 Star,当天该语言榜最好名次为第 7。这只是单日观察,不足以说明趋势,也没有全语言日榜名次记录。这个仓库的长期价值更多在于它为 root 应用提供的 API 层,而非涨星速度——Shizuku 一类工具应用依赖的正是这层基础设施。

本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。

相关推荐

  1. RikkaApps/Shizuku-API让 Android 应用以 ADB shell 或 root 身份运行自身 Java/JNI 代码,适合需要特权能力的 Android 开发者。Java2,724
  2. coldMEW/Hush在 Android 上跳过 Spotify 广告时段,无需 root 或修改版 Spotify;没有 Shizuku 时只能静音广告。Java18
  3. LSPosed/LSPatch把 Xposed 模块注入 APK,让 Android 应用免 Root 加载模块,适合普通用户和逆向分析人员。Java9,453