Repolode
提交项目
roro2239

roro2239/Stellar

基于 Shizuku 的深度定制分支，让 Android 应用通过 ADB 或 Root 权限调用系统级 API。

在 GitHub 查看
Star
1,812
Fork
68
未关闭 Issue
27
最近提交
20天前

这是什么？

Stellar 是 Shizuku 的深度定制版本，让应用无需自身拥有 Root 权限，也能调用需要系统级权限的 API。通过 ADB 无线调试或 Root 启动 Stellar 服务后，授权应用即可通过它执行特权操作。

相比原版 Shizuku，Stellar 将权限细分为核心服务权限和伴随启动权限，后者可让应用的生命周期与服务绑定。项目还提供开机启动选项、服务与守护进程相互监测重启的双进程模式，以及以 Shell 用户（uid 2000）身份运行的降权激活功能。内置的 Shizuku 兼容层使基于 Shizuku API 开发的应用无需修改代码即可使用 Stellar。

项目主要使用 Kotlin 编写，管理界面采用 Material Design 3 风格重新设计。开发者可通过 JitPack 引入 Stellar-API 依赖进行集成，仓库提供了从 Shizuku 迁移的集成指南。

核心功能

  • 01通过 ADB 无线调试或 Root 权限启动特权服务。
  • 02细分的权限模型，包含核心服务权限和伴随启动权限。
  • 03内置 Shizuku 兼容层，现有 Shizuku 应用无需修改代码即可使用。
  • 04可选的降权激活功能，将 Root 启动的服务降至 Shell 用户运行。
  • 05双进程守护模式，服务与守护进程在异常关闭后相互拉起。
  • 06重新启用 Shizuku 已弃用的 newProcess() 及运行时权限授予、撤销功能。

适用场景

  • 开发需要系统级 API 但不希望用户 Root 设备的 Android 工具。
  • 将已基于 Shizuku 的应用迁移到提供更多权限控制的分支。
  • 借助开机启动选项，运行需要随系统启动的自动化或系统调优工具。

快速上手

  1. 1

    添加 JitPack 依赖 com.github.roro2239:Stellar-API:latest.release

  2. 2

    在 AndroidManifest 中配置 StellarProvider

  3. 3

    初始化 Stellar 并请求权限

  4. 4

    调用 Stellar API 执行特权操作

使用前须知

  • 服务必须通过 ADB 无线调试或 Root 权限启动。
  • 移除了 Shizuku 的部分功能，如 rish 和 Sui 支持，因此并非完全的直接替代品。

收录于专题

Android 应用与手机工具

标签

#android#shizuku#adb#root#system-api#kotlin#privileged-api

常见问题

Stellar 是什么？
基于 Shizuku 的深度定制分支，让 Android 应用通过 ADB 或 Root 权限调用系统级 API。 Stellar 是 Shizuku 的深度定制版本，让应用无需自身拥有 Root 权限，也能调用需要系统级权限的 API。通过 ADB 无线调试或 Root 启动 Stellar 服务后，授权应用即可通过它执行特权操作。
Stellar 可以免费使用吗？用的什么许可证？
Stellar 以 MPL-2.0 许可证开源。用于商业产品前，请先确认许可证条款。
Stellar 还在维护吗？
活跃维护中。Stellar 最近一次提交是在 2026年10月18日。
Stellar 适合用来做什么？
开发需要系统级 API 但不希望用户 Root 设备的 Android 工具。 将已基于 Shizuku 的应用迁移到提供更多权限控制的分支。 借助开机启动选项，运行需要随系统启动的自动化或系统调优工具。
Stellar 怎么安装和运行？
添加 JitPack 依赖 com.github.roro2239:Stellar-API:latest.release 在 AndroidManifest 中配置 StellarProvider 初始化 Stellar 并请求权限 调用 Stellar API 执行特权操作
在哪里获取 Stellar？
源代码和安装说明在 GitHub 上：https://github.com/roro2239/Stellar

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目