[2.0.0] - 2026-02-04
此版本将广告位名称替换为 CloudX 控制台中的广告单元 ID。更新您的createBanner()、createMREC()、createInterstitial() 和 createRewarded() 调用，使用广告单元 ID 而不是广告位名称。
新增
- 激励视频广告 包括
CloudX.createRewarded()、CloudXRewardedAd、CloudXRewardedListener和CloudXReward - InMobi 适配器 (SDK 11.1.0) 支持横幅、MREC、插屏和激励视频广告
- Vungle 激励视频广告 (SDK 7.6.1) 为现有 Vungle 适配器添加支持
CloudX.isInitialized()用于检查 SDK 初始化状态CloudX.getVersion()用于获取 SDK 版本字符串- 在
CloudXAdView上添加setPlacement()和setCustomData()方法用于跟踪 - 在全屏广告上添加
show(activity, placement, customData)重载用于跟踪 - 在
onInitialized()回调中返回CloudXSdkConfiguration - 添加
CloudXAd.networkPlacement属性用于网络特定的广告位 ID - 新增错误代码：
NETWORK_NO_CONNECTION、AD_ALREADY_SHOWING、DONT_KEEP_ACTIVITIES_ENABLED、AD_NOT_READY、INVALID_APP_KEY
破坏性变更
- 将
minSdk从 21 提升到 23 (Android 6.0 Marshmallow) - 将
CloudXInitializationParams替换为CloudXInitializationConfiguration构建器模式 - 在
createBanner()、createMREC()、createInterstitial()、createRewarded()中将placementName参数重命名为adUnitId - 将
CloudXAd.placementId重命名为adUnitId - 移除
CloudXAd.placementName属性 - 将
CloudXAd.bidderName重命名为networkName - 将
CloudXErrorCode.INVALID_PLACEMENT重命名为INVALID_AD_UNIT - 将
onAdLoadFailed(placementName, cloudXError)更改为onAdLoadFailed(adUnitId, cloudXError) - 将
onAdDisplayFailed(cloudXError)更改为onAdDisplayFailed(cloudXAd, cloudXError)- 现在包含广告对象 - 将
onInitialized()更改为onInitialized(configuration: CloudXSdkConfiguration) - 移除
testMode参数 - 测试模式现在由服务器控制 - 将
show()更改为show(activity)用于插屏和激励视频广告 - 现在需要 Activity 参数
变更
- Meta Audience Network SDK 从 6.17.0 更新到 6.21.0
修复
- 广告重新加载现在在
onAdHidden和onAdDisplayFailed回调中正常工作 - 所有
load()和show()调用现在保证在 UI 线程上回调
[0.12.1] - 2025-12-23
修复
- 修复 Meta 适配器中由
getBidderToken()阻塞主线程导致的 ANR
[0.12.0] - 2025-12-14
破坏性变更
- 移除
CloudXError.effectiveMessage- 请直接使用message - 移除
setLoggingEnabled()- 使用setMinLogLevel(CloudXLogLevel.NONE)来禁用日志 - 移除
CloudXPrivacy类 - 隐私现在通过 GPP/TCF 自动处理
变更
- 增强 GDPR 支持，包含 GPP Section 2 解析和供应商同意检查
- 简化 TCF 目的检查，仅需要目的 1 和 2（移除 3-4）
- 通过 GPP 添加 CCPA 支持，并提供传统 USPrivacy 回退
- 移除 COPPA 处理
- 添加
CloudXLogLevel.NONE枚举值用于禁用日志
修复
- 修复初始化期间地理 API 失败处理
[0.11.0] - 2025-12-09
变更
- HTTP 客户端从 Ktor 3.0.3 迁移到 OkHttp 4.12.0
- 为所有广告格式添加
isDestroyed保护
[0.10.0] - 2025-12-03
新增
- Vungle 适配器 (SDK 7.6.1) 支持横幅和插屏广告
变更
- 简化日志标签为 “CloudX” 以便更容易过滤 logcat
- 为公共 API 函数添加入口日志以便更好地调试
- SDK 初始化现在在未找到适配器时会提前失败并显示明确错误
修复
- 修复加载失败后横幅刷新停止的问题
[0.9.0] - 2025-11-26
新增
- 通过新的
CloudXAdRevenueListener接口和onAdRevenuePaid回调实现广告收入追踪
变更
- 将 Ktor 从 2.3.8 升级到 3.0.3 以提高与使用 Ktor 3.x 的应用的兼容性
修复
- 修复广告生命周期管理中的内存泄漏
- 各种错误修复和稳定性改进
[0.8.0] - 2025-11-11
内部
- 验证发布自动化工作流程的测试版本
[0.6.1] - 2025-11-03
修复
- 修复发布脚本以更新中文 README (README.zh-CN.md) 版本号
[0.6.0] - 2025-11-03
新增
- 测试模式支持：在
CloudXInitializationParams中添加testMode参数以在开发期间请求测试广告
[0.5.0] - 2025-10-27
修复
- 修复发布推广脚本以正确同步从发布分支到主分支的文件删除
[0.4.0] - 2025-10-27
新增
- CloudX Android SDK 初始 Alpha 版本
- 支持横幅 (320x50) 和 MREC (300x250) 广告格式
- 支持插屏全屏广告
- 具有智能广告聚合的实时竞价
- CloudX 和 Meta Audience Network 适配器支持
- GDPR、CCPA（通过 GPP）和 COPPA 隐私合规
- IAB TCF、USPrivacy 和 GPP 字符串支持
- 用于竞价优化的会话深度追踪
- 全面的广告生命周期回调和错误处理
- 可配置日志级别的调试日志