> ## Documentation Index > Fetch the complete documentation index at: https://docs.cloudx.io/llms.txt > Use this file to discover all available pages before exploring further. # 更新日志 > iOS SDK 发布历史 *** ## MobileFuse 适配器 1.11.0.0 - 2026-07-08 ### 新增 * **MobileFuse 适配器** — 全新的 `CloudXMobileFuseAdapter`，支持横幅、MREC、插屏和激励广告。安装：`pod 'CloudXMobileFuseAdapter', '~> 1.11.0.0'`。基于 MobileFuse SDK 1.11.0；需要 `CloudXCore >= 3.5.0`。 *** ## \[3.5.0] - 2026-07-07 适配器现在与 `CloudXCore` 独立版本化。每个适配器 pod 使用 `<第三方 SDK 版本>.<适配器修订号>` 格式（例如 `pod 'CloudXVungleAdapter', '~> 7.7.4.0'`），每次发布对应一个确切的第三方 SDK 版本。`CloudXCore` 继续使用 SDK 语义化版本（`pod 'CloudXCore', '~> 3.5'`）。 ### 破坏性变更 * **适配器 pod 不再与 `CloudXCore` 共享版本号。** 旧的统一版本线上的现有版本锁定（`~> 3.4`、`~> 3.x`）将无法解析新的适配器发布版本。请为每个适配器独立更新版本锁定，例如 `pod 'CloudXMintegralAdapter', '~> 8.1.5.0'`。 * **`CloudXMagniteAdapterV2` 取代 `CloudXMagniteAdapter` 用于独立版本化。** 安装 `pod 'CloudXMagniteAdapterV2', '~> 1.0.0.0'` 以迁移到新版本线；若尚未准备好迁移，旧的 `CloudXMagniteAdapter` pod 仍保留在旧的统一版本线上。两种方式均无需修改源代码 — import 名称保持不变。 * **`CloudXRenderer` 不再是独立的 pod。** 其功能已内置于 `CloudXCore`；请从 Podfile 中移除任何直接的 `CloudXRenderer` 依赖。 ### 新增 * **App Open 广告格式** — 全新的 `CLXAppOpen` 广告类（配套 `CLXAppOpenDelegate`），用于在应用启动或返回前台时展示的全屏广告。通过 `createAppOpen(adUnitId:)`（Objective-C 中为 `createAppOpenWithAdUnitId:`）创建。支持 Google Waterfall、Mintegral、Pangle 和 Vungle 适配器。 * **CloudX 渲染器支持 VAST 视频插屏与激励视频** — CloudX 渲染器现可投放 VAST 视频插屏和激励素材，并支持 Open Measurement（OMID）视频可见性测量。发布由服务端控制；无需修改集成。 * **CloudX 渲染器支持 HTML 激励视频** — HTML 激励素材现可通过 CloudX 渲染器渲染，补全了 3.4.5 中为插屏引入的全屏 HTML 支持。服务端控制发布；无需修改集成。 * **Digital Turbine、Mintegral、Pangle、Verve 和 Google Waterfall 支持原生广告** — 这些适配器现可投放原生素材，支持独立原生（通过 `CLXNativeAdLoader`）以及横幅位/中矩形位原生广告。原生广告现已覆盖 Meta、Vungle、InMobi、Moloco、Digital Turbine、Mintegral、Pangle、Verve 和 Google Waterfall。 * **Google Waterfall — 插屏与激励视频** — `CloudXGoogleWaterfallAdapter` 现可投放全屏插屏和激励视素材，在横幅、中矩形、原生广告和 App Open 之外进一步扩展。 * **应用内 App Store 弹窗，用于安装类广告点击** — 对于声明了推广应用的 CloudX 渲染素材，点击安装类广告现在会打开应用内 App Store 产品弹窗，而不是跳转离开您的应用。当弹窗无法显示时，会回退到之前的行为（打开 App Store 应用）。 * **全屏 HTML 插屏点击跳转** — 由 CloudX 渲染器渲染的全屏 HTML 插屏现在支持点击跳转。 * **`CloudXMagniteAdapterV2` 1.0.0.1** — 全新的独立版本化 Magnite pod。安装：`pod 'CloudXMagniteAdapterV2', '~> 1.0.0.0'`。底层基于 MagniteSDK 1.0.0。 ### 变更 — 适配器发布 * **Vungle** `CloudXVungleAdapter` → `~> 7.7.4.0`（VungleAds 7.7.4）。 * **Mintegral** `CloudXMintegralAdapter` → `~> 8.1.5.0`（MintegralAdSDK 8.1.5）。 * **Unity Ads** `CloudXUnityAdsAdapter` → `~> 4.19.0.0`（UnityAds 4.19.0）。 * **Verve** `CloudXVerveAdapter` → `~> 3.9.0.0`（HyBid 3.9.0）。 * **Digital Turbine** `CloudXDigitalTurbineAdapter` → `~> 8.4.8.0`（Fyber Marketplace SDK 8.4.8）。 * **Google Waterfall** `CloudXGoogleWaterfallAdapter` → `~> 13.6.0.0`（Google Mobile Ads SDK 13.6.0 — 从 12.x 升级的主版本更新）。 * **InMobi** `CloudXInMobiAdapter` → `~> 11.3.0.0`（InMobiSDK 11.3.0）。 * **Meta** `CloudXMetaAdapter` → `~> 6.21.1.0`（FBAudienceNetwork 6.21.1）。 * **Moloco** `CloudXMolocoAdapter` → `~> 4.8.0.0`（MolocoSDKiOS 4.8.0）。 * **Pangle** `CloudXPangleAdapter` → `~> 7.9.1.3.0`（Ads-Global 7.9.1.3）。 ### 修复 * **部分竞价方未就某些横幅展示获得计费** — 修复了一个问题：通过横幅位原生广告桥接渲染的原生广告展示，可能在未附带竞价方获胜/计费通知的情况下被上报，导致该展示虽被计数但竞价方从未获得计费。此问题影响横幅位原生广告渲染路径（例如 Moloco）。展示现在均能正确计费。 * **横幅位或中矩形位原生广告可能过早上报展示** — 修复了一个问题：投放在横幅位或中矩形位的原生广告（Moloco）可能在广告视图实际插入并可见之前就触发展示事件，尤其是在离屏预加载时。展示现在会在正确的时间上报。 * **渲染崩溃后全屏广告卡住** — 修复了一个问题：全屏广告加载完成后，若其背后的网页内容进程崩溃，用户可能停留在无法关闭的全屏界面。广告现在会自动关闭并派发关闭回调。 * **紧凑布局下横幅位原生广告可能漏报展示** — 修复了一个问题：使用紧凑模板投放在横幅位的原生广告可能已显示但未登记展示。 ### 移除 * **`CloudXRenderer` 独立 pod** — 已合并至 `CloudXCore`。详见上方破坏性变更。 *** ## \[3.4.6] - 2026-06-29 ### 变更 * **`CloudXMolocoAdapter` 现已支持完整的 MolocoSDK 4.x 系列** — 适配器对 `MolocoSDKiOS` 的版本要求已从 `~> 4.6.0`（仅允许 4.6.x）放宽至 `>= 4.6.0, < 5.0`。您现在可以采用更新的 Moloco SDK 版本（4.7.0、4.8.0 及后续 4.x），从而解决部分应用中可能阻碍集成的 CocoaPods 依赖冲突。 ### 修复 * **广告加载完成时的罕见崩溃** — 修复了横幅或全屏（插屏/激励）广告加载完成时可能发生的罕见崩溃。受影响的广告现在能够可靠地加载并回报结果。 * **无填充刷新后的横幅广告重复展示计数** — 修复了横幅广告在自动刷新未获得出价时可能重新展示上一个创意并计入额外展示的问题。未获得出价的刷新现在不会展示任何内容，也不会回报展示，从而保证展示计数的准确性。 *** ## \[3.4.5] - 2026-06-12 ### 新增 * **InMobi、Meta、Vungle 和 Moloco 全面支持原生广告** — 随着本次发布新增 InMobi 原生广告与 Vungle 独立原生广告，这四家需求方合作伙伴现已支持 CloudX 提供的所有原生广告形式：独立原生广告（通过 `CLXNativeAdLoader`）以及横幅/中矩形位中的原生广告。 * **InMobi 原生广告** — `CloudXInMobiAdapter` 现已支持原生广告，包括独立原生广告（通过 `CLXNativeAdLoader`）以及横幅/中矩形位中的原生广告。需要 `InMobiSDK >= 11.2.0`（适配器最低版本要求已从 `11.0.0` 提升）。 * **Vungle 独立原生广告** — `CloudXVungleAdapter` 现已支持通过 `CLXNativeAdLoader` 投放独立原生广告（横幅/中矩形位中的原生广告此前已支持）。 * **CloudX 渲染器支持 HTML 插屏广告** — CloudX 渲染器现已支持全屏 HTML 插屏创意（含 MRAID 3.0），与现有的 HTML 横幅/中矩形支持并列。该功能由服务端控制灰度发布，无需修改集成代码。 ### 变更 * **较慢的广告网络 SDK 不再拖慢 CloudX SDK 初始化** — 适配器初始化现采用按网络的软超时机制：若某个广告网络 SDK 初始化较慢，CloudX SDK 将不再等待并完成初始化；该网络在完成初始化后会自动加入后续竞价。尚未完成初始化的网络会被排除在其无法响应的竞价之外。 ### 修复 * **Digital Turbine 适配器不再与其他先初始化 Fyber SDK 的聚合 SDK 冲突** — 如果您的应用同时运行 CloudX 与另一个先初始化共享 Fyber Marketplace SDK 的聚合 SDK，CloudX 适配器现在会检测到这一情况并自动让步，而不是重新初始化（此前可能导致对方 SDK 的初始化被取消）。为获得最平滑的启动体验，建议先初始化其他聚合 SDK，等待其初始化完成回调后再初始化 CloudX。 * **部分有效的 HTML 横幅创意被渲染器拒绝** — 修复了包含加载失败的追踪像素的 HTML 横幅/中矩形创意被误判为损坏而不展示的问题。此类创意现已能正常渲染。 * **Meta 与 Moloco 原生广告可靠性提升** — Meta 原生广告现在会在交付前校验广告有效性，并将所有素材视图（标题、正文、图标、媒体、广告主）注册用于展示和点击跟踪，而不仅限于 CTA 按钮（同样适用于 Vungle 和 Verve 的横幅位原生广告）。Moloco 原生广告在底层广告不可渲染时不再交付。 ### 移除 * **适配器集成 API** — 从适配器层面移除：`clx_isFlexibleSize`（横幅适配器）、`+isInitialized`（适配器初始化器）以及按实例的 `sdkVersion`（原生适配器）。这些 API 对应用集成没有实际作用；标准发布商集成不受影响。 *** ## \[3.4.4] - 2026-06-02 ### 修复 * **Digital Turbine 适配器在 Fyber Marketplace SDK 低于 8.4.0 时无法链接** — 尽管 3.4.3 宣称支持低至 Fyber `8.0.0`，但实际发布的适配器二进制文件在应用使用低于 `8.4.0` 的 Fyber SDK 时仍会链接失败。该适配器现已可在整个 `8.x` 系列中正常链接——横幅、中矩形、插屏和激励广告在 Fyber `8.0.0`+ 上均可使用。原生广告填充仍需 Fyber SDK `8.4.0`+。 * **Google Waterfall — 中介响应较慢时偶尔丢失填充** — 修复了当 Google Waterfall 广告的中介瀑布流响应耗时超出预期时，即使最终成功填充，该广告也可能被丢弃的问题。响应较慢但成功的填充现已能正常交付，从而提升填充可靠性。 *** ## \[3.4.3] - 2026-06-01 ### 新增 * **Pangle 适配器** — 全新的 `CloudXPangleAdapter`，支持横幅/中矩形、插屏和激励广告。安装：`pod 'CloudXPangleAdapter', '~> 3.4.3'`。底层基于 Pangle（字节跳动）SDK `Ads-Global ~> 7.9.0`。 ### 变更 * **DigitalTurbine 适配器 — 更广泛的 Fyber Marketplace SDK 兼容性** — `CloudXDigitalTurbineAdapter` 现在接受 `Fyber_Marketplace_SDK >= 8.0.0`（此前要求 `>= 8.4.0`）。横幅、中矩形、插屏和激励广告在整个 8.x 系列中均可使用；原生广告填充仍需 Fyber SDK 8.4.0 及以上版本。 ### 修复 * **`itms-services` URL scheme 导致的 App Store 提审被拒** — 已从 SDK 二进制文件中移除该 scheme；商店跳转不受影响。 * **部分账户的 SDK 初始化可能失败** — 修复了没有组织标识符的账户初始化失败的问题。 *** ## \[3.4.2] - 2026-05-29 ### 新增 * **Google Waterfall 适配器** — 全新的 `CloudXGoogleWaterfallAdapter`（横幅、中矩形）。通过 CocoaPods（`pod 'CloudXGoogleWaterfallAdapter', '~> 3.4.2'`）或 Swift Package Manager 安装。底层基于 `Google-Mobile-Ads-SDK 12.14.0`；需要在 Info.plist 中配置 `GADApplicationIdentifier`。 *** ## \[3.4.1] - 2026-05-27 ### 新增 * **Digital Turbine 适配器** — 全新的 `CloudXDigitalTurbineAdapter`（横幅、中矩形、插屏、激励、原生）。安装：`pod 'CloudXDigitalTurbineAdapter', '~> 3.4.1'`。底层基于 `Fyber_Marketplace_SDK >= 8.4.0, < 9.0`。 ### 修复 * **横幅刷新时 `didLoadAd` / `didShowAd` 回调重复** — 当合作伙伴适配器 SDK 对同一广告多次触发加载或展示回调时，发布者委托可能收到重复的回调。现在首次回调被视为标准回调，同一适配器后续重复触发的相同事件将被丢弃，发布者侧每个广告精确收到一次加载和一次展示。 *** ## \[3.4.0] - 2026-05-22 ### 新增 * **Verve 适配器** — 全新的 `CloudXVerveAdapter`（横幅、中矩形、插屏、激励、原生）。安装：`pod 'CloudXVerveAdapter', '~> 3.4.0'`。底层基于 HyBid 3.8.0。 * **Moloco 适配器** — 全新的 `CloudXMolocoAdapter`（横幅、中矩形、插屏、激励、原生）。安装：`pod 'CloudXMolocoAdapter', '~> 3.4.0'`。底层基于 MolocoSDKiOS `~> 4.6.0`。 * **非 SDK CloudX 渲染的 HTML 横幅与中矩形（含 MRAID 3.0）** — HTML 横幅和中矩形素材现可通过 CloudX 渲染器投放，并支持 MRAID 3.0。 * **横幅位与中矩形位原生广告支持** — 原生素材可投放到 Meta、Vungle、Moloco 上的横幅或中矩形广告位。 * **Trusted Arbiter** — 新增公共 API，可比较 CloudX 出价与 Unity LevelPlay、PubMatic 的受支持第三方出价，并通过 CloudX 仲裁选择获胜平台。 * **`CLXAd.adValues` 属性** — 新增只读 `NSDictionary` 属性，暴露 SDK 定义的加载广告元数据。具体可用值取决于广告格式与网络。 ### 变更 * **UnityAds 适配器版本范围放宽** — 调整为接受 Unity Ads 4.x 补丁版本(`>= 4.17.0, < 5.0`)。 * **发布方委托主队列回调成为契约文档** — 所有 `CLXAdDelegate` 回调（及其扩展协议）以及 `CLXAdRevenueDelegate` 回调都会在主队列上派发，并可能相对触发它们的 SDK 调用以内联方式触发。运行时行为无变化。 ### 修复 * **长会话期间的原生广告内存泄漏** — 长期运行、加载大量原生广告的发布方集成不再在每次原生广告刷新周期累积保留观察者。 *** ## \[3.2.0] - 2026-04-22 ### 新增 * **Magnite 适配器** — 全新的 `CloudXMagniteAdapter`（横幅、中矩形、插屏、激励）。安装：`pod 'CloudXMagniteAdapter', '~> 3.2.0'`。 * **更丰富的仪表盘遥测** — 全面的遥测升级。事件采集更稳健，新增事件类型，整体可观测性显著提升。 *** ## \[3.1.0] - 2026-04-16 ### 新增 * **Meta Reels 与原生广告** — 现已支持 Meta Reels（9:16 竖版视频）及其他 Meta 原生广告格式，通过 `CLXPublisherNative` 集成。本版本仅支持 Meta 原生广告；其他竞价方的支持将在未来版本中推出。 * **按适配器初始化超时** — SDK 初始化现在支持每个适配器的独立超时设置，启动行为更可预测。 ### 修复 * **Xcode 26 兼容性** — 解决了使用 Xcode 26 编译时的构建警告。 *** ## \[2.2.9] - 2026-04-09 ### 修复 * **Unity Ads 适配器** — 修复了初始化、隐私同意转发、激励回调和竞价令牌错误处理，提升了各地区的可靠性。 *** ## \[2.2.8] - 2026-04-03 ### 修复 * **崩溃修复** — 修复了在后台线程上并发进行广告事件追踪时可能发生的崩溃问题 *** ## \[2.2.7] - 2026-04-01 ### 修复 * **延迟横幅展示** — 修复了在 SDK 初始化完成之前创建的横幅广告在初始化成功后可能无法展示的问题 * **Vungle 适配器可靠性** — 修复了 Vungle 激励广告和插屏广告由于链接时方法被错误剥离而在运行时崩溃的问题 *** ## \[2.2.6] - 2026-03-30 ### 新增 * **Unity Ads 隐私同意** — Unity Ads 适配器现在支持 GDPR 和 CCPA 隐私同意转发 * **`isAdReady` 支持** — 全屏广告适配器现在支持 `isAdReady`，可在调用 show 之前可靠地查询广告可用性 ### 修复 * **横幅可见性准确性** — 修复了设置 `banner.hidden = YES` 不会暂停广告刷新的问题。隐藏的横幅可能继续加载广告而不具备展示资格，可能影响 CPM。 * **改进依赖兼容性** — 放宽第三方 SDK 版本约束（VungleAds、FBAudienceNetwork、InMobiSDK），防止与其他聚合 SDK 集成时出现 CocoaPods 依赖冲突 * **全屏广告可靠性** — 修复了广告生命周期回调在罕见情况下可能静默丢失的问题 * **iOS 16 崩溃修复** — 修复了 iOS 16 设备上与会话追踪相关的崩溃 *** ## \[2.2.4] - 2026-03-26 ### 变更 * **服务端驱动的位置控制** — 竞价请求中的位置坐标共享现在通过 CloudX 控制面板控制（账户级别）。发布商无需更改 SDK 代码。 * **改进竞价请求数据** — 竞价请求现在包含内容语言，以改善广告定向 *** ## \[2.2.3] - 2026-03-19 ### 新增 * **Unity Ads 适配器** — Unity Ads 适配器现已支持横幅、插屏和激励广告 ### 修复 * **Unity Ads 初始化** — 修复了 Unity Ads 适配器在某些配置下可能无法正确初始化的问题 *** ## \[2.2.2] - 2026-03-16 ### 新增 * **手动隐私 API** — 新增 `setHasUserConsent:` 和 `setDoNotSell:` 方法，用于发布商控制的隐私同意 * **Mintegral 适配器** — Mintegral 适配器现已作为标准版本发布 ### 修复 * **提升错误可见性** — 提高了无竞价场景的错误可见性，使填充率问题更容易诊断 * **全屏广告加载** — 修复了在另一个全屏广告展示时加载广告可能静默失败的问题 * **全屏失败回调** — 修复了全屏广告失败回调中缺少广告单元 ID 的问题 * **渲染器展示追踪** — 修复了 CloudX Renderer 中的可见性追踪准确性 ### 变更 * **Mintegral SDK** — 从 8.0.7 升级到 8.0.8 *** ## \[2.0.0] - 2026-02-04 此版本将 placement 名称替换为 CloudX 仪表板中的 **Ad Unit ID**。请更新您的 `createBannerWithAdUnitId:`、`createMRECWithAdUnitId:`、`createInterstitialWithAdUnitId:` 和 `createRewardedWithAdUnitId:` 调用，使用 ad unit ID 而非 placement 名称。 ### 新增 * 激励广告，使用 `createRewardedWithAdUnitId:delegate:` 和 `CLXRewardedDelegate` * InMobi 适配器（SDK 11.1），支持横幅、MREC、插屏和激励广告 * `CLXAd.networkPlacement` 属性用于获取网络特定的 placement ID ### 重大变更 * 在 `createBannerWithAdUnitId:`、`createMRECWithAdUnitId:`、`createInterstitialWithAdUnitId:`、`createRewardedWithAdUnitId:` 中将 `placement` 参数重命名为 `adUnitId` * 将 `CLXAd.placement` 重命名为 `adUnitId` * 将 `CLXAd.bidderName` 重命名为 `networkName` * 将 `CLXErrorCodeInvalidPlacement` 重命名为 `CLXErrorCodeInvalidAdUnit` * 更改 `bannerAdView:didFailWithError:` 以在错误中包含 ad unit ID * 从 `initializeSDKWithAppKey:completion:` 中移除 `testMode` 参数 - 测试模式现在通过仪表板进行服务端控制 ### 变更 * Meta Audience Network SDK 从 6.17.0 更新到 6.21.0 * Vungle SDK 从 7.4.2 更新到 7.6.0 ### 修复 * 修复 IFA（广告标识符）收集问题 * 修复国家/地理定向数据收集问题 *** ## \[1.3.0] - 2025-12-14 ### 新增 * **横幅刷新重试** - 横幅广告现在在隐藏后会自动重试加载失败的广告 ### 修复 * **App Extension 兼容性** - SDK 现在可以在 App Extensions 中正常工作（无 UIApplication 调用） * **激励广告代理回调** - 修复回调顺序错误 * **符号冲突** - 所有分类方法现在都以 `clx_` 为前缀以防止冲突 ### 变更 * **CloudXCore 现在以动态框架分发** - 支持 SDK 问题的崩溃符号化 *** ## \[1.2.1] - 2025-12-04 ### 新增 * **可视化调试器按钮** - 用于开发和 QA 的新调试工具 * **高 ROI 键值定向示例** - 增强的演示应用，包含定向信号示例 ### 修复 * 更正 podspecs 中的 vendored\_frameworks 路径 *** ## \[1.2.0] - 2025-11-26 ### 🚀 首次正式发布 CloudX iOS SDK 的初始版本，支持横幅、MREC 和插屏广告。