fis-didi

基于fis且适用于滴滴前端集成解决方案

为什么使用fis-didi

• 从开发流程&效率层面：从开发、测试到上线全面规范前端开发流程,提升开发效率，让fe专注开发。
• 从生产力层面：基于git提供模块按版本发布、安装，让前端组件可以积累、共享，减少生产力浪费。
• 从页面性能方面：自动CSS、JS/Image、font压缩、合并、base64、Sprite等让页面速度更快；模块化开发让页面可维护性更好。

关键词

weinre调试、无线端console调试、压缩、打包、md5戳、加域名、csssprite、文件监听、自动刷新、测试、发布目录、自动上传、内置服务器、数据模拟、请求模拟、获取组件、资源定位、资源内嵌、依赖声明、模块化规范、模块化框架、模块化规范、静态资源表、前端模块化、组件化规范、组件仓库、组件生态、插件扩展、coffee|less|stylus|sass编译...

快速开始

安装didi

npm i -g fis-didi

MAC遇到权限问题？

删除缓存目录，以后不要用sudo来执行npm install啦

sudo rm -rf `npm config get cache`

查看安装是否成功

didi -v

开始新项目

didi init project

├── component.json          // 目前主要作用记录项目使用了哪些模块（由此命令安装：didi install <namespace>/<component name>）
├── fis-conf.js             // fis-didi的配置文件
├── css                       // 项目的基础css文件
│   └── lib.css             // 基础HTML文件
├── img                     // 基础图片文件
│   └── didi.png
├── lib                     // 基础JS文件，主意里面文件都是 非模块化文件
│   ├── lib.js              // 负责将其他文件内嵌进来
│   ├── mod.js              // 模块加载器，配合fis-didi的发布来实现模块化
│   └── zepto.js            // 号称移动端的jquery
├── page                    // 页面根目录
│   └── pop                 // 示例页面文件夹
│       ├── animate.css     // 示例页面分出来的单个CSS
│       ├── main.css        // 示例页面的入口CSS
│       ├── main.html       // 示例页面的入口HTML
│       └── main.js
├── test                    // 模拟数据目录，特别注意的是其内部的结构和page文件夹一致
│   └── pop                 // 示例页面pop的模拟数据文件夹
│       └── main.php        // 示例页面pop的模拟数据
└── components              // 项目工程模块的跟目录
    ├── first               // first模块文件夹
    │   ├── first.css       // first模块的入口css，文件名须与模块名(first)相同 
    │   ├── first.html      // first模块的入口HTML，文件名须与模块名(first)相同
    │   └── first.js        // first模块的入口JS，文件名须与模块名(first)相同，可通过 require('first') 来获取模块
    ├── second
    │   ├── second.css
    │   ├── second.html
    │   └── second.js
    └── third
        ├── third.css
        ├── third.html
        └── third.js

初始化本地预览服务器

本地预览服务器依赖php-cgi和JDK

• 安装php-cgi
• 安装JAVA

有同学反馈MAC的JDK下载很慢？

didi server init

启动本地预览服务器

didi server start

发布项目到本地预览服务器

didi release 

打开浏览器访问 http://127.0.0.1:8080/pop/ 即可预览项目效果。

模拟假数据

模拟php下发的假数据

模拟页面中请求的数据

例如，我们滴滴打车行程中页面，需要不断去轮询当前页面状态； 我们需要ajax请求/beatles/webapi/passenger/order/getstatus?status=1， 这时候，我想在本地测试模拟一下假数据。

• 一、 项目根目录下新建文件rewrite.conf
• 二、项目根目录下新建文件夹mock，新建文件mock/status.php，并且在该文件输入

<?php
//模拟自己写的假数据，也可以其他方式获取
$data = <<<json
{
    "status": "123"
}
json;
$data = json_decode($data, true);
echo json_encode($data);

• 三、打开rewrite.conf，加入以下代码。

rewrite \/beatles\/webapi\/passenger\/order\/getstatus\?.* mock/status.php

