手把手教你用 Yeoman 构建 Web 应用

手把手教你用 Yeoman 构建 Web 应用

Yeoman 是一种高效、开源的 Web 应用脚手架搭建系统,意在精简开发过程。Yeoman 因其专注于提供脚手架功能而声誉鹊起,它支持使用各种不同的工具和接口协同优化项目的生成。

本文要点

  • Yeoman 提供了一种灵活创建、开发、编译和调试 Web 应用的脚手架(scaffolding)软件。
  • 虽然 Yeoman 本身是 JavaScript 编写的,但适用于任何语言编写的应用。
  • Yeoman 支持与 Webpack、Babel、TypeScript、React 和 Angular 等多种第三方软件库的无缝集成。
  • Yeoman 内建立有一个基于 Node.js 的 HTTP 开发服务器,简化了开发环境的设置和开发过程的迭代。
  • Yeoman 实现构建过程由开发环境到优化后生产环境间的无缝转移。

Yeoman最初发布于 2012 年,它是一款高效、开源的 Web 应用脚手架(scaffolding)软件,意在精简软件的开发过程。脚手架软件用于实现项目中多种不同的工具和接口的协同使用,优化项目的生成过程。Yeoman 因其专注于提供脚手架功能而声誉鹊起,项目开源发布在GitHub上。

手把手教你用 Yeoman 构建 Web 应用

Yeoman 的基础知识

Yeoman 的使用体验可分为三个层次,各层间无缝协作,均为独立开发,并可单独运行。在第一层上,Yeoman 提供了命令行实用表单程序“Yo”。Yo 与 Yeoman 一起使用,提供 Yeoman 软件平台的基线。在第二层中,Yeoman 包括了应用构建器“Grunt”和“Gulp”,帮助实现应用开发的自动化。Yeoman 软件第三层的特点在于使用了软件包管理器“npm”,管理后端和前端开发的代码包及其依赖关系,由此为应用开发提供便利。Yeoman 为开发人员提供了多种结合开发过程使用的特性。

Yo

Yo 担当着“胶水”的作用,将应用粘合在一起的。Yo 可在 macOS、Windows 和 Linux 等多种不同操作系统上使用。从设计上看,Yo 通过 Gruntfile 与开发人员选取的生成器 (generator)协同工作,创建 Web 应用的基线。通过使用 Yo,可理解 Yeoman 的工作机制。

对比 Grunt 与 Gulp

Grunt 提供了开发的自动化,由此成为 Yeoman 的重要创新组成部分。Grunt 和 Gulp 插件的安装和管理,均通过 Node.js 的软件包管理器 npm。作为一种任务运行器,Grunt 最大限度上简化了开发人员的工作。Grunt 构建系统可用于项目的构建、预览和测试。一些重复性任务,包括编译、缩减( minification)、检查(linting)和测试等,均可交由 Grunt 执行。Grunt 将开发团队从应用开发的琐碎工作(nitty gritty)中解放出来,这意味着开发人员可以专注于应用所独有的一些重要、复杂之处。尤其是,Grunt 可以执行编译、代码检查、单元测试和压缩等基本任务,简化了开发人员的工作。一些著名企业,包括沃尔玛和 Wordpress等,均已使用了 Grunt。

Grunt 还支持使用插件定制应用,其具有数以百计的可用插件,支持执行多种任务。例如,开发人员可使用 cc-templates-generator 插件基于组件生成模板,在需要并发运行 Grunt 任务时使用一些并发插件。但有必要指出,如果现有的插件并不能满足开发人员的需求,那么他们可以通过grunt-init在 Grunt 上创建自己的插件,然后发布到数据库中以供他人使用。所创建的内容和文件,取决于开发人员选取的具体模板。

Gulp 非常类似于 Grunt,也是一种开发人员构建应用的自动任务运行器。从设计上看,Gulp 支持使用多种插件完成每个任务,而 Grunt 则是使用可同时完成多种任务的插件。此外,Gulp 的性能也要显著地快。例如,Grunt 执行一次 Sass 编译的用时 2.348 秒,而 Gulp 仅需要 1.27 秒。Gulp 的性能优势在于它使用了 Node 流,这意味着 Gulp 无需在磁盘上写入中间文件。

开发团队在 Grunt 或 Gulp 两者间做出选择时,应考虑的是应用的具体需求。

npm

npm 是一种软件包管理器,提供特性组和打包的代码,支持开发人员简化和自定义应用。通常,可用的代码是通过由 npm“托管”的代码库提供,其中包括 jQuery,React 和 Angular 等。从应用架构的角度看,开发人员可使用 npm 选取应用开发所需的代码。npm 的另一个特性类似于 Grunt,如果 npm 平台提供的代码或软件包无法满足开发人员的需求,那么他们可以创建自己的软件包,并与他人共享。该做法适用于所有的开源软件。

