一、工欲善其事,必先利其器

做Android开发,第一件事就是把开发环境搭好。我记得刚入行那会儿,光装环境就折腾了一整天——JDK版本不对、SDK路径带中文、Gradle下载卡住...全是坑。今天我把这些经验都整理出来,你跟着一步步来,半小时内就能跑起第一个Hello World。

核心要点:开发环境 = JDK + Android Studio + Android SDK + 模拟器/真机

Android开发环境 JDK 17+ Android Studio Android SDK 配置 JAVA_HOME 验证 java -version 下载安装包 配置代理/镜像 SDK Manager 创建模拟器 三步走:装JDK → 装Studio → 配SDK

二、JDK安装与配置

2.1 下载JDK

Android开发现在推荐用JDK 17。为什么?因为Android Gradle Plugin 8.0以上版本已经强制要求JDK 17了。我之前有个项目还用的JDK 11,升级AGP后直接编译报错,折腾了半天才发现是JDK版本问题。

去Oracle官网或者用OpenJDK都行。我个人习惯用Oracle JDK,稳定,坑少。下载时注意选对操作系统版本——Windows选.exe,macOS选.dmg,Linux选.tar.gz。

⚠️ 注意:不要下载JDK 8或JDK 11了!虽然它们还能用,但新版本的Android Studio和Gradle已经不再支持。你想想看,装个旧版本回头还得重装,何必呢?

2.2 配置环境变量

Windows用户,右键"此电脑"→属性→高级系统设置→环境变量。新建一个JAVA_HOME,值指向你的JDK安装路径,比如:

JAVA_HOME = C:\Program Files\Java\jdk-17

然后在Path变量里加上:

%JAVA_HOME%\bin

macOS和Linux用户,编辑~/.bash_profile~/.zshrc

export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home
export PATH=$JAVA_HOME/bin:$PATH

配置完记得验证一下。打开终端或命令行,输入:

java -version

如果看到类似openjdk version "17.0.1" 2021-10-19的输出,说明JDK装好了。

💡 小技巧:我曾经遇到过明明配了JAVA_HOME,但java -version还是旧版本。后来发现是Path里有两个JDK路径,系统取了第一个。解决办法:把新JDK的路径放在Path最前面。

三、安装Android Studio

3.1 下载与安装

去Android开发者官网下载最新版Android Studio。目前稳定版是Hedgehog(2023.1.1)或更高版本。下载时注意:Windows有.exe和.zip两种,建议用.exe安装包,它会帮你处理一些系统依赖。

安装过程很简单,一路Next就行。但有几点我建议你注意:

  • 安装路径不要带中文——我之前有个同事路径写了"安卓开发",结果Gradle编译各种奇葩报错
  • 安装路径不要有空格——比如Program Files (x86)这种,虽然现在兼容性好了,但保不齐哪个插件就翻车
  • 记住你的安装位置——后面配置SDK时会用到

3.2 首次启动配置

第一次启动Android Studio,它会问你要不要导入之前的设置。如果你是全新安装,选"Do not import settings"。

然后它会自动检测JDK。如果检测不到,手动指定一下你刚才装的JDK 17路径。嗯,这里要注意:Android Studio自带了JDK,但版本可能比较老,我建议用你自己装的。

接下来是SDK配置。它会让你选择SDK的安装路径。我个人习惯单独建一个文件夹,比如D:\Android\SDK,不要放在C盘——你想想看,SDK越来越大,C盘分分钟爆满。

推荐SDK目录结构:

D:\Android\
  ├── SDK\          # Android SDK
  ├── Studio\       # Android Studio
  └── Projects\     # 你的项目代码

四、配置Android SDK

4.1 SDK Manager

安装完成后,打开Android Studio,点击右下角的"Configure"→"SDK Manager"。或者直接在欢迎界面点"More Actions"→"SDK Manager"。

在SDK Manager里,你需要安装以下几样东西:

