新溪blog

新溪-gordon之胡写乱画

0%

Erlang：Rebar3的简单使用

发表于 更新于 分类于
本文字数： 0 阅读时长 ≈ 1 分钟

安装

方法一：源码安装
1
2
3
$ git clone https://github.com/erlang/rebar3.git
$ cd rebar3
$ ./bootstrap
方法二：点击「链接」直接下载

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

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

项目说明

新建项目命令
1
2
3
4
5
6
7
8
//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项目结构
1
2
3
4
5
6
7
8
9
$> rebar3 new app projApp

├── LICENSE
├── README.md
├── rebar.config
└── src
    ├── projApp.app.src
    ├── projApp_app.erl
    └── projApp_sup.erl
release项目结构
1
2
3
4
5
6
7
8
9
10
11
12
13
14
$> 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项目
1
2
3
4
5
6
├── LICENSE
├── README.md
├── rebar.config
└── src
    ├── projLib.app.src
    └── projLib.erl
plugin项目

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

编译运行

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

1
$> rebar3 compile

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

1
2
3
4
5
6
7
8
9
10
11
├── _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
文件目录说明
1
2
3
4
5
6
deps默认目录:
_build/default/lib
release默认目录:
_build/default/rel
test默认目录:
_build/test/lib

常见命令

1
2
3
4
5
6
7
8
9
10
11
//查看依赖树
$ rebar3 tree
//查看依赖 $ rebar3 deps
//release所有app
$ rebar release

//release指定app
$ rebar3 release -n <release_name>

//按指定配置release
$ rebar3 as prod tar

配置文件实例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
{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, {
    proj, "0.1.0"
  },
  [proj,
    ... ...
    sasl]},
 
  {sys_config, "./config/sys.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}
    ]}
  ]
}]
}.