Yeoman 的优点

  • Yeoman 的流程中整合了多种新手特性,支持新入门的开发人员轻松进行 Web 应用开发,同时也简化了专业人员的工作。
  • Yeoman 可用于开发任何类型的 Web 应用。对于潜在的开发人员而言,它提供了极大的自由度。
  • 该软件非常人性化。即使是十分缺乏经验的开发人员也可以使用,由此也成为 Web 应用开发的一种绝佳选择。
  • 该软件还提供了一些构建应用的自动化流程。对于无论具有何种经验水平的各类开发人员而言,精简复杂的开发过程无疑都是一件好事。
  • 在提供脚手架功能外,Yeoman 还为 Web 应用开发的其它部分提供了工具。例如,调试所用的代码。开发人员可以使用 Chrome Devtools,或者任何使得顺手的 IDE。Yeoman 生成器还提供调试模式,可记录相关日志。这意味着 Yeoman 可以满足开发人员的各种需求,不必使用大量的软件平台即可创建完美的应用。
  • Yeoman 支持使用任何编程语言创建应用,包括 Java 和 C#。对于希望或需要实现应用开发多样化的开发人员,该多语言软件提供的多功能性是非常有用的。
  • Yeoman 集成了多种生成器。这些生成器作为 Yeoman 开发过程的“插件”,为 Yeoman 用户提供了多种选项。在搭建脚手架中,支持使用不同的生成器。例如,开发人员可通过使用各种生成器间的协调和协作来“支撑”自身的项目。在项目定制和开发之前,开发人员还可以考虑将生成器作为项目的准系统。一些热门的生成器包括:
  • Backbone.js:提供 Web 应用处理数据、视图、事件、REST API 等的结构和公共基础。
  • AngularJS:广为使用且十分流行的 JavaScript 框架,可提供模型支撑、视图路由等功能。该生成器中还包括了 sun-generator,实现控制器、指令、服务、提供者(provider),装饰器(decorator)等其他功能。
  • Bootstrap 生成器:一种流行的 CSS 框架,通过提供超高效实现简化项目开发。它为 Bootstrap 项目提供四种起始选项:CSS、LESS、SASS 和 Stylus。生成器根据开发人员的选择,将所选框架下载到项目的 bower 组件中。
  • JHipster 生成器:用于开发和部署 Spring Boot 和 Angular/React Web 应用。
  • Hyperledger-composer:使用 Hyperledger Composer 业务网络定义作为输入,创建和编写新应用程序相关的工件。
  • Yeoman 是开源的。 这意味着用户可从软件开发的自由市场中受益。一旦需要汇集英才创建最佳、最优化的系统,用户就能够受益于这些最优秀的开发人员。

Yeoman 的不足之处

  • Yeoman 支持使用任何编程语言并为业余开发者提供服务,这意味着对于那些经验丰富的开发人员而言,他们希望的是在提供高级开发选项的同时尽可能地简化和定制流程,由此 Yeoman 可能并非最佳的系统。在他们看来,Yeoman 的平台可能过于通用。
  • 与上一点相关,一些开发人员可能会发现,由于 Yeoman 的生成器设置,他们花费了过多时间在定制和测试生成器上,而不是工作于实际的应用开发。
  • Yeoman 另一个饱受批评之处是需要开发人员紧跟发展。对于开发人员而言,重要的是确保他们不断拥有最新的程序、生成器及其它工具,以生产最好的产品。因此,项目或应用是永远不会真正完成的,最佳实践也是不断变化的。为了保持竞争力,开发人员必须亦步亦趋。

Yeoman 具有清晰的 API,这对于那些刚着手或想要尝试构建应用的用户是一个很好的特性。 此外,Yeoman 还可自动执行一些常见的任务,有助于开发人员改进工作流程。

尽管 Yeoman 尚存在一些缺陷,但其背后具有一个不断增长的社区,并且开发人员也正在其工作流程集成 Yeoman,实现持续集成、版本控制等,从而使构建应用对每位开发人员而言不再那么令人生畏和耗时。Yeoman 还支持多种选择,例如 Grunt、Gulp 和 npm,确保开发人员所具有的软件组合最符合团队对 Web 应用程序开发过程的期望。

为进一步了解 Yeoman 的相关信息,下面我们将通过给出一个如何使用 Yeoman 创建示例应用,介绍构建的过程。该特定示例是 TodoMVC 的一个实现。

第一步:设置开发环境

开发人员主要通过命令行与 Yeoman 进行交互。

在安装 Fountain Webapp Generator 之前,确保系统中安装了下列环境:

  • Node.js 6 或以上版本;
  • npm 3 或以上版本;
  • Git;
  • Yeoman 工具集。

