Centos7 Erlang Rebar3 安装使用

rebar3 github地址

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

执行./bootstrap后，目录里面会生产一个rebar3文件。

接下来运行：

$ ./rebar3 local install
===> Extracting rebar3 libs to /root/.cache/rebar3/lib...
===> Writing rebar3 run script /root/.cache/rebar3/bin/rebar3...
===> Add to $PATH for use: export PATH=/root/.cache/rebar3/bin:$PATH

按照提示添加PATH，把/root/.cache/rebar3/bin:添加到环境变量中。

$ vim /etc/profile
export PATH=$JAVA_HOME/bin:/usr/local/erlang/bin:/root/.cache/rebar3/bin:$PATH

$ source /etc/profile

测试rebar3是否安装成功

$ rebar3 -v 
rebar 3.12.0+build.4465.refb8f8f3e on Erlang/OTP 23 Erts 10.5.3

出现以上，说明安装成功了！

//1新建一个简单app项目
$ rebar3 new app <projName>

//2新建一个多app项目
$ rebar3 new release <projName>

//3新建一个简单app项目
$ rebar3 new lib <projName>

//4新建一个rebar插件
$ rebar3 new plugin <projName>

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

$> 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

app和release项目区别，app类型项目主要是简单的项目，而release项目多了个apps目录，此目录下可以有多个Erlang的application，可以处理复杂项目。

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

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

$> rebar3 compile

├── _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

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

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}
 ]}
 ]
}]
}.