跳转至

SDK Native 发布说明

本指南介绍 Hive SDK Native 各版本的主要更新。

Hive SDK Native 各目标操作系统的更新通过以下操作系统标签区分。

  • Android SDK Native Android 更新
  • iOS SDK Native iOS 更新
  • Windows SDK Native Windows 更新
  • 全部 SDK Native Android、iOS 和 Windows 更新

必需项

使用 Hive SDK 各发布版本之前,我们指导您进行与版本特定限制相关的必需设置。

  • 使用 Hive SDK v4 Native 25.0.0 或更高版本时,必须获取安全密钥(../../operation/appcenter/securitykey_settings.md)。
    • 由于身份验证安全协议的变更,使用 Hive SDK v4 Native 25.0.0 或更高版本时,您必须从Hive 控制台 > 安全密钥设置获取安全密钥(../../operation/appcenter/securitykey_settings.md)。如果您未获取安全密钥,则将无法登录应用程序。
  • Hive SDK v4 Native 25.1.3 或更高版本需要对 PG 支付实现进行更改
    • 要在 Android 25.1.3 或更高版本上实现 PG 支付,您必须参考 [PG 支付操作流程]PG 支付操作流程 修改 PG 支付实现代码。

v4.26.1.5

按目标操作系统的 SDK 发布日期
SDK Native iOS 2026-03-20

已修复的错误

  • iOS 修复了在 iOS 26.4 环境下使用 WebView 的弹出窗口(登录、横幅、客户服务、社区等)无法正常工作的错误。

v4.26.0.2

按目标操作系统的 SDK 发布日期
SDK Native iOS 2026-03-20

已修复的错误

  • iOS 修复了在 iOS 26.4 环境下使用 WebView 的弹出窗口(登录、横幅、客户服务、社区等)无法正常工作的错误。

v4.25.9.1

按目标操作系统的 SDK 发布日期
SDK Native iOS 2026-03-20

已修复的错误

  • iOS 修复了在 iOS 26.4 环境下使用 WebView 的弹出窗口(登录、横幅、客户服务、社区等)无法正常工作的错误。

v4.25.8.3

按目标操作系统的 SDK 发布日期
SDK Native iOS 2026-03-20

已修复的错误

  • iOS 修复了在 iOS 26.4 环境下使用 WebView 的弹出窗口(登录、横幅、客户服务、社区等)无法正常工作的错误。

v4.26.1.4

按目标操作系统的 SDK 发布日期
SDK Native Android 2026-03-05

更改的功能

Authentication

  • Android 已将使用凭据管理器登录 Google 的功能更改为“选择加入”。
  • 更改原因:在某些支持 16 KB 页面大小的 Android 16(API 级别 36)设备上,通过凭据管理器登录 Google 存在兼容性问题。
  • 主要更改:已将 Google 登录方式恢复为现有的 Google 登录方式。
  • 未来计划:未来版本的 Hive SDK Android 将提供一个 API,用于将“使用凭据管理器登录”设置为默认登录方式。

v4.26.1.3

按目标操作系统的 SDK 发布日期
SDK Native Android 2026-02-06
SDK Native iOS 2026-02-06

已修复的错误

Authentication

  • iOS 修复了在 iPad 设备上,触摸 AgeGate 弹出窗口(需要输入出生日期信息)或日历相关弹出窗口中的空白区域时,应用程序会冻结(无响应)的错误。
  • iOS 修复了在 iOS 设备上运行设备管理服务时,某些弹出窗口中显示不必要的滚动条的错误。

Billing

  • iOS 修复了调用 getAccountUUID 方法时返回值发生变化的错误。

Promotion

  • Android 修复了当游戏应用在后台运行时,如果发生用户互动(UE)直接链接事件,促销弹窗就会消失的错误。

Marketing Attribution

  • iOS 修复了在分辨率低于 1170px 的 iOS 设备上无法显示《数字市场法》(DMA) 同意横幅的部分文本的错误。

v4.26.1.2

按目标操作系统的 SDK 发布日期
SDK Native Android 2026-01-23
SDK Native iOS 2026-01-23

更改的功能

Authentication

  • All 如果您在登录中国区HYIVE会员账户时已验证过手机号码,我们将更改流程,以便您在进行中国实名验证时直接进行身份验证,无需再次验证手机号码。
  • 由于现有的HYIVE会员登录流程仅验证您的会员ID(邮箱地址),而不验证您的手机号码,因此您必须在后续的中国实名验证步骤中验证您的手机号码。

已修复的错误

  • iOS 修复了由于在 Apple 提交过程中包含了错误生成的捆绑文件 Info.plist 而导致分发版本验证失败的错误。
  • iOS 修复了退款用户重新付款界面中 PG 付款显示为 Hive Store 的错误。

