3.0 KiB
3.0 KiB
🚀 快速开始 - iOS 12/13 兼容性修复
✅ 代码修复已完成
所有代码已经修复完成,现在只需要在 Xcode 中做一些配置即可。
⚡ 3 步完成配置
步骤 1: 修改 Deployment Target(5 分钟)
-
打开项目:
open PlayBTopOn.xcworkspace -
在 Xcode 中:
- 左侧选择项目
PlayBTopOn - 选择
PROJECT→PlayBTopOn Build Settings→ 搜索 "Deployment"iOS Deployment Target改为 12.0
- 左侧选择项目
-
同样地,配置 TARGETS:
- 选择
TARGETS→PlayBTopOn General→Deployment InfoiOS Deployment Target改为 12.0
- 选择
步骤 2: 设置 AppTrackingTransparency 为弱链接(2 分钟)
-
在 Xcode 中:
- 选择
TARGETS→PlayBTopOn - 点击
Build Phases标签 - 展开
Link Binary With Libraries
- 选择
-
找到或添加
AppTrackingTransparency.framework:- 如果没有,点击
+添加 - 将 Status 从
Required改为Optional
- 如果没有,点击
步骤 3: 重新编译(3 分钟)
# 1. 进入项目目录
cd /Users/mac/workspaces/projects/ios/build-ipa/ironSource/PlayBTopOn
# 2. 重新安装 Pods
pod install
# 3. 在 Xcode 中清理并编译
# Product → Clean Build Folder (Cmd+Shift+K)
# Product → Build (Cmd+B)
# Product → Run (Cmd+R)
🎯 验证成功的标志
运行应用后,在控制台应该看到:
XS- app start: xxx
XS- BbbAdManager init 开始
XS- BbbAdManager init 完成
XS- init config ← 看到这个说明成功了!
XS- init config 1
XS- init config 2
XS- init config 3
❌ 常见错误
错误 1: 应用启动即崩溃,没有任何日志
原因: Deployment Target 还是 17.4
解决: 按照步骤 1 修改为 12.0
错误 2: 编译报错找不到 AppTrackingTransparency
原因: 框架未设置为 Optional
解决: 按照步骤 2 设置为 Optional
错误 3: 运行到 "XS- 开始创建 BbbAdManager.shared" 就崩溃
原因: 代码未更新(CheckedContinuation 问题)
解决: 确保已接受所有代码更改
📋 检查清单
- ✅ Deployment Target 改为 12.0(PROJECT 和 TARGET 都要改)
- ✅ AppTrackingTransparency 设为 Optional
- ✅ 运行
pod install - ✅ Clean Build Folder
- ✅ 编译成功
- ✅ 运行成功,看到 "XS- init config" 日志
🆘 需要帮助?
如果遇到问题,查看详细文档:
| 问题类型 | 查看文档 |
|---|---|
| 崩溃定位 | DEBUG_CRASH_GUIDE.md |
| 关键修复说明 | CRITICAL_FIX.md |
| 完整配置指南 | iOS12_COMPATIBILITY_GUIDE.md |
| 所有修改记录 | CHANGES_SUMMARY.md |
🎉 完成!
配置完成后,你的应用就可以在 iOS 12、13、14、15、16、17 上运行了!
最后更新: 2025-01-01
预计配置时间: 10 分钟
难度: ⭐⭐ (简单)