Android 开发环境搭建全攻略：Flutter、Android SDK、Java 与 Gradle 配置详解

目录

Android 开发环境搭建全攻略：Flutter、Android SDK、Java 与 Gradle 配置详解

一、为什么配置开发环境如此重要？

二、组件介绍与版本兼容性

1. Android Studio

2. Flutter

3. Android SDK

4. Java Development Kit (JDK)

5. Gradle

三、环境配置详细步骤

1. 安装 Android Studio

2. 配置 Android SDK

3. 安装 Java

4. 配置环境变量

5. 安装 Flutter

6. 配置 Flutter 与 Android Studio 集成

7. 配置 Gradle

四、常见版本兼容性问题及解决方案

1. Flutter 与 Android SDK 版本冲突

2. Java 版本不兼容

3. AGP 与 Gradle 版本不匹配

4. NDK 许可证未接受

五、验证配置

1. 验证 Android SDK 配置

2. 验证 Java 配置

3. 验证 Flutter 配置

六、总结

在移动应用开发领域，Android 平台占据着重要地位。然而，搭建一个完整且兼容的 Android 开发环境却常常让开发者感到困惑。本文将详细介绍如何配置 Android Studio、Flutter、Android SDK、Java 和 Gradle，并深入探讨版本兼容性问题，帮助你避免常见的配置陷阱。

一、为什么配置开发环境如此重要？

Android 开发环境是一个由多个工具和组件组成的生态系统，各个部分之间存在紧密的依赖关系。如果版本不兼容，可能会导致以下问题：

• 构建失败：Gradle 无法正确解析依赖项，或与 Android SDK 版本冲突
• 运行时错误：应用在模拟器或真机上崩溃
• 功能缺失：某些 API 无法正常工作
• 开发效率低下：频繁调试环境问题浪费时间

因此，了解各组件之间的版本兼容性，并正确配置它们，是成功开发 Android 应用的关键。

二、组件介绍与版本兼容性

1. Android Studio

Android Studio 是官方推荐的 Android 开发 IDE，集成了 SDK、模拟器和调试工具。建议使用最新稳定版本（截至 2023 年为 Giraffe），它会自动安装兼容的 SDK 和工具。

2. Flutter

Flutter 是 Google 推出的跨平台开发框架，可同时构建 iOS 和 Android 应用。Flutter 依赖于 Android SDK 和 Java 环境。

• 兼容性：Flutter 3.x 及以上版本需要 Android SDK Build Tools 33+、Java 11+

3. Android SDK

Android SDK 包含了开发 Android 应用所需的各种工具和平台版本：

• Platform Tools：包含 adb、fastboot 等核心工具
• Build Tools：编译和打包应用的工具
• SDK Platforms：不同 Android 版本的开发平台
• NDK：原生开发工具包
• ***mand-line Tools：命令行开发工具

4. Java Development Kit (JDK)

Android 开发需要 Java 环境：

• Java 8 (LTS)：适用于较旧的 Android 项目
• Java 11 (LTS)：推荐用于最新的 Android 开发
• Java 17+：实验性支持，部分工具可能不兼容

5. Gradle

Gradle 是 Android 项目的构建工具，需要与 Android Gradle Plugin (AGP) 版本兼容：

三、环境配置详细步骤

1. 安装 Android Studio

1. 从官方网站下载并安装 Android Studio
2. 启动安装向导，选择 "Standard" 安装类型
3. 安装完成后，启动 Android Studio 并完成初始设置

2. 配置 Android SDK

1. 打开 Android Studio，进入 "Settings" > "Appearance & Behavior" > "System Settings" > "Android SDK"
2. 选择 "SDK Platforms" 选项卡，安装所需的 Android 版本（建议至少安装 Android 11 (API 30) 和最新版本）
3. 选择 "SDK Tools" 选项卡，安装以下组件：
   • Android SDK Build-Tools (最新稳定版本)
   • Android SDK ***mand-line Tools (最新)
   • Android Emulator
   • Android SDK Platform-Tools
   • NDK (Side by side) (根据项目需求选择)

3. 安装 Java

