IFLYADLib接入文档
打开文档导航

开始接入

广告形式

进阶与排错

资料与支持

本页目录

Manual 接入示例

此独立示例固定使用 SDK 6.5.1；仓库当前发布版本另见根 README。工程包含与本仓 CocoaPods Demo 对应的广告示例页面，应用 Bundle Identifier 独立，可以分别安装对比。示例源码是生成时的独立副本。

获取示例

使用 GitHub main 分支源码 ZIP，解压后进入 YTIFLYADLib_iOS-main/YTIFLYADLibManualSimple/。不要只下载本页、.xcodeproj 或准备脚本，工程依赖同目录源码与资源。也可以从终端获取：

git clone --branch main --single-branch https://github.com/LJMcarryu/YTIFLYADLib_iOS.git
cd YTIFLYADLib_iOS/YTIFLYADLibManualSimple

以下命令均在这个示例目录执行。已有仓库先确认使用最新 main，并检查本页声明的 SDK 版本；历史 Tag 的示例不会随 main 更新，6.5.1 Tag 内的独立示例仍固定 6.5.0。安装自己的 App 请按安装指南操作。

运行

先准备本地库，再打开共享 workspace（需要 Python 3）：

python3 准备SDK.py
open YTIFLYADLibManualSimple.xcworkspace

准备脚本按 sdk-artifacts.json 下载并校验固定版本的官方 XCFramework，放入 Vendor/。工程直接链接这些本地库，不使用 SwiftPM 或 CocoaPods，Xcode 构建过程不会联网下载库。Vendor/ 不提交 Git；已经准备好的副本可离线构建。也可以从清单中的官方链接自行下载 ZIP，再运行 python3 准备SDK.py --archive-dir /绝对路径/下载目录。本地库被修改时脚本会拒绝复用；确认需要重建后使用 --refresh。

工程按静态库方式链接 XCFramework（Do Not Embed）。资源随 GitHub 示例源码下载：同版资源和隐私清单已保存在 SDKResources/，准备SDK.py 只下载二进制，不下载 bundle。若该目录缺失，应重新下载完整 main 源码，不能只运行准备脚本。工程已配置 Copy Bundle Resources，不要从其他版本重复复制。不要修改隐私声明来规避系统限制。

在 Xcode 选择 YTIFLYADLibManualSimple scheme，再选择模拟器或真机。真机运行时设置自己的 Team 与 Bundle Identifier，替换源码 Supporting Files 中的广告位配置。示例 ID 不保证填充。工程最低声明 iOS 11.0，实际可用系统范围需结合所用 Xcode 与 SDK 验证。

App target 已配置 $(inherited) -ObjC、AdSupport.framework 和 Optional 的 AppTrackingTransparency.framework。请保留应用隐私流程与系统授权处理；构建通过不代表广告已成功加载或展示。

页面使用与各广告形式 API 见接入指南；本副本的源码目录仍为 YTIFLYADLibSimple/。日志或请求失败须按实际回调和系统日志定位。

构建检查

xcodebuild -workspace YTIFLYADLibManualSimple.xcworkspace \
  -scheme YTIFLYADLibManualSimple -configuration Debug \
  -destination 'generic/platform=iOS Simulator' \
  -derivedDataPath build/DerivedData CODE_SIGNING_ALLOWED=NO build

运行与排错

构建成功后运行 App，首页应显示 SDK 6.5.1。广告位宏、页面按钮顺序及回调观察见 CocoaPods 示例的页面说明；本副本中的对应源码仍位于 YTIFLYADLibSimple/，请修改本副本文件，不是另一示例的文件。内置格式等待 Ready 后 Show；信息流按页面完成加载、渲染与挂载。无填充不能据此认定安装失败。

若找不到 workspace，先确认终端目录；若依赖下载失败，先恢复网络并重试。手动方式的 --archive-dir 接受 sdk-artifacts.json 指定的各模块 .xcframework.zip，不接受完整合包或资源 ZIP 代替。资源缺失、重复符号和模块名问题见安装排查。

版本维护

此示例不会随仓库当前版本自动升级。更新依赖时同时更新工程、锁文件或资产摘要、同版资源及说明，并重新验证模拟器与设备架构。不得混用不同版本的库与资源。示例来源.json 记录本副本的 SDK Tag 和示例源码提交。