> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superun.com/llms.txt
> Use this file to discover all available pages before exploring further.

# iOS开发专家

> 在 WorkBuddy 使用 superun iOS开发专家，完成本轮研发、适配规划确认、上线与打包，查询历史包和备案信息。

superun iOS开发专家帮助你从一句想法做出能安装到iPhone的 App，也支持把指定的已有 superun 项目适配后打包。目标平台固定为iOS，无需在对话中重新选择。

## 安装与启动

### 方式一：从 WorkBuddy 应用市场使用（推荐）

1. 打开 WorkBuddy 桌面端左侧「专家·技能·连接器」，进入顶部「专家」页面，并在下方选择「专家」。
2. 在右上角搜索框输入 `superun`，找到「superun iOS开发专家」，核对介绍中的目标平台为 iOS。
3. 点击专家卡片查看介绍，再点击详情中的「召唤」。
4. 进入「新建任务」后，确认已选中「superun iOS开发专家」。将预填示例替换为自己的 App 需求；已有项目时提供真实的 superun 项目链接或编号，按需选择工作空间、添加截图等参考资料，然后发送。后续在同一个任务中回答需求问题、确认适配规划，并查看上线与打包结果。

> [!NOTE]
>
> 市场条目会受上架状态、账号及组织可见范围影响。搜索结果中暂未出现该专家时，使用下面的完整 ZIP 安装方式；安装完成后，在「专家·技能·连接器 → 专家 → 我的专家」中找到「superun iOS开发专家」，再召唤使用。

### 方式二：通过对话安装或更新