如果出现访问许可或权限问题,可参考操作指南。

第二步:安装 Yeoman 生成器

安装用于 FountainJS 项目的生成器,可减少用于设置样板文件(boilerplate)代码和文件夹结构的时间。使用 npm 安装 generator-fountain-webapp,命令为 npm install --global generator-fountain-webapp。

此外,还可使用 Yeoman 的交互菜单搜索其它生成器。运行 yo 命令,选择“install a generator”选项,然后继续搜索其它已发布的生成器。

第三步:使用生成器搭建应用的脚手架

该步骤展示 Yeoman 如何生成开发人员选定的软件库和框架。此外,还有选项支持使用一些外部软件库,例如Webpack、Babel和Sass。

首先,创建项目文件夹。运行命令 mkdir mytodo 和 cd mytodo,为项目创建 mytodo 文件夹。生成器将使用此文件夹放置生成的项目脚手架文件。

现在,运行 yo,并通过 Yeoman 菜单访问生成器。开发人员可能已安装了多个生成器,对于此例需选定Fountain Webapp并点击回车键。

一些生成器提供了额外的功能,使用开发人员软件库定制应用。着手配置生成器,加速开发环境的设置。

下面列出使用的一些 FountainJS 生成器选项:

  • 模块管理,例如Webpack、SystemJS;
  • 框架,例如React、Angular2或Angular1;
  • CSS 预处理器,例如SASS、LESS;
  • JavaScript 预处理器,例如Babel、TypeScript;
  • 三个示例应用,即引导页(a landing page)、示例程序 hello world 和 TodoMVC。

对于本例,箭头选择SaSSReactBabelWebpackRedux TodoMVC并回车。Yeoman 会自动为应用建立脚手架,并管理依赖关系。

第四步:检查 Yeoman 生成的应用目录结构

查看 mytodo 目录中脚手架生成的内容。其中可看到:

  • src
  • app
  • index.html
  • index.js
  • conf
  • gulp_tasks
  • gulpfile.js
  • .babelrc
  • package.json
  • node_modules
  • .gitattributes
  • .gitignore

在所有生成和安装完成后,会初始化一个新的 git 代码库。使用 git add --all 和 git commit -m 'First commit’命令添加首个提交,保存当前状态。

第五步:在浏览器中预览应用

运行 npm 脚本,创建一个基于 Node 的本地 HTTP 服务器,命令为 npm run serve。该服务器将在 localhost:3000 端口(在一些配置下是 127.0.0.1:3000)提供服务。以 localhost:3000 打开一个新的浏览器页面。

(注意:要停止服务器运行并退出 CLI 过程,使用 Ctrl+C 键盘命令。)

打开常用的文本编辑器查看文件,并可做出更改。在每次保存编辑后,浏览器将强制自动刷新,该功能称为“现场重载”(live reloading)。要实现该功能,需要在 gulpfile.js 中配置 Gulp 任务,在 gulp_tasks/browsersync.js 中配置Browsersync。

第六步:使用 Karma 和 Jasmine 测试

Karma是一种测试框架不可知性的 JavaScript 测试运行器。Jasmine测试框架已经包含在本例中所使用的 FountainJS 生成器中。前面运行的 yo fountain-webapp,在 mytodo 目录中生成了模式为 *.spec.js 的脚手架文件,并创建了 conf/karma.conf/js 文件。这为 Karma 提供了 Node 模块。

回到命令行,使用 Ctrl+C 杀掉本地服务器。使用 package.json 中的脚手架 npm 脚本运行单元测试。运行 npm test 初始化测试。

在 src 目录中打开 src/app/reducers/todos.spec.js,可看到脚手架的单元测试。

第七步:准备用于生产环境

首先,通过优化用于生产的文件,创建应用的生产版本。运行 npm run build,精简下列过程:

  • 代码检查;
  • 脚本和风格的链接和最小化;
  • 编译预处理器的输出;
  • 尽可能精简应用。

运行 npm run build 脚本后,通过 mytodo 项目根目录中的 dist 文件夹可访问用于生产的应用。这些文件已使用开发人员熟悉的部署服务置于服务器。

最后,运行 npm run serve:dist,在本地预览生成的应用。该命令在本地 Web 服务器上构建并加载项目。

获取更多Java高级架构最新视频,

直接点击链接加群。https://jq.qq.com/?_wv=1027&k=5lXBNZ7

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 205,132评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 87,802评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,566评论 0 338
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,858评论 1 277
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,867评论 5 368
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,695评论 1 282
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,064评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,705评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 42,915评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,677评论 2 323
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,796评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,432评论 4 322
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,041评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,992评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,223评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,185评论 2 352
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,535评论 2 343

推荐阅读更多精彩内容