组件 说明 建议
Android SDK Platform 各Android版本的API 至少装一个最新稳定版(比如Android 14)
Intel x86 Emulator Accelerator (HAXM) 模拟器加速器 Windows和macOS必须装,不然模拟器卡成PPT
Android SDK Build-Tools 编译工具 会自动匹配,不用手动选
Android Emulator 模拟器本体 建议装,调试方便

⚠️ 网络问题:国内下载SDK经常很慢。我曾经等了一个小时还没下载完。解决办法:在SDK Manager的"SDK Update Sites"里,勾选"Force https://... sources to be fetched using http://",或者配置阿里云镜像。具体镜像地址网上搜一下就有。

4.2 创建模拟器

SDK装好后,点"Configure"→"AVD Manager"创建模拟器。选一个设备,比如Pixel 6,然后选一个系统镜像。我建议下载不带Google Play的版本,体积小一些。

创建时注意几个设置:

  • RAM:至少2GB,推荐4GB。设太小了模拟器会卡
  • VM heap:256MB或512MB
  • Internal Storage:至少2GB,不然装几个App就满了

启动模拟器后,如果遇到"Intel HAXM is not installed"的报错,去BIOS里开启虚拟化技术(VT-x/AMD-V)。这个坑我踩过——当时折腾了一下午,最后发现是BIOS里没开虚拟化。

五、创建第一个Hello World项目

5.1 新建项目

回到欢迎界面,点"New Project"。选择"Empty Views Activity"(空模板),然后配置项目信息:

项目名称:HelloWorld
包名:com.example.helloworld
保存位置:D:\Android\Projects\HelloWorld
语言:Kotlin(推荐)
最低SDK:API 24 (Android 7.0)

为什么选Kotlin?因为Google官方已经全面转向Kotlin了。Java当然也能用,但新项目我建议直接用Kotlin。你想想看,学新东西肯定学主流方向。

5.2 项目结构

项目创建完成后,你会看到这样的结构:

HelloWorld/
├── app/
│   ├── src/
│   │   ├── main/
│   │   │   ├── java/com/example/helloworld/
│   │   │   │   └── MainActivity.kt
│   │   │   ├── res/
│   │   │   │   ├── layout/
│   │   │   │   │   └── activity_main.xml
│   │   │   │   └── values/
│   │   │   │       ├── strings.xml
│   │   │   │       └── themes.xml
│   │   │   └── AndroidManifest.xml
│   │   └── test/
│   └── build.gradle.kts
├── build.gradle.kts
└── settings.gradle.kts

别被这么多文件吓到。说白了,你只需要关注两个文件:

  • MainActivity.kt——代码逻辑
  • activity_main.xml——界面布局

5.3 运行项目

打开activity_main.xml,你会看到一个"Hello World!"的TextView。这就是默认的界面。如果你想改文字,在strings.xml里修改app_name的值。

然后点击工具栏上的绿色三角形按钮(Run),选择你刚才创建的模拟器。第一次运行会下载一些依赖,耐心等一会儿。看到模拟器上出现"Hello World!"的那一刻,恭喜你,环境配好了!

💡 真机调试:如果你有Android手机,用数据线连上电脑,开启开发者选项和USB调试。比模拟器快多了。我平时开发都是真机调试,模拟器只在测试不同屏幕尺寸时才用。

六、常见问题与避坑

最后总结几个我遇到过的坑,你碰到了可以直接对照:

  • Gradle同步失败:多半是网络问题。配置阿里云镜像,或者开VPN。
  • 模拟器启动黑屏:检查HAXM是否安装,BIOS虚拟化是否开启。
  • 编译报错"Unsupported class file major version 65":JDK版本太高或太低。确认用的是JDK 17。
  • SDK路径找不到:检查环境变量ANDROID_HOME是否配置,指向你的SDK目录。

好了,环境配置就到这里。记住:开发环境是地基,地基稳了,后面写代码才顺手。别嫌配置麻烦,磨刀不误砍柴工。


公众号:蓝海资料掘金营,微信deep3321