> ## 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.

# 更新日志

> React Native SDK 版本历史

<Note>
  本页面正在翻译中。请参阅[英文版](/en/react-native/changelog)获取最新内容。
</Note>

## \[3.4.6] - 2026-06-20

使 React Native 包装层与 CloudX 原生 Android 4.1.5 对齐；iOS 保持 3.4.5。本次发布没有 JavaScript API 变更。

### 新增

* **(Android) MobileFuse 适配器可用** - 现可通过 `io.cloudx:adapter-mobilefuse:1.11.0.0` 在 Android React Native 应用中接入 MobileFuse 需求（横幅、MREC、插页式、激励视频）。
* **(Android) Pangle 适配器就绪** - 现可通过 `io.cloudx:adapter-pangle:8.1.0.3.0` 在 Android 上接入 Pangle 需求。

### 变更

* 将底层 Android 原生依赖更新为 `io.cloudx:sdk:4.1.5`（iOS `CloudXCore ~> 3.4.5` 保持不变）。
* **(Android) 启动更快** - 减少了因设备信号采集导致的初始化与广告请求停顿。
* **(Android) 全屏 HTML 渲染** - SDK 现可在插页式和激励视频广告位渲染 CloudX 投放的全屏 HTML 素材，并支持可见性测量。由服务端控制发布；无需应用改动。
* **(Android) 更广泛的原生广告入横幅覆盖** - Vungle 原生需求现可通过现有横幅 API 投放到标准横幅和 MREC 广告位（与 Meta、Moloco 一起），需在对应订单项中启用。

### 修复

* **(Android) 全屏可靠性** - 全屏 HTML 广告的关闭行为与隐藏回调更可靠，激励视频被提前关闭时的奖励处理更安全。
* **(Android) 原生广告图片处理** - 原生素材的图片加载更可靠，防止复用广告视图时出现过时图片。

### 平台支持

* iOS：CloudXCore \~> 3.4.5
* Android：io.cloudx:sdk:4.1.5

***

## \[3.4.5] - 2026-06-16

使 React Native 包装层与 CloudX 原生 iOS 3.4.5 对齐；Android 保持 4.1.3。本次发布没有 JavaScript API 变更。

### 修复

* **(iOS) 插页式和激励视频广告现可在旧架构 (Paper) 上正常显示** - 在使用旧版 React Native 架构构建的应用中，全屏广告可能加载成功但无法显示。现已可正常展示。新架构 (Fabric) 应用不受影响。
* **(iOS) 部分有效的 HTML 横幅和 MREC 素材不再被跳过** - 之前被误判为损坏的素材现可正常渲染。
* **(iOS) Meta 和 Moloco 原生广告可靠性** - 原生广告入横幅及入 MREC 素材的资源校验与注册更可靠，展示与点击跟踪更稳定。
* **(iOS) Digital Turbine 启动冲突** - 当另一个聚合 SDK 先初始化共享的 Fyber SDK 时，CloudX 适配器现会延后处理而非重新初始化。为获得最顺畅的启动流程，请先初始化另一个聚合 SDK，再初始化 CloudX。

### 变更

* 将底层 iOS 原生依赖更新为 `CloudXCore ~> 3.4.5`（Android `io.cloudx:sdk:4.1.3` 保持不变）。请将 iOS 的 `CloudX*` 适配器 pod 同步更新为 `~> 3.4.5`。
* **(iOS) 更广泛的原生广告入横幅覆盖** - InMobi 和 Vungle 的原生需求现可通过现有横幅 API 投放到标准横幅和 MREC 广告位（与 Meta、Moloco 一起），需在对应订单项中启用。
* **(iOS) HTML 插页式渲染** - CloudX 渲染器现支持全屏 HTML 插页式素材。由服务端控制发布；无需应用改动。
* **(iOS) 慢速广告网络不再拖慢启动** - 若某网络 SDK 初始化较慢，CloudX 初始化将不等待它直接完成，该网络在初始化完成后自动加入后续竞价。

### 平台支持

* iOS：CloudXCore \~> 3.4.5
* Android：io.cloudx:sdk:4.1.3

***

## \[3.4.4] - 2026-06-12

使 React Native 包装层与 CloudX 原生 SDK 对齐 — iOS 3.4.4 和 Android 4.1.3。本次发布没有 JavaScript API 变更；应用通过现有 React Native API 即可获得原生平台改进和更丰富的适配器阵容。

### 新增

* **Digital Turbine 适配器支持** - 双平台均可在 React Native 应用中接入 Digital Turbine 广告需求（横幅、MREC、插页式、激励视频）。iOS：`pod 'CloudXDigitalTurbineAdapter', '~> 3.4.4'`；Android：`io.cloudx:adapter-digitalturbine:8.4.5.0`。
* **(iOS) Pangle 适配器** - `pod 'CloudXPangleAdapter', '~> 3.4.4'`（横幅/MREC、插页式、激励视频）。
* **(iOS) Google Waterfall 适配器** - `pod 'CloudXGoogleWaterfallAdapter', '~> 3.4.4'`（横幅、MREC）；需要在应用的 Info.plist 中配置 Google 广告应用标识符。
* **(Android) 原生广告入横幅渲染** - 来自受支持网络（Meta、Moloco、Vungle）的原生广告需求现可通过现有横幅 API 投放到标准横幅和 MREC 广告位。

