Bobril-build 深入指南

Bobril-build 是一个基于 Node.js 的构建系统,专为使用TypeScript编写的单页应用程序(SPA)设计,同时为 Bobril 和 Bobril-g11n 提供了许多优化。它由 GMC Software Technology 的软件架构师和开发人员 Boris Letocha 编写。Bobril-build 不仅适用于 Bobril 应用程序,也可以用于一般的 TypeScript 应用程序。

安装 Bobril-build

Bobril-build 可以通过以下命令全局安装:

npm i bobril-build -g

它需要 Node.js >= 6.*.* 和 npm >=3.*.*。Bobril-build 也可以选择使用 yarn 包管理器(推荐)。如果 yarn 不可用,则会使用 npm。

Bobril-build 的优势

Bobril-build 旨在提供最佳的开发者体验。一般来说,要开始开发,只需要安装全局的 Bobril-build(只需一次),初始化 npm 包,创建 index.ts 文件并启动 bb 命令。它启动了一个自托管服务器,将分发存储在内存中(对 SSD 驱动器有好处),监视文件更改,运行测试,提供 sourcemaps 等。

但 Bobril-build 提供的远不止这些。它还可以执行:

  • 运行自托管服务器分发
  • 监视文件更改
  • 运行测试并可选生成 JUnit XML 结果以便于在构建服务器上集成
  • 编译TypeScript
  • 安装外部依赖
  • 解析内部/外部依赖(导入)
  • 转译
  • 管理翻译
  • 压缩
  • 创建精灵图
  • 管理资源
  • 运行和管理外部 Bobril 插件

基本命令

Bobril-build 提供了一些基本命令来运行构建过程:

bb

- 在交互模式下运行构建。分发可以在自托管服务器上使用 http://localhost:8080 访问。文件从内存中提供。构建信息可以在 http://localhost:8080/bb 上获取。它还运行测试。要启动另一个测试代理,将任何浏览器指向 http://localhost:8080/bb/test 。如果想调试测试,打开 http://localhost:8080/test.html ,任何失败的断言都会抛出异常,因此很容易在它们上停止。

测试

Bobril-build 运行带有 spec.ts 后缀的测试文件。它自动为这些 spec 文件提供 jasmine.d.ts。

bb test [options]

- 仅在 PhantomJS 中运行测试

翻译管理

Bobril-build 提供了一套工具来管理翻译。

bb translation|t [options]

- 翻译管理

构建命令

Bobril-build 允许通过参数管理构建过程。

bb build|b [options]

- 包括所有提到的操作的完整构建。仅构建一次,将生成的文件提供给 dist 文件夹并停止。

插件

Bobril-build 允许使用外部插件(例如,plug in),这些插件在 Bobril-build 过程的最后部分运行。要管理这些插件,请使用以下命令:

bb plugins [options]

配置

Bobril-build 可以通过 package.json 中定义的选项进行配置:

{ "typescript": { "main": "pathToMain.ts", // 默认为 index.ts ... }, "bobril": { "dir": "name of directory where to place release", // 默认为 dist ... }, ... }

调试模式

可以根据代码中的 DEBUG 标志有条件地运行一些代码。只需在模块中添加以下代码:

declare let DEBUG: boolean;
沪ICP备2024098111号-1
上海秋旦网络科技中心:上海市奉贤区金大公路8218号1幢 联系电话:17898875485