安装

安装前准备

开始前准备：

• Mac、Xcode、Git 和命令行工具。
• Codex、Cursor 或 Claude Code 中的一种 AI 编程工具。
• Apple ID；准备上架时需要有效的 Apple Developer Program 资格。
• 建议准备一台 iPhone 做真机验证。

如果 App 包含网站或后端，再准备 Cloudflare 或你实际使用的云服务账号。

1. 获取交付仓库

付款并确认 GitHub 用户名后，接受仓库邀请并克隆代码。先阅读仓库根目录的 README、项目规则和产品说明，不要直接从某个案例 App 复制文件开始修改。

交付仓库会把模板、App、Skills、素材、文档和工具放在明确的目录中：

2. 安装 iOS 开发插件

Codex 用户可以在插件列表中搜索并安装 Build iOS Apps。其他 Agent 工具需要具备对应的 iOS、Xcode 和命令行操作能力。

涉及 Cloudflare 后端时，再安装 Cloudflare 相关插件或 Skill。不要为了“配置完整”安装与当前 App 无关的工具。

3. 检查本地工具

在仓库根目录让 Agent 检查：

请先读取仓库 README、AGENTS.md、产品档案和 iOS 开发 Skill。

只做环境检查，不修改远端资源。检查 Git、Xcode、xcodebuild、模拟器、签名环境、Xcode MCP、ASC CLI 和当前仓库状态。列出已经可用、需要我手动处理和会阻止首次开发的事项。

至少确认：

• xcodebuild -version 可以返回当前 Xcode 信息。
• xcrun simctl list 可以读取模拟器。
• 目标工程可以被 Xcode 打开。
• 仓库没有把私钥、会话或生产凭据提交进 Git。

4. 查看工作流目录

主流程位于 /create-oneapps-app 对应的 Skill 中，并按调研、架构、设计、测试、商店素材和发布任务引用配套资料。

完成以上步骤后，继续阅读配置。