iOS 构建配置与 AdHoc 打包说明

1. 背景

在 iOS 项目中，通常需要支持 多个环境的构建和分发，比如：

• 开发环境 (Debug) → 本地调试
• 内测环境 (AdHoc) → 提供 QA / 产品经理测试
• 预发布环境 (AdHoc_Release) → 和正式版配置一致，但通过 AdHoc 分发
• 正式环境 (Release) → 上架 App Store

为了方便 CI/CD 和团队协作，我们在项目中自定义了 AdHoc 和 AdHoc_Release 配置。

---

2. 各构建配置的区别

配置名称	用途	证书/Provisioning Profile	典型分发方式	日志 & 调试	优化
Debug	本地开发调试	开发证书 (Development)	Xcode 直接运行	✅ 开启日志	无优化
AdHoc	内测分发	AdHoc 证书	绑定 UDID，蒲公英/企业分发	✅ 可保留少量日志	接近 Release
AdHoc_Release	预发布（灰度）	AdHoc 证书	绑定 UDID，蒲公英	❌ 关闭日志	与 Release 相同
Release	正式上架 App Store	App Store 发行证书	App Store	❌ 关闭日志	最大优化

---

3. Xcode Archive 默认使用哪个配置？

• 默认情况下，Product → Archive 使用 当前 Scheme 的 Archive 配置
• 通常是 Release，可以在
  Product → Scheme → Edit Scheme → Archive → Build Configuration
  修改为 AdHoc 或 AdHoc_Release

命令行可直接指定：

xcodebuild archive \-workspace MyApp.xcworkspace \-scheme MyApp \-configuration AdHoc \-archivePath build/MyApp-AdHoc.xcarchive

AdHoc 包的特殊要求和实现方案

为了方便测试人员区分 内测包 和 正式包，我们为 AdHoc 包添加 带“开发”角标的 App Icon。

---

✅ 实现方案

1. 在项目中添加两个 AppIcon 集合

• AppIcon → 正式版 icon
• AppIcon-Dev → 内测版 icon（在 icon 上加“开发”水印/角标）

Xcode 中结构示例：
Assets.xcassets/
├── AppIcon.appiconset # 正式版
└── AppIcon-Dev.appiconset # 内测版（带开发角标）
AppIcon-Dev 里的每个 PNG 带有角标，比如右上角写“开发版”。

---

2. 在 Build Settings 中区分配置使用的 Icon 名称

1. 进入 TARGETS → Build Settings → Packaging → Asset Catalog App Icon Set Name
2. 为不同的构建配置指定不同的 icon 集合：

• Release → AppIcon
• AdHoc / Debug → AppIcon-Dev

可以用 .xcconfig 管理，示例：

// Debug.xcconfig & AdHoc.xcconfig
ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon-Dev// Release.xcconfig & AdHoc_Release.xcconfig
ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon

3. 在 Scheme 或 CI/CD 里指定配置
   • 内测分发（AdHoc）

	xcodebuild archive \-scheme MyApp \-configuration AdHoc \-archivePath build/MyApp-AdHoc.xcarchive

生成的 IPA 会自动使用 AppIcon-Dev

•	正式发布（Release）

	xcodebuild archive \-scheme MyApp \-configuration Release \-archivePath build/MyApp-Release.xcarchive

✅ 最终效果
• AdHoc 内测包
• 安装后桌面 icon 右上角有 “开发”标识
• 方便测试人员快速区分内测和正式版
• Release 正式包
• 使用正常 icon，无任何角标