如何解决 Unity Android 构建时 Failed to download any source lists! UnknownFormatConversionException 错误？

2024-03-05 15:27:10

在 Unity 开发过程中，构建 Android 项目时遇到 "sdkmanager Failed to download any source lists! UnknownFormatConversionException" 错误是一个常见问题。这个错误通常表示 SDK 管理器无法从 Google 服务器下载源列表。本文将详细介绍如何解决这个问题，并提供一系列有效的解决方案。

理解错误

当 Unity 在构建 Android 项目时，如果 SDK 管理器无法从 Google 服务器下载源列表，就会出现 "Failed to download any source lists! UnknownFormatConversionException" 错误。这通常是由于网络问题、环境配置错误或 SDK 工具版本不兼容引起的。

解决方法

1. 检查 Java 版本

确保你的系统上安装了 Java 8 或更高版本。Java 是运行 Android SDK 工具的必要条件。

java -version

如果 Java 版本过低，请下载并安装最新版本的 Java。

2. 检查 Android SDK 位置

在 Unity 编辑器中，前往“首选项”>“外部工具”>“Android SDK”，并验证路径是否正确。确保路径指向正确的 Android SDK 目录。

3. 安装 Android SDK 命令行工具

下载 Android SDK 命令行工具包，并将其解压缩到 Android SDK 目录中。

访问 Android 开发者网站下载命令行工具包。
解压缩下载的 ZIP 文件。
将解压后的内容复制到 Android SDK 目录。

4. 配置环境变量

正确配置 JAVA_HOME 和 PATH 环境变量是确保 SDK 工具正常运行的关键。

export JAVA_HOME=$( /usr/libexec/java_home -v 17.0.10 )
export PATH=$JAVA_HOME/bin:$PATH

确保这些环境变量指向正确的 Java 和 SDK 命令行工具路径。

5. 更新 SDK 列表

使用以下命令更新 SDK 列表：

./sdkmanager --list

这将强制 SDK 管理器从 Google 服务器下载最新的源列表。

其他解决方法

切换到较旧版本的 Unity

有时，较新的 Unity 版本可能存在与 SDK 工具的兼容性问题。尝试使用 Unity 2021.3 LTS 或更早版本进行构建。

重新安装 Android SDK

从 Android Studio 重新安装 Android SDK，确保所有组件都是最新的，并且没有损坏。

检查代理设置

确保你的网络没有使用代理，或者正确配置了代理设置。有时，代理服务器可能会阻止 SDK 管理器访问 Google 服务器。

结论

通过上述步骤，你应该能够解决 "Failed to download any source lists! UnknownFormatConversionException" 错误，并在 Unity 中成功构建 Android 项目。如果问题仍然存在，建议检查网络连接和防火墙设置，确保没有任何阻止 SDK 管理器访问 Google 服务器的设置。