6.7 KiB
6.7 KiB
开发环境搭建
目录
JDK安装配置
JDK版本选择
// 推荐版本：
// - JDK 11（LTS，长期支持）
// - JDK 17（LTS，最新长期支持）
// - JDK 8（兼容性好，但较旧）
// Android Studio 内置 JDK，也可以使用系统 JDK
Windows安装JDK
# 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
# 方式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
# 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
// 1. 访问官网
// https://developer.android.com/studio
// 2. 下载安装包
// - Windows: .exe 安装程序
// - macOS: .dmg 磁盘映像
// - Linux: .tar.gz 压缩包
Windows安装
# 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安装
# 1. 打开 .dmg 文件
# 2. 拖拽 Android Studio 到 Applications
# 3. 首次启动，完成设置向导
Linux安装
# 1. 解压文件
tar -xzf android-studio-*.tar.gz
# 2. 移动到合适位置
sudo mv android-studio /opt/
# 3. 创建启动脚本
# /opt/android-studio/bin/studio.sh
首次启动配置
// 1. 欢迎界面
// - 选择 Standard 安装类型（推荐）
// 2. SDK 组件安装
// - Android SDK
// - Android SDK Platform
// - Android Virtual Device
// 3. 许可协议
// - 接受所有许可协议
// 4. 完成设置
SDK配置
SDK Manager
// 打开 SDK Manager
// File → Settings → Appearance & Behavior → System Settings → Android SDK
// 或
// Tools → SDK Manager
必需组件
// 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路径配置
// Windows 默认路径：
// C:\Users\<用户名>\AppData\Local\Android\Sdk
// macOS 默认路径：
// ~/Library/Android/sdk
// Linux 默认路径：
// ~/Android/Sdk
模拟器配置
创建虚拟设备
// 1. 打开 AVD Manager
// Tools → Device Manager
// 2. 创建虚拟设备
// Create Device
// 3. 选择设备定义
// - Pixel 5（推荐）
// - Pixel 6
// - 其他设备
// 4. 选择系统镜像
// - 推荐：最新稳定版（API 33+）
// - 下载系统镜像（如需要）
// 5. 配置虚拟设备
// - AVD Name：设备名称
// - Graphics：硬件加速（推荐）
// - Show Advanced Settings：高级设置
模拟器设置
// 性能设置：
// - Graphics: Hardware - GLES 2.0（推荐）
// - RAM: 2048 MB（推荐）
// - VM heap: 512 MB
// 存储设置：
// - Internal Storage: 2048 MB
// - SD Card: 可选
// 网络设置：
// - 默认使用主机网络
启动模拟器
// 1. 从 AVD Manager 启动
// 2. 或从 Android Studio 运行应用时自动启动
// 3. 或使用命令行：
emulator -avd <AVD_NAME>
真机调试配置
启用开发者选项
// 1. 打开设置
// 2. 关于手机
// 3. 连续点击"版本号"7次
// 4. 返回设置，找到"开发者选项"
启用USB调试
// 1. 打开开发者选项
// 2. 启用"USB调试"
// 3. 连接手机到电脑
// 4. 手机上确认 USB 调试授权
验证连接
# 使用 ADB 验证
adb devices
# 应该显示设备列表
# List of devices attached
# <设备ID> device
常见问题
// 1. 设备未识别
// - 检查 USB 驱动（Windows）
// - 检查 USB 连接模式（文件传输模式）
// - 重新插拔 USB
// 2. 授权问题
// - 手机上撤销 USB 调试授权
// - 重新连接并授权
// 3. 驱动问题（Windows）
// - 安装手机厂商 USB 驱动
// - 或使用通用 Android USB 驱动
环境变量设置
Windows环境变量
# 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环境变量
# 编辑 ~/.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下载失败
// 解决方案：
// 1. 检查网络连接
// 2. 使用代理或 VPN
// 3. 手动下载 SDK 组件
// 4. 配置 SDK Manager 代理
问题2：模拟器启动慢
// 解决方案：
// 1. 启用硬件加速（HAXM）
// 2. 增加 RAM 分配
// 3. 使用 x86 系统镜像
// 4. 关闭不必要的后台程序
问题3：Gradle同步失败
// 解决方案：
// 1. 检查网络连接
// 2. 配置 Gradle 代理
// 3. 清理项目：Build → Clean Project
// 4. 重新同步：File → Sync Project with Gradle Files
问题4：ADB未识别设备
// 解决方案：
// 1. 检查 USB 驱动（Windows）
// 2. 重启 ADB：adb kill-server && adb start-server
// 3. 检查 USB 调试是否启用
// 4. 尝试不同的 USB 端口
总结
开发环境搭建是 Android 开发的第一步。确保正确安装和配置所有必需组件，可以大大提高开发效率。
最后更新：2024年