kevinbrowntech/electron-wine-plus-postgres-libs

ElectronBuilder/Wine + libpq-dev Docker镜像文档

镜像概述

本镜像基于ElectronBuilder/Wine基础镜像构建，额外集成了libpq-dev（PostgreSQL客户端开发库）。它旨在为类Unix系统（如Linux、macOS）提供一个完整环境，用于构建需要PostgreSQL客户端依赖的Electron应用，同时支持通过Wine构建Windows平台的应用包。

核心功能和特性

• 集成ElectronBuilder：提供Electron应用打包工具，支持多平台（Windows、macOS、Linux）应用构建
• Wine环境：内置Wine兼容层，支持在类Unix系统中运行Windows工具链，实现Windows应用打包
• libpq-dev支持：包含PostgreSQL客户端开发库，满足依赖libpq的应用构建需求（如需要PostgreSQL连接的Electron应用）
• 基础构建环境：包含Node.js、npm等基础开发工具，可直接用于Electron应用的编译和打包

使用场景和适用范围

• 在Linux或macOS系统上开发需要PostgreSQL客户端依赖的Electron应用
• 需要跨平台构建Electron应用（尤其是Windows版本）的开发场景
• CI/CD流水线中集成Electron应用构建步骤，确保依赖环境一致性
• 本地开发环境快速搭建，避免系统级依赖冲突

使用方法和配置说明

基本使用（docker run）

bash
docker run -it --rm \
  -v $(pwd):/app \
  -w /app \
  electronbuilder-wine-libpq-dev \
  electron-builder --win

参数说明：

• -v $(pwd):/app：将本地当前目录挂载到容器内的/app目录，用于访问项目文件
• -w /app：设置工作目录为/app
• electron-builder --win：执行Electron构建命令，指定构建Windows平台应用

Docker Compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  electron-builder:
    image: electronbuilder-wine-libpq-dev
    volumes:
      - ./:/app
    working_dir: /app
    command: electron-builder --win --x64
    environment:
      - NODE_ENV=production
      - ELECTRON_BUILDER_CACHE=/app/.electron-builder-cache

启动构建：

bash
docker-compose run electron-builder

环境变量配置

构建自定义应用

1. 将Electron项目文件挂载到容器内
2. 安装项目依赖：npm install
3. 执行构建命令：electron-builder [平台参数]

常用平台参数：

• --win：构建Windows平台应用
• --mac：构建macOS平台应用
• --linux：构建Linux平台应用
• --x64：指定64位架构

示例（构建Windows 64位应用）：

bash
docker run -it --rm -v $(pwd):/app -w /app electronbuilder-wine-libpq-dev sh -c "npm install && electron-builder --win --x64"

注意事项

• 首次运行时，Wine会初始化配置，可能需要较长时间
• 构建Windows应用时，需确保项目中已正确配置Windows平台相关参数
• 对于大型项目，建议挂载本地缓存目录（如ELECTRON_BUILDER_CACHE）以加速构建过程
• libpq-dev包含头文件和库文件，如需运行时依赖，需额外安装libpq5包