Skip to main content

Module android_adapter

Module android_adapter 

Source
Expand description

一等公民 AndroidAdapter:把已封存的 AuthorizedAction 经请求/响应协议 转发到设备侧 localhost bridge,并把设备的真实执行结果如实映射为 ActionOutcome / AdapterError。

与旧实现(DefaultActionExecutor 内部 env 分支 + fire-and-forget)相比的关键差异:

  1. 诚实的 outcome:请求/响应。转发后读取设备回执;超时、连接被拒、设备 拒绝或回执非法都返回 Err(AdapterError::AndroidBridgeError) → 生命周期记为 Failed,而不再把“一次成功的 TCP 写“谎报为 Succeeded。
  2. 注入式配置:AndroidBridgeConfig 在构造时注入,execute() 内不再 读取进程环境变量 —— 移除执行期的 ambient authority。
  3. HMAC 绑定:认证标签覆盖 freshness window 与 AuthorizedAction 字节, 而非静态 bearer token,使捕获到的标签无法重放到另一个 action 或过期窗口。

非转发类动作(或缺少有效目标的 PrefetchFile)回退到内部 DefaultActionExecutor 的确定性本地 stub —— 复用同一套 stub 语义,不重复实现。

注意:AndroidAdapter 不进入 golden/replay 的 hash 路径(那条路径用 OfflineAdapter)。设备侧 latency/成败本就非确定,本 adapter 只产生供检视的 审计轨迹,不参与可复现性断言。

Structs§

AndroidAdapter
转发到设备侧 bridge 的一等 adapter。
AndroidBridgeConfig
转发到 Android bridge 所需的配置。构造时注入,不在 execute() 内读 env。