第 2 章 · 环境搭建 & Wrapper & 第一个项目

4 个交互式演示帮你直观理解 Gradle Wrapper 工作流、项目目录、常用命令、Git 提交边界。

🔄 Wrapper 工作流:第一次跑 vs 第二次跑

点击下面的按钮模拟两种场景,观察 wrapper 自动下载 Gradle 的过程。

📍 步骤进度

🚀
启动 gradlew
读 properties
🔍
检查本地缓存
~/.gradle/wrapper/dists/
⬇️
下载 Gradle
~100MB(首次)
📦
解压安装
→ dists/gradle-8.5/
⚙️
启动 Gradle
JVM 进程
▶️
执行任务
build / test / ...

📋 终端输出

点击上方按钮开始模拟...

📊 性能对比

第一次(冷)
--
第二次(热)
--
提速
--

💡 关键观察:第一次 ~50s(含 Gradle 下载),第二次 ~5s(直接命中缓存)。这就是 wrapper 的零成本一致性方案。

📁 Gradle 项目目录结构

点击文件树中任意节点,查看它的作用、是否要提交 Git、典型内容。

👈 点击左侧任意文件 / 文件夹查看详细说明

💻 常用命令模拟器

点击下面的按钮模拟运行常用 Gradle 命令,看看每个命令到底输出什么。

$ my-project

💡 把这些命令记熟,95% 的日常 Gradle 操作不外乎这几个。

🔒 Git 提交边界检查器

哪些 Gradle 文件该提交到 Git?哪些必须忽略?看下面这张对照表,然后点击右下角的"生成 .gitignore"复制到自己项目。

✅ 必须提交(团队共享)

  • settings.gradle.kts 项目入口
  • build.gradle.kts 主构建脚本
  • gradle.properties 全局属性
  • gradle/libs.versions.toml Version Catalog
  • gradle/wrapper/gradle-wrapper.properties 版本锁
  • gradle/wrapper/gradle-wrapper.jar 启动器(必须!)
  • gradlew Unix 启动脚本
  • gradlew.bat Windows 启动脚本
  • src/ 源代码
  • buildSrc/ 或 build-logic/ Convention 插件

❌ 必须忽略(本地生成)

  • .gradle/ Gradle 工作区缓存
  • build/ 所有构建产物
  • **/build/ 子模块的 build 也要
  • .idea/ IDEA 配置
  • *.iml / *.ipr / *.iws IDEA 项目文件
  • out/ IDEA 编译输出
  • .vscode/ VSCode 配置
  • local.properties Android 本地路径
  • .DS_Store / Thumbs.db 系统文件
  • ~/.gradle/ 用户级缓存(不在仓库内)