2026-01-05 10:40:05 +08:00

4.6 KiB

Raw Blame History

iOS 12/13 兼容性配置指南

问题说明

在 iOS 12/13 系统上，如果应用使用了 AppTrackingTransparency 框架（iOS 14+ 才有），即使代码中有 @available(iOS 14, *) 检查，应用启动时也会因为找不到该框架而直接崩溃。

已完成的代码修复

✅ 移除了所有 Task { await ... } 代码，改用 DispatchQueue 和回调 ✅ 使用 #if canImport(AppTrackingTransparency) 条件编译 ✅ 所有 async/await 代码都标记了 @available(iOS 15.0, *)

需要在 Xcode 中手动配置的步骤

⚠️ 重要：将 AppTrackingTransparency 设置为弱链接

打开 Xcode 项目
- 打开 PlayBTopOn.xcworkspace
进入项目设置
- 在左侧项目导航栏中，点击项目根节点 PlayBTopOn
- 选择 TARGETS -> PlayBTopOn
配置弱链接
- 选择 Build Phases 标签
- 展开 Link Binary With Libraries
- 找到或添加 AppTrackingTransparency.framework
- 将右侧的 Status 列从 Required 改为 Optional
如果列表中没有 AppTrackingTransparency.framework：
- 点击 + 按钮
- 搜索 AppTrackingTransparency.framework
- 添加后，将其状态设置为 Optional
验证设置
- 确保 AppTrackingTransparency.framework 的状态显示为 Optional
- 这样在 iOS 12/13 上，即使框架不存在，应用也不会崩溃

检查部署目标

设置最低支持版本
- 在 TARGETS -> PlayBTopOn -> General 标签
- 找到 Deployment Info 部分
- 将 iOS Deployment Target 设置为 iOS 12.0
检查 Podfile
- 打开项目根目录的 Podfile
- 确保第一行包含：platform :ios, '12.0'
- 如果修改了，运行 pod install

可选：添加 NSUserTrackingUsageDescription（如果需要在 iOS 14+ 上请求 IDFA）

如果你计划在 iOS 14+ 上请求用户授权追踪，需要在 Info.plist 中添加说明：

<key>NSUserTrackingUsageDescription</key>
<string>我们需要获取您的广告标识符以提供个性化广告体验</string>

测试验证

在 iOS 12/13 设备或模拟器上测试

选择 iOS 12 或 iOS 13 的模拟器
清理项目：Product -> Clean Build Folder (Cmd+Shift+K)
编译运行：Product -> Run (Cmd+R)
检查控制台日志，确保没有崩溃

在 iOS 14+ 设备上测试

选择 iOS 14+ 的模拟器或真机
运行应用，ATT 功能应该正常工作
检查是否能正常请求广告追踪权限

代码修改总结

1. AppDelegate.swift

❌ 移除：Task { await BbbAdManager.shared.initAd() }
✅ 替换：DispatchQueue.global(qos: .userInitiated).async { BbbAdManager.shared.initAd() }

2. YL_PlayVC.swift

❌ 移除：Task { await BbbAdManager.shared.waitForSDKInitialization() ... }
✅ 替换：BbbAdManager.shared.waitForSDKInitialization { ... }

3. bbbAdManager.swift

✅ 添加：基于回调的 initAd(completion:) 方法
✅ 添加：基于回调的 waitForSDKInitialization(completion:) 方法
✅ 保留：async/await 版本（标记 @available(iOS 15.0, *)）

4. idfa.swift

✅ 使用：#if canImport(AppTrackingTransparency) 条件编译
✅ 移除：文件顶部的无条件 import AppTrackingTransparency

5. YL_NetWorkManager.swift

✅ 使用：#if canImport(AppTrackingTransparency) 条件编译
✅ 保护：所有使用 ATTrackingManager 的代码

兼容性保证

iOS 版本	支持状态	说明
iOS 12.x	✅ 完全支持	使用旧版 IDFA API
iOS 13.x	✅ 完全支持	使用旧版 IDFA API
iOS 14.x	✅ 完全支持	使用 ATT 框架
iOS 15+	✅ 完全支持	支持 async/await + ATT

常见问题

Q: 为什么需要设置为 Optional？

A: 因为 AppTrackingTransparency.framework 在 iOS 14 才引入，iOS 12/13 系统中不存在这个框架。设置为 Optional 后，系统会在运行时动态加载，如果不存在也不会崩溃。

Q: 代码中的 `#if canImport()` 是什么？

A: 这是编译时检查，确保只在可以导入该框架的环境下才编译相关代码。

Q: 如果忘记设置 Optional 会怎样？

A: 应用会在 iOS 12/13 启动时立即崩溃，错误信息类似于 "dyld: Library not loaded: /System/Library/Frameworks/AppTrackingTransparency.framework"

编译和发布

编译通过后，可以正常打包发布：

Archive: Product -> Archive
导出 IPA 进行分发测试
确保在不同 iOS 版本上都进行了测试

修复完成时间: 2025-01-01 最低支持版本: iOS 12.0 推荐测试版本: iOS 12.5, iOS 13.7, iOS 14.8, iOS 15.0+

4.6 KiB Raw Blame History Unescape Escape