> ## 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.

# 安卓开发专家

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

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

## 本地安装与启动

先安装[豆包工作桌面端](https://www.doubao.com/work)，使用本页的豆包 **Skill** 包。

[下载技能 ZIP](https://www.superun.com/web-api/packages/superun-android-expert/doubao/skill/download) · [查看当前版本](https://www.superun.com/web-api/packages/superun-android-expert/doubao/skill/latest)

1. 下载本页的豆包工作版 ZIP，保留完整安装包，无需重新压缩。
2. 打开左侧「插件 · 技能 · 伙伴」，切换到顶部「技能」，点击「管理」查看个人技能。
3. 点击「添加 → 上传技能」，通过「选择文件」上传刚下载的 ZIP。部分版本可直接在技能页点击「添加 → 上传技能」。
4. 已有同名技能时，先保留自己的修改，再在该技能详情菜单中选择「替换」，上传完整新包；出现确认时核对技能名并选择「上传并替换」。
5. 回到个人技能列表，确认已添加 `superun-android-expert`，再按下方「首次运行」新建工作任务使用。

也可以解压 ZIP，通过「选择文件夹」选择包含 `SKILL.md` 的完整 `superun-android-expert` 文件夹。请保留脚本、引用和素材；单独上传 `SKILL.md` 会缺少执行所需资源。

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

### 首次运行

新建工作任务，选择「本地电脑」。在输入框输入 `/superun`，从候选中选择 `superun-android-expert` 对应技能，再补充自己的 App 需求；也可以直接说明「请使用 superun-android-expert」并给出具体任务。已有项目时提供真实的 superun 项目链接或编号，可以附上截图等参考资料。

按提示准备 Node.js 22 或更高版本、npm 和 superun CLI，在系统浏览器登录自己的 superun 账号并完成授权，再回到原任务继续。豆包工作与 superun 分别登录；生成与资源费用以实际提示为准。

如果没有出现技能，先在「技能 → 管理」中确认已导入，再新建本地电脑任务。切换豆包账号后，重新核对当前账号的技能列表；等待或登录中断后继续原任务。

## 可以这样开始

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

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

新建 App：

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

## 从需求到手机安装包

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

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

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

## 安卓打包前需要准备什么

| 包类型 | 准备内容 | 交付方式 |
| - | - | - |
| 体验包 | 确认应用信息，使用默认调试签名，无需配置正式签名或连接商店开发者账号 | 安装二维码和安装页 |
| 正式包 | 首次填写真实签名主体名称和两位国家代码；组织、部门、省市按需填写 | 正式签名包的安装二维码和安装页，不自动上传商店 |

首次正式打包由 superun 生成并保管签名证书，后续更新复用同一份签名。专家保存主体信息后会重新检查，不会仅凭你提供过信息就直接打包。

## 第一次生成正式包

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

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

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

成功后返回应用名称、版本、安装二维码和可点击的安装页。用安卓手机打开安装页，通过页面内的按钮下载安装；体验包和安卓正式包都使用这个入口。

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

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

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

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

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

同一专家的其他客户端入口：[WorkBuddy](https://docs.superun.com/superun/third-party-apps/workbuddy/experts/android-expert.md) · [Qoder](https://docs.superun.com/superun/third-party-apps/qoder/plugins/android-expert.md)。


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