快速接入

Priv Kit 支持 Android API 26 及以上版本。它为单个应用提供启动、连接并使用 自有 Privileged Server 的基础能力。应用可以使用内置文件代理、通过 Binder 或 自己的 UserService 实现特权功能。

添加依赖

优先使用 priv-ui。它提供 Compose 授权页面，并通过传递依赖公开 priv-core， 应用只声明这一个模块即可使用运行时、文件代理、Binder 和 UserService API。

dependencies {
    implementation("io.github.priv-kit:priv-ui:<version>")
}

自定义授权界面可以直接依赖 priv-core：

dependencies {
    implementation("io.github.priv-kit:priv-core:<version>")
}

配置 native 库打包

支持 Android 10 以下版本时，将 useLegacyPackaging 设置为 true：

android {
    packaging {
        jniLibs {
            useLegacyPackaging = true
        }
    }
}

Android 10 及以上版本没有此限制。Priv Kit 会根据 useLegacyPackaging 的值使用 对应的启动命令。

以 arm64 设备为例：

useLegacyPackaging = true：

adb shell /data/app/.../lib/arm64/libprivkitstarter.so

useLegacyPackaging = false：

adb shell /system/bin/linker64 '/data/app/.../base.apk!/lib/arm64-v8a/libprivkitstarter.so'

配置 hidden API 访问

在应用中配置 HiddenApiBypass：

class App : Application() {
    override fun attachBaseContext(base: Context?) {
        super.attachBaseContext(base)
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
            HiddenApiBypass.addHiddenApiExemptions("L")
        }
    }
}

嵌入 Privilege UI

在应用的 Compose 内容中放置 PrivilegeScaffold：

PrivilegeScaffold()

默认配置会展示 Root、ADB 和手动启动。ADB 界面会定期检查状态，并处理无线调试配对、 前台权限请求、TCP/IP 确认和启动。配置方式和静默启动见 Privilege UI 指南。

使用 priv-core 自定义界面

使用 priv-core 替换自带授权界面时，应用自行处理 权限请求、配对码输入、确认界面、定期检查状态和错误展示。

最短的 Root 与无线调试调用如下：

val rootServer = Privilege.startRoot()
val adbServer = Privilege.startAdb()

两者都是 suspend 函数。取消调用它们的协程时，运行时会关闭当前进程、Socket 或查找端口的任务。 完整的 priv-core 流程见启动方式。

选择使用方式

• 使用 Binder 访问系统服务或执行底层 Binder 调用。
• 使用文件代理执行基础的绝对路径文件操作，无需定义 UserService。
• 使用命令执行启动有界的非交互进程，并流式读取或汇总输出。
• 使用 UserService 运行应用自定义 AIDL 服务。
• 使用 Privilege UI 接入自带授权页面。
• 需要用 priv-core 替换该页面时阅读启动方式。

仍在活跃开发

请使用正式发布的版本。priv-core 和 priv-ui 是受支持的公开 API， 其他类和方法即使可以从字节码中访问，也属于实现细节。