Skip to content
<

JavaFX 打包 APP 时的配置

使用 jpackage 需要先下载 WIX,并配置环境变量。

工程中的 module-info.java 需要删除,否则非 module 的依赖打包会报错。

总览

插件作用
maven-compiler-plugin指定编译版本
maven-dependency-plugin收集依赖到
maven-jar-plugin将工程打包产物定义为可执行的 jar
maven-resources-plugin复制打包产物到
jpackage-maven-plugin使用 jpackage 打包
xml
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.atoz</groupId>
    <artifactId>FXDemo</artifactId>
    <version>1.0-SNAPSHOT</version>
    <name>FXDemo</name>

    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <junit.version>5.12.1</junit.version>
        <hutool.version>5.8.14</hutool.version>
        <!-- 保存可运行的 App 的临时目录 -->
        <app.dir>${project.build.directory}/libs</app.dir>
    </properties>

    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>cn.hutool</groupId>
                <artifactId>hutool-bom</artifactId>
                <version>${hutool.version}</version>
                <type>pom</type>
                <!-- 注意这里是import -->
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>


    <dependencies>
        <dependency>
            <groupId>org.openjfx</groupId>
            <artifactId>javafx-controls</artifactId>
            <version>17.0.14</version>
        </dependency>
        <dependency>
            <groupId>org.openjfx</groupId>
            <artifactId>javafx-fxml</artifactId>
            <version>17.0.14</version>
        </dependency>

        <dependency>
            <groupId>cn.hutool</groupId>
            <artifactId>hutool-core</artifactId>
        </dependency>

    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.7.0</version>
                <configuration>
                    <source>17</source>
                    <target>17</target>
                </configuration>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-dependency-plugin</artifactId>
                <version>3.6.1</version>
                <executions>
                    <execution>
                        <id>copy-dependencies</id>
                        <phase>package</phase>
                        <goals>
                            <goal>copy-dependencies</goal>
                        </goals>
                        <configuration>
                            <outputDirectory>${app.dir}</outputDirectory>
                            <includeScope>runtime</includeScope>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-jar-plugin</artifactId>
                <version>3.3.0</version>
                <configuration>
                    <archive>
                        <manifest>
                            <addClasspath>true</addClasspath>
                            <mainClass>com.atoz.fxdemo.Launcher</mainClass>
                        </manifest>
                    </archive>
                </configuration>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-resources-plugin</artifactId>
                <version>3.2.0</version>
                <executions>
                    <execution>
                        <id>copy-artifact</id>
                        <phase>package</phase>
                        <goals>
                            <goal>copy-resources</goal>
                        </goals>
                        <configuration>
                            <outputDirectory>${app.dir}</outputDirectory>
                            <resources>
                                <resource>
                                    <directory>${project.build.directory}</directory>
                                    <includes>
                                        <include>${project.build.finalName}.${project.packaging}</include>
                                    </includes>
                                </resource>
                            </resources>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
            <plugin>
                <groupId>org.panteleyev</groupId>
                <artifactId>jpackage-maven-plugin</artifactId>
                <version>1.6.0</version>
                <configuration>
                    <input>${app.dir}</input>
                    <type>APP_IMAGE</type>
                    <name>${project.artifactId}</name>
                    <mainJar>${project.build.finalName}.${project.packaging}</mainJar>
                    <vendor>com.atoz</vendor>
                    <appVersion>1.0</appVersion>
                    <destination>${project.build.directory}/dist</destination>
                    <javaOptions>
                        <option>-Dfile.encoding=UTF-8</option>
                    </javaOptions>
                    <verbose>true</verbose>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

打包可直接运行的程序

xml
<plugin>
    <groupId>org.panteleyev</groupId>
    <artifactId>jpackage-maven-plugin</artifactId>
    <version>1.6.0</version>
    <configuration>
        <input>${app.dir}</input>
        <type>APP_IMAGE</type>
        <name>${project.artifactId}</name>
        <mainJar>${project.build.finalName}.${project.packaging}</mainJar>
        <vendor>com.atoz</vendor>
        <appVersion>1.0</appVersion>
        <destination>${project.build.directory}/dist</destination>
        <javaOptions>
            <option>-Dfile.encoding=UTF-8</option>
        </javaOptions>
        <verbose>true</verbose>
    </configuration>
</plugin>

打包安装的程序

xml
<plugin>
    <groupId>org.panteleyev</groupId>
    <artifactId>jpackage-maven-plugin</artifactId>
    <version>1.6.0</version>
    <configuration>
        <input>${app.dir}</input>
        <type>EXE</type>
        <name>${project.artifactId}</name>
        <mainJar>${project.build.finalName}.${project.packaging}</mainJar>
        <vendor>com.atoz</vendor>
        <appVersion>1.0</appVersion>
        <destination>${project.build.directory}/dist</destination>
        <javaOptions>
            <option>-Dfile.encoding=UTF-8</option>
        </javaOptions>
        <winDirChooser>true</winDirChooser>
        <winMenu>true</winMenu>
        <winShortcut>true</winShortcut>
        <verbose>true</verbose>
    </configuration>
</plugin>