• 四、 打开 http://127.0.0.1:8080/beatles/webapi/passenger/order/getstatus?status=1 可以看到由mock/status.php 输出的数据啦。

{
    status: "123"
}

而且按照我们的规范的文件不会发布到线上哦！！

在项目目录下通过配置文件 rewrite.conf 文件进行配置，配置方式是：

每一行被翻译成一条匹配规则，自上而下的匹配。
匹配类型 (空格) 匹配url正则 (空格) 命中正则后的目的文件路径或者url

rewrite ： 匹配规则后使用该文件输出的结果
redirect ： 匹配规则后302重定向到另一个url

rewrite ^\/news\?.*tn\=[a-zA-Z0-9]+.* app/data/news.php
redirect ^\/index\?.* /home/page/index

[发布]功能介绍

开启weinre调试功能

didi release -W

代码压缩

didi release -o

1. 所有的JS/CSS代码都被压缩
2. 所有的被引用的ttf文件自动压缩：根据CSS文件样式所匹配的DOM元素，自动抽取该DOM元素里面的文字，产生缩减版本字体文件。

例如以下 文件夹结构

page/pop
├── main.css
├── main.html
├── xiaofeng.ttf

page/pop/main.html里面有以下代码片段

<div class="didi_font">
    bealtes-fe
    <p>
        遇见美好
    </p>
</div>

page/pop/main.css里面有以下代码片段

/*声明 WebFont*/
@font-face {
  font-family: 'xiaofeng';
  src: url('xiaofeng.eot');
  src:
    url('xiaofeng.eot?#fis-didi') format('embedded-opentype'),
    url('xiaofeng.woff') format('woff'),
    url('xiaofeng.ttf') format('truetype'),
    url('xiaofeng.svg') format('svg');
  font-weight: normal;
  font-style: normal;
}

/*使用选择器指定字体*/
.didi_font{
    font-family: 'xiaofeng';
}

将会自动新增woff/svg/eot等文件，同时他们都是抽取了beatles-fe遇见美好等文字的缩减版本哦

分分钟3MB变3KB

代码合并

didi release -p

按照配置规则自动合并代码，并且自动使用合并后的代码包。

代码监听修改自动发布

#修改即编译
didi release -w
#修改即编译并且自动刷新浏览器
didi release -w -L

更多[发布]功能功能请查看帮助

didi release -h

  Usage: release [options]

  Options:

    -h, --help             output usage information
    -d, --dest <names>     release output destination
    -m, --md5 [level]      md5 release option
    -D, --domains          add domain name
    -l, --lint             with lint
    -t, --test             with unit testing
    -o, --optimize         with optimizing
    -p, --pack             with package
    -w, --watch            monitor the changes of project
    -L, --live             automatically reload your browser
    -C, --console          console.log tool within phone browser
    -W, --weinre [client]  use weinre debugger for web pages
    -c, --clean            clean compile cache
    -r, --root <path>      set project root
    -f, --file <filename>  set fis-conf file
    -u, --unique           use unique compile caching
    --verbose              enable verbose output

[预览]功能介绍

 Usage: preview <command> [options]

  Commands:

    open                   open pages preview in browser
    create                 create pages preview and save to server root

  Options:

    -h, --help  output usage information

自动读取本地server中的页面列表，并使用phantomjs生成页面预览，适合项目交接中使用，有利于把控整个仓库的所有页面。

语言实现功能介绍

__inline语法

预编译的前端模板

项目中任意的tmpl扩展名的文件，里面书写了简易模板underscore.js的template的语法代码。

<!--a.tmpl---->
<div class="layer_box_card">
    <img src="<%=img_src%>"/>
</div>

项目中某个JS文件可以这样使用它

//main.js
var a_tmpl = __inline('./a.tmpl');
var a_tmpl_content = a_tmpl({
    img_src: 'http://xxx.png'
});

在浏览器的效果是这个样子的，在main.js已经将a.tmpl预编译成一个函数。

