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

时间:2021-05-02

前言

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

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

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

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

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

仅仅使用了4.80s

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

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

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

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

  • https://v2.parceljs.org/
  • 搭建FastReactApp项目

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

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

    全局安装

    输入命令:

  • npminstallfast-react-cli-g
  • 初始化项目

    输入命令:

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

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

    检测版本

    输入命令:

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

    安装项目依赖

    我们使用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环境。

    2. 查找文件夹

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

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

    至此大功告成。

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

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

    输入命令:

  • npminstall
  • 运行项目

    输入命令:

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

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

  • "scripts":{
  • "start":"parcel./public/index.html--port3000--no-source-maps",
  • "build":"parcelbuild./public/index.html--no-source-maps",
  • "api":"mocker./mock/mocker.js",
  • "serve":"concurrently\"yarnapi\"\"yarnstart\""
  • },
  • --port 3000这里你可以修改端口,这行命令配置是基于Parcel 2,更多配置可以参考:

  • https://v2.parceljs.org/features/cli/
  • 我们在浏览器上输入http://localhost:3000/。

    项目成功启动。

    发布项目

    输入命令:

  • npmrunbuild
  • 将用于生产的应用程序生成到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/
  • 原文地址:https://mp.weixin.qq.com/s/ujJZj7-Wue2PtAhFXAEYGQ

    声明:本页内容来源网络,仅供用户参考;我单位不保证亦不表示资料全面及准确无误,也不保证亦不表示这些资料为最新信息,如因任何原因,本网内容或者用户因倚赖本网内容造成任何损失或损害,我单位将不会负任何法律责任。如涉及版权问题,请提交至online#300.cn邮箱联系删除。

    相关文章