另明确所有命令在WSL Ubuntu终端中执行。格式清晰,带步骤编号。

太好了!既然环境已经跑通,后续任何新项目只需按以下 标准流程 操作即可,所有命令均在 WSL Ubuntu 终端 中执行。


📋 新项目构建标准流程(模板)

1️⃣ 将项目源码放入 WSL 内

cp -r /mnt/g/你的项目路径 ~/projects/新项目名

示例: cp -r /mnt/g/AndroidCode/NewProject ~/projects/NewProject

2️⃣ 进入项目根目录

cd ~/projects/新项目名

3️⃣ 给 gradlew 添加执行权限

chmod +x gradlew

4️⃣ 初始化 Git 并创建初始提交(关键)

git init
git add .
git commit -m "Initial commit"

如果没有配置过 Git 用户信息 ,先执行一次:

git config --global user.email "你的邮箱"

git config --global user.name "你的名字"

5️⃣ 执行 Debug 构建

docker run --rm -it \
  -v ${PWD}:/workspace \
  -v gradle-cache:/root/.gradle \
  android-builder:v1 \
  bash -c "git config --global --add safe.directory /workspace && ./gradlew --no-daemon :app:assembleDebug"

6️⃣ 执行 Release 构建(需要 CI 环境变量)

docker run --rm -it \
  -v ${PWD}:/workspace \
  -v gradle-cache:/root/.gradle \
  -e CI=true \
  android-builder:v1 \
  bash -c "git config --global --add safe.directory /workspace && ./gradlew --no-daemon :app:assembleRelease"

7️⃣ 获取 APK

构建完成后,APK 位于:

app/build/outputs/apk/debug/app-debug.apk
app/build/outputs/apk/release/app-release.apk

在 WSL 中可用 ls 查看,也可通过 Windows 资源管理器访问 \\wsl$\Ubuntu\home\你的用户名\projects\新项目名\... 复制出来。


🧩 一键构建脚本(可选)

将以下脚本保存为 build.sh ,放在项目根目录,执行 ./build.sh Debug 或 ./build.sh Release :

#!/bin/bash
TYPE=${1:-Debug}
docker run --rm -it \
  -v ${PWD}:/workspace \
  -v gradle-cache:/root/.gradle \
  ${CI:+ -e CI=true} \
  android-builder:v1 \
  bash -c "git config --global --add safe.directory /workspace && ./gradlew --no-daemon :app:assemble${TYPE}"

给脚本执行权限: chmod +x build.sh 。


📌 注意事项

  • 镜像复用 : android-builder:v1 镜像已包含所有环境,无需重新构建。
  • Git 提交是必须的 :因为 Gradle 脚本用 git rev-parse 获取版本号。
  • 项目模块名 :如果模块名不是 app ,请将命令中的 :app 改为实际模块名(如 :phone )。
  • Release 签名 :确保项目配置了 signingConfigs ,否则 Release 构建会失败。