gamechangerinteractive/electron

docker-electron 镜像文档

镜像概述

docker-electron 是一个专为构建 Electron 和 Cordova Android 应用设计的 Docker 镜像。它提供了统一、隔离的构建环境，旨在解决因本地开发环境差异导致的构建问题，简化跨平台应用的开发与部署流程。

核心功能与特性

• 多框架支持：同时支持 Electron 应用和 Cordova Android 应用的构建
• 环境一致性：提供标准化的构建环境，避免因本地依赖差异导致的构建失败
• 简化配置：内置构建所需的基础依赖，减少手动配置步骤
• 跨平台兼容：可在任何支持 Docker 的系统上运行，确保构建结果一致性

使用场景与适用范围

• 开发 Electron 桌面应用的个人开发者或团队
• 需要构建 Cordova Android 移动应用的开发人员
• CI/CD 流程中集成自动化构建环节
• 希望快速搭建统一构建环境的开发团队

使用方法与配置说明

基本使用（docker run）

bash
# 构建 Electron 应用示例
docker run -v /path/to/your/electron-project:/app -w /app docker-electron electron-builder

# 构建 Cordova Android 应用示例
docker run -v /path/to/your/cordova-project:/app -w /app docker-electron cordova build android

参数说明

• -v /path/to/your/project:/app：将本地项目目录挂载到容器内的 /app 工作目录
• -w /app：设置容器内的工作目录为 /app，即项目根目录
• 后续命令（如 electron-builder、cordova build android）为具体构建命令，需根据项目实际需求调整

注意事项

1. 确保本地项目已正确配置 package.json（Electron）或 config.xml（Cordova）
2. 构建 Cordova Android 应用时，可能需要根据项目需求配置 Android SDK 版本等参数
3. 对于大型项目，建议通过 Docker 卷挂载依赖目录（如 node_modules）以提高构建效率

扩展说明

该镜像默认包含构建 Electron 和 Cordova Android 应用所需的基础工具链，如 Node.js、npm、Android SDK 基础组件等。如需自定义构建环境，可基于此镜像创建 Dockerfile 进行扩展，添加额外依赖或工具。