v4.26.1.0

按目标操作系统的 SDK 发布日期
SDK Native Android 2026-01-13
SDK Native iOS 2026-01-13

检查此 SDK 版本的开发环境

新功能

Authentication

  • All 我们提供了 AuthV4.checkAgeGate 方法,该方法会显示一个弹出窗口供用户输入出生日期,并在用户输入日期后以回调函数的形式返回该值。
  • All 添加了 AuthV4.setAutoLoginEnabled 方法(../../dev/authv4/login-helper.md#set-auto-login-enabled),该方法会将下一个登录会话(而非当前会话)注册为自动登录会话(ON/OFF)。当设置为 ON 时,如果通过登录方法执行登录操作,则该登录会话将被保存为自动登录会话。之后,可以通过执行 AuthV4.Helper.signIn 或在登录期间执行带有 ProviderType.AUTOAuthV4.signIn 来使用自动登录功能。
  • Android 支持使用小米账号登录

Billing

Promotion

  • All 它支持延迟深度链接,即使应用安装完成,点击直接链接后,尚未安装应用的用户也会被重定向到链接中指定的应用内页面。

Add-ons

  • Android 在游戏内 WebView 中打开 提供了一个选项,可以在使用 PlatformHelper 类的 showInWebView 方法公开 WebView 时使用游戏 Activity 而不是 Hive Activity。

Others

  • All 您可以使用 Configuration 类中的 getGameLanguage 方法检查 SDK 中配置的语言设置。
  • iOS CocoaPod 服务终止后,我们通过 SPM(Swift Package Manager)提供分发服务。

更改的功能

Authentication

  • All 我们支持通过网页和应用程序进行年龄验证。
  • All 移除 通过 SNS 登录时自动收集个人资料图片和昵称。
  • All 通过添加 AuthV4.setAutoLoginEnabled(默认值:PC 关闭/移动设备开启),自动登录行为策略更改如下:
  • 之前:在账户冲突后切换到其他账户时,新账户在移动设备上保持自动登录,但在 PC 上禁用自动登录。
  • 更改后:在账户冲突后切换到其他账户时,如果已使用 AuthV4.setAutoLoginEnabled 注册了自动登录会话,则新账户在移动设备和 PC 上均保持自动登录;否则,禁用自动登录(存在例外情况)。
  • Android 更改设置,以便在使用 Google 登录时同时使用凭据管理器和 Play 服务身份验证。在凭据管理器故障转移期间,尝试使用 Play 服务身份验证登录。

Billing

  • Android 将用于 Google Play 结算的库更改为 Google Play 结算库 8.0。

Promotion

  • All 修复了通过自定义视图/直接视图导航到外部浏览器时 WebView 闪烁的错误。

Push

  • iOS 在收集推送通知的令牌时,根据构建环境更改收集其他令牌信息的方法。

Marketing Attribution

  • All 显示 DMA 同意横幅 的弹出窗口设计已更改,其行为也已改进。
  • 现有同意横幅的先前同意历史记录将被保留,重新显示时,将显示一个文本和用户界面均已改进的新同意横幅。
  • 如果您之前为现有同意横幅使用了自定义文本,则必须参考自定义同意横幅用户界面设置 重新配置文本,以匹配更改后的数据结构。
  • All 做出更改是为了防止将同一收据的重复销售记录发送到 MMP。
  • All 新增了在发送 Firebase 购买事件时,将销售额也发送到“value”键的功能。
  • 此前,销售额被发送到“revenue”键。

Add-ons

  • All 改进了 PlatformHelper 类的 showInAppView 方法在 打开游戏内 WebView 中显示的 WebView 关闭按钮的可见性。

Provisioning

  • All 我们单独提供年龄范围 API,以便根据《应用商店责任法案》的要求进行应用。
  • 《应用商店责任法案》将于2026年1月1日在美国德克萨斯州生效,目前暂缓实施,可根据开发情况选择性地应用。
  • 也可选择性地应用,以符合将于2026年5月在美国犹他州和2026年7月在美国路易斯安那州生效的《应用商店责任法案》。

Library updates

  • Android 亚马逊应用商店 (Android) v3.0.4 → v3.0.8
    • 三星 GalaxyStore IAP (Android) v6.1.1 → v6.5.0
    • Google 计费库 (Android) v7.0.0 → v8.0.0
    • QQ (安卓) v3.5.17 → v3.5.18
    • 小米 (Android) v3.2.5_12798 → v3.4.6
  • iOS Adjust (iOS) 5.4.3 → 5.4.6
  • Airbridge (iOS) 4.7.0 → 4.8.1
  • AppsFlyer (iOS) 6.17.2 → 6.17.7
  • Firebase (iOS) 11.15.0 → 12.5.0
  • Singular (iOS) 12.8.1 → 12.9.0
  • Facebook (iOS) 18.0.0 → 18.0.2
  • Line (iOS) 5.13.0 → 5.14.0
  • QQ (iOS) 3.5.17.5 → 3.5.18
  • SDWebImage (iOS) 5.21.1 → 5.21.5

Others

  • All Configuration.setZone 的行为已更改为仅在初始化之前有效。

已修复的错误

  • Android 如果整个公共区域的 UI 背景是不透明的,请对其进行修改,使其在镂空区域内可见。

Authentication

  • iOS 修复了在使用聊天机器人时聊天消息输入字段间歇性不显示的错误。
  • iOS 修复了以下错误:当设备管理中已注册的设备数量超过限制时,如果已注册的设备在通过成人验证后被删除,则成人验证弹出窗口会重新出现。

Promotion

  • iOS 修复了当新闻项目数量超过一定限制时,新闻菜单无法正常工作的错误。
  • iOS 修复了当正面横幅上显示的图像宽度或高度为“0”或服务器传输错误信息时,系统无法正常运行的错误。
  • iOS 修复了通过直接链接公开社区时,如果缺少 URL 参数则直接链接无法正常工作的错误。

Push

  • Android 修复了即使针对 COPPA 目标也会收集推送通知令牌的错误。
  • iOS 修复了 ForegroundPush 设置未更改为 False 的错误。

Marketing Attribution

  • iOS 修复了 Firebase 中缺少安装或更新事件的错误。

Add-ons

  • iOS 修复了当游戏应用程序用户的网络状态离线或当应用 PlatformHelper 类的 showInAppBrowser 方法时,游戏应用程序会闪烁并且窗口会关闭的问题。打开游戏内浏览器

v4.26.0.1

按目标操作系统的 SDK 发布日期
SDK Native Android 2025-12-18
SDK Native iOS 2025-12-18

更改的功能

  • iOS Hive SDK 开发环境的 Xcode 版本将进行如下更改。
  • 原版本:Xcode 26.2 Beta2
  • 更改版本:Xcode 26.2

Provisioning

  • Android 为遵守《应用商店责任法》,Hive SDK 支持的 Google Play Age Signals API 版本将进行如下更改。
  • 原版本:0.0.1-Beta2
  • 更改版本:0.0.2

v4.26.0.0

按目标操作系统的 SDK 发布日期
SDK Native Android 2025-12-08
SDK Native iOS 2025-12-08

检查此 SDK 版本的开发环境

新功能

  • iOS 您可以在 iOS Xcode 26.2 或更高版本上构建 Hive SDK。
  • 最低支持的操作系统版本为 iOS 15

Provisioning

  • Android 合规性 是一项新功能。
  • 当向 Google Play 和 Amazon Appstore 分发游戏应用时,Hive SDK 提供 年龄范围 API 来检查用户年龄范围,以符合将于 2026 年 1 月 1 日在美国德克萨斯州生效的《应用商店责任法案》。
  • iOS 新增合规性功能。
  • 将游戏应用分发到 Apple App Store 时,Hive SDK 提供*年龄范围 API*,用于检查用户年龄范围,以符合将于 2026 年 1 月 1 日在美国德克萨斯州生效的《App Store 责任法案》。
  • 仅支持 iOS 26.2 或更高版本。

已知问题

Provisioning

  • Android 根据《App Store 责任法》,Hive SDK 26.0.0 Beta 支持的 Google Play Age Signals API 版本 0.0.1-beta02 不能用于接收实际年龄信号的用户环境。 ※ 如需接收实际年龄信号,请更新至 Hive SDK v4.26.0.1,该版本支持 Google Play Age Signals API 版本 0.0.2(非测试版)。

v4.25.9.0

按目标操作系统的 SDK 发布日期
SDK Native Android -
SDK Native iOS -

注意:此 SDK 版本不提供单独的发行文件,该功能包含在 SDK 的更高版本中。

新功能

Authentication

  • All 已提供身份验证服务(../../dev/authv4/verification.md)。
  • SteamDeck 不提供身份验证服务(身份验证、年龄验证、家长同意)。您必须在移动设备或电脑上使用身份验证服务,然后通过 SteamDeck 再次访问游戏。

v4.25.8.0

按目标操作系统的 SDK 发布日期
SDK Native Android 2025-10-02
SDK Native iOS 2025-10-02

检查此 SDK 版本的开发环境

新功能

  • Android 支持 Android OS 16(API 级别 36)。
  • Android 在 Android OS 15(API 级别 35)或更高版本上构建时,支持 16KB 页面大小的构建。

更改的功能

  • Android 移除不再使用的 android.permission.FOREGROUND_SERVICE 权限。
  • Android Android 最低构建目标从 19 更改为 23

Authentication

  • iOS 在 Xcode 26 中构建时移除不可用的库引用。

Library updates

  • Android Adjust(Android)5.2.0 → 5.4.2
  • Airbridge(Android)4.3.0 → 4.7.1
  • AppsFlyer(Android)6.16.2 → 6.17.3
  • Firebase-analytics(Android)22.1.2 → 23.0.0
  • Singular(Android)12.7.0 → 12.10.0
  • Facebook(Android)17.0.0 → 18.0.1
  • Line(Android)5.10.0 → 5.11.1
  • play-services-auth(Android)(Google 登录)20.7.0 → 21.3.0
  • play-services-games-v2(Android)(Play 游戏服务)20.1.2 → 21.0.0
  • play-services-ads-identifier(Android)18.0.1 → 18.2.0
  • play-services-analytic(Android)18.0.4 → 18.1.1
  • firebase messaging(Android)24.0.2 → 25.0.0
  • onestore(Android)21.01.00 → 21.02.01
  • google-core-review(Android)2.0.1 → 2.0.2
  • reCAPTCHA(Android)18.6.1 → 18.7.1
  • Kotlin(Android)1.9.22 → 2.1.21
  • iOS Adjust(iOS)5.2.0 → 5.4.3
  • Airbridge(iOS)4.3.0 → 4.7.0
  • AppsFlyer(iOS)6.16.1 → 6.17.2
  • Firebase(iOS)11.6.0 → 11.15.0
  • Singular(iOS)12.7.1 → 12.8.1
  • Facebook(iOS)17.4.0 → 18.0.0
  • Google 登录(iOS)8.0.0 → 9.0.0
  • Line(iOS)5.11.2 → 5.13.0
  • QQ(iOS)3.5.17.4 → 3.5.17.5
  • SDWebImage(iOS)5.20.0 → 5.21.1
  • Recaptcha(iOS)18.6.0 → 18.7.0

已修复的错误

Authentication

  • iOS 修复了聊天机器人弹出窗口显示时,偶尔会显示横屏模式而不是竖屏模式的错误。
  • iOS 修改代码以防止空数组引用错误。
  • 使用 Authv4 类的 showConflict 方法时,如果缺少必需的输入数据,则会发生崩溃。

Analytics

  • Android 修改为防止在同时发生客户端传输故障时重新传输不必要的信息。

v4.25.7.0

按目标操作系统的 SDK 发布日期
SDK Native Android -
SDK Native iOS -

注意:此 SDK 版本不提供单独的发行文件,该功能包含在 SDK 的更高版本中。

新功能

Authentication

更改的功能

Authentication

  • All 如果您在 Hive 控制台中配置应用启用年龄验证,则登录后将自动执行年龄验证流程。
  • 此功能仅在韩国受支持。
  • All 用于执行年龄验证的 showAdultConfirm 方法已被弃用。
  • showAdultConfirm 方法可能会在未来的更新中被移除。

v4.25.6.0

按目标操作系统的 SDK 发布日期
SDK Native Android 2025-07-31
SDK Native iOS 2025-07-31

新功能

Chat

  • All 新增一项功能,允许您表达或标记“喜欢”特定的聊天消息。
  • All 它提供的信息允许您对特定的聊天消息进行“回复”,或指示回复连接关系。
  • All 它提供了提及特定用户或提供有关提及用户的信息的功能。

更改的功能

Chat


v4.25.5.2

按目标操作系统的 SDK 发布日期
SDK Native iOS 2025-07-30

已修复的错误

Authentication

  • iOS 修复了在横屏模式下显示聊天机器人时发生的崩溃错误。

v4.25.5.1

按目标操作系统的 SDK 发布日期
SDK Native Android 2025-07-23
SDK Native iOS 2025-07-23

新功能

Authentication

  • All 我们新增了【多账号切换】功能。相关功能详情如下:
  • 将当前登录账号保存到设备
  • 查看已保存的账号
  • 注销并删除已保存的账号
  • 快速登录其他已保存的账号

Promotion

Notification

  • All 新增了一个推送操作按钮
  • 当收到推送通知时,您可以通过推送选择操作按钮执行预定义的操作。

Chat

  • All 发送消息
  • 新增自动将聊天消息翻译成用户语言以及翻译特定消息的功能。
  • 新增仅供特定语言用户接收的公告消息功能。
  • 为 WebSocket 消息添加消息 ID 值,以确保回调顺序。
  • All 频道
  • 新增进入聊天频道时查看历史对话记录的功能。
  • 显示当前频道参与人数。
  • 提供频道列表排序功能。
  • All 事件管理
  • 添加聊天以二进制形式发送自定义数据事件的功能
  • All 连接管理
  • 添加了重新连接功能。

Hercules

  • Android 20241125-2 -> 20250527
  • iOS 20241120 -> 20250218

更改的功能

  • Android 更新构建所需的混淆规则。
  • iOS 之前单独提供的 HiveAppTrackingTransparents.framework 库已集成到 Service.framework 中。

Authentication

  • All 我们修改了 showMyInquiry 方法,以便在使用时显示查询页面,而此前在未使用 Hive 会员帐户时,该方法不起作用。
  • Android 将 VK 身份验证弹出窗口从 WebView 更改为应用内浏览器。

Marketing Attribution

  • iOS 为支持启用后自动收集 Firebase 购买事件而进行的更改。

已修复的错误

Promotion

  • iOS 修改 iPad 设备上新闻界面的边角曲率。

Provisioning

  • iOS 修改网页视图,使其在显示条款和条件时不滚动。

Analytics

  • iOS 修改逻辑,以便在条款协议完成后立即传输分析日志。

已知问题

Others

  • iOS 在横屏模式下使用聊天机器人时,会出现崩溃错误。
  • 请将 Hive SDK 更新至 Unity iOS 25.5.2 或更高版本。

v4.25.2.2

按目标操作系统的 SDK 发布日期
SDK Native Android 2025-06-23

检查此 SDK 版本的开发环境

更改的功能

Authentication

  • Android 由于部分用户因兼容性问题无法访问 Google 凭据管理器,我们将身份验证方法回滚到现有的 Google 登录

Library updates

  • Android * Google Play 服务身份验证(Android)v20.7.0(重新引入 Google 登录回滚支持)
  • Google 凭据 Play 服务身份验证(Android)v1.3.0(移除 Google 登录回滚支持)

v4.25.2.1

按目标操作系统的 SDK 发布日期
SDK Native Android 2025-05-14

检查此 SDK 版本的开发环境

已修复的错误

Marketing Attribution

  • Android 修复了用于 MMP 服务集成 的 Hive SDK 标识符中缺少“did”值的错误。

v4.25.2.0

按目标操作系统的 SDK 发布日期
SDK Native Android 2025-04-29
SDK Native iOS 2025-04-29

更改的功能

Authentication

  • All 我们正在提供更新的 VK 身份验证方法。新的身份验证方法可在新版 VK 开发者控制台中找到。
  • iOS 更新了已弃用的用于 Apple GameCenter 登录的 GameKit API 的验证协议。
  • Android 由于 Google 登录库已停止支持,我们将改用 Google 凭据管理器 和 AuthorizationClient API 进行隐式和显式登录身份验证。

Billing

  • Android 如果通过 PG 付款购买的产品被退款,则添加 order_id 值以将其与之前的交易区分开来。
  • Android 当 PG 付款交易完成后,更改购买完成日志以通过营销归因发送。

Promotion

  • Android 已进行更改,以便在分享用户获取信息时,将其添加到 Telegram 支持的曝光列表中。
  • Android 显示 WebView 时更改缓存策略。

Marketing Attribution

  • All 此外,还要发送 Hive SDK 标识符以支持 MMP 服务集成
  • All 手动跟踪事件时,可通过添加自定义属性更改为发送。
  • Android 启动 Airbridge 时,市场源信息传输方式的变更。
  • iOS 使用 sendEventWithAttributes API 时,将“语义值”类型的浮点值的精度范围从“float”更改为“double”。

Provisioning

  • All 在“条款与条件详情”和“回放”页面上,系统在以下情况下会进行调整,打开一个新的外部浏览器窗口加载内容,而不是使用“条款与条件”页面(WebView):
  • 当导航到“条款与条件”网址之外的网页时
  • 当点击“条款与条件”页面内的超链接 HTML 标签(例如 标签、 等)时

Library updates

  • Android Airbridge(Android)v4.1.0 → v4.3.0
  • Adjust(Android)v5.0.1 → v5.2.0
  • Singular(Android)v12.6.1 → v12.7.0
  • AppsFlyer(Android)v6.15.2 → v6.16.2
  • Google Play 服务授权(Android)v20.7.0(已停止支持)
  • Google 凭据 Play 服务授权(Android)v1.3.0(新增支持)
  • iOS 空桥 (iOS) v4.1.1 → v4.3.0
    • 调整(iOS) v5.0.1 → v5.2.0
    • 单数 (iOS) v12.6.1 → v12.7.1
    • AppsFlyer (iOS) v6.15.3 → v6.16.1
    • QQ (iOS) 3.5.17.3 → 3.5.17.4

Chat

  • All 发送或接收消息数据时,会发送和接收额外的“extraData”。
  • All 连接到聊天服务器时,不再传输extraData
  • All 此外,接收整数时间值而不是字符串时间值。
  • All 修改为防止在通信不可能的情况下(例如网络阻塞),由于未能正确释放 WebSocket 而尝试重新连接时出现重复连接导致的失败。

已修复的错误

  • Android 修改代码,以便在需要通过网络进行通信重试或访问分布式服务器的情况下,如果在设定的最大超时时间之前收到响应,则立即执行通信重试或访问分布式服务器,而无需等待超时到期。
  • iOS 修复了当使用 Configuration 类的 setZone 方法更改 Hive SDK 连接的服务器组 Zone 时,hive_config.xml 文件中的 gameLanguage 值被初始化的错误。

Authentication

  • iOS 修复了在运行 iOS 18 或更高版本的设备上 QQ 网页版登录无法正常进行的错误。

Marketing Attribution

  • Android 修复了使用 Adjust 功能确定安装状态时,推送通知显示为空的问题。
  • Android 修改系统,使其在通过 Airbridge 购买多个商品时,根据单价和数量提供销售信息。

Provisioning

  • All 修复了在 SDK 初始化之前初始化广告模块 (Adiz) 时,用于年龄检查的 AgeGate 值在 COPPA 或 GDPR 等合规性情况下基于 hive_config.xml 中设置的值运行的错误。

Chat

  • Android 修复了聊天连接间歇性断开的问题。

已知问题

Marketing Attribution


v4.25.1.3

按目标操作系统的 SDK 发布日期
SDK Native Android 2025-04-10
SDK Native iOS 2025-04-10

检查此 SDK 版本的开发环境

更改的功能

Billing

  • Android 将 PG 支付的行为更改为与其他计费(IAPv4)功能中的市场行为一致。如果您正在使用 PG 支付,则必须参考 PG 支付 文档修改您的代码实现。

Marketing Attribution

已修复的错误

Billing

  • iOS 修复了在显示请求同意传输消费信息的弹出式用户界面时背景变为不透明的错误。
  • iOS 修复了在关闭请求同意传输消费信息的弹出式 UI 时,应用程序屏幕方向会向非预期方向旋转的错误。

Promotion

  • iOS 修复了在显示包含图像的审核弹出窗口时,如果发生旋转事件,则显示的图像会消失的错误。

Marketing Attribution

  • iOS 修复了 Airbridge 在通过 Adiz 传输时将广告收入信息发送给 AdMob 而不是 Adiz 的错误。

v4.25.0.1

按目标操作系统的 SDK 发布日期
SDK Native iOS 2025-03-10

新功能

Marketing Attribution

  • iOS 修复了在使用 Hive SDK v4 25.0.0 或更高版本并应用 Adjust v5 时,SDK 自动收集和发送的 did 和 vid 值未发送的错误。

v4.25.0.0

按目标操作系统的 SDK 发布日期
SDK Native Android 2025-01-24
SDK Native iOS 2025-01-24

新功能

Authentication

Billing

Promotion

  • All 收集登录事件,以便在输入邀请码的用户安装应用程序时提供奖励(../../operation/promotion/ua.md/#_7)。

Matchmaking

  • All 匹配功能已更新,新增支持群组匹配。 ※ 此功能与 Hive SDK 的早期版本接口不兼容。要使用更新后的匹配功能,您必须使用 Hive SDK v4 25.0.0 或更高版本。

Marketing Attribution

Chat

  • All 新增了聊天功能。

更改的功能

Authentication

  • All 删除不再使用的 Auth 模块类、接口、方法、委托和监听器。
  • All 使用 JWT 令牌实施更强大的安全协议。
  • All 由于 TalkPlus 停止支持,TalkPlus 身份验证令牌方法将被移除。
  • Android 除了 Apple Login WebView 中的登录功能外,还允许使用密码恢复等浏览功能。

Marketing Attribution

  • All 更新以支持 Adjust v5。
  • 移除 Adjust Signature 库。
  • All 更改设置,以便在将 Adiz 广告收入与 Adjust 聚合时,将广告收入来源发送到 AdMob 来源。
  • Android 反映了 Appsflyer 广告收入聚合库已集成到主库中。
  • 6.14.2 → 6.15.2
  • 移除 Appsflyer 广告收入库。

Hercules

  • All 2024.11.20

已修复的错误

Authentication

  • Android 解决了在执行 signIn 方法期间发生网络响应延迟时 UI 线程间歇性被占用的问题。

Billing

  • iOS 修复了在使用 UserEngagement 诱导应用内购买时触发额外 IAP_UPDATE 事件的错误。

已知问题

Marketing Attribution

  • iOS 使用 Adjust 时,SDK 自动收集并发送的 did 和 vid 值无法传输,这是一个错误。您需要将 Hive SDK 更新到 v4 25.0.1 或更高版本。

v4.24.5.0

按目标操作系统的 SDK 发布日期
SDK Native Android 2024-11-08
SDK Native iOS 2024-11-08

检查此 SDK 版本的开发环境

新功能

  • All 支持 Unity 6 (Unity 6000)。

Authentication

Promotion

  • All 广告也可以在Spot Banner中显示。
  • Android 我们支持 X(原 Twitter)的用户邀请分享功能。

Matchmaking

更改的功能

Authentication

  • All 修改冲突弹出窗口中显示的提供商名称。

已修复的错误

Billing

  • iOS 当某些产品的价格无法精确地用浮点数表示时,请修改 JSON 格式,将值显示为小数点后的数字,而不是循环小数。
  • 例如:4.99$(字符串)→ 4.9900000000000011(双精度浮点数)→ 4.99(JSON 数字)

v4.24.4.0

按目标操作系统的 SDK 发布日期
SDK Native Android 2024-10-14
SDK Native iOS 2024-10-14

检查此 SDK 版本的开发环境

新功能

Billing

  • Android 在进行 PG 付款请求时,支持使用 IAPv4.purchase 进行多件购买

Marketing Attribution

已修复的错误

Analytics

  • iOS 修复了仅选择同意横幅中的一个选项时,未正确反映的错误。

v4.24.3.0

按目标操作系统的 SDK 发布日期
SDK Native Android 2024-09-03
SDK Native iOS 2024-09-03

检查此 SDK 版本的开发环境

新功能

Provisioning

  • All 在条款和条件屏幕上增加了一项功能,用于检查是否已获得法定代表人的同意。

更改的功能

Authentication

  • All 更改了注销行为。
  • 之前:调用 signOut 时,Hive SDK 会注销用户帐户。 访客在调用 signOut API 时会收到服务器返回的失败响应。
  • 更改后:调用 signOut 时,Hive SDK 会向 Hive 服务器请求确认注销用户帐户是否安全,然后根据服务器响应注销用户帐户。
  • All 注销访客帐户时,不再返回成功响应,而是返回错误代码。它仍然保持访客帐户与 Hive SDK 和 Hive 服务器之间的会话。
  • All 对于已暂停的帐户,设置将更改为自动从身份提供商 (IdP) 注销,以便您可以使用同一 IdP 上的其他帐户登录。此设置仅在无法自动登录时适用。
  • All 在使用 AuthV4.connect 方法执行身份提供商 (IdP) 集成时,请进行相应修改,以便在帐户切换到已暂停帐户时执行注销操作。
  • All 更改设备管理服务,使其根据设备的连接区域自动应用国际电话国家代码。
  • iOS 我们正在更改设置,即使您已拒绝应用跟踪透明度 (ATT) 同意,也允许 Facebook 登录。

Promotion

Marketing Attribution

Library updates

  • Android Google Play结算库 6.1 → 7.0 Google Play服务游戏 20.0.0 → 20.1.2
  • iOS Facebook SDK 16.2.1 → 17.0.2

已修复的错误

  • Android 通过修改资源引用逻辑,修复了无法分配内存的错误。
  • iOS 修复了在 iOS 14 设备上检查 App Tracking Transparency (ATT) 的同意情况时导致间歇性崩溃的错误。
  • iOS 修复了在相册中选择访问限制(仅允许访问部分照片)时导致崩溃的错误。

Notification

  • Android 修复了当设置了不支持的 type 时,本地推送通知 中推送消息显示不正确的错误。
  • iOS 修改以发送应用版本信息。

v4.24.1.3

按目标操作系统的 SDK 发布日期
SDK Native Android 2024-07-25
SDK Native iOS 2024-07-25

检查此 SDK 版本的开发环境

更改的功能

Authentication

  • All 更改设备管理服务,使其根据设备的连接区域自动应用国际电话国家代码。

v4.24.2.0

按目标操作系统的 SDK 发布日期
SDK Native Android 2024-07-05
SDK Native iOS 2024-07-05

新功能

  • All 提供一个函数,用于返回欧盟和欧洲经济区(受 GDPR 约束)内未满 16 周岁的用户是否已同意相关条款。您可以检查用户是否未满 16 周岁。
  • Android 在运行 Android OS 11 或更高版本的设备上,或者在安装了受支持模块的设备上使用相册时,默认使用 PhotoPicker
  • iOS 您可以在 macOS 控制台应用程序中查看 Hive SDK 调试日志,并选择要查看的特定日志类型。

Authentication

  • All 当一个手机号码可注册的账户数量超过限制时,请求发送验证码时会显示一条错误消息,提示“您使用同一个手机号码创建的账户数量已超过限制”。

Promotion

  • All 它提供了一项功能,用于控制交叉推广活动的曝光度。
  • All 今天,我们支持N 天不显示,这是改进后的“不显示”功能。

更改的功能

Promotion

  • iOS 改进了可用性,在使用游戏邀请(UA)功能时,最小化了剪贴板粘贴权限同意弹窗的显示。
    1. 更改了权限同意弹窗的显示时间,从受邀用户启动应用后立即显示,改为在应用启动后 Hive SDK 初始化时显示。
    2. 仅当邀请方 URL 数据存在于剪贴板中时,才显示弹窗。

Notification

  • Android 支持在新亚马逊 Fire 设备上运行的运行时库(Push Amazon Device Message 1.2.0)。

Library updates

  • Android 三星 Galaxy 应用商店 IAP 版本 6.1 → 6.1.1 亚马逊设备消息版本 1.0.1 → 1.2.0

Analytics

  • iOSsaveAnalyticsLogBeforeCrash 设置的默认值(该选项用于在应用程序崩溃时将未发送的日志保存到文件中)更改为 false

已修复的错误

Authentication

  • All 修改为:当从中国访问的用户在实名验证过程中发送的短信数量超过限制时,显示错误消息,而不是重置剩余时间。
  • Android 修复了用户在 Google Play 登录过程中未按返回键登录时,没有正确响应回调的错误。
  • Android 修复了在低分辨率设备上无法进行键盘输入的错误。

Promotion

  • iOS 修复了在新闻视图中显示新框架视图时出现冻结的错误。

Marketing Attribution

  • Android 修复了使用自定义条款执行初始化时,Adjust 事件发送延迟的错误。

v4.24.1.2

按目标操作系统的 SDK 发布日期
SDK Native Android 2024-06-27

检查此 SDK 版本的开发环境

已修复的错误

Authentication

  • Android 修复了在 Google 登录过程中,如果按下返回键取消登录,则无法正确响应回调的错误。此错误仅在 Hive 控制台中的“Google 旧版支持”值为 true 时才会出现。
  • Android 修复了低分辨率设备上无法进行键盘输入的错误。

v4.24.1.0

按目标操作系统的 SDK 发布日期
SDK Native iOS 2024-05-14

更改的功能

Library updates

  • iOS AppsFlyer(iOS) v6.13.1 → v6.14.3 QQ (iOS) v3.5.14 → v3.5.16 Facebook SDK v17.0.0 → v16.2.1

Analytics

  • iOS 我们会根据设备是否同意跟踪来更改同意横幅的显示方式。
    • 如果拒绝跟踪同意,则不会显示同意横幅。

已修复的错误

Billing

  • iOS 修复了从低于 v4 24.0.0 的 Hive SDK 版本(例如 v4 23.4.0)更新到 v4 24.0.0 时产品查找失败的错误。

v4.24.0.0

按目标操作系统的 SDK 发布日期
SDK Native Android 2024-04-30
SDK Native iOS 2024-04-30

新功能

Billing

  • iOS 如果初始订阅折扣信息可用,则会在检索产品信息时一并传递。使用 getProductInfo 时,您可以通过查看回调中接收到的 IAPV4Product 对象列表中 original_price 字段值与 price 字段值之间的差异来检查折扣信息。

Promotion

更改的功能

  • iOS 区分应用版本时,请同时使用 CFBundleShortVersionString

Billing

  • All 我们已将退款用户付款界面中显示的 PG 付款类型文本从“HiveStore”更改为“PG Payment”。
  • Android 我们将PG支付页面的显示方式从应用内浏览器更改为应用内WebView。这样即使在不支持应用内浏览器环境的设备上,也能使用PG支付。

Library updates

  • Android Google Play 服务 - 游戏 v2(Android)v19.0.0 → 20.0.0
  • Facebook SDK Android v16.2.0 → 17.0.0
  • LINE(Android)v5.9.1 → 5.10.0
  • iOS 微信 2.0.2 → 2.0.4
  • Hercules 2024.01.23 → 2024.04.11
  • Singular 12.3.2 → 12.4.1

Analytics

  • Android 将 Firebase 事件收集功能中的广告标识符收集设置的默认值更改为 true

已知问题

Authentication

  • iOS 使用 Facebook SDK iOS 17.0.0 时,如果用户不同意“应用跟踪透明度”,则无法在 iOS 17.0 或更高版本的设备上登录。要在此条件下实现 Facebook 登录,请使用 Hive SDK v4 24.1.0。