另明确所有命令在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 构建会失败。