Repository navigation
Tutorials
Atom 是GitHub推出的新一代的编辑器(A hackable text editor for the 21st Century). Atom 基于 node.js 、Chromium、CoffeeScript和LESS ,具有极高的拓展性和可用性.
在GitHub的官方Blog中描述了Atom的开发背景,“Sublime和TextMate十分方便,但是扩展性不足; 另一方面,Emacs和 Vim扩展性很强却需要学习日程工作中很少用到的脚本语言。”因此,他们希望在易用和易拓展之间寻找一个平衡点,于是就有了Atom这个项目.
作为GitHub的产品,Atom在今年5月宣布开源,开源部分包括Atom's core,apm(Atom Package Manager),Atom Shell .
EMP是北京融易通信息技术公司自主研发的一个高延展性、高可靠性、兼容多种业务系统和中间件系统、支持多种手机应用平台的企业移动应用平台,可以为现有和未来的移动应用构建一个通用的运行环境。
同时,为了增加EMP组件的开发和测试速度, 我们决定开发一个基于Atom 并且包含EMP 组件快速生成逻辑的插件,这就是Emp Debugger。
Atom依赖环境:
- Git, 你可以选择直接下载Github 的客户端: GitHub for Mac, GitHub for Windows, 或者直接安装Git: Git For Windows, Git
Atom 官网提供了不同平台的安装包,你可以直接下载安装包安装(平台自适配),Atom下载地址:
Atom(Atom Version > v0.150.0)
其他的下载地址: Atom Release
如果你没有你是用的平台或者你想要定制自己的Atom,那么你也可以通过自己编译源码,来获得对应的安装包,Atom 源码地址:
-
如果你已经安装完Atom,打开Atom并看到如下画面

-
打开Atom 的配置 界面, Mac系统通过:
Atom->Preferences... cmd+,来打开
-
点击
Setting界面左侧的 Install 按键,进入 APM包安装界面,在这里,你可以查找需要的包,以及一些推荐的包
-
在包安装界面下,搜索安装包的框中 输入
emp,一般出现的第一个包即为Emp Debugger,点击install來安装该插件,安装时间时网络情况而定. 安装完Emp Debugger之后,可以点击插件详情中的Settings来查看插件的相关信息.
-
也可以点击左侧的
Packages来查看已安装的插件
-
可以点击插件详情中的
View on Atom.io來查看插件的wiki
-
在插件详情中可以看到插件相关的 快捷键信息

-
在详情的底部,可以看到插件相关的打码补全片段关键字

-
到这
Emp Debugger的安装已经完成了,如果想要了解更多关于Emp Debugger的信息,请关注Emp Debugger的wiki.
Emp Debugger 使用依赖环境:
- Atom 这句是废话···
-
Erlang因为Atom中的部分逻辑是基于Erlang实现的 ,所以如果想要是用完整功能,请安装Erlang (Erlang version > R15B) - Ewp + App:推荐使用安装过
ewp的环境,但是不强制 (win32无要求) - Android或者Ios的SDK+ 打开
Emp Debugger调试功能的客户端安装包,但是不强制
推荐安装:
- Nodejs: Atom使用
Nodejs开发,如果你使用的是源码编译安装,则需要安装 NodeJs - Coffee Script: Atom的插件基于
Coffee Script开发,如果你对插件开发感兴趣,可以安装完NodeJs之后通过如下命令安装:npm install -g coffee-script
如果你是初次使用Atom,那么你看到的界面或许是这样的:

你可以通过File->Open File... 或者 Cmd+O 来打开新的工程(文件夹或者文件),打开之后,你看到的界面是这样的:

另外你可以通过 View -> Developer -> Toggle Developer Tools 或者 Cmd+alt+i 来打开开发者工具,是不是和浏览器的Debug工具很像

这之上就是Atom的基本使用界面
了解Atom的基本界面之后,你可以 通过Emp -> Setting View 或者 ctrl+alt+s来调出Emp Debugger .
Emp Debugger 插件以一种操作面板的方式悬浮与编辑域上面.Emp Debugger 根据功能组成,分成了两个分页,分别是 Debugger 和Emp App .

其中 Debugger 中的是Emp 的页面调试功能集合, 使用时需要 特定的,打开Debugger 功能的客户端支持,主要用于Emp 开发工程中的实时页面调试.

