相关说明
- IDE:IntelliJ IDEA 或者 (Spring Tools Suite)
- 工具:Gradle, 插件
- JDK:
Halo
项目使用了 Lombok
,运行 Halo
之前请检查 IDE
是否已经安装好了 Lombok
插件。
如果使用的 IDE
是 IntelliJ IDEA
,请在设置中启用 Build, Execution, Deployment/Annotation Processors
的 Enable annotation processing
。
如果仍然因为 Lombok
报错,请更新 IntelliJ IDEA
至最新版。
如果你已经 fork
了 Halo
,请将以下命令中的 halo-dev
替换为你的 Github 用户名
。
这里推荐使用第二种方式进行克隆,这样每次提交代码的时候,就不会提示登录 Github
了。
导入项目的时候请选择 Gradle 项目
进行导入。
如果需要指定配置,请在 内进行设置 VM options
(这里推荐采用上文的),例如:
-Dspring.profiles.active=dev
-Dhalo.auth-enabled=false
-Dhalo.production-env=false
在项目根目录下运行以下命令:
如果需要手动指定配置,可添加 —args
参数(这里推荐采用上文的自定义配置),例如:
# 类 Unix 用户
# Windows 用户
./gradlew.bat bootRun --args="--spring.profiles.active=dev --server.port=2333"
如果一切正常且没有额外指定配置,则可根据控制台的输出链接进行访问 Halo
:
首次运行的时候,会跳转到博客安装页面,请大家耐心填写完毕,最后正式进入开发之旅
。
这里推荐一个配置:
运行命令中添加 VM options
,例如:
-Dspring.profiles.active=dev
IDE
一般都会提供一个 Run/Debug 配置
,可以添加 VM options
和 参数
。以上示例可以直接应用在以命令运行
方式上。
在开发环境下,修改代码之后,每次都需要重启应用,是一个非常耗时的操作。
有一个专门解决这个问题的工具,那就是 ,但是它的费用实在是太昂贵,作为普通的开发者很难承受这笔费用(但不推荐使用破解版)。
于是 Halo
最后采用了 Spring Boot
官方推荐的 Developer Tools。
这里以 为例。
- 进入
Settings
(Preferences on macOS)。 - 打开
Build, Execution, Deployment > Compiler
. 启用Build project automatically
。 - 点击
应用
。 - 按
Ctrl+Shift+A
(Cmd+Shift+A on macOS)快捷键,然后搜索Registry
。打开之后找到compiler.automake.allow.when.app.running
,并启用它 (IntelliJ IDEA 15 and newer)。
来源于
Developer Tools 原理
更多细节请查阅: Automatic Restart