如何为JavaFX独立应用的.deb（Debian）包设置安装路径

我之前也碰到过一模一样的需求，官方文档确实没明确说明怎么调整Deb包的安装路径，但其实有两种可行的方法能实现把应用部署到/opt/company/apps/${bundle.name}：

方法一：使用隐藏的bundleArgument参数 #

JavaFX的fx:deploy任务其实支持一个没在官方文档里详细提及的linux.deb.installPrefix参数，直接在Maven配置里添加它就能指定基础安装路径。

修改你pom.xml里fx:deploy的配置部分，加入这个bundleArgument：

<plugin>
    <groupId>com.zenjava</groupId>
    <artifactId>javafx-maven-plugin</artifactId>
    <!-- 其他已有配置... -->
    <configuration>
        <deploy>
            <bundleArguments>
                <linux.deb.installPrefix>/opt/company/apps</linux.deb.installPrefix>
                <!-- 你的其他bundle参数... -->
            </bundleArguments>
        </deploy>
    </configuration>
</plugin>

这个参数会把Deb包的基础安装路径设为/opt/company/apps，打包工具会自动把你的bundle.name追加到后面，最终安装路径就是/opt/company/apps/${bundle.name}。

方法二：自定义Debian打包模板（适用于复杂定制需求） #

如果方法一因为JDK版本兼容性等原因不生效，你可以通过自定义Deb打包模板完全掌控安装路径：

1. 提取默认模板：找到你的JDK安装目录下的ant-javafx.jar（一般在${JAVA_HOME}/jre/lib/），解压这个jar包，找到com/sun/javafx/tools/deploy/template/linux/deb目录，把里面的所有文件复制到项目里，比如src/main/resources/deb-template。

2. 修改模板文件：

   • 打开control文件，确保Installed-Size的计算逻辑适配新路径，也可以添加必要的依赖说明。
   • 修改postinst脚本，把安装路径从默认的/opt/${bundle.name}改成/opt/company/apps/${bundle.name}，同时添加创建父目录的命令：

     mkdir -p /opt/company/apps
     cp -r ./* /opt/company/apps/${bundle.name}/
     

   • 调整prerm和postrm脚本里的路径，确保卸载时能正确清理文件。
   • 修改desktop文件中的Exec路径，指向新安装目录下的可执行文件：

     Exec=/opt/company/apps/${bundle.name}/your-app-executable
     

3. 在Maven中指定自定义模板：在pom.xml的fx:deploy配置里添加模板路径：

<plugin>
    <groupId>com.zenjava</groupId>
    <artifactId>javafx-maven-plugin</artifactId>
    <!-- 其他已有配置... -->
    <configuration>
        <deploy>
            <template>${project.basedir}/src/main/resources/deb-template</template>
            <!-- 其他配置... -->
        </deploy>
    </configuration>
</plugin>

验证配置是否生效 #

重新执行mvn clean install生成Deb包后，用以下命令检查包内的文件路径是否符合预期：

dpkg-deb -c target/dist/bundles/your-app.deb

如果看到文件路径都是/opt/company/apps/your-app-name/...，就说明配置成功了。安装后也可以检查/opt/company/apps目录下是否存在你的应用，以及桌面快捷方式能否正常启动。

内容的提问来源于stack exchange，提问作者Danilo Guimaraes