orgchart架构图 头像 架构图绘图软件_idea zip怎么安装


一、前言

在平常的工作中画一些架构图,流程图应该是再正常不过了,画图的工具也是根据每个人的喜好进行选择,有的选择Visio,有的选择PowerDesigner,还有直接用在线的processOn等。这些工具各有优劣,都能实现画图的目标。但也有一些不足,比如:如何跟团队其他成员进行共享?目前看只能拷贝源文件或复制链接,如何进行版本控制?因为画图也是一个不断迭代的过程,也会有回到之前历史版本的情况。那么今天要跟大家介绍的这个画图软件,就是基于代码进行绘制,也就是现在所说的Diagrams as code,能够和代码一样放在像Git这样的版本控制系统中,团队成员签出代码的同时就签出了这些架构图,架构图类似上图所示,是不是很赞!

这个图是采用PlantUML+C4 Model+graphviz绘制的,下面就介绍一下如何在IDEA里进行集成。

二、环境集成

1、前置条件

必须安装JDK和IDEA。

我的版本是JDK8和IDEA 2019.3.2(Ultimate Edition)

2、安装PlantUML插件

在IDEA的File——>Settings...——>Plugins,在插件这里搜索PlanUML,选择PlanUML integration进行安装,安装完后重启IDEA使插件生效。


orgchart架构图 头像 架构图绘图软件_graphviz安装_02

安装PlantUML插件


3、安装graphviz绘图工具

如果不安装graphviz,那么使用plantUML语法编写的代码不能生成图形,会显示如下报错信息:


orgchart架构图 头像 架构图绘图软件_idea zip怎么安装_03

显示异常


①下载https://graphviz.gitlab.io/_pages/Download/windows/graphviz-2.38.zip

②解压到一个文件夹下,比如D:softwaregraphviz-2.38

③设置环境变量GRAPHVIZ_DOT


orgchart架构图 头像 架构图绘图软件_orgchart架构图 头像_04

环境变量


4、IDEA中配置graphviz

在IDEA的plantUML中设置graphviz的执行文件dot.exe


orgchart架构图 头像 架构图绘图软件_graphviz安装_05

配置dot路径


创建一个test.puml文件,验证是否配置成功,内容如下:


orgchart架构图 头像 架构图绘图软件_idea配置gitlab_06

测试成功


从右侧的内容可以看出,PlantUML和graphviz安装成功了。到这一步,可以使用PlantUML来绘制一些图形了,比如:时序图,组件图等,如下所示:


orgchart架构图 头像 架构图绘图软件_idea zip怎么安装_07

plantUML原生图


这样的图形也能满足我们的需求,只是看起来不够美观,下面就与C4 Model进行集成。

5、集成C4 Model

要集成C4 Model需要将`C4.puml`、`C4_Context.puml`、 `C4_Container.puml` 和`C4_Component.puml`文件拷贝到代码里,存放到一个能够找到的路径下。这几个文件在官方的代码库里,地址为:

https://github.com/RicardoNiepel/C4-PlantUML.git

下面添加一个样例代码,验证是否OK。注意:这几个文件中使用了域名,国内访问不了,因为已经下载到本地,改成相对路径即可。

@startuml Basic Sample!include ../c4/C4_Container.pumlPerson(admin, "Administrator")System_Boundary(c1, "Sample System") {    Container(web_app, "Web Application", "C#, ASP.NET Core 2.1 MVC", "Allows users to compare multiple Twitter timelines")}System(twitter, "Twitter")Rel(admin, web_app, "Uses", "HTTPS")Rel(web_app, twitter, "Gets tweets from", "HTTPS")@enduml

最后生产的图形如下,和开始的架构图的样式一样,通过这种方式绘制的架构图,是不是很专业啊。


orgchart架构图 头像 架构图绘图软件_idea zip怎么安装_08

C4 Model版的架构图