Project Icon

Shizuku

Android系统API权限增强工具

Shizuku是一款Android系统API权限增强工具,通过在root或ADB环境下运行服务进程,提供高效可靠的系统API调用。它优化了操作速度,扩展了应用功能,并保持ADB权限兼容性。Shizuku为开发者提供API工具包,简化高级系统操作,促进Android应用开发创新。

Shizuku

背景

在开发需要 root 权限的应用时,最常见的方法是在 su shell 中运行一些命令。例如,有一个应用使用 pm enable/disable 命令来启用/禁用组件。

这种方法有很大的缺点:

  1. 极其缓慢(需要创建多个进程)
  2. 需要处理文本(非常不可靠
  3. 可能性仅限于可用的命令
  4. 即使 ADB 有足够的权限,应用也需要 root 权限才能运行

Shizuku 使用了一种完全不同的方式。详细描述如下。

用户指南与下载

https://shizuku.rikka.app/

Shizuku 如何工作?

首先,我们需要讨论应用如何使用系统 API。例如,如果应用想获取已安装的应用列表,我们都知道应该使用 PackageManager#getInstalledPackages()。这实际上是应用进程和系统服务进程之间的进程间通信(IPC)过程,只是 Android 框架为我们处理了内部工作。

Android 使用 binder 来进行这种 IPC。Binder 允许服务端了解客户端的 uid 和 pid,这样系统服务就可以检查应用是否有权限执行操作。

通常,如果有一个供应用使用的"管理器"(例如 PackageManager),在系统服务进程中就应该有一个对应的"服务"(例如 PackageManagerService)。我们可以简单地认为,如果应用持有"服务"的 binder,它就可以与"服务"通信。应用进程在启动时会收到系统服务的 binder。

Shizuku 引导用户首先使用 root 或 ADB 运行一个进程,即 Shizuku 服务器。当应用启动时,连接到 Shizuku 服务器的 binder 也会被发送到应用。

Shizuku 提供的最重要功能是充当中间人,接收来自应用的请求,将它们发送到系统服务器,然后将结果发送回来。你可以查看 rikka.shizuku.server.ShizukuService 类中的 transactRemote 方法和 moe.shizuku.api.ShizukuBinderWrapper 类以了解详情。

这样,我们就达到了使用更高权限系统 API 的目标。对于应用来说,这几乎与直接使用系统 API 相同。

开发者指南

API 和示例

https://github.com/RikkaApps/Shizuku-API

从 v11 之前版本迁移

现有应用当然仍然可以正常工作。

https://github.com/RikkaApps/Shizuku-API#migration-guide-for-existing-applications-use-shizuku-pre-v11

注意事项

  1. ADB 权限有限

    ADB 的权限有限,并且在不同的系统版本上有所不同。你可以在这里查看授予 ADB 的权限。

    在调用 API 之前,你可以使用 ShizukuService#getUid 检查 Shizuku 是否正在使用 ADB,或使用 ShizukuService#checkPermission 检查服务器是否有足够的权限。

  2. Android 9 之后的隐藏 API 限制

    从 Android 9 开始,普通应用对隐藏 API 的使用受到限制。请使用其他方法(例如 https://github.com/LSPosed/AndroidHiddenApiBypass)。

  3. Android 8.0 和 ADB

    目前,Shizuku 服务获取应用进程的方式是结合 IActivityManager#registerProcessObserverIActivityManager#registerUidObserver(26+)来确保在应用启动时发送应用进程。然而,在 API 26 上,ADB 缺乏使用 registerUidObserver 的权限,因此如果你需要在可能不是由 Activity 启动的进程中使用 Shizuku,建议通过启动一个透明的 activity 来触发 binder 的发送。

  4. 直接使用 transactRemote 需要注意

    • 不同 Android 版本下的 API 可能不同,请务必仔细检查。此外,android.app.IActivityManager 在 API 26 及以后版本中有 aidl 形式,而 android.app.IActivityManager$Stub 仅存在于 API 26。

    • SystemServiceHelper.getTransactionCode 可能无法获取正确的事务代码,例如 android.content.pm.IPackageManager$Stub.TRANSACTION_getInstalledPackages 在 API 25 上不存在,而是有 android.content.pm.IPackageManager$Stub.TRANSACTION_getInstalledPackages_47(这种情况已经处理,但不排除可能存在其他情况)。使用 ShizukuBinderWrapper 方法不会遇到这个问题。

开发 Shizuku 本身

构建

  • 使用 git clone --recurse-submodules 克隆
  • 运行 gradle 任务 :manager:assembleDebug:manager:assembleRelease

:manager:assembleDebug 任务生成可调试的服务器。你可以将调试器附加到 shizuku_server 以调试服务器。请注意,在 Android Studio 中,"运行/调试配置" - "始终使用包管理器安装" 应该被选中,这样服务器就会使用最新的代码。

许可证

本项目的代码可在 Apache-2.0 许可下使用。

例外情况

  • 禁止以任何方式使用以下列出的图像文件(除非用于显示 Shizuku 本身)。

    manager/src/main/res/mipmap-hdpi/ic_launcher.png
    manager/src/main/res/mipmap-hdpi/ic_launcher_background.png
    manager/src/main/res/mipmap-hdpi/ic_launcher_foreground.png
    manager/src/main/res/mipmap-xhdpi/ic_launcher.png
    manager/src/main/res/mipmap-xhdpi/ic_launcher_background.png
    manager/src/main/res/mipmap-xhdpi/ic_launcher_foreground.png
    manager/src/main/res/mipmap-xxhdpi/ic_launcher.png
    manager/src/main/res/mipmap-xxhdpi/ic_launcher_background.png
    manager/src/main/res/mipmap-xxhdpi/ic_launcher_foreground.png
    manager/src/main/res/mipmap-xxxhdpi/ic_launcher.png
    manager/src/main/res/mipmap-xxxhdpi/ic_launcher_background.png
    manager/src/main/res/mipmap-xxxhdpi/ic_launcher_foreground.png
    
  • 对于整个项目而言,它不是免费的。 你禁止编译的 apk(包括修改过的,例如将应用名称"Shizuku"改为其他名称) 分发到任何应用商店(包括但不限于 Google Play 商店、F-Droid、亚马逊应用商店等)。

项目侧边栏1项目侧边栏2
推荐项目
Project Cover

豆包MarsCode

豆包 MarsCode 是一款革命性的编程助手,通过AI技术提供代码补全、单测生成、代码解释和智能问答等功能,支持100+编程语言,与主流编辑器无缝集成,显著提升开发效率和代码质量。

Project Cover

AI写歌

Suno AI是一个革命性的AI音乐创作平台,能在短短30秒内帮助用户创作出一首完整的歌曲。无论是寻找创作灵感还是需要快速制作音乐,Suno AI都是音乐爱好者和专业人士的理想选择。

Project Cover

有言AI

有言平台提供一站式AIGC视频创作解决方案,通过智能技术简化视频制作流程。无论是企业宣传还是个人分享,有言都能帮助用户快速、轻松地制作出专业级别的视频内容。

Project Cover

Kimi

Kimi AI助手提供多语言对话支持,能够阅读和理解用户上传的文件内容,解析网页信息,并结合搜索结果为用户提供详尽的答案。无论是日常咨询还是专业问题,Kimi都能以友好、专业的方式提供帮助。

Project Cover

阿里绘蛙

绘蛙是阿里巴巴集团推出的革命性AI电商营销平台。利用尖端人工智能技术,为商家提供一键生成商品图和营销文案的服务,显著提升内容创作效率和营销效果。适用于淘宝、天猫等电商平台,让商品第一时间被种草。

Project Cover

吐司

探索Tensor.Art平台的独特AI模型,免费访问各种图像生成与AI训练工具,从Stable Diffusion等基础模型开始,轻松实现创新图像生成。体验前沿的AI技术,推动个人和企业的创新发展。

Project Cover

SubCat字幕猫

SubCat字幕猫APP是一款创新的视频播放器,它将改变您观看视频的方式!SubCat结合了先进的人工智能技术,为您提供即时视频字幕翻译,无论是本地视频还是网络流媒体,让您轻松享受各种语言的内容。

Project Cover

美间AI

美间AI创意设计平台,利用前沿AI技术,为设计师和营销人员提供一站式设计解决方案。从智能海报到3D效果图,再到文案生成,美间让创意设计更简单、更高效。

Project Cover

AIWritePaper论文写作

AIWritePaper论文写作是一站式AI论文写作辅助工具,简化了选题、文献检索至论文撰写的整个过程。通过简单设定,平台可快速生成高质量论文大纲和全文,配合图表、参考文献等一应俱全,同时提供开题报告和答辩PPT等增值服务,保障数据安全,有效提升写作效率和论文质量。

投诉举报邮箱: service@vectorlightyear.com
@2024 懂AI·鲁ICP备2024100362号-6·鲁公网安备37021002001498号