萤石仅开屏 iOS SDK
当前版本：6.5.1。本版已通过 CocoaPods、SwiftPM、手动集成的安装及 arm64 模拟器/设备架构构建验证；真机广告展示仍需在宿主 App 中联调。
YSIFLYADLibSplash 为 iOS App 提供图片和视频开屏广告；本仓库包含分发清单、接入指南与示例。
指南目录 · 运行示例 · 安装指南 · 广告接入 · 更新记录 · 隐私与网络 · 支持说明 · 许可
三种接入示例
最新示例请从 main 分支源码 ZIP 下载并解压，或克隆 main；下面各 README 说明进入哪个目录及如何运行。接入自己的 App 请从安装指南开始，包含完整下载、资源来源、Xcode 配置和安装检查。
| 接入方式 | 独立示例 | 首次准备 |
|---|---|---|
| CocoaPods | YSIFLYADLibSimple | 在示例目录运行 pod install |
| SwiftPM | YSIFLYADLibSplashSwiftPMSimple | 打开 workspace，解析远程 6.5.1 包 |
| 手动集成 | YSIFLYADLibSplashManualSimple | 运行示例内 准备SDK.py，再打开 workspace |
可左右滚动查看完整表格
三种示例均固定使用 SDK 6.5.1，具体运行步骤见各自 README。同一 App 只选择一种接入方式。
能力与接入身份
| 项目 | 说明 |
|---|---|
| 广告能力 | 图片、视频开屏；不包含 Banner、插屏、自渲染信息流或激励广告 |
| CocoaPods product | YSIFLYADLibSplash |
| 代码模块 / 导入 | YSIFLYADLib / #import <YSIFLYADLib/YSIFLYADLib.h> |
| 资源包 | YSAdvSDK.bundle，含 PrivacyInfo.xcprivacy |
| API 命名 | 类型使用 YSIFLY 前缀；公开方法和 delegate 回调使用 ysifly_ 前缀，初始化方法和属性不加此前缀 |
| 共存限制 | 与多格式 YSIFLYADLib 使用相同模块、类型与资源，同一 App 只能选择一个 YS 包 |
可左右滚动查看完整表格
迁移 YS 包时先移除旧依赖、手工 framework 和重复资源。接口以所安装版本的 framework 公开头为准。
环境要求
- iOS 11.0+。
- 静态 XCFramework，包含设备与模拟器切片；App 最终链接需要
-ObjC，无需 Embed & Sign。 - 环境与安装说明区分部署目标、清单要求与工具兼容范围。
安装
推荐使用 CocoaPods 官方 trunk 的精确版本：
source 'https://cdn.cocoapods.org/'
platform :ios, '11.0'
target 'YourApp' do
use_frameworks!
pod 'YSIFLYADLibSplash', '6.5.1'
endpod install
open YourApp.xcworkspace该版本通过 CocoaPods trunk 安装，可直接使用官方 CocoaPods trunk。CocoaPods 自动加入资源、-ObjC 和所需系统库。
手动集成见安装与资源配置。三种方式选择一种；依赖名为 YSIFLYADLibSplash，代码始终导入 YSIFLYADLib。
最小使用流程
SDK 无需额外 App ID 初始化。完成宿主隐私流程，使用平台分配给当前 App 和广告形式的广告位，创建并强持有广告对象、设置 delegate，然后调用 ysifly_loadAd。开屏收到 Ready 后检查有效性、来源窗口与宿主展示时机，再调用展示方法；失败、结束或宿主放弃等待时继续业务并清理对象。成功展示后的下一次机会需新建对象。
完整普通请求示例、稍后展示与失败出口见广告加载与展示。
按广告形式接入
可左右滚动查看完整表格
普通广告无需服务端竞价；已开通媒体可查阅 S2S 与 Header Bidding。
隐私、支持与许可
ysifly_setPersonalizedEnabled: 仅记录状态，不改变数据处理、请求、填充、展示或点击行为，也不替代宿主同意流程与 ATT 授权。IDFA 只在授权后读取或传入；资源清单、ATS 与日志说明见隐私与网络。
接入失败先查错误处理与反馈；仍需帮助时通过双方约定的支持渠道提供版本、操作步骤、错误码和脱敏日志。使用许可见 LICENSE。