Remo Setup 是每个项目使用一次的初始化技能,用于把 Remo 的命令行工具(CLI)和 SDK 正确接入 iOS 应用。开始前应先确认应用本身已能在模拟器上编译并启动。使用安装或验证命令前,需先阅读 references/cli.md 获取确切的参数语法、二进制解析方式和当前 CLI 注意事项。
流程分四步。第一步安装 CLI:优先做项目本地安装,使版本与项目绑定,可用 REMO_INSTALL_PREFIX="$PWD/.remo" 配合发布安装脚本,让二进制落在 .remo/bin/remo;随后按顺序解析二进制:.remo/bin/remo、remo,若都不存在则先完成安装。第二步添加 SDK:使用 Swift Package Manager 时,若项目有 Package.swift,添加 .package(url: "https://github.com/yjmeqt/remo-spm.git", from: "0.4.0"), 以及 .product(name: "RemoSwift", package: "remo-spm"),;若应用仅在 Xcode 中管理、没有包清单,则需在 Xcode 中添加上述仓库地址。使用 CocoaPods 时添加 pod 'Remo', :podspec => 'https://raw.githubusercontent.com/yjmeqt/remo-spm/main/Remo.podspec',Objective-C 支持需改用 pod 'Remo/ObjC', :podspec => '...'。第三步在调试构建中启动:把 Remo 接入应用生命周期,并始终置于 #if DEBUG 内,导入、Remo.start() 与能力注册都只走仅调试代码路径;UIKit 在 didFinishLaunchingWithOptions 中调用 Remo.start(),SwiftUI 在 App 的 init 中调用。Remo.start() 是幂等的;Release 构建会把 SDK 编译为空操作,但仍建议保留 #if DEBUG 以保持清晰;模拟器通常通过 Bonjour 被发现,每次启动可能使用不同端口。第四步验证:执行 references/cli.md 中的最小验证序列——发现运行中的应用、调用 __ping、保存截图、检查视图树。
完成标准:CLI 二进制可正确解析、应用出现在 remo devices 中、remo call ... "__ping" 成功、截图捕获可用、视图树捕获可用。之后日常验证改用 remo,项目特定自动化改用 remo-capabilities。除上述内容外,其余细节资料暂未提供。