shizuku

CODE IN THE NOTIFICATION

shizuku 全程无线操作的安卓系统级权限桥接工具

shizuku 这款应用在 Android 11 及以上系统里可以完全不接电脑:配对码由系统生成,由它的通知接收,配对成功后服务就在手机里跑起来。整条链路只有一处需要人手输入,把六位数字从系统设置抄到通知栏那一步。

  • 六位配对码
  • 不插数据线
  • 配对只需一次
  • 与 root 无关
shizuku 配对页提示需要允许应用发布通知,否则无法从通知输入配对码
配对页会先提醒允许通知,否则配对码无处可填
three touchpoints

通知在这里不只是提醒

多数应用的推送是可以关掉的装饰,这里的通知是配对链条上的一环:关掉它,流程直接断在抄码那一步。

配对通知
在应用里点配对后会立刻出现,标题写着正在搜索配对服务。它带一个输入框,六位配对码要填进这里,点右侧箭头提交。它是唯一能填码的地方,系统设置页只负责显示码。
常驻通知
服务处于运行状态时留在通知栏,写明当前状态与端口。下滑可以看到详情,点开可以回到应用。服务退出时它会自己消失,可以把它当作最省事的健康指示。
系统通知样式
小米、POCO 默认把通知画成自家卡片样式,输入框回填的路径会被截断。到通知管理里把样式切成原生样式,配对通知才恢复成带输入框的样子。
通知权限
首次安装后系统会询问是否允许通知。拒绝过的应用在配对时会直接失败,需要到应用信息里手动打开通知权限,而不是重装一次。
three handovers

配对码的三次转手

一串数字在三个地方出现,顺序错了就会看到「配对失败」而不是别的提示,很容易被误判成码抄错。

  1. 系统生成,显示在无线调试里

    打开无线调试后点「使用配对码配对设备」,系统弹出一组数字与一个端口号,有效期很短,页面停留久了会自动刷新。

  2. 抄进通知栏的输入框

    下拉通知栏找到那条配对通知,输入六位数字后点箭头。这里的输入框由应用提供,系统不参与校验,填错只会静默失败。

  3. 配对成功后回应用点启动

    配对是登记握手关系,不等于启动。回到应用点一次启动,状态变成运行中,权限才真正开始借出。

配对码是一次性的。成功之后系统不会保存它,下次重启只回应用点启动,不需要再抄一遍;反过来,想换端口或重置关系时才需要重新配对。

screens

界面预览

三张图连起来就是完整的一条路:通知搜索到服务,样式切回原生,配对码填进输入框。

通知栏里的 shizuku 正在搜索配对服务通知
搜索阶段的通知只有一句说明,还没有输入框
安卓通知显示设置里把通知样式切换为原生样式
通知样式两选一,选原生那一张才能回填
配对码输入框与系统显示的一组六位配对码及端口
上框填码,下方的数字与端口由系统给出
shizuku 无线调试页说明 Android 11 之前需要连接电脑
低于 11 的机型会直接提示需要接电脑
blocked notices

通知被拦下的几种情况

配对失败几乎都不是密码学问题,而是这条通知没能正常出现、或被系统改写成了不能输入的样子。

现象多半原因怎么处理
通知栏里找不到那条通知通知权限被拒,或应用被归入静默通知到应用信息里打开通知,允许横幅与声音
通知在,但没有输入框通知样式被改成了系统自定义样式通知管理里切回原生样式,重开配对
点箭头后立刻失败配对码已过期,或端口已经变化回系统设置重新生成一组码,尽快填入
通知一闪就消失应用被系统清掉了后台解除电池限制、锁定后台,再重来一次

表里四种情况都不需要重新安装应用,也不需要换安装包版本。

questions

常见问题

这里只收与通知、配对码直接相关的问题,启动之后的授权与回收在另一条线上,逻辑完全不同。

常驻通知能不能关掉

可以关,但服务状态就看不见了。它本身不带广告与跳转,占的位置也很小,多数人留着更方便判断服务是否还在。

配对过一次,换 Wi-Fi 需要重新配对吗

同一台设备同一端口通常不用。换了网络环境或端口变了,系统会要求重新生成一次配对码。

为什么码填对了还是提示失败

先看通知样式是不是原生,再看码是不是已经过期。小米系机型这两条占绝大多数,跟数字本身无关。

通知栏一直显示正在搜索

系统没能把配对服务的广播送到应用。放开后台限制、关掉并重开无线调试,两者按顺序做一次。

可以扫码配对吗

系统页面提供了二维码入口,但这条链路不依赖它。手动抄六位数字更稳,也更容易排查问题出在哪一步。

装好先开通知权限,再谈配对

权限给足、样式切回原生,六位数字一次就能填进去。