3. 开发环境配置
说实话,我见过太多新手在环境配置这一步就卡住了。明明代码逻辑没问题,模拟器就是不启动,或者 Gradle 报一堆看不懂的错。我个人习惯是先把环境搭干净,后面才能专心写业务。这一章咱们就把 Android Studio 最新版安装、SDK 管理、模拟器创建和 Gradle 版本这几个核心点理清楚。
3.1 安装 Android Studio:别选错包
去官网下载时注意看版本号。我遇到过有人下了 Canary 版,结果插件不兼容,折腾半天又重装。建议直接选 稳定版(Stable Channel)。
安装后首次启动会引导下载 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 Tools | NDK、CMake、模拟器镜像、ProGuard 等 | 把 Android SDK Build-Tools 和 Android Emulator 勾上 |
| SDK Update Sites | 镜像地址配置 | 国内开发者可以换成中科大或腾讯的镜像 |
我之前在项目里同时维护三个不同 targetSdk 的项目,SDK 平台装了一大堆。后来发现其实只保留 30 和 33 就够用了,公司内部统一升级后,其他版本占空间还容易搞混。所以 按需安装 是最好的。
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.0 | 8.0.x | 配合 Kotlin 1.8 挺稳 |
| 8.1 | 8.1.x | 升级后 build 速度提升明显 |
| 8.2 | 8.2.x | 注意 AGP 8.2 要求 compileSdk 34+ |
| 7.6 | 7.4.x | 老项目还在用,别轻易升 |
为什么会这样?因为 AGP 用到的 API 在不同 Gradle 版本里可能变了。我曾经把一个项目从 Gradle 7.4 升到 8.0,结果自定义 task 里调用 Gradle API 的地方全报错,改了一下午。
gradle-wrapper.properties 里指定 exact version,别用 + 通配符,否则团队环境不一致。
3.5 环境配置完整流程
把上面几步串起来,就是一个从零到能跑 Hello World 的流程。下面这张图概括了核心步骤和常见的拦路虎:
环境配置就像盖楼打地基。一次到位后,后面开发几乎不会再碰这里。我每次换电脑或公司,都会把这套流程走一遍,顺带更新一下 SDK 和 Gradle 版本。希望这章的内容能帮你避开我当年遇到的那些坑。