mominger / blog

Tech blog
45 stars 3 forks source link

Analysis of AntDesign - Basic architecture #42

Open mominger opened 1 year ago

mominger commented 1 year ago

bash_arch

This article written together by me and Cherry

The upper part is the English version, and the lower part is the Chinese version, with the same content. If there are any wrong, or you have anything hard to understand, pls feel free to let me know.many thx.

AntDesign is an enterprise-class UI design language and React UI library, Similar to it is Material-UI or Element React This article is based on AntDesign 4.23.2 At the top is its basic architecture diagram, which will be analyzed layer by layer below AntDesign official website AntDesign source code

1 Directory

directory_source

directory_1

2 Tech stack

tech_stack

AntDesign builds on react-component

3 Component source code

There is planning to choose a few typical components to source code analysis in subsequent articles

4 Compile && Compiled components

Compile with commands in package.json

   "compile": "npm run clean && antd-tools run compile"

Can be found from package-lock.json, antd-tools actually corresponds to node_modules/@ant-design/tools/lib/cli/index.js As below is the specific exploration for the compilation process

Find the package corresponding to antd-tools by package-lock.json ant-tooles_0

ant-tools_1

Compiling by gulpfile ant-tools_2

Compile to ES6/ES5 modular code by gulpfile compile_1

Compile into bundle by webpack compile_2

Compiled component compoile_3

5 Document

doc_discribe

react-styleguidist storybook 的 showcase

5.1 AntDesign Document Library

Use its self-developed bisheng documentation library bisheng mixes markdown and jsx writing. Similar to storybook.

bisheng codes bisheng_1

bisheng_2

bisheng effect bisheng_3

5.1 Story Document Library

Storybook is recommended as it is more welcoming than bisheng. For example, bisheng star 2.8K. But github storybook 74.1k.

Microsoft Fluent Component Library storybook effect

microsoft_1

Microsoft VSCode Webview UI Toolkit microsoft_2

6 Test

Test command test_command

Test configuration, such as setting enzyme, mock, etc. test_set

jest configuration file jest_config

There are unit tests and snapshot tests in each component directory snap_test

7 Code formatting

Formatting codes by eslint+prettier, and execute husky checking before submitting For details, you can check 9. Pre Commit in my other blog post Design a web architecture based on React18+Mobx `

8 CI/CD

ci_cd

Public component libraries, such as AntDesign, Element-react, will be published to npmjs, their source code will be hosted on github, and be publicly available for download and use But the internal component library of the enterprise usually use jFrog + gitlab, which requires authentication to access Travis CI is a CI/CD platform with integrating github. Enterprises usually use gitlab CI/CD or the more powerful jekins.

The following is the Chinese version, the same content as above

bash_arch

AntDesign is an enterprise-class UI design language and React UI library, 与它类似的还有 Material-UI 或 Element React 本文基于 AntDesign 4.23.2 最顶上的是它的基础架构图,会在下面逐层进行分析 AntDesign 官网 AntDesign 源码

1 目录

directory_source

directory_1

2 技术栈

tech_stack

AntDesign 基于 react-component 构建

3 组件源码

会在后续文章选几个典型组件进行源码分析

4 编译 && 编译后的组件

通过 package.json里的命令进行编译

   "compile": "npm run clean && antd-tools run compile"

从package-lock.json 可以找到,antd-tools 实际对应 node_modules/@ant-design/tools/lib/cli/index.js 下面是具体的探索编译的过程

通过package-lock.json 找 antd-tools 对应的 package ant-tooles_0

ant-tools_1

通过gulpfile进行编译 ant-tools_2

编译成 ES6/ES5 模块化代码 compile_1

编译成bundle compile_2

编译后的组件 compoile_3

5 文档

doc_discribe

react-styleguidist storybook 的 showcase

5.1 AntDesign 文档库

用其自研的 bisheng 文档库 bisheng 混合了 markdown和jsx的写法。类似storybook.

bisheng 代码 bisheng_1

bisheng_2

bisheng 效果 bisheng_3

5.1 Story 文档库

建议使用storybook,因为它比bisheng更通用。比如bisheng star 2.8K. 但 github storybook 74.1k.

微软 Fluent 组件库 storybook 效果

microsoft_1

微软Microsoft VSCode Webview UI Toolkit microsoft_2

6 测试

测试命令 test_command

测试的配置,例如设置enzyme,mock等 test_set

jest配置文件 jest_config

每个组件下都有单元测试和快照测试 snap_test

7 代码格式化

通过eslint+prettier进行格式化,以及husky在提交前做检查 具体可以查看我的另一篇博文 Design a web architecture based on React18+Mobx里的 9. Pre Commit

8 CI/CD

ci_cd

一般公共组件库,比如AntDesign,Element-react,都会发布到 npmjs,源码托管到github,公开供人下载使用 但企业内部的组件库,则会采用 jFrog + gitlab, 需要通过鉴权才能访问 Travis CI 是和 github绑定的一个 CI/CD平台,企业一般用gitlab CI/CD 或者更强大的 jekins.