Priv Kit 是什么？

Priv Kit 让 Android 应用通过 Root、ADB、手动命令或外部授权器启动和管理自己的特权进程，用于 Binder 调用、文件操作、命令执行和自定义 UserService。

使用 priv-ui 接入 Compose 授权页面，或通过 priv-core 自建界面。

接入步骤见快速接入。

功能

Privilege UI

priv-ui 处理启动、无线调试配对、权限请求、TCP/IP 确认和静默启动。

用 priv-core 构建自定义界面

priv-core 提供 Root、无线 ADB、静态 TCP、手动和外部授权器所需的启动与连接 API。自定义界面负责权限请求、配对码输入、确认和错误展示，底层流程见 启动方式。

通过 Binder 访问服务

按名称获取系统服务并转发 Binder 调用。应用提供服务接口并处理错误，见 Binder。

内置文件代理

文件代理在服务端执行文件操作，内容和目录项通过管道传输。

应用自定义 UserService

应用定义 AIDL 接口和特权实现，Priv Kit 负责启动 UserService、管理生命周期并返回 Binder。

每个应用独立运行

每个应用独立管理自己的服务端，包括启动、连接和恢复。

各启动方式使用相同的连接检查，并报告断连和服务端死亡。

从哪里开始

• 按照快速接入添加 priv-ui 并嵌入授权页面。
• 在 Privilege UI 中配置自带的前台与静默流程。
• 使用 priv-core 构建自定义界面时，阅读启动方式。
• 选择文件代理执行基础文件操作、选择 Binder 执行底层 Binder transaction，或选择 UserService 运行应用自定义 AIDL 服务。
• 在 GitHub 浏览源码或反馈问题。