### 变更

* 底层原生 SDK 版本更新为 iOS `CloudXCore ~> 3.4.4` 和 Android `io.cloudx:sdk:4.1.3`。
* **(Android) 更具韧性的适配器初始化** - 缓慢的广告网络不再拖慢 SDK 启动；未就绪的适配器会暂不参与竞价，就绪后自动加入。
* **(Android) 服务端控制的始终发放奖励模式** - 可在控制台按 line item 配置保证触发奖励回调，无需应用侧改动。

### 修复

* **(iOS) App Store 提交被拒** - 移除了 SDK 二进制中可能导致 App Store 审核被拒的受限 URL scheme。
* **(iOS) 部分账户 SDK 初始化失败** - 没有组织标识符的账户现在也能正常完成初始化。
* **(iOS) Google Waterfall 丢单** - 响应较慢但最终成功的瀑布流响应不再被丢弃，提升填充可靠性。
* **(iOS) Digital Turbine 兼容性** - 横幅、MREC、插页式和激励视频现已兼容 Fyber 8.x 全系列版本。

### 平台支持

* iOS: CloudXCore \~> 3.4.4
* Android: io.cloudx:sdk:4.1.3

***

## \[3.4.0] - 2026-05-25

### 新增

* **Trusted Arbiter** - 新增支持将 CloudX 出价与 Unity LevelPlay、PubMatic 等受支持的第三方出价进行比较，并通过 CloudX 仲裁选择胜出平台。
* **广告元数据** - 新增 `CloudXAdInfo.adValues`，用于读取 SDK 提供的已加载广告元数据，可用于 Trusted Arbiter 等功能。
* **更多适配器覆盖** - 更新 iOS 和 Android 最新支持适配器的安装说明，包括底层原生 SDK 支持的 Google Waterfall、Moloco 和 Verve。

### 变更

* 底层原生 SDK 版本更新为 iOS `CloudXCore ~> 3.4.0` 和 Android `io.cloudx:sdk:4.1.0`。

### 平台支持

* iOS: CloudXCore \~> 3.4.0
* Android: io.cloudx:sdk:4.1.0

***

## \[2.0.0] - 2026-03-05

CloudX React Native SDK 首个稳定版本。

### 新增

* 完整的 SDK 集成：横幅、MREC、插页式和激励视频广告格式
* 程序化叠加 API：`CloudXBannerAd` 和 `CloudXMRECAd`
* 全屏广告模块：`CloudXInterstitialAd` 和 `CloudXRewardedAd`
* React Hooks: `useCloudXInterstitial`, `useCloudXRewarded`, `useCloudXBanner`
* 隐私合规支持 (CCPA, GDPR, GPP)
* 用户定向键值对 (`setUserKeyValue`, `setAppKeyValue`)
* 展示级收入追踪 (`addAdRevenuePaidListener`)
* App Tracking Transparency (iOS 14+)
* 展示失败事件 (`addAdFailedToDisplayEventListener`)
* 完整的 TypeScript 类型定义
* Fabric (新架构) 和 Paper (旧架构) 支持

### 修复 (iOS — 自 2.0.0-beta.1)

* 修复 `onInterstitialHidden` / `onRewardedAdHidden` 关闭时重复回调
* 修复激励视频广告收入回调重复触发
* 修复 bid token 字典构建中的线程安全崩溃
* `showInterstitial` / `showRewarded` 在 `topViewController` 为 nil 时发送展示失败事件
* `didFailToLoadAd:` 在 `adUnitId` 为 nil 时广播到所有全屏监听器
* `rewardAmount` 以 `NSNumber` 而非 `NSString` 发送
* 改进加载/失败路径的诊断日志

### 平台支持

* iOS: CloudXCore \~> 2.2.0-beta
* Android: io.cloudx:sdk:2.0.0

***

## \[2.0.0-beta.1] - 2026-02-26

### 新增

* 完整的 CloudX Core SDK 集成
* 通过 `CloudXBannerAd` 模块支持横幅广告
* 通过 `CloudXMRECAd` 模块支持 MREC 广告 (300x250)
* 通过 `CloudXInterstitialAd` 模块支持插页式广告
* 通过 `CloudXRewardedAd` 模块支持激励视频广告
* React Hooks: `useCloudXInterstitial`, `useCloudXRewarded`, `useCloudXBanner`
* 隐私合规支持 (CCPA, GDPR, GPP)
* 用户定向键值对
* 展示级收入追踪
* App Tracking Transparency (iOS)
* 完整的 TypeScript 类型定义
* Fabric (新架构) 和 Paper (旧架构) 支持

### 平台支持

* iOS: CloudXCore \~> 2.1.0-beta
* Android: io.cloudx:sdk:2.0.0