文章详情

短信预约-IT技能 免费直播动态提醒

请输入下面的图形验证码

提交验证

短信预约提醒成功

一篇非常 Nice 的 UmiJS 教程

2024-12-02 15:01

关注

umi介绍

Umi 是什么?

Umi,中文可发音为乌米,是可扩展的企业级前端应用框架。Umi 以路由为基础的,同时支持配置式路由和约定式路由,保证路由的功能完备,并以此进行功能扩展。然后配以生命周期完善的插件体系,覆盖从源码到构建产物的每个生命周期,支持各种功能扩展和业务需求。

Umi 是蚂蚁金服的底层前端框架,已直接或间接地服务了 3000+ 应用,包括 java、node、H5 无线、离线(Hybrid)应用、纯前端 assets 应用、CMS 应用等。他已经很好地服务了我们的内部用户,同时希望他也能服务好外部用户。

它主要具备以下功能:

什么时候不用 umi?

如果你,

Umi 可能不适合你。

为什么不是?

create-react-app

create-react-app 是基于 webpack 的打包层方案,包含 build、dev、lint 等,他在打包层把体验做到了极致,但是不包含路由,不是框架,也不支持配置。所以,如果大家想基于他修改部分配置,或者希望在打包层之外也做技术收敛时,就会遇到困难。

next.js

next.js 是个很好的选择,Umi 很多功能是参考 next.js 做的。要说有哪些地方不如 Umi,我觉得可能是不够贴近业务,不够接地气。比如 antd、dva 的深度整合,比如国际化、权限、数据流、配置式路由、补丁方案、自动化 external 方面等等一线开发者才会遇到的问题。

umi3项目初始化

环境准备

首先得有 node,并确保 node 版本是 10.13 或以上。

推荐使用 yarn 管理 npm 依赖

本项目使用的版本为 node v14.17.5  yarn 1.22.15

脚手架

桌面新建umi3文件夹, 用vscode打开, 打开vscode终端,

执行 yarn create @umijs/umi-app 创建项目

安装依赖 yarn

启动项目 yarn start

配置 prettier,eslint, stylelint

umi 维护了一个 prettier,eslint,stylelint 的配置文件合集 umi-fabric 

  1. yarn add @umijs/fabric -D 

根目录新建下面三个文件,删除.prettierrc文件

.eslintrc.js、.prettierrc.js、.stylelintrc.js

