110 lines
3.0 KiB
Markdown
110 lines
3.0 KiB
Markdown
# 🚀 快速开始 - iOS 12/13 兼容性修复
|
||
|
||
## ✅ 代码修复已完成
|
||
|
||
所有代码已经修复完成，现在只需要在 Xcode 中做一些配置即可。
|
||
|
||
## ⚡ 3 步完成配置
|
||
|
||
### 步骤 1: 修改 Deployment Target（5 分钟）
|
||
|
||
1. 打开项目：
|
||
```bash
|
||
open PlayBTopOn.xcworkspace
|
||
```
|
||
|
||
2. 在 Xcode 中：
|
||
- 左侧选择项目 `PlayBTopOn`
|
||
- 选择 `PROJECT` → `PlayBTopOn`
|
||
- `Build Settings` → 搜索 "Deployment"
|
||
- `iOS Deployment Target` 改为 **12.0**
|
||
|
||
3. 同样地，配置 TARGETS：
|
||
- 选择 `TARGETS` → `PlayBTopOn`
|
||
- `General` → `Deployment Info`
|
||
- `iOS Deployment Target` 改为 **12.0**
|
||
|
||
### 步骤 2: 设置 AppTrackingTransparency 为弱链接（2 分钟）
|
||
|
||
1. 在 Xcode 中：
|
||
- 选择 `TARGETS` → `PlayBTopOn`
|
||
- 点击 `Build Phases` 标签
|
||
- 展开 `Link Binary With Libraries`
|
||
|
||
2. 找到或添加 `AppTrackingTransparency.framework`：
|
||
- 如果没有，点击 `+` 添加
|
||
- 将 Status 从 `Required` 改为 **`Optional`**
|
||
|
||
### 步骤 3: 重新编译（3 分钟）
|
||
|
||
```bash
|
||
# 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](./DEBUG_CRASH_GUIDE.md) |
|
||
| 关键修复说明 | [CRITICAL_FIX.md](./CRITICAL_FIX.md) |
|
||
| 完整配置指南 | [iOS12_COMPATIBILITY_GUIDE.md](./iOS12_COMPATIBILITY_GUIDE.md) |
|
||
| 所有修改记录 | [CHANGES_SUMMARY.md](./CHANGES_SUMMARY.md) |
|
||
|
||
## 🎉 完成！
|
||
|
||
配置完成后，你的应用就可以在 iOS 12、13、14、15、16、17 上运行了！
|
||
|
||
---
|
||
|
||
**最后更新：** 2025-01-01
|
||
**预计配置时间：** 10 分钟
|
||
**难度：** ⭐⭐ (简单)
|