Mac系统手动配置Unity Android构建环境完整教程

由于您无法使用Unity Hub下载Android构建工具，以下是手动配置的完整解决方案。本教程基于Unity官方文档和实际配置经验，确保您能成功配置Android构建环境。

一、确定Unity版本对应的工具版本

首先确认您的Unity版本，然后根据下表选择对应的工具版本：

Unity版本

JDK版本

NDK版本

Android SDK Build-Tools版本

6000.0

JDK 17 (OpenJDK 版本 17)

r23b (23.1.7779620)

34.0.0

2022.3 LTS

JDK 11 (OpenJDK 版本 11)

r21d (21.3.6528147)

32.0.0

2021.3 LTS

JDK 11 (OpenJDK 版本 11)

r21d (21.3.6528147)

32.0.0

2020.3 LTS

JDK 8 (OpenJDK 版本 1.8)

r19 (19.0.5232133)

30.0.2

信息来源：Unity - 手册：Android 环境设置 - Unity 文档

重要提示：Unity 2020.3和2021.3 LTS不支持Android SDK构建工具版本31及更高版本。

二、手动下载所需工具

1. 下载JDK（Java开发工具包）

根据您的Unity版本选择对应的JDK版本：

  • JDK 17：适用于Unity 6000.0

    • 下载地址：https://adoptium.net/temurin/releases/?version=17

    • 选择macOS版本下载

  • JDK 11：适用于Unity 2021.3-2022.3 LTS

    • 下载地址：https://adoptium.net/temurin/releases/?version=11

  • JDK 8：适用于Unity 2020.3 LTS

    • 下载地址：https://adoptium.net/temurin/releases/?version=8

安装后，JDK通常位于：/Library/Java/JavaVirtualMachines/目录下。

2. 下载Android SDK（推荐使用命令行工具）

方法一：使用Homebrew安装（最简单）

# 安装Android命令行工具
brew install --cask android-commandlinetools

# 创建SDK目录结构
mkdir -p ~/Library/Android/sdk/cmdline-tools

# 查看安装位置并链接
ls /opt/homebrew/Caskroom/android-commandlinetools/
ln -s /opt/homebrew/Caskroom/android-commandlinetools/latest ~/Library/Android/sdk/cmdline-tools/latest

方法二：手动下载命令行工具

# 创建目录
mkdir -p ~/Library/Android/sdk

# 下载命令行工具
cd ~/Library/Android/sdk
curl -O https://dl.google.com/android/repository/commandlinetools-mac-11076708_latest.zip
unzip commandlinetools-mac-*.zip

# 创建正确的目录结构
mkdir cmdline-tools
mv tools cmdline-tools/latest

3. 使用sdkmanager安装必要组件

打开终端，进入SDK目录：

cd ~/Library/Android/sdk/cmdline-tools/latest/bin

根据您的Unity版本安装对应组件：

对于Unity 6000.0：

./sdkmanager "platforms;android-34" "platform-tools" "build-tools;34.0.0"

对于Unity 2022.3 LTS：

./sdkmanager "platforms;android-32" "platform-tools" "build-tools;32.0.0"

对于Unity 2021.3 LTS：

./sdkmanager "platforms;android-32" "platform-tools" "build-tools;32.0.0"

对于Unity 2020.3 LTS：

./sdkmanager "platforms;android-30" "platform-tools" "build-tools;30.0.2"

4. 下载Android NDK

根据Unity版本下载对应的NDK：

  • NDK r23b（Unity 6000.0、2022.3 LTS）：

    • 下载地址：https://developer.android.com/ndk/downloads?hl=zh-cn

    • 选择版本：23.1.7779620

  • NDK r21d（Unity 2021.3 LTS）：

    • 下载地址：https://developer.android.com/ndk/downloads/older_releases?hl=zh-cn

    • 选择版本：21.3.6528147

  • NDK r19（Unity 2020.3 LTS）：

    • 下载地址：https://developer.android.com/ndk/downloads/older_releases?hl=zh-cn

    • 选择版本：19.0.5232133

下载后解压到合适位置，例如：~/Library/Android/ndk/

三、在Unity中配置工具路径

  1. 打开Unity编辑器

  2. 进入外部工具设置：

    • 菜单栏选择 Unity > Settings > External Tools（macOS）

    • 或 Edit > Preferences > External Tools（Windows/Linux）

  3. 配置Android部分：

    • JDK配置：

      • 取消勾选"JDK Installed with Unity (recommended)"

      • 点击"Browse"，选择您安装的JDK路径

      • 示例路径：/Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home/

    • Android SDK配置：

      • 取消勾选"Android SDK Tools Installed with Unity (recommended)"

      • 点击"Browse"，选择Android SDK目录

      • 示例路径：/Users/[您的用户名]/Library/Android/sdk

    • Android NDK配置：

      • 取消勾选"Android NDK Installed with Unity (recommended)"

      • 点击"Browse"，选择NDK解压目录

      • 示例路径：/Users/[您的用户名]/Library/Android/ndk/android-ndk-r23b

  4. 保存配置：

    • 点击"Apply"或"OK"保存设置

