JetBrains插件开发：解决pluginUntilBuild属性不能为空的问题

问题背景

在JetBrains插件开发过程中，开发者通常需要指定插件支持的IntelliJ平台版本范围。这通过pluginSinceBuild和pluginUntilBuild两个属性来实现。过去，开发者可以将pluginUntilBuild留空，表示插件支持所有未来版本。然而，最新版本的IntelliJ平台Gradle插件(2.1.0)不再允许这种做法。

问题表现

当在gradle.properties文件中将pluginUntilBuild属性留空时：

pluginSinceBuild = 223
pluginUntilBuild = 

运行Gradle验证任务时会出现以下错误：

Plugin problems:
Invalid plugin descriptor 'plugin.xml'. The <until-build> attribute with only a branch number () is not valid...
Invalid plugin descriptor 'plugin.xml'. The <until-build> attribute () does not match the multi-part build number format...

解决方案

方法一：使用通配符表示支持所有未来版本

官方推荐的做法是使用.*通配符来表示支持某个分支的所有未来版本：

pluginUntilBuild = 223.*

这表示插件支持从223分支开始的所有版本。

方法二：在build.gradle.kts中动态处理

如果你需要更灵活的控制，可以在构建脚本中动态处理这个属性：

ideaVersion {
    sinceBuild = providers.gradleProperty("pluginSinceBuild")
    if (!providers.gradleProperty("pluginUntilBuild").get().isBlank()) {
        untilBuild = providers.gradleProperty("pluginUntilBuild")
    }
}

这种方法会检查pluginUntilBuild是否有值，只有非空时才设置untilBuild属性。

技术原理

IntelliJ平台对插件兼容性描述有严格要求：

1. 版本号必须符合<branch>.<build_number>.<version>格式
2. 或者使用通配符表示分支范围
3. 空值不再被视为"支持所有版本"的有效表示

这种变化是为了提高插件兼容性声明的明确性，避免因版本范围不明确导致的运行时问题。

最佳实践

1. 明确指定插件支持的版本范围
2. 定期测试和更新插件的兼容性声明
3. 使用通配符时要谨慎，确保插件确实能在该分支的所有版本上运行
4. 考虑使用CI/CD流程自动验证插件在不同版本上的兼容性

总结

JetBrains插件开发中版本兼容性管理是一个重要环节。随着工具链的更新，开发者需要适应新的规范要求。通过本文介绍的解决方案，开发者可以继续灵活地管理插件的版本兼容性，同时满足最新的验证要求。