tmvdl/android

Android 项目编译 Docker 镜像

镜像概述

tmvdl/android 是一个集成 Android SDK 及多种移动开发框架的 Docker 镜像，旨在简化 Android 应用项目的编译流程。该镜像预配置了 Android 开发所需的工具链、依赖库及主流框架（如 Ionic、React Native、Angular），可直接用于 Android 应用的构建与打包，避免本地开发环境配置复杂、依赖冲突等问题，确保构建环境的一致性。

核心功能与特性

• 多框架支持：集成 Ionic、React Native、Angular 等主流移动开发框架，满足不同技术栈项目的编译需求。
• Android SDK 集成：内置 Android SDK（基于 API Level 30），包含编译 Android 应用所需的基础工具链（如 adb、gradle、aapt 等）。
• 简化环境配置：无需本地安装 Android SDK、框架依赖及系统工具，直接通过镜像启动即可进行编译。
• 一致性构建环境：在开发、测试及 CI/CD 流程中提供统一的构建环境，消除“本地能跑，线上构建失败”的环境差异问题。

支持的标签

使用场景

• 开发者本地编译：快速搭建 Android 应用编译环境，无需手动配置 SDK 及框架依赖。
• CI/CD 自动化构建：在持续集成/持续部署流程中作为构建节点，自动化执行 Android 应用打包。
• 多框架项目构建：适配 Ionic、React Native、Angular 等不同技术栈的 Android 项目构建需求。
• 跨平台团队协作：统一团队开发环境，避免因本地配置差异导致的构建问题。

使用方法

基础使用示例

根据项目技术栈选择对应的镜像标签，通过 Dockerfile 集成或直接运行容器执行编译命令。

1. Ionic 项目编译

Dockerfile 集成（推荐用于项目固化构建环境）：

dockerfile
# 基于 ionic 标签构建
FROM docker.xuanyuan.run/tmvdl/android:ionic

# 设置工作目录
WORKDIR /app

# 复制项目文件
COPY . .

# 安装项目依赖（如 package.json 中定义的依赖）
RUN npm install

# 执行 Android 编译命令
CMD ["cordova", "build", "android"]

直接运行容器编译（适合临时构建）：

bash
# 挂载本地项目目录到容器内 /app，执行编译
docker run -v $(pwd):/app docker.xuanyuan.run/tmvdl/android:ionic sh -c "cd /app && npm install && cordova build android"

2. React Native 项目编译

Dockerfile 示例：

dockerfile
FROM docker.xuanyuan.run/tmvdl/android:react-native

WORKDIR /app

COPY . .

RUN npm install

# 编译 Android 应用（生成 APK）
CMD ["react-native", "build-android"]

容器运行命令：

bash
docker run -v $(pwd):/app docker.xuanyuan.run/tmvdl/android:react-native sh -c "cd /app && npm install && react-native build-android"

3. Angular 项目编译（Android 平台）

Dockerfile 示例：

dockerfile
FROM docker.xuanyuan.run/tmvdl/android:angular

WORKDIR /app

COPY . .

RUN npm install

# 构建 Angular 项目并打包为 Android 应用（需项目已配置 Cordova 或 Capacitor）
CMD ["ng", "build", "--prod", "&&", "capacitor", "copy", "android"]

4. 基础 Android SDK 环境（sdk30）

适用于原生 Android 项目或需要自定义编译流程的场景：

bash
# 运行容器，使用基础 SDK 环境执行 gradle 编译
docker run -v $(pwd):/app docker.xuanyuan.run/tmvdl/android:sdk30 sh -c "cd /app && ./gradlew assembleRelease"

Docker Compose 配置示例

在 docker-compose.yml 中定义构建服务，便于集成到项目开发流程：

yaml
version: '3'

services:
  android-build:
    image: docker.xuanyuan.run/tmvdl/android:ionic  # 根据项目框架选择标签
    volumes:
      - ./:/app  # 挂载本地项目目录
    working_dir: /app
    command: sh -c "npm install && cordova build android"

启动构建：

bash
docker-compose run android-build

配置说明

• 环境变量：当前镜像无需额外环境变量配置，工具链及框架依赖已预集成。
• 数据持久化：通过 -v 参数挂载本地项目目录（如示例中的 $(pwd):/app），确保编译产物（如 platforms/android/app/build/outputs/apk）输出到本地。
• 自定义编译参数：可在 CMD 或容器运行命令中调整编译参数（如 cordova build android --release 生成正式版 APK）。

问题反馈

如使用中遇到问题，可通过 https://github.com/brtmvdl/docker-android/issues 提交反馈。

许可证

本镜像基于 https://github.com/brtmvdl/docker-android/blob/main/LICENSE 开源。