From 5dc02feeedcbf894555b788977fb4b012fbf93c9 Mon Sep 17 00:00:00 2001 From: Odboy Date: Sun, 15 Nov 2026 13:08:00 +0800 Subject: [PATCH] =?UTF-8?q?feat:=20=E6=96=B0=E5=A2=9E=20android=20?= =?UTF-8?q?=E5=BA=94=E7=94=A8=E7=A4=BA=E4=BE=8B=EF=BC=88kotlin=20/=20java?= =?UTF-8?q?=EF=BC=89=EF=BC=8CREADME=20=E8=A1=A5=E5=85=85=20compile-android?= =?UTF-8?q?-gradle8x?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - demo/app/android-kotlin:Kotlin Android 应用编译示例,debug apk 产出后拷回宿主机 - demo/app/android-java:纯 Java Android 应用编译示例 - README:镜像表新增 compile-android-gradle8x,示例表与选型说明补充 android 条目 --- README.md | 7 ++ demo/app/android-java/.dockerignore | 4 + demo/app/android-java/.gitignore | 8 ++ demo/app/android-java/Dockerfile | 16 +++ demo/app/android-java/README.md | 110 ++++++++++++++++++ demo/app/android-java/app/build.gradle.kts | 55 +++++++++ demo/app/android-java/app/proguard-rules.pro | 1 + .../app/src/main/AndroidManifest.xml | 17 +++ .../java/cn/odboy/demo/java/MainActivity.java | 24 ++++ .../app/src/main/res/layout/activity_main.xml | 17 +++ .../app/src/main/res/values/strings.xml | 5 + .../app/src/main/res/values/styles.xml | 5 + demo/app/android-java/build.gradle.kts | 5 + demo/app/android-java/build.sh | 19 +++ demo/app/android-java/gradle.properties | 6 + demo/app/android-java/settings.gradle.kts | 20 ++++ demo/app/android-kotlin/.dockerignore | 4 + demo/app/android-kotlin/.gitignore | 8 ++ demo/app/android-kotlin/Dockerfile | 15 +++ demo/app/android-kotlin/README.md | 106 +++++++++++++++++ demo/app/android-kotlin/app/build.gradle.kts | 59 ++++++++++ .../app/android-kotlin/app/proguard-rules.pro | 1 + .../app/src/main/AndroidManifest.xml | 17 +++ .../java/cn/odboy/demo/kotlin/MainActivity.kt | 21 ++++ .../app/src/main/res/layout/activity_main.xml | 17 +++ .../app/src/main/res/values/strings.xml | 5 + .../app/src/main/res/values/styles.xml | 5 + demo/app/android-kotlin/build.gradle.kts | 6 + demo/app/android-kotlin/build.sh | 19 +++ demo/app/android-kotlin/gradle.properties | 8 ++ demo/app/android-kotlin/settings.gradle.kts | 20 ++++ 31 files changed, 630 insertions(+) create mode 100644 demo/app/android-java/.dockerignore create mode 100644 demo/app/android-java/.gitignore create mode 100644 demo/app/android-java/Dockerfile create mode 100644 demo/app/android-java/README.md create mode 100644 demo/app/android-java/app/build.gradle.kts create mode 100644 demo/app/android-java/app/proguard-rules.pro create mode 100644 demo/app/android-java/app/src/main/AndroidManifest.xml create mode 100644 demo/app/android-java/app/src/main/java/cn/odboy/demo/java/MainActivity.java create mode 100644 demo/app/android-java/app/src/main/res/layout/activity_main.xml create mode 100644 demo/app/android-java/app/src/main/res/values/strings.xml create mode 100644 demo/app/android-java/app/src/main/res/values/styles.xml create mode 100644 demo/app/android-java/build.gradle.kts create mode 100644 demo/app/android-java/build.sh create mode 100644 demo/app/android-java/gradle.properties create mode 100644 demo/app/android-java/settings.gradle.kts create mode 100644 demo/app/android-kotlin/.dockerignore create mode 100644 demo/app/android-kotlin/.gitignore create mode 100644 demo/app/android-kotlin/Dockerfile create mode 100644 demo/app/android-kotlin/README.md create mode 100644 demo/app/android-kotlin/app/build.gradle.kts create mode 100644 demo/app/android-kotlin/app/proguard-rules.pro create mode 100644 demo/app/android-kotlin/app/src/main/AndroidManifest.xml create mode 100644 demo/app/android-kotlin/app/src/main/java/cn/odboy/demo/kotlin/MainActivity.kt create mode 100644 demo/app/android-kotlin/app/src/main/res/layout/activity_main.xml create mode 100644 demo/app/android-kotlin/app/src/main/res/values/strings.xml create mode 100644 demo/app/android-kotlin/app/src/main/res/values/styles.xml create mode 100644 demo/app/android-kotlin/build.gradle.kts create mode 100644 demo/app/android-kotlin/build.sh create mode 100644 demo/app/android-kotlin/gradle.properties create mode 100644 demo/app/android-kotlin/settings.gradle.kts 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 @@ + + + +