shizukuANDROID API BRIDGE

shizuku 常见问题解答

shizuku 用起来只有三个动作,出错也几乎集中在三处:包没装对、配对没握上手、授权没落到具体应用。把这三处的现象和处置记住,九成问题能自己解决,剩下的多半是系统策略在拦。

装包与启动

装完之后第一件事做什么?

先打开一次应用,让它把服务端文件解压到位,再进开发者选项开无线调试。顺序反过来会出现「找不到配对入口」的假象,其实是文件还没准备完。

提示「服务未运行」但明明点过启动?

看通知栏有没有常驻条目。没有就说明进程没起来,多半是调试开关被系统回收了;有条目却仍报未运行,则可能是设备上同时装了两个版本,互相抢同一个端口。

旧机器没有无线调试入口怎么办?

安卓 10 或更早的版本没有这个开关,只能走电脑:接上数据线,开启 USB 调试,在电脑上跑一次启动命令。命令可以在应用的指令页里直接复制。

配对与连接

配对码弹窗被通知栏挡住

部分定制系统把通知样式改成了自家样式,输入框会被折叠。到系统设置里把通知显示样式切回原生,再回到配对页,输入框就会正常浮出来。

端口每次都不一样,正常吗?

正常。无线调试的端口由系统随机分配,重启或重新开关无线调试都会变。应用会自动读取当前端口,所以通常不需要手动填。

换了 WiFi 之后连不上

无线调试要求手机与发起端处在同一网络,且部分路由器的隔离功能会挡住端口。先关掉访客网络与 AP 隔离,再重新配对一次。

授权与撤销

授权了,工具还是说没权限

先看名单里有没有它。名单里有却仍报错,通常是该工具在后台缓存了旧状态,强制停止后重新打开即可;个别工具需要重启手机才重新探测。

撤销之后对方会立刻失效吗?

会。下一次调用就会被拒绝,不需要重启手机。已经执行完的操作不会回滚,撤销只影响后续请求。

能不能一次授权所有应用?

不能,也不建议。逐个确认是它的安全模型:哪个应用拿了权限必须一眼可见,才能在想收回的时候收得回来。

兼容与限制

为什么有的工具在别的手机上能用,我这里不行?

多半不是权限问题,而是系统策略差异。同一版系统在不同厂商手里会收紧不同接口,比如限制后台启动、限制包安装来源。遇到这类情况先查该工具自己的兼容说明。

会跟手机管家或安全中心冲突吗?

偶尔会。部分安全软件把调试进程当成风险项,会主动结束它,表现为「跑一阵就掉」。把该应用加入后台白名单能缓解,但无法彻底免除。

它能卸载系统预装应用吗?

能停用,能不能彻底卸载取决于厂商是否允许。多数机型可以通过配套工具卸载当前用户的副本,恢复出厂设置后仍会回来。

换机器与退场

升级版本后授权还在吗?

覆盖安装通常保留名单,但服务进程会重启,需要重新点一次启动。跨大版本升级时建议先记下名单,装完核对一遍。

卸载前要做什么?

先在应用里停掉服务,再卸载。直接删应用不会立刻出问题,但个别配套工具会短暂停在「等待服务」的状态,重启一次即可恢复。

换手机怎么把配置搬过去?

搬不过去。授权名单在应用私有目录里,不随账号同步。新机上重装、重新配对、重新逐个授权,是唯一路径,但整个过程不超过几分钟。

问题对上了,就把包取回去

遇到没列出来的现象,先按「包、配对、授权」三段各查一遍,多数情况会自己浮出答案。