APP NEST轻应用开发

1. 使用流程

app01

图一 产品申请、部署及上线流程

app02

图二 APP NEST轻应用开发流程

2. 产品申请

若申请入驻式产品部署,需填写《产品申请单》,《产品申请单》可填写是正式购买使用还是用户试用,若使用则填写试用周期。此种申请方式是在客户现场部署环境使用。

另外,若仅仅是使用,产品也搭建了阿里云的试用环境,可以远程试用,不用在客户现场进行入驻式的部署,这种试用方式快捷高效,不用填写《产品申请单》,需要相关人员发送邮件到“APPNEST@ntaionsky.com”,主要描述清楚客户信息以及项目名称,申请完毕后提供环境使用账号。

3.  创建应用

用户获取到开发环境之后,首先在用户本地安装开发工具,开发工具是用来开发轻应用使用,当然用户也可以选择不安装:

1)  双击NationSkyIDESetup_X86.exe安装程序,点击“下一步”按钮

app03

图1 开发工具安装过程

2)  选择安装位置点击“下一步”按钮

app04

图2 开发工具安装路径

3)  点击“安装”按钮开始软件安装过程

app05

图3 开发工具安装过程

4)  点击“安装”按钮,开始安装开发平台

app06

图4 开发工具安装过程

5)  点击“完成”按钮,完成开发平台安装过程

app07

图4 开发工具安装完成

说明:

  • 若勾选“启动国信灵通移动开发平台”则安装完成后自动运行开发平;
  • 若勾选“访问产品网站”则安装完成后会自动打开国信灵通产品官网。

4. 工具介绍

4.1 工具主页

双击开发工具,选择项目存储路径,点击OK按钮。

app08

图5 开发工具工作空间选择

进入工具主页面,MeapStudio为开发者提供了快捷创建应用以及RMS服务功能,如下图所示;

app09

图6 开发工具首页

同时开发者可以点击下面的快捷菜单,进入APP NEST文档中心,查看对应的功能介绍。

4.2 NationSky透视图

MeapStudio为开发者提供了强大的MeapStudio透视图功能,见下图;

app10

图7 开发工具打开透视图

点击OK,打开透视图后,如下图所示;

app11

图8 开发工具透视图

说明:

  • 项目资源管理器

该工作区域以树形结构形式显示项目信息。

  • RMS API

公共服务列表由APP NEST平台提供,提供所有应用使用。

  • 组件区域

未开发这提供内置的JS组件代码,可直接拖拽到页面中生成js代码。

  • 代码编辑区域

该区域主要是对HTML、JS、CSS、XML代码进行编辑、展示。

  • HTML即时浏览器

代码编辑完成后,通过该浏览器能够即时的查看编辑后的效果。

4.3 参数配置

单击菜单栏中的Window—>Preferences选项,弹出参数配置窗口,如下图;

app12

图9 开发工具参数配置

说明:

  • APPNESTReq:APP NEST后台服务对外访问地址,必填项,eg: http://101.200.156.199/nqsky-meap-open-webapps/open.jws
  • AppUserName :登录移动门户的测试账号,主要用于IDE中实现真机调试轻应用时,自动登录门户所用。该测试账号必须预先配置于管理平台。
  • PassWord:登录移动门户密码,主要用于IDE实现真机调试轻应用时,自动登录门户所用。。
  • AppName:安装在移动终端上的门户名称,默认值为APP NEST;
  • IOSID:苹果终端上移动门户应用标识,默认值为com.nationsky.rmad
  • AndroidID:安卓终端门户应用标识,默认值为com.nqsky.rmad
  • AndroidActivity:安卓终端门户启动入口类,默认值为com.nqsky.nest.WelcomActivity
  • TestAppID:手机运行功能中,用于推送资源的目标轻应用标识。取管理平台中已经发布的轻应用的应用标识,并且这个应用已经在门户的应用商店安装过了。
  • Whether the encryption:是否加密选项,根据当前的平台进行选择,如果平台使用加密处理,请勾选此项.
  • 通过以上几个步骤,参数配置完成,下面将开发一个Hello Word为大家讲解如何使用我们开发工具来开发一个Demo。

5. Hello World

5.1 创建应用

首先在登录开发者平台创建轻应用项目,如下图;

app13

图  创建轻应用-1

app14

图  创建轻应用-2

  • 应用图标:此图片是在门户客户端桌面进行显示的,请要求UI设计人员按照规定的尺寸大小提供:57*57像素。
  • 定义应用名称:给该应用定义一个名称,用来标识该应用是什么应用,比如移动OA、移动展业
  • 定义应用类型:轻应用包含三种模式:1.HTML5的zip包。2.外部的URL;3.服务型应用  这里我们选择zip包类型.
  • 定义应用标识:应用标识由平台自动生成。
  • 应用类别:门户中应用所在的类别。
  • 应用简介:对该应用做一个简短的文字描述。
  • 版本更新动态:对该应用版本更新做一个简短的文字描述。
  • 后台地址:轻应用后台维护地址。
  • 调用接口:开发者勾选需调用的平台API接口,平台管理员审核通过后可调用。
  • 点击保存,应用创建完成。

