Skip to content
jcrom edited this page Dec 24, 2014 · 25 revisions

Tutorials

背景

Atom Atom

AtomEdit

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 Debugger EMP

EMP是北京融易通信息技术公司自主研发的一个高延展性、高可靠性、兼容多种业务系统和中间件系统、支持多种手机应用平台的企业移动应用平台,可以为现有和未来的移动应用构建一个通用的运行环境。

同时,为了增加EMP组件的开发和测试速度, 我们决定开发一个基于Atom 并且包含EMP 组件快速生成逻辑的插件,这就是Emp Debugger。

安装

Atom

Atom 官网提供了不同平台的安装包,你可以直接下载安装包安装(平台自适配),Atom下载地址:

Atom(Atom Version > v0.150.0)

如果你没有你是用的平台或者你想要定制自己的Atom,那么你也可以通过自己编译源码,来获得对应的安装包,Atom 源码地址:

atom/atom repository

Emp Debugger 安装

  1. 如果你已经安装完Atom,打开Atom并看到如下画面 Tutorials_1

  2. 打开Atom 的配置 界面, Mac系统通过:Atom->Preferences... cmd+, 来打开 Tutorials_2

  3. 点击Setting界面左侧的 Packages 按键,进入 APM包管理界面,在这里,你可以找到自己已经安装的Apm包,安装包的更新以及一些推荐的包 Tutorials_3

  4. 在包管理界面下,搜索安装包的框中 输入 emp ,一般出现的第一个包即为 Emp Debugger,点击install 來安装该插件,安装时间时网络情况而定,另因为Emp Debugger 依赖一些npm包,所以Emp Debugger安装完成之后,约莫几分钟之后才能使用 Tutorials_4

  5. 安装完 Emp Debugger之后,可以点击插件详情中的Learn More 來查看插件的wiki, 可以点击插件详情中的Settings 来查看插件的相关信息(也可以通过左侧边框中的 Filter packages 来查找已安装的插件) Tutorials_5

  6. 在插件详情中可以看到插件相关的 快捷键信息 Tutorials_6

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

  8. 到这 Emp Debugger的安装已经完成了,如果想要了解更多关于Emp Debugger 的信息,请关注Emp Debugger的wiki.

插件使用前的环境准备

插件使用

Emp Debugger 使用依赖环境:

  1. Atom 这句是废话···
  2. Erlang 因为Atom中的部分逻辑是基于Erlang实现的 ,所以如果想要是用完整功能,请安装Erlang (Erlang version > R15B)
  3. Ewp + App:推荐使用安装过ewp的环境,但是不强制 (win32 无要求)
  4. Android或者Ios的SDK+ 打开Emp Debugger调试功能的客户端安装包,但是不强制

推荐安装:

  1. Nodejs: Atom使用Nodejs 开发,如果你使用的是源码编译安装,则需要安装 NodeJs
  2. Coffee Script: Atom的插件基于Coffee Script 开发,如果你对插件开发感兴趣,可以安装完NodeJs之后通过如下命令安装:npm install -g coffee-script

Atom介绍

Atom 界面介绍

如果你是初次使用Atom,那么你看到的界面或许是这样的: Tutorials_1

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

Tutorials_8

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

这之上就是Atom的基本使用界面

Emp Debugger 界面介绍

了解Atom的基本界面之后,你可以 通过Emp -> Setting View 或者 ctrl+alt+s来调出Emp Debugger .

Emp Debugger 插件以一种操作面板的方式悬浮与编辑域上面.Emp Debugger 根据功能组成,分成了两个分页,分别是 Debugger 和Emp App .

Tutorials_10

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

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

通过Emp Debugger 来开发你的Emp App应用

创建 Emp App 应用

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

Tutorials_14

  1. 向导页面中的输入项包括 App名称,App 路径, Ewp路径三项,其中 App名称和App生成路径(路径结尾如果不为App名称,则声称以App名称为名的文件夹)为必须输入项, Ewp路径为选输项. Ewp路径 为系统中安装的Ewp或者Ewp源码的路径, 默认为 /usr/local/lib/ewp,该步的配置会决定生成App启动时,寻找Ewp的路径

  2. 完成上述操作之后,点击Ok按键,來结束整个创建过程.

  3. 在创建完成后, App 工程会自动打开 Tutorials_15

编译并启动App

现在你已经创建完一个Emp App,接下来你需要编译的App工程,并启动他们,注意本条教程只适用于 Linux Or MacOs 系统,如果为Win32系统,请自行在虚拟机下编译.

Linux MacOs系统下

  1. 通过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().,则直接输入后,点击按键即可 Tutorials_16
  2. 首先,我们需要初始化我们刚创建的App工程,点击控制台上的 Config App按键.这是推荐通过cmd+alt+i打开开发者工具,并选到console分页上来查看日志. Tutorials_17

  3. 查看日志,如果没有错误,点击控制台上的Make App 按键,进行编译.检查日志,查看是否有错误.因为日志输出为erl进城输出,所以错误信息和普通提示信息颜色相同,错误不容易识别,需要仔细辨认. Tutorials_21

  4. 检查编译结果,如果没有错误,点击控制台上的Start App 按键,进行启动.等待启动完成,几秒后查看日志,如果出现app start success的字样,则启动成功 Tutorials_19

  5. 如果需要停止启动的app,可以点击控制台上的Stop App 按键,來停止服务. 也可以直接关闭当前Atom 的窗口,窗口关闭后App进程会随着Atom进程一起消亡. Tutorials_20 Tutorials_22

  6. 在app启动的同时,可以点击控制台上的Import Menu 来导入channel.

  7. 综上, 就是类linux环境下的app操作

win32 环境下的远程连接

在win32环境下, emp服务端环境并无法运行,开发者主要通过虚拟机来对win32下开发程序进行调试和运行.在这种情况下,为了简化开发者的调试流程,我们参考了 eclipse erlide 的方法,通过远程节点使 Atom与 emp服务进行连接,从而实现部分联调功能.具体使用流程:

  1. 首先需要在虚拟机中启动emp服务,再启动服务的同时,你可以通过 node(). 來获得该节点的名称,如下图: Tutorials_23

  2. 在Atom环境下,通过ctrl+alt+s来调出Emp Debugger ,并选择 Emp App 分页. 选择 Connect Remote Node 子分页, 这时你能看下面的界面: Tutorials_13

  • 其中Ewp Node 就是第一步中启动emp服务时,通过node().获得的节点名称.
  • Ewp Cookie,是节点的Cookie,如果在你不明白这是什么的情况下,一般不需要修改.
  1. 在确认参数后,可以直接点击 Connect按键來连接远程节点,如果出现以下界面,则为连接成功 Tutorials_24

如果出现以下界面,则为连接失败,如果失败,则应该检查节点名(如节点名应该用长名还是短名,cookie是否正确等),來判断节点直接是否能够通信 Tutorials_25

Clone this wiki locally