Emp App 中的是 应用逻辑操作相关的功能集合,同时对于不同的 使用环境,Emp App 也分为两个分页,分别为Start Local App 和 Connect Remote Node.其中 Start Local App 为本地App 的相关操作几个, Connect Remote Node 为连接远程App 节点的相关操作集合.

- 通过
ctrl+alt+s来调出Emp Debugger,并选择Emp App分页. 找到分页中的Create App Wizard,点击Create A Emp App按键,來调出App创建向导

-
向导页面中的输入项包括 App名称,App 路径,
Ewp路径三项,其中 App名称和App生成路径(路径结尾如果不为App名称,则声称以App名称为名的文件夹)为必须输入项,Ewp路径为选输项.Ewp路径为系统中安装的Ewp或者Ewp源码的路径, 默认为/usr/local/lib/ewp,该步的配置会决定生成App启动时,寻找Ewp的路径 -
完成上述操作之后,点击
Ok按键,來结束整个创建过程. -
在创建完成后, App 工程会自动打开

现在你已经创建完一个Emp App,接下来你需要编译的App工程,并启动他们,注意本条教程只适用于 Linux Or MacOs 系统,如果为Win32系统,请自行在虚拟机下编译.
-
通过
ctrl+alt+s来调出Emp Debugger,并选择Emp App分页. 选择Start Local App子分页(该分页为默认分页), 这时你能看到控制台上不同的按键,这些按键对应的功能如下:-
Config App初始化App相关配置 -
Make App编译整个App -
Start App启动App -
Stop App停止启动后的App -
C_App用于运行时的编译 -
Import Menu用于运行后Channel的导入 -
Run Erl Term用于运行Erlang语句,例如想要调用test:test().,则直接输入后,点击按键即可
-
-
首先,我们需要初始化我们刚创建的App工程,点击控制台上的
Config App按键.这是推荐通过cmd+alt+i打开开发者工具,并选到console分页上来查看日志.
-
查看日志,如果没有错误,点击控制台上的
Make App按键,进行编译.检查日志,查看是否有错误.因为日志输出为erl进城输出,所以错误信息和普通提示信息颜色相同,错误不容易识别,需要仔细辨认.
-
检查编译结果,如果没有错误,点击控制台上的
Start App按键,进行启动.等待启动完成,几秒后查看日志,如果出现app start success的字样,则启动成功
-
如果需要停止启动的app,可以点击控制台上的
Stop App按键,來停止服务. 也可以直接关闭当前Atom 的窗口,窗口关闭后App进程会随着Atom进程一起消亡.

-
在app启动的同时,可以点击控制台上的
Import Menu来导入channel. -
综上, 就是类linux环境下的app操作
在win32环境下, emp服务端环境并无法运行,开发者主要通过虚拟机来对win32下开发程序进行调试和运行.在这种情况下,为了简化开发者的调试流程,我们参考了 eclipse erlide 的方法,通过远程节点使 Atom与 emp服务进行连接,从而实现部分联调功能.具体使用流程:
-
首先需要在虚拟机中启动
emp服务,再启动服务的同时,你可以通过node().來获得该节点的名称,如下图:
-
在Atom环境下,通过
ctrl+alt+s来调出Emp Debugger,并选择Emp App分页. 选择Connect Remote Node子分页, 这时你能看下面的界面:
- 其中
Ewp Node就是第一步中启动emp服务时,通过node().获得的节点名称. -
Ewp Cookie,是节点的Cookie,如果在你不明白这是什么的情况下,一般不需要修改.
- 在确认参数后,可以直接点击
Connect按键來连接远程节点,如果出现以下界面,则为连接成功
如果出现以下界面,则为连接失败,如果失败,则应该检查节点名(如节点名应该用长名还是短名,cookie是否正确等),來判断节点直接是否能够通信

