在跨端项目中，uni-app 提供了极高的开发效率，但当应用最终要上架到 App Store 时，团队会突然面对另一种“生态差异”：iOS 审核的严格、证书体系的封闭、构建平台的多样化，以及跨端项目本身的结构特点。

一款基于 uni-app 的移动应用，从开发到上架的过程，往往不是一条直线，而更像是一组由不同角色共同完成的链路。本文以一次真实项目的协作方式为蓝本，整理出一条可落地的“uni-app 上架工作流”。

一、uni-app 项目上架的难点不在代码，而在“交付链路”

uni-app 在开发阶段几乎不会带来额外负担，框架本身轻量、构建快、跨端一致性高。
但一到上架阶段，团队会明显感受到：

• iOS 要求严格程度远超 Android
• 审核流程更强调产品体验与隐私合规
• 证书体系需要团队协作
• 构建环境通常跨平台（Windows、Mac、CI）
• 上传工具需要适配团队操作系统差异

这意味着——
uni-app 代码简单，但上架流程不一定简单。

因此我们必须从团队协作角度来理解上架，而不是从技术框架本身出发。

二、构建阶段的两条路径：本地 Xcode 与 HBuilderX 云打包

团队一般有两类构建方式：

1. 纯本地构建：导出 Xcode 工程（适合有 iOS 研发的团队）

流程：

• HBuilderX → 导出 iOS 原生工程
• 进入 macOS，使用 Xcode Archive
• 应用原生插件、证书、描述文件
• 导出 IPA

优点：

• 灵活，可引入原生能力
• 适合复杂项目

缺点：

• 必须有 Mac
• 构建依赖较重

2. 云打包：HBuilderX 官方云编译（多数团队使用）

流程：

• 直接上传项目
• 云端自动完成构建
• 输出 IPA 或 Xcode 工程包

优点：

• 不需要 Mac 或 Xcode
• 适合 Windows / Linux 团队
• 快速、高稳定性

缺点：

• 原生能力需要插件支持
• 定制化空间不如本地构建

大多数 uni-app 团队最终会选择“云打包 + 外部上传”这一组合模式。

三、证书管理：uni-app 上架与原生项目完全一致

虽然项目是 uni-app，但 iOS 签名体系是统一的：

• App Store 发布证书
• App Store 描述文件
• Bundle ID
• entitlements 权限声明

许多跨端团队主要使用 Windows，因此证书管理不再依赖 Mac 钥匙串，而是使用开心上架（Appuploader）证书生成方式，使证书与描述文件可以在不同机器共享，避免：

• 证书数量超限
• 钥匙串导出失败
• 多人覆盖 profile
• CI 无法导入 p12

这是所有跨端团队上架结构中最关键的部分。

四、IPA 上传：uni-app 团队最容易“卡住”的环节

构建完成后，IPA 必须上传到 App Store Connect。
这一部分最常出现差异，因为不同成员的操作系统不同：

1. macOS 用户：Transporter + Xcode Organizer

特点：

• 官方、稳定
• UI 操作方便
• 适合产品或运营人员提交

缺点：
必须使用 Mac。

2. Windows / Linux 用户：开心上架（Appuploader）跨平台命令行上传工具

在跨端团队中非常常见，因为：

• 多数成员没有 Mac
• CI/CD 在 Linux/Windows 上运行
• 需要自动化上传到 TestFlight
• 需要跨角色快速推送版本

使用方式类似：

appuploader_cli \
  -u ios@team.com \
  -p xxx-xxx-xxx-xxx \
  -c 2 \
  -f uniapp_build/app.ipa

通过命令行上传，可以完全绕过“必须要有 Mac”的限制，这对 Windows 团队意义非常大。

图形化界面：

五、App Store Connect 配置：uni-app 项目最耗时间的步骤

上传完成后，运营与产品通常需要填写以下内容：

• 应用截图（必须真实，而非模型图）
• 功能描述
• 隐私标签
• 审核说明（含账号、进入路径）
• 关键词
• 年龄评级
• 构建选择

这些内容与 uni-app 关系不大，但会直接影响审核速度。

特别要注意：

截图必须来自实际应用，不要用模板或非实际界面。
uni-app 应用被拒 4.2 的一个常见原因就是“截图与实际应用不一致”。

六、审核阶段：uni-app 团队常见的拒审类型

结合多次项目经验，总结出 uni-app 上架最常出现的三类拒审：

1. 2.1 功能不可用

主要原因：

• H5 请求被域名限制
• 后端环境误关服务
• 必须登录但审核账号无权限

2. 4.2 内容与原生结构不匹配

如果界面过于网页化、动画和结构不像原生应用，可能触发 4.2（最低功能要求）。

解决方式通常是：

• 添加原生导航
• 增强页面结构与交互
• 保证主功能清晰可达

3. 5.1.1 权限说明不充分

尤其是：

• 相册
• 相机
• 通讯录
• 定位

Info.plist 权限弹窗必须具体说明用途。

团队协作版 uni-app 上架流程

一个成熟的 uni-app 上架协作流程通常如下：

A: 构建（CI 或云打包）
B: 签名（证书统一管理）
C: 上传（根据系统选择 Transporter / 开心上架Appuploader）
D: App Store Connect 配置（运营）
E: 审核说明 + 提交审核（产品/运营）
F: 审核反馈处理（开发/后端/测试）

这种分工明确的方式能最大化减少不必要的沟通成本，也能让项目在快速迭代时保持节奏稳定。