企业官网建设流程全解析

1. 为什么Unity安卓环境配置值得单独拿出来讲

做过Unity移动端项目的朋友大概率都有过这种体验：编辑器里跑得好好的场景，一切换到Android平台就报一堆红字，要么是SDK路径找不到，要么是Gradle版本对不上，要么是打包出来装到手机上直接闪退。更让人头疼的是，这类问题往往不是代码逻辑的错，而是环境配置的坑。你花两个小时排查一个“Build failed”，最后发现只是某个路径里带了中文或者空格。

所以我把这次配置过程完整记录下来，不是照搬官方文档，而是把每一步背后的原因、容易翻车的地方、以及我实际踩过的坑都摊开讲。这篇文章适合刚接触Unity移动端开发的新手，也适合之前一直做PC端、现在需要把项目往安卓上迁的老手。核心关键词就一个：Unity安卓环境配置。我会从整体思路讲到具体操作，再到问题排查，尽量让不同基础的人都能照着做下来。

先说清楚一件事：Unity打包安卓，本质上是你本机的Unity编辑器调用外部的一整套工具链，把C#代码、资源、第三方库编译成能在安卓设备上运行的APK或AAB。这套工具链包括JDK、Android SDK、NDK、Gradle，它们各自有版本要求，彼此之间还有兼容性约束。Unity Hub从某个版本开始提供了“一键安装模块”的功能，但那个功能只解决了一部分问题，真正遇到自定义需求时，你还是得手动配。这就是为什么很多人明明点了“安装Android Build Support”，打包时依然报错。

我这次配置的目标很明确：在一台Windows机器上，让Unity能够稳定地打出安卓包，并且支持后续接入第三方SDK、自定义Gradle模板、以及处理常见的架构和API Level问题。下面按我的实际顺序展开。

2. 整体思路与工具链选型拆解

2.1 先搞清楚Unity打包安卓到底依赖哪些东西

很多人一上来就装Android Studio，装完发现Unity里还是配不对。问题在于没理清依赖关系。Unity打包安卓，核心依赖四样东西：

• JDK（Java Development Kit）：Gradle和安卓构建工具本身是Java写的，没有JDK就跑不起来。Unity对JDK版本有明确要求，版本不对会直接报“Unable to find java”或者Gradle同步失败。
• Android SDK：里面包含构建工具（Build-Tools）、平台工具（Platform-Tools，主要是adb）、以及各个API Level的平台文件（Platforms）。Unity需要知道SDK的根目录在哪。
• NDK（Native Development Kit）：如果你的项目用了IL2CPP脚本后端，或者集成了C/C++写的原生库，就需要NDK来编译。用Mono后端理论上可以不装NDK，但实际项目里IL2CPP几乎是标配。
• Gradle：安卓的构建系统。Unity会自带一个Gradle版本，但你可以选择用自定义的。Gradle版本和安卓Gradle插件版本、JDK版本之间是强绑定的。

这四者之间的关系可以这样理解：JDK是发动机，SDK是工具箱，NDK是特殊工具，Gradle是装配流水线。任何一个版本错位，整条线就卡住。

2.2 为什么我不推荐无脑用Unity Hub一键安装

Unity Hub的“Android Build Support”模块确实方便，它会帮你下载OpenJDK、SDK、NDK并自动填好路径。对于纯新手、只做简单项目的人来说，这是最省事的方案。但它有几个明显的局限：

第一，它下载的SDK和NDK版本是跟着Unity版本走的，可能不是你项目需要的版本。比如你的项目要接入某个第三方库，那个库要求最低API Level 24，而Hub装的SDK里没有对应的Platform，你就得手动补。

第二，Hub安装的路径默认在C盘用户目录下，路径里可能包含空格或特殊字符，某些Gradle版本对路径很敏感。

第三，当你需要自定义Gradle模板、修改gradle.properties、或者处理依赖冲突时，你还是得手动去改这些文件，而Hub装的目录结构和你自己装的Android Studio目录结构不完全一样，找起来费劲。

我的做法是：JDK和Gradle用Unity自带的，SDK和NDK用Android Studio的SDK Manager来管理。这样既保证了Unity能识别，又保留了灵活增删API Level和Build-Tools的能力。下面详细说。

2.3 版本匹配的核心逻辑

版本匹配是配置过程中最容易出问题的地方。我整理了一个实际可用的版本对应关系，以Unity 2021 LTS和2022 LTS为例：

这张表不是绝对的，但如果你不想折腾，按这个来基本不会出大问题。关键原则是：JDK版本不要动，Gradle版本尽量用Unity自带的，SDK和NDK可以按需调整。

