你提到使用 Jenkins 通过 `xcodebuild` 命令行打包 iOS 应用，输出到 `${OM
ADA_IOS_BUILD}` 目录的包**永远是崩溃的**。我们来详细分析这个问题，并提供解决方案。
---
### 🔍 问题分析
你的命令如下：
```bash
xcodebuild \
-workspace ${IOS_WORKSPACE} \
-scheme ${IOS_SCHEME} \
-configuration Debug \
-sdk iphonesimulator \
-derivedDataPath ${OM
ADA_IOS_BUILD} \
build \
CODE_SIGN_IDENTITY="" CODE_SIGNING_REQUIRED=NO
```
#### ❌ 关键问题点：
1. **构建的是模拟器（iphonesimulator）包**
- 使用 `
-sdk iphonesimulator` 编译出的是 **仅能在 macOS 上运行的 iOS 模拟器应用**。
- 这种 `.app` 包 **无法在真机上运行**，如果尝试安装到物理设备上，一定会崩溃或直接无法安装。
2. **
Debug 配置 + 模拟器 = 不可用于发布/测试真机**
- Debug 配置通常包含调试符号、断言、性能优化关闭等，不适合分发。
- 更重要的是：**模拟器架构（如 x86_64 / arm64e
-simulator）与真机架构（arm64）不兼容**。
3. **生成的是中间产物，不是可发布的 `.ipa` 文件**
- 你只执行了 `build`，并没有导出 `.ipa` 安装包。
- 即使你在本地打开了 `.app`，它也依赖于 Xcode 的 DerivedData 环境和模拟器环境，脱离后容易崩溃。
4. **Jenkins 构建上下文可能缺少必要依赖**
- 如 CocoaPods、carthage、证书配置缺失（虽然你禁用了签名）、环境变量未设置等。
---
### ✅ 正确做法：构建可用于真机测试的 `.ipa` 包
如果你希望打出一个可以在 **真机上安装测试** 的包，请按以下方式修改命令：
#### ✅ 方案一：构建真机可用的
Ad Hoc 或 Development 包（推荐）
```bash
# 清理旧构建
rm
-rf ${OM
ADA_IOS_BUILD}
# 使用真机 SDK 和 Release 配置构建
xcodebuild \
-workspace ${IOS_WORKSPACE} \
-scheme ${IOS_SCHEME} \
-configuration Release \
-destination 'generic/platform=iOS' \
-archivePath ${OM
ADA_IOS_BUILD}/Archive.xcarchive \
CODE_SIGN_STYLE=Manual \
CODE_SIGN_IDENTITY="iPhone Developer" \
PROVISIONING_PROFILE_SPECIFIER="你的描述文件名称" \
clean archive
# 导出为 .ipa 文件
xcodebuild \
-exportArchive \
-archivePath ${OM
ADA_IOS_BUILD}/Archive.xcarchive \
-exportPath ${OM
ADA_IOS_BUILD} \
-exportOptionsPlist ${EXPORT_OPTIONS_PLIST}
```
> 注意：
>
- `${EXPORT_OPTIONS_PLIST}` 是一个 `.plist` 文件，指定导出类型（
ad-hoc, development, enterprise）。
>
- 示例 `ExportOptions.plist` 内容：
>
> ```xml
> <?xml version="1.0" encoding="UTF
-8"?>
> <!DOCTYPE plist PUBLIC "
-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList
-1.0.dtd">
> <plist version="1.0">
> <dict>
> <key>method</key>
> <string>development</string>
> <key>teamID</key>
> <string>YOUR_TEAM_ID</string>
> <key>compileBitcode</key>
> <false/>
> </dict>
> </plist>
> ```
---
#### ✅ 方案二：如果只是本地模拟器调试（不用于真机）
保留当前命令，但明确用途：**仅用于单元测试或 UI 测试在模拟器中运行**
```bash
xcodebuild \
-workspace ${IOS_WORKSPACE} \
-scheme ${IOS_SCHEME} \
-configuration Debug \
-sdk iphonesimulator \
-derivedDataPath ${OM
ADA_IOS_BUILD} \
build TEST_AFTER_BUILD=NO
```
但这不能“安装”到手机上！
---
### 🛠️ Jenkins 调试建议
1. **检查构建产物类型**
```bash
lipo
-info ${OM
ADA_IOS_BUILD}/Build/Products/
Debug-iphoneos/YourApp.app/YourApp
```
- 如果显示 `x86_64` 或 `i386` → 是模拟器包 ❌
- 正确应为 `arm64` ✅
2. **确认是否真的生成了 .ipa**
- 没有 `.ipa` 就说明没有走 `exportArchive` 步骤。
3. **查看 Xcode 版本一致性**
```bash
xcode
-select
-p
xcodebuild
-version
```
- Jenkins 所用 Xcode 是否与本地一致？
4. **日志输出增强**
添加 `
-verbose` 或重定向日志：
```bash
xcodebuild ... > build.log 2>&1
```
5. **权限 & Keychain 问题**
- Jenkins 启动的 agent 可能无法访问登录 keychain，导致签名失败。
- 解决方法：解锁 keychain
```bash
security unlock
-keychain
-p "your_password" ~/Library/Keychains/login.keychain
-db
```
---
### 💡 总结
| 问题 | 原因 | 解决方案 |
|
------|
------|
----------|
| 包崩溃 / 无法启动 | 构建的是模拟器包 | 改用 `
-destination 'generic/platform=iOS'` |
| 无法安装到真机 | 架构不支持 | 必须使用真机编译并签名 |
| 没有 `.ipa` | 只 build 没 export | 添加 `exportArchive` 步骤 |
| Jenkins 构建异常 | 环境差异 | 检查 Xcode、Keychain、权限 |
---
### ✅ 推荐完整 Jenkins Shell Script 示例
```bash
#!/bin/bash
set
-ex
WORKSPACE=${IOS_WORKSPACE}
SCHEME=${IOS_SCHEME}
BUILD_DIR=${OM
ADA_IOS_BUILD}
EXPORT_PLIST=${EXPORT_OPTIONS_PLIST:
-"./ExportOptions.plist"}
TEAM_ID="YOUR_TEAM_ID"
# 创建导出选项文件（若不存在）
if [ !
-f "$EXPORT_PLIST" ]; then
cat > $EXPORT_PLIST <<EOF
<?xml version="1.0" encoding="UTF
-8"?>
<!DOCTYPE plist PUBLIC "
-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList
-1.0.dtd">
<plist version="1.0">
<dict>
<key>method</key>
<string>development</string>
<key>teamID</key>
<string>${TEAM_ID}</string>
<key>compileBitcode</key>
<false/>
<key>stripSwiftSymbols</key>
<true/>
</dict>
</plist>
EOF
fi
# 清理构建目录
rm
-rf "${BUILD_DIR}"
mkdir
-p "${BUILD_DIR}"
# 归档
xcodebuild \
-workspace "${WORKSPACE}" \
-scheme "${SCHEME}" \
-configuration Release \
-destination 'generic/platform=iOS' \
-archivePath "${BUILD_DIR}/Archive.xcarchive" \
CODE_SIGN_STYLE=Manual \
CODE_SIGN_IDENTITY="iPhone Developer" \
PROVISIONING_PROFILE_SPECIFIER="Provisioning_Profile_Name_Here" \
clean archive \
| tee ${BUILD_DIR}/archive.log \
| xcpretty
-c || exit 1
# 导出 IPA
xcodebuild \
-exportArchive \
-archivePath "${BUILD_DIR}/Archive.xcarchive" \
-exportPath "${BUILD_DIR}" \
-exportOptionsPlist "${EXPORT_PLIST}" \
| tee ${BUILD_DIR}/export.log \
| xcpretty
-c || exit 1
echo "✅ 构建完成: ${BUILD_DIR}/${SCHEME}.ipa"
```
---
###
本文介绍了一系列针对Linux系统中网络问题的排查方法，包括检查IP地址设置、更新内核版本、查看系统版本信息、检查网络适配器驱动及重启无线网卡驱动等操作。
扫一扫
4万+
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
