# 🚀 快速开始 - 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 分钟  
**难度：** ⭐⭐ (简单)