注意：不要同时装多个JDK然后让系统PATH指向另一个版本。Unity在打包时会优先使用它自己配置的JDK路径，但Gradle有时会去读系统环境变量，导致版本混乱。最稳妥的做法是让Unity设置里的JDK路径指向它自带的那个，系统PATH里不要放其他JDK。

3. 核心细节解析与实操要点

3.1 JDK的配置与验证

Unity从2019.3开始自带OpenJDK，路径一般在：

# Windows 默认路径示例 C:\Program Files\Unity\Hub\Editor\2021.3.x\Editor\Data\PlaybackEngines\AndroidPlayer\OpenJDK

在Unity里，打开Edit > Preferences > External Tools，找到JDK那一栏，勾选“Installed with Unity (recommended)”。这样Unity就会用自带的JDK。

验证JDK是否可用的方法：打开命令行，进入上面那个路径的bin目录，执行：

java -version

如果输出类似openjdk version "11.0.x"就说明没问题。如果报“不是内部或外部命令”，说明路径不对或者文件缺失，重新通过Hub安装Android Build Support模块。

这里有个细节：有些教程会让你去装Oracle JDK或者AdoptOpenJDK，然后手动指定路径。我试过，在Unity 2021上指定外部JDK 17会直接导致Gradle同步失败，因为Unity自带的Gradle 6.7.1不支持JDK 17。所以除非你明确知道自己在做什么，否则不要换JDK。

3.2 Android SDK的安装与目录结构

我推荐用Android Studio的SDK Manager来装SDK，因为它的界面直观，增删组件方便。如果你不想装完整的Android Studio，也可以单独下载command-line tools，但那个对新手不太友好。

装好Android Studio后，打开SDK Manager，重点装这几项：

• SDK Platforms：至少勾选一个你目标API Level对应的平台，比如Android 12 (API 31) 或 Android 13 (API 33)。建议多勾几个，方便切换。
• SDK Tools：必须勾选Android SDK Build-Tools、Android SDK Platform-Tools、Android SDK Command-line Tools。NDK根据是否需要IL2CPP来决定，建议勾上。
• NDK：在SDK Tools里勾选NDK (Side by side)，它会装到SDK目录下的ndk文件夹里，每个版本一个子目录。

装完后，SDK的根目录一般在：

# Windows 默认路径 C:\Users\你的用户名\AppData\Local\Android\Sdk

这个路径要记下来，待会填到Unity里。注意：路径里不要有中文和空格。如果你的用户名是中文，建议把SDK装到D盘根目录下，比如D:\Android\Sdk。

3.3 NDK的选择与坑点

NDK不是必须的，但如果你用IL2CPP后端，就必须有。Unity对NDK版本有要求，版本不对会报“NDK not found”或者编译原生代码时出错。

在Unity的External Tools设置里，NDK那一栏可以勾选“Installed with Unity”或者手动指定路径。我建议手动指定，指向Android SDK目录下的ndk文件夹里你装的那个版本。比如：

D:\Android\Sdk\ndk\23.1.7779620

注意要指到具体版本号那一层，不要只指到ndk文件夹。

实操心得：如果你同时装了多个NDK版本，Unity只会用你指定的那个。但Gradle在构建时可能会去环境变量里找NDK，导致版本冲突。解决办法是在项目的gradle.properties里显式指定android.ndkVersion，或者在Unity的NDK路径里只保留一个版本。

3.4 Gradle的配置策略

Unity自带的Gradle版本在：

C:\Program Files\Unity\Hub\Editor\2021.3.x\Editor\Data\PlaybackEngines\AndroidPlayer\Tools\gradle

在External Tools里，Gradle那一栏可以勾选“Installed with Unity”或者指定自定义Gradle。我强烈建议用自带的，除非你有明确的理由换。

如果你需要自定义Gradle模板，可以在Player Settings > Publishing Settings里勾选“Custom Gradle Template”，Unity会在Assets/Plugins/Android下生成mainTemplate.gradle和gradleTemplate.properties。这两个文件可以让你修改依赖、添加仓库、调整编译选项。

这里有个常见的坑：修改了mainTemplate.gradle后，如果格式不对，Gradle同步会直接失败，报错信息往往很模糊。我的经验是，改之前先备份，改完之后用Android Studio打开Assets/Plugins/Android目录，让它帮你做一次Gradle同步，能提前发现语法错误。

4. 完整实操流程与关键环节实现

4.1 第一步：通过Unity Hub安装Android Build Support

打开Unity Hub，找到你正在用的Unity版本，点击右侧的齿轮图标，选择“Add modules”。在弹出的列表里勾选：

• Android Build Support
• 下面的子项：Android SDK & NDK Tools、OpenJDK

