Halo CMS项目改成用Maven构建项目并打包成安装程序

项目名称

Halo

项目介绍

Halo [ˈheɪloʊ]，意为光环。Halo 是一款现代化的个人独立博客系统，给习惯写博客的同学多一个选择。当然，你也可以当成拼音读(哈喽)。

项目来源： Github/Gitee

本文内容

由于习惯使用Maven构建项目，但Halo是基于Gradle 构建的，所以打算小小改动一下，两种方式都能构建，没有太多差别，本文主要讲Maven构建Halo CMS系统。

第一步，把代码克隆下来，先放桌面

 git clone https://gitee.com/halo-dev/halo.git

创建新的SpringBoot项目

Java 版本为 11

预选一下要用到的依赖

打开pom.xml 对照这克隆下来的项目里面的buIld.gradle, 挨个添加依赖

默认是打包jar，有内置的Tomcat，所以暂时不加 Jetty

pom.xml 追加内容

<dependency><groupId>com.google.guava</groupId><artifactId>guava</artifactId><version>31.1-jre</version>
</dependency>
<dependency><groupId>com.upyun</groupId><artifactId>java-sdk</artifactId><version>4.2.3</version>
</dependency>
<dependency><groupId>com.qiniu</groupId><artifactId>qiniu-java-sdk</artifactId><version>7.10.2</version>
</dependency>
<dependency><groupId>com.aliyun.oss</groupId><artifactId>aliyun-sdk-oss</artifactId><version>3.15.0</version>
</dependency>
<dependency><groupId>com.baidubce</groupId><artifactId>bce-java-sdk</artifactId><version>0.10.209</version>
</dependency>
<dependency><groupId>com.qcloud</groupId><artifactId>cos_api</artifactId><version>5.6.80</version>
</dependency>
<dependency><groupId>com.huaweicloud</groupId><artifactId>esdk-obs-java</artifactId><version>3.22.3.1</version>
</dependency>
<dependency><groupId>io.minio</groupId><artifactId>minio</artifactId><version>8.4.1</version>
</dependency>
<dependency><groupId>io.springfox</groupId><artifactId>springfox-boot-starter</artifactId><version>3.0.0</version>
</dependency>
<dependency><groupId>commons-fileupload</groupId><artifactId>commons-fileupload</artifactId><version>1.4</version>
</dependency>
<dependency><groupId>org.apache.httpcomponents</groupId><artifactId>httpclient</artifactId>
</dependency>
<dependency><groupId>com.fasterxml.jackson.dataformat</groupId><artifactId>jackson-dataformat-yaml</artifactId>
</dependency>
<dependency><groupId>org.eclipse.jgit</groupId><artifactId>org.eclipse.jgit</artifactId><version>6.1.0.202203080745-r</version>
</dependency>
<dependency><groupId>com.google.code.findbugs</groupId><artifactId>annotations</artifactId><version>3.0.1u2</version>
</dependency>
<dependency><groupId>com.vladsch.flexmark</groupId><artifactId>flexmark-all</artifactId><version>0.64.0</version>
</dependency>
<dependency><groupId>kr.pe.kwonnam.freemarker</groupId><artifactId>freemarker-template-inheritance</artifactId><version>0.4.RELEASE</version>
</dependency>
<dependency><groupId>net.coobird</groupId><artifactId>thumbnailator</artifactId><version>0.4.17</version>
</dependency>
<dependency><groupId>image4j.sf.net</groupId><artifactId>image4j</artifactId><version>0.7</version>
</dependency>
<dependency><groupId>org.flywaydb</groupId><artifactId>flyway-core</artifactId><version>8.5.11</version>
</dependency>
<dependency><groupId>com.google.zxing</groupId><artifactId>core</artifactId><version>3.5.0</version>
</dependency>
<dependency><groupId>io.github.java-diff-utils</groupId><artifactId>java-diff-utils</artifactId><version>4.11</version>
</dependency>
<dependency><groupId>org.iq80.leveldb</groupId><artifactId>leveldb</artifactId><version>0.12</version>
</dependency>

该依赖无法下载

