用途:该技能用于从源码构建 Swift iOS 应用、使用 Apple 凭据签名、通过 OTA 安装到 iPhone,并发布到 App Store Connect(生产审核或 TestFlight)。所有构建均通过云端流水线完成,禁止使用 Xcode、xcodebuild 或 xcrun,也禁止直接对签名服务发起 HTTP/curl 调用,必须使用 ./ios-cli。
主要能力:ios-cli 提供登录、Apple ID 或 App Store Connect API 密钥认证、上传源码 zip 云端构建、模拟器预览、签名、设备注册与同步、构建日志、状态查询、从模板创建 SwiftUI 项目、添加 Swift Package Manager 依赖、配置管理等命令。输出支持 text、json 和 quiet 模式。
使用方式:默认流程为构建后输出 previewUrl 供预览,无需 Apple 认证。仅当用户点击“Install on device”触发安装消息时,才执行认证、设备注册和签名。首次设置需用户已加入 Apple Developer Program,依次完成 Apple 认证、设备注册和签名。构建失败可用 ./ios-cli logs <jobId> 查看 Xcode 错误并修复后重新构建。
适用场景:需要从源码构建 iOS 应用、在真机安装测试或发布到 App Store Connect 的流程。
限制:依赖 Vibecode 签名服务和 ios-cli 二进制;需要 Apple Developer Program 会员资格;认证凭据、设备注册和签名步骤仅在用户明确请求安装时执行;部分环境变量和配置细节需参考官方文档。