这一步会下载几个G的文件，时间取决于网速。装完后，Unity的安装目录下会多出PlaybackEngines/AndroidPlayer文件夹，里面就是SDK、NDK、JDK的默认位置。

如果你之前已经装过，可以跳过这步，但建议检查一下这些文件夹是否存在且完整。

4.2 第二步：配置External Tools路径

打开Unity，新建或打开一个项目，进入Edit > Preferences > External Tools。按照下面的表格逐项配置：

配置完后，点击每个路径旁边的“Browse”确认一下能不能正常打开。如果SDK路径填错，Unity会提示“Invalid SDK path”。

4.3 第三步：切换平台并设置Player Settings

点击File > Build Settings，在平台列表里选择Android，然后点击“Switch Platform”。这个过程会把项目里的资源重新导入为安卓格式，时间可能比较长，取决于项目大小。

切换完成后，点击“Player Settings”，重点设置这几项：

• Company Name 和 Product Name：随便填，但不要用中文。
• Package Name：格式是com.公司名.项目名，必须唯一，不能有中文和大写字母。
• Minimum API Level：根据你的用户群体决定，一般设22或23。
• Target API Level：建议设31或33，应用商店有要求。
• Scripting Backend：选IL2CPP，除非你有特殊理由用Mono。
• Target Architectures：勾选ARM64和ARMv7。如果只勾ARMv7，某些新设备装不上；只勾ARM64，老设备装不上。两个都勾最稳，但包体会大一些。

4.4 第四步：处理Gradle依赖和自定义配置

如果你的项目没有引入任何第三方安卓库，这一步可以跳过。但如果引入了，比如广告SDK、推送SDK、支付SDK，就需要在mainTemplate.gradle里添加依赖。

打开Assets/Plugins/Android/mainTemplate.gradle，找到dependencies块，在里面添加：