四、配置环境变量（可选但推荐）

为了确保命令行工具正常工作，建议配置环境变量：

  1. 打开终端配置文件：

    # 如果使用Zsh（macOS Catalina及以后版本）
nano ~/.zshrc

# 如果使用Bash（旧版本macOS）
nano ~/.bash_profile

  2. 添加以下内容：

    # Android SDK路径
export ANDROID_SDK_ROOT=$HOME/Library/Android/sdk
export PATH=$PATH:$ANDROID_SDK_ROOT/cmdline-tools/latest/bin
export PATH=$PATH:$ANDROID_SDK_ROOT/platform-tools

# Android NDK路径（根据实际路径调整）
export ANDROID_NDK_HOME=$HOME/Library/Android/ndk/android-ndk-r23b
export PATH=$PATH:$ANDROID_NDK_HOME

# Java路径（根据实际路径调整）
export JAVA_HOME=/Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home
export PATH=$PATH:$JAVA_HOME/bin

  3. 使配置生效：

    # Zsh
source ~/.zshrc

# Bash
source ~/.bash_profile

五、验证配置

1. 验证工具安装

# 验证Java
java -version

# 验证Android SDK
adb version

# 验证sdkmanager
sdkmanager --list

2. 在Unity中测试构建

  1. 创建一个简单的Unity项目

  2. 打开 File > Build Settings

  3. 选择 Android​ 平台，点击 Switch Platform

  4. 点击 Build​ 尝试构建APK文件

六、常见问题解决

1. 下载速度慢或无法下载

使用国内镜像源加速下载：

# 配置清华镜像源
export REPO_OS_OVERRIDE=darwin
sdkmanager --sdk_root=$ANDROID_SDK_ROOT --channel=0 --verbose --no_https \
  --proxy=http --proxy_host=mirrors.tuna.tsinghua.edu.cn --proxy_port=80

或在Android Studio中配置镜像源：

  • 打开 Android Studio > Preferences > Appearance & Behavior > System Settings > Android SDK

  • 点击 SDK Update Sites​ 标签

  • 添加镜像源：https://mirrors.tuna.tsinghua.edu.cn/android/repository/

2. 权限问题

# 确保有读写权限
sudo chown -R $(whoami) ~/Library/Android/

3. Unity提示"Android SDK缺少构建工具"

确保安装了正确版本的Build Tools：

# 查看已安装的构建工具
sdkmanager --list | grep build-tools

# 安装特定版本（以34.0.0为例）
sdkmanager "build-tools;34.0.0"

4. 路径包含空格或特殊字符

确保所有工具路径不包含：

  • 中文

  • 空格

  • 特殊字符（如!@#$%^&*()）

建议使用纯英文路径，如：/Users/username/Development/Android/sdk

七、替代方案：使用Android Studio管理SDK

如果命令行工具配置困难，可以使用Android Studio管理SDK：

  1. 下载安装Android Studio：https://developer.android.com/studio

  2. 打开SDK Manager：

    • 启动Android Studio

    • 进入 Preferences > Appearance & Behavior > System Settings > Android SDK

  3. 安装必要组件：

    • 在 SDK Platforms​ 选项卡选择对应Android API级别

    • 在 SDK Tools​ 选项卡勾选：

      • Android SDK Build-Tools（选择对应版本）

      • Android SDK Platform-Tools

      • NDK（选择对应版本）

  4. 在Unity中指向Android Studio的SDK路径：

    • 通常位于：~/Library/Android/sdk

八、重要注意事项

  1. 版本兼容性：严格遵循Unity官方推荐的版本组合，避免使用不兼容的版本

  2. 路径一致性：确保Unity配置的路径与实际安装路径完全一致

  3. 重启Unity：修改配置后重启Unity编辑器使更改生效

  4. 清理缓存：如果遇到问题，尝试清理Unity缓存（菜单：Assets > Reimport All）

  5. 检查控制台错误：构建失败时仔细查看控制台错误信息，通常会有明确提示

九、信息来源

官方权威信息来源网址

1. Unity官方中文文档 - Android环境设置

网址：https://docs.unity3d.org/cn/Manual/android-sdksetup.html

权威性：极高

关键信息：Unity建议使用Unity Hub来安装Android SDK & NDK Tools，以确保获得正确的版本和配置。Unity分别在特定路径下安装Android SDK & NDK Tools和OpenJDK。重要警告：Unity未正式支持除了提供的OpenJDK、SDK或NDK版本外的其他版本。

2. Unity官方手册 - 支持的依赖项版本

网址：https://docs.unity3d.org/cn/Manual/android-requirements.html

权威性：极高

关键信息：提供了完整的Unity版本与工具链版本对应表格：

Unity版本

SDK构建工具版本

SDK命令行工具版本

SDK平台工具版本

6000.0

34.0.0

6

34.0.5

2022.3 LTS

32.0.0

6

32.0.0

2021.3 LTS

32.0.0

6

32.0.0

2020.3 LTS

30.0.2

2

28.0.1

重要警告：Unity版本2020.3和2021.3 LTS不支持Android SDK构建工具版本31及更高版本。

3. Unity官方英文文档 - Android环境设置

网址：https://docs.unity3d.com/Manual/android-sdksetup.html

权威性：极高

关键信息：创建Unity Android应用程序需要以下依赖项：Android Build Support模块、Android SDK、NDK和Java Development Kit。默认情况下，Unity使用OpenJDK。建议在开始前检查Unity的Android要求和兼容性文档。

4. Unity官方文档 - 外部工具配置

网址：https://docs.unity3d.com/Manual/ExternalTools.html

权威性：极高

关键信息：详细说明了Android外部工具的配置方法，解释了"与Unity一起安装的JDK(推荐)"、"与Unity一起安装的Android SDK工具(推荐)"、"与Unity一起安装的Android NDK(推荐)"等选项的含义，提供了配置自定义JDK、SDK和NDK路径的具体步骤。

5. Unity官方文档 - 自定义依赖项版本

网址：https://docs.unity3d.com/Manual/CustomDependencies.html

权威性：极高

关键信息：说明了如何使Unity使用依赖项的自定义版本。重复强调了Unity只正式支持通过Hub提供的OpenJDK、SDK或NDK版本。

补充信息来源网址

6. Android官方文档 - SDK Build Tools版本说明

网址：https://developer.android.com/studio/releases/build-tools

权威性：较高

关键信息：Android SDK Build-Tools是构建Android应用所需的一个Android SDK组件。应保持更新Build Tools组件，可以使用Android SDK管理器下载最新版本。

7. Unity官方文档 - Android要求和兼容性

网址：https://docs.unity3d.com/Manual/android-requirements.html

权威性：极高

关键信息：在开始使用Unity开发Android应用程序之前，请查看Unity对Android的要求和兼容性信息，以确保您了解为该平台开发Unity应用程序的任何限制。

关键版本对应关系总结

根据以上官方文档，完整的版本对应关系如下：

JDK版本要求

  • Unity 6000.0：JDK 17 (OpenJDK版本17)

  • Unity 2022.3 LTS：JDK 11 (OpenJDK版本11)

  • Unity 2021.3 LTS：JDK 11 (OpenJDK版本11)

  • Unity 2020.3 LTS：JDK 8 (OpenJDK版本1.8)

NDK版本要求

  • Unity 6000.0：NDK r23b (23.1.7779620) 或 r27c (6000.0.38及以上版本)

  • Unity 2022.3 LTS：NDK r23b (23.1.7779620)

  • Unity 2021.3 LTS：NDK r21d (21.3.6528147)

  • Unity 2020.3 LTS：NDK r19 (19.0.5232133)

Android SDK Build-Tools版本要求

  • Unity 6000.0：34.0.0

  • Unity 2022.3 LTS：32.0.0

  • Unity 2021.3 LTS：32.0.0

  • Unity 2020.3 LTS：30.0.2

重要注意事项：

  1. Unity 2020.3和2021.3 LTS不支持Android SDK构建工具版本31及更高版本。

  2. Unity只正式支持通过Hub提供的OpenJDK、SDK或NDK版本。

  3. 虽然可以手动配置自定义版本，但官方建议使用Unity Hub安装以确保兼容性。

这些网址均指向Unity官方文档，具有最高的权威性和准确性。建议您直接访问这些官方文档获取最新和最准确的信息。

# macos # unity # android
Logo
DeepSeek技术社区

欢迎加入DeepSeek 技术社区。在这里，你可以找到志同道合的朋友，共同探索AI技术的奥秘。

更多推荐

cover

DeepSeek RAG 查询缓存命中率优化：如何从 30% 提升到 80% 的工程实践

avatar DeepSeek技术社区
cover

DeepSeek-V4 服务健康检查：为什么你的离线评测全绿，上线却崩了？

avatar DeepSeek技术社区
cover

DeepSeek输出护栏实战：如何用结构化JSON抵御越狱与幻觉

avatar DeepSeek技术社区