Xitrum学习笔记02 - 构建 Xitrum 项目

时间:2022-12-26 21:40:23

参考的文档的位置:

1. http://xitrum-framework.github.io/guide/3.28/html/en/  (需要选择合适的版本,我选的是3.28,目前没有中文版)

可以选择Download PDF,下载英文Guide xitrum-en.pdf

2. API ScalaDocs:

http://xitrum-framework.github.io/api.html  选择3.28即可   注意:在国内访问Xitrum官网实在是慢得要死,还请自备FQ软件

另一种查看API ScalaDoc的方式,进入https://github.com/xitrum-framework/xitrum-framework.github.io,Clone and download下载ZIP包

开始自己构建Xitrum项目:

1. 创建一个空的Xitrum项目,需要下载 xitrum-new.zip

wget -O xitrum-new.zip https://github.com/xitrum-framework/xitrum-new/archive/master.zip

curl -L -o xitrum-new.zip https://github.com/xitrum-framework/xitrum-new/archive/master.zip

和xitrum相关的代码放在 https://github.com/xitrum-framework/ 中

2. 解压 xitrum-new.zip,进入 解压缩后的路径 xitrum-new/,运行 sbt/sbt run

此sbt命令,会下载Xitrum所有依赖的jar包,编译项目,运行 quickstart.Boot类,启动web server

浏览器打开 http://localhost:8000/ 或 https://localhost:4430/ 可以进入主页面

3. 把空的 Xitrum 项目导入到 Eclipse中

1)在目录xitrum-new中,运行 sbt/sbt eclipse,会生成了 .project 和 .class 等项目文件

2)打开build.sbt文件,查看所需的scala和java版本

scalaVersion := "2.12.1"

// Xitrum requires Java 8

javacOptions ++= Seq("-source", "1.8", "-target", "1.8")

3)配置Eclipse Scala IDE,

在Windows->Preference下,Scala > Installations, Add 2.12.0的Scala版本(用2.12.1会使3.28.3的Xitrum中的一个jar报错)

                                        在Java配置项下,确认使用的是Java8

然后可以用 eclipse 打开此项目,在 项目Properties > Scala Compiler > Scala Installation中,选择2.12.0的版本,点OK

4)运行quickstart.Boot

如果没有Boot类的运行条目,则在 Run Configuration > Scala中添加一个即可,Main Class是quickstart.Boot

 

5)最终的文件路径结构

Xitrum学习笔记02 - 构建 Xitrum 项目

其中,以下路径及其文件不属于源码,不必放到SVN或Git上,可以被忽略掉

log
project/project
project/target
target
tmp