1、概述

1.1、为什么使用appassembler

java程序打成jar包后，简单的使用命令行 java-jar直接来启动应用，但这样很不优雅，部署人员需要自己写脚本，而且也不符合工程化要求。至少这个包打出来后，部署或者安装人员只需要根据实际情况修改配置，直接 start/stop来启动即可。

之前介绍过对于java服务程序，使用jsw和commons-daemon进行服务安装(见我的两篇文章《java服务安装(一)：使用java service wrapper及maven打zip包》和《java服务安装(二)：使用commons-daemon》)，这两种方法对于简单的java服务，相对来讲还是有点繁琐，对于spring boot而言，官方网站推荐 linux脚本和 winsw的方式，也比较繁琐。

后来经过查阅，发现有个appassembler的maven插件，完美解决了服务安装部署包的处理，配置好插件后， mvnpackage即可生成完整部署包，并且适用于linux和windows两种平台。

1.2、appassembler介绍

appassembler官网有介绍，总的来说，它是一个maven插件，用于生成启动关闭应用的脚本，同时集成了相应的需要启动应用的依赖(当然，jdk还是要自己安装的)。它适用于linux平台、windows平台。使用的也是jsw的支持。

1.3、本文主要内容

本文通过一个简单的java应用示例和 appassembler的 maven配置，实现部署安装包的导出。此示例配置也适用于基于spring boot的应用。

2、程序示例

本示例是使用java生成一个文件并写入内容。生成安装部署包后，在 linux下可使用直接 start及 stop启动和关闭。在 windows平台，可以注册为服务，从而以服务的形式启动和关闭。项目结构如下图：

共三个文件 App是启动入口， FileGenerator用于生成文件并输出内容，pom.xml是相应的配置。 App和 FileGenerator比较简单，读者下载示例，看一下知道，不再细说，主要说一下pom.xml的配置项以及打包出来的内容。

3、打包说明

最终打出来部署包的结果如下：

说明：部署包主要分为 bin, etc, lib, logs，这是比较通用的目录了，分别是运行脚本文件目录，配置文件目录，依赖包目录，日志目录。当前目录名称可以修改。

3.1 appassembler配置说明

org.codehaus.mojo

appassembler-maven-plugin

2.0.0

generate-jsw-scripts

package

generate-daemons

flat

true

logs

app1

me.mason.test.app_assembler.App

jsw

jsw

linux-x86-32

linux-x86-64

macosx-universal-64

macosx-universal-32

windows-x86-32

windows-x86-64

configuration.directory.in.classpath.first

etc

set.default.REPO_DIR

lib

wrapper.logfile

logs/wrapper.log

如上配置所示的注释，打包配置相对来说比较简单，指定 appassembler-maven-plugin插件，在 package阶段生成JSW运行脚本。其中，需要指定服务名称、服务主入口类，配置文件目录和依赖文件目录等。

3.2 生成部署包

使用maven打包，命令 mvnpackage，即可生成安装包目录，位置是 target\generated-resources\appassembler\jsw。

安装时，进入到 bin目录下，linux下， chmod+x修改脚本运行权限，执行 app1 start即可启动应用。

windows下，需要以管理员身份运行 app1.bat，使用如下：

rem安装应用为服务

app1.bat install

rem启动服务

app1.bat start

rem关闭服务

app1.bat stop

rem卸载服务

app1.bat remove

4、下载示例

链接: https://pan.baidu.com/s/1An8nJcAIxvtN7ocAnrpW9w 密码: c2ae