Skip to content
Ju.chao edited this page Jan 27, 2015 · 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 Release

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

atom/atom repository

Emp Debugger 安装

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

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

  3. 点击Setting界面左侧的 Install 按键,进入 APM包安装界面,在这里,你可以查找需要的包,以及一些推荐的包 Tutorials_3

  4. 在包安装界面下,搜索安装包的框中 输入 emp ,一般出现的第一个包即为 Emp Debugger,点击install 來安装该插件,安装时间时网络情况而定.

安装完 Emp Debugger之后,可以点击插件详情中的Settings 来查看插件的相关信息. Tutorials_4

5.也可以点击左侧的 Packages 来查看已安装的插件 Tutorials_5

6.可以点击插件详情中的View on Atom.io 來查看插件的wiki Tutorials_5_1

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

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

  3. 到这 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

创建业务流程

创建一个测试业务流程

现在你已经有一个正在运行的Emp App工程,但是这个工程现在是空的,是时候为他添加一些业务逻辑了!

  1. 若果你的服务已经启动,则可以忽略本部.如果没有,则通过ctrl+alt+s来调出Emp Debugger ,还是选择 Emp App 分页,然后首先通过Start App 來启动App.

  2. 点击 Emp App 分页下的 Show Channel按键,这时候会弹出 Channel 展现页面,如图 Tutorials_26

  3. Channel展现页面分为三部分,分别为左侧的Channel树状结构图,Collection 列表相关操作按键,Channel 列表相关操作按键,现在我们点击Channel 列表右侧的Add... 按键来添加一个新的业务. Tutorials_27

  4. Channel添加的页面和Emp 管理平台的Channel添加页面相同,如果你使用过的,会很快上手.

    • 分别输入Channel Id和Channel Name.
    • Channel类型现在只支持适配类型,默认选择适配即可
    • 准备添加业务逻辑单元,如果有适配问题,可以在此选择平台和分辨率.ps:分辨率和平台的选项可以再 安装插件的详情页面中配置,详见安装->Emp Debugger安装中介绍
    • 填写业务逻辑单元信息,如果你拥有Procedure/Adapter配置,那么在此刻可以为每一步逻辑添加上.如果没有,建议把参数置空
    • 如果业务逻辑单元有其他的参数,可以通过下方的参数配置添加 Tutorials_28
  5. 添加完成后,点击下方的Ok 按键來结束整个流程.之后可以看到,先添加的Channel 出现在列表中. Ps:如果这是第一个添加的Channel,那么他会成为业务流程中的第一个业务.入口在工程下的/public/www/entrance.xhtml中设置 Tutorials_29

  6. 如果需要在后续页面中显示九宫格,则可以在Collection操作页面中加入刚添加的Channel

    • 点击Collection页面中的Edit按键,对选中的Collection进行编辑
    • 可以再下方列表中, 为Collection添加子项 Tutorials_30
    • 编辑完成之后点击下方的Ok,来完成编辑
    • 可以看到,添加的Channel出现在左侧的'Collection'树下 Tutorials_31
  7. 到这一步,一个Channel业务逻辑就完成了

运行刚创建的业务逻辑

在这时, 你已经生完一个业务逻辑了,那么赶快测试一下他吧.

  1. 若果你的服务已经启动,则可以忽略本部.如果没有,则通过ctrl+alt+s来调出Emp Debugger ,还是选择 Emp App 分页,然后首先通过Start App 來启动App.

  2. 因为刚刚添加的业务逻辑中包含有 Erlang 代码,我们需要先进行编译之后,确认没有错误之后,进行下一步.所以,点击App控制按键中的C_App 来对运行时的App工程进行编译

  3. 打开模拟器(已安装客户端),点击进入之后即可看到看到刚添加的业务逻辑 Tutorials_33

页面实时调试

如果你已经完成上述步骤,那你肯定已经有了自己的工程和业务逻辑,那么是时候开始对你的逻辑页面进行编写了,下面,我们就来了解一下如何使用Atom来进行页面调试.

开启调试服务

  1. 通过ctrl+alt+s来调出Emp Debugger ,选择 Debugger 分页, 你可以导入画面 Tutorials_11

  2. 其中Host 为调试服务的地址, Port 为调试服务的地址, 你可以填上指定的Ip地址和未被占用的端口,如果Ip地址为空,则会监听所有Host地址

  3. 配置完成后,点击Start Server 按键,来启动调试服务,启动服务后,会有一调试功能的按键:

  • Live Preview 上送本地调试页面
  • Enable Views 下行的客户端页面 (客户端显示过得页面代码)
  • Enable Lua 下行的客户端脚本(对应页面的脚本,同上条相同,都为客户端显示过得) Tutorials_34
  1. 调试服务就已经启动完成了,这时打开带Debugger功能的客户端.可以看到,客户端中有两个输入框,其中editor 为调试服务的地址,在其中输入刚启动的调试服务地址即可,端口默认为7003,若果相同则地址可以不加端口,否则,地址需要带上指定端口.ewp 为emp app地址,填入对应地址即可. Tutorials_35

  2. 客户端配置完成后,并已经启动调试服务和emp服务,那么可以点击connect,这是你会看到首页,你可以直接点击访问來进入到业务逻辑中. Ps:首页为入口页,刚才我们就在入口页定义了其实业务逻辑的Id Tutorials_36

  3. 这是你已经看到了业务逻辑的首页面, 同时我们在Atom中打开对应的页面文件(app/public/www/resource_dev下的对应平台, 例如我们的当前文件在ebank/public/www/resource_dev/common/channels/test/xhtml).

如果你的模板页面是通过Atom插件生成,那么你可以直接从下行页面代码中获取到对应文件的实体,方法为:

  • 点击调试服务页面中的Enable Views 按键来获取下行报文列表 Tutorials_39
  • 页面列表的顺序就是页面展现的次序,你可以选择最上方的一个(当前显示)页面,来跳转到页面的试题内容 Tutorials_38
  1. 我们可以对页面进行一些修改,修改完成后,点击 Live Preview 来同步代码的变更.

    • 添加代码 Tutorials_40

    • 点击 Live Preview 同步 Tutorials_41

    • 查看修改后的结果,并重复上述过程

  2. 同时我们可以在页面脚本中添加打印语句,来获取实时的变量情况:

    • 在页面脚本中,为刚才的添加的按键添加对应的函数

    • 点击 Show Log 打开日志显示界面 Tutorials_42

    • 点击 Live Preview 同步

    • 查看修改后的结果,并重复上述过程 Tutorials_43

    • 还可以通过右侧的LogColor Selector 来为日志选择不同的颜色 Tutorials_44

Clone this wiki locally