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,4 @@
|
||||
build.sh
|
||||
dist/
|
||||
.git/
|
||||
.DS_Store
|
||||
@@ -0,0 +1,8 @@
|
||||
# 构建产物 / 本地缓存
|
||||
build/
|
||||
.gradle/
|
||||
local.properties
|
||||
*.apk
|
||||
*.aab
|
||||
dist/
|
||||
.DS_Store
|
||||
@@ -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/
|
||||
@@ -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",
|
||||
)
|
||||
}
|
||||
}
|
||||
@@ -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>
|
||||
@@ -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
|
||||
}
|
||||
@@ -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
|
||||
@@ -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
|
||||
@@ -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")
|
||||
@@ -0,0 +1,4 @@
|
||||
build.sh
|
||||
dist/
|
||||
.git/
|
||||
.DS_Store
|
||||
@@ -0,0 +1,8 @@
|
||||
# 构建产物 / 本地缓存
|
||||
build/
|
||||
.gradle/
|
||||
local.properties
|
||||
*.apk
|
||||
*.aab
|
||||
dist/
|
||||
.DS_Store
|
||||
@@ -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/
|
||||
@@ -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 字节码。
|
||||
@@ -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",
|
||||
)
|
||||
}
|
||||
}
|
||||
@@ -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,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<TextView>(R.id.message).text = info
|
||||
}
|
||||
}
|
||||
@@ -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-kotlin demo" />
|
||||
</LinearLayout>
|
||||
@@ -0,0 +1,5 @@
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<resources>
|
||||
<string name="app_name">android-kotlin demo</string>
|
||||
<string name="hello">Hello from android-kotlin 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>
|
||||
@@ -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
|
||||
}
|
||||
@@ -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
|
||||
@@ -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
|
||||
@@ -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")
|
||||
Reference in New Issue
Block a user