APP NEST轻应用开发
1. 使用流程
图一 产品申请、部署及上线流程
图二 APP NEST轻应用开发流程
2. 产品申请
若申请入驻式产品部署,需填写《产品申请单》,《产品申请单》可填写是正式购买使用还是用户试用,若使用则填写试用周期。此种申请方式是在客户现场部署环境使用。
另外,若仅仅是使用,产品也搭建了阿里云的试用环境,可以远程试用,不用在客户现场进行入驻式的部署,这种试用方式快捷高效,不用填写《产品申请单》,需要相关人员发送邮件到“APPNEST@ntaionsky.com”,主要描述清楚客户信息以及项目名称,申请完毕后提供环境使用账号。
3. 创建应用
用户获取到开发环境之后,首先在用户本地安装开发工具,开发工具是用来开发轻应用使用,当然用户也可以选择不安装:
1) 双击NationSkyIDESetup_X86.exe安装程序,点击“下一步”按钮
图1 开发工具安装过程
2) 选择安装位置点击“下一步”按钮
图2 开发工具安装路径
3) 点击“安装”按钮开始软件安装过程
图3 开发工具安装过程
4) 点击“安装”按钮,开始安装开发平台
图4 开发工具安装过程
5) 点击“完成”按钮,完成开发平台安装过程
图4 开发工具安装完成
说明:
- 若勾选“启动国信灵通移动开发平台”则安装完成后自动运行开发平;
- 若勾选“访问产品网站”则安装完成后会自动打开国信灵通产品官网。
4. 工具介绍
4.1 工具主页
双击开发工具,选择项目存储路径,点击OK按钮。
图5 开发工具工作空间选择
进入工具主页面,MeapStudio为开发者提供了快捷创建应用以及RMS服务功能,如下图所示;
图6 开发工具首页
同时开发者可以点击下面的快捷菜单,进入APP NEST文档中心,查看对应的功能介绍。
4.2 NationSky透视图
MeapStudio为开发者提供了强大的MeapStudio透视图功能,见下图;
图7 开发工具打开透视图
点击OK,打开透视图后,如下图所示;
图8 开发工具透视图
说明:
- 项目资源管理器
该工作区域以树形结构形式显示项目信息。
- RMS API
公共服务列表由APP NEST平台提供,提供所有应用使用。
- 组件区域
未开发这提供内置的JS组件代码,可直接拖拽到页面中生成js代码。
- 代码编辑区域
该区域主要是对HTML、JS、CSS、XML代码进行编辑、展示。
- HTML即时浏览器
代码编辑完成后,通过该浏览器能够即时的查看编辑后的效果。
4.3 参数配置
单击菜单栏中的Window—>Preferences选项,弹出参数配置窗口,如下图;
图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 创建应用
首先在登录开发者平台创建轻应用项目,如下图;
图 创建轻应用-1
图 创建轻应用-2
- 应用图标:此图片是在门户客户端桌面进行显示的,请要求UI设计人员按照规定的尺寸大小提供:57*57像素。
- 定义应用名称:给该应用定义一个名称,用来标识该应用是什么应用,比如移动OA、移动展业
- 定义应用类型:轻应用包含三种模式:1.HTML5的zip包。2.外部的URL;3.服务型应用 这里我们选择zip包类型.
- 定义应用标识:应用标识由平台自动生成。
- 应用类别:门户中应用所在的类别。
- 应用简介:对该应用做一个简短的文字描述。
- 版本更新动态:对该应用版本更新做一个简短的文字描述。
- 后台地址:轻应用后台维护地址。
- 调用接口:开发者勾选需调用的平台API接口,平台管理员审核通过后可调用。
- 点击保存,应用创建完成。
5.2 接口审核
平台管理员在管理平台的“开发者管理”模块中,可对开发者调用接口申请进行审核,通过勾选批准调用的应用来审核开发者提出的平台接口调用申请,通过后该应用方可调用。
图 审核轻应用接口权限
5.3 创建项目
在管理平台创建好应用项目后,客户端开发人员就可以利用开发工具来开发移动应用了,操作步骤如下:
5.3.1
1) 打开MeapStudio,在File->New菜单中选择Light Project.
图12 开发工具新建工程
2) 选择应用ID(管理平台创建的应用ID),输入项目名称,点击Next进行下一步。如下图:
说明:
appKey(轻应用标识)与appSecret(轻应用密匙)是非必填项,但是在手机运行功能中需要二者进行平台验证;所以请确保二者的正确性。
项目名称是必填项,验证要求与eclipse中对project名称校验一致。
3) MeapStudio中提供部分场景的轻应用模版供开发者使用,如下图;
图17 开发工具工程模板
4) 以空模板为例,选择完成后点击Finish,项目创建完成。
5.3.2 新建项目元素
1) 打开MeapStudio,在File->New菜单中选择NationSky Studio Element.
图18 开发工具Element选择
2) 选择Css文件单击下一步,选择文件存放路径,给新建文件一个名称,点击Finish按钮创建Css文件完成。
图19 开发工具css文件向导
5.3.3 项目架构
如下图所示;
图20 开发工具工程架构
说明:
1) Config:项目配置基本信息,包括项目的版本号,应用名称等。
图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代码助手
图22 内置Aptana预览
2) 调试代码,在预览区域点击open DevTools
图23预览区
3) 弹出调试窗口
图24 代码调试窗口
4) 内置Emmet,使用方法请参照Help—>Help Contents帮助文档,如下图;
图25 内置Emmet
如:输入!号,按Tab键将会快速生成上述HTML框架代码。输入a,按Tab键将会快速生成超链接标签等。具体可以按照帮助文档中的描述的实现。
7. 手机运行功能
MeapStudio中除了提供HTML即时预览的功能外,还提供了手机运行功能,方便开发者在开发过程中将项目同步到手机门户下,可以方便的进行原生组件调用的调试。目前支持android及ios两种手机系统的调试。
使用手机运行功能之前,需要开发者先行安装苹果提供的ITunse工具,及待使用的android手机相应的驱动,并关闭所有手机助手软件,及后台运行进程。
具体使用:
- 首先在需要运行的手机中安装门户应用,并下载参数配置中的目标应用。
- 通过usb将手机连接到电脑,在MeapStudio的菜单栏Mobile中找到手机运行,如下图
- 点击 开始手机运行功能,MeapStudio开始启动手机文件通道,并将相关信息输入到控制台中,如下图:
- MeapStudio在开启了手机运行功能后,只要保持手机文件通道的开启,允许开发者在修改当前项目下的资源文件并保存时,即时同步到手机中,如下图:
- 当手机拔出,或者点击停止按钮,手机运行功能停止。
8. 轻应用打包
- 在项目名称右键单击—>NQ APP TOOLS—>Packaging Light App
图26 开发工具打包
- 生成以应用标识命名的zip包,完成后打开存放文件夹,如。
图27 开发工具打包生成安装包
9. 轻应用上传
轻应用开发完毕后,需要开发者将轻应用的zip包上传到开发者平台中,相应的轻应用下。
- 登录开发者平台,找到需要上传版本的轻应用。如下图;
图31 打包上传
- 进入轻应用信息,选择添加新版本按钮,如下图;
图32 上传成功
- 进入版本管理页面,填写版本更新动态,编辑版本号,点击选择文件按钮,选择开发完成,打包完毕的轻应用zip包,如下图;
图33 上传文件信息
- 点击保存后,跳转到应用管理页面,版本列表中显示应用为“未审核”,如下图:
- 至此开发工作告一段落。