菜单

Unity SDK升级方案

1. Unity SDK导入方式变更说明

🚨 重要提示：从老版本迁移到新版本的必须操作

迁移前必须执行的步骤

移除老版本SDK文件（<=5.0.24）

​​在导入新版本UnityPackage之前，必须先手动删除以下老版本文件：​

⚠️ 注意：​​ 必须在导入新版本UnityPackage之前完成删除操作，否则会导致编译冲突！

📱 Android SDK文件移除：

Assets/Plugins/Android/GravityEngineSDK-*.aar # 所有以GravityEngineSDK-开头的aar文件

📱 iOS SDK文件移除：

Assets/Plugins/iOS/GravityEngineSDK/ # 整个GravityEngineSDK文件夹

2. 新版本接入方式（版本 ≥ 5.0.25）

方式一：插件引入（推荐）

EDM4U 插件使用说明
  • 引入方式：使用 EDM4U 插件动态引用底层 SDK
  • Android：通过 Maven 库方式引用
  • iOS：通过 CocoaPods 方式引用
  • 详细操作请参考：《EDM4U插件使用说明》文档

方式二：非插件引入

如果不使用自动导入 SDK 插件，在导入 unitypackage 时，无需勾选以下两个文件夹：
  • Assets/ExternalDependencyManager
  • Assets/GravityNet
此时需要将 Android 和 iOS 的 SDK 手动导入到 Unity 项目，可参考下述的导入方式。

📱 Android SDK 导入

方法 1：Maven 方式（推荐）

1. 配置仓库地址​
在 /Assets/Plugins/Android/settingsTemplate.gradle文件中添加以下仓库地址：
maven { url 'https://nexus.gravity-engine.com/repository/maven-releases/' }
maven { url 'https://nexus.gravity-engine.com/repository/maven-snapshots/' }
maven { url 'https://developer.huawei.com/repo' }
maven { url 'https://developer.hihonor.com/repo' }
2. 添加依赖​
在 /Assets/Plugins/Android/mainTemplate.gradle文件中添加以下依赖
implementation ("cn.gravity.android:GravityEngineSDK:+")
implementation "com.huawei.hms:ads-identifier:3.4.62.300"//华为SDK
implementation 'com.hihonor.mcs:ads-identifier:1.0.3.300'//荣耀SDK

方法 2：手动导入 AAR 方式（不推荐）

  1. 下载 Android 最新 SDK 的 AAR 文件（[下载地址]）
  2. 将 AAR 文件放入 Assets/Plugins/Android/目录下
  3. 华为 SDK 和荣耀 SDK 仍需通过上述 Maven 方式引入

方法 3：在已有的 Android 项目中接入

除上述方式外，也可在已有的 Android 项目中接入，详细操作请参考 [Android 接入文档]。

📱 iOS SDK 导入

方法 1：CocoaPods 导入（推荐）

在原有的 Podfile 文件中，添加引力 SDK 的引用：
pod 'GravityEngineSDK'

方法 2：手动导入 Framework 方式（不推荐）

  1. 下载 iOS 最新 SDK 的 Framework 文件（[下载地址]）
  2. 将 Framework 文件放入 Assets/Plugins/iOS/目录下
  3. 需要对 iOS 项目进行相应设置，详细操作请参考 [iOS 接入文档]

方法 3：在已有的 iOS 项目中接入

除上述方式外，也可在已有的 iOS 项目中接入，详细操作请参考 [iOS 接入文档]。

注意:如果unity版本是区分UnityFramework方式，需要将GravityEngineSDK引入到名字为UnityFramework的Target中

上一个
自动采集
下一个
Flutter
最近修改: 2025-11-12Powered by