企业官网建设流程全解析

做 React Native 开发的团队，大部分用 Mac 做 iOS 编译和上架。但有一种场景越来越常见——CI/CD 流水线跑在 Linux 服务器上，或者团队里的前端开发用 Linux 作为主力系统。React Native 项目在 Linux 上可以写代码、可以跑 Metro 开发服务器，甚至可以打包 Android APK，但到了 iOS 这步就卡住了——IPA 文件已经在远程 Mac 上编译好了，怎么在 Linux 上把它上传到 App Store，而不需要把上传操作也绑定到 Mac 环境？

React Native 的 iOS 构建流程

React Native 项目的 iOS 端构建依赖 Xcode 环境。通常的做法是：在 Mac 上执行npx react-native run-ios或通过 Fastlane 打包。如果团队只有一台 Mac 用作编译机，RN 开发者可以在本地写 React 代码，提交后由 CI 拉取代码在 Mac 上编译和上传。

但对于 Linux 开发者来说，如果不想把上传操作也绑定到 Mac 上，可以从 IPA 文件上传这个环节做拆分——编译交给 Mac 或者云编译服务，上传这一步用跨平台工具在 Linux 上完成。

Appuploader 在 Linux 上的上传方案

Appuploader 提供桌面端和命令行版本，均支持 Linux 系统。桌面端可以在 Linux 上通过 wine 或直接运行（如果提供原生 Linux 版本），命令行版本则可以直接集成到 Bash 脚本中。

Appuploader 的桌面端在提交上传界面选择 IPA 文件、上传通道和 Apple 账号专用密码，点击上传。提供多条上传通道，网络不好时可以切换。上传成功后构建版本会出现在 App Store Connect 上，选择构建版本后提交审核即可。

命令行版本更适合集成到 React Native 项目的 CI/CD 流水线中。命令格式：appuploader_cli --upload-app -f Payload.ipa -u user@example.com -p xxxx-xxxx-xxxx-xxxx --type ios。只需要指定 IPA 文件路径、Apple 账号和专用密码，不需要图形界面。

在 Linux CI 上执行的完整流程建议：通过 GitHub Actions 或 GitLab CI 在 Mac runner 上编译 IPA → 将 IPA 产物传输到 Linux runner → 在 Linux runner 上调用 Appuploader 命令行上传 IPA。这样 CI 的流水线中，编译和上传两个环节可以解耦——编译依赖 Mac 是硬性限制，但上传不需要绑定 Mac 环境。Linux runner 的成本通常比 Mac runner 低不少，把上传操作移到 Linux 上也能节省一些 CI 开销。

上传前的准备

不管用哪种方式，上传 IPA 前需要确认几件事。IPA 必须用发布证书签名，开发证书的 IPA 无法提交上架。Apple 开发者账号需要开通双因素认证，并生成 App 专用密码（在 Apple ID 页面的"安全"→"App 专用密码"里创建）。上传专用密码和登录密码不同，至少记一次。Bundle ID 需要和 App Store Connect 里创建的应用完全一致，不一致会提示"No suitable application records were found"。

上传后的操作

上传完成后回到 App Store Connect，选择构建版本、填写审核信息。如果构建版本没有立刻出现，等几分钟再刷新。始终不出现的话检查版本号是否重复或网络上传通道是否正常。