一、前置环境准备1. 软硬件版本要求MacOS 系统更新至最新正式版本Xcode更新 App Store 内最新稳定版本2. 项目代码仓库Git 仓库地址内部私有 Git 地址 本地项目根目录示例~/Developer/app/项目根目录3. Xcode 工程打开路径工程相对路径app/项目目录/mobile/swift/Apps/CPMS二、本地模拟器调试流程使用 Xcode 打开 CPMS 工程文件Target 选择CPMS-TeamUAT 测试环境模拟器设备选择iPhone 17点击左上角运行按钮编译启动 App核心功能自测流程新建测试账号完成注册添加充电桩设备校验定时任务相关逻辑三、版本号升级修改步骤Xcode 左侧选中项目根节点CPMS右侧切换对应环境 TargetCPMS-TeamUAT 测试环境CPMS-EU欧洲正式环境CPMS-SG新加坡正式环境CPMS-ME中东正式环境进入「Build Settings」→「Versioning」分类修改Marketing Version版本号根据迭代需求递增示例1.2.2四、证书与描述文件管理规范1. 证书管理后台地址苹果开发者后台证书管理页https://developer.apple.com/account/resources/profiles/list2. 证书维护要求定期查看证书有效期防止打包签名失败证书过期时登录开发者后台重新生成、更新配置文件3. Xcode 证书配置Xcode 开启自动管理证书无需手动导入配置文件。五、TestFlight 打包脚本操作Makefile1. 打包前置通用命令终端切换至项目根目录依次执行bash# 安装打包所需工具依赖 make install-tools # 导入签名证书配置 make install-certs # 指定系统默认Xcode路径执行后输入电脑开机密码输入无显示输完回车 sudo xcode-select -s /Applications/Xcode.app/Contents/Developer2. UAT 测试环境打包打包脚本bashmake 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 版本、有效签名证书为打包硬性前置条件版本过低 / 证书失效会引发编译、签名报错
