# 迁移到 9.0.0+

> 将 LevelPlay Unity 集成迁移到 9.0.0 及更高版本的指南。

使用此指南可将 LevelPlay Unity 软件包集成更新为 9.0.0 或更高版本。本指南涵盖三种常见的迁移方案，并通过删除过时文件、安装最新软件包和恢复网络适配器来确保设置整洁。

> **Important:**
>
> 如果使用开发者设置（LevelPlay Mediation 设置 或 Mediated Network 设置），请在更新之前录制所有app密钥、app ID 或自定义选项。升级到 9.0.0 或更高版本后，您需要重新输入它们。

本文为开发者将 LevelPlay Unity 集成迁移到 9.0.0 或更高版本提供了指导。

## 9.0.0+ 中的关键更改##key-changes-in-9.0.0+

* 新的初始化 API 和流程
* 更新了适配器和网络要求
* 旧版 API 的弃用
* 其他隐私和合规性功能

## 迁移步骤##migration-steps

1. 使用 Unity Package Manager 或通过下载最新的 .unitypackage 将 **LevelPlay Unity 软件包更新**到 9.0.0+。
2. **更新初始化代码**以使用新的 API。有关详细信息，请参阅[迁移到 LevelPlay Init API](/grow/levelplay/sdk/unity/migrate-to-init-api.md)。
3. **检查和更新所有广告格式集成**（奖励、插页式、横幅广告）以确保兼容性。
4. 将**聚合网络适配器**更新为最新支持的版本。
5. 使用集成测试套件彻底**测试集成**。

## 先决条件##prerequisites

为了防止在更新到 9.0.0 版本时与旧版文件或适配器发生冲突，请确保已执行以下操作：

* 删除现有集成文件以避免版本冲突。
* 安装软件包时，只能依赖更新的代码路径。
* 重新安装网络适配器，使其与 9.0.0 版 API 和依赖项赖项解析器正确集成。

## 选择更新路径##choose-your-update-path

| 场景                                | 何时使用                                                 |
| --------------------------------- | ---------------------------------------------------- |
| 将当前 Unity 插件版本更新为 Unity 插件 9.0.0+ | 您当前使用 .unitypackage for LevelPlay 并希望更新到 9.0.0+ 版本   |
| 更新 Ads Mediation UPM 软件包到 9.0.0   | 您当前使用 LevelPlay 的广告服务聚合 UPM 软件包，并希望更新到 9.0.0+ 版本     |
| 从 Unity 插件迁移到 Ads Mediation 包     | 您希望停止使用 .unitypackage 并切换到版本为 9.0.0+ 的广告服务聚合 UPM 软件包 |

## 将当前 Unity 插件版本更新为 9.0.0+##update-your-current-unity-plugin-version-to-9.0.0+

如果您当前使用 Unity 插件 (.unitypackage) for LevelPlay 并希望升级到 9.0.0 或更高版本，请执行以下步骤：

1. 使用[支持的编辑器](https://unity.com/releases/editor/archive)，在 Unity Editor 中打开项目。
2. 在 Project 窗口中，找到 `Assets > LevelPlay` 文件夹，然后删除 LevelPlay 及其所有内容。
3. 如果存在，请删除 `Assets > Mobile Dependency Resolver`。
4. 下载 [Unity 插件](/grow/levelplay/sdk/unity/package-integration.md)。
5. 将 .unitypackage 文件导入项目。
6. 转到 Unity 主菜单中的广告服务聚合 (Ads Mediation) > Network Manager。
7. 单击 Install（安装）以添加与 9.0.0 或更高版本兼容的网络适配器。

## 更新 Ads Mediation UPM 软件包到 9.0.0+##update-the-ads-mediation-upm-package-to-9.0.0+

如果您当前使用 LevelPlay 的广告服务聚合 UPM 软件包并希望升级到 9.0.0 或更高版本，请执行以下步骤：

1. 使用[支持的编辑器](https://unity.com/releases/editor/archive)，在 Unity Editor 中打开项目。
2. 在 Project 窗口中，找到 `Assets > LevelPlay` 或 `Assets > IronSource` 文件夹，然后删除该文件夹及其所有内容。
3. 如果存在，请删除 `Assets > Mobile Dependency Resolver`。
4. 打开窗口 > Package Manager。
   * 在 Packages 音频源中选择 Unity Registry。
   * 选择 Ads Mediation（广告服务聚合）。
   * 单击 Update。
5. 转到 Unity 主菜单中的广告服务聚合 (Ads Mediation) > Network Manager。
6. 单击 Install（安装）以添加与 9.0.0 或更高版本兼容的网络适配器。

## 从 Unity 插件迁移到 Ads Mediation 包##migrate-from-the-unity-plugin-to-the-ads-mediation-package

如果您当前使用 Unity 插件 (.unitypackage)，但希望迁移到广告服务聚合 UPM 软件包 (v9.0.0+)，请执行以下步骤：

1. 使用[支持的编辑器](https://unity.com/releases/editor/archive)，在 Unity Editor 中打开项目。
2. 在 Project 窗口中，找到 `Assets > LevelPlay` 或 `Assets > IronSource` 文件夹，然后删除该文件夹及其所有内容。
3. 如果存在，请删除 `Assets > Mobile Dependency Resolver`。
4. 打开窗口 > Package Manager。
   * 选择 Unity Registry。
   * 查找广告服务聚合。
   * 单击 Install（安装）。
5. 导航到 Unity 主菜单中的广告服务聚合 (Ads Mediation) > Network Manager。
6. 单击 Install（安装）以添加与 9.0.0+ 版本兼容的网络适配器。

## 更新后验证##post-update-verification

* 重新输入先前保存的任何开发者设置值。
* 运行测试构建以确认广告服务正确加载并且不会出现缺失的适配器错误。
* 检查主机日志，查找与已弃用的 API 使用相关的警告，并使用 [v9.0.0 支持](/grow/levelplay/sdk/unity/9-0-0-api-changes/.md)的 API 替换这些警告。

## 常见迁移问题的故障排除##troubleshooting-common-migration-issues

| 问题          | 可能的原因            | 建议的修复                                                                                                         |
| ----------- | ---------------- | ------------------------------------------------------------------------------------------------------------- |
| 网络适配器缺失或不显示 | 适配器安装已跳过或失败      | 转到广告服务聚合 (Ads Mediation) > Network Manager，然后再次选择安装 (Install)。验证安装程序日志。                                       |
| 文件重复或冲突     | 未完全删除旧的软件包SDK 文件 | 搜索旧的 LevelPlay、Ironsource 或移动端依赖项解析器文件夹。删除它们。重新安装 Unity 软件包。                                                  |
| 缺少以前的开发者设置值 | 在升级过程中删除了以前的设置   | 重新输入密钥；确认它们与您之前使用的密钥匹配。在 Developer 设置 > LevelPlay Mediation 设置 和 Developer 设置 > Mediated Network 设置 中重新输入您的值。 |

有关集成故障排除的更多信息，请参阅[故障排除指南](/grow/dashboard/levelplay/troubleshoot.md)。

## 其他资源##additional-resources

* [LevelPlay Unity 集成](/grow/levelplay/sdk/unity/package-integration.md)
* [LevelPlay SDK 变更日志](/grow/levelplay/sdk/unity/changelog.md)
* [Maven Central 迁移指南](/grow/levelplay/sdk/unity/maven-central-migration-guide.md)