`
litaocheng
  • 浏览: 332155 次
  • 性别: Icon_minigender_1
  • 来自: 北京
社区版块
存档分类
最新评论

reltool用户指南

阅读更多

说明,最近比较忙,没有太多时间更新blog,请各位朋友谅解.

寻找俺的朋友,可以gtalk : litaocheng[at]gmail.com 或者 twitter : @litaocheng

这篇文章,应该是我写的最久的一篇,请各位多实践.

 

 

reltool使用指南

Author: Mail: Revision: Date:
litaocheng
litaocheng@gmail.com
1
2009.10.28

1   概述

reltoolErlang 提供的 release 管理工具. 我们依据 Erlang/OTP 开发的 application, 最后需要发布,这时需要使用 reltool 帮我们生成最终的 release, 也称为 target system. 同时 reltool 可以分析 application 的依赖关系,帮助我们正确的发布应用.

reltool 包括一个基于 wx 的 GUI 前端(wxWidgets erlang bind), 其可以用来查看 application 的依赖关系,可以查看模块的依赖关系,可以查看源代码. reltool 也提供使用命令来生成自定义的发布包.

1.1   适用范围和目的

本文档主要介绍如何使用 reltool, reltool 为 Erlang/OTP 开发环境的一部分. 本文假设读者对Erlang相关开发比较熟悉,了解 Eralng/OTP 开发规范. Erlang/OTP 要求R13B02及以上版本.

1.2   了解更多内容

可以通过下列相关文档了解更多 Erlang/OTP 开发相关信息

2   使用

前面讲过, reltool 提供 GUI 和命令两种交互方式, 本章首先简单的介绍GUI界面相关内容, 重点是使用命令生成 release, 发布自己的应用. 之所以重点介绍命令方式,主要基于两个因素:

  1. 命令方式是基础, GUI 只是提供了一个界面封装, 本质还是调用的相关的命令
  2. GUI 目前功能还不是很完整,很多操作不支持

2.1   GUI 相关

2.1.1   System Window

通过调用 reltool:start/0,1 启动 reltool, reltool 在启动时,首先扫描所有的 application 和 module, 分析其相互依赖关系.随后启动 system window.

system window 包含四个page window (tabs):

  • Libraries
  • System settings
  • Applications
  • Releases

点击对应的tag, 可以切换page.

system window 如下图:



 

Librarie 窗口如下图



 

在 library 窗口, 我们设置 reltool 将要使用的代码. 本页面以 tree 的形式来组织内容, 你可以点击每行前面的标记折叠/展开对应内容.

Library directories, Escript files 都可以进行操作. 选择对应的项目,按住鼠标右键显示对应的菜单, 移动鼠标选择对应的菜单项,释放鼠标右键.

双击 lib 下某个 application, 可以显示对应的 application window.

通过 reltool GUI, 我们还可以查看很多 windows, 如 aplication 依赖图:



 

源代码窗口:



 

2.1.2   System Settings

Avaiable 中显示的所有可用的 applications. 在 system page 中,我们可以设置全局的 application 包含规则, 即 incl_cond.

incl_cond 包含三种策略,我们在介绍命令方式创建release时,会详细介绍.

3   用命令生成relase(target system)

先说一下为自己的 application 生成 release 的步骤:

  1. 依据 Erlang/OTP 项目完成, 测试通过
  2. 定义 reltool 使用的关于最终 release 的各种配置参数 Config
  3. reltool:start_server(Config) 启动 reltool
  4. reltool:get_target_spec/1 获取根据 Config 产生的用来创建 target system 的一系列"动作"(Spec)
  5. reltool:eval_target_spec/3 根据 Spec 生成 target system
  6. 书写辅助的脚本,用来生成最终的安装包(可以为tar包,或者zip等)

我们假设第1步,您已经完成.

生成 target system 的重点就是 config 的设置了, 让我们详细的描述一下 reltool 手册中各项 config 参数.

config 可以大体分为4种类型:

  • 基本配置
  • sys 配置
  • app 配置
  • mod 配置

其中,很多配置信息在 sys, application, mod 三个等级中均会出现,其关系为: mod > app > sys, 即 mod 配置覆盖 app 配置, app 配置覆盖 sys 配置.

3.1   基本配置

  • root_dir

    Reltool 根据当前开发环境产生 target system, 因此 config 信息中势必包含 erlang root_dir 信息.

    root_dir 指明 erlang 的当前安装目录(比如在 ubuntu 9.04 下, 默认为 /usr/local/lib/erlang).本选项可以不用指定, reltool 会自动设置 root_dir.

  • lib_dirs

    除却 $ERL_LIB 外, 指定附加的 library 目录. 主要用来指定非 Erlang/OTP 正式发布版本中的 application 或 library.如第三方 library, 或我们自己的 application.

3.2   sys 配置

  • erts

    指定 erts application 信息, 具体的字段参考后面介绍的 app 配置.

  • escript

    escript 脚本配置信息, 包含 escript 文件,以及对应的配置信息

  • app

    target system 中包含的 app 信息. 比如所有的 release 都要包含 kernel, stdlib, 具体的app的相关配置,轻参考后面介绍的 app level 配置

  • mod_cond

    设置 module 的包含策略. 其包含多种方式:

    • all - 表示如果某个 app 被包含,那么其包含的所有模块全部被包含. 假设 app 名为 demoapp, all 不仅包含 demoapp/ebin 下的所有模块, 同时 demoapp.app 中 modules 字段描述的所有模块也将被包括(默认)
    • ebin - 表示 ebin 目录下所有的模块,以及相关的模块会被包含
    • app - 表示 .app 描述文件,以及相关的模块会被包含
    • derived - 表示被其他包含的模块用到的相关模块会被包含

    此处配置的 mod_cond 是 sys level 的配置, 控制所有的 app 中的 module 包含策略. 当然我们可以对这个信息, 在 app level 进行覆盖.

  • incl_cond 设置 applicaion 以及 escript 的包含策略.

    其包含3种类型:

    • derived - 表示 包含 没有明确设置 incl_cond, 同时被其他 application 直接或间接引用的application. (默认)
    • include - 表示 包含 所有没有明确设置 incl_cond 的application
    • exclude - 表示 排除 排除没有明确设置 incl_cond 的application

include 和 exclude 意义相反. 一个是包含没有设置 incl_cond 的 apps, 一个是排除没有设置 incl_cond 的 apps.

一般我们使用默认的 derived 选项,这样保证所有相关的 application 均被包含, 不会出现 target system 中,某个模块没有定义的错误.我们可以通过前面 reltool GUI 部分介绍的 application 依赖关系图 来了解 application 的交互相关信息.

  • boot_rel

    指定 target system 中默认启动项 (rel), 一个target system 中可能包含很多的 release(通过 rel 来指定)

  • rel

    指定 rel 内容 (Release specific configuration), 每个 rel 定义会被映射成 rel, script 和 boot 文件,请参考 Erlang/OTP Design Principles Release

  • relocable

    指定 target system 中erl 执行时自动检测路径相关信息({relocable, true}), 还是硬编码指定路径启动({relocable, false}). 如果 relocable 为 false, 那么 target system 必须首先通过 reltool:install/2 进行安装, 如果 relocable 为 true, target system 移动到其他目录时,仍然可以方便的运行. {relocable, true} (默认)

  • profile 指定 tareget system 的类型, 此选项主要影响:incl_sys_filters, excl_sys_filters, incl_app_filters 和 excl_app_filters. 不同的 profile 类型, 以上4个 filters 不同.

    主要包含3种:

    • development - 开发测试模式(默认)
    • embedded - 嵌入式完整模式
    • standalone - 单独模式,不携带相关的可执行文件

    在生成 target system 时, 实际上主要有两个步骤:首先创建一个完整的文件候选列表,它包含尽可能多的文件; 随后调用各种相关的 filter 定义,对结果进行过滤, 最后声称最终的 target system.

    一般情况下,我们的target system 要是一个完整的可执行的系统,因此我们许要设置 profile 为 embedded. (当然不设置 profile, 只是修改4个相关的 filter, 也可以达到我们想要的效果)

  • app_file

    控制 app 的内容, 因为有各种各样的 filter, 因此最终的 target system 中包含的模块,可能与 app 文件定义的模块列表不一致, 本选项控制 app 的内容. 主要包含3种:

    • keep - 将 app 直接拷贝到 target system 中(默认)
    • strip - 依据 app 文件产生 target system 中的 app 文件, 并将未被包含的模块从 app 文件中移出
    • all - 依据 app 文件产生 tarege system 中的 app 文件, 同时所有的模块将添加到 app 文件中, 如果某个应用没有 app 文件,那么会自动创建一个 app 文件.
  • debug_info

    是否去除 beam 文件中的调试信息: keep 表示保持; strip 表示去除

  • incl_sys_filters

    指定一个正则表达式列表,用来表示哪些系统文件可以出现在 target system 中. 如果某个系统文件想被包括, 那么其必须满足 incl_sys_filters 中的某个正则表达式, 同时不能满足 excl_sys_filters 中的任何表达式.

    比如:

    {incl_sys_filters,["^bin","^erts","^lib","^releases"]},
    

    表示 $ERL_ROOT 目录下的 bin, erts, lib, releases 目录均要包含.

    incl_app_filters, excl_app_filters 同 sys 相关的 filters 含义大致相同,只是用来控制 application 的包含规则.

  • excl_sys_filters

    指定一个正则表达式列表,表示哪些系统文件不可以出现在 target system 中. 默认 为 [].

  • incl_app_filters

    指定一个正则表达式列表,表示 application 中的哪些文件可以被包含. 如果某个文件想被包含,至少要满足正则表达式列表中的一个表达式. 默认为 [".*"], 如果设置为 [], 那么 application 中的任何文件都不会被包含.

  • excl_app_filters

    指定一个正则表达式列表,表示 application 的哪些文件不可以出现在 target system 中. 默认 为 [].

  • incl_archive_filters

    指定 application 中哪些一级子目录包含在压缩包中(与包含正常的目录对应), 通过一个正则表达式列表指定要包含在压缩包中的一级子目录. 默认为 [".*"]

  • excl_archive_filters

    指定一个正则表达式列表,指定 application 的哪些一级目录不包含在压缩包中. 如果某个目录,匹配任何一个正则表达式,则不会包含在压缩包中. 默认为 ["^include$", "^priv$"]

  • archive_opts

    创建压缩包对应的参数,在 zip:create/3 中使用, 请参考 zip module, 默认 为 [].

3.3   app 配置

  • vsn

    指定要包含的 application 的版本, 因为在系统中,可能存在同一应用的多个版本. 如果忽略,则使用最新版本.

  • mod

    模块相关的配置信息. 必须包含一个模块名称,以及其他可选的模块配置(参照后面 mod 配置)

  • mod_cond - 同 sys level 的同名配置含义相同

  • incl_cond - 同上

  • debug_info - 同上

  • incl_app_filters - 同上

  • excl_app_filters - 同上

  • incl_archive_filters - 同上

  • excl_archive_filters - 同上

  • archive_opts - 同上

3.4   mod 配置

  • incl_cond

    指示模块是否被包含,其覆盖 application 及 system 配置中的 incl_cond 信息.

    其包含3个值:

    • include - 表示本模块将被包含
    • exclude - 表示本模块不被包含
    • derived - 表示如果其他被包含的模块引用本模块,则本模块被也被包含.
  • debug_info

    同 app 配置中 debug_info 描述.

4   例子

最后是一个实例,我们为 erlips (erlang ip service) 生成 target system.

config (erlips.config)如下:

{sys,
   [
   {lib_dirs,["/home/litaocheng/erlang"]},
   {boot_rel, "erlips"},
   {rel, "erlips", "0.1", [kernel, stdlib, sasl, mochiweb, erlips]},
   {relocatable, true},
   {profile, embedded},
   {app_file, keep},
   {debug_info, strip},
   {mod_cond, all},
   {incl_cond, derived},

   {incl_app_filters, ["^include", "^priv", "^ebin", "^src"]},
   {excl_app_filters, []},

   {incl_archive_filters,[]},
   {excl_archive_filters,[".*"]},

   {app, kernel, [{incl_cond, include}]},
   {app, stdlib, [{incl_cond, include}]},
   {app, sasl, [{incl_cond, include}]},
   {app, erlips, [{incl_cond, include},
                   {incl_app_filters, [".*"]},
                   {excl_app_filters, ["^log", "^var", "^release"]}]},
   {app, mochiweb, [{incl_cond, include}]},
   {app, runtime_tools, [{incl_cond, include}]}
   ]
}.

我们为一个名叫 erlips 的 application 生成 target system.

随后执行:

> {ok, Server} = reltool:start_server([{config, "erlips.config"}]).
> {ok, Spec} = reltool:get_target_spec(Server).
> RelDir = "target_dir".
> file:make_dir(RelDir).
> ok = reltool:eval_target_spec(Spec, code:root_dir(), RelDir).
> zip:zip(RelDir ++ ".zip", [RelDir]). % 创建zip包

将生成的 zip 包拷贝到没有安装 Erlang 环境的电脑中, 解压 zip 包, 随后运行:

./bin/erl

则自动启动 erlips 应用.

5   config type定义

下面为 reltool 中各相关 config 的 type 定义(参考 reltool):

options()           = [option()]
option()            = {config, config() | file()}
                   | {trap_exit, bool()}
                   | {wx_debug, term()}
config()            = {sys, [sys()]}
sys()               = {root_dir, root_dir()}
                   | {lib_dirs, [lib_dir()]}
                   | {profile, profile()}
                   | {erts, app()}
                   | {escript, escript_file(), [escript()]}
                   | {app, app_name(), [app()]}
                   | {mod_cond, mod_cond()}
                   | {incl_cond, incl_cond()}
                   | {boot_rel, boot_rel()}
                   | {rel, rel_name(), rel_vsn(), [rel_app()]}
                   | {relocatable, relocatable()}
                   | {app_file, app_file()}
                   | {debug_info, debug_info()}
                   | {incl_sys_filters, incl_sys_filters()}
                   | {excl_sys_filters, excl_sys_filters()}
                   | {incl_app_filters, incl_app_filters()}
                   | {excl_app_filters, excl_app_filters()}
                   | {incl_archive_filters, incl_archive_filters()}
                   | {excl_archive_filters, excl_archive_filters()}
                   | {archive_opts, [archive_opt()]}
app()               = {vsn, app_vsn()}
                   | {mod, mod_name(), mod()}
                   | {mod_cond, mod_cond()}
                   | {incl_cond, incl_cond()}
                   | {debug_info, debug_info()}
                   | {app_file, app_file()}
                   | {incl_sys_filters, incl_sys_filters()}
                   | {excl_sys_filters, excl_sys_filters()}
                   | {incl_app_filters, incl_app_filters()}
                   | {excl_app_filters, excl_app_filters()}
                   | {incl_archive_filters, incl_archive_filters()}
                   | {excl_archive_filters, excl_archive_filters()}
                   | {archive_opts, [archive_opt()]}
mod()               = {vsn, app_vsn()}
                   | {incl_cond, incl_cond()}
                   | {debug_info, debug_info()}
rel_app()           = app_name()
                   | {app_name(), app_type()}
                   | {app_name(), [incl_app()]}
                   | {app_name(), app_type(), [incl_app()]}
app_name()          = atom()
app_type()          = permanent | transient | temporary | load | none
app_vsn()           = string()
archive_opt         = zip_create_opt()
boot_rel()          = rel_name()
app_file()          = keep | strip | all
debug_info()        = keep | strip
dir()               = string()
escript()           = {incl_cond, incl_cond()}
escript_file()      = file()
excl_app_filters()  = regexps()
excl_archive_filters() = regexps()
excl_sys_filters()  = regexps()
file()              = string()
incl_app()          = app_name()
incl_app_filters()  = regexps()
incl_archive_filters() = regexps()
incl_cond()         = include | exclude | derived
incl_sys_filters()  = regexps()
lib_dir()           = dir()
mod_cond()          = all | app | ebin | derived | none
mod_name()          = atom()
profile()           = development | embedded | standalone
re_regexp()         = string()
reason()            = string()
regexps()           = [re_regexp()] | {add, [re_regexp()]} | {del, [re_regexp()]}
rel_file()          = term()
rel_name()          = string()
rel_vsn()           = string()
relocatable         = boolean()
root_dir()          = dir()
script_file()       = term()
server()            = server_pid() | options()
server_pid()        = pid()
target_dir()        = file()
  • 大小: 73.4 KB
  • 大小: 21.5 KB
  • 大小: 33.5 KB
  • 大小: 86.3 KB
4
0
分享到:
评论

相关推荐

    工业机器人reLTOOL坐标方向-【ABB】ABB机器人旋转姿态的左乘与右乘.pdf

    ⼯业机器⼈reLTOOL坐标⽅向_【ABB】ABB机器⼈旋转姿态 的左乘与右乘 1.现场ABB机器⼈若希望绕当前tcp坐标系旋转,可以使⽤reltool函数,例如 2. ptmp1:=reltool(phome1,0,0,0\x:=30,\z:=30)表⽰沿当前⼯具坐标系xyz...

    ABB机器人指令教程

    换键选择所用函数 Offs() 或 RelTool() 。 •Offs(p1,100,50,0) 代表一个距离 p1 点 X 轴偏差量为 100mm,Y 轴偏差量为 50mm,Z 轴偏差量为 0 的点。 •函数 Offs() 座标方向与机器人 World 座 标系一致。

    工业机器人reLTOOL坐标方向-工业机器人工具坐标系(TCF)标定的六点法原理.pdf

    ⼯业机器⼈reLTOOL坐标⽅向_⼯业机器⼈⼯具坐标系 (TCF)标定的六点法原理 ⼀、基本步骤 (1)在机器⼈动作范围内找⼀个⾮常精确的固定点作为参考点; (2)在⼯具上确定⼀个参考点(最好是⼯具中⼼点Tool Center Point,...

    压铸岛ABB程序指令翻译.docx

    MoveL RelTool(pExtract,0,200,0), v2500, fine, toGripper; (横行进入第一个点) MoveL RelTool(pExtract,0,100,0), v1000, fine, toGripper; (横行进入第二个点) MoveL pExtract, v600, fine, toGripper; ...

    ABB机器人常用指令.pdf

    ABB机器⼈常⽤指令 ABB机器⼈常⽤指令 1、机器⼈运动指令 2、例⾏程序内的逻辑控制 For(根据指定的次数,重复执⾏...8、功能函数 offs(对机器⼈位置进⾏偏移) RelTool(对⼯具的位置和姿态进⾏偏移) 升级版: 升级版:

Global site tag (gtag.js) - Google Analytics