var a_tmpl = function(obj){
    var __t,__p='',__j=Array.prototype.join,print=function(){__p+=__j.call(arguments,'');};
    with(obj||{}){
    __p+='<div style="display:none" class="layer_box_card">\n\t<img src="'+
    ((__t=(img_src))==null?'':__t)+
    '"/>\n</div>';
    }
    return __p;
};

var a_tmpl_content = a_tmpl({
    img_src: 'http://xxx.png'
});

/*
* a_tmpl_content等于
* <div style="display:none" class="layer_box_card">
*   <img src="http://xxx.png"/>
* </div>
*
*/

细心的读者注意到这里的__inline函数，这个函数可以在任意的JS块里面使用，它的作用顾名思义是将一个文件里面的代码嵌入进来。 而嵌入.tmpl扩展名的文件更是可以预编译成为一个JS文件。

聪明的读者可能会想到能不能将CSS、HTML嵌入进来呢？答案是肯定的！这是FIS实现的基础功能。猛击看文档

模块化开发

在项目中任何一个JS都可以被require获取，就像NODEJS一样。 同时页面中会自动加载依赖的模块文件

require可以接受3种类型

• 相对路径 以点.为起点

var a = require('./a.js');

• 绝对路径 以项目/根目录（fis-conf.js所在目录)为起点

var a = require('/page/pop/a.js')

• component模块名称

var dd = require('dd');

模块生态

如上所述，didi的component模块可以有2种来源

工程模块

例如工程模块a，被放在项目的/compoents/目录下

├── components
│   ├── a
│   │   ├── README.md
│   │   ├── a.css
│   │   ├── a.js
│   │   └── component.json

/components/a/a.js

exports.name = '我是a模块';
exports.sayName = function(){
    console.log(exports.name);
}

生态模块

将会被安装在项目/component_modules/目录下

didi install didi-component/dd

├── component_modules
│   └── didi-component-dd
│       ├── component.json
│       └── dd.js

可以使用didi install命令安装任何一个发布在github或者滴滴GitLab平台上，且符合component规范的模块包。

以component为规范的groups

• xiaojukeji GitLab: https://git.xiaojukeji.com/didi-component
• github：https://github.com/component

创建工程模块

通过上面的命令，可以一键创建a模块

didi init component

该模块将会自动放在/comopnents/a文件夹内 该模块的基本形态

├── README.md        //  模块的说明
├── component.json   //  模块的表单
├── a.css            //  模块的入口CSS
├── a.js             //  模块的入口JS
└── dialog.js        //  其他JS

发布生态模块

