Hachi 3.0.0 版本升级须知（开发者必看）

用户7478

2024年7月12日修改

Hachi 3.0.0版本开始支持Android Target 34，谷歌要求8月31日前完成升级。Hachi SDK也在以下几个方面发生了比较大的变化，需开发者使用新版本时注意。建议新老开发者详细阅读Hachi 接入文档相关部分。

Android打包方式

Android打包方式，由使用Unity Build 直接出包，改为Hachi托管用菜单HCSDK->Build->Android方式出包。具体可参加 Hachi SDK构建Android平台。

Android平台设置

Target API Level 需要设置为34。Android平台之前相关一些Gradle版本的设置，现在不需要了。新版本需设置的请参见 Hachi SDK Android 平台设置。

广告展示接口

1、广告展示只保留了传入string表示广告位名称的接口，去掉了枚举接口。目的是开发者无需改动SDK目录下任何值，方便更新时可全量文件更新。​

但建议开发者自己根据需求文档的HCIVPositionName、HCRVPositionName，定义枚举值.toString()传给SDK，以保证传入广告位名称的正确性。具体请参见 Hachi SDK插屏广告和 Hachi SDK激励视频广告部分。

2、新版本SDK去掉了HCAdPositionName.cs文件，开发者可自行拷贝到自定义目录进行使用，.toString后传给SDK。​

内购部分

关于内购部分有四点需要注意：

1、Unity In App Purchasing 插件版本需要更为 4.12.0+。

2、收到购买成功回调，下发奖励完成，必须调用奖励下发上报接口，以完成整次支付流程。

3、补单，SDK内部会在购买成功和购买失败回调里进行自动补单。开发者可自行调用补单接口，在进入游戏或每次回到主界面等合适时机进行调用。

4、新版本SDK去掉了HCPurchaseProducts.cs 文件，开发者可将此文件内容自行定义，也可以将老版本改文件放到自定义目录，在SDK初始化前，通过添加内购商品- AddProductsStatic 接口传给SDK。推荐初始化SDK前传入的方式。

账号系统

账号系统将账号绑定和删除等逻辑，封装到了SDK界面内，可在设置界面加账号信息按钮点击进行调用。游戏只需处理相应回调即可。之前老版本SDK只提供接口，所有逻辑都由游戏侧处理。因此逻辑相对复杂，故做了封装。具体可参加登录账号信息界面。

已正常上线跑的游戏，不建议改为此方式接入。新游戏使用此方式可简化接入。具体参见需求文档。​

推送

推送功能3.0.0版本已改为需要开发者手动调用开启。请参见推送接入部分。接入需求请参加需求文档。

Hachi 3.0.0 版本升级须知（开发者必看）​