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 官网提供了不同平台的安装包,你可以直接下载安装包安装(平台自适配),Atom下载地址:
Atom(Atom Version > v0.150.0)
如果你没有你是用的平台或者你想要定制自己的Atom,那么你也可以通过自己编译源码,来获得对应的安装包,Atom 源码地址:
-
如果你已经安装完Atom,打开Atom并看到如下画面

-
打开Atom 的配置 界面, Mac系统通过:
Atom->Preferences... cmd+,来打开
-
点击
Setting界面左侧的 Packages 按键,进入 APM包管理界面,在这里,你可以找到自己已经安装的Apm包,安装包的更新以及一些推荐的包
-
在包管理界面下,搜索安装包的框中 输入
emp,一般出现的第一个包即为Emp Debugger,点击install來安装该插件,安装时间时网络情况而定,另因为Emp Debugger依赖一些npm包,所以Emp Debugger安装完成之后,约莫几分钟之后才能使用
-
安装完
Emp Debugger之后,可以点击插件详情中的Learn More來查看插件的wiki, 可以点击插件详情中的Settings来查看插件的相关信息(也可以通过左侧边框中的Filter packages来查找已安装的插件)
-
在插件详情中可以看到插件相关的 快捷键信息

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

-
到这
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是否正确等),來判断节点直接是否能够通信

