便携包导入与导出¶
便携包用于在设备之间迁移任务模板、工作流和模板路线。它会尽量保留任务说明、目标应用、用户操作文档、步骤编排和已保存路线,让另一台设备导入后再做本机适配。
什么时候需要导出?¶
适合导出:
- 你在一台设备上调好了一个任务模板,想放到另一台设备使用。
- 你想备份一个已经编排好的工作流。
- 你想把某个模板或工作流分享给别人,让对方导入后再本地试跑。
不适合导出:
- 模板还没有跑通。
- 任务强依赖本机账号、时间、地理位置或临时状态。
- 任务里有付款、下单、发消息等高风险动作,且没有在目标设备上测试。
导出¶
导出入口在编辑页:
- 任务模板:打开已保存的模板详情页,点击 导出模板。
- 工作流:打开已保存的工作流详情页,点击 导出工作流。
新建对象还没有保存时,导出会提示“请先保存后再导出”。
导出成功后,前端会立即弹出结果提示,并显示保存路径。优先保存到:
Downloads/LXB/Tasks/lxb-template-portable-<时间戳>.json
Downloads/LXB/Tasks/lxb-workflow-portable-<时间戳>.json
如果系统下载目录不可写,App 会使用自己的外部文件目录作为兜底路径,提示里会显示最终位置。
导出文件包含什么?¶
模板便携包包含:
- 模板名称和描述。
- 目标应用包名。
- 用户操作文档。
- 是否启用旧的 TASK_DECOMPOSE 阶段。
- 路线模式。
- 已保存的模板路线。
- “回放结束后直接结束任务”等路线行为配置。
工作流便携包包含:
- 工作流名称和描述。
- 步骤顺序。
- 每个步骤引用的模板。
- 工作流所需模板的嵌入副本。
- 嵌入模板的路线。
不会导出的内容¶
为了避免把原设备的本机运行状态带到新设备,便携包不会携带:
- 原对象的本地身份。
- 历史运行记录。
- 历史运行时间。
- 工作流触发器配置。
- 触发器启用状态。
导入后,工作流默认触发方式为空、触发器关闭。需要定时或通知触发时,请在工作流编辑页重新配置。
导入¶
导入入口在任务页,按钮名是 导入便携包。选择 JSON 文件后,AutoLXB 会自动识别模板便携包、工作流便携包以及兼容的旧格式文件。
导入成功或失败都会立即弹出提示:
- 导入模板成功后,会打开导入模板的编辑页。
- 导入工作流成功后,会打开导入工作流的编辑页。
- 导入失败时,会提示失败原因。
导入时会生成新的本地 ID。允许重名,对象只用 ID 区分。导入过程采用整体事务:模板、工作流或路线任意一部分失败,整次导入都会回滚。
旧格式兼容¶
导入器会识别旧格式任务 JSON / 旧格式路线 JSON,并迁移成当前的模板或工作流结构:
- 旧定时类文件会迁移成一个模板和一个工作流。
- 旧通知触发类文件会迁移成一个模板和一个工作流。
- 纯路线文件会迁移成模板路线。
迁移后仍然需要打开编辑页检查目标应用、任务描述、路线和触发方式。
跨设备路线适配¶
有些路线步骤可以直接在新设备上复用,例如有明确文字或描述的按钮。也有一些步骤在 XML locator 无法复用时需要在新设备上做语义适配。
首次运行导入对象时,AutoLXB 会尝试根据语义说明和当前界面重新找到目标控件,并把适配结果保存到新设备本地。
导入后一定要试跑
不同设备的屏幕尺寸、系统字体、App 版本和登录状态都可能不同。导入后建议先手动立即触发一次低风险试跑,确认路线和任务行为都符合预期,再启用定时或通知触发。