如何利用Maven配置为JavaFX应用构建多环境专属.exe程序？

嘿，太懂你这种手动改配置打包怕搞混的痛苦了！我之前帮团队处理过几乎一样的需求，用Maven Profiles配合JavaFX打包插件就能完美解决，全程自动化，再也不用担心错发版本。咱们一步步来：

先在你的pom.xml里添加三个环境的Profile，把每个环境独有的URL、令牌、版本这些变量都放在对应的Profile里，这样切换环境只需要指定Profile就行，不用手动改代码：

<profiles>
    <!-- 开发环境，默认激活 -->
    <profile>
        <id>dev</id>
        <properties>
            <app.env>development</app.env>
            <app.api.url>https://dev-api.example.com</app.api.url>
            <app.auth.token>dev-token-123</app.auth.token>
            <app.version>1.0.0-SNAPSHOT</app.version>
        </properties>
        <activation>
            <activeByDefault>true</activeByDefault>
        </activation>
    </profile>
    <!-- 测试环境 -->
    <profile>
        <id>test</id>
        <properties>
            <app.env>testing</app.env>
            <app.api.url>https://test-api.example.com</app.api.url>
            <app.auth.token>test-token-456</app.auth.token>
            <app.version>1.0.0-TEST</app.version>
        </properties>
    </profile>
    <!-- 生产环境 -->
    <profile>
        <id>prod</id>
        <properties>
            <app.env>production</app.env>
            <app.api.url>https://prod-api.example.com</app.api.url>
            <app.auth.token>prod-token-789</app.auth.token>
            <app.version>1.0.0</app.version>
        </properties>
    </profile>
</profiles>

每个Profile的id就是环境标识，properties里的变量对应你需要替换的配置项，默认激活开发环境，避免误操作。

接下来要把这些变量传递到JavaFX打包插件和应用配置里，分两部分：

1. 配置打包插件，生成带环境标识的exe #

用官方的javafx-maven-plugin和maven-jpackage-plugin（负责生成exe），把Profile里的变量关联到打包配置，比如让生成的exe名称带环境后缀，版本也用Profile里的：

<build>
    <plugins>
        <!-- JavaFX jlink插件，生成模块化运行时镜像 -->
        <plugin>
            <groupId>org.openjfx</groupId>
            <artifactId>javafx-maven-plugin</artifactId>
            <version>0.0.8</version>
            <configuration>
                <mainClass>com.yourpackage.MainApp</mainClass> <!-- 替换成你的主类路径 -->
                <version>${app.version}</version> <!-- 应用版本来自Profile -->
                <!-- 开启资源过滤，替换配置文件里的变量 -->
                <resources>
                    <resource>
                        <directory>src/main/resources</directory>
                        <filtering>true</filtering>
                    </resource>
                </resources>
            </configuration>
            <executions>
                <execution>
                    <id>default-cli</id>
                    <phase>package</phase>
                    <goals>
                        <goal>jlink</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>

        <!-- jpackage插件，生成exe安装包 -->
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-jpackage-plugin</artifactId>
            <version>1.4.0</version>
            <executions>
                <execution>
                    <phase>package</phase>
                    <goals>
                        <goal>jpackage</goal>
                    </goals>
                </execution>
            </executions>
            <configuration>
                <input>${project.build.directory}/jlink</input> <!-- 读取jlink生成的镜像 -->
                <dest>${project.build.directory}/jpackage</dest> <!-- exe输出目录 -->
                <name>MyApp-${app.env}</name> <!-- exe名称带环境，比如MyApp-prod.exe -->
                <mainClass>com.yourpackage.MainApp</mainClass>
                <type>exe</type>
                <vendor>YourCompany</vendor> <!-- 替换成你的公司名称 -->
                <!-- 可以加图标、安装选项等，根据需要配置 -->
            </configuration>
        </plugin>
    </plugins>
</build>

2. 让应用读取Profile生成的配置 #

在src/main/resources下创建一个config.properties文件，用变量占位符对应Profile里的配置：

api.url=${app.api.url}
auth.token=${app.auth.token}
app.version=${app.version}
app.env=${app.env}

因为我们开启了资源过滤，Maven打包时会自动把这些占位符替换成对应Profile的实际值。然后在你的Java代码里读取这个配置文件就行，比如：

Properties props = new Properties();
try (InputStream is = getClass().getResourceAsStream("/config.properties")) {
    props.load(is);
    String apiUrl = props.getProperty("api.url");
    // 其他配置读取逻辑
} catch (IOException e) {
    e.printStackTrace();
}

现在不用手动改pom了，在IntelliJ里就能一键打包对应环境：

1. 打开右侧的Maven面板（找不到的话，点View > Tool Windows > Maven）
2. 展开你的项目，找到Profiles选项，勾选你要打包的环境（比如prod），取消其他环境的勾选
3. 在Maven面板的Lifecycle里找到package，右键点击Run Maven Build
4. 打包完成后，去target/jpackage目录找生成的exe，比如MyApp-prod.exe，名字带环境标识，绝对不会搞混！

或者你也可以直接在IntelliJ的终端里执行命令打包：

• 开发环境：mvn clean package（默认激活dev）
• 测试环境：mvn clean package -P test
• 生产环境：mvn clean package -P prod

为了彻底杜绝错发，再加上这两个小措施：

• 在应用的“关于”窗口里显示当前环境和版本，比如“版本：1.0.0（生产环境）”，打包后打开应用就能验证是不是对应环境
• 用Maven的enforcer-plugin加个规则，生产环境打包必须明确指定-P prod，防止误点默认打包生成生产版本

这样一套流程下来，完全不用手动改任何配置，切换环境只需要点一下或者输个参数，生成的exe还带环境标识，再也不用担心错发版本啦！

内容的提问来源于stack exchange，提问作者João Costa