正式发布一款可cmd命令安装的React.js项目脚手架——FastReactApp

425 阅读6分钟

前言

今天,篇幅可能比较短,主要介绍最近这段时间开发的一款脚手架——FastReactApp。这是一款基于Parcel2 开发的React.js项目脚手架。虽然比不上正在前端界火爆的Vite以及占据稳定地位的CreateReactApp,但是基本的项目开发还是可以的。

下面我将介绍FastReactApp几点特征:

  • 对JS、CSS、HTML、文件资产等的现成支持—不需要插件。
  • 使用dynamic import()语法,它分割输出包,以便您只在初始加载时加载所需的内容。
  • 当您在开发过程中进行更改时,它会自动更新浏览器中的模块,无需配置。
  • 它使用工作进程来支持多核编译,并且有一个文件系统缓存,即使在重新启动后也可以快速重建。
  • 现在生成树震动包的源映射,并在引用未知符号时显示友好的错误消息。
  • 它对React Fast Refresh有一流的支持。它(在大多数情况下)能够在重新加载之间保持状态(即使在发生错误之后)。

我们定义FastReactApp这个名字,你会看到Fast这个单词,中文意思是“快”,那到底有多快呢?我们来检验一下。

我们先来看下初始化时安装依赖需要多长时间。

截屏2021-04-24 19.26.22.png

仅仅使用了4.80s

那么,我们接下来看下热重载的时间。

截屏2021-04-24 20.15.28.png

也仅仅使用了499ms,是不是觉得特别快。

这全仅仅是Parcel2 的功劳,它使用工作进程来支持多核编译,并且有一个文件系统缓存,即使在重新启动后也可以快速重建。另外,使用dynamic import()语法,分割输出包。

以下是Parcel2的官方网址,你可以查看它其他特性。

https://v2.parceljs.org/

搭建FastReactApp项目

我们首先需要安装FastReactApp,这里你需要全局安装一个为FastReactApp而生的命令脚手架FastReactCli,它可以更快地为你生成一个FastReactApp项目。

在安装之前,你需要确保你的Node版本>=12.0.0。

全局安装

npm install fast-react-cli -g

初始化项目

fast-react-cli init <projectName>

例:这里,我初始化一个名称为myreact2的项目,选择fast-react-app@1.0.1项目模板。

截屏2021-04-24 20.38.01.png

然后回车,项目初始化完成。

截屏2021-04-24 20.54.42.png

检测版本

fast-react-cli -v

我们目前fast-react-cli最新版本是1.1.7。

截屏2021-04-24 20.56.51.png

安装项目依赖

我们使用fast-react-cli安装上了FastReactApp,我们下一步需要安装项目的依赖。 在安装之前,你需要注意以下几点:

如果你的项目需要引入图片,你需要使用@parcel/transformer-image依赖,它可以调整图像的大小、更改图像的格式和质量。为了完成这些图像转换,它依赖于图像转换库Sharp,因此,需要将几个特定的文件导入NPM缓存路径下的特定文件夹中。

  1. 获取文件

打开网址:

https://github.com/lovell/sharp-libvips/

找到两个与您的计算机环境匹配的文件,以下是两个文件,xxx代表计算机环境。

1. libvips-8.9.0-xxx.tar.gz

2. libvips-8.10.5-xxx.tar.br

darwin-x64 一般指Mac OS环境,win32-x64 一般指 Windows环境。

  1. 查找文件夹

键入以下命令以获取NPM缓存路径:

npm config get cache

获得路径后,在此_libvips这个文件夹,将符合你计算机环境的两个文件放入这个文件夹内。

至此大功告成。

如果你的项目不引入图片,你可以不用看以上内容。另外,你需要把package.json文件中的"devDependencies"属性内的@parcel/transformer-image依赖删除掉,还有项目中默认会引入图片,把相应引入图片地址的代码段删除掉即可,因为这个依赖默认是安装的。

