3. 开发环境配置

说实话,我见过太多新手在环境配置这一步就卡住了。明明代码逻辑没问题,模拟器就是不启动,或者 Gradle 报一堆看不懂的错。我个人习惯是先把环境搭干净,后面才能专心写业务。这一章咱们就把 Android Studio 最新版安装、SDK 管理、模拟器创建和 Gradle 版本这几个核心点理清楚。

3.1 安装 Android Studio:别选错包

去官网下载时注意看版本号。我遇到过有人下了 Canary 版,结果插件不兼容,折腾半天又重装。建议直接选 稳定版(Stable Channel)。

小技巧: Windows 上安装路径不要带中文或空格,否则 NDK 编译会报路径错。Mac 上直接拖到 Applications 就行。

安装后首次启动会引导下载 SDK。这里有个坑——如果你网络不好,容易卡在「Fetching SDK」界面。我的经验是提前挂好代理,或者用国内的镜像站(后面 SDK Manager 里会讲)。

3.2 SDK Manager:管好你的版本

SDK Manager 入口在 Tools → SDK Manager。打开后你会看到三个主要标签:SDK Platforms、SDK Tools、SDK Update Sites。

标签页干嘛用的个人建议
SDK Platforms安装不同 Android 版本的 API 库只装你项目要用的版本 + 最新的预览版
SDK ToolsNDK、CMake、模拟器镜像、ProGuard 等把 Android SDK Build-Tools 和 Android Emulator 勾上
SDK Update Sites镜像地址配置国内开发者可以换成中科大或腾讯的镜像

我之前在项目里同时维护三个不同 targetSdk 的项目,SDK 平台装了一大堆。后来发现其实只保留 30 和 33 就够用了,公司内部统一升级后,其他版本占空间还容易搞混。所以 按需安装 是最好的。

注意: 不要更新到一半强制关闭 AS。我见过有人断电后 SDK 目录损坏,导致所有项目都无法编译。最好设一个环境变量 ANDROID_SDK_ROOT,这样万一重装 AS 也能复用。

3.3 AVD 模拟器:创建一台「好用的」虚拟机

AVD Manager 里创建模拟器时,有两点特别重要:系统镜像选择 和 硬件配置。

  • 系统镜像:优先选带有 "Google Play" 和 "x86-64" 的。ARM 镜像在非 ARM 电脑上跑会非常慢。
  • 硬件配置:给模拟器分配 2GB RAM、512MB heap 足矣。CPU 内核数别超过你物理机的一半。
  • 存储:SD 卡大小设 200MB 就够了,除非你要测试大文件。

我曾经为了省空间,给模拟器只配了 1GB RAM,结果 App 启动就 OOM。后来老老实实加到 2GB,流畅很多。你想想看,模拟器其实是个完整的 Android 系统,太抠门肯定卡。

还有个小坑:创建后第一次启动模拟器会很慢,因为要生成用户数据分区。建议先让它跑一遍,然后 快照保存 重启时间能压缩到 5 秒内。

3.4 Gradle 版本兼容性:踩坑实录

嗯,这部分我踩过的坑能写满一页纸。Gradle 版本和 Android Gradle Plugin(AGP)版本需要严格匹配。官方有一个兼容性表格,但很多人懒得查直接升级,然后就报错。

Gradle 版本AGP 版本我的项目经历
8.08.0.x配合 Kotlin 1.8 挺稳
8.18.1.x升级后 build 速度提升明显
8.28.2.x注意 AGP 8.2 要求 compileSdk 34+
7.67.4.x老项目还在用,别轻易升

为什么会这样?因为 AGP 用到的 API 在不同 Gradle 版本里可能变了。我曾经把一个项目从 Gradle 7.4 升到 8.0,结果自定义 task 里调用 Gradle API 的地方全报错,改了一下午。

核心建议: 每次升 Gradle 或 AGP,先看官方迁移指南。然后在 gradle-wrapper.properties 里指定 exact version,别用 + 通配符,否则团队环境不一致。

3.5 环境配置完整流程

把上面几步串起来,就是一个从零到能跑 Hello World 的流程。下面这张图概括了核心步骤和常见的拦路虎:

Android 开发环境配置流程 安装 Android Studio SDK Manager 配置 创建 AVD 模拟器 Gradle 版本校验 构建并运行 常见踩坑点 • 网络超时 → 用国内镜像 • 模拟器启动慢 → 开启快照 • Gradle 版本不匹配 → 查表 • SDK 目录损坏 → 设环境变量 • CPU 虚拟化未开启 → BIOS 设置 • heap 给太少 → OOM

环境配置就像盖楼打地基。一次到位后,后面开发几乎不会再碰这里。我每次换电脑或公司,都会把这套流程走一遍,顺带更新一下 SDK 和 Gradle 版本。希望这章的内容能帮你避开我当年遇到的那些坑。