# Maven Central 迁移指南
> 在 2025 年 6 月 30 日之前将 Unity LevelPlay 项目依赖项迁移到 Maven Central，以便不间断地继续构建和使用 Unity LevelPlay 和广告品质。
作为 Unity 和 ironsource 统一的一部分，适用于 Android 的 Unity LevelPlay SDK、所有支持的广告网络适配器以及适用于 Android 的广告品质 SDK 将从 is.com 迁移到 Maven Central。
作为已集成 Unity LevelPlay 的 Unity 开发者，您必须在 **2025 年 6 月 30** 日之前将项目依赖项迁移到 Maven Central，以便不间断地继续构建项目和使用 Unity LevelPlay 和广告品质。
> **Note:**
>
> 必须将项目迁移到 Maven Central。IS.com 上将不再访问 SDK，因此请进行迁移以避免开发工作流程中断，并继续使用 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 才能保持开发和构建功能。 |
> **Note:**
>
> Maven Central 中支持的最低 SDK 版本为：
>
> * Unity LevelPlay SDK：7.9.0
> * Unity Ad Quality SDK：7.19.2
>
> 如果项目使用任一 SDK 的早期版本，则必须至少更新到支持的最低版本才能继续开发和构建功能。弃用 is.com 后，在更新之前，使用旧版本的项目将不再构建或函数。
在进行手动迁移之前，请确认您使用的 LevelPlay Unity 软件包（包裹 LevelPlay SDK）和广告品质 SDK 版本。下一部分提供了验证 SDK 版本和确定是否需要手动迁移的步骤。
## 确定 LevelPlay Unity 软件包是否需要手动迁移
要确定项目是否需要手动迁移，请按照以下步骤检查项目文件中是否存在过时的依赖项。
在 Unity Editor 中，转到 **Assets** > **LevelPlay** > **编辑器**。在此文件夹中的任何 XML 文件中搜索字符串`https://android-sdk.is.com/`。如果找到，请继续**执行手动迁移步骤**部分：
1. 打开 IronSourceSDKDependencies.xml 或与项目中使用的适配器相关的任何 xml 文件。
2. 在代码仓库参考文件中搜索以下代代码，并确认 AndroidPackage 规范和代码仓库标签是否如下所示：
* 如果存在这些代码行，请继续执行**手动迁移步骤**部分。
* 如果缺少这些代代码，则项目中的依赖项已使用 Maven Central，因此不需要您执行任何操作。
```objective-c
https://android-sdk.is.com/
```
## 确定 Ad 品质 Unity 软件包是否需要手动迁移
要确定项目是否需要手动迁移，请按照以下步骤检查项目文件中是否存在过时的依赖项。
1. 在 Unity Editor 中，转到 **Assets** > **LevelPlay** > **编辑器**。
2. 在项目打开 IronSourceAdQualityDependencies.xml。
3. 在代码仓库参考文件中搜索以下代代码，并确认 AndroidPackage 规范和代码仓库标签是否如下所示：
* 如果存在这些代码行，请继续执行**手动迁移步骤**部分。
* 如果缺少这些代代码，则项目中的依赖项已使用 Maven Central，因此不需要您执行任何操作。
```objective-c
https://android-sdk.is.com/
```
## LevelPlay Unity 软件包的手动迁移步骤
> **Note:**
>
> 如果您使用的是 7.9.0 到 8.4.1 之间的 LevelPlay 软件包版本（在 2024 年 11 月 21 日之前安装），并且不想更软件包版本，则需要手动迁移。这也适用于在此日期之后无法更新到较新版本的发布者。
按照以下步骤完成项项目 Maven Central 的手动迁移，同时确保正确更新依赖项：
1. 转到项目的 **Assets** > **LevelPlay** > **编辑器**文件夹。
2. 删除 IronSourceSDKDependencies.xml 文件。
3. 删除以下已安装的聚合适配器依赖项 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
4. 打开广告服务聚合软件包中的 **Network Manager**，选择 LevelPlay SDK 和所需的聚合适配器，然后选择 **Install**。
5. 通过确认在 **Assets** > **LevelPlay** > **Editor** 文件夹中更新了 XML 文件来验证迁移成功，并确保存在以下 XML 文件：
* IronSourceSDKDependencies.xml
* 重新安装的适配器的相应适配器依赖项 XML 文件。
6. 打开以下文件并确认它们正确引用了 Maven Central 中的依赖项：
```objective-c
```
```objective-c
```
7. 构建并运行项目以验证迁移是否成功。如果在迁移中遇到问题，请将 Unity LevelPlay 软件包更新到 7.9.0 或更高版本。
## Ad 品质 软件包户的手动迁移步骤
> **Note:**
>
> 如果您使用的是早于 7.19.2 的广告品质 SDK 版本，或者如果您使用的是 7.19.2 及更高版本，但最新安装日期在 2024 年 10 月 30 日之前，则需要手动迁移。
按照以下步骤完成项项目 Maven Central 的手动迁移，同时确保正确更新依赖项：
1. 转到项目的 **Assets** > **LevelPlay** > **编辑器**文件夹。
2. 删除 IronSourceAdQualityDependencies.xml 文件。
3. [下载支持 Maven Central（7.19.2 及更高版本）的 XML 版本。](http://ssa.public.s3.amazonaws.com/Dependencies-xmls/AdQuality/7.24.0/IronSourceAdQualityDependencies.xml)
4. 通过确认在 **Assets** > **LevelPlay** > **Editor** 文件夹中更新了 XML 文件来验证迁移成功，并确保存在以下 XML 文件：
* IronSourceAdQualityDependencies.xml
5. 打开以下文件并确认它们正确引用了 Maven Central 中的依赖项：
```objective-c
```
6. 构建并运行项目以验证迁移是否成功。