等我们把模块开发好了，可以分享给其他人使用，软件开发的最佳实践DRY (Don't Repeat Yourself) 。

我们为a模块在GitLab创建一个仓库。

上文说过我们可以从github或者滴滴GitLab下载一个模块包，我们可以根据模块任意选择发布到哪一个平台。

将所有的修改提交(git commit)之后，推送到远程仓库（git push）。

之后我们就可以发布一个新版本了，正如软件发包一样。

创建一个仓库

可以是任何groups的命名空间(namespace) 例如在我的zhangnan03下创建仓库。

https://git.xiaojukeji.com/zhangnan03/a.git

进入a模块的根目录

cd components/a

将模块提交到仓库

git init
git add -A
git remote add origin https://git.xiaojukeji.com/zhangnan03/a.git
git commit -am 'first comment for didi-compnent'
git push -u origin master

确认所有修改已经提交且推送到远程仓库。

发布新版本

通过didi publish -t <version>命令来发布模块 -t是指定版本号 <version>是特定版本号 版本号的规则应该是符合/^\d[0-9\.]+\d$/规则。

didi publish -t 0.0.2

你可能看到以下类似输出信息，就代表发布成功啦。

On branch master
Your branch is up-to-date with 'origin/master'.
nothing to commit, working directory clean
origin  https://git.xiaojukeji.com/zhangnan03/a.git (fetch)
origin  https://git.xiaojukeji.com/zhangnan03/a.git (push)
[master bebcd89] update new tag 0.0.2 use [didi publish]
 1 file changed, 2 insertions(+), 2 deletions(-)
To https://git.xiaojukeji.com/didi-component/ddplayer.git
   31c4f8f..bebcd89  master -> master
To https://git.xiaojukeji.com/didi-component/ddplayer.git
 * [new tag]         0.0.2 -> 0.0.2

其他人可以直接使用，以下命令来安装你的dd模块了

didi install zhangnan03/dd

其他人也可以指定安装某(如0.0.1)版本

didi install zhangnan03/[email protected]

然后在JS项目里面如下使用

var dd = require('dd');
dd.sayName();

工程模块类型

工程模块可以是JS、CSS、JS+CSS+HTML混合模块。

以下例子我们都使用a模块举例。

JS+CSS+HTML

通过didi init component命令创建的模块，模块中包含与模块同名的CSS+JS+HTML文件。

var a = require('a')

当我们使用上面的语法调用时，/component/a/a.js和/components/a/a.cs被自动加载

然后

HTML文件只能嵌入使用

/page/pop/main.html

<link rel="import" href="/components/a/a.html?__inline">

CSS+HTML

如果你不需要JS文件，把/components/a/a.js删除了。这样模块变成纯CSS的模块啦。 你可以在HTML文件里面使用这种语法载入

<!--
    @require a
-->

也可以在你的HTML使用到(依赖链上)JS/CSS文件里面

/**
 * @require a
 */

HTML文件同样只能同上使用嵌入语法使用。

JS+HTML

使用上和JS+CSS+HTML上并没有区别。

生态模块类型

生态模块以模块component.json的main字段所指文件（JS/CSS文件皆可）为入口。

JS+CSS

/component_modules/didi-component-dd/dd.js

/component_modules/didi-component-dd/dd.css

/component_modules/didi-component-dd/component.json

/component_modules/didi-component-dd/component.jsonmain字段的值dd.js，被依赖(require)时若存在同文件夹且同名的CSS也会被依赖，从而自动加载。

var dd = require('dd');

CSS

/component_modules/didi-component-dd/dd.css

/component_modules/didi-component-dd/component.json

在HTML里面使用

<!--
    @require a
-->

也可以你的HTML使用到(依赖链上)JS/CSS文件里面

/**
 * @require a
 */

HTML+CSS+JS

生态模块不建议使用HTML文件，而使用tmpl扩展名的模板文件替代。

页面开发

一键创建页面

进入项目根(fis-conf.js所在)目录

cd <project_root>

didi init page

创建newpage页面

├── page
│   ├── newpage          //newpage页面文件夹
│   │   ├── main.css    //newpage页面的CSS入口文件
│   │   ├── main.html   //newpage页面的HTML文件
│   │   └── main.js     //newpage页面的JS入口文件
└── test
    ├── newpage
    │   └── main.php

假数据文件夹

首先来介绍test/newpage/main.php，这是在本地预览服务的数据模拟的。他负责模拟 /page/newpage/main.html的数据。 main.html默认是认为使用codeigniter的简单模板语法。

如果想要使用smarty语法

didi init page --smarty

创建好的页面，发布一下(didi release)就可以看效果啦

• /page/newpage/main.html ===> http://127.0.0.1:8080/newpage/
• /template/newpage/main.tpl ===> http://127.0.0.1:8080/smarty/newpage/

资源依赖的作用

在fis-didi里面

总结

恭喜你，看到这里你已经基本掌握了didi的基本日常使用啦。

我们学习了

• 快速创建一个项目

didi init project 

• 快速创建一个页面

didi init page

• 快速创建一个工程模块

didi init component

• 发布一个模块到生态圈

didi publish 

• 安装一个生态模块

didi install didi-component/dd

• 启动一个本地测试服务

didi server start

• 将项目发布到本地测试服务目录

didi release

相关链接

• 优雅didi心得-如何快速发布(deploy)到远端测试机

• 优雅didi心得-如何轻松调试客户端Webview

• 优雅didi心得-如何轻松发布的上线

• 优雅didi心得-如何快速的线上调试