1. 从零开始的Android开发环境搭建2014年8月我接手了公司第一个Android项目。当时Android Studio刚发布1.0版本不久整个开发环境搭建过程充满了各种惊喜。十年后的今天回头看虽然工具链已经成熟很多但新手在搭建环境时依然会遇到不少坑。这篇记录既是对当年踩坑的复盘也结合最新工具链给出2024年的实践建议。Android开发环境的核心组件包括JDKJava开发工具包Android Studio官方IDEAndroid SDK软件开发工具包可选硬件设备或模拟器2. 基础环境准备2.1 JDK安装与配置虽然现在Android开发已经支持Kotlin但Java环境仍然是基础。建议安装OpenJDK 11LTS版本这是目前Android开发的稳定选择。# 在终端验证Java版本 java -version如果显示版本不是11需要配置JAVA_HOME环境变量。在Windows上右键此电脑 → 属性 → 高级系统设置环境变量 → 新建系统变量变量名JAVA_HOME变量值JDK安装路径如C:\Program Files\Java\jdk-11.0.2注意不要安装Java 17或更高版本某些Android工具链可能不兼容2.2 Android Studio安装细节从官网下载最新稳定版当前是2023.3.1。安装时有几个关键选项安装类型选择Standard即可确保勾选Android Virtual Device用于创建模拟器安装路径不要包含中文或空格首次启动时会提示导入设置新用户选择Do not import settings安装完成后首次运行会进入配置向导选择Standard主题Darcula暗色主题更护眼SDK组件安装界面确保勾选Android SDKAndroid SDK PlatformPerformance (Intel® HAXM)Android Virtual Device3. SDK与工具链配置3.1 Android SDK管理在Android Studio中打开SDK Manager工具栏小安卓图标需要安装SDK Platforms至少安装一个API级别的平台推荐API 34/Android 14勾选Show Package Details安装Sources for Android 34SDK ToolsAndroid SDK Build-ToolsAndroid EmulatorAndroid SDK Platform-ToolsIntel x86 Emulator Accelerator (HAXM installer)实测建议在C盘空间充足的情况下不要修改默认SDK路径。我曾经因为修改路径导致Gradle构建各种诡异问题。3.2 环境变量配置需要将平台工具加入PATH找到SDK安装路径下的platform-tools目录默认路径C:\Users[用户名]\AppData\Local\Android\Sdk\platform-tools将路径添加到系统环境变量PATH中验证adb是否可用adb devices应该显示已连接设备列表初次使用可能是空的4. 模拟器配置优化4.1 创建高性能AVD在AVD Manager中选择设备定义推荐Pixel 5系统镜像选择带有Google Play标记的版本在Advanced Settings中内存至少4GB存储内部存储16GBSD卡不需要启用Use Host GPU4.2 模拟器加速技巧在BIOS中开启VT-x/AMD-V虚拟化支持安装Intel HAXMMac不需要路径SDK目录/extras/intel/Hardware_Accelerated_Execution_Manager运行intelhaxm-android.exe对于AMD CPU用户需要使用Windows Hypervisor Platform踩坑记录曾经遇到模拟器启动黑屏问题原因是NVIDIA显卡驱动不兼容。解决方案是在模拟器的Graphics设置中改为Software模式。5. Gradle配置调优5.1 镜像源配置在国内环境需要修改build.gradle文件buildscript { repositories { maven { url https://maven.aliyun.com/repository/google } maven { url https://maven.aliyun.com/repository/public } } }5.2 常见Gradle问题解决构建卡在Download gradle-x.x.x.zip手动下载对应版本Gradle放入C:\Users[用户名].gradle\wrapper\dists\gradle-x.x.x-bin[随机目录]报错Could not find com.android.tools.build:gradle:x.x.x检查build.gradle中的classpath版本是否与Gradle版本匹配参考官方兼容性表格https://developer.android.com/studio/releases/gradle-plugin6. 物理设备调试配置6.1 开启开发者选项在Android设备上设置 → 关于手机 → 版本号连点7次返回设置 → 系统 → 开发者选项启用USB调试启用安装未知应用如果需要调试非商店应用6.2 USB驱动问题某些厂商设备需要单独安装驱动华为HiSuite小米Mi PC Suite三星Samsung USB Driver连接设备后在终端运行adb devices如果显示unauthorized需要在设备上弹出的对话框中授权。7. 插件与工具推荐7.1 必备Android Studio插件ADB Idea快速执行ADB命令JSON To Kotlin Class快速生成数据类Rainbow Brackets彩色括号匹配Code Glance右侧代码缩略图安装方法File → Settings → Plugins → Marketplace7.2 辅助工具scrcpy通过USB/WiFi投屏控制设备Wireshark网络请求分析StethoFacebook开发的调试工具LeakCanary内存泄漏检测8. 项目结构最佳实践8.1 现代Android项目结构推荐使用Google官方推荐的架构app/ ├── libs/ ├── src/ │ ├── androidTest/ # 仪器测试 │ ├── main/ # 主代码 │ └── test/ # 单元测试 build.gradle # 模块级配置8.2 多模块配置对于大型项目建议按功能拆分模块project/ ├── app/ # 主应用模块 ├── feature-auth/ # 认证功能 ├── library-core/ # 核心库 └── build.gradle # 项目级配置在settings.gradle中添加include :app, :feature-auth, :library-core9. 构建优化技巧9.1 加速构建在gradle.properties中添加org.gradle.daemontrue org.gradle.paralleltrue org.gradle.cachingtrue android.enableBuildCachetrue9.2 产品风味配置针对不同环境配置不同构建变体android { flavorDimensions env productFlavors { dev { dimension env applicationIdSuffix .dev } prod { dimension env } } }10. 持续集成配置10.1 GitHub Actions示例创建.github/workflows/android.ymlname: Android CI on: [push] jobs: build: runs-on: ubuntu-latest steps: - uses: actions/checkoutv2 - name: Set up JDK uses: actions/setup-javav1 with: java-version: 11 - name: Build with Gradle run: ./gradlew build10.2 本地缓存配置在build.gradle中添加缓存依赖android { buildTypes { release { minifyEnabled true shrinkResources true proguardFiles getDefaultProguardFile(proguard-android-optimize.txt) } } }十年Android开发环境搭建经验告诉我最稳定的环境往往是稍微落后的版本。不要盲目追求最新版工具链特别是企业项目中。建议选择比最新稳定版低1-2个版本的组件组合这样可以避开许多新版本的兼容性问题。