现在你已经有一个正在运行的Emp App工程,但是这个工程现在是空的,是时候为他添加一些业务逻辑了!
-
若果你的服务已经启动,则可以忽略本部.如果没有,则通过
ctrl+alt+s来调出Emp Debugger,还是选择Emp App分页,然后首先通过Start App來启动App. -
点击
Emp App分页下的Show Channel按键,这时候会弹出Channel展现页面,如图
-
Channel展现页面分为三部分,分别为左侧的Channel树状结构图,Collection 列表相关操作按键,Channel 列表相关操作按键,现在我们点击Channel 列表右侧的Add...按键来添加一个新的业务.
-
Channel添加的页面和Emp 管理平台的Channel添加页面相同,如果你使用过的,会很快上手.- 分别输入
Channel Id和Channel Name. -
Channel类型现在只支持适配类型,默认选择适配即可 - 准备添加业务逻辑单元,如果有适配问题,可以在此选择平台和分辨率.ps:分辨率和平台的选项可以再 安装插件的详情页面中配置,详见
安装->Emp Debugger安装中介绍 - 填写业务逻辑单元信息,如果你拥有
Procedure/Adapter配置,那么在此刻可以为每一步逻辑添加上.如果没有,建议把参数置空 - 如果业务逻辑单元有其他的参数,可以通过下方的参数配置添加
- 分别输入
-
添加完成后,点击下方的
Ok按键來结束整个流程.之后可以看到,先添加的Channel出现在列表中. Ps:如果这是第一个添加的Channel,那么他会成为业务流程中的第一个业务.入口在工程下的/public/www/entrance.xhtml中设置
-
如果需要在后续页面中显示九宫格,则可以在
Collection操作页面中加入刚添加的Channel- 点击
Collection页面中的Edit按键,对选中的Collection进行编辑 - 可以再下方列表中, 为
Collection添加子项
- 编辑完成之后点击下方的
Ok,来完成编辑 - 可以看到,添加的
Channel出现在左侧的'Collection'树下
- 点击
-
到这一步,一个
Channel业务逻辑就完成了
在这时, 你已经生完一个业务逻辑了,那么赶快测试一下他吧.
-
若果你的服务已经启动,则可以忽略本部.如果没有,则通过
ctrl+alt+s来调出Emp Debugger,还是选择Emp App分页,然后首先通过Start App來启动App. -
因为刚刚添加的业务逻辑中包含有
Erlang代码,我们需要先进行编译之后,确认没有错误之后,进行下一步.所以,点击App控制按键中的C_App来对运行时的App工程进行编译 -
打开模拟器(已安装客户端),点击进入之后即可看到看到刚添加的业务逻辑

如果你已经完成上述步骤,那你肯定已经有了自己的工程和业务逻辑,那么是时候开始对你的逻辑页面进行编写了,下面,我们就来了解一下如何使用Atom来进行页面调试.
-
通过
ctrl+alt+s来调出Emp Debugger,选择Debugger分页, 你可以导入画面
-
其中
Host为调试服务的地址,Port为调试服务的地址, 你可以填上指定的Ip地址和未被占用的端口,如果Ip地址为空,则会监听所有Host地址 -
配置完成后,点击
Start Server按键,来启动调试服务,启动服务后,会有一调试功能的按键:
-
Live Preview上送本地调试页面 -
Enable Views下行的客户端页面 (客户端显示过得页面代码) -
Enable Lua下行的客户端脚本(对应页面的脚本,同上条相同,都为客户端显示过得)
-
调试服务就已经启动完成了,这时打开带
Debugger功能的客户端.可以看到,客户端中有两个输入框,其中editor为调试服务的地址,在其中输入刚启动的调试服务地址即可,端口默认为7003,若果相同则地址可以不加端口,否则,地址需要带上指定端口.ewp为emp app地址,填入对应地址即可.
-
客户端配置完成后,并已经启动调试服务和
emp服务,那么可以点击connect,这是你会看到首页,你可以直接点击访问來进入到业务逻辑中. Ps:首页为入口页,刚才我们就在入口页定义了其实业务逻辑的Id
-
这是你已经看到了业务逻辑的首页面, 同时我们在Atom中打开对应的页面文件(
app/public/www/resource_dev下的对应平台, 例如我们的当前文件在ebank/public/www/resource_dev/common/channels/test/xhtml).
如果你的模板页面是通过Atom插件生成,那么你可以直接从下行页面代码中获取到对应文件的实体,方法为:
- 点击调试服务页面中的
Enable Views按键来获取下行报文列表
- 页面列表的顺序就是页面展现的次序,你可以选择最上方的一个(当前显示)页面,来跳转到页面的试题内容
-
我们可以对页面进行一些修改,修改完成后,点击
Live Preview来同步代码的变更.-
添加代码

-
点击
Live Preview同步
-
查看修改后的结果,并重复上述过程
-
-
同时我们可以在页面脚本中添加打印语句,来获取实时的变量情况:
-
在页面脚本中,为刚才的添加的按键添加对应的函数
-
点击
Show Log打开日志显示界面
-
点击
Live Preview同步 -
查看修改后的结果,并重复上述过程

-
还可以通过右侧的
LogColorSelector 来为日志选择不同的颜色
-
