用途:该斜杠命令用于为 macOS 项目创建或更新项目本地的 script/build_and_run.sh 脚本,并把该脚本作为默认的构建/运行入口。
主要能力:自动检测仓库使用 Xcode workspace、Xcode project 还是 SwiftPM 包;若 workspace 尚未纳入 git,则在项目根目录执行 git init 以启用基于 git 的编辑器功能;生成或更新脚本,使其始终先停止当前应用、构建 macOS 目标并启动新构建结果。对 SwiftPM,仅对真正的 CLI 工具保留原始可执行文件启动方式;对 AppKit/SwiftUI GUI 应用,则创建项目本地 .app bundle 并用 /usr/bin/open -n 启动。脚本支持 --debug、--logs、--telemetry、--verify 等可选标志。
使用方式:可传入可选参数 scheme(Xcode scheme 名)、workspace(.xcworkspace 路径)、project(.xcodeproj 路径)、product(SwiftPM 可执行产品名)、mode(run、debug、logs、telemetry 或 verify,默认 run)、app_name(重新启动前要停止的进程/应用名)。脚本形态遵循 ../build-run-debug/references/build-script.md 中的规范引导契约。随后以请求的模式运行脚本,并汇总构建、脚本或启动失败信息。
限制与约束:不要在已有父级 checkout 内初始化嵌套 git 仓库;无标志的脚本路径保持简单,即 kill、build、run;仅在用户明确要求时才使用 --debug、--logs、--telemetry 或 --verify 模式。