iOS Build Expert 是一个专注于 iOS/Xcode 构建问题的技能,资料说明其提供针对 Leavn 应用的完整 iOS 构建系统专业知识。
用途 该技能用于处理 iOS 构建过程中出现的各类问题,包括编译错误、模拟器问题、构建分析与诊断,以及快速修复。资料中明确其适用场景为:构建失败、模拟器问题、Xcode 错误和诊断。
主要能力 资料列出了以下能力方向:
- 构建错误处理:运行构建并捕获输出,对错误进行分类(类型错误、缺失导入、actor 隔离等),按依赖顺序修复(导入→类型→逻辑),然后重新构建并验证。
- 模拟器问题处理:重置模拟器、启动指定设备、安装应用、启动应用。
- 常见修复:检查 Package.swift 依赖、添加 @MainActor 或 nonisolated、检查 @Observable 与 @Published 模式、验证 project.yml / xcodegen 构建设置。
- 可视化调试:通过 simctl 进行截图和录屏。
使用方式 资料提供了以下快速命令:
- make clean:清理构建
- make sim-build:为模拟器构建
- make test:运行测试
- xcrun simctl list:列出模拟器
构建错误工作流:
- 运行构建并捕获输出:make sim-build 2>&1 | tee /tmp/build.log
- 对错误进行分类:类型错误、缺失导入、actor 隔离等
- 按依赖顺序修复(导入→类型→逻辑)
- 重新构建并验证
模拟器操作命令:
- 重置:xcrun simctl erase all
- 启动指定设备:xcrun simctl boot "iPhone 15 Pro"
- 安装应用:xcrun simctl install booted path/to/app
- 启动应用:xcrun simctl launch booted bundle.id
可视化调试命令:
- 截图:xcrun simctl io booted screenshot /tmp/screen.png
- 录屏:xcrun simctl io booted recordVideo /tmp/video.mov
适用场景 适用于 iOS 项目构建失败、模拟器异常、Xcode 报错以及需要构建诊断的场景。资料中特别提到该技能面向 Leavn 应用的构建系统。
限制 资料未提供该技能的安装方式、收费模式、支持平台范围、具体版本要求或与其他工具的集成说明,这些信息暂未提供。