Skip to content

Latest commit

 

History

History
76 lines (58 loc) · 5.01 KB

README.md

File metadata and controls

76 lines (58 loc) · 5.01 KB

欢迎访问kiftd源代码资源库!

Welcome to visit source of kiftd!

当前版本:v1.2.3-SNAPSHOT

简介

kiftd——一款便捷、开源、功能完善的个人&团队&小型团队网盘服务器系统。


kiftd-mainpage.png

kiftd能够帮助您快速搭建起一个面向家庭、团队或组织的网盘系统,它操作简单、高效且功能多样。这里是kiftd的源代码资源库,您可以在这里获得kiftd的源代码,并对其进行下载、阅读与重构。

注:如果您仅仅希望得到一份拿来即用的软件,kiftd也提供了一个完整的、解压即用的编译版。您可以根据其说明在3分钟内快速安装并开始使用。如果您需要该版本,请转到以下位置进行浏览和下载: kiftd-官方主页

构建说明

下列条目为kiftd开发环境的基本信息,如需对源代码进行查看及编译,推荐使用所列配置。

  • JDK版本:1.8.0
  • 项目管理框架:Maven(m2e 1.8.0 for Eclipse),Archetype:mavem-archetype-quickstart 1.1。
  • 编码格式:UTF-8
  • 项目资源及配置:Spring Boot+MyBatis+H2 DB,详见pom.xml文档。

快速开始

  • 使用Eclipse(javaEE)以项目方式导入本资源文件夹,并设置构建路径中的JDK版本。
  • 使用Maven选项更新项目,并确保pom文件中引入的所有外部资源能够正确引入至本地。
  • 打开kohgylw.kiftd.mc.MC类,进行测试运行。
  • 右键项目,执行Run with选项中的Maven install操作以在target文件夹内编译生成jar程序。
  • 将生成的jar程序拷贝到项目主目录下(即与libs等文件夹同级)并开始使用。

提示:源代码路径下包含了一些程序运行所需的非源代码资源(例如程序图标等),某些集成式开发环境(例如IDEA)在编译过程中可能会自动忽略非源代码资源。您需要设置并保证这些资源也能够被正确打包至最终的jar程序内,否则将会导致编译出的程序无法顺利运行。

程序基本结构说明

  • 源代码资源文件夹:/src/main/java/
  • 入口类:kohgylw.kiftd.mc.MC
  • web界面请求处理包:kohgylw.kiftd.server.controller、kohgylw.kiftd.server.filter
  • web界面操作逻辑包:kohgylw.kiftd.server.service
  • 核心功能及文件系统实现包:kohgylw.server.util、kohgylw.kiftd.server.listener、kohgylw.kiftd.server.mapper、kohgylw.kiftd.server.model
  • 服务器行为控制类:kohgylw.server.ctl.KiftdCtl
  • 服务器界面相关包:kohgylw.kiftd.ui、kohgylw.kiftd.printer
  • 独立文件管理模块相关包:kohgylw.kiftd.util.file_system_manager
  • 第三方工具使用许可证包:kohgylw.kiftd.util.licenses
  • web页面静态资源文件夹:/webContext/
  • mybatis映射表文件夹:/mybatisResource/
  • 外部引用资源(编译后生成)文件夹:/libs/
  • 引用字体文件夹:/fonts/
  • 设置文件(程序第一次运行后生成)文件夹:/conf/
  • 日志文件夹:/logs/
  • 编译输出文件夹:/target/
  • maven配置文件:/pom.xml

常见问题&解决方案

  • 使用IDEA导入项目后无法以图形界面方式运行

在默认情况下,IDEA可能会自动忽略位于项目源代码路径内的所有非源代码文件,从而导致图形界面需要的某些图标文件(例如png文件)无法被识别和打包。如遇此问题,请修改IDEA设置,确保项目源代码路径下的所有文件均会被识别和打包。

  • 启动源代码项目时出现“Error creating bean with name org.mybatis.spring.mapper.MapperScannerConfigurer”

如遇该问题,请尝试将pom.xml文件中引入的mybatis资源和mybatis-spring资源移除并重新添加mybatis-spring-boot-starter资源,从而避免默认整合方式可能导致的Spring Boot框架插件兼容性问题(特别鸣谢:用户 michael)。

使用许可(下载该源代码资源即视为接受以下许可)

当前版本的kiftd使用自带的许可文件进行分发。您应该先阅读该文件(获取方式:前往kiftd发行版主页下载一份kiftd发行版并在其中获得,详见 https://github.com/KOHGYLW/kiftd ),并在同意其中的所有条款后再下载该源代码。其大致内容如下:

  • 您可以免费获得该源代码的原版拷贝。
  • 您可以自由地对该源代码进行分发、重构并运用于任何领域。
  • 作者对于使用该源代码造成的任何后果均无需负责。
  • 作者对该源代码具有版权。

关于该源代码...

该源代码为目前发布的kiftd解压即用版的原始编译来源,二者保持一致性(有时源码版本可能会略微超前),作者将在今后对其逐步进行整理以便于用户阅读,由此带来的不便敬请谅解。

联系作者?

如有任何需要(例如对该资源有疑问、意见或建议),请发件联系作者: [email protected] (青阳龙野),随时恭候您的来信!

青阳龙野@kohgylw by 2024年07月20日