kkFileView 如何用 dev.sh 以资源热加载方式启动服务并修改前端预览模板【免费下载链接】kkFileViewUniversal File Online Preview Project based on Spring-Boot项目地址: https://gitcode.com/GitHub_Trending/kk/kkFileView当你需要调整 kkFileView 的前端预览页面——修改 Freemarker 模板.ftl或预览页用到的 CSS/JS并希望在浏览器里马上看到效果而不是每次改动都重新打包 jar——仓库内置的dev.sh就是为此准备的启动方式。它会以资源热加载resource hot reload方式运行 Spring Boot 服务使server/src/main/resources/web/下的模板改动在刷新页面后即可生效。适用前提本机已安装 JDK 21 与 Mavenpom.xml 中java.version为 21且dev.sh通过 Maven 启动应用。启动前的准备JDK 21pom.xml 将java.version、maven.compiler.source/target均设为 21编译与运行都需要对应版本。Mavendev.sh 最终执行的是mvn spring-boot:run需要mvn在 PATH 中可用。脚本自身会做一件事如果设置了JAVA_HOME会把$JAVA_HOME/bin加到 PATH 前面确保用你指定的 JDK。Office 组件按需README 快速开始说明Office 文件预览依赖 OpenOffice 或 LibreOffice——Windows 下已内置Linux 脚本启动模式会自动安装Mac OS 下需要手动安装。如果你只改模板界面而不实际转换 Office 文档可以跳过这项。用 dev.sh 启动服务在仓库根目录执行./server/src/main/bin/dev.sh脚本内容很短逐行看它的动作见 dev.sh#!/bin/bash set -e ROOT_DIR$(cd $(dirname $0)/../../../.. || exit 1; pwd) SERVER_DIR$ROOT_DIR/server if [ -n $JAVA_HOME ]; then export PATH$JAVA_HOME/bin:$PATH fi cd $SERVER_DIR || exit 1 mvn spring-boot:run \ -Dspring-boot.run.addResourcestrue \ -Dspring-boot.run.jvmArguments-Dfile.encodingUTF-8 -Dspring.config.location$SERVER_DIR/src/main/config/application.properties三个关键点-Dspring-boot.run.addResourcestrueAGENTS.md 明确把这套组合spring-boot:runaddResourcestrueapplication.properties描述为带资源热加载的启动方式并建议在修改前端模板或 CSS/JS 时优先使用dev.sh而不是反复重建 jar。配置文件被显式固定-Dspring.config.location指向 application.properties。AGENTS.md 特别提醒仓库默认指向application.properties如果某环境改用test.properties属于环境级覆盖改动配置不生效时先确认实际启动命令用的是哪个配置文件。模板加载配置application.properties中 FreeMarker 相关配置为spring.freemarker.template-loader-path classpath:/web/、spring.freemarker.cache false、spring.freemarker.suffix .ftl。模板缓存关闭配合 dev.sh 的热加载启动server/src/main/resources/web/下的.ftl改动无需重新打包即可被重新读取。确认服务启动成功启动后访问http://127.0.0.1:8012/AGENTS.md 给出的默认本地地址。按 README.cn.md 快速开始的说明看到首页界面即代表服务启动成功。端口默认 8012可通过环境变量KK_SERVER_PORT覆盖见application.properties中server.port ${KK_SERVER_PORT:8012}覆盖后请改用对应端口访问。修改前端预览模板模板位于server/src/main/resources/web/目录。AGENTS.md 列出的主要预览模板与用途如下模板文件用途compress.ftl压缩包目录树预览页pdf.ftlPDF 预览容器页picture.ftl单张图片预览页officePicture.ftlOffice/PDF 图片模式预览页officeweb.ftl前端 xlsx/html 预览页修改前有一条来自 AGENTS.md 的硬性建议先确认预览流程实际选用的是哪一个模板不要假设两个相似的预览页面共享同一套 CSS 或行为。例如 PDF 预览走pdf.ftl单张图片走picture.ftlOffice 图片模式走officePicture.ftl它们是相互独立的页面。选定模板后直接编辑保存然后刷新浏览器中的预览页面即可看到效果——这就是选择 dev.sh 的原因不必执行mvn package再重启。验证修改生效AGENTS.md 给出的预览相关改动验证清单按适用项逐条核对目标 URL 返回200选中的模板是预期中的那一个目标 UI 元素或样式改动确实存在于渲染后的 HTML 中。如果改动触及 PDF 预览的兼容性逻辑AGENTS.md 还给出了定向 Java 测试的示例命令mvn -q -pl server -DtestPdfViewerCompatibilityTests test需要跑端到端检查时见 tests/e2e/README.md。边界与替代启动方式外部文件预览受限application.properties中trust.host默认未配置白名单配置注释说明不配置时系统默认拒绝所有外部文件预览请求当前默认值仅用于本机测试。如果你用外部地址的 URL 验证预览页却打不开先检查这一项再怀疑模板改动。非热加载路径mvn -q -pl server -DskipTests package用于打包 jarAGENTS.md 的 Jar build 一节。这是部署或整体验证用的构建方式日常改模板时不应走这条路否则每次都要重新打包重启。按上述路径一次典型操作是./server/src/main/bin/dev.sh启动 → 访问http://127.0.0.1:8012/确认首页 → 定位到实际被选用的.ftl并修改 → 刷新预览页按200 / 模板正确 / 改动在渲染 HTML 中三条核对结果。【免费下载链接】kkFileViewUniversal File Online Preview Project based on Spring-Boot项目地址: https://gitcode.com/GitHub_Trending/kk/kkFileView创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考