Android Project Compose

Appearance

环境要求 ​

本页记录运行 Android Project Compose 所需的软硬件环境以及推荐工具，帮助你在不同机器上快速完成搭建。

IDE 与 JDK ​

  • Android Studio：始终使用最新稳定版（下载地址：https://developer.android.com/studio ），以获得最新的 Compose/AGP 支持。
  • JDK：项目以 JDK 17 为基线，Android Studio 自带的内置 JDK 已满足需求；若需独立安装，请确保 JAVA_HOME 指向 17。
  • Kotlin 插件：随 Android Studio 自动更新即可（当前使用 Kotlin 2.2.21）。

验证方式：

bash
./gradlew --version

命令输出中的 JVM 应显示 17，Kotlin 版本需 ≥ 2.2.21。

Android SDK 与模拟器 ​

在 Android Studio 的 SDK Manager 中安装以下组件：

  • Android SDK Platform 36（对应 compileSdk/targetSdk 36）。
  • Android SDK Build-Tools 36.0.0。
  • Android Emulator 与 Android SDK Platform-Tools。

运行或调试时可选择：

  • 物理设备：Android 8.0（API 26）及以上，已开启开发者模式与 USB 调试。
  • 模拟器：建议选择 Pixel 6 / API 30+ 系统镜像，并开启硬件加速。

构建工具与依赖栈 ​

  • AGP：8.13.1（参见 gradle/libs.versions.toml 中 agp 条目）。
  • Gradle Wrapper：随仓库提供，默认使用 ./gradlew 即可。
  • Kotlin 编译器：2.2.21，JVM target = 17。
  • Compose BOM：2025.11.01（确保 IDE 可以同步最新 Compose 组件）。

如需自定义镜像，可在 ~/.gradle/gradle.properties 中配置 mavenCentral、google() 代理或国内镜像地址，避免依赖下载失败。

网络与代理建议 ​

  • 保持能访问 maven.google.com、repo.maven.apache.org、dl.google.com 等仓库。必要时在 ~/.gradle/gradle.properties 中配置 systemProp.http.proxyHost / https.proxyHost。
  • 如果使用公司内网或定制仓库，确保镜像同步了 Compose、Hilt、Retrofit 等依赖版本；否则建议临时直连外网完成首次同步。

满足以上环境后，即可按照「快速开始」章节克隆仓库并运行 App。若在搭建过程中遇到兼容性或依赖问题，优先检查 IDE/JDK/AGP 版本是否满足上述要求。