1. Android开发环境搭建：从零开始，跑起你的第一个Hello World

说实话，每次带新人入行，我最怕的就是环境搭建这一步。不是技术难，而是坑多。我自己当年刚学Android时，光配JDK就折腾了一下午——后来发现是路径里多了个空格。嗯，咱们今天就把这事捋清楚。

1.1 JDK：一切的基础

Android开发离不开Java，所以JDK是第一步。我个人习惯用JDK 17，稳定且兼容性好。你可能会问：为什么不用最新的？我在项目中遇到过，新版JDK有时会和Gradle版本打架，得不偿失。

安装步骤：

  1. 去Oracle官网或Adoptium下载JDK 17（LTS版本）
  2. 双击安装，记住安装路径（比如 C:\Program Files\Java\jdk-17）
  3. 配置环境变量：
    • 新建 JAVA_HOME，值填你的JDK路径
    • 在 Path 变量中添加 %JAVA_HOME%\bin
  4. 打开命令行，输入 java -version，看到版本信息就对了
⚠️ 注意： 我曾经因为装了多个JDK版本，导致Android Studio死活认不对。建议只保留一个JDK，或者用工具管理版本。

1.2 Android SDK：你的工具箱

SDK说白了就是Android系统的开发工具包。你写代码时调用的那些API，都在这里面。安装SDK通常有两种方式：

  • 通过Android Studio安装（推荐，省心）
  • 单独下载命令行工具（适合CI/CD场景）

我个人建议用第一种。Android Studio的SDK Manager里，你可以勾选需要的版本。一般我会装：

组件 说明 我的建议
Android SDK Platform 对应Android版本的API 至少装API 33和API 34
Android SDK Build-Tools 编译工具 装最新版就行
Android Emulator 模拟器镜像 选一个你测试用的系统版本
Google USB Driver 真机调试驱动 Windows用户必装
💡 小技巧： 你可以在环境变量里设置 ANDROID_HOME，指向SDK路径。这样很多命令行工具就能直接用了。

1.3 Gradle：构建系统的幕后英雄

Gradle是Android的构建工具。说白了，它负责把你的代码、资源、依赖打包成APK。Android Studio自带Gradle，但你也可以单独装一个。

为什么会单独装？我在项目中遇到过，有些老项目需要特定版本的Gradle，而Studio自带的版本不匹配。这时候手动指定版本就很有用。

关键文件：

  • gradle-wrapper.properties：指定Gradle版本
  • build.gradle（项目级）：配置仓库和插件
  • build.gradle（模块级）：配置依赖和构建参数

你想想看，Gradle其实就是一个流水线。你告诉它要做什么，它按顺序执行。我第一次接触时觉得它很复杂，后来发现只要记住几个核心配置就够了。

1.4 Android Studio：你的主战场

Android Studio是Google官方的IDE，基于IntelliJ IDEA。我个人觉得它比Eclipse好用太多了——尤其是代码补全和布局预览。

安装要点：

  1. 从官网下载安装包，建议选稳定版
  2. 安装时勾选 Android Virtual Device（模拟器）
  3. 首次启动会联网下载SDK组件，耐心等待
  4. 配置代理（如果你在墙内），不然下载很慢
🔧 我的配置习惯：
  • 内存分配：至少4GB（在 studio64.exe.vmoptions 里改）
  • 自动导入：勾选 Enable auto-import
  • 字体：JetBrains Mono，14号，看着舒服

1.5 第一个Hello World项目

好了，环境搭好了，咱们跑个Hello World试试。这个过程其实很简单，但有几个细节要注意。

创建项目：

  1. 打开Android Studio，点击 New Project
  2. 选择 Empty Views Activity（别选Compose，咱们先学传统方式）
  3. 填写项目名：HelloWorld，包名：com.example.helloworld
  4. 选择语言：Java或Kotlin（我建议Kotlin，现在主流）
  5. Minimum SDK：API 24（覆盖95%以上的设备）
  6. 点击Finish，等待Gradle同步完成

同步完成后，你会看到项目结构。核心文件就这几个：

  • MainActivity.kt：入口Activity
  • activity_main.xml：布局文件
  • AndroidManifest.xml：应用配置
  • build.gradle.kts：模块构建配置

运行项目：

  1. 点击工具栏的绿色三角形（或按Shift+F10）
  2. 选择模拟器或连接真机
  3. 等待编译和安装

如果一切顺利，你会看到模拟器上显示 Hello World!。嗯，这一刻的感觉，我到现在还记得。

⚠️ 常见问题：
  • Gradle同步失败：检查网络，或者手动下载Gradle版本
  • 模拟器启动黑屏：试试冷启动，或者降低RAM大小
  • 真机不识别：打开开发者选项和USB调试

1.6 知识体系总览

下面这张图，帮你理清整个环境搭建的脉络。说白了，就是一层层往上搭：

Android开发环境搭建知识体系 JDK 17 Java开发工具包 Android SDK Platform + Build-Tools + Emulator Gradle 构建系统 & 依赖管理 Android Studio IDE + 模拟器 + 调试工具 🎉 Hello World 基础层 工具层 构建层 开发层 运行层

你看，从JDK到Hello World，其实就这五步。每一步都有它的作用，缺一不可。我当年踩过的坑，就是跳过了某一步的验证，结果后面全乱套。

1.7 避坑指南

最后，分享几个我亲身经历过的坑：

  • 路径带中文或空格：我曾经把SDK装在了 D:\Android SDK，结果Gradle死活找不到。后来改成 D:\Android_SDK 就好了。
  • 代理设置：如果你在下载依赖时卡住，八成是网络问题。Android Studio的Settings里可以配HTTP代理。
  • 模拟器太慢：试试用真机调试，或者开启Intel HAXM加速。我一般用真机，模拟器只用来测试不同屏幕尺寸。
  • Gradle版本不匹配：项目里的 gradle-wrapper.properties 和本地安装的版本要一致。不一致时，要么升级项目，要么降级Gradle。
📌 我的建议： 环境搭建完成后，先别急着写代码。花10分钟跑一遍模拟器，确认所有组件都正常工作。这一步省了，后面能省一小时。

好了，环境搭好了，项目也跑起来了。接下来你就可以开始写真正的Android代码了。记住，环境搭建是基础，基础打牢了，后面才走得稳。

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

← 上一章 📖 返回目录 下一章 →