nanometrics/maven-install4j

Maven + Install4j 编译器镜像

镜像概述

本Docker镜像集成了Maven构建工具和Install4j编译器，专为Bitbucket Pipelines环境设计，旨在简化Java项目的自动化构建、依赖管理及安装程序打包流程。通过该镜像，开发团队可在Bitbucket CI/CD流水线中统一构建环境，确保构建过程的一致性和可重复性。

核心功能与特性

• Maven集成：包含完整的Maven工具链，支持Java项目的编译、测试、依赖管理及打包（如生成JAR、WAR文件）。
• Install4j支持：内置Install4j编译器，可将Java应用程序打包为跨平台的安装程序（支持Windows、macOS、Linux等系统）。
• Bitbucket Pipelines优化：镜像配置适配Bitbucket流水线环境，可直接作为构建步骤集成到bitbucket-pipelines.yml配置中。
• 环境一致性：统一的构建环境避免因本地环境差异导致的构建问题，提升团队协作效率。

使用场景

• Bitbucket托管的Java项目，需通过CI/CD流水线实现自动化构建。
• 需要使用Install4j生成标准化安装程序的Java应用（如桌面应用、企业级软件）。
• 团队协作中需确保构建流程统一、可复现的场景。

使用方法

基本使用（Docker Run）

通过以下命令启动容器，挂载本地项目目录并执行构建/打包操作：

bash
docker run -v /path/to/your/project:/app \
  bitbucket.org/nanometrics/docker-maven-install4j:latest \
  sh -c "mvn clean package && install4j /app/path/to/your/install4j-project.ijp"

Bitbucket Pipelines配置

在项目根目录的bitbucket-pipelines.yml中集成该镜像，示例配置如下：

yaml
image: bitbucket.org/nanometrics/docker-maven-install4j:latest

pipelines:
  default:
    - step:
        name: Build and package with Install4j
        script:
          - mvn clean install -DskipTests  # 使用Maven构建项目
          - install4j ./src/main/install4j/your-project.ijp  # 使用Install4j生成安装程序
        artifacts:
          - target/*.jar  # 保留Maven构建产物
          - out/*.exe  # 保留Install4j生成的安装程序（根据目标平台调整）

关键参数说明

• Maven参数：可通过mvn命令行参数自定义构建行为（如-DskipTests跳过测试、-Pprofile指定构建配置文件）。
• Install4j项目文件：需提供.ijp格式的Install4j项目文件路径，该文件定义安装程序的配置（如目标平台、安装步骤、资源文件等）。
• 数据卷挂载：通过-v参数挂载本地项目目录到容器内/app路径，确保项目文件可被Maven和Install4j访问。

注意事项

• 确保Install4j项目文件（.ijp）中引用的资源路径与容器内项目结构一致。
• 如需使用特定版本的Maven或Install4j，可通过镜像标签指定（如:maven-3.8.5-install4j-10.0，具体标签需参考镜像仓库说明）。
• 在Bitbucket Pipelines中使用时，需确保流水线权限允许访问该镜像仓库。