特性标识 编辑页面


英文原文:http://emberjs.com/guides/configuring-ember/feature-flags/

在Ember.js中,当添加一个新特性时,会为这个特性添加一个标识。这个标识用来标记该特性是在构建Ember.js的时候被启用并包含在构建中,还是完全被移除。这样新开发的特性可以在满足生产环境需求之前,有选择的进行发布。

特性生命周期

当一个新特性被标记,这表明其将被包含在canary构建中(如果在运行期被启用)。当开始下一个beta周期的时候(通常是6-12周),会对每一个特性进行评估,那些通过评估的特性会在下一个beta周期中启用(也会在之后的每个canary构建中被启用)

如果一个特性还不够稳定,那么它将在下一个beta发布点被禁用。也不会被包含在接下来的stable发布中。如果相关的问题都被解决了,它将依然被包含在下一个beta周期中

一旦beta周期完成了最后的发布,那么发布中将包含所有在该周期中被启用的特性。此时特性标识将从canary和之后的beta分支中删除,且特性标识不在起作用。

标识详解

在生成的构建中,标识状态通过项目根目录的features.json文件进行控制。这个文件中列出了所有的特性以及状态。

一个特性可以有如下的状态:

  • true - 特性被启用:标识背后的代码将在之后的构建中被启用。
  • false - 特性被禁用:标识背后的代码完全不会被包含在构建中。
  • null - 特性会包含在构建中,但是必须在运行期启用才生效(依然处于标识之后)。

处理从生成的构建输出中删除特性标识是通过defeatureify来实现的。

特性列表 (FEATURES.md)

当一个特性被添加到canary分支(或者master分支),会在FEATURES.md中添加一条记录,用来描述这个特性提供了什么功能(并链接到原始的PR)。这个列表是当前保存的,用来记录分支中(stablebetamaster)包含了些什么特性。

运行期启用

只有当features.json文件中指定一个特性的状态为null时,该特性才能在运行期被启用。(从技术上说,任何truefalse之外的值都可以,不过这里使用null来表示)。

Ember使用一个全局变量EmberENV对象来初始化Ember.ENV,所有EmberENV.FEATURES中的特性标识都会被移植到Ember.FEATURES中,这些特性将根据标识的值来启用。Ember紧在初始加载时读取EmberENV的值,因此在Ember加载后再设置这些标识不会起任何作用。

例子:

1
EmberENV = {FEATURES: {'link-to': true}};

此外,也可以通过定义EmberENV.ENABLE_ALL_FEATURES来启用所有的特性。