RuoYi 系统修改项目名和包名
教学视频
以下演示,使用的 前后端分离
版本,当前版本为 3.9.0
,切换到 springboot3
分支。如果是其他的版本,大同小异。
然后克隆到本地,用 IDEA
打开项目。
调整项目名
首先来看看如何调整项目名。以下演示使用的是 my-xxx
的命名规则。
例如将 ruoyi-system
项目调整为 my-system
,右击项目,选择 Rename
。
接下来,选择 Rename module and directory
然后在输入框内填入想重命名的项目名。
点击弹窗的 Refactor
按钮后,就会看到如下图所示。
然后直接点击左下角的 Refactor
即可,这样就会将这个项目相关的配置等内容进行替换。
例如子项目的定义,在根目录的 pom.xml
。
还有其他项目中的项目依赖,例如在 ruoyi-framework
项目中就引入了这个项目。
那么其他的项目也是使用相同的操作,调整后的项目如下图所示。
然后你会发现很多项目依赖标红的地方。
这时候只需要重新编译打包一下就好了。
如果不标红就代表修改项目名成功了,有时候可能需要刷新一下项目。
修改包名
以下演示,以修改为 com.my.xxx
的命名规则。
项目包路径
例如将 ruoyi-system
项目的包路径调整为 com.my.system
,右击包路径,选择 Rename
。
然后在输入框内填写希望调整的包路径名称,同时勾选 Search in comments and strings
那么其他的项目也是使用相同的操作,但是这里在调整 admin
项目的时候需要注意一下,因为我们其他项目的已经处理过了,所以这里只需要选择调整这个目录的就好了。
这里填入需要调整的包名
配置包路径
接下来就需要调整一些配置文件中的包路径,因为有些地方可能通过上面的方法没有调整过来的。
admin 项目
这里需要调整 mybatis
的扫描包路径,例如调整为 com.my.**.domain
日志打印相关的配置
spring doc 的配置
common 项目
这里有一些硬编码的配置
framework 项目
这里需要调整 指定要扫描的Mapper类的包的路径
这里还有一个位置需要确认一下有没有改对,就是验证码的生成器配置,因为刚才上面做整体替换的时候,有可能会改乱
项目运行
上面调整以后,也需要重新编译一下整个项目,也是先 clean,再 package
如果 IDEA
的启动类报错了,就需要调整一下包名,因为在上面做了调整。
接下来,调整 数据库链接 和 redis链接 后,就可以试试运行一下,看看有没有报错的。如果能够看到这个 logo
就代表启动成功了。
然后打开页面看看有没有问题,如果能够刷到验证码出来,那基本上没问题了
如果数据也能够刷出来,那么这次的调整就大功告成了