Unity HUB国际版模块管理指南：彻底删除与重装Android SDK
1. 为什么需要彻底删除Android SDK模块
用Unity开发Android应用时，SDK配置问题是最常见的绊脚石。我遇到过无数次这样的情况：明明按照官方文档一步步操作，却总是报错"SDK tools not found"或者"NDK not configured"。更糟的是，有时候升级Unity版本后，旧的SDK配置会和新版本产生冲突，导致构建直接失败。
这时候最彻底的解决方法就是完全删除旧的Android SDK模块，然后重新安装。但很多人不知道的是，仅仅在Unity HUB界面点击"卸载"是不够的，因为会有大量残留文件和配置项留在系统里。这就是为什么我们需要手动彻底清理。
2. 定位并删除SDK模块文件
2.1 找到Unity编辑器安装目录
首先打开Unity HUB，在左侧导航栏选择"Installs"选项卡。找到你当前使用的Unity版本，点击右侧的三个点图标，选择"Show in Explorer"（Windows）或"Reveal in Finder"（Mac）。这会直接打开Unity编辑器的安装目录。
在这个目录下，你会看到一个名为"PlaybackEngines"的文件夹。打开它，里面就是各种平台支持模块，包括我们需要的Android模块。
2.2 彻底删除Android SDK
在PlaybackEngines文件夹中，找到"AndroidPlayer"文件夹。这就是Android SDK的核心所在。但先别急着删除整个文件夹，因为里面可能包含你辛苦下载的SDK工具和NDK。
更稳妥的做法是：
- 备份"AndroidPlayer/SDK"和"AndroidPlayer/NDK"文件夹（如果有重要版本需要保留）
- 删除整个"AndroidPlayer"文件夹
- 同时检查以下位置是否有残留：
- Windows:
C:\Users\[用户名]\AppData\Local\Unity\cache - Mac:
~/Library/Application Support/Unity/
- Windows:
3. 清理Unity HUB的模块配置
3.1 修改modules.json文件
仅仅删除文件还不够，Unity HUB内部还保存着模块的配置信息。这些信息存储在一个叫modules.json的文件中。
这个文件的位置通常位于：
- Windows:
C:\Program Files\Unity Hub\resources\app.asar.unpacked\build\services\modules\modules.json - Mac:
/Applications/Unity Hub.app/Contents/Resources/app.asar.unpacked/build/services/modules/modules.json
注意：直接修改这个文件前，强烈建议先备份。
用文本编辑器打开这个文件后，你会看到类似这样的内容：
{ "modules": [ { "id": "android", "name": "Android Build Support", "description": "Enables building...", "selected": true } ] }3.2 重置Android模块状态
找到所有与Android相关的模块（通常包括"android"、"android-sdk"、"android-ndk"等），将它们的"selected"属性从true改为false。这相当于告诉Unity HUB这些模块没有被安装。
如果你不确定哪些是Android相关的模块，可以搜索关键词"android"、"sdk"、"ndk"来定位。
4. 重新安装Android SDK模块
4.1 通过Unity HUB安装
完成上述清理后，重启Unity HUB。这时你会发现Android模块又变成了可安装状态。回到"Installs"选项卡，点击你Unity版本旁边的齿轮图标，选择"Add Modules"。
在模块列表中，勾选以下关键组件：
- Android Build Support
- Android SDK & NDK Tools
- OpenJDK
建议选择最新稳定版本，除非你的项目有特殊要求。
4.2 验证安装是否成功
安装完成后，打开Unity编辑器，依次点击：
- Edit > Preferences > External Tools
- 检查Android SDK和JDK路径是否自动填充
- 如果没有自动填充，可能需要手动指定路径
为了确保一切正常，可以创建一个简单的Android工程测试构建。如果构建成功并生成APK文件，说明重新安装成功了。
5. 常见问题与解决方案
5.1 安装过程中断或失败
这种情况通常是由于网络问题导致的。解决方法有：
- 使用稳定的网络连接
- 尝试切换下载镜像源
- 手动下载SDK工具包后指定本地路径
5.2 构建时报NDK错误
如果遇到NDK相关错误，很可能是版本不匹配。建议：
- 检查项目要求的NDK版本
- 在Unity安装目录下手动替换NDK版本
- 在Player Settings中指定正确的NDK路径
5.3 SDK工具找不到
这个经典错误通常有几个原因：
- 路径中有中文或特殊字符 - 建议使用全英文路径
- 权限问题 - 确保Unity有权限访问SDK目录
- 环境变量未设置 - 可以手动添加ANDROID_HOME变量
6. 最佳实践与维护建议
6.1 定期清理无用SDK版本
Android SDK会占用大量磁盘空间。建议每隔一段时间：
- 删除不再使用的SDK平台版本
- 清理过时的构建工具
- 移除不再需要的系统镜像
6.2 使用版本管理
对于团队项目，建议：
- 统一SDK和NDK版本
- 将版本要求写入项目文档
- 考虑使用版本控制工具管理SDK配置
6.3 监控磁盘空间
Android开发工具很容易占用几十GB空间。养成习惯定期检查：
- Unity缓存目录
- SDK下载缓存
- 构建临时文件
我在实际项目中发现，保持开发环境的整洁不仅能避免各种奇怪错误，还能显著提高构建速度。特别是当项目需要频繁切换不同Unity版本时，一套清晰的模块管理流程能节省大量调试时间。