SDK 版本记录
本文记录 DeepAdx iOS、Android 与 Flutter SDK 的对外发布版本。各平台版本号独立编号,核心能力(错误码、广告策略加载、隐私合规)在相近版本中逐步对齐。
集成时请以下方「当前最新」为准。CocoaPods / Maven / pub 同步可能有短暂延迟,可稍后重试,或参考 iOS 集成、Android 集成、Flutter 接入 中的 Git 源 / 本地 AAR 方式。
当前最新
| 平台 | 版本 | 发布日期 | 包名 / 坐标 |
|---|---|---|---|
| iOS | 2.0.6 | 2026-11-09 | CocoaPods DeepAdxSDK |
| Android | 2.1.8 | 2026-11-09 | Maven com.deepadx.sdk:* |
| Flutter | 1.0.3 | 2026-11-09 | pub deepadx_sdk |
跨端能力参考(按特性,版本号不必相同):
| 特性 | iOS | Android |
|---|---|---|
| 统一错误码 2000–2017 | 2.0.x 起 | 2.1.0 |
| 广告策略按需加载 | 2.0.2 | 2.1.0 |
| 隐私 / UMP 由 App 自行处理 | 2.0.3 | 2.1.0 |
GG DeepAdxGGTemplates 模板 bundle | 2.0.4 | — |
AdMob 缓存 TTL / showAdCheckingExpire | 2.0.5 | — |
| 海外广告全局静音 / 音量 | 2.0.6 | 2.1.8 |
iOS 版本记录
2.0.6 最新
发布日期: 2026-11-09
重要变更
- 新增海外广告全局静音 / 音量:
+[DeepAdxSdkConfig setAdMuted:]、+[DeepAdxSdkConfig setAdVolume:]。 - 可在
registerAppID:前后调用;未调用时不干预各渠道默认声音。当前生效渠道:海外。 - 静音与音量相互独立;静音打开时音量值不会让广告出声。要静音建议两行都调。
objc
[DeepAdxSdkConfig setAdMuted:YES];
[DeepAdxSdkConfig setAdVolume:0.f];
// 非静音:
[DeepAdxSdkConfig setAdMuted:NO];
[DeepAdxSdkConfig setAdVolume:1.f];集成示例
ruby
pod 'DeepAdxSDK', '2.0.6'
pod 'DeepAdxSDK', '2.0.6', :subspecs => ['Core', 'CSJ', 'GDT', 'KS', 'BD', 'GG', 'PAG']从 2.0.5 升级
| 变更项 | 说明 |
|---|---|
| 全局静音 / 音量 | 新增 API,未调用则行为与 2.0.5 一致 |
| 其他 API | 无 Breaking Change |
2.0.5
发布日期: 2026-07-10
重要变更
- AdMob(GG)广告缓存 TTL:开屏 4h / 其他 1h(Release);Debug 10s 便于联调;过期静默 reload。
- 新增
DeepAdxNativeExpress.showAdCheckingExpire(load / show 分离的信息流场景)。
功能优化
- 聚合层
destroy、防重复 load、waterfall 生命周期守卫。 - Banner waterfall 自动跳过 BD(无 Banner 位)。
- 流量切分
doPercent对齐 Android(0~9999 + fallback)。 - 频控模型反序列化修复;各渠道 Adapter 编译与回调修复。
集成示例
ruby
pod 'DeepAdxSDK', '2.0.5'
pod 'DeepAdxSDK', '2.0.5', :subspecs => ['Core', 'CSJ', 'GDT', 'KS', 'BD', 'GG', 'PAG']从 2.0.4 升级
| 变更项 | 说明 |
|---|---|
| 信息流手动 show | 建议改用 showAdCheckingExpire |
| Banner 含 BD | 自动跳过,无需改配置 |
| 其他 API | 无 Breaking Change |
2.0.4
发布日期: 2026-07-01
重要变更
- GG 原生模板迁移为
DeepAdxGGTemplates.bundle,废弃GGResource.bundle;CocoaPodsDeepAdxSDK/GG自动打入 App。 - 含 Small / Medium XIB 及 Medium 星级 PNG;新增
DeepAdxNativeExpress.templateStyle(默认 Small)。 - 修复模板浅灰边框;Medium 星级优先 PNG 展示。
集成示例
ruby
pod 'DeepAdxSDK', '2.0.4'
pod 'DeepAdxSDK', '2.0.4', :subspecs => ['Core', 'CSJ', 'GDT', 'KS', 'BD', 'GG', 'PAG']从 2.0.3 升级
| 变更项 | 说明 |
|---|---|
| GG 资源 | 删除 GGResource.bundle,使用 DeepAdxGGTemplates.bundle |
| 模板样式 | 可选 templateStyle,GG 已支持 Small / Medium |
2.0.3
发布日期: 2026-07-01
重要变更
- 不再内置 Google UMP 弹窗。面向欧盟 / GDPR 等市场时,请在用户同意隐私政策后、调用
registerAppID:之前,由 App 自行完成 UMP 或其他合规方案。 - 已移除
enableGoogleUMPConsent、testDeviceIdentifiersGG等配置项,请删除相关代码。 - AdMob(GG)渠道仅依赖
Google-Mobile-Ads-SDK,不再捆绑 UMP 库。
若此前依赖 SDK 自动弹出 UMP,请改为集成 Google UMP SDK 后再初始化 DeepAdx。
其他优化
- 初始化后不再预拉全部广告位策略;各广告位在 加载广告时 按需获取策略,与官方 Demo 行为一致。
- GG 原生信息流:Small / Medium 模板 XIB 内置
DeepAdxAdapter_GG,接入DeepAdxSDK/GG无需GGResource.bundle;可选DeepAdxNativeExpress.templateStyle(默认 Small,Feed 可用 Medium)。
集成示例
ruby
pod 'DeepAdxSDK', '2.0.3'
# 按需引入渠道
pod 'DeepAdxSDK', '2.0.3', :subspecs => ['Core', 'CSJ', 'GDT', 'KS', 'BD', 'GG', 'PAG']从 2.0.2 升级
| 变更项 | 说明 |
|---|---|
| UMP / Consent | SDK 不再提供,改由 App 处理 |
| 已删除的配置字段 | 移除 enableGoogleUMPConsent、testDeviceIdentifiersGG 等赋值 |
| GG 原生模板 | 不再需 GGResource.bundle;XIB 随 DeepAdxAdapter_GG 发布 |
| 广告位 API | placementId、loadAd 等无变更,一般无需改业务代码 |
可选渠道(Subspec)
| Subspec | 说明 |
|---|---|
Core | 核心 + 广告位(默认) |
CSJ | CSJ |
GDT | GDT |
KS | KS |
BD | BD |
GG | GG |
PAG | PAG |
2.0.2
发布日期: 2026-06-30
功能优化
- 初始化后不再批量拉取全部广告位策略;每个广告位在首次 load 时按需拉取,并优先使用本地缓存。
- 修复首次加载时因策略尚未就绪导致的失败问题(如 Banner 偶发加载失败)。
- 减少生产环境 DEBUG 日志中的策略明细输出。
从 2.0.1 升级
| 变更项 | 说明 |
|---|---|
| 策略加载时机 | 由「初始化后全部就绪」改为「各广告位 load 时按需加载」 |
| 接入建议 | 以 load 成功回调 为准判断广告位可用,而非 init 完成即认为可展示 |
| 广告位 API | 无需修改调用方式 |
Android 版本记录
2.1.8 最新
发布日期: 2026-11-09
重要变更
- 新增海外广告全局静音 / 音量:
DeepAdx.setAdMuted(boolean)、DeepAdx.setAdVolume(float)。 - 可在
DeepAdx.init前后调用;未调用时不干预各渠道默认声音。当前生效渠道:海外。 - 静音与音量相互独立;静音打开时音量值不会让广告出声。要静音建议两行都调。
- 海外渠道初始化完成后 SDK 自动下发已保存策略,接入方不必等待初始化。
java
DeepAdx.setAdMuted(true);
DeepAdx.setAdVolume(0f);
// 非静音:
DeepAdx.setAdMuted(false);
DeepAdx.setAdVolume(1f);集成示例
gradle
def sdkVer = '2.1.8'
implementation "com.deepadx.sdk:deepadx-core:${sdkVer}"
implementation "com.deepadx.sdk:deepadx-adapter-gdt:${sdkVer}"
implementation 'com.deepadx.thirdparty:gdt-union-normal:4.640.1510'
implementation "com.deepadx.sdk:deepadx-adapter-gg:${sdkVer}"
implementation 'com.google.android.gms:play-services-ads:24.9.0'从 2.1.7 升级
| 变更项 | 说明 |
|---|---|
| 全局静音 / 音量 | 新增 API,未调用则行为与 2.1.7 一致 |
| Maven 坐标 | 无 Breaking Change,改版本号即可 |
2.1.7
发布日期: 2026-09-17
重要变更(Breaking Change)
- 渠道模块名与 iOS 对齐:
deepadx-adapter-ylh→deepadx-adapter-gdt,deepadx-adapter-admob→deepadx-adapter-gg。 - 运行时 tag 不变(GDT 仍为
ylh,GG 仍为gg),后台广告源无需修改。 - 旧 Maven 坐标不再发布。
集成示例
gradle
def sdkVer = '2.1.7'
implementation "com.deepadx.sdk:deepadx-core:${sdkVer}"
implementation "com.deepadx.sdk:deepadx-adapter-gdt:${sdkVer}"
implementation 'com.deepadx.thirdparty:gdt-union-normal:4.640.1510'
implementation "com.deepadx.sdk:deepadx-adapter-gg:${sdkVer}"
implementation 'com.google.android.gms:play-services-ads:24.9.0'从 2.1.6 升级
| 变更项 | 说明 |
|---|---|
| GDT | deepadx-adapter-ylh 改为 deepadx-adapter-gdt |
| GG | deepadx-adapter-admob 改为 deepadx-adapter-gg |
| 协议 tag | 仍为 ylh / gg,无需改后台 |
完整说明见 Android 接入文档。
2.1.6
发布日期: 2026-07-12
重要变更(Breaking Change)
- 全渠道 adapter 均为瘦身 AAR,须按渠道成对引入 adapter + 三方 SDK(不仅限于 BD / Pangle)。
- 三方坐标统一:
baidu-mobads-sdk、gdt-union-normal、kssdk-ad使用com.deepadx.thirdparty:*。 - 移除 fat-aar / embed 构建,避免 AGP 8.x Duplicate dex。
成对表见 Android 接入文档。
集成示例
gradle
def sdkVer = '2.1.6'
implementation "com.deepadx.sdk:deepadx-core:${sdkVer}"
chinaImplementation "com.deepadx.sdk:deepadx-adapter-csj:${sdkVer}"
chinaImplementation 'com.pangle_beta.cn:mediation-sdk:7.4.1.4'
implementation "com.deepadx.sdk:deepadx-adapter-gdt:${sdkVer}"
implementation 'com.deepadx.thirdparty:gdt-union-normal:4.640.1510'
chinaImplementation "com.deepadx.sdk:deepadx-adapter-bd:${sdkVer}"
chinaImplementation 'com.deepadx.thirdparty:baidu-mobads-sdk:9.432'从 2.1.5 升级
| 变更项 | 说明 |
|---|---|
| CSJ / GDT / KS | 须额外成对三方依赖,不可仅依赖 adapter |
| GDT | 使用 com.deepadx.thirdparty:gdt-union-normal:4.640.1510 |
| 旧 BD 坐标 | 改用 com.deepadx.thirdparty:baidu-mobads-sdk:9.432 |
2.1.5
发布日期: 2026-07-10
重要变更(Breaking Change)
deepadx-adapter-bd不再 fat-embed BD SDK(2.1.1 fat 版开屏必崩)。须额外依赖:gradleimplementation 'com.deepadx.sdk:deepadx-adapter-bd:2.1.5' implementation 'com.deepadx.thirdparty:baidu-mobads-sdk:9.432'deepadx-adapter-pag须单独依赖 Pangle 海外 SDK:gradleglobalImplementation 'com.deepadx.sdk:deepadx-adapter-pag:2.1.5' globalImplementation 'com.pangle.global:ads-sdk:6.5.1.2'
功能优化
- 首次启动无本地 filter 时不再误报
No value for supplierserror 日志。 ruleInfo落盘与reloadStrategyFromDisk修复;PagUtil 异常日志增强。- Maven POM 生成修复(
adapter-bd/adapter-pag)。
集成示例
gradle
def sdkVer = '2.1.5'
implementation "com.deepadx.sdk:deepadx-core:${sdkVer}"
chinaImplementation "com.deepadx.sdk:deepadx-adapter-csj:${sdkVer}"
chinaImplementation "com.deepadx.sdk:deepadx-adapter-bd:${sdkVer}"
chinaImplementation 'com.deepadx.thirdparty:baidu-mobads-sdk:9.432'
globalImplementation "com.deepadx.sdk:deepadx-adapter-pag:${sdkVer}"
globalImplementation 'com.pangle.global:ads-sdk:6.5.1.2'从 2.1.1 升级
| 变更项 | 说明 |
|---|---|
| BD | 须额外 baidu-mobads-sdk:9.432,勿与 2.1.1 fat 版混用 |
| Pangle | 须额外 com.pangle.global:ads-sdk:6.5.1.2 |
| 策略日志 | 首次 load 不再误报 suppliers 解析 error |
2.1.0
发布日期: 2026-06-30
重要变更
- 错误码统一为 2000–2017,与 iOS 一致,便于跨端排查。
- 废弃旧版
99_前缀错误码;请在onAdFailed中按 错误码汇总 处理。 - 全渠道均无填充时返回 2006;策略未配置、无渠道等场景返回更明确的错误码(如 2004、2005、2007、2014)。
功能优化
- 初始化后不再批量拉取全部广告位策略;各广告位在 load 时按需拉取,并优先使用本地缓存。
- 修复首次加载时因策略尚未就绪导致的失败问题。
集成示例
gradle
implementation 'com.deepadx.sdk:deepadx-core:2.1.0'
implementation 'com.deepadx.sdk:deepadx-adapter-csj:2.1.0' // 国内 CSJ,与 pag 二选一
// 其他渠道模块版本号统一 2.1.0从 2.0.x 升级
| 变更项 | 说明 |
|---|---|
| 错误码 | 9906、99_3 等旧码改为 2000–2017 |
| 策略加载 | 由 init 批量拉取改为各广告位 load 时按需拉取 |
| 错误处理 | 请更新 onAdFailed 中的错误码判断逻辑 |
可选模块(Maven)
| 模块 | artifactId |
|---|---|
| 核心 | deepadx-core |
| CSJ | deepadx-adapter-csj |
| PAG | deepadx-adapter-pag |
| GG | deepadx-adapter-gg |
| GDT | deepadx-adapter-gdt |
| BD | deepadx-adapter-bd |
| KS | deepadx-adapter-ks |
Flutter 版本记录
1.0.3 最新
发布日期: 2026-11-09
重要变更
- 桥接海外广告全局静音 / 音量:
DeepAdxFlutterSdk.setAdMuted、setAdVolume。 - 默认 Android 原生依赖升级至
deepadx-core2.1.8;iOS 对齐DeepAdxSDK2.0.6。 - 可在
init前后调用;未调用不干预各渠道默认声音。当前生效渠道:海外。
dart
await DeepAdxFlutterSdk.setAdMuted(true);
await DeepAdxFlutterSdk.setAdVolume(0);
// 非静音:
await DeepAdxFlutterSdk.setAdMuted(false);
await DeepAdxFlutterSdk.setAdVolume(1);集成示例
yaml
dependencies:
deepadx_sdk: ^1.0.3从 1.0.2 升级
| 变更项 | 说明 |
|---|---|
| 全局静音 / 音量 | 新增 API,未调用则行为与 1.0.2 一致 |
默认 deepadx-core | 2.1.7 → 2.1.8 |
iOS DeepAdxSDK | 文档 / 示例 2.0.5 → 2.0.6 |
1.0.2
发布日期: 2026-09-17
Bug 修复
- 修复 Android
DeepAdxFlutterSdk.sdkVersion()误返回0.1.0,改为运行时读取deepadx-core真实版本(当前 2.1.7),与 iOS 对齐。 - 新增
DeepAdxFlutterSdk.flutterVersion常量(插件版本 1.0.2)。
集成示例
yaml
dependencies:
deepadx_sdk: ^1.0.2从 1.0.1 升级
| 变更项 | 说明 |
|---|---|
Android sdkVersion() | 0.1.0 → 2.1.7(deepadx-core) |
| 插件版本常量 | DeepAdxFlutterSdk.flutterVersion |
| Dart 广告 API / 宿主 adapter | 不变 |
1.0.1
发布日期: 2026-09-17
重要变更
- 默认 Android 原生依赖升级至
deepadx-core2.1.7。 - 宿主渠道 adapter 坐标与 iOS 对齐:
deepadx-adapter-ylh→deepadx-adapter-gdt,deepadx-adapter-admob→deepadx-adapter-gg。 - Dart API 无变更;运行时渠道 tag 仍为
ylh/gg。
集成示例
yaml
dependencies:
deepadx_sdk: ^1.0.1从 1.0.0 升级
| 变更项 | 说明 |
|---|---|
默认 deepadx-core | 2.1.6 → 2.1.7 |
| 宿主 GDT adapter | deepadx-adapter-ylh → deepadx-adapter-gdt |
| 宿主 GG adapter | deepadx-adapter-admob → deepadx-adapter-gg |
| Dart API / 运行时 tag | 不变 |
1.0.0
发布日期: 2026-09
首个正式发布版本。封装 Android / iOS 原生聚合 SDK,提供开屏、插屏、激励视频、横幅、原生信息流统一 Dart API。
