kkFileView源码编译并发布详细教程

概述

官方的描述是：kkFileView为文件文档在线预览解决方案，该项目使用流行的spring boot搭建，易上手和部署，基本支持主流办公文档的在线预览，如doc,docx,xls,xlsx,ppt,pptx,pdf,txt,zip,rar,图片,视频,音频等等
官方文档链接：https://kkview.cn/zh-cn/docs/home.html

为啥要自己进行源码编译

因为从4.0开始，官方就不再提供发行版(就是编译后的，可以直接安装使用的版本）下载，只提供源码。想要发行版就需要加入社群，当然是有偿入群。
当然，开源不易，应该支持这种有偿服务。所以不差钱的人可以不用往下看了，本文主要讲解的是想通过源码自己编译获取发行版的小伙伴。

我不懂Java代码，可以编译吗

可以的，本文介绍的方法，不需要进行Java代码层面的修改，简单点说就是不进行二次开发。最最重要 Apache 协议开源，代码 pull 下来想干嘛就干嘛

为什么写这篇教程

• 首先，kkFileView确实非常优秀，集成到项目里，可以解决90%以上的文档解析（工作中能用的的文件类型基本都支持），用户体验非常好。
• 第二，我在研究过程中发现，网上很少详细的教程，多数教程是教大家如何使用IDE进行代码编译，这就需要Java功底了。
• 第三，编译的过程也是学习的过程，涨知识，学技能，自己动动手丰衣足食（省下￥99）。

废话不多说，下面是详细操作教程

安装JDK

• 需要JDK版本 1.8+以上，我的版本是这个
  
• 安装过程就不啰嗦了，这类教程太多了。

安装Git

• git版本没有严格要求，当然不安装也可以，就需要手动下载源码，然后上传到服务器上了。
• 安装教程也不啰嗦，这类教程也很多。
  

安装Maven

• 这类教程也很多，我用的3.8版本，能正常编译通过，其他版本没有尝试，简单记录以下。
• 下载maven安装包

wget https://dlcdn.apache.org/maven/maven-3/3.8.8/binaries/apache-maven-3.8.8-bin.tar.gz

• Maven 下载后，将 Maven 解压到 /usr/local/maven
• 配置环境变量

vim /etc/profile
以下是内容：包括JDK和Maven两块

export JAVA_HOME=/usr/local/jdk1.8.0_202
export JRE_HOME=${JAVA_HOME}/jre
export CLASSPATH=.:${JAVA_HOME}/lib:${JRE_HOME}/lib:$CLASSPATH
export JAVA_PATH=${JAVA_HOME}/bin:${JRE_HOME}/bin
export PATH=$PATH:${JAVA_PATH}

MAVEN_HOME=/usr/local/maven/apache-maven-3.8.8
export PATH=${MAVEN_HOME}/bin:${PATH}

• 查看maven安装是否正常
  

编译kkFileView源码

• 下载源码

地址：
git clone https://gitee.com/kekingcn/file-online-preview.git
未安装git的自己手动下载，然后上传，后续步骤一样。
码云代码地址：
https://gitee.com/kekingcn/file-online-preview

• 使用maven进行编译

cd file-online-preview/
mvn clean package -DskipTests
然后就是漫长的等待，会自动下载所需的各种依赖，这里要保证你所用的网络要稳定。整个过程根据你机器和网络情况而定，我这里用了40多分钟

• 编译完成后，会提示你编译后的发行版具体目录，有window和Linux2个版本，非常贴心！！！
  

kkFileView安装和使用

编译后获得安装包，进行解压

解压到磁盘空间大的位置，后期kkfile解析文件都将存储在安装目录下file文件夹下。
tar -zxvf kkFileView-4.4.0.tar.gz

修改配置文件

配置文件修改
重点修改：端口号，和文件存储目录，file.dir：原始文件存放位置；Office.home:在线解析的文件存放位置。

修改配置文件
server.port = ${KK_SERVER_PORT:8808}

执行在线安装，下载依赖

进入bin目录，执行安装脚本
安装命令：
sh install.sh

启动并验证服务

进入bin目录，执行
sh startup.sh

浏览器访问

浏览器访问：IP：8808(配置文件设置的端口）

至此，大功告成！！！