Maven Central 迁移指南
在 2025 年 6 月 30 日之前将 Unity LevelPlay 项目依赖项迁移到 Maven Central,以便不间断地继续构建和使用 Unity LevelPlay 和广告品质。
阅读时间1 分钟最后更新于 2 天前
作为 Unity 和 ironsource 统一的一部分,适用于 Android 的 Unity LevelPlay SDK、所有支持的广告网络适配器以及适用于 Android 的广告品质 SDK 将从 is.com 迁移到 Maven Central。
作为已集成 Unity LevelPlay 的 Unity 开发者,您必须在 2025 年 6 月 30 日之前将项目依赖项迁移到 Maven Central,以便不间断地继续构建项目和使用 Unity LevelPlay 和广告品质。
您需要根据已集成到项目的 LevelPlay Unity 软件包(包含 LevelPlay SDK)和广告品质 SDK 的哪个版本采取指定的操作。请参阅下表以根据 SDK 版本确定后续步骤。
LevelPlay Unity 软件包用户
LevelPlay Unity 软件包版本 | 安装日期 | 所需操作 |
|---|---|---|
| 7.9.0 和更高版本 | 2024 年 11 月 21 日之后安装 | 无需执行任何操作。更新时会自动进行迁移。 |
| 7.9.0 - 8.4.1 | 2024 年 11 月 21 日之前安装,此后未更新 | 更新到比当前版本更新的 Unity 软件包版本,以启用自动迁移。 如果选择不更新,请检查项目依赖关系,并在需要时执行手动迁移步骤。请参阅确定是否需要手动迁移部分以了解详细信息。 |
| 早于 7.9.0 | 任何日期 | 必须将 Unity 软件包版本更新到至少 7.9.0 才能保持开发和构建功能。 |
Ad 品质 Unity 软件包用户
广告品质 SDK 版本 | 安装日期 | 所需操作 |
|---|---|---|
| 7.19.2 和更高版本 | 2024 年 10 月 30 日之后安装 | 无需执行任何操作。更新时会自动进行迁移。 |
| 7.19.2 和更高版本 | 2024 年 10 月 30 日之前安装,此后未更新 | 更新到比当前版本更新的 SDK 版本以启用自动迁移。 如果选择不更新,请检查项目依赖关系,并在需要时执行手动迁移步骤。请参阅确定是否需要手动迁移部分以了解详细信息。 |
| 早于 7.19.2 | 任何日期 | 必须将 SDK 版本更新到至少 7.19.2 才能保持开发和构建功能。 |
在进行手动迁移之前,请确认您使用的 LevelPlay Unity 软件包(包裹 LevelPlay SDK)和广告品质 SDK 版本。下一部分提供了验证 SDK 版本和确定是否需要手动迁移的步骤。
确定 LevelPlay Unity 软件包是否需要手动迁移
要确定项目是否需要手动迁移,请按照以下步骤检查项目文件中是否存在过时的依赖项。
在 Unity Editor 中,转到 Assets > LevelPlay > 编辑器。在此文件夹中的任何 XML 文件中搜索字符串。如果找到,请继续执行手动迁移步骤部分:
https://android-sdk.is.com/- 打开 IronSourceSDKDependencies.xml 或与项目中使用的适配器相关的任何 xml 文件。
- 在代码仓库参考文件中搜索以下代代码,并确认 AndroidPackage 规范和代码仓库标签是否如下所示:
- 如果存在这些代码行,请继续执行手动迁移步骤部分。
- 如果缺少这些代代码,则项目中的依赖项已使用 Maven Central,因此不需要您执行任何操作。
<androidPackages> <androidPackage spec="com.ironsource.sdk:mediationsdk:7.9.0"> <repositories> <repository>https://android-sdk.is.com/</repository> </repositories> </androidPackage></androidPackages>
确定 Ad 品质 Unity 软件包是否需要手动迁移
要确定项目是否需要手动迁移,请按照以下步骤检查项目文件中是否存在过时的依赖项。
- 在 Unity Editor 中,转到 Assets > LevelPlay > 编辑器。
- 在项目打开 IronSourceAdQualityDependencies.xml。
- 在代码仓库参考文件中搜索以下代代码,并确认 AndroidPackage 规范和代码仓库标签是否如下所示:
- 如果存在这些代码行,请继续执行手动迁移步骤部分。
- 如果缺少这些代代码,则项目中的依赖项已使用 Maven Central,因此不需要您执行任何操作。
<androidPackages> <androidPackage spec="com.ironsource:adqualitysdk:7.19.1"> <repositories> <repository>https://android-sdk.is.com/</repository> </repositories> </androidPackage></androidPackages>
LevelPlay Unity 软件包的手动迁移步骤
按照以下步骤完成项项目 Maven Central 的手动迁移,同时确保正确更新依赖项:
-
转到项目的 Assets > LevelPlay > 编辑器文件夹。
-
删除 IronSourceSDKDependencies.xml 文件。
-
删除以下已安装的聚合适配器依赖项 XML 文件:
- ISAdColonyAdapterDependencies.xml
- ISAdMobAdapterDependencies.xml
- ISAppLovinAdapterDependencies.xml
- ISAPSAdapterDependencies.xml
- ISBidMachineAdapterDependencies.xml
- ISBigoAdapterDependencies.xml
- ISChartboostAdapterDependencies.xml
- ISCSJAdapterDependencies.xml
- ISFacebookAdapterDependencies.xml
- ISFyberAdapterDependencies.xml
- ISHyprMXAdapterDependencies.xml
- ISInMobiAdapterDependencies.xml
- ISMaioAdapterDependencies.xml
- ISMintegralAdapterDependencies.xml
- ISMobileFuseAdapterDependencies.xml
- ISMolocoAdapterDependencies.xml
- ISMyTargetAdapterDependencies.xml
- ISOguryAdapterDependencies.xml
- ISPangleAdapterDependencies.xml
- ISSmaatoAdapterDependencies.xml
- ISSuperAwesomeAdapterDependencies.xml
- ISTapJoyAdapterDependencies.xml
- ISTencentAdapterDependencies.xml
- ISUnityAdsAdapterDependencies.xml
- ISVerveAdapterDependencies.xml
- ISVungleAdapterDependencies.xml
- ISYandexAdapterDependencies.xml
-
打开广告服务聚合软件包中的 Network Manager,选择 LevelPlay SDK 和所需的聚合适配器,然后选择 Install。
-
通过确认在 Assets > LevelPlay > Editor 文件夹中更新了 XML 文件来验证迁移成功,并确保存在以下 XML 文件:
- IronSourceSDKDependencies.xml
- 重新安装的适配器的相应适配器依赖项 XML 文件。
-
打开以下文件并确认它们正确引用了 Maven Central 中的依赖项:<androidPackages> <androidPackage spec="com.unity3d.ads-mediation:mediation-sdk:x.x.x"> </androidPackage> </androidPackages><androidPackages> <androidPackage spec="com.unity3d.ads-mediation:unityads-adapter:x.x.x"> </androidPackage> </androidPackages>
-
构建并运行项目以验证迁移是否成功。如果在迁移中遇到问题,请将 Unity LevelPlay 软件包更新到 7.9.0 或更高版本。
Ad 品质 软件包户的手动迁移步骤
按照以下步骤完成项项目 Maven Central 的手动迁移,同时确保正确更新依赖项:
-
转到项目的 Assets > LevelPlay > 编辑器文件夹。
-
删除 IronSourceAdQualityDependencies.xml 文件。
-
通过确认在 Assets > LevelPlay > Editor 文件夹中更新了 XML 文件来验证迁移成功,并确保存在以下 XML 文件:
- IronSourceAdQualityDependencies.xml
-
打开以下文件并确认它们正确引用了 Maven Central 中的依赖项:<androidPackages> <androidPackage spec="com.unity3d.ads-mediation:adquality-sdk:x.x.x"> </androidPackage> </androidPackages>
-
构建并运行项目以验证迁移是否成功。