<dependency><groupId>image4j.sf.net</groupId><artifactId>image4j</artifactId><version>0.7</version>
</dependency>

需要添加仓库

<repositories><repository><id>soffid.maven</id><url>http://download.soffid.com/maven</url></repository>
</repositories>

由于JDK11没有tools.jar 包，所以jdk.tools:1.6 报错。本项目暂不需要使用该依赖，故把jdk.tools 排除掉。

修改pom.xml 内容，将jdk.tools 排除

 <dependency><groupId>com.baidubce</groupId><artifactId>bce-java-sdk</artifactId><version>0.10.209</version><exclusions><exclusion><groupId>jdk.tools</groupId><artifactId>jdk.tools</artifactId></exclusion></exclusions></dependency>

把克隆的代码复制到SpringBoot项目中 , 主要是java ,resources 里面的内容，直接粘贴到项目中即可，然后我们需要先下载一个默认halo主题。

git clone https://gitee.com/halo-dev/halo-theme-anatole.git

克隆下载完成，把目录名称改为anatole即可。

直接运行SpringBoot程序

命令太长，点击下方的Shorten the command line and rerun

修改 sql

把 modify 全部替换成 alter column

然后再次启动SpringBoot 项目，即可运行成功

项目启动后，会在用户主目录下创建.halo 文件夹，将主题复制到 templates/themes 下，数据库的路径为 ~/.halo/db/halo。

搭建CMS

打开链接 127.0.0.1:8090 , 开始填写表单。

导入其他的主题，打开官方主题网站 https://halo.run/themes.html

Git克隆下载完成

启用该主题后的效果

如果无法查看评论内容，删除注释符号，然后保存文件。

刷新页面，评论就出来了

后台评论管理页面

如果你需要重新建站，请删除用户目录下的 .halo 文件夹，当然下载的主题也会被删除，记得备份，另外还得删除缓存。再次运行SpringBoot，即可重新进入到建站页面。
还有些小问题，一并解决

        排除slf4j-reload4j

        设置JPA方言

        log4j.properties 配置

log4j.rootLogger = debug,stdout,D,Elog4j.appender.stdout = org.apache.log4j.ConsoleAppender
log4j.appender.stdout.Target = System.out
log4j.appender.stdout.layout = org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern = [%-5p] %d{yyyy-MM-dd HH:mm:ss,SSS} method:%l%n%m%nlog4j.appender.D = org.apache.log4j.DailyRollingFileAppender
log4j.appender.D.File = ./logs/log.log
log4j.appender.D.Append = true
log4j.appender.D.Threshold = DEBUG
log4j.appender.D.layout = org.apache.log4j.PatternLayout
log4j.appender.D.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss}  [ %t:%r ] - [ %p ]  %m%nlog4j.appender.E = org.apache.log4j.DailyRollingFileAppender
log4j.appender.E.File =./logs/error.log
log4j.appender.E.Append = true
log4j.appender.E.Threshold = ERROR
log4j.appender.E.layout = org.apache.log4j.PatternLayout
log4j.appender.E.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss}  [ %t:%r ] - [ %p ]  %m%n

打包成jar

打包的时候，我又把Tomcat排除了，还是选择用Jetty 算了

<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId><exclusions><exclusion><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-tomcat</artifactId></exclusion></exclusions>
</dependency><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-jetty</artifactId>
</dependency>

将jar包整合成exe安装程序

当你不关闭程序，而再次运行程序时，bat脚本会将前一个运行程序已经taskkill 掉，而且，只会kill掉已存在的名称为 halo-java.exe 的程序。

打印 Halo has started successful代表启动成功

访问路径

前端 http://localhost:8090
后端 http://localhost:8090/admin

数据库访问

安装h2数据库

上面这个AVATAR属性可以改成QQ头像链接：http://q1.qlogo.cn/g?b=qq&nk=2371778707&s=640

好了，本文到此结束。

代码，jar，安装程序exe

下载地址：

https://cloud.189.cn/web/share?code=UjURfeuayQbe（访问码：0dci）

安装包200多MB太大，原因就是里面包含了太多无用的Jar包，还加入了JDK11，先就这样吧。