如何在Redmine 5.x中使用PlantUML插件？

直接修改旧插件适配Redmine 5.x #

1. 调整插件兼容性声明 #

找到插件目录下的plugin.rb文件，定位到版本限制的代码行（通常是requires_redmine方法调用），将原有版本上限（比如3.4）修改为5.x，或者直接移除版本上限，示例：

# 原代码
requires_redmine :version_or_higher => '2.0', :version_or_lower => '3.4'
# 修改后
requires_redmine :version_or_higher => '2.0'

2. 适配Redmine API变动 #

Redmine 4.x及以上版本对部分API做了调整，需要针对性修复：

• 视图模板修复：旧插件的ERB模板可能使用了过时的helper方法或路径，检查app/views下的模板文件，替换为Redmine 5.x兼容的语法（比如更新link_to、url_for的参数）
• 权限系统适配：如果插件注册了自定义权限，检查Redmine::AccessControl.map中的权限定义，确保project_module和actions的格式符合Redmine 5.x的要求
• Gem依赖更新：查看插件的Gemfile或依赖声明，将过时的依赖（如旧版plantuml gem）替换为兼容Ruby 2.7+和Redmine 5.x的版本

3. 安装测试 #

修改完成后，执行以下操作：

• 将修改后的插件放入Redmine的plugins目录
• 重启Redmine服务
• 执行缓存清理命令：rails tmp:cache:clear
• 创建测试工单，插入PlantUML代码块验证渲染效果
• 查看log/production.log排查潜在报错

替代方案（更省心） #

如果不想手动修改旧插件，可以选择：

• 寻找该插件的社区维护分支：很多开发者会fork原插件并适配Redmine 4+/5.x，直接安装这些适配后的版本即可
• 使用Redmine插件库中兼容5.x的PlantUML替代插件：选择官方插件库中明确标注支持Redmine 5.x的同类插件

内容的提问来源于stack exchange，提问作者kaorukobo