build-ipa/ironSource/PlayBTopOn/QUICK_START.md
2026-01-05 10:40:05 +08:00

3.0 KiB
Raw Blame History

🚀 快速开始 - iOS 12/13 兼容性修复

代码修复已完成

所有代码已经修复完成,现在只需要在 Xcode 中做一些配置即可。

3 步完成配置

步骤 1: 修改 Deployment Target5 分钟)

  1. 打开项目:

    open PlayBTopOn.xcworkspace
    
  2. 在 Xcode 中:

    • 左侧选择项目 PlayBTopOn
    • 选择 PROJECTPlayBTopOn
    • Build Settings → 搜索 "Deployment"
    • iOS Deployment Target 改为 12.0
  3. 同样地,配置 TARGETS

    • 选择 TARGETSPlayBTopOn
    • GeneralDeployment Info
    • iOS Deployment Target 改为 12.0

步骤 2: 设置 AppTrackingTransparency 为弱链接2 分钟)

  1. 在 Xcode 中:

    • 选择 TARGETSPlayBTopOn
    • 点击 Build Phases 标签
    • 展开 Link Binary With Libraries
  2. 找到或添加 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.0PROJECT 和 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 分钟
难度: (简单)