我们默认我们项目需要它,然后我们也做完了以上需要注意的工作。那么,现在就可以安装依赖了。

npm install

截屏2021-04-24 21.31.08.png

运行项目

npm run serve

截屏2021-04-24 21.32.17.png

这里需要声明一点,项目默认安装了mocker-apimocker-apiREST API 创建模拟 API。 当您尝试在没有实际 REST API 服务器的情况下测试应用程序时,它会很有用。所以,使用concurrently并行地运行多个命令(同时跑前端和后端的服务)。这里的mocker-api只有在开发环境中适用。

项目默认端口号为:3000,当然你也可以在package.json文件中修改默认配置。

  "scripts": {
    "start": "parcel ./public/index.html --port 3000 --no-source-maps",
    "build": "parcel build ./public/index.html --no-source-maps",
    "api": "mocker ./mock/mocker.js",
    "serve": "concurrently \"yarn api\" \"yarn start\""
  },

--port 3000这里你可以修改端口,这行命令配置是基于Parcel 2,更多配置可以参考:

https://v2.parceljs.org/features/cli/

我们在浏览器上输入http://localhost:3000/

截屏2021-04-24 21.43.39.png

项目成功启动。

发布项目

npm run build

将用于生产的应用程序生成到buildDir文件夹。它在生产模式下正确地进行反应,并优化构建以获得最佳性能。构建被缩小,文件名包含哈希。

你的应用程序已准备好部署。

FastReactApp资源

介绍完如果搭建项目了,下面,我们来看下FastReactApp给我们默认安装了那些资源依赖。

  • parcel
  • concurrently
  • mocker-api
  • eslint
  • babel-plugin-import
  • antd
  • axios
  • immutable
  • react
  • react-dom
  • react-redux
  • react-router
  • react-router-dom
  • redux
  • redux-immutable
  • redux-thunk
  • styled-components
  • web-vitals

前三项我们已经之前介绍过了,这里就不再复述了,下面,我们将挑几个代表性的资源依赖介绍下。

eslint可谓是现代前端开发过程中必备的工具了。其用法简单,作用却很大,使用过程中不知曾帮我减少过多少次可能的 bug。其实仔细想想前端开发过程中的必备工具似乎也没有那么多,ESLint 做为必备之一,值得深挖,理解其工作原理。

babel-plugin-import是一款babel插件,在编译过程中将import的写法自动转换成按需引入的方式。

antd是基于Ant Design 设计体系的 React UI 组件库,用于研发企业级中后台产品。Ant Design 2.0官网上有两句耐人寻味的话,我特别喜欢。

“Ant Design 无法保证业务产品能否成功,但是能帮助业务产品『正确的成功』或者『正确的失败』。”

“Ant Design 不但追求『用户』的使用体验,还追求『设计者』和『开发者』的使用体验。”

immutable对象是不可直接赋值的对象,它可以有效的避免错误赋值的问题。在react中,immutable主要是防止state对象被错误赋值。在Rudux中因为深拷贝对性能的消耗太大了(用到了递归,逐层拷贝每个节点)。但当你使用immutable数据的时候:只会拷贝你改变的节点,从而达到了节省性能。immutable的不可变性让纯函数更强大,每次都返回新的immutable的特性让程序员可以对其进行链式操作,用起来更方便。

styled-components有以下几点:1、样式写在 js 文件里,降低 js 对 css 文件的依赖。 2、样式可以使用变量,更加灵活。 3、使用方便,不需要配置 webpack、开箱即用。可以说做到了”All in js“。

web-vitals库是一个小型(约1K)模块化库,用于测量真实用户的所有web vitals指标,精确匹配Chrome对这些指标的测量方式,并报告给其他Google工具(例如Chrome用户体验报告、页面速度洞察、搜索控制台的速度报告)。

结语

FastReactApp官方文档网址:

https://www.maomin.club/site/fastReactApp/

截屏2021-04-24 22.18.48.png