Files
odboy 5dc02feeed feat: 新增 android 应用示例(kotlin / java),README 补充 compile-android-gradle8x
- demo/app/android-kotlin:Kotlin Android 应用编译示例,debug apk 产出后拷回宿主机
- demo/app/android-java:纯 Java Android 应用编译示例
- README:镜像表新增 compile-android-gradle8x,示例表与选型说明补充 android 条目
2026-11-15 13:08:00 +08:00

4.5 KiB
Raw Permalink Blame History

android-java 示例

演示如何用 compile-android-gradle8x 编译一个纯 Java Android 应用,并把 debug apk 取回宿主机。 与 android-kotlin 示例内容相同,区别是:不引入 Kotlin 插件与 Kotlin 标准库, 构建更快,适合只需要 Java 的项目。

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-java/
├── settings.gradle.kts            # 阿里云仓库地址,不提交 gradle wrapper
├── build.gradle.kts               # 只有 AGP 8.13.2
├── 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/java/MainActivity.java
│       └── 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-java .

# 2. 取出产物(Android 没有“运行”这一步,只能从镜像里拷)
docker create --name android-java-out registry.cn-shanghai.aliyuncs.com/odboy/kenaito:demo-android-java
docker cp android-java-out:/workspace/app/build/outputs/apk/debug/app-debug.apk dist/app-debug.apk
docker rm -f android-java-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.java/.MainActivity

模拟器安装:把 dist/app-debug.apk 拖进模拟器窗口,或 adb install -r。

关键点

纯 Java:build.gradle.kts 里只有 com.android.application,没有 Kotlin 插件,镜像里也不需要额外装 Kotlin 编译器。

不用 gradle wrapper:镜像已内置 Gradle 8.14.3,gradle :app:assembleDebug 直接可用; wrapper 会再联网下载一份 gradle 发行包(约 130MB),在离线 / 内网环境里还会卡住。

国内源:settings.gradle.kts 里直接用阿里云仓库地址(maven.aliyun.com/repository/google、/public、 /gradle-plugin),AGP 与 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 字节码。