- demo/app/android-kotlin:Kotlin Android 应用编译示例,debug apk 产出后拷回宿主机 - demo/app/android-java:纯 Java Android 应用编译示例 - README:镜像表新增 compile-android-gradle8x,示例表与选型说明补充 android 条目
4.3 KiB
android-kotlin 示例
演示如何用 compile-android-gradle8x 编译一个 Kotlin Android 应用,并把 debug apk 取回宿主机。
Android 没有运行阶段:产物是 apk,由真机或模拟器安装运行,所以本示例不是 compile → runtime 两阶段,
而是「编译镜像 + 把产物拷出来」两个动作。
| 阶段 | 镜像 | 说明 |
|---|---|---|
| 编译 | registry.cn-shanghai.aliyuncs.com/odboy/kenaito:compile-android-gradle8x |
JDK 21 + Android SDK 35/36 + build-tools 35.0.0 + NDK 27 + Gradle 8.14.3 |
| 运行 | — | apk 由真机 / 模拟器安装,容器里不驻留进程 |
示例内容
android-kotlin/
├── settings.gradle.kts # 阿里云仓库地址,不提交 gradle wrapper
├── build.gradle.kts # AGP 8.13.2 + Kotlin 2.2.21
├── gradle.properties # android.useAndroidX=true 等
├── app/
│ ├── build.gradle.kts # compileSdk 35、minSdk 24、targetSdk 35
│ ├── proguard-rules.pro
│ └── src/main/
│ ├── AndroidManifest.xml
│ ├── java/cn/odboy/demo/kotlin/MainActivity.kt
│ └── res/ # layout / strings / styles
├── Dockerfile # 基于 compile-android-gradle8x 执行 assembleDebug
├── build.sh # 构建镜像并把 apk 拷到 dist/
└── .gitignore / .dockerignore
构建并取出 apk
sh build.sh
# 产物:dist/app-debug.apk
build.sh 做的是两件事:
# 1. 构建(docker build 不支持 -v 挂载宿主目录,依赖复用靠层缓存)
docker build --progress=plain \
-t registry.cn-shanghai.aliyuncs.com/odboy/kenaito:demo-android-kotlin .
# 2. 取出产物(Android 没有“运行”这一步,只能从镜像里拷)
docker create --name android-kotlin-out registry.cn-shanghai.aliyuncs.com/odboy/kenaito:demo-android-kotlin
docker cp android-kotlin-out:/workspace/app/build/outputs/apk/debug/app-debug.apk dist/app-debug.apk
docker rm -f android-kotlin-out
日常开发:直接挂载源码构建
改代码后不用重新 docker build,挂载当前目录跑 Gradle 即可,产物出现在宿主机的 app/build/ 下:
docker run --rm \
-v "$PWD":/workspace \
-v ~/.gradle:/home/admin/.gradle \
-w /workspace \
registry.cn-shanghai.aliyuncs.com/odboy/kenaito:compile-android-gradle8x \
gradle :app:assembleDebug --no-daemon --console=plain
ls -lh app/build/outputs/apk/debug/app-debug.apk
清工程:
docker run --rm -v "$PWD":/workspace -w /workspace \
registry.cn-shanghai.aliyuncs.com/odboy/kenaito:compile-android-gradle8x \
gradle clean --no-daemon
校验与安装 apk
debug 包用 SDK 自带的调试签名,可直接安装。
# 校验签名与基本信息
docker run --rm -v "$PWD/dist":/dist \
registry.cn-shanghai.aliyuncs.com/odboy/kenaito:compile-android-gradle8x \
sh -c 'apksigner verify -v /dist/app-debug.apk && aapt dump badging /dist/app-debug.apk'
# 连上真机(USB 调试)后安装
adb install -r dist/app-debug.apk
adb shell am start -n cn.odboy.demo.kotlin/.MainActivity
模拟器安装:把 dist/app-debug.apk 拖进模拟器窗口,或 adb install -r。
关键点
不用 gradle wrapper:镜像已内置 Gradle 8.14.3,gradle :app:assembleDebug 直接可用;
wrapper 会再联网下载一份 gradle 发行包(约 130MB),在离线 / 内网环境里还会卡住。
国内源:settings.gradle.kts 里直接用阿里云仓库地址(maven.aliyun.com/repository/google、/public、
/gradle-plugin),AGP、Kotlin 插件、AndroidX 依赖都从阿里云拉取;镜像里另有 ~/.gradle/init.d/init.gradle
把项目里残留的 dl.google.com / Maven Central / Gradle Plugin Portal 地址再改写一遍,保证不会直连国外源。
SDK 路径:来自镜像环境变量 ANDROID_SDK_ROOT=/usr/local/android-sdk,不需要 local.properties;
在本机 Android Studio 里打开时再补 sdk.dir。
release 包:gradle :app:assembleRelease 产出的是未签名 apk,需要自己的 keystore 签名后才能安装。
JDK:AGP 8.13 要求 JDK 17+,镜像用 JDK 21,compileOptions 里指定 Java 17 字节码。