接口 CompanionPrepareOptions

备注

回调接收经过 Runtime 校验的 CompanionPrepareProgress：Host 可能报告 downloading、verifying、extracting；下载 total 可以省略，其他阶段同时提供 processed 与 total。加入既有操作时，Host 可以先回放最近进度；不保证页面收到每个 中间值。回调抛错会被 SDK 隔离，不会取消 Host 操作或改变 prepare 的最终结果。

备注

调用前已经 aborted 时，SDK 在发起 prepare 前以 COMPANION_PREPARATION_CANCELLED 拒绝。操作在途时触发 signal，SDK 会另发 cancelPreparation(alias)，但不会使用普通 bridge cancel，也不会仅在页面本地立即 settle；最终结果仍由 Host 的取消与原子提交 竞态决定。

同 alias 的准备由 Host 共享，因此该取消意图针对整项在途准备，不只是移除当前页面的 progress observer，其他 joiner 也可能收到取消结果。页面 reload 本身不会触发这个 signal，也不会自动取消 Host 操作。需要观察取消请求本身是否失败时，显式 await companion.cancelPreparation。