dependencies { implementation fileTree(dir: 'libs', include: ['*.jar']) implementation 'com.example.library:1.0.0' // 其他依赖 }

同时，在gradleTemplate.properties里可以添加一些全局配置，比如：

android.useAndroidX=true android.enableJetifier=true org.gradle.jvmargs=-Xmx4096m

android.useAndroidX=true是必须的，因为现在大部分安卓库都迁移到AndroidX了。org.gradle.jvmargs用来调整Gradle的内存，如果项目大、依赖多，默认内存可能不够，导致构建失败。

注意：每次修改这两个文件后，建议先删除Library目录下的Gradle缓存，或者执行一次Assets > Play Services Resolver > Android Resolver > Force Resolve（如果装了External Dependency Manager），确保依赖被正确解析。

4.5 第五步：打包测试与验证

点击File > Build Settings，点击“Build”或者“Build And Run”。如果一切正常，会生成一个APK文件。第一次构建会比较慢，因为要下载Gradle依赖、编译原生代码。

构建完成后，把APK装到手机上，重点验证这几项：

• 应用能否正常启动，有没有闪退。
• 如果用了IL2CPP，检查ARM64和ARMv7是否都正常。
• 如果接了第三方SDK，检查初始化是否成功。
• 检查日志里有没有ClassNotFoundException或NoSuchMethodError，这些通常是依赖冲突或混淆导致的。

我习惯在构建完成后，用adb logcat看一遍启动日志，确认没有隐藏的报错。命令是：

adb logcat -s Unity:V

这样只过滤Unity相关的日志，看起来清爽。

5. 常见问题与排查技巧实录

5.1 构建失败类问题速查表

5.2 路径与权限的坑

Windows上最容易出问题的是路径。我遇到过好几次，SDK装在C:\Users\张三\AppData\Local\Android\Sdk，因为用户名是中文，Gradle直接报“Invalid path”。解决办法是把SDK移到纯英文路径下，比如D:\Android\Sdk。

另一个坑是权限。如果你把Unity装在C盘Program Files下，某些操作可能需要管理员权限。我建议把Unity和SDK都装在非系统盘，避免权限问题。

5.3 依赖冲突的排查思路

依赖冲突是安卓打包里最烦人的问题之一。典型表现是构建成功但运行时报ClassNotFoundException或NoSuchMethodError。排查步骤：

1. 在mainTemplate.gradle里添加implementation依赖时，注意版本号。不同库可能依赖同一个库的不同版本。
2. 用./gradlew :app:dependencies命令查看依赖树（需要在Android Studio里打开项目）。
3. 找到冲突的库，用exclude排除掉旧版本：

implementation('com.example.library:1.0.0') { exclude group: 'com.android.support', module: 'support-v4' }

4. 如果用了AndroidX，确保所有库都迁移到AndroidX，不要混用support库。

5.4 构建速度优化技巧

安卓构建慢是常态，但可以优化：

• 在gradleTemplate.properties里加大Gradle内存：org.gradle.jvmargs=-Xmx4096m。
• 开启Gradle缓存：org.gradle.caching=true。
• 开启并行构建：org.gradle.parallel=true。
• 如果不需要每次构建都跑Proguard，可以在调试版本里关掉。
• 把Build Settings里的“Build App Bundle”关掉，除非你要上传商店，APK构建比AAB快。

实操心得：我习惯在开发阶段用Mono后端加ARMv7单架构，构建速度最快。等到要出包测试或上线时，再切回IL2CPP加双架构。这样能省不少等待时间。

5.5 版本升级后的环境迁移

Unity版本升级后，安卓环境经常需要重新配。比如从2021升到2022，Gradle版本从6.7.1变成7.5.1，JDK可能还是11，但SDK Build-Tools需要更新。我的做法是：

1. 先备份现有的mainTemplate.gradle和gradleTemplate.properties。
2. 升级Unity后，重新在External Tools里确认路径。
3. 用SDK Manager补装新版本要求的Build-Tools和Platform。
4. 把备份的Gradle文件内容合并到新生成的文件里，注意语法可能有变化。
5. 清理Library目录，重新构建。

这个过程我走过几次，每次大概花半小时到一小时，主要时间在下载和重新构建上。

6. 一些容易被忽略的细节和我的个人习惯

6.1 关于API Level的选择

Minimum API Level决定了你的应用能装到哪些设备上。设得太低，比如21，能覆盖更多老设备，但某些新API用不了，而且Google Play对最低版本有要求。设得太高，比如26，会丢掉一部分老用户。我的经验是，面向国内市场设22或23，面向海外市场设24或26。Target API Level则要跟着应用商店的要求走，目前建议至少31。

6.2 关于包体大小

安卓包体大小受几个因素影响：架构数量、纹理压缩格式、代码混淆。如果包体太大，可以考虑：

• 只保留ARM64，放弃ARMv7，能省不少空间，但会丢掉老设备。
• 用ETC2或ASTC纹理压缩，比RGBA32省很多。
• 开启Proguard或R8混淆，能减小代码体积。
• 用AssetBundle或Addressables把资源拆出去，首包只留必要资源。

6.3 关于真机调试

打包出来装到手机上只是第一步，真机调试才能发现真正的问题。我习惯用USB连接手机，开启开发者模式和USB调试，然后在Unity里点“Build And Run”，这样Unity会自动安装并启动应用，同时把日志输出到Console窗口。如果Console里看不到日志，可以用adb logcat在命令行看。

还有一个技巧：在手机上装一个Logcat查看器应用，比如“Logcat Reader”，这样不用连电脑也能看日志，适合外出测试。

6.4 关于自动化构建

如果团队里有多个人，或者需要频繁出包，建议把安卓构建自动化。Unity提供了命令行构建的方式：

Unity.exe -quit -batchmode -projectPath "D:\MyProject" -executeMethod BuildScript.BuildAndroid -logFile build.log

你可以写一个静态方法BuildScript.BuildAndroid，在里面调用BuildPipeline.BuildPlayer，设置好各种参数。这样就能集成到CI/CD流水线里，每次提交代码自动出包。

不过自动化构建的前提是环境配置必须稳定，否则流水线会频繁失败。所以先把本文说的这些配置做扎实，再考虑自动化。

7. 最后再分享几个压箱底的小技巧

第一个技巧：如果你不确定某个第三方库需要什么版本的SDK或Gradle，去它的官方文档里找“Requirements”或“Setup”章节，通常会写明最低API Level、需要的Gradle版本、以及是否依赖AndroidX。照着配，比瞎试快得多。

第二个技巧：Unity的Assets/Plugins/Android目录下可以放AndroidManifest.xml，用来覆盖默认的清单文件。如果你需要添加权限、修改启动Activity、或者配置Provider，都在这里改。改完后记得在Player Settings里确认“Custom Main Manifest”被勾选。

第三个技巧：遇到构建报错但看不懂日志时，先去C:\Users\你的用户名\AppData\Local\Unity\Editor\Editor.log里搜“error”或“failed”，Unity的详细日志都在那里。Gradle的详细日志则在项目目录的Library\Bee\Android\Prj\IL2CPP\Gradle下，里面有完整的构建输出。

第四个技巧：如果你用的是Windows，建议把Windows Defender的实时扫描对Unity项目目录和SDK目录排除掉，否则构建时文件读写会被拖慢很多。我实测排除后，构建时间能缩短20%左右。

这些就是我这次配置Unity安卓环境的完整记录。环境配置这件事，第一次做会觉得繁琐，但把原理搞清楚之后，后面遇到问题就能快速定位。希望这些内容能帮你少走一些弯路。