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 条目
This commit is contained in:
2026-11-15 13:08:00 +08:00
parent 8a14027e22
commit 5dc02feeed
31 changed files with 630 additions and 0 deletions
+4
View File
@@ -0,0 +1,4 @@
build.sh
dist/
.git/
.DS_Store
+8
View File
@@ -0,0 +1,8 @@
# 构建产物 / 本地缓存
build/
.gradle/
local.properties
*.apk
*.aab
dist/
.DS_Store
+16
View File
@@ -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/
+110
View File
@@ -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 字节码。
@@ -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",
)
}
}
+1
View File
@@ -0,0 +1 @@
# 示例不开启混淆(isMinifyEnabled = false),此文件留作项目扩展用
@@ -0,0 +1,17 @@
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android">
<application
android:allowBackup="true"
android:label="@string/app_name"
android:supportsRtl="true"
android:theme="@style/Theme.Demo">
<activity
android:name=".MainActivity"
android:exported="true">
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
</application>
</manifest>
@@ -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());
}
}
@@ -0,0 +1,17 @@
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:gravity="center"
android:orientation="vertical"
android:padding="24dp">
<TextView
android:id="@+id/message"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:gravity="center"
android:textSize="18sp"
tools:text="android-java demo" />
</LinearLayout>
@@ -0,0 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<resources>
<string name="app_name">android-java demo</string>
<string name="hello">Hello from android-java demo!</string>
</resources>
@@ -0,0 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<resources>
<!-- AppCompat 主题即可满足示例,不引入 Material 依赖 -->
<style name="Theme.Demo" parent="Theme.AppCompat.DayNight.DarkActionBar" />
</resources>
+5
View File
@@ -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
}
+19
View File
@@ -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
+6
View File
@@ -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
+20
View File
@@ -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")