diff --git a/README.md b/README.md
index 1c5c8b2..acf5a4b 100644
--- a/README.md
+++ b/README.md
@@ -61,6 +61,7 @@ demo/plateform/ 平台类示例(tengine3 反向代理)
| `image/compile-node16` | `kenaito:compile-node16` | `runtime-node16` / 编译工具链 | 同上,Node 16 版本线 |
| `image/runtime-rust` | `kenaito:runtime-rust` | 上者 / Rust 1.100.0 | 运行环境,rustc/cargo(无文档、无 rust-src) |
| `image/compile-rust` | `kenaito:compile-rust` | `runtime-rust` / 编译工具链 | 编译环境,追加 gcc/make/pkg-config/openssl-devel,crates 源走阿里云 |
+| `image/compile-android-gradle8x` | `kenaito:compile-android-gradle8x` | `runtime-jdk21` / SDK 35+36、build-tools 35.0.0、NDK 27、Gradle 8.14.3 | Android 编译环境,仅出 apk/aar(无运行阶段),Gradle 仓库源走阿里云;示例见 `demo/app/android-kotlin`、`demo/app/android-java` |
### 部署编排
@@ -113,6 +114,8 @@ demo/plateform/ 平台类示例(tengine3 反向代理)
| [`demo/app/node-frontend-react-class`](demo/app/node-frontend-react-class/README.md) | `compile-node22` / `proxy-tengine3` | 8093 | React 19 类组件写法 |
| [`demo/app/node-frontend-vite5`](demo/app/node-frontend-vite5/README.md) | `compile-node22` / `proxy-tengine3` | 8092 | Vite 5 + Vue 3 前端,用于和 Vite 7 对照 |
| [`demo/app/rust`](demo/app/rust/README.md) | `compile-rust` / `runtime-rust` | 8088 | Rust 标准库 TcpListener Web 两阶段构建示例 |
+| [`demo/app/android-kotlin`](demo/app/android-kotlin/README.md) | `compile-android-gradle8x` | - | Kotlin Android 应用编译示例,产出 debug apk 并拷回宿主机(apk 由真机安装,无运行阶段) |
+| [`demo/app/android-java`](demo/app/android-java/README.md) | `compile-android-gradle8x` | - | 纯 Java Android 应用编译示例,产出 debug apk 并拷回宿主机 |
| [`demo/plateform/tengine3`](demo/plateform/tengine3/README.md) | `proxy-tengine3` | 80、443 | Tengine 3.1.0 反向代理示例,证书与站点配置挂载目录 |
@@ -135,3 +138,7 @@ demo/plateform/ 平台类示例(tengine3 反向代理)
- rust 适用于 rust 应用
- 编译:`compile-rust`(rustc/cargo + gcc/make,crates 源走阿里云)
- 运行:`runtime-rust`(rustc/cargo,直接运行编译出的二进制)
+- android 适用于 android 应用(kotlin / java)
+ - 编译:`compile-android-gradle8x`(JDK 21 + Android SDK 35/36 + build-tools 35.0.0 + NDK 27 + Gradle 8.14.3,Gradle 仓库源走阿里云)
+ - 运行:不适用。产物是 apk / aar,由真机或模拟器安装,容器里没有常驻进程
+ - 取产物:`docker create` + `docker cp`,或直接把源码目录挂载进编译镜像跑 `gradle`,示例见 `demo/app/android-kotlin`、`demo/app/android-java`
diff --git a/demo/app/android-java/.dockerignore b/demo/app/android-java/.dockerignore
new file mode 100644
index 0000000..8497212
--- /dev/null
+++ b/demo/app/android-java/.dockerignore
@@ -0,0 +1,4 @@
+build.sh
+dist/
+.git/
+.DS_Store
diff --git a/demo/app/android-java/.gitignore b/demo/app/android-java/.gitignore
new file mode 100644
index 0000000..ced569b
--- /dev/null
+++ b/demo/app/android-java/.gitignore
@@ -0,0 +1,8 @@
+# 构建产物 / 本地缓存
+build/
+.gradle/
+local.properties
+*.apk
+*.aab
+dist/
+.DS_Store
diff --git a/demo/app/android-java/Dockerfile b/demo/app/android-java/Dockerfile
new file mode 100644
index 0000000..fdaf120
--- /dev/null
+++ b/demo/app/android-java/Dockerfile
@@ -0,0 +1,16 @@
+# Android 没有运行阶段:产物是 apk,由真机 / 模拟器安装,
+# 所以这里不是前后两个 FROM,而是「编译镜像 + 取出产物」两步(见 build.sh)
+FROM registry.cn-shanghai.aliyuncs.com/odboy/kenaito:compile-android-gradle8x
+LABEL MAINTAINER="tianjun@odboy.cn"
+ENV TimeZone=Asia/Shanghai
+WORKDIR /workspace
+# 先拷构建脚本再拷源码:依赖声明(build.gradle.kts / gradle.properties)不变时,
+# 这一层可直接命中构建缓存,不必重跑依赖解析
+COPY settings.gradle.kts build.gradle.kts gradle.properties ./
+COPY app/build.gradle.kts app/proguard-rules.pro ./app/
+COPY app/src ./app/src
+# 直接使用镜像内置的 Gradle 8.14.3(不带 wrapper:wrapper 会再联网下载一份 gradle 发行包)
+# assembleDebug 产出 app/build/outputs/apk/debug/app-debug.apk
+# assembleRelease 产出 app-release-unsigned.apk(需自行签名后安装)
+RUN set -e && gradle :app:assembleDebug --no-daemon --console=plain; \
+ ls -lh app/build/outputs/apk/debug/
diff --git a/demo/app/android-java/README.md b/demo/app/android-java/README.md
new file mode 100644
index 0000000..43f884d
--- /dev/null
+++ b/demo/app/android-java/README.md
@@ -0,0 +1,110 @@
+# android-java 示例
+
+演示如何用 `compile-android-gradle8x` 编译一个纯 Java Android 应用,并把 `debug` apk 取回宿主机。
+与 [`android-kotlin`](../android-kotlin/README.md) 示例内容相同,区别是:不引入 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
+
+```shell
+sh build.sh
+# 产物:dist/app-debug.apk
+```
+
+`build.sh` 做的是两件事:
+
+```shell
+# 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/` 下:
+
+```shell
+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
+```
+
+清工程:
+
+```shell
+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 自带的调试签名,可直接安装。
+
+```shell
+# 校验签名与基本信息
+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 字节码。
diff --git a/demo/app/android-java/app/build.gradle.kts b/demo/app/android-java/app/build.gradle.kts
new file mode 100644
index 0000000..763a801
--- /dev/null
+++ b/demo/app/android-java/app/build.gradle.kts
@@ -0,0 +1,55 @@
+plugins {
+ id("com.android.application")
+}
+
+android {
+ namespace = "cn.odboy.demo.java"
+ compileSdk = 35
+
+ defaultConfig {
+ applicationId = "cn.odboy.demo.java"
+ minSdk = 24
+ targetSdk = 35
+ versionCode = 1
+ versionName = "1.0"
+ }
+
+ buildTypes {
+ // debug 用 SDK 内置的调试签名即可安装,示例不需要 release keystore
+ debug {
+ isMinifyEnabled = false
+ }
+ release {
+ isMinifyEnabled = false
+ proguardFiles(getDefaultProguardFile("proguard-android-optimize.txt"), "proguard-rules.pro")
+ }
+ }
+
+ // BuildConfig 需要在 AGP 8.x 里显式打开
+ buildFeatures {
+ buildConfig = true
+ }
+
+ // JDK 21 编译,字节码与 Android 兼容
+ compileOptions {
+ sourceCompatibility = JavaVersion.VERSION_17
+ targetCompatibility = JavaVersion.VERSION_17
+ }
+}
+
+dependencies {
+ implementation("androidx.appcompat:appcompat:1.7.0")
+}
+
+// appcompat 1.7.0 传递依赖 kotlin-stdlib-jdk7/jdk8:1.6.21,而 AGP 8.x 工具链带 kotlin-stdlib:1.8.22。
+// Kotlin 1.8 起 jdk7/jdk8 的类已合并进主 stdlib,两个版本同时出现会报 Duplicate class;
+// 用 force 把三个坐标强制统一到同一版本(纯 Java 工程没有 Kotlin 插件,1.8.22 即工具链版本)。
+configurations.configureEach {
+ resolutionStrategy {
+ force(
+ "org.jetbrains.kotlin:kotlin-stdlib:1.8.22",
+ "org.jetbrains.kotlin:kotlin-stdlib-jdk7:1.8.22",
+ "org.jetbrains.kotlin:kotlin-stdlib-jdk8:1.8.22",
+ )
+ }
+}
diff --git a/demo/app/android-java/app/proguard-rules.pro b/demo/app/android-java/app/proguard-rules.pro
new file mode 100644
index 0000000..276ad63
--- /dev/null
+++ b/demo/app/android-java/app/proguard-rules.pro
@@ -0,0 +1 @@
+# 示例不开启混淆(isMinifyEnabled = false),此文件留作项目扩展用
diff --git a/demo/app/android-java/app/src/main/AndroidManifest.xml b/demo/app/android-java/app/src/main/AndroidManifest.xml
new file mode 100644
index 0000000..2f851da
--- /dev/null
+++ b/demo/app/android-java/app/src/main/AndroidManifest.xml
@@ -0,0 +1,17 @@
+
+
+
+
+
+
+
+
+
+
+
diff --git a/demo/app/android-java/app/src/main/java/cn/odboy/demo/java/MainActivity.java b/demo/app/android-java/app/src/main/java/cn/odboy/demo/java/MainActivity.java
new file mode 100644
index 0000000..53eb715
--- /dev/null
+++ b/demo/app/android-java/app/src/main/java/cn/odboy/demo/java/MainActivity.java
@@ -0,0 +1,24 @@
+package cn.odboy.demo.java;
+
+import android.os.Bundle;
+import android.widget.TextView;
+
+import androidx.appcompat.app.AppCompatActivity;
+
+public class MainActivity extends AppCompatActivity {
+ @Override
+ protected void onCreate(Bundle savedInstanceState) {
+ super.onCreate(savedInstanceState);
+ setContentView(R.layout.activity_main);
+
+ // 启动即显示构建信息,便于在真机上确认装的是哪一次构建的包
+ StringBuilder info = new StringBuilder();
+ info.append(getString(R.string.hello)).append('\n');
+ info.append("versionName: ").append(BuildConfig.VERSION_NAME).append('\n');
+ info.append("applicationId: ").append(BuildConfig.APPLICATION_ID).append('\n');
+ info.append("BuildConfig.DEBUG: ").append(BuildConfig.DEBUG);
+
+ TextView message = findViewById(R.id.message);
+ message.setText(info.toString());
+ }
+}
diff --git a/demo/app/android-java/app/src/main/res/layout/activity_main.xml b/demo/app/android-java/app/src/main/res/layout/activity_main.xml
new file mode 100644
index 0000000..299dd5e
--- /dev/null
+++ b/demo/app/android-java/app/src/main/res/layout/activity_main.xml
@@ -0,0 +1,17 @@
+
+
+
+
+
diff --git a/demo/app/android-java/app/src/main/res/values/strings.xml b/demo/app/android-java/app/src/main/res/values/strings.xml
new file mode 100644
index 0000000..cf393e2
--- /dev/null
+++ b/demo/app/android-java/app/src/main/res/values/strings.xml
@@ -0,0 +1,5 @@
+
+
+ android-java demo
+ Hello from android-java demo!
+
diff --git a/demo/app/android-java/app/src/main/res/values/styles.xml b/demo/app/android-java/app/src/main/res/values/styles.xml
new file mode 100644
index 0000000..7fb0269
--- /dev/null
+++ b/demo/app/android-java/app/src/main/res/values/styles.xml
@@ -0,0 +1,5 @@
+
+
+
+
+
diff --git a/demo/app/android-java/build.gradle.kts b/demo/app/android-java/build.gradle.kts
new file mode 100644
index 0000000..faeb3aa
--- /dev/null
+++ b/demo/app/android-java/build.gradle.kts
@@ -0,0 +1,5 @@
+// 纯 Java 工程:只声明 AGP,不需要 Kotlin 插件
+// AGP 8.13.x 需要 Gradle 8.13+、JDK 17+(镜像为 JDK 21 + Gradle 8.14.3)
+plugins {
+ id("com.android.application") version "8.13.2" apply false
+}
diff --git a/demo/app/android-java/build.sh b/demo/app/android-java/build.sh
new file mode 100644
index 0000000..99de64f
--- /dev/null
+++ b/demo/app/android-java/build.sh
@@ -0,0 +1,19 @@
+#!/usr/bin/env bash
+# 构建 apk 并把产物拷到宿主机 dist/(Android 无运行阶段,只交付 apk)
+set -euo pipefail
+cd "$(dirname "$0")"
+
+IMAGE=registry.cn-shanghai.aliyuncs.com/odboy/kenaito:demo-android-java
+# docker cp 的路径相对容器根目录解析(不是相对 WORKDIR),所以这里必须写绝对路径
+APK=/workspace/app/build/outputs/apk/debug/app-debug.apk
+
+# docker build 不支持 -v 挂载宿主目录(那是 docker run 的选项);依赖包复用靠 BuildKit 的层缓存,
+# Dockerfile 里先 COPY gradle 构建脚本再 COPY 源码,依赖声明不变时这一层直接命中缓存
+docker build --progress=plain -t "${IMAGE}" .
+
+# 从镜像里把 apk 取出来:先 create 出容器(不启动),docker cp 后删除
+mkdir -p dist
+CID=$(docker create "${IMAGE}")
+docker cp "${CID}:${APK}" dist/app-debug.apk
+docker rm -f "${CID}" > /dev/null
+ls -lh dist/app-debug.apk
diff --git a/demo/app/android-java/gradle.properties b/demo/app/android-java/gradle.properties
new file mode 100644
index 0000000..3b3d8e8
--- /dev/null
+++ b/demo/app/android-java/gradle.properties
@@ -0,0 +1,6 @@
+// SDK 路径由镜像的 ANDROID_SDK_ROOT 环境变量提供;本地开发时也可写 local.properties
+org.gradle.jvmargs=-Xmx2g -Dfile.encoding=UTF-8
+org.gradle.parallel=true
+org.gradle.caching=true
+# AGP 8.x 默认使用 AndroidX
+android.useAndroidX=true
diff --git a/demo/app/android-java/settings.gradle.kts b/demo/app/android-java/settings.gradle.kts
new file mode 100644
index 0000000..2f00340
--- /dev/null
+++ b/demo/app/android-java/settings.gradle.kts
@@ -0,0 +1,20 @@
+pluginManagement {
+ repositories {
+ // 阿里云代理 Google / Maven Central / Gradle Plugin Portal(镜像内 init.d/init.gradle 也做同样的改写,
+ // 这里直接写阿里云地址,脱离镜像在本地构建时也走国内源)
+ maven("https://maven.aliyun.com/repository/google")
+ maven("https://maven.aliyun.com/repository/public")
+ maven("https://maven.aliyun.com/repository/gradle-plugin")
+ }
+}
+
+dependencyResolutionManagement {
+ repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
+ repositories {
+ maven("https://maven.aliyun.com/repository/google")
+ maven("https://maven.aliyun.com/repository/public")
+ }
+}
+
+rootProject.name = "android-java"
+include(":app")
diff --git a/demo/app/android-kotlin/.dockerignore b/demo/app/android-kotlin/.dockerignore
new file mode 100644
index 0000000..8497212
--- /dev/null
+++ b/demo/app/android-kotlin/.dockerignore
@@ -0,0 +1,4 @@
+build.sh
+dist/
+.git/
+.DS_Store
diff --git a/demo/app/android-kotlin/.gitignore b/demo/app/android-kotlin/.gitignore
new file mode 100644
index 0000000..ced569b
--- /dev/null
+++ b/demo/app/android-kotlin/.gitignore
@@ -0,0 +1,8 @@
+# 构建产物 / 本地缓存
+build/
+.gradle/
+local.properties
+*.apk
+*.aab
+dist/
+.DS_Store
diff --git a/demo/app/android-kotlin/Dockerfile b/demo/app/android-kotlin/Dockerfile
new file mode 100644
index 0000000..4fc6743
--- /dev/null
+++ b/demo/app/android-kotlin/Dockerfile
@@ -0,0 +1,15 @@
+# Android 没有运行阶段:产物是 apk,由真机 / 模拟器安装,
+# 所以这里不是前后两个 FROM,而是「编译镜像 + 取出产物」两步(见 build.sh)
+FROM registry.cn-shanghai.aliyuncs.com/odboy/kenaito:compile-android-gradle8x
+LABEL MAINTAINER="tianjun@odboy.cn"
+ENV TimeZone=Asia/Shanghai
+WORKDIR /workspace
+# 先拷构建脚本再拷源码:依赖声明不变时,这一层可直接命中构建缓存,不必重跑依赖解析
+COPY settings.gradle.kts build.gradle.kts gradle.properties ./
+COPY app/build.gradle.kts app/proguard-rules.pro ./app/
+COPY app/src ./app/src
+# 直接使用镜像内置的 Gradle 8.14.3(不带 wrapper:wrapper 会再联网下载一份 gradle 发行包)
+# assembleDebug 产出 app/build/outputs/apk/debug/app-debug.apk
+# assembleRelease 产出 app-release-unsigned.apk(需自行签名后安装)
+RUN set -e && gradle :app:assembleDebug --no-daemon --console=plain; \
+ ls -lh app/build/outputs/apk/debug/
diff --git a/demo/app/android-kotlin/README.md b/demo/app/android-kotlin/README.md
new file mode 100644
index 0000000..4059d53
--- /dev/null
+++ b/demo/app/android-kotlin/README.md
@@ -0,0 +1,106 @@
+# 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
+
+```shell
+sh build.sh
+# 产物:dist/app-debug.apk
+```
+
+`build.sh` 做的是两件事:
+
+```shell
+# 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/` 下:
+
+```shell
+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
+```
+
+清工程:
+
+```shell
+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 自带的调试签名,可直接安装。
+
+```shell
+# 校验签名与基本信息
+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 字节码。
diff --git a/demo/app/android-kotlin/app/build.gradle.kts b/demo/app/android-kotlin/app/build.gradle.kts
new file mode 100644
index 0000000..49ad516
--- /dev/null
+++ b/demo/app/android-kotlin/app/build.gradle.kts
@@ -0,0 +1,59 @@
+plugins {
+ id("com.android.application")
+ id("org.jetbrains.kotlin.android")
+}
+
+android {
+ namespace = "cn.odboy.demo.kotlin"
+ compileSdk = 35
+
+ defaultConfig {
+ applicationId = "cn.odboy.demo.kotlin"
+ minSdk = 24
+ targetSdk = 35
+ versionCode = 1
+ versionName = "1.0"
+ }
+
+ buildTypes {
+ // debug 用 SDK 内置的调试签名即可安装,示例不需要 release keystore
+ debug {
+ isMinifyEnabled = false
+ }
+ release {
+ isMinifyEnabled = false
+ proguardFiles(getDefaultProguardFile("proguard-android-optimize.txt"), "proguard-rules.pro")
+ }
+ }
+
+ // AppCompat 主题与 BuildConfig 需要在 AGP 8.x 里显式打开
+ buildFeatures {
+ buildConfig = true
+ }
+
+ // JDK 21 编译,字节码与 Android 兼容
+ compileOptions {
+ sourceCompatibility = JavaVersion.VERSION_17
+ targetCompatibility = JavaVersion.VERSION_17
+ }
+ kotlinOptions {
+ jvmTarget = "17"
+ }
+}
+
+dependencies {
+ implementation("androidx.appcompat:appcompat:1.7.0")
+}
+
+// appcompat 1.7.0 传递依赖 kotlin-stdlib-jdk7/jdk8:1.6.21,与 Kotlin 插件带入的 stdlib 版本不一致。
+// Kotlin 1.8 起 jdk7/jdk8 的类已合并进主 stdlib,版本错开会报 Duplicate class;
+// 用 force 统一到 Kotlin 2.2.21 对应的 stdlib 版本。
+configurations.configureEach {
+ resolutionStrategy {
+ force(
+ "org.jetbrains.kotlin:kotlin-stdlib:2.2.21",
+ "org.jetbrains.kotlin:kotlin-stdlib-jdk7:2.2.21",
+ "org.jetbrains.kotlin:kotlin-stdlib-jdk8:2.2.21",
+ )
+ }
+}
diff --git a/demo/app/android-kotlin/app/proguard-rules.pro b/demo/app/android-kotlin/app/proguard-rules.pro
new file mode 100644
index 0000000..276ad63
--- /dev/null
+++ b/demo/app/android-kotlin/app/proguard-rules.pro
@@ -0,0 +1 @@
+# 示例不开启混淆(isMinifyEnabled = false),此文件留作项目扩展用
diff --git a/demo/app/android-kotlin/app/src/main/AndroidManifest.xml b/demo/app/android-kotlin/app/src/main/AndroidManifest.xml
new file mode 100644
index 0000000..2f851da
--- /dev/null
+++ b/demo/app/android-kotlin/app/src/main/AndroidManifest.xml
@@ -0,0 +1,17 @@
+
+
+
+
+
+
+
+
+
+
+
diff --git a/demo/app/android-kotlin/app/src/main/java/cn/odboy/demo/kotlin/MainActivity.kt b/demo/app/android-kotlin/app/src/main/java/cn/odboy/demo/kotlin/MainActivity.kt
new file mode 100644
index 0000000..a57c080
--- /dev/null
+++ b/demo/app/android-kotlin/app/src/main/java/cn/odboy/demo/kotlin/MainActivity.kt
@@ -0,0 +1,21 @@
+package cn.odboy.demo.kotlin
+
+import android.os.Bundle
+import android.widget.TextView
+import androidx.appcompat.app.AppCompatActivity
+
+class MainActivity : AppCompatActivity() {
+ override fun onCreate(savedInstanceState: Bundle?) {
+ super.onCreate(savedInstanceState)
+ setContentView(R.layout.activity_main)
+
+ // 启动即显示构建信息,便于在真机上确认装的是哪一次构建的包
+ val info = buildString {
+ appendLine(getString(R.string.hello))
+ appendLine("versionName: ${BuildConfig.VERSION_NAME}")
+ appendLine("applicationId: ${BuildConfig.APPLICATION_ID}")
+ append("BuildConfig.DEBUG: ${BuildConfig.DEBUG}")
+ }
+ findViewById(R.id.message).text = info
+ }
+}
diff --git a/demo/app/android-kotlin/app/src/main/res/layout/activity_main.xml b/demo/app/android-kotlin/app/src/main/res/layout/activity_main.xml
new file mode 100644
index 0000000..f9756ac
--- /dev/null
+++ b/demo/app/android-kotlin/app/src/main/res/layout/activity_main.xml
@@ -0,0 +1,17 @@
+
+
+
+
+
diff --git a/demo/app/android-kotlin/app/src/main/res/values/strings.xml b/demo/app/android-kotlin/app/src/main/res/values/strings.xml
new file mode 100644
index 0000000..615fbb2
--- /dev/null
+++ b/demo/app/android-kotlin/app/src/main/res/values/strings.xml
@@ -0,0 +1,5 @@
+
+
+ android-kotlin demo
+ Hello from android-kotlin demo!
+
diff --git a/demo/app/android-kotlin/app/src/main/res/values/styles.xml b/demo/app/android-kotlin/app/src/main/res/values/styles.xml
new file mode 100644
index 0000000..7fb0269
--- /dev/null
+++ b/demo/app/android-kotlin/app/src/main/res/values/styles.xml
@@ -0,0 +1,5 @@
+
+
+
+
+
diff --git a/demo/app/android-kotlin/build.gradle.kts b/demo/app/android-kotlin/build.gradle.kts
new file mode 100644
index 0000000..e64c09f
--- /dev/null
+++ b/demo/app/android-kotlin/build.gradle.kts
@@ -0,0 +1,6 @@
+// 根工程只声明插件版本,各模块按需 apply
+// AGP 8.13.x 需要 Gradle 8.13+、JDK 17+(镜像为 JDK 21 + Gradle 8.14.3)
+plugins {
+ id("com.android.application") version "8.13.2" apply false
+ id("org.jetbrains.kotlin.android") version "2.2.21" apply false
+}
diff --git a/demo/app/android-kotlin/build.sh b/demo/app/android-kotlin/build.sh
new file mode 100644
index 0000000..13f7f98
--- /dev/null
+++ b/demo/app/android-kotlin/build.sh
@@ -0,0 +1,19 @@
+#!/usr/bin/env bash
+# 构建 apk 并把产物拷到宿主机 dist/(Android 无运行阶段,只交付 apk)
+set -euo pipefail
+cd "$(dirname "$0")"
+
+IMAGE=registry.cn-shanghai.aliyuncs.com/odboy/kenaito:demo-android-kotlin
+# docker cp 的路径相对容器根目录解析(不是相对 WORKDIR),所以这里必须写绝对路径
+APK=/workspace/app/build/outputs/apk/debug/app-debug.apk
+
+# docker build 不支持 -v 挂载宿主目录(那是 docker run 的选项);依赖包复用靠 BuildKit 的层缓存,
+# Dockerfile 里先 COPY gradle 构建脚本再 COPY 源码,依赖声明不变时这一层直接命中缓存
+docker build --progress=plain -t "${IMAGE}" .
+
+# 从镜像里把 apk 取出来:先 create 出容器(不启动),docker cp 后删除
+mkdir -p dist
+CID=$(docker create "${IMAGE}")
+docker cp "${CID}:${APK}" dist/app-debug.apk
+docker rm -f "${CID}" > /dev/null
+ls -lh dist/app-debug.apk
diff --git a/demo/app/android-kotlin/gradle.properties b/demo/app/android-kotlin/gradle.properties
new file mode 100644
index 0000000..ed03ebe
--- /dev/null
+++ b/demo/app/android-kotlin/gradle.properties
@@ -0,0 +1,8 @@
+// SDK 路径由镜像的 ANDROID_SDK_ROOT 环境变量提供;本地开发时也可写 local.properties
+org.gradle.jvmargs=-Xmx2g -Dfile.encoding=UTF-8
+org.gradle.parallel=true
+org.gradle.caching=true
+# AGP 8.x 默认使用 AndroidX
+android.useAndroidX=true
+# Kotlin 增量编译与代码风格
+kotlin.code.style=official
diff --git a/demo/app/android-kotlin/settings.gradle.kts b/demo/app/android-kotlin/settings.gradle.kts
new file mode 100644
index 0000000..3f02045
--- /dev/null
+++ b/demo/app/android-kotlin/settings.gradle.kts
@@ -0,0 +1,20 @@
+pluginManagement {
+ repositories {
+ // 阿里云代理 Google / Maven Central / Gradle Plugin Portal(镜像内 init.d/init.gradle 也做同样的改写,
+ // 这里直接写阿里云地址,脱离镜像在本地构建时也走国内源)
+ maven("https://maven.aliyun.com/repository/google")
+ maven("https://maven.aliyun.com/repository/public")
+ maven("https://maven.aliyun.com/repository/gradle-plugin")
+ }
+}
+
+dependencyResolutionManagement {
+ repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
+ repositories {
+ maven("https://maven.aliyun.com/repository/google")
+ maven("https://maven.aliyun.com/repository/public")
+ }
+}
+
+rootProject.name = "android-kotlin"
+include(":app")