安装

方法一：源码安装

$ git clone https://github.com/erlang/rebar3.git
$ cd rebar3
$ ./bootstrap

方法二：点击「链接」直接下载

https://s3.amazonaws.com/rebar3/rebar3

方法三：直接从其他项目中拷贝

项目说明

新建项目命令

//1新建一个简单app项目
$ rebar3 new app <projName>
//2新建一个多app项目
$ rebar3 new release <projName>
//3新建一个简单app项目
$ rebar3 new lib <projName>
//4新建一个rebar插件
$ rebar3 new plugin <projName>

app项目结构

$> rebar3 new app projApp├── LICENSE
├── README.md
├── rebar.config
└── src├── projApp.app.src├── projApp_app.erl└── projApp_sup.erl

release项目结构

$> rebar3 new release projRel├── LICENSE
├── README.md
├── apps
│   └── projRel
│       └── src
│             ├── projRel.app.src
│             ├── projRel_app.erl
│             └── projRel_sup.erl
├── config
│   ├── sys.config
│   └── vm.args
└── rebar.config

PS:看文件目录就能大体看出，这两个的区别，app类型项目主要是简单的项目，而release项目多了个apps目录，此目录下可以有多个Erlang的application，可以处理复杂项目

lib项目

├── LICENSE
├── README.md
├── rebar.config
└── src├── projLib.app.src└── projLib.erl

plugin项目

说明:代码格式与app相同，但它有一套它自己的实现方式，具体实现留到以后来做

编译运行

以上把新建这块大体说完了，下面以release类项目为实例，具体分析
执行

$> rebar3 compile

编译成功，会生成一个新文件夹_build

├── _build
│   └── default
│       └── lib
│           └── projRel
│               ├── ebin
│               │   ├── projRel.app
│               │   ├── projRel_app.beam
│               │   └── projRel_sup.beam
│               ├── include -> ../../../../apps/projRel/include
│               ├── priv -> ../../../../apps/projRel/priv
│               └── src -> ../../../../apps/projRel/src

文件目录说明

deps默认目录:
_build/default/lib
release默认目录:
_build/default/rel
test默认目录:
_build/test/lib

常见命令

//查看依赖树
$ rebar3 tree
//查看依赖 $ rebar3 deps
//release所有app
$ rebar release//release指定app
$ rebar3 release -n <release_name>//按指定配置release
$ rebar3 as prod tar 

配置文件实例

{erl_opts, [debug_info,{i, "./include"}  % 指定include文件目录,{d, 'NOTEST', true}   %,{parse_transform, lager_transform}  %lager专用]}.% {deps_error_on_conflict, true}. // 增加这句，依赖有冲突时，会中止
{rebar_packages_cdn, "https://hexpm.upyun.com"}.  % package中国镜像{plugins, [  %% 插件% .dtl格式文件插件{rebar3_erlydtl_plugin, ".*",{git, "https://github.com/tsloughter/rebar3_erlydtl_plugin.git", {branch, "master"}}}
]}.{deps, [{apns,    {git, "git@github:zhaoweiguo/apns.git"}},{eredis, {git, "https://github.com/wooga/eredis.git", {tag, "v1.1.0"}}},{brod, {git, "https://github.com/klarna/brod.git", {tag, "3.4.0"}}}... ...
]}.{erlydtl_opts,[ % erlydtl插件相关配置{doc_root, "templates"}%,{compiler_options, [report, return, debug_info]}
]}.
{provider_hooks, [  %% hook钩子{pre, [{compile, {erlydtl, compile}}]}  % 执行rebar3 compile时先执行rebar3 plugin compile
]}.{relx, [{release, {octopus, "0.1.0"},[octopus,... ...sasl]},{sys_config, "./config/octopus.config"},{vm_args, "./config/vm.args"},{dev_mode, false}, % 开发模式{include_erts, false},  % 编译时是否包含erts库
%%  {exclude_modules, [{
%%    syntax_tools, [merl, merl_transform]
%%  }]},{extended_start_script, true}
]}.{profiles, [{ % 配置相关，同一rebar.config可以生成多种不同版本,如release, default, debug等prod, [{erl_opts
%      ,[no_debug_info, warnings_as_errors]   % [注意]加此句,有warning不能通过,[no_debug_info]},{relx, [{dev_mode, false},    % 用于修改上面relx顶层目录的配置{include_erts, true}]}]
}]
}.