【React UI环境搭建】Webpack 4

  • 整个项目只用ts,不用js;

  • 推荐用yarn,尽量不用npm;

  • 把yarn设置下淘宝源,下载会快很多,yarn config set registry https://registry.npm.taobao.org

  • package.json中版本号前面~和^的区别

  • /dist/*dist下的所有文件都是不提上去的,要写到.gitignore里;

  • 有一个比较疑惑的点,每次新安装依赖,再npx webpack-dev-server的时候,都要报错“Cannot find module 'webpack-cli/bin/config-yargs'”,是因为webpack-cli版本号需要是@3.x.x的,但是此时webpack-cli是@3.x.x啊,所以只能先移除再安装一下!!!就能正常开启服务了;

  • yarn.lock文件是干什么用的? 答:1. yarn.lock是yarn.lock文件;2. 它锁住了所安装依赖的版本号;

步骤

1、创建目录和远程仓库
  • 创建图上三个文件;
  • 再git clone这个仓库;


    image.png
2、npm 初始化
  • npm init -y, -y就是在init的时候省去了敲回车的步骤,生成的默认的package.json;
3、安装webpack(去官网看如何安装)
  • 目前webpack已经到5了,所以安装的时候我们要把版本号带上,和课程中保持一致; yarn add webpack@4.29.6 webpack-cli@3.2.3 --save-dev
4、新建lib/index.tsx
  • 因为我们写的是一个库,库文件都写在lib目录下;
  • 但是这时webpack还不知道该怎么去编译tsx文件;所以下面我们就添加一个webpack.config.js来配置webpack;
5、新建webpack.config.js

①配置entry
②配置output
③配置module.rules
a. 安装awesome-typescript-loader来编译ts(yarn add awesome-typescript-loader --dev
④配置plugins

6、配置 tsconfig.json 和 tslint.json
  • tsconfig.json 和 tslint.json的内容可以直接抄别人的;
  • 此时已经可以打包,把index.tsx变成index.js了!!!(运行npx webpack
7、配置webpack-dev-server(yarn add webpack-dev-server --dev
  • 因为虽然可以把index.tsx打包成index.js,但是我们不可能改动一下就npx webpack一下啊,需要它可以自动编译,所以就需要安装webpack-dev-server了;
  • webpack是把index.tsx变成index.js,从文件变成文件;
  • webpack-dev-server,则是开一个server,监听8080端口,同时把index.tsx变成index.js,且把index.js以字符串的形式存在内存里;放内存里的原因是这样会更快;
8、配置html-webpack-plugin(yarn add html-webpack-plugin --dev
  • 如果我们把webpack.config.js中entry的文件名改成其他的,例如entry: { dd: '.....'}(dd就是定义的入口名字),那index.html中js的引入我们要重新再改写一次吗?
  • 当然不是!!!index.html中那句引入语句我们就不写,安装html-webpack-plugin插件,它会自动填入js引入;
  • 这时,再运行npx webpack-dev-server,就会显示出index.html了,且自动把index.js引入了;
  • 下图中,把index.js的输出名字改成了win,在webpack.config.js中改;


    image.png

    image.png
9、定义一下快捷命令
  • 就可以直接yarn startyarn build
    image.png
10、安装react和react-dom
  • yarn add react react-dom,不用加--dev,因为用户也需要用到它们,注意版本号;
  • 这时报错Could not find a declaration file for module 'react',是因为ts项目中除了要安装react、react-dom,还需要安装它们的类型声明文件,yarn add @types/react、@types/react-dom --dev
  • !!!这里一定要注意,它们的版本号,如果后面有bug了,一定记得查看是否是版本号的问题!!!
  • 这里一个很神奇的bug就是即使安装完@types/react和@types/react-dom,yarn start也是失败的。但是!!!做完下面一步,分别配置webpack文件,安装完依赖cross-env,再yarn start竟然成功了!!!
11、配置 webpack.config.prod.js和webpack.config.dev.js(具体内容看下面第4条)
12、移动index.d.tsx文件
image.png
13、配置单元测试
  • react社区最流行的测试就是jest,文档:https://jestjs.io/zh-Hans/
  • jest不支持ts,所以我们需要安装ts-jest;
  • jest.config.js需再配置一边webpack里的东西,因为jest不会去读取webpack里的东西;

yarn add --dev jest@24.3.1 babel-jest@24.3.1 @babel/preset-env@7.3.4 @babel/preset-react@7.0.0 react-test-renderer@16.8.4
②配置babel.config.js或者.babelrcbabel.config.js.babelrc的区别是什么);
yarn add --dev ts-jest@24.0.0
④package.json中,"test": "cross-env NODE_ENV=test jest --config=jest.config.js --runInBand",
⑤配置jest.config.js文件;
⑥必须要创建test/setupTests.js文件,否则yarn test报错;

image.png

yarn add @types/jest@24.0.9 --dev
⑧配置tsconfig.test.json文件;
yarn add --dev react-test-renderer@16.8.4 @types/react-test-renderer@16.8.1

  • 最后出了这个报错,于是又安装了tslib,再yarn test就成功了(但是课程中没有这个报错);


    image.png
image.png

image.png

知识要点

1、npx xxx
  • npx:先在当前目录下找此模块运行,找不到就到全局找,全局找不到就直接安装(但是它的安装位置不在node_modules下,所以最好不要用npx来自动下载安装)
2、组件文件里也要引入React!!!
  • 时刻记住,你在return中写的<div></div>不是标签!!!是JSX!!!
    image.png
3、关于打包后的大小
  • mode为production时,index.html文件有200多k,但这时会很有警告,因为生产环境下的文件有大小限制; mode为development时,index.html有1.2M,但没有警告,因为它看你是开发环境,所以允许你的体积大一些;
  • 要想办法打包的时候不把react给打包进去,因为用户既然要用我这个UI库,那么他肯定是基于react的,他自己就会安装react;
  • 于是就需要进行两步:
    ①mode为production;
    ②在webpack配置文件中,添加externals属性,它就告诉webpack,里面的库你不要给我打包进来;
  • 到这里又会有一个问题,难道每次要改来改去吗,开发的时候是development,部署的时候是production?
4、webpack.config.dev.js和webpack.config.prod.js
  • webpack.config.dev.js是开发是用的;
  • webpack.config.prod.js是打包时用的;
  • webpack.config.js是webpack的共用配置;
  • 最后在package.json中修改一下start和build使用的webpack文件;(cross-env是一个跨平台的库,保证你的变量在各个平台都能被理解;)
5、每个目录的作用
image.png
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,732评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 87,496评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,264评论 0 338
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,807评论 1 277
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,806评论 5 368
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,675评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,029评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,683评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 41,704评论 1 299
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,666评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,773评论 1 332
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,413评论 4 321
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,016评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,978评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,204评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,083评论 2 350
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,503评论 2 343

推荐阅读更多精彩内容