eirslett/frontend-maven-plugin
Frontend Maven Plugin
Dieses Projekt ist ein Maven-Plugin, das Node.js- und npm-Build-Prozesse in den Java-Build-Lebenszyklus integriert. Es fungiert als Build-Orchestrator und Umgebungsmanager und ermöglicht die Ausführung von npm-Skripten und Frontend-Task-Runnern während des Build-Prozesses eines Java-Projekts.
Das Plugin verwaltet das Herunterladen und Entpacken spezifischer Node.js- und npm-Binärdateien in lokale Projektverzeichnisse. Dies stellt konsistente, plattformübergreifende Build-Umgebungen sicher, indem Binärdateien basierend auf dem Host-Betriebssystem und der CPU-Architektur aufgelöst werden, ohne den globalen Systemzustand zu verändern.
Es bietet Orchestrierung für Frontend-Toolchains, einschließlich der Ausführung von Paketmanagern, Test-Runnern und Skriptautomatisierung. Das System unterstützt die Injektion von Umgebungsvariablen, die Konfiguration von Netzwerk-Proxys für eingeschränkte Umgebungen und das Caching von Binär-Downloads, um den Netzwerk-Overhead zu reduzieren.
Die Integration in integrierte Entwicklungsumgebungen bietet Unterstützung für inkrementelle Builds, um unnötige Aufgabenausführungen zu verhindern.
Features
- Build Orchestration Tools - Orchestrates the execution of external frontend task runners and build tools within the Java build process.
- Maven Frontend Integrations - Integrates Node.js and npm build processes directly into the Maven project lifecycle.
- Package Manager Orchestrations - Integrates npm installation and dependency management directly into the Maven build lifecycle.
- Frontend Build Tools - Executes standard frontend utilities for tasks such as minification, packaging, and bundling.
- Build Orchestrators - Triggers JavaScript build tools and test runners like Grunt, Gulp, and Karma during Java builds.
- Local Runtime Provisioning - Automates the installation of specific Node.js runtime versions into local project directories.
- Frontend Build Pipelines - Automates the execution of npm, Grunt, or Gulp scripts to compile assets as part of the Java build.
- Frontend Script Executions - Runs npm and yarn scripts within a controlled environment using pre-configured system paths.
- Maven Frontend Plugins - Provides a Maven plugin that integrates non-Java frontend toolchains into the project lifecycle.
- Cross-Platform Tooling Management - Manages compatible Node.js and npm binaries across different operating systems and CPU architectures.
- Build Environment Configurations - Configures project-specific working directories and environment variables to ensure consistent build outcomes.
- Local Runtime Installations - Provisions specific versions of Node.js and npm into local directories for build consistency.
- Cross-Platform Runtime Support - Provides compatible precompiled binaries across various operating systems and CPU architectures.
- Platform-Specific Artifact Resolution - Automatically resolves the correct Node.js binary based on the host operating system and CPU architecture.
- Node.js Version Managers - Manages the installation and switching of Node.js and npm versions locally within the project.
- Isolated Runtime Directories - Installs runtimes into project-local directories to ensure consistent environments without affecting the global system.
- Lifecycle Phase Binding - Binds frontend tool execution to specific phases of the Maven build lifecycle.
- Binary Download Caches - Caches downloaded Node.js and npm binaries locally to prevent redundant network requests during builds.
- NPM Script Runners - Executes npm installation and custom scripts as part of the Maven build process.
- Runtime Environment Variable Injections - Injects runtime environment variables into the processes that execute frontend build tools.
- Binary Archive Installation - Provides the capability to download pre-built runtime binaries and unpack them into the project directory for immediate use.
- Node.js CI Environment Setups - Provides configuration for Node.js environments in CI pipelines, including network proxy and environment variable settings.
- Shell Environment Injections - Injects custom environment variables and proxy settings into the shell process executing frontend tools.
- Test Execution and Orchestration - Orchestrates the execution of JavaScript test suites with support for skipping tests via build flags.
