Erlang Rebar 使用指南之一：入门篇

全文目录:

​​https://github.com/rebar/rebar/wiki​​

本章原文:

​​https://github.com/rebar/rebar/wiki/Getting-started​​

Rebar 是功能丰富的 Erlang 构建工具。用于Erlang/OTP项目的编译，测试，依赖管理，打包发布等。

Rebar 是自包含的脚本，可以方便地嵌入到项目中。

1 编译 rebar

$ git clone git://github.com/rebar/rebar.git
    $ cd rebar
    $ ./bootstrap

  查看命令说明：

$ ./rebar -c
    $ ./rebar help clean

2 入门例子

2.1 创建一个程序目录

$ mkdir myapp
    $ cd myapp

  把 “1 编译 rebar” 得到的 rebar 复制到myapp目录中

$ cp ../rebar/rebar .

2.2 创建第一个rebar项目

$ ./rebar create-app appid=myapp
    $ touch rebar.config

  上面命令执行后，在myapp/src生成了3个文件：

  myapp.app.src - OTP应用资源

  myapp_app.erl - 一个实现 OTP application behaviour

  myapp_sup.erl - 最顶层的 OTP Supervisor behaviour

2.3 编译项目

$ ./rebar compile

  上面命令执行后，生成ebin目录，包含与src/erl文件对应的.beam文件.

  src/myapp.app.src 生成 ebin/myapp.app

  清理项目

$ ./rebar clean

2.4 测试项目

  Rebar 支持 EUnit和Common Test测试框架。给项目增加 EUint 单元测试,  增加下面的代码到

  src/myapp_app.erl:

  -export([start/2, stop/1]). 后面添加：

%% eunit testing
    -ifdef(TEST).
    -include_lib("eunit/include/eunit.hrl").
    -endif.

  在文件末尾添加：

%% eunit testing
    -ifdef(TEST).

    simple_test() ->
        ok = application:start(myapp),
        ?assertNot(undefined == whereis(myapp_sup)).

    -endif.

  ifdef 宏指示测试阶段代码，不会编译进产品中。

  开始编译和测试:

$ ./rebar compile eunit

  上面的命令将编译2次，一次输出到ebin/，一次输出到.eunit/:

    ==> myapp (compile)

    Compiled src/myapp_app.erl

    Compiled src/myapp_sup.erl

    ==> myapp (eunit)

    Compiled src/myapp_sup.erl

    Compiled src/myapp_app.erl

      Test passed.

    =INFO REPORT==== 30-Nov-2014::03:50:01 ===

        application: myapp

        exited: killed

        type: temporary

2.5 测试代码覆盖率统计

  在myapp/rebar.config中加入下面的行:

{cover_enabled, true}.

  再次运行:

$ rebar compile eunit

  生成的统计页面在：.eunit/index.html