Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
38 changes: 38 additions & 0 deletions docs/developer-guide/plugin/api-changelog.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,44 @@ description: 记录每一个版本的插件 API 变更记录,方便开发者

## 2.23.0

### Spring Boot 依赖升级可能导致插件无法正常启动

在 2.23.0 中,我们升级了 Spring Boot 版本至 4.x,该版本包含一些破坏性更新,可能会导致插件无法正常启动,因此建议插件开发者尽快升级 Halo 依赖,`build.gradle` 修改示例如下:

```groovy
repositories {
// TODO Remove this repository once the new version is released
maven {
name = 'Central Portal Snapshots'
url = 'https://central.sonatype.com/repository/maven-snapshots/'

// Only search this repository for the specific dependency
content {
includeGroupAndSubgroups('run.halo')
}
}
mavenCentral()
}

dependencies {
// TODO Change to a released version once available
implementation platform('run.halo.tools.platform:plugin:2.23.0-SNAPSHOT')
}

halo {
version = '2.23.0-beta.2'
}
```

`plugin.yaml` 中的 `spec.requires` 字段也需要提升至 `>=2.23.0`,示例如下:

```yaml
spec:
requires: ">=2.23.0"
```

尝试构建并解决编译错误即可。如果使用了 Spring 相关的组件或者 API,请参考 [Spring Boot 4.x 的升级指南](https://github.com/spring-projects/spring-boot/wiki/Spring-Boot-4.0-Migration-Guide)进行适配。

### 表单定义 > Iconify 表单类型新增 `sizing` 参数

在 2.23.0 中,Iconify 表单类型默认不再显示图标大小选项,如果需要让用户设置图标大小,可以配置 `sizing` 参数,详细文档可查阅:[表单定义#Iconify](../../developer-guide/form-schema.md#iconify)
Expand Down