Ant Design Pro入门教程,安装,运行(V5 Typescript版)

【前言】

找了很多Admin模板,最后还是看中了AntDesignPro这个阿里巴巴开源的Admin框架,长这样(还行吧,目前挺主流的):

官网地址:https://pro.ant.design/index-cn

该套模板是使用了React开发框架作为基础,AntDesign(蚂蚁金服开源UI组件库)作为UI库,集成了Dva,Umi,Mock等库,如果不是很了解这些内容,门槛还是比较高的,下面我们梳理一下从零开始运行起来这个项目的过程。

【准备环境】

  1. node js 安装最新版即可
    我的nodejs版本 v12.18.3
  2. npm npm服务器在国外,访问比较慢,可以更换成国内源:
npm config set registry https://registry.npm.taobao.org

当然也可以安装cnpm(采用的国内源),使用时需要npm命令的地方都换成cnpm

npm install -g cnpm --registry=https://registry.npm.taobao.org

【开始整Antd Pro】

Ant Design Pro的安装方式有几种,可以自行选择:

1. git clone(稳定,没啥坑,速度偏慢github)

git clone https://github.com/ant-design/ant-design-pro.git
cd ant-design-pro
npm install
npm start

2. 官网推荐的方法

新建一个空的文件夹作为项目目录,并在目录下执行:

npm create umi

然后等待安装依赖,完毕后会提示选择模板,我们选择第一个 ant-design-pro(完整的pro模板):

 Select the boilerplate type (Use arrow keys)
❯ ant-design-pro  - Create project with an layout-only ant-design-pro boilerplate, use together with umi block.
  app             - Create project with a simple boilerplate, support typescript.
  block           - Create a umi block.
  library         - Create a library with umi.
  plugin          - Create a umi plugin.

选择模板后,会弹出选择版本,我们选择v5(v5默认是typescript版本,也是antd pro的最新开发模式,v4可以选择javascript/typescript两种版本,如果不想用typescript方式,可以选择v4,然后再选择javascript即可。

Ant Design Pro 脚手架将会自动安装...

运行Antd Pro(Ant Design Pro,下文简称Antd Pro)

安装教授架完毕后,执行命令:

npm install
npm start

如果重试几次还报错,可以考虑换cnpm试试,我这就cnpm好使

cnpm install
cnpm start

等待webpack building完成

我们打开浏览器输入 http://localhost:8000 即可看到初始页面,大概长这样:

可能我们想参考官网展示的大量组件的代码,那么,我们如何得到官网这个较为完整的效果呢?

其实很简单,在启动的时候,我们加个参数 fetch:blocks ,会自动安装完整的组件到我们的代码中

cnpm run fetch:blocks

输入命令会执行漫长地下载安装过程,安装完毕后,重新启动即可

【简单介绍一下】

目录结构

Antd Pro 已经为你生成了一个完整的开发框架,提供了涵盖中后台开发的各类功能和坑位,下面是整个项目的目录结构。

├── config                   # umi 配置,包含路由,构建等配置
├── mock                     # 本地模拟数据
├── public
│   └── favicon.png          # Favicon
├── src
│   ├── assets               # 本地静态资源
│   ├── components           # 业务通用组件
│   ├── e2e                  # 集成测试用例
│   ├── layouts              # 通用布局
│   ├── models               # 全局 dva model
│   ├── pages                # 业务页面入口和常用模板
│   ├── services             # 后台接口服务,请求服务端接口的都放在这里
│   ├── utils                # 工具库
│   ├── locales              # 国际化资源
│   ├── global.less          # 全局样式
│   └── global.ts            # 全局 JS
├── tests                    # 测试工具
├── README.md
└── package.json

内置模板

- Dashboard
  - 分析页
  - 监控页
  - 工作台
- 表单页
  - 基础表单页
  - 分步表单页
  - 高级表单页
- 列表页
  - 查询表格
  - 标准列表
  - 卡片列表
  - 搜索列表(项目/应用/文章)
- 详情页
  - 基础详情页
  - 高级详情页
- 结果
  - 成功页
  - 失败页
- 异常
  - 403 无权限
  - 404 找不到
  - 500 服务器出错
- 个人页
  - 个人中心
  - 个人设置
- 图形编辑器
  - 流程图编辑器
  - 脑图编辑器
  - 拓扑编辑器
- 帐户
  - 登录
  - 注册
  - 注册成功

代码结构基本长这样

模板内建了模拟数据、HMR 实时预览、状态管理、国际化、全局路由等等各种实用的功能辅助开发,想要了解更多可以访问官网(目前比较粗糙)

官网地址:https://pro.ant.design/index-cn

posted @ 2020-08-06 11:38  7tiny  阅读(24317)  评论(4编辑  收藏  举报