[下载专家 ZIP](https://www.superun.com/web-api/packages/superun-ios-expert/workbuddy/expert/download) · [查看当前版本](https://www.superun.com/web-api/packages/superun-ios-expert/workbuddy/expert/latest)

复制下面整段内容发送给 WorkBuddy，新装和更新都使用这一段：

```text theme={null}
请使用 WorkBuddy 内置 expert-manager 安装或更新 superun iOS开发专家。
版本信息：https://www.superun.com/web-api/packages/superun-ios-expert/workbuddy/expert/latest
下载入口：https://www.superun.com/web-api/packages/superun-ios-expert/workbuddy/expert/download
重新查询本次版本，确认专家包为 0.1.2 或更高版本，使用 version.downloadUrl 下载完整 ZIP，核对 SHA-256 和字节大小；没有合适版本或校验失败时停止，不安装旧包。
在临时目录完整解压并保留隐藏文件，只安装或替换 superun-ios-expert，完成官方校验、注册，并清理本专家的旧缓存，不修改其他专家。
回读实际安装版本和入口，确认后告诉我如何开始使用。
```

安装后新建任务，确认已选中「superun iOS开发专家」再发送需求。

> [!NOTE]
>
> 请使用 **0.1.2 或更高版本的本平台专家包**，三个专家的名称分别为「superun 安卓开发专家」「superun 鸿蒙开发专家」「superun iOS开发专家」。若提示名称超过 15 字，请重新下载新版安装，不要继续使用旧 ZIP。下载入口尚无可用版本时，请等待对应包发布；手机安装包会在项目打包完成后另行交付。

首次运行按提示准备 Node.js 22 或更高版本、npm 和 superun CLI，并在系统浏览器登录自己的 superun 账号。后续使用云端流程，生成与资源费用以实际提示为准；登录或等待中断时返回原任务继续。

## 可以这样开始

已有项目时，先提供真实的 superun 项目链接或编号，再发送：

```text theme={null}
把我的 CRM 系统打包成一个iOS App，方便我在手机上使用。请先展示实际适配规划，等我确认后执行修复，上线后再选择包类型。
```

新建 App：

```text theme={null}
帮我做一个 iOS 记账 App，可以记录收支并按月份查看统计，最后生成能安装到 iPhone 上的体验包。
```

## 从需求到手机安装包

流程为：**本轮选中功能完成 → 自动咨询适配 → 查看规划并确认执行 → 适配完成 → 上线运营 → 选择体验包或正式包 → 配置并打包**。

1. **明确项目与需求**：新想法从需求澄清和方案选择开始；已有 superun 项目提供链接或编号，沿原项目继续。
2. **本轮研发完成后自动咨询**：本轮已选功能全部完成后，专家会先告知，再自动检查 App 适配并整理规划。未选中的候选功能可以留到以后，不必先实现整份功能清单。
3. **查看规划并确认执行**：完整查看适配内容与步骤，选择「确认执行」后才开始修复。需要补充时选择「继续咨询」，讨论后的新规划需重新确认。
4. **适配完成后选择下一步**：专家展示结果，提供「上线并打包 / 继续研发」。继续研发沿原项目进行；选择上线时，按实际提示核对费用、公开影响并完成发布。
5. **上线成功后再选包类型**：只有当前版本上线运营成功后才能打包。专家会询问「生成体验包 / 生成正式包」，并让你确认或修改应用名称、图标和本平台应用 ID。
6. **补齐配置并生成**：已有配置直接复用，缺少的账号、签名或手机按提示补齐。完成后交付本次真实安装入口或正式包上传结果。

> [!NOTE]
>
> 适配规划确认和上线运营都是打包前置条件。应用 ID 用于识别同一款 App，更改后无法覆盖安装旧包，请在正式发布前确认。

## iOS 打包前需要准备什么

体验包和正式包都需要你自己的 Apple 开发者账号。按 [Apple Developer Program 官方指引](https://developer.apple.com/programs/enroll/)办理会员，费用及适用条件以 Apple 实际提示为准。

1. 在 [App Store Connect](https://appstoreconnect.apple.com/access/integrations/api) 的「用户和访问 → 集成 → 团队密钥」中，按 superun 连接指引准备 **Admin** 权限的团队密钥、Issuer ID、Key ID 和原始 `.p8` 文件；App 内购买密钥不能替代。
2. 前往 [superun.ai](https://superun.ai) 下载或打开 superun 桌面端，用同一账号打开同一项目的 iOS 打包设置并连接账号。
3. 生成体验包时，使用 **Mac 版 superun** 连接测试 iPhone，解锁并信任电脑，再在测试手机列表中勾选并保存本次手机。已有登记手机可以直接选择。
4. 返回专家，选择「已完成，重新检查」，检查通过后继续。新增测试手机后，需要重新生成体验包。

首次手机绑定在 superun 桌面端完成，不在 WorkBuddy、豆包或 Qoder 中连接 USB 代办。原始 `.p8` 文件只在账号连接界面导入，不要把私钥内容粘贴到聊天中。

| 包类型 | 安装或分发 |
| - | - |
| 体验包 | 仅本次已选 iPhone 可安装，用 Safari 打开安装页 |
| 正式包 | 准备与当前 Bundle ID 对应的 App Store Connect 应用；取得本次上传许可后自动上传，后续仍需完成 TestFlight 分发或商店上架 |

## 第一次生成正式包

尚未生成过本平台体验包时，专家会引导先体验。选择「先生成体验包」后，先在手机检查功能和效果，再选择「体验无误，继续正式包」；有问题则选择「先修复问题」。

这个体验步骤不会取消原来的正式包需求。修复影响源码时，按更新后的内容完成必要适配和上线，再继续正式包。

## 打包完成后会收到什么

体验包成功后返回名称、版本、二维码和安装页，用已选 iPhone 在 Safari 中打开。正式包返回实际上传状态和 App Store Connect 入口；没有真实 TestFlight 邀请链接时，不会生成体验二维码。

下载手机安装包统一使用安装页中的按钮，不需要单独获取包文件直链。生成成功不代表已经在你的手机上验证安装成功。

正式包上传成功也不代表审核通过、商店已上架或测试邀请已经就绪，仍需在对应平台完成后续分发。

## 历史包、备案与继续开发

交付完成后，可以选择「查看历史包 / 查看备案信息 / 继续开发」，也可以直接说明要调整的内容。

* **历史包**：查看当前项目、本平台返回的最近记录，选择成功版本重新获取安装入口；返回范围不代表全部历史。
* **备案信息**：查看正式版本对应的实际备案资料。仅有体验包或资料尚未就绪时，专家会说明缺项；资料可查不代表备案已经通过。
* **继续开发**：沿原项目提交新需求，新一轮选中功能完成后再按适配、上线与打包流程更新 App。

出现失败时，专家会说明实际原因，并在可重试时提供「重试本步 / 稍后处理」。任务仍在运行时继续等待原任务；正式包上传失败时复用原包重试上传，不为此重新打包。

同一专家的其他客户端入口：[豆包工作](https://docs.superun.com/superun/third-party-apps/doubao/skills/ios-expert.md) · [Qoder](https://docs.superun.com/superun/third-party-apps/qoder/plugins/ios-expert.md)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.