From 8a14027e227d20eb43e49d4dd7bce1a8d8958c68 Mon Sep 17 00:00:00 2001 From: Odboy Date: Sun, 15 Nov 2026 12:52:59 +0800 Subject: [PATCH] =?UTF-8?q?feat:=20=E6=96=B0=E5=A2=9E=20android=20?= =?UTF-8?q?=E7=BC=96=E8=AF=91=E9=95=9C=E5=83=8F=20compile-android-gradle8x?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 基于 runtime-jdk21,内置 JDK 21 + Gradle 8.14.3 + Android SDK (platform-tools、platforms 35/36、build-tools 35.0.0、NDK 27、CMake 3.22.1)。 Android 只出 apk/aar,无运行阶段,因此只加编译镜像。 - 组件包由 build.sh 预下载并校验 sha1,Dockerfile 按各包实际目录结构解压 (不用 sdkmanager 在线安装:它在 Docker 里从镜像站取到残包,报 ZipFile unknown archive) - Gradle 发行包走阿里云;gradle-init.gradle 把依赖仓库改写为阿里云代理 - 构建末尾按真实文件自检 adb/android.jar/aapt2/ndk-build/cmake --- image/compile-android-gradle8x/.dockerignore | 5 + image/compile-android-gradle8x/.gitignore | 6 ++ image/compile-android-gradle8x/Dockerfile | 98 +++++++++++++++++++ image/compile-android-gradle8x/build.sh | 81 +++++++++++++++ .../gradle-init.gradle | 32 ++++++ 5 files changed, 222 insertions(+) create mode 100644 image/compile-android-gradle8x/.dockerignore create mode 100644 image/compile-android-gradle8x/.gitignore create mode 100644 image/compile-android-gradle8x/Dockerfile create mode 100644 image/compile-android-gradle8x/build.sh create mode 100644 image/compile-android-gradle8x/gradle-init.gradle diff --git a/image/compile-android-gradle8x/.dockerignore b/image/compile-android-gradle8x/.dockerignore new file mode 100644 index 0000000..b80541c --- /dev/null +++ b/image/compile-android-gradle8x/.dockerignore @@ -0,0 +1,5 @@ +# build.sh 预下载的 zip(cmdline-tools / gradle / SDK 组件包)由 Dockerfile COPY 进镜像, +# 必须在构建上下文内,因此不能在这里忽略 *.zip +build.sh +.git/ +.DS_Store diff --git a/image/compile-android-gradle8x/.gitignore b/image/compile-android-gradle8x/.gitignore new file mode 100644 index 0000000..dc5c836 --- /dev/null +++ b/image/compile-android-gradle8x/.gitignore @@ -0,0 +1,6 @@ +# 构建产物 / 本地缓存 +*.zip +*.sha256 +*.part +*.pro +.DS_Store diff --git a/image/compile-android-gradle8x/Dockerfile b/image/compile-android-gradle8x/Dockerfile new file mode 100644 index 0000000..311c81d --- /dev/null +++ b/image/compile-android-gradle8x/Dockerfile @@ -0,0 +1,98 @@ +# Android 只有编译镜像,没有 runtime:构建产物是 apk / aar / jar,由真机或模拟器安装运行, +# 不存在“在容器里跑起来”的服务进程;apk 用镜像内置的 JDK 21 + SDK 35 + Gradle 8.x 产出即可 +FROM registry.cn-shanghai.aliyuncs.com/odboy/kenaito:runtime-jdk21 +LABEL MAINTAINER="tianjun@odboy.cn" +ENV TimeZone=Asia/Shanghai +# SDK 装到 /usr/local 下而不是 $HOME:容器里 HOME 可能随 docker run -u 变化, +# sdkmanager 发现 HOME 下没有 SDK 会尝试重新下载,路径固定后不受影响 +ENV ANDROID_SDK_ROOT=/usr/local/android-sdk +ENV ANDROID_HOME=/usr/local/android-sdk +ENV GRADLE_HOME=/usr/local/gradle8 +# Gradle 缓存与守护进程目录固定到 admin 家目录,宿主 -v ~/.gradle:/home/admin/.gradle 可直接复用依赖缓存 +ENV GRADLE_USER_HOME=/home/admin/.gradle +ENV PATH="${ANDROID_SDK_ROOT}/cmdline-tools/latest/bin:${ANDROID_SDK_ROOT}/platform-tools:${GRADLE_HOME}/bin:$PATH" +WORKDIR /home/admin +# 由 build.sh 预先下载并校验 sha1/sha256 到本目录(构建上下文里不能忽略这些 zip), +# 全部用 COPY:ADD 对本地 tar 会自动解压,这里要的是原样放进镜像再按需解压 +COPY commandlinetools-linux-13114758_latest.zip /tmp/android-cmdline-tools/ +# cmdline-tools 的 zip 解出来是 cmdline-tools/ 目录,sdkmanager 要求它放在 cmdline-tools/latest 下(见下方 RUN) +COPY gradle-8.14.3-bin.zip /usr/local/ +COPY platform-tools_r37.0.3-linux.zip platform-35_r02.zip platform-36_r02.zip \ + build-tools_r35_linux.zip android-ndk-r27-linux.zip cmake-3.22.1-linux.zip \ + /tmp/sdk-packages/ +# unzip:解 cmdline-tools / Gradle 包;git 供部分 AGP 插件拉依赖(libstdc++ 是 system-alinux3 自带的基础库) +RUN set -e && yum install \ + unzip \ + zip \ + git \ + ca-certificates \ + which \ + sysstat \ + net-tools -y; \ + mkdir -p ${ANDROID_SDK_ROOT}/cmdline-tools; \ + unzip -q /usr/local/gradle-8.14.3-bin.zip -d /usr/local; \ + mv /usr/local/gradle-8.14.3 ${GRADLE_HOME}; \ + unzip -q /tmp/android-cmdline-tools/commandlinetools-linux-13114758_latest.zip -d ${ANDROID_SDK_ROOT}; \ + mv ${ANDROID_SDK_ROOT}/cmdline-tools ${ANDROID_SDK_ROOT}/cmdline-tools-latest; \ + mkdir -p ${ANDROID_SDK_ROOT}/cmdline-tools; \ + mv ${ANDROID_SDK_ROOT}/cmdline-tools-latest ${ANDROID_SDK_ROOT}/cmdline-tools/latest; \ + rm -rf /tmp/android-cmdline-tools; \ + gradle -v; \ + sdkmanager --version +# 装编译所需组件(版本与 README 中的说明保持一致): +# platform-tools adb / fastboot,apk 校验与真机安装用 +# platforms;android-35 compileSdk 35 +# platforms;android-36 预留 Android 16,targetSdk 36 的项目可直接编 +# build-tools;35.0.0 aapt2 / d8 / zipalign / apksigner +# ndk;27.0.12077973 原生代码(CMake / ndk-build) +# cmake;3.22.1 由 SDK 提供 linux-x86_64 预编译二进制,与仓库其余镜像同为 x86_64; +# ninja 随该包一起装到 cmake/3.22.1/bin 下,无需单独下载 +# 组件不从 sdkmanager 在线安装:它在 Docker 里从镜像站下载后解压会报 +# “Error on ZipFile unknown archive”(包本身完好、sha1 与仓库清单一致,拿到的是残包)。 +# 改为 build.sh 预下载 + 校验 sha1,这里按各包的目录结构解压: +# platform-tools_r37.0.3-linux.zip -> platform-tools/ +# platform-35_r02.zip -> android-35/ (移到 platforms/android-35) +# platform-36_r02.zip -> android-36/ (移到 platforms/android-36) +# build-tools_r35_linux.zip -> android-15/ (移到 build-tools/35.0.0,包内目录名与版本不一致) +# android-ndk-r27-linux.zip -> android-ndk-r27/(移到 ndk/27.0.12077973) +# cmake-3.22.1-linux.zip -> 无顶层目录 (直接解到 cmake/3.22.1) +RUN set -e && mkdir -p "${ANDROID_SDK_ROOT}/platforms" \ + "${ANDROID_SDK_ROOT}/build-tools" \ + "${ANDROID_SDK_ROOT}/ndk" \ + "${ANDROID_SDK_ROOT}/cmake/3.22.1"; \ + unzip -q /tmp/sdk-packages/platform-tools_r37.0.3-linux.zip -d "${ANDROID_SDK_ROOT}"; \ + unzip -q /tmp/sdk-packages/platform-35_r02.zip -d /tmp/sdk-packages/p35; \ + mv /tmp/sdk-packages/p35/android-35 "${ANDROID_SDK_ROOT}/platforms/android-35"; \ + unzip -q /tmp/sdk-packages/platform-36_r02.zip -d /tmp/sdk-packages/p36; \ + mv /tmp/sdk-packages/p36/android-36 "${ANDROID_SDK_ROOT}/platforms/android-36"; \ + unzip -q /tmp/sdk-packages/build-tools_r35_linux.zip -d /tmp/sdk-packages/bt; \ + mv /tmp/sdk-packages/bt/android-15 "${ANDROID_SDK_ROOT}/build-tools/35.0.0"; \ + unzip -q /tmp/sdk-packages/android-ndk-r27-linux.zip -d /tmp/sdk-packages/ndk; \ + mv /tmp/sdk-packages/ndk/android-ndk-r27 "${ANDROID_SDK_ROOT}/ndk/27.0.12077973"; \ + unzip -q /tmp/sdk-packages/cmake-3.22.1-linux.zip -d "${ANDROID_SDK_ROOT}/cmake/3.22.1"; \ + rm -rf /tmp/sdk-packages/p35 /tmp/sdk-packages/p36 /tmp/sdk-packages/bt /tmp/sdk-packages/ndk; \ + chmod +x "${ANDROID_SDK_ROOT}/platform-tools/adb" \ + "${ANDROID_SDK_ROOT}/build-tools/35.0.0/aapt2" \ + "${ANDROID_SDK_ROOT}/cmake/3.22.1/bin/cmake"; \ + sdkmanager --sdk_root="${ANDROID_SDK_ROOT}" --list_installed || true; \ + for f in \ + "${ANDROID_SDK_ROOT}/platform-tools/adb" \ + "${ANDROID_SDK_ROOT}/platforms/android-35/android.jar" \ + "${ANDROID_SDK_ROOT}/platforms/android-36/android.jar" \ + "${ANDROID_SDK_ROOT}/build-tools/35.0.0/aapt2" \ + "${ANDROID_SDK_ROOT}/ndk/27.0.12077973/ndk-build" \ + "${ANDROID_SDK_ROOT}/cmake/3.22.1/bin/cmake"; do \ + if [ ! -x "$f" ] && [ ! -f "$f" ]; then \ + echo "组件文件缺失:$f" >&2; \ + ls -la "${ANDROID_SDK_ROOT}" >&2; \ + exit 1; \ + fi; \ + done; \ + "${ANDROID_SDK_ROOT}/build-tools/35.0.0/aapt2" version +# Gradle 全局配置:只改仓库地址(阿里云代理 Google / Maven Central / Gradle 插件仓库), +# 其余保持 Gradle 默认行为;项目里的 Gradle Wrapper / 自身依赖仍按各自配置解析 +COPY gradle-init.gradle ${GRADLE_USER_HOME}/init.d/init.gradle +# Android SDK 与 NDK 目录只读执行权限,非 root 用户(docker run -u)也能用 +RUN set -e && chmod -R a+rx ${ANDROID_SDK_ROOT} ${GRADLE_HOME}; \ + mkdir -p ${GRADLE_USER_HOME}; \ + gradle --version diff --git a/image/compile-android-gradle8x/build.sh b/image/compile-android-gradle8x/build.sh new file mode 100644 index 0000000..5dd1922 --- /dev/null +++ b/image/compile-android-gradle8x/build.sh @@ -0,0 +1,81 @@ +#!/usr/bin/env bash +# 预下载镜像构建所需的全部压缩包(Android 组件包 + cmdline-tools + Gradle),逐个校验后构建镜像。 +# 为什么不用 sdkmanager 在线安装:它在 Docker 里从镜像站下载后解压会报 +# “Error on ZipFile unknown archive”(包本身完好、sha1 与仓库清单一致),拿到的其实是残包; +# 这里用 curl 下载并校验 sha1,再由 Dockerfile 解压到 SDK 目录。 +set -euo pipefail +cd "$(dirname "$0")" + +# 阿里云镜像站没有 Android SDK 仓库,SDK 相关包用腾讯云同步的 AndroidSDK 镜像 +SDK_BASE=https://mirrors.cloud.tencent.com/AndroidSDK + +# Android cmdline-tools(sdkmanager / avdmanager 等工具) +CMDLINE_ZIP=commandlinetools-linux-13114758_latest.zip +CMDLINE_URL=${SDK_BASE}/${CMDLINE_ZIP} + +# Gradle:8.14.x 与 AGP 8.x 兼容。阿里云没有独立的 gradle 分区, +# 用其在 macports distfiles 下同步的官方发行包(sha256 与 services.gradle.org 一致) +GRADLE_VERSION=8.14.3 +GRADLE_ZIP=gradle-${GRADLE_VERSION}-bin.zip +GRADLE_URL=https://mirrors.aliyun.com/macports/distfiles/gradle/${GRADLE_ZIP} +# 阿里云镜像不提供 .sha256 文件,校验值取自官方(几十字节,联网获取一次即可) +GRADLE_SHA_URL=https://services.gradle.org/distributions/${GRADLE_ZIP}.sha256 + +# SDK 组件包:包名 | sha1。sha1 取自仓库清单 repository2-3.xml,与官方一致 +SDK_PACKAGES=$(cat <<'EOF' +platform-tools_r37.0.3-linux.zip e1579b288a7ae4e9bc28dedec6a154d78b3c04ed +platform-35_r02.zip 0bb560a90a7a2cbd0dd8348224d518b638fe7949 +platform-36_r02.zip 2c1a80dd4d9f7d0e6dd336ec603d9b5c55a6f576 +build-tools_r35_linux.zip 2cfaa0bbb2336e9ec18ed3ecea84fa2e2af607bc +android-ndk-r27-linux.zip 5e5cd517bdb98d7e0faf2c494a3041291e71bdcc +cmake-3.22.1-linux.zip fd0a48b4a758310df8c7aa51f59840ed48fe7ed8 +EOF +) + +# 下载到临时文件,完整下载后才改名:中途 Ctrl+C 不会留下“看起来已下载”的残包; +# --speed-limit/--speed-time:速率低于 50KB/s 持续 30 秒就断开重试,避免镜像偶发降速时一直挂着 +download() { + local url="$1" out="$2" + if [ ! -s "${out}" ]; then + curl -fL --retry 5 --retry-delay 2 --speed-limit 51200 --speed-time 30 -o "${out}.part" "${url}" + mv "${out}.part" "${out}" + fi +} + +# cmdline-tools:官方未公开独立校验文件,只校验 zip 完整可解 +download "${CMDLINE_URL}" "${CMDLINE_ZIP}" +unzip -tq "${CMDLINE_ZIP}" > /dev/null +echo "${CMDLINE_ZIP}: OK" + +# Gradle:官方 .sha256 内容只有 64 位十六进制哈希、没有文件名,不能直接 shasum -c,自己算完比对 +download "${GRADLE_URL}" "${GRADLE_ZIP}" +if [ ! -s "${GRADLE_ZIP}.sha256" ]; then + curl -fL --retry 3 --retry-delay 2 -o "${GRADLE_ZIP}.sha256.part" "${GRADLE_SHA_URL}" + mv "${GRADLE_ZIP}.sha256.part" "${GRADLE_ZIP}.sha256" +fi +EXPECTED=$(tr -d ' \t\r\n' < "${GRADLE_ZIP}.sha256") +ACTUAL=$(shasum -a 256 "${GRADLE_ZIP}" | awk '{print $1}') +if [ "${EXPECTED}" != "${ACTUAL}" ]; then + echo "sha256 校验失败:期望 ${EXPECTED},实际 ${ACTUAL};删除 ${GRADLE_ZIP} 后重试" >&2 + exit 1 +fi +echo "${GRADLE_ZIP}: OK" +rm -f "${GRADLE_ZIP}.sha256" + +# SDK 组件包:逐个下载并校验 sha1,不一致则删除残包退出 +while read -r pkg sha1; do + [ -z "${pkg}" ] && continue + download "${SDK_BASE}/${pkg}" "${pkg}" + ACTUAL=$(shasum -a 1 "${pkg}" | awk '{print $1}') + if [ "${sha1}" != "${ACTUAL}" ]; then + echo "sha1 校验失败:${pkg} 期望 ${sha1},实际 ${ACTUAL};已删除,重跑即可" >&2 + rm -f "${pkg}" + exit 1 + fi + echo "${pkg}: OK" +done <<< "${SDK_PACKAGES}" + +IMAGE=registry.cn-shanghai.aliyuncs.com/odboy/kenaito:compile-android-gradle8x +# --progress=plain:NDK 等包体积大,plain 日志便于看进度与排查 +docker build --progress=plain -t "${IMAGE}" . +docker push "${IMAGE}" diff --git a/image/compile-android-gradle8x/gradle-init.gradle b/image/compile-android-gradle8x/gradle-init.gradle new file mode 100644 index 0000000..6aa3913 --- /dev/null +++ b/image/compile-android-gradle8x/gradle-init.gradle @@ -0,0 +1,32 @@ +// Gradle 全局 init 脚本(镜像内 ${GRADLE_USER_HOME}/init.d/init.gradle),对容器里所有 Gradle 构建生效。 +// 只替换仓库地址,其余保持 Gradle 默认行为;项目里的 repositoryMode / 私有仓库配置仍按各自 build.gradle 解析。 +// 阿里云代理的三类仓库:Google(androidx / build-tools 依赖)、Maven Central、Gradle Plugin Portal + +def mirrors = [ + 'https://dl.google.com/dl/android/maven2': 'https://maven.aliyun.com/repository/google', + 'https://repo.maven.apache.org/maven2' : 'https://maven.aliyun.com/repository/public', + 'https://repo1.maven.org/maven2' : 'https://maven.aliyun.com/repository/public', + 'https://plugins.gradle.org/m2' : 'https://maven.aliyun.com/repository/gradle-plugin', +] + +def redirect = { RepositoryHandler repos -> + repos.configureEach { repo -> + if (repo instanceof MavenArtifactRepository) { + def url = repo.url.toString() + def target = mirrors.find { from, to -> url.startsWith(from) } + if (target) { + repo.url = target.value + } + } + } +} + +allprojects { + buildscript { + redirect(repositories) + } + redirect(repositories) +} +settingsEvaluated { settings -> + redirect(settings.pluginManagement.repositories) +}