一、前置环境准备
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/Developer2. UAT 测试环境打包
打包脚本：
bash
make testflight-cpms-teamUAT 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 版本、有效签名证书为打包硬性前置条件，版本过低 / 证书失效会引发编译、签名报错