入门
Halo 提供了一个模板仓库用于创建插件:
- 打开 plugin-starter。
- 点击
Use this template
->Create a new repository
。 - 如图所示填写仓库名后点击
Create repository from template
。
你现在已经基于 Halo 插件模板创建了自己的存储库。接下来,你需要将它 git clone
到你的计算机上并使用 IntelliJ IDEA
打开它。
运行插件
现在有了一个空项目,我们需要让插件能最最小化的运行起来。
这很简单,首先你需要构建插件:只需要在 halo-plugin-hello-world
项目目录下执行 Gradle 命令
./gradlew build
或者使用 IntelliJ IDEA
提供的 Gradle build
即可完成插件项目的构建。
第二步就是使用它。
使用 IntelliJ IDEA
打开 Halo,参考 Halo 开发环境运行。
然后在 src/main/resources
下创建一个 application-local.yaml
文件并做如下配置:
# macOS / Linux
halo:
plugin:
runtime-mode: development
fixed-plugin-path:
# 配置为插件绝对路径
- /Users/guqing/halo-plugin-hello-world
# Windows
halo:
plugin:
runtime-mode: development
fixed-plugin-path:
# 配置为插件绝对路径
- C:\Users\guqing\halo-plugin-hello-world
使用此 local profile 启动 Halo:
# macOS / Linux
./gradlew bootRun --args="--spring.profiles.active=dev,local"
# Windows
gradlew.bat bootRun --args="--spring.profiles.active=dev,win,local"
然后访问 http://localhost:8090/console
在插件列表将能看到插件已经被正确启动,并且在左侧菜单添加了一个 示例分组
,其下有一个名 示例页面
的菜单。