1. 使用 Android Studio 内置 JDK：

   • Android Studio 4.1 及以上版本自带 OpenJDK 11
   • 路径通常为：C:\Program Files\Android\Android Studio\jre

2. 手动安装 OpenJDK 11：

   • 从Adoptium下载 OpenJDK 11 LTS
   • 安装后，设置JAVA_HOME环境变量指向安装目录

3. 验证 Java 安装：

   java -version
   javac -version
   

4. 配置环境变量

1. ANDROID_HOME：指向 Android SDK 根目录

   C:\Users\你的用户名\AppData\Local\Android\Sdk
   

2. JAVA_HOME：指向 Java 安装目录

   C:\Program Files\Android\Android Studio\jre  # 或手动安装的路径
   

3. Path 变量：添加以下路径

   %ANDROID_HOME%\platform-tools
   %ANDROID_HOME%\build-tools\34.0.0  # 替换为实际安装的版本
   %ANDROID_HOME%\cmdline-tools\latest\bin
   %JAVA_HOME%\bin
   

5. 安装 Flutter

1. 从Flutter 官网下载 Flutter SDK

2. 解压到指定目录，例如：C:\src\flutter

3. 添加flutter到 Path 环境变量：

   C:\src\flutter\bin
   

4. 运行 Flutter doctor：

   flutter doctor
   

    

   根据提示解决任何问题（如接受 Android SDK 许可证）

6. 配置 Flutter 与 Android Studio 集成

1. 打开 Android Studio，进入 "File" > "Settings" > "Languages & Frameworks" > "Flutter"
2. 设置 Flutter SDK 路径，点击 "Apply"
3. Android Studio 将自动安装 Dart 插件

7. 配置 Gradle

1. 在项目的android/build.gradle.kts文件中，确保使用兼容的 AGP 版本：

   plugins {
       id("***.android.application") version "8.0.2" apply false
       id("***.android.library") version "8.0.2" apply false
   }
   

2. 在android/gradle/wrapper/gradle-wrapper.properties中，确保使用兼容的 Gradle 版本：

   distributionUrl=https\://services.gradle.org/distributions/gradle-7.6.1-bin.zip
   

四、常见版本兼容性问题及解决方案

1. Flutter 与 Android SDK 版本冲突

• 问题：Flutter 构建失败，提示找不到特定的 Build Tools 版本
• 解决方案：
  • 在android/build.gradle.kts中指定兼容的 Build Tools 版本：

    android {
        buildToolsVersion = "34.0.0"
    }
    

2. Java 版本不兼容

• 问题：Gradle 构建失败，提示 "Java version is not ***patible"
• 解决方案：
  • 确保JAVA_HOME指向兼容的 Java 版本
  • 在android/gradle.properties中指定 Java 版本：

    org.gradle.java.home=C:/Program Files/Android/Android Studio/jre
    

3. AGP 与 Gradle 版本不匹配

• 问题：Gradle 同步失败，提示 "Plugin requires Gradle X.X or later"
• 解决方案：
  • 更新android/gradle/wrapper/gradle-wrapper.properties中的 Gradle 版本
  • 使用兼容的 AGP 版本

4. NDK 许可证未接受

• 问题：构建失败，提示 "LicenceNotA***eptedException"
• 解决方案：

  sdkmanager --licenses
  

五、验证配置

1. 验证 Android SDK 配置

sdkmanager --list
adb version

2. 验证 Java 配置

java -version
javac -version

3. 验证 Flutter 配置

flutter doctor
flutter run

六、总结

搭建 Android 开发环境需要仔细考虑各组件之间的版本兼容性。建议遵循以下最佳实践：

1. 使用最新稳定版本的 Android Studio 和 Flutter
2. 优先选择 Java 11 LTS 版本
3. 保持 Android SDK 组件更新到最新稳定版本
4. 查阅官方文档确认 AGP 与 Gradle 的兼容关系
5. 使用flutter doctor和gradlew --version定期检查环境配置

通过正确配置和维护开发环境，你将能够更高效地开发 Android 应用，避免因环境问题导致的开发障碍。