配置如下 

  1. //.eslintrc.js 配置  
  2. module.exports = {  
  3.   extends: [require.resolve('@umijs/fabric/dist/eslint')],  
  4.   // in antd-design-pro  
  5.   globals: {  
  6.     ANT_DESIGN_PRO_ONLY_DO_NOT_USE_IN_YOUR_PRODUCTION: true,  
  7.     page: true,  
  8.   }, 
  9.   rules: {  
  10.     // your rules  
  11.     'prefer-const': 0,  
  12.   },  
  13. };  
  14. //.prettierrc.js 配置  
  15. const fabric = require('@umijs/fabric')  
  16. module.exports = {  
  17.   ...fabric.prettier,  
  18.   semi: false,  
  19.  
  20. //.stylelintrc.js 配置  
  21. const fabric = require('@umijs/fabric')  
  22. module.exports = {  
  23.   ...fabric.stylelint,  

根目录新建eslint忽略文件  .eslintignore 

  1. .eslintrc.js  
  2. node_modules 

在package.json 里面的lint-staged 新增 "eslint --fix"

最后你的 vscode 要安装这三个同名扩展插件,这时候分别去更改 js、less 文件,会发现已经有风格校验了。

验证

修改src/paegs文件夹下的index.tsx文件,新增一个a变量,有eslint错误提示,说明eslint生效了

然后再单独提交index.tsx这一个文件

会提示有错误,无法提交,说明pre-commmit 钩子生效

保存时自动格式化代码

在vscode设置 文本编辑器的格式化里面  勾选Format on Save

我的eslint,或者prettier 不生效?

去到终端里的输出,找到eslint或者prettier 看他们的输出日志,是否正常。如果有报错,根据报错信息处理问题

检查步骤:

pre-commit时的lint-staged 不生效

在package.json中 我们配置了如下得代码

意思是 在代码commit之前 执行prettier格式化代码和eslint fix 如果你在提交代码的时候没有生效,请执行

  1. yarn install --force 

执行这个命令重新拉取依赖

不生效的原因?

自己刚开始也是各种google,查看文档,也没有找出原因,最后在umi2的一个issue里面,自己找到了答案。

原因在于我们初始化git仓库的顺序,如果我们先初始化git仓库 然后再创建项目,再拉取依赖。是没有任何问题的。

如果我们先创建了umi项目,拉去依赖,最后初始化git,提交代码到git仓库,当我们拉去依赖时, 这是就还没有.git 就没有生成相关的pre-commit,所以就没有生效。所以这时我们就只需要在重新拉取下依赖就可以了。

配置css初始化代码

为什么要初始化css

建站老手都知道,这是为了考虑到浏览器的兼容问题,其实不同浏览器对有些标签的默认值是不同的,如果没对CSS初始化往往会出现浏览器之间的页面差异。当然,初始化样式会对SEO有一定的影响,但鱼和熊掌不可兼得,但力求影响最小的情况下初始化。

最简单的初始化方法就是:* {padding: 0; margin: 0;} 。有很多人也是这样写的。这确实很简单,但有人就会感到疑问:*号这样一个通用符在编写代码的时候是快,但如果网站很大,CSS样式表文件很大,这样写的话,他会把所有的标签都初始化一遍,这样就大大的加强了网站运行的负载,会使网站加载的时候需要很长一段时间。

CSS初始化是指重设浏览器的样式。不同的浏览器默认的样式可能不尽相同,所以开发时的第一件事可能就是如何把它们统一。如果没对CSS初始化往往会出现浏览器之间的页面差异。每次新开发网站或新网页时候通过初始化CSS样式的属性,为我们将用到的CSS或html标签更加方便准确,使得我们开发网页内容时更加方便简洁,同时减少CSS代码量,节约网页下载时间。

Umi 中约定 src/global.css 为全局样式,如果存在此文件,会被自动引入到入口文件最前面。

src下面新建global.css,代码如下 

  1. body,  
  2. ol,  
  3. ul,  
  4. h1,  
  5. h2,  
  6. h3,  
  7. h4,  
  8. h5,  
  9. h6,  
  10. p,  
  11. th,  
  12. td,  
  13. dl,  
  14. dd,  
  15. form,  
  16. fieldset,  
  17. legend,  
  18. input,  
  19. textarea,  
  20. select,  
  21. figure,  
  22. figcaption {  
  23.   margin: 0;  
  24.   padding: 0;  
  25. li {  
  26.   list-style-type: none;  
  27.  
  28. a {  
  29.   text-decoration: none;  
  30.  
  31. a:hover {  
  32.   text-decoration: underline;  
  33.  
  34. img {  
  35.   border: none;  
  36.  
  37. input {  
  38.   outline: none;  

配置文件

Umi 在 .umirc.ts 或 config/config.ts 中配置项目和插件,支持 es6。

如果项目的配置不复杂,推荐在 .umirc.ts 中写配置;如果项目的配置比较复杂,可以将配置写在 config/config.ts 中,并把配置的一部分拆分出去,比如路由配置可以拆分成单独的 routes.ts

推荐两种配置方式二选一,.umirc.ts 优先级更高。

我们采用config的方式,删除.umirc.ts,根目录新建config文件夹, 在里面新建config.ts

默认内容如下 

  1. import { defineConfig } from 'umi';  
  2. export default defineConfig({ 
  3.   nodeModulesTransform: {  
  4.     type: 'none',  
  5.   },  
  6.   routes: [  
  7.     { path: '/', component: '@/pages/index' },  
  8.   ],  
  9.   fastRefresh: {},  
  10. }); 

多环境多配置文件

可以通过环境变量 UMI_ENV 区分不同环境来指定配置。

为了兼容性,可借助三方工具 cross-env来设置环境变量 

  1. yarn add cross-env --dev 

在package.json中的script中   

  1. "start": "cross-env UMI_ENV=dev umi dev",  
  2.    "start:test": "cross-env UMI_ENV=test umi dev",  
  3.    "start:prd": "cross-env UMI_ENV=prd umi dev",  
  4.    "build": "cross-env UMI_ENV=dev umi build",  
  5.    "build:test": "cross-env UMI_ENV=test umi build",  
  6.    "build:prd": "cross-env UMI_ENV=prd umi build", 

然后再config文件夹下 新建

config.dev.ts,config.test.ts,config.prd.ts

代表开发环境,测试环境,生产环境的配置文件.

config.dev.ts 

  1. import { defineConfig } from 'umi';  
  2. export default defineConfig({ 
  3.   define: {  
  4.     CurrentEnvironment: 'dev',  
  5.   }, 
  6. }); 

config.test.ts 

  1. import { defineConfig } from 'umi';  
  2. export default defineConfig({  
  3.   define: {  
  4.     CurrentEnvironment: 'test',  
  5.   },  
  6. }); 

config.prd.ts 

  1. import { defineConfig } from 'umi';  
  2. export default defineConfig({  
  3.   define: {  
  4.     CurrentEnvironment: 'prd',  
  5.   },  
  6. }); 

CurrentEnvironment 变量代表当前的环境,后面根据不同的环境配置不同的请求地址会用到

用于提供给代码中可用的变量,定义的变量可以全局拿到

这时 执行 yarn start:prd,然后去到pages的index.tsx打印CurrentEnvironment.

这时需要去到根目录的 typings.d.ts 添加 

  1. // 声明当前的环境  
  2. declare const CurrentEnvironment: 'dev' | 'test' | 'prd';  

然后报错消失 控制台打印如下

这时 重新执行yanr start:test 控制台打印如下

环境变量和多环境多配置 成功

**注意点**:

config.ts作为配置文件时,记得删除.umirc.ts 不然config.ts不会生效。

自定义环境变量

如果我们想自定义一个环境变量,REACT_APP_ENV. 同样我们可以在package.json里面设置

然后我们要这样拿到这个变量呢?

首先 我们要在config.ts 的 define 配置 

  1. define: {  
  2.     REACT_APP_ENV: process.env.REACT_APP_ENV,  
  3. }, 

然后再在根目录的 typings.d.ts 定义

  1. declare const REACT_APP_ENV: string; 

这样就可以以在全局中拿到和使用 REACT_APP_ENV这个环境变量了.

可以在任意组件 直接打印

  1. console.log('自定义环境变量', REACT_APP_ENV); 

系统自带的环境变量

官方提供的环境变量

怎么使用?

在根目录新建.env 环境变量配置文件

然后写入 

  1. PORT=3000  // 表示启动的端口号为3000  
  2. COMPRESS = none  // 不压缩 CSS 和 JS 

还有一些环境变量 不能配在 .env 中,只能在命令行里添加

比如 FORK_TS_CHECKER 默认不开启 TypeScript 类型检查,值为 1 时启用。 

  1. "start": "cross-env FORK_TS_CHECKER=1 UMI_ENV=dev umi dev", 

请求的封装

src文件夹下新建 request文件夹 新建request.ts

request.ts 

  1.   
  2. import { extend } from 'umi-request';  
  3. import type { RequestOptionsInit } from 'umi-request';  
  4. import { notification } from 'antd';  
  5. // codeMessage仅供参考 具体根据和后端协商,在详细定义.  
  6. const codeMessage = {  
  7.   200: '服务器成功返回请求的数据。',  
  8.   400: '发出的请求有错误,服务器没有进行新建或修改数据的操作。',  
  9.   500: '服务器发生错误,请检查服务器。',  
  10. };  
  11. type mapCode = 200 | 400 | 500;   
  12.   
  13. const errorHandler = (error: { response: Response }): Response => {  
  14.   const { response } = error;  
  15.   if (response && response.status) {  
  16.     let errorText = codeMessage[response.status as mapCode] || response.statusText;  
  17.     const { status, url } = response;  
  18.     response  
  19.       ?.clone()  
  20.       ?.json()  
  21.       ?.then((res) => {  
  22.         // 后端返回错误信息,就用后端传回的  
  23.         errorText = res.msg ? res.msg : errorText;  
  24.         notification.error({  
  25.           message: `请求错误 ${status}: ${url}`,  
  26.           description: errorText,  
  27.         });  
  28.       });  
  29.   } else if (!response) {  
  30.     notification.error({  
  31.       description: '您的网络发生异常,无法连接服务器', 
  32.       message: '网络异常',  
  33.     });  
  34.   }  
  35.   return response;  
  36. };  
  37.   
  38. const request = extend({  
  39.   errorHandler, // 默认错误处理  
  40.   credentials: 'include', // 默认请求是否带上cookie  
  41. });  
  42. // 根据不同的开发环境,配置请求前缀  
  43. interface ApiPrefix {  
  44.   dev: string;  
  45.   test: string;  
  46.   prd: string;  
  47.  
  48. const apiPreFix: ApiPrefix = {  
  49.   dev: 'http://120.55.193.14:3030/',  
  50.   test: 'http://120.55.193.14:3030/',  
  51.   prd: 'http://120.55.193.14:3030/',  
  52. };  
  53. // request拦截器, 携带token,以及根据环境,配置不同的请求前缀  
  54. request.interceptors.request.use((url: string, options: RequestOptionsInit) => {  
  55.   // 不携带token的请求数组  
  56.   let notCarryTokenArr: string[] = [];  
  57.   if (notCarryTokenArr.includes(url)) {  
  58.     return {  
  59.       url: `${apiPreFix[CurrentEnvironment]}${url}`,  
  60.       options,  
  61.     };  
  62.   }  
  63.   // 给每个请求带上token  
  64.   let token = localStorage.getItem('tokens') || '';  
  65.   let headers = {  
  66.     Authorization: `Bearer ${token}`,  
  67.   };  
  68.   return {  
  69.     url: `${apiPreFix[CurrentEnvironment]}${url}`,  
  70.     options: { ...options, interceptors: true, headers },  
  71.   };  
  72. });  
  73.   
  74. // 封装的get,post.put,delete请求  
  75. const get = async (url: string, parameter?: Record<string, unknown>): Promise<any> => {  
  76.   try { 
  77.     const res = await request(url, { method: 'get', params: parameter });  
  78.     return res;  
  79.   } catch (error) {  
  80.     console.error(error);  
  81.   }  
  82. };  
  83. const deletes = async (url: string, parameter?: Record<string, unknown>): Promise<any> => {  
  84.   try {  
  85.     const res = await request(url, { method: 'delete', params: parameter });  
  86.     return res;  
  87.   } catch (error) {  
  88.     console.error(error);  
  89.   }  
  90. };  
  91. const post = async (url: string, parameter?: Record<string, unknown>): Promise<any> => {  
  92.   try {  
  93.     const res = await request(url, { method: 'post', data: parameter });  
  94.     return res;  
  95.   } catch (error) {  
  96.     console.error(error);  
  97.   }  
  98. };  
  99. const put = async (url: string, parameter?: Record<string, unknown>): Promise<any> => {  
  100.   try {  
  101.     const res = await request(url, { method: 'put', data: parameter });  
  102.     return res;  
  103.   } catch (error) {  
  104.     console.error(error);  
  105.   }  
  106. };  
  107. export default {  
  108.   get,  
  109.   post,  
  110.   put,  
  111.   deletes,  
  112. }; 

这里封装了umi-request,统一处理了接口错误,请求拦截器携带token等.最后在配合useRequest 非常的好用.

umi中使用dva

介绍

包含以下功能,

约定式的 model 组织方式

符合以下规则的文件会被认为是 model 文件,

实际使用

比如在src下新建 models文件夹,里面新建test.ts

test.ts 

  1. import type { Effect, Reducer, Subscription } from 'umi'; // 映入umi 定义好的ts类型  
  2. import axios from '../request/request'; // 引入封装好的网络请求  
  3. // state 接口  
  4. export interface TextModelState { 
  5.   name?: string;  
  6.   testData?: string;  
  7. // test model接口  
  8. export interface TextModelType {  
  9.   namespace: 'testModel';  
  10.   state: TextModelState;  
  11.   effects: {  
  12.     query: Effect;  
  13.   };  
  14.   reducers: {  
  15.     save: Reducer<TextModelState> 
  16.     msg: Reducer<TextModelState> 
  17.   };  
  18.   subscriptions?: { setup: Subscription };  
  19.  
  20. const IndexModel: TextModelType = {  
  21.   namespace: 'testModel',  
  22.   state: {  
  23.     name: '初始名字',  
  24.     testData: '初始testData',  
  25.   },  
  26.   effects: {  
  27.     *query(action, { call, put }) {  
  28.       const getDataTest = async () => {  
  29.         const data = await axios.get('test'); 
  30.         return data;  
  31.       };  
  32.       let testData = yield call(getDataTest); 
  33.       yield put({  
  34.         type: 'msg',  
  35.         data: { testData: testData?.msg },  
  36.       });  
  37.     },  
  38.   },  
  39.   reducers: {  
  40.     save(state) {  
  41.       return {  
  42.         ...state,  
  43.         name: 'jimmy',  
  44.       };  
  45.     },  
  46.     msg(state, action) {  
  47.       return {  
  48.         ...state,  
  49.         testData: action?.data?.testData,  
  50.         testData2: action?.data?.testData2,  
  51.       };  
  52.     },  
  53.   },  
  54. };  
  55. export default IndexModel; 

在src/pages下的index.tsx中使用

index.tsx 

  1. import type { Effect, Reducer, Subscription } from 'umi'; // 引入umi 定义好的ts类型  
  2. import axios from '../request/request'; // 引入封装好的网络请求  
  3. // state 接口  
  4. export interface TextModelState {  
  5.   name?: string;  
  6.   testData?: string;  
  7.  
  8. // test model接口  
  9. export interface TextModelType {  
  10.   namespace: 'testModel';  
  11.   state: TextModelState;  
  12.   effects: {  
  13.     query: Effect;  
  14.   };  
  15.   reducers: {  
  16.     save: Reducer<TextModelState> 
  17.     msg: Reducer<TextModelState> 
  18.   };  
  19.   subscriptions?: { setup: Subscription };  
  20.  
  21. const IndexModel: TextModelType = {  
  22.   namespace: 'testModel',  
  23.   state: {  
  24.     name: '初始名字',  
  25.     testData: '初始testData',  
  26.   },  
  27.   effects: {  
  28.     *query(action, { call, put }) {  
  29.       const getDataTest = async () => {  
  30.         const data = await axios.get('test');  
  31.         return data;  
  32.       };  
  33.       let testData = yield call(getDataTest); 
  34.       yield put({  
  35.         type: 'msg',  
  36.         data: { testData: testData?.msg },  
  37.       });  
  38.     },  
  39.   },  
  40.   reducers: {  
  41.     save(state) {  
  42.       return {  
  43.         ...state,  
  44.         name: 'jimmy',  
  45.       };  
  46.     },  
  47.     msg(state, action) {  
  48.       return {  
  49.         ...state,  
  50.         testData: action?.data?.testData,  
  51.         testData2: action?.data?.testData2,  
  52.       };  
  53.     },  
  54.   },  
  55. };  
  56. export default IndexModel; 

mfsu

启用 mfsu 后,热启动得到 **10 倍** 提升;热更新提升 **50%** 以上!

如何启用

在 config/config.ts 中添加 mfsu:{}

项目源代码

请点击我

和两个小伙伴一起,会根据实际运用中出现的问题或者没有考虑完善的地方,持续的更新迭代.如有问题,欢迎提Issue或者在评论区留言

FAQ

umi 不是内部或外部命令

解决办法

执行 yarn global bin 拿到 bin 路径。然后把这个路径添加到环境变量里面的系统变量的path里面

如果还是不行,执行 

  1. yarn global add umi 

如遇到更多问题,请查考

官方FAQ

官方仓库的issue 

 

来源:前端大全内容投诉

免责声明:

① 本站未注明“稿件来源”的信息均来自网络整理。其文字、图片和音视频稿件的所属权归原作者所有。本站收集整理出于非商业性的教育和科研之目的,并不意味着本站赞同其观点或证实其内容的真实性。仅作为临时的测试数据,供内部测试之用。本站并未授权任何人以任何方式主动获取本站任何信息。

② 本站未注明“稿件来源”的临时测试数据将在测试完成后最终做删除处理。有问题或投稿请发送至: 邮箱/279061341@qq.com QQ/279061341

软考中级精品资料免费领

  • 历年真题答案解析
  • 备考技巧名师总结
  • 高频考点精准押题
  • 2024年上半年信息系统项目管理师第二批次真题及答案解析(完整版)

    难度     813人已做
    查看
  • 【考后总结】2024年5月26日信息系统项目管理师第2批次考情分析

    难度     354人已做
    查看
  • 【考后总结】2024年5月25日信息系统项目管理师第1批次考情分析

    难度     318人已做
    查看
  • 2024年上半年软考高项第一、二批次真题考点汇总(完整版)

    难度     435人已做
    查看
  • 2024年上半年系统架构设计师考试综合知识真题

    难度     224人已做
    查看

相关文章

发现更多好内容

猜你喜欢

AI推送时光机
位置:首页-资讯-后端开发
咦!没有更多了?去看看其它编程学习网 内容吧
首页课程
资料下载
问答资讯