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

一、前置环境准备

1. 软硬件版本要求

  1. MacOS 系统:更新至最新正式版本
  2. Xcode:更新 App Store 内最新稳定版本

2. 项目代码仓库

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

3. Xcode 工程打开路径

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

二、本地模拟器调试流程

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

三、版本号升级修改步骤

  1. Xcode 左侧选中项目根节点 CPMS
  2. 右侧切换对应环境 Target:
    • CPMS-Team:UAT 测试环境
    • CPMS-EU:欧洲正式环境
    • CPMS-SG:新加坡正式环境
    • CPMS-ME:中东正式环境
  3. 进入「Build Settings」→「Versioning」分类
  4. 修改 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 正式上架流程

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

七、文档说明

  1. 本文档覆盖 iOS 客户端本地调试、TestFlight 灰度打包、AppStore 正式发布完整流程
  2. 打包逻辑由项目根目录 Makefile 统一封装,不同环境通过 Target + make 命令区分
  3. MacOS、Xcode 版本、有效签名证书为打包硬性前置条件,版本过低 / 证书失效会引发编译、签名报错
相关推荐
二流小码农2 小时前
鸿蒙开发:router组件升级,彻底告别手动配置
android·ios·harmonyos
茶底世界之下9 小时前
雾中山路的冷光层次:用 Awaking 留住红色背影
ios·app·产品
Digitally10 小时前
iPhone 如何添加日历?
ios·iphone
Gracker1 天前
100 Years Life:把体检、睡眠和运动放进同一份健康档案
ios
秋雨梧桐叶落莳1 天前
【iOS】Block底层详解
macos·ios·cocoa
茶底世界之下1 天前
舞台灯下的萨克斯:用 Awaking 让铜管从蓝幕前亮起来
ios·app·产品
传奇开心果编程1 天前
【Flutter踩坑排雷】第28课:平台目录缺失与修复坑|`flutter create` 的“重建”与“覆盖”边界
android·flutter·ios·移动开发·跨平台·dart·声明式ui
3095566661 天前
股票接口返回 404 与空数组的排查笔记:证书状态与级别参数
java·笔记·python·ios·iphone·股票数据api·股票数据接口
Geek-Chow2 天前
00 Apple Code Signing, In Depth — A Series
ios
传奇开心果编程3 天前
【Flutter踩坑排雷】第25课:ScrollController 误用坑|跳转失效、监听泄漏与“控制器未附加”
android·flutter·ios·移动开发·跨平台·dart·声明式ui