iOS 多 Target 打包、UAT/生产测试与上架 App Store 全流程指南

一、前置环境准备

1. 软硬件版本要求

MacOS 系统：更新至最新正式版本
Xcode：更新 App Store 内最新稳定版本

2. 项目代码仓库

Git 仓库地址：内部私有 Git 地址本地项目根目录示例：~/Developer/app/项目根目录

3. Xcode 工程打开路径

工程相对路径：app/项目目录/mobile/swift/Apps/CPMS

二、本地模拟器调试流程

使用 Xcode 打开 CPMS 工程文件
Target 选择：CPMS-Team（UAT 测试环境）
模拟器设备选择：iPhone 17
点击左上角运行按钮编译启动 App
核心功能自测流程
- 新建测试账号完成注册
- 添加充电桩设备
- 校验定时任务相关逻辑

三、版本号升级修改步骤

Xcode 左侧选中项目根节点 CPMS
右侧切换对应环境 Target：
- CPMS-Team：UAT 测试环境
- CPMS-EU：欧洲正式环境
- CPMS-SG：新加坡正式环境
- CPMS-ME：中东正式环境
进入「Build Settings」→「Versioning」分类
修改 Marketing Version 版本号，根据迭代需求递增（示例：1.2.2）

四、证书与描述文件管理规范

1. 证书管理后台地址

苹果开发者后台证书管理页：https://developer.apple.com/account/resources/profiles/list

2. 证书维护要求

定期查看证书有效期，防止打包签名失败
证书过期时登录开发者后台重新生成、更新配置文件

3. Xcode 证书配置

Xcode 开启自动管理证书，无需手动导入配置文件。

五、TestFlight 打包脚本操作（Makefile）

1. 打包前置通用命令

终端切换至项目根目录，依次执行：

bash

复制代码

# 安装打包所需工具依赖
make install-tools
# 导入签名证书配置
make install-certs
# 指定系统默认Xcode路径，执行后输入电脑开机密码（输入无显示，输完回车）
sudo xcode-select -s /Applications/Xcode.app/Contents/Developer

2. UAT 测试环境打包

打包脚本：

bash

复制代码

make testflight-cpms-team

UAT TestFlight 后台：苹果开发者后台对应团队测试页面

3. 各区域正式环境灰度测试包

bash

复制代码

# 新加坡环境测试包
make testflight-cpms-sg
# 中东环境测试包
make testflight-cpms-me
# 欧洲环境测试包
make testflight-cpms-eu

六、App Store 正式上架流程

各区域 TestFlight 内测版本全量测试通过后，执行正式发布
上架后台入口：App Store Connect 对应应用分发页面
操作步骤：页面切换至「分发」标签页，根据页面指引完成版本提交、审核、上线操作

七、文档说明

本文档覆盖 iOS 客户端本地调试、TestFlight 灰度打包、AppStore 正式发布完整流程
打包逻辑由项目根目录 Makefile 统一封装，不同环境通过 Target + make 命令区分
MacOS、Xcode 版本、有效签名证书为打包硬性前置条件，版本过低 / 证书失效会引发编译、签名报错