# 开发环境搭建

## 目录
- [JDK安装配置](#jdk安装配置)
- [Android Studio安装](#android-studio安装)
- [SDK配置](#sdk配置)
- [模拟器配置](#模拟器配置)
- [真机调试配置](#真机调试配置)
- [环境变量设置](#环境变量设置)
- [常见问题](#常见问题)

---

## JDK安装配置

### JDK版本选择

```java
// 推荐版本：
// - JDK 11（LTS，长期支持）
// - JDK 17（LTS，最新长期支持）
// - JDK 8（兼容性好，但较旧）

// Android Studio 内置 JDK，也可以使用系统 JDK
```

### Windows安装JDK

```bash
# 1. 下载 JDK
# 访问 Oracle 官网或 OpenJDK 下载

# 2. 安装 JDK
# 运行安装程序，按提示安装

# 3. 配置环境变量
# 系统属性 → 高级 → 环境变量
# 新建 JAVA_HOME = C:\Program Files\Java\jdk-11
# 编辑 Path，添加 %JAVA_HOME%\bin

# 4. 验证安装
java -version
javac -version
```

### macOS安装JDK

```bash
# 方式1：使用 Homebrew
brew install openjdk@11

# 方式2：下载安装包
# 从官网下载 .dmg 文件安装

# 配置环境变量（~/.zshrc 或 ~/.bash_profile）
export JAVA_HOME=$(/usr/libexec/java_home -v 11)
export PATH=$JAVA_HOME/bin:$PATH

# 验证
java -version
```

### Linux安装JDK

```bash
# Ubuntu/Debian
sudo apt update
sudo apt install openjdk-11-jdk

# 配置环境变量（~/.bashrc）
export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64
export PATH=$JAVA_HOME/bin:$PATH

# 验证
java -version
```

---

## Android Studio安装

### 下载Android Studio

```java
// 1. 访问官网
// https://developer.android.com/studio

// 2. 下载安装包
// - Windows: .exe 安装程序
// - macOS: .dmg 磁盘映像
// - Linux: .tar.gz 压缩包
```

### Windows安装

```bash
# 1. 运行安装程序
# android-studio-xxxx.exe

# 2. 选择安装组件
# - Android Studio
# - Android SDK
# - Android Virtual Device
# - Performance (Intel HAXM)

# 3. 选择安装路径
# 建议：C:\Program Files\Android\Android Studio

# 4. 完成安装
```

### macOS安装

```bash
# 1. 打开 .dmg 文件
# 2. 拖拽 Android Studio 到 Applications
# 3. 首次启动，完成设置向导
```

### Linux安装

```bash
# 1. 解压文件
tar -xzf android-studio-*.tar.gz

# 2. 移动到合适位置
sudo mv android-studio /opt/

# 3. 创建启动脚本
# /opt/android-studio/bin/studio.sh
```

### 首次启动配置

```java
// 1. 欢迎界面
// - 选择 Standard 安装类型（推荐）

// 2. SDK 组件安装
// - Android SDK
// - Android SDK Platform
// - Android Virtual Device

// 3. 许可协议
// - 接受所有许可协议

// 4. 完成设置
```

---

## SDK配置

### SDK Manager

```java
// 打开 SDK Manager
// File → Settings → Appearance & Behavior → System Settings → Android SDK

// 或
// Tools → SDK Manager
```

### 必需组件

```java
// 1. Android SDK Platform
// - 选择目标 API 级别（推荐 API 33+）
// - 至少安装一个最新版本

// 2. Android SDK Build-Tools
// - 最新版本
// - 用于编译应用

// 3. Android SDK Platform-Tools
// - ADB 工具
// - Fastboot 工具

// 4. Android SDK Tools
// - 开发工具

// 5. Android Emulator
// - 模拟器

// 6. Intel x86 Emulator Accelerator (HAXM)
// - Windows/macOS 模拟器加速
```

### SDK路径配置

```java
// Windows 默认路径：
// C:\Users\<用户名>\AppData\Local\Android\Sdk

// macOS 默认路径：
// ~/Library/Android/sdk

// Linux 默认路径：
// ~/Android/Sdk
```

---

## 模拟器配置

### 创建虚拟设备

```java
// 1. 打开 AVD Manager
// Tools → Device Manager

// 2. 创建虚拟设备
// Create Device

// 3. 选择设备定义
// - Pixel 5（推荐）
// - Pixel 6
// - 其他设备

// 4. 选择系统镜像
// - 推荐：最新稳定版（API 33+）
// - 下载系统镜像（如需要）

// 5. 配置虚拟设备
// - AVD Name：设备名称
// - Graphics：硬件加速（推荐）
// - Show Advanced Settings：高级设置
```

### 模拟器设置

```java
// 性能设置：
// - Graphics: Hardware - GLES 2.0（推荐）
// - RAM: 2048 MB（推荐）
// - VM heap: 512 MB

// 存储设置：
// - Internal Storage: 2048 MB
// - SD Card: 可选

// 网络设置：
// - 默认使用主机网络
```

### 启动模拟器

```java
// 1. 从 AVD Manager 启动
// 2. 或从 Android Studio 运行应用时自动启动
// 3. 或使用命令行：
emulator -avd <AVD_NAME>
```

---

## 真机调试配置

### 启用开发者选项

```java
// 1. 打开设置
// 2. 关于手机
// 3. 连续点击"版本号"7次
// 4. 返回设置，找到"开发者选项"
```

### 启用USB调试

```java
// 1. 打开开发者选项
// 2. 启用"USB调试"
// 3. 连接手机到电脑
// 4. 手机上确认 USB 调试授权
```

### 验证连接

```bash
# 使用 ADB 验证
adb devices

# 应该显示设备列表
# List of devices attached
# <设备ID>    device
```

### 常见问题

```java
// 1. 设备未识别
// - 检查 USB 驱动（Windows）
// - 检查 USB 连接模式（文件传输模式）
// - 重新插拔 USB

// 2. 授权问题
// - 手机上撤销 USB 调试授权
// - 重新连接并授权

// 3. 驱动问题（Windows）
// - 安装手机厂商 USB 驱动
// - 或使用通用 Android USB 驱动
```

---

## 环境变量设置

### Windows环境变量

```bash
# 1. 设置 ANDROID_HOME
# 系统属性 → 高级 → 环境变量
# 新建 ANDROID_HOME = C:\Users\<用户名>\AppData\Local\Android\Sdk

# 2. 添加到 Path
# %ANDROID_HOME%\platform-tools
# %ANDROID_HOME%\tools
# %ANDROID_HOME%\tools\bin

# 3. 验证
adb version
```

### macOS/Linux环境变量

```bash
# 编辑 ~/.zshrc 或 ~/.bash_profile
export ANDROID_HOME=$HOME/Library/Android/sdk
export PATH=$PATH:$ANDROID_HOME/platform-tools
export PATH=$PATH:$ANDROID_HOME/tools
export PATH=$PATH:$ANDROID_HOME/tools/bin

# 使配置生效
source ~/.zshrc  # 或 source ~/.bash_profile

# 验证
adb version
```

---

## 常见问题

### 问题1：SDK下载失败

```java
// 解决方案：
// 1. 检查网络连接
// 2. 使用代理或 VPN
// 3. 手动下载 SDK 组件
// 4. 配置 SDK Manager 代理
```

### 问题2：模拟器启动慢

```java
// 解决方案：
// 1. 启用硬件加速（HAXM）
// 2. 增加 RAM 分配
// 3. 使用 x86 系统镜像
// 4. 关闭不必要的后台程序
```

### 问题3：Gradle同步失败

```java
// 解决方案：
// 1. 检查网络连接
// 2. 配置 Gradle 代理
// 3. 清理项目：Build → Clean Project
// 4. 重新同步：File → Sync Project with Gradle Files
```

### 问题4：ADB未识别设备

```java
// 解决方案：
// 1. 检查 USB 驱动（Windows）
// 2. 重启 ADB：adb kill-server && adb start-server
// 3. 检查 USB 调试是否启用
// 4. 尝试不同的 USB 端口
```

---

## 总结

开发环境搭建是 Android 开发的第一步。确保正确安装和配置所有必需组件，可以大大提高开发效率。

---

*最后更新：2024年*
