> ## 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开发专家

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

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

## 安装与启动

本文使用 [Qoder 桌面端](https://qoder.com.cn/download)的 **插件** 入口，IDE 和 CLI 的界面需分别核对。

### 方式一：从 Qoder 扩展市场安装（推荐）

1. 打开 Qoder 桌面端左侧「扩展」，进入「插件」页面。
2. 在搜索框输入 `superun`，在结果中选择「superun iOS开发专家」。市场搜索使用 `superun` 和中文展示名核对，无需输入插件的技术标识。
3. 打开插件详情，核对名称、发布者及 iOS App 开发能力说明，再点击「安装」。
4. 在「已安装」中确认「superun iOS开发专家」已添加；如有启用提示，按提示启用。安装完成后，按下方「首次运行」选择主技能并发送需求。

> [!NOTE]
>
> 市场条目会受上架状态、账号及组织可见范围影响。找不到对应条目时，使用下面的完整 ZIP 导入方式；导入后同样从「已安装」确认插件，并按「首次运行」启动。

### 方式二：下载并导入 ZIP

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

1. 下载完整 ZIP，保留原包，在「扩展 → 插件 → 添加插件 → 上传 Plugin」中导入。
2. 在「已安装」中确认 `superun-ios-expert` 并按提示启用。更新使用同一导入入口，无需另装同名独立 Skill。

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

### 首次运行

两种安装方式都使用以下步骤启动：

1. 新建任务，在输入框输入 `/`，选择「superun iOS开发专家」对应的主技能。菜单中的主技能可能显示为 `superun-ios-expert:superun-ios-expert`，按实际菜单核对。
2. 补充自己的 App 需求；已有项目时提供真实的 superun 项目链接或编号，按需添加截图等参考资料，再发送。可以直接使用下方「可以这样开始」中的示例。
3. 按提示准备 Node.js 22 或更高版本、npm 和 superun CLI，在系统浏览器登录自己的 superun 账号并完成授权，再返回原任务继续。Qoder 登录与 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。

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

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


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