Skip to content
Ju.chao edited this page Jun 16, 2016 · 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依赖环境:

  1. 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 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

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

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

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

Emp Debugger 离线安装

如果你已经有了插件的安装包(代码), 你可以考到指定路径下,并通过刷新 Atom 来实现插件的可用(View -> Reload). Mac Os/Linux 路径为: ~/.atom/packages

Win 路径为: C:\User\用户名\.atom\packages (根据系统不同,可能会有差异. Win Xp 不支持 Atom)

插件使用前的环境准备

插件使用

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工具很像.

左侧的文件树状结构图也可以通过快捷键来快速隐藏和呼出: Mac 下为 cmd+\,Win/Linux 下为 ctrl+\

Tutorials_9

另外 Atom 提供单独的界面管理页面,可以通过如下方式唤出.

Mac系统通过:Atom->Preferences... 或者通过快捷键cmd+, 来打开.

Win/Linux 可以通过如下方式打开:目录File-> Setting 或者 Packages->Settings View -> Open来打开. 打开后如下图: Settings_view1 其中选项介绍如下:

  • Setting 是Atom 的基础配置,包括编辑气的编码模式, Tab 缩进的长度等类似配置.
  • Keybindings 是 Atom 自带的一些热键

Settings_view2

  • Packages 是 Atom 中的包管理器, 这个选项卡中显示的是已经安装了的插件包.

Settings_view3

  • Themes 是 Atom 中的主题管理器,显示已经安装了的主题,和当前配置的主题.

Settings_view4

  • Updates 显示可升级的插件包

Settings_view4

  • Install 显示推荐安装的插件包,并可以在这里搜索想要安装的插件包

Settings_view4

这之上就是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

同时你可以在虚拟机中/终端中通过命令 nodes(). 查看是否有连接的节点.

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 出现在列表中. 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,这是你会看到首页. 在首页中会有两个输入框,分别为 ChannelId 和 TranCode, 通过直接指定 Channel 和 Trancode 我们可以调到指定的页面查看. Ps:首页为入口页,ChannelId 和 'TranCode'就是创建Channel 是输入的Id 和 Add A Step 中的 Trancode. Tutorials_36

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

离线资源打包

EMP 框架中, 很多资源都是已离线资源包的形式存在的.在原来的开发流程中, 开发人员一般通过EWP 管理平台来进行离线资源的打包,现在我们把离线资源打包的功能整合到了 Atom 插件中,现在开发人员可以更方便的打资源报了, 下面我们就来介绍一下,离线资源包的打包方式.

普通资源打包

  1. 打开插件的管理界面,选择EMP App 选项卡,在界面的下方,你可以找到如下图的按钮. Package1

  2. 其中Package An Union Package 是打一个整合的普通资源包(会把所有的资源包压缩成为一个 zip 文件), 而上面的按键则是为每个资源路径单独打资源包(分散的). 打完的离线资源包,会放在当前 App 下的 tmp 文件夹下, 开发人员只需要按路径查找即可(tmp在点击打包按键时会自动创建). Package2 Package3

插件资源打包

  1. 打开Channel Management 管理界面,选中需要大插件包的 Channel, 如果需要多选,可同时按住Ctrl 建來选择.(Mac 下位Cmd 按键). Package4

  2. 点击右侧的 Batch Download按键,即可为选择的Channel 打插件资源包. 点击之后在弹出的面板里面选择需要打的包,然后点击打包按键,即可完成整个操作. Package5 Package6

  3. 打包完成后, 同资源包打包一样, 插件包存放在当前 App 下的 tmp 文件夹下. Package7

基础公共样式

为了方便页面人员的快速开发,我们在EMP Debugger 中内置了一些代码段, 你可以通过使用这些代码端来进行快速开发.

代码段使用实例

代码短的使用需要在页面文件中才可以生效.(.xhtml, .html, .cs结尾的文件). 代码自动补全效果如下: snippets1

补全完成的效果如下图:

snippets2

  • 我们可以看到补全完成后,会在编辑框里插入一段 Html 代码,同时该段HTML 也带有样式. 所有的基础控件的公共样式, 全都放在ert_ui.css 中.
  • 如果该工程是由 Atom 创建的, 那么该公共样式应该保存在 public/www/resource_dev/common/css/ert_ui.css下.
  • 如果该工程不是由 Atom 创建的, 那么,你可以通过 EMP App 面板下的, Refresh 模块, 来自行添加或者刷新公共样式.
  • 在确保存在公共样式文件之后, 同时需要在当前页面中引入该外联样式.引入方式同上述插入代码段相同 您只需要输入link , 然后通过tab 键自动补全即可.

如下图. snippets3 snippets4

之后,在客户端上即可看到效果. snippets5

注意

如果该基础控件的样式不满足您当前的需求,您可以通过在本地重定义样式,然后引用覆盖. 请不要修改公共样式文件ert_ui.css, 因为每次公共样式文件的刷新,都会重写该文件, 如果您对该文件有修改,那么修改将会丢失.

其他

Clone this wiki locally