CLIENTS · OFFICIAL PROMPT

启动 iOS 客户端

让 AI 配置 iOS 工程、连接后端并通过一次真实编译。

难度
入门
阶段
准备 · 开发 · 验证
版本
v1.0.0
更新
2026-08-30

OUTCOMES

这条 Prompt 会帮你完成什么

  • iOS 工程在模拟器或设备运行
  • xcodebuild 验证通过

BEFORE YOU START

开始前准备

  • 使用安装了兼容 Xcode 的 Mac
  • 后端 API 可访问

AI 应优先了解这些位置

apps/tabtin-iosAGENTS.mddocs/agent/commands.md

READY TO RUN

完整 Prompt

复制完整 Prompt,不会遗漏执行边界和验收要求

你正在帮助我启动 TabTin iOS 客户端,之后我会把它改造成自己的移动产品。请以仓库当前工程配置为准,完成依赖、后端连接、编译和运行验证,不要只描述 Xcode 中应该点击什么。

开始前

阅读根 AGENTS.md、移动端相关规则和 apps/tabtin-ios 中的工程说明。检查 macOS、Xcode、命令行工具、模拟器、Swift 版本和签名团队。确认当前后端地址能被模拟器或真机访问,避免把 localhost 错当成设备可访问地址。保留现有签名配置和用户改动。

任务

  1. 识别工程入口、Scheme、最低系统版本、包依赖和环境配置来源。
  2. 安装或解析依赖,选择可用模拟器;需要真机签名时先说明账户和团队要求。
  3. 配置开发后端地址与必要权限,不能将秘密直接写入源码。
  4. 使用命令行构建发现真实编译错误,逐项修复后再运行应用。
  5. 检查登录、组织进入、基础导航和一个核心数据页面,确认不是只显示静态壳。

验证

每轮修改后运行一次明确的 xcodebuild 验证,记录 Scheme、Destination 和结果。实际启动模拟器或设备,检查网络、权限弹窗、深色/浅色基础表现和控制台错误。若功能依赖推送、相机等真机能力,明确模拟器未覆盖的边界。

最终汇报

说明运行目标、后端环境、构建命令、编译结果、已验证页面、签名状态和剩余真机事项。不要上传 TestFlight,不改 Bundle ID 或签名资产,除非我明确要求。