把特权能力接进你的应用:集成前的整体认识
如果你的应用需要执行特权操作(跑命令、读系统属性、管理运行时权限),把 Stellar-API 集成进来,就能让用户在免 Root 的设备上用上这些能力。这一页是整个开发者分组的地图。
前置条件
- 应用最低支持 API 26(Android 8.0);
- 用户设备上已安装管理器并启动了服务(无线调试或 Root 均可);
- 依赖通过 JitPack 分发,项目能访问仓库即可。
集成路径四步走
- 添加依赖:JitPack 仓库与 Stellar-API 依赖 → 见添加依赖;
- 配置清单:声明 Provider 与权限 meta-data → 见Manifest 配置;
- 初始化与监听:感知服务连接、断开与授权结果 → 见初始化与监听器;
- 调用 API:按需使用权限、进程、用户服务等接口,各专页索引见下。
两条接入路线
| 路线 | 适用 | 说明 |
|---|---|---|
| Stellar 原生 API | 新应用 | 功能最全:细分权限、一次性授权感知、PTY 进程等 |
| Shizuku 兼容层 | 存量应用 | 零改动,靠管理器侧的兼容层直接运行 |
存量应用无需迁移也能用;但新代码建议走原生路线——伴随启动、授权类型感知这些增量能力只有原生 API 能触达。
能力索引
- 权限:权限 API
- 进程:特权进程与 PTY
- 服务内跑代码:用户服务
- 授权他人:运行时权限授予与撤销
- 系统层:系统属性与 Binder 包装
接口形态可能随版本演进,接入时以项目仓库内的接入指南与 AIDL 定义为准。