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:
@@ -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 字节码。
|
||||
Reference in New Issue
Block a user