5.2 接口审核

平台管理员在管理平台的“开发者管理”模块中,可对开发者调用接口申请进行审核,通过勾选批准调用的应用来审核开发者提出的平台接口调用申请,通过后该应用方可调用。

app15

图  审核轻应用接口权限

5.3 创建项目

在管理平台创建好应用项目后,客户端开发人员就可以利用开发工具来开发移动应用了,操作步骤如下:

5.3.1

1)  打开MeapStudio,在File->New菜单中选择Light Project.

app16

图12 开发工具新建工程

2)  选择应用ID(管理平台创建的应用ID),输入项目名称,点击Next进行下一步。如下图:

app17

说明:

appKey(轻应用标识)与appSecret(轻应用密匙)是非必填项,但是在手机运行功能中需要二者进行平台验证;所以请确保二者的正确性。

项目名称是必填项,验证要求与eclipse中对project名称校验一致。

3)  MeapStudio中提供部分场景的轻应用模版供开发者使用,如下图;

app18

图17 开发工具工程模板

4)  以空模板为例,选择完成后点击Finish,项目创建完成。

5.3.2 新建项目元素

1)  打开MeapStudio,在File->New菜单中选择NationSky Studio Element.

app19

图18 开发工具Element选择

2)  选择Css文件单击下一步,选择文件存放路径,给新建文件一个名称,点击Finish按钮创建Css文件完成。

app20

图19 开发工具css文件向导

5.3.3 项目架构

如下图所示;

app21

图20 开发工具工程架构

说明:

1)  Config:项目配置基本信息,包括项目的版本号,应用名称等。

app22

图21 开发工具工程配置信息

2)  应用标识:是在管理平台创建的应用ID是不能更改的

3)  Version Number:应用版本

4)  Application Name:应用名称,(这个应用名称就是打完应用程序后的应用名称)。

5)  Start Page:是配置启动页面

6)  Icon:是应用图标

7)  Image:是启动页图片

8)  Icons : Icons主要包含应用图标、loading图片(不能删除)。

6. 编辑index.html

MeapStudio为开发者提供了快捷代码编辑功能,具体如下;

1)  内置Aptana,支持HTML、CSS、JS代码助手

app23app23

图22 内置Aptana预览

2)  调试代码,在预览区域点击open DevTools

app24

图23预览区

3)  弹出调试窗口

app25

图24 代码调试窗口

4)  内置Emmet,使用方法请参照Help—>Help Contents帮助文档,如下图;

app26

图25 内置Emmet

如:输入!号,按Tab键将会快速生成上述HTML框架代码。输入a,按Tab键将会快速生成超链接标签等。具体可以按照帮助文档中的描述的实现。

7. 手机运行功能

MeapStudio中除了提供HTML即时预览的功能外,还提供了手机运行功能,方便开发者在开发过程中将项目同步到手机门户下,可以方便的进行原生组件调用的调试。目前支持android及ios两种手机系统的调试。

使用手机运行功能之前,需要开发者先行安装苹果提供的ITunse工具,及待使用的android手机相应的驱动,并关闭所有手机助手软件,及后台运行进程。

具体使用:

  • 首先在需要运行的手机中安装门户应用,并下载参数配置中的目标应用。
  • 通过usb将手机连接到电脑,在MeapStudio的菜单栏Mobile中找到手机运行,如下图

app27

  • 点击 开始手机运行功能,MeapStudio开始启动手机文件通道,并将相关信息输入到控制台中,如下图:

app28

  • MeapStudio在开启了手机运行功能后,只要保持手机文件通道的开启,允许开发者在修改当前项目下的资源文件并保存时,即时同步到手机中,如下图:

app29

  • 当手机拔出,或者点击停止按钮,手机运行功能停止。

8. 轻应用打包

  • 在项目名称右键单击—>NQ APP TOOLS—>Packaging Light App

app30

图26 开发工具打包

app31

  • 生成以应用标识命名的zip包,完成后打开存放文件夹,如。

app32

图27 开发工具打包生成安装包

9. 轻应用上传

轻应用开发完毕后,需要开发者将轻应用的zip包上传到开发者平台中,相应的轻应用下。

  • 登录开发者平台,找到需要上传版本的轻应用。如下图;

app33

图31 打包上传

  • 进入轻应用信息,选择添加新版本按钮,如下图;

app34

图32 上传成功

  • 进入版本管理页面,填写版本更新动态,编辑版本号,点击选择文件按钮,选择开发完成,打包完毕的轻应用zip包,如下图;

app35

图33 上传文件信息

  • 点击保存后,跳转到应用管理页面,版本列表中显示应用为“未审核”,如下图:

app36

  • 至此开发工作告一段落。