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

107 lines
4.3 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 字节码。