mlukman/gitlabci-nodejs-android

NodeJS + Android SDK Docker镜像文档

镜像概述

本Docker镜像集成了NodeJS环境与Android SDK，旨在为基于Docker的持续集成(CI)流程提供一站式的Android应用编译环境。通过预配置必要的开发工具和依赖，解决CI环境中Android编译依赖复杂、环境一致性难以保障的问题，简化自动化构建流程。

核心功能与特性

• 完整开发环境：包含稳定版本的NodeJS环境及Android SDK，支持JavaScript/TypeScript开发与Android应用编译
• Android构建工具：预安装Android Build Tools、Platform Tools、SDK Platform等必要组件
• CI兼容性：适配主流CI平台（如Jenkins、GitLab CI、GitHub Actions等），支持容器化构建流程
• 环境一致性：标准化构建环境，避免因本地环境差异导致的构建问题
• 轻量级优化：精简镜像体积，缩短CI流程中的镜像拉取时间

使用场景与适用范围

• 持续集成流程中的Android应用自动化编译与打包
• 需要同时使用NodeJS（如React Native、Ionic等混合开发框架）和Android SDK的构建任务
• 多团队协作时统一构建环境，减少"在我机器上能运行"的问题
• 自动化测试流程中Android应用的构建与部署前置步骤

使用方法

基本使用

拉取镜像

bash
docker pull [镜像仓库地址]/nodejs-android-sdk:[标签]

注：请将[镜像仓库地址]和[标签]替换为实际的镜像地址和版本标签

运行编译命令

在项目根目录执行以下命令，挂载项目目录并运行编译：

bash
docker run -v $(pwd):/app -w /app [镜像仓库地址]/nodejs-android-sdk:[标签] sh -c "npm install && ./gradlew assembleRelease"

在CI配置中使用（以GitLab CI为例）

在.gitlab-ci.yml中添加构建任务：

yaml
build_android:
  image: [镜像仓库地址]/nodejs-android-sdk:[标签]
  stage: build
  script:
    - npm install
    - ./gradlew assembleRelease
  artifacts:
    paths:
      - app/build/outputs/apk/release/*.apk

Docker Compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  android-build:
    image: [镜像仓库地址]/nodejs-android-sdk:[标签]
    volumes:
      - ./:/app
    working_dir: /app
    command: sh -c "npm install && ./gradlew assembleRelease"

运行构建：

bash
docker-compose run android-build

配置说明

环境变量

自定义配置

如需扩展或修改SDK组件，可在运行时执行sdkmanager命令：

bash
docker run -it [镜像仓库地址]/nodejs-android-sdk:[标签] sdkmanager "platforms;android-33" "build-tools;33.0.1"

注意事项

• 首次运行可能需要接受Android SDK许可协议，可通过添加-y参数自动接受：sdkmanager --licenses -y
• 大型项目编译建议增加容器内存限制，避免OOM错误
• 如需使用特定版本的NodeJS或Android SDK，请选择对应标签的镜像版本