这是一篇思路清晰的 Android 环境配置教程。

准备#

需要有基本的编程素养。
知道命令行怎么使用。
知道怎么配置环境变量。

概念#

Android 开发中有几个概念需要了解：

Android Studio - 一个 Android 集成开发环境，日常开发都在这上面完成。
Gradle - 一个构建工具，可以自定义命令进行构建，Java 实现。
Android SDK - 构建 Android 项目所需的 SDK。
Java - Gradle 的依赖，也是 Android 开发所需的编程语言。
Maven - Java 仓库。开发中经常需要引用依赖，而这些依赖由 Maven 管理。
Kotlin - Google 官方推荐的 Android 开发语言。实际上，它的作用和 Java 是一样的，只不过是 Google 不想用主流编程语言，这样可以显得别具一格。

这里我们先不讨论 Kotlin，默认使用 Java。

具体说，构建 Android 应用需要使用 Gradle 作为构建工具，而 Android SDK 是为了构建 Android 应用所作出的适配，我们的应用是基于 Android SDK 构建的。用 Gradle 构建，必然就少不了 Java。而 Java 又使用 Maven 作为依赖管理。而 Android Studio 只是一个辅助开发的图形界面。

我们需要知道的是：

Android 应用使用 Java 编写。
原生 Java 并不支持 Android，而 Android SDK 就解决了这个问题。Android SDK 是编写 Java 所必须的依赖。
Android 应用使用 Gradle 构建。

所以，构建一个 Android 应用所需的核心组件是：Gradle、Java、Android SDK。

到这里思路就清晰了吧！

而 Android Studio 的作用就是：提高开发效率，提供可视化编辑界面，并利用可视化界面来操作 Gradle、Java、Android SDK。

所以如果没有 Android Studio，可以构建 Android 应用吗？答案是完全可以！

下面我们根据思路来准备 Android 开发环境吧！

记住，Android 开发环境无非就是三个：Gradle、Java、Android SDK。

NOTE
本文使用 Linux 演示，而不是 Windows。配置 Android 开发环境的过程中，Windows 与 Linux 的区别仅限于：Windows 目录使用反斜杠 \ 和下载软件的区别，其它方面（如环境变量的值）都是相同的。

IMPORTANT
以下操作中，有些需要设置环境变量。如果使用 Android Studio，理论上可以不设置环境变量，直接在 Android Studio 中设置即可。但为了避免 BUG，建议跟着设置一遍环境变量。

Gradle#

配置#

前往 Gradle 官网下载 Gradle，也可以直接前往 Gradle 发布页面下载，这里只需要下载 binary-only。下载后解压。

解压后的文件结构如下：

1
gradle-9.0.0/
2
├── bin
3
├── init.d
4
├── lib
5
├── LICENSE
6
├── NOTICE
7
└── README

之后设置环境变量 GRADLE_HOME 为文件夹 gradle-9.0.0，并把 bin 添加到 PATH 环境变量。

NOTE
事实上，Android Studio 会自动下载 Gradle，但国内下载速度太慢。这一步是为了我们通过各种合适的渠道下载，然后在 Android Studio 中指定使用本地 Gradle。

TIP
如果不能下载，可以前往阿里云镜像下载。下载时注意下载的版本号。

另外，可以设置 GRADLE_USER_HOME，这是 Gradle 缓存的文件夹。默认是 主目录/.gradle/。

TIP
主目录指的是用户主目录，环境变量 HOME 说明了主目录的位置。Windows 平台下，主目录位于 C:\User\用户名\，而 Linux 平台下，主目录位于 /home/用户名。
Windows 平台下，可以通过以下方法查看主目录：
Terminal window
1
echo %HOME%
Linux 平台下，可以通过以下方法查看主目录：
Terminal window
1
echo $HOME

NOTE
本文中，Mac 平台的方法同 Linux。

Java#

Windows#

前往 Java 下载页面下载Java，安装好后设置环境变量 JAVA_HOME 为 Java 所在的文件夹，如 jdk-21。接着添加 bin 文件夹到 PATH 环境变量。

Linux#

直接使用系统自带的包管理器安装 Java。可以使用 echo $JAVA_HOME 来检查是否已正确设置环境变量（一般来说，包管理器会自动设置）。

Android SDK#

安装 Android SDK 有两种方式，一种是使用命令行安装，一种是使用 Android Studio 安装（当然，这也说明了Android Studio 内置 Android SDK 管理工具）。

使用 Android Studio 安装#

打开 Android Studio，会弹出下面的弹框。如果不需要设置代理，点击 Cancel。

Welcome 页面

接着点击 Next。

选择安装类型页面

这一步选择如何下载 Android SDK。如果不关心安装位置，并且想要开箱即用，那么就选择 Standard。反之选择 Custom。

如果选择 Standard，无脑下一步就行。这里我选择 Custom。

图中可以选择是否需要 Android Virtual Device。由于我的系统已经安装了 Waydroid，不需要虚拟机，所以可以不勾选。此外，还可以选择安装位置。

选择安装 SDK 页面

下一步，同意协议。

协议页面

接着下一步，开始下载。国内环境可以下载，并且如果是 5G，下载也很快。

下载页面

下载完成后就进入了主界面。可以打开 SDK Manager 查看已经安装的 SDK。

主界面

在这里可以管理本地的 Android SDK。同样，项目界面中也可以管理 SDK。推荐取消勾选“Hide Obsolete Packages”来查看所有的包。

SDK Manager

使用命令行安装#

前往 Android Studio 下载页面，找到“仅限命令行工具”，选择你的平台下载。

新建一个存 Android SDK 的文件夹，如 D:\AndroidSDK 或 $HOME/AndroidSDK。

1
mkdir AndroidSDK

解压 cmdline-tools，然后在 AndroidSDK 文件夹下创建 cmdline-tools/latest。随后把解压得出的 cmdline-tools 文件夹中的所有文件移动（或复制）到 latest 文件夹中。

1
unzip Downloads/commandlinetools-linux-13114758_latest.zip -d Downloads
2
mkdir -p AndroidSDK/cmdline-tools/latest
3
mv Downloads/cmdline-tools/. AndroidSDK/cmdline-tools/latest

此时的文件结构是：（文件夹 cmdline-tools 在文件夹 AndroidSDK 中）

1
cmdline-tools/
2
└── latest
3
    ├── bin
4
    │   ├── apkanalyzer
5
    │   ├── avdmanager
6
    │   ├── d8
7
    │   ├── lint
8
    │   ├── profgen
9
    │   ├── r8
10
    │   ├── resourceshrinker
11
    │   ├── retrace
12
    │   ├── screenshot2
13
    │   └── sdkmanager
14
    ├── lib
15
    ├── NOTICE.txt
16
    ├── package.xml
17
    └── source.properties

如果想要方便，还可以把 bin 文件夹添加到 PATH 中。

现在可以下载 Android SDK 了，下载的默认目录即为刚刚创建的 AndroidSDK 目录。

对 Android SDK 进行管理，需使用 sdkmanager 命令：

1
# 获取帮助
2
sdkmanager --help
3

4
# 获取可安装的SDK
5
sdkmanager --list
6

7
# 下载SDK，例如android源码。可以指定参数 --install
8
sdkmanager "source;android-35"

NOTE
sdkmanager 需要使用 Java。使用前，请确保你已经正确安装了 Java。

选择 SDK#

SDK 除了作为构建 Android 应用的依赖之外，还有其它用处，比如源码、虚拟机、调试等。

对于一般开发来说，我们通常不需要下载所有 SDK，而只需要选择常用的即可。下面对一些常用的 SDK 进行解释：

build-tools - Android 应用的构建工具，你可以理解为它会被 Gradle 调用。一般选择最新的即可。
cmake - 构建 C 库的工具。
cmdline-tools - Android SDK 命令行工具，可以在官网下载。如果你使用 Android Studio 自带的 SDK 工具，可以不下载。
ndk - 构建 C 库的 Android 依赖和构建工具。
platform-tools - Android 工具，内含 Android Debug Bridge（ADB）等多种工具。
platforms - 构建 Android 应用的依赖。
sources - Android 源码。
system-image - Android 虚拟机镜像，可以用来创建虚拟机。其中带 GApps 的是指包含 GMS。

一般来说，我们只需要下载：build-tools、platform-tools、platforms 这三样。如果需要 C，那么就下载 ndk（cmake 是可选的）。

Android Studio 额外的配置#

打开设置，选择 Gradle，这里需要选择 Distribution 和 Gradle JDK。如果不选择，Android Studio 会自动下载（但下载速度很慢）。由于之前已经下载好 Gradle 和 JDK，这里直接选择本地的即可。（注意 Gradle 的文件夹需要包含 bin 文件夹）

另外，Gradle 的缓存数据量很大。如果是 Windows，会使用 C 盘空间。你可以考虑在这个页面设置 Gradle user home 来解决问题。

Gradle 设置

至于 Maven 镜像，如果不添加镜像也是可以下载的，只不过速度比较慢而已。这里我非常不建议添加国内的镜像，因为国内镜像貌似有各种版本问题。