gromore_ads_kit 2.0.2

GroMore 广告聚合 Flutter 核心插件，支持 Android、iOS 和 HarmonyOS 的开屏、 插屏、Banner、激励视频、信息流和 Draw 信息流广告，第三方 ADN 可按需接入。

2.0.2

• 修复 iOS 滑动关闭激励广告后，Flutter 滚动或侧滑返回可能卡住的问题。 使用独立原生页面承载广告，避免广告内部未消费的触摸进入隐藏的 Flutter 页面， 并在承载页退出后发送关闭事件。调用方无需接入手势恢复逻辑。
• 激励广告承载页使用透明的覆盖全屏展示，保留下层业务页面，避免关闭广告时短暂露出黑底。

2.0.1

• 修复 iOS 激励广告奖励验证结果的解析，兼容原生回调中的 verify 字段， 避免已验证的奖励被误判为未验证。
• 保持 Android、HarmonyOS 的 verified 字段兼容，支持顶层和 extra 中的 布尔、数字及字符串验证结果，并补充回归测试。

2.0.0

• 核心包只携带 GroMore/穿山甲，优量汇、百度、Sigmob、快手 分别拆到 gromore_ads_kit_gdt、gromore_ads_kit_baidu、 gromore_ads_kit_sigmob、gromore_ads_kit_ks，避免宿主被迫集成所有 ADN。
• 新增 gromore_ads_kit_all 全家桶；只在确实需要四家 ADN 时使用。
• 官方预览工具拆到 gromore_ads_kit_debug_tools。Android 使用 debugImplementation，Release 不打入测试 AAR；iOS 发布前应移除该扩展包。
• Android GroMore、测试工具和 ADN Adapter 使用字节跳动正式 Maven 远程坐标； 没有验证到公开远程坐标的百度、Sigmob、快手原生 SDK 只保留在各自扩展包中。
• Android 核心包保留穿山甲 TTFileProvider；优量汇的 Provider 和路径资源移动到 GDT 扩展包。
• iOS GroMore 升级到 Ads-CN-Beta 7.8.0.2；四家 ADN SDK 与 Adapter 移到各自 扩展包。
• HarmonyOS 核心包只保留 @csj/openadsdk 7.5.3；GDT 和快手依赖移动到对应扩展。
• 使用 flutter_platform_utils 的 PlatformUtils.isOhos 判断鸿蒙，核心 Dart 代码 不再直接引用 TargetPlatform.ohos，可由标准版 Flutter 分析和测试。

1.0.1

• Android 内置优量汇 SDK 4.680.1550 和匹配的 GroMore Adapter 4.680.1550.1，与 GroMore 后台导出的 beta Maven 接入配置保持一致。
• 移除未实际应用、也不能自动引入三方 ADN SDK 的 mediation-auto-adapter 构建脚本依赖。
• 补充 Android 第三方 ADN 的接入边界和 Sigmob 本地 AAR 接入说明。

1.0.0

• 新增 HarmonyOS/OpenHarmony 插件平台，实现 GroMore SDK 初始化、隐私控制、 开屏、插全屏、激励视频、Banner、信息流和 Draw。
• HarmonyOS Feed/Draw 改用官方聚合混出链路，同时支持模板与原生自渲染； 内置 ArkUI 布局完成物料展示、唯一组件 ID、计费点击区、dislike 和视频回调。
• HarmonyOS 直连穿山甲新增原生自渲染 Banner，通过 harmonyNativeRender: true 显式开启；GroMore 聚合 Banner 仍按官方限制使用模板。
• HarmonyOS 核心 SDK 使用官方 OHPM @csj/openadsdk 7.5.3，补齐仓库、权限、 可选快手/广点通 Adapter 和 runtimeOnly 接入文档。
• 新增独立 gromore_ads_kit_ohos.dart 入口，在保留普通 Flutter Android/iOS 编译兼容性的同时注册 OhosView。
• initAd 新增 HarmonyOS appName、allowShowNotify，AdPrivacyConfig 新增 OAID 授权与宿主 OAID 字段。
• 开屏新增 SplashAdHarmonyOptions 和 CSJSplashUserData 兜底映射。
• 明确记录 HarmonyOS 1.0.0 的 waterfall 明细、预览工具和真机验收边界。
• 修正 Flutter/Dart 最低版本约束，兼容标准 Flutter 3.41.6 自带的 Dart 3.11.4；HarmonyOS 初始化按官方要求使用 UIAbilityContext。
• iOS GroMore 更新到 CocoaPods 官方当前最新版 Ads-CN 7.7.0.8。

0.3.0

• 新增跨平台 AdPrivacyConfig，完整接入 Android TTCustomController、 MediationPrivacyConfig 与 iOS BUAdSDKPrivacyProvider、IDFA 和设备信息开关。
• 新增公开的 GromoreAdsKit.isReady，支持开屏、插屏、激励视频、Banner、 信息流和 Draw 信息流。
• 新增 GromoreAdsKit.getAdLoadInfo，结构化返回 Android/iOS 每个 ADN 的 waterfall 加载结果。
• Android Feed/Draw PlatformView 支持模板和自渲染广告，自动注册展示、点击和 dislike 交互。
• iOS Feed/Draw PlatformView 支持模板和自渲染物料，补齐物料布局与点击区域注册。
• Android/iOS Banner 补齐混合信息流默认布局；Android PlatformView 接入 dislike。
• 新增自定义 ADN 接入边界说明和 0.2.0 到 0.3.0 迁移说明。

0.2.0

• Android GroMore SDK 升级到 7.7.1.6，并按官方要求加入 OkHttp 3.12.1。
• Android 编译环境对齐 Flutter 3.41：compileSdk 36、Java 17、AGP 8.11.1、Kotlin 2.2.20。
• iOS Ads-CN 升级到 7.7.0.7，最低系统版本提高到 iOS 13.0。
• iOS 测试工具改为通过 canImport 检测宿主 Debug framework，避免测试包进入 Release。
• 移除过时的 Android 内置 tools-release.aar，改为运行时检测宿主 Debug 依赖。
• 更新隐私、ATT、SKAdNetwork、多进程、ABI 和测试工具接入文档。
• 适配 GroMore 7.2+ 已移除的激励视频“再看一次”和 iOS 开屏 ZoomOut 接口。
• 插屏、激励视频在展示前严格检查 isReady，并补齐 Android 展示后 eCPM 事件。
• 修正 Dart eCPM 对 Android/iOS 当前原生字段名的解析。
• 按官方能力限制 Banner、Draw 信息流通用预加载。
• iOS 广告请求增加 SDK 初始化状态检查。
• 新增 0.1.0 到 0.2.0 迁移说明。

0.1.0

• 使用 Flutter 3.41.10 和 Dart 3.11.5 创建插件骨架。
• 支持 Android 和 iOS。
• 支持开屏、插屏、Banner、激励视频、信息流和 Draw 信息流广告。
• 支持广告事件、错误、奖励和 eCPM 回调。
• 保留上游 MIT 许可证并记录来源版本。