目录

summer开发框架原生服务扩展可以cordova插件形式来进行。总的来说分为两大类:
(1)summer引用cordova官方仓库上发布的插件
(2)summer引用私有的cordova插件,即开发自己开发的插件
注:对于(1)的情况,可以支持绝大多数的cordova插件。一些涉及框架及app系统启动的cordova插件不支持,这受限于框架规范约束。

一、使用Cordova仓库中已有的插件

对于引用已经发布到Cordova仓库的插件的引用,开发者只需要通过开发工具上的配置文件进行简单的配置,即可实现引用插件的全过程。

1、创建summer工程

打开iUAPMobile开发工具,通过菜单栏中的【文件】->【新建】->【iUAPMobile Summer Project】, 打开创建项目向导,如图:

在创建项目向导中输入项目名称、默认包名,如图:

创建项目界面说明
1、项目名: 项目名称;
2、默认包名:不同APP包名不要相同,包名强制设置两层以上,比如:xxx.xxx;

输入完成后,点击“完成”,这时summer移动应用工程就创建完毕了。详细的可参见开发工具如何进行summer开发的相关文档。

2、配置cordova插件

1)找到工程项目目录下config.xml文件
2)在config.xml文件上右键-打开方式-XML Editor
3)配置此插件信息,添加样例:

  1. <import id="cordova-plugin-wechat" type="web" ref="cordova">
  2. <parameter>WECHATAPPID=xxxx</parameter>
  3. </import>

说明
a)import节点中,id属性为插件名称
b)parameter节点,为插件的参数信息,可以没有,也可以有多个,
c) 配置成功后,构建服务器在第一次构建打包时会自动去cordova 插件库下载当前最新的插件版本。如后期需要使用更高版本的cordova插件,可参考下一节中如何手动更新构建服务器上的cordova插件。构建服务器目前不支持自动更新cordova插件。
d)官网地址在http://cordova.apache.org/plugins/
例如以微信分享插件为例,还需对该插件要求的参数WECHATAPPID进行设置,具体设置可参见SummerAPI—微信分享
配置完毕后记得保存,接下来可以在代码中按照cordova插件的使用说明进行开发。

3、工程打包

如何使用cordova插件进行开发,可以参考cordova插件的使用,因为每个插件的用法是不一样的。app工程开发完毕后,就进入构建打包阶段。具体操作如下:
在开发工具选中summer项目,在弹出的鼠标右键菜单中,点击【新云端打包】,在弹出页面中选择构建生成安卓或者IOS包二维码,确定完成后,等待app构建成功后返回的二维码,进行扫码安装到手机上即可验证插件的使用情况。这些步骤都可以参看summer开发文档。关键步骤如下图所示:

二、手动扩展使用Cordova插件

对于在官网发布的cordova插件,由于构建服务器只在第一次构建时自动下载插件并应用于构建,并不会自动更新插件,所以在某些情况下开发者还需手动配置并使用corodva,手动配置适用于以下场景:
1)第一次使用自己封装开发的cordova插件,并未发布至cordova仓库的情况
2)自己修改插件(例如插件升级),需要引用的情况
3)需要使用cordova仓库上最新(或较高)版本的cordova插件的情况

以上情况都需要手动完成制作、上传构建服务器的过程。

1、获取cordova插件

1、插件来源
1)来源于cordova 插件库
http://cordova.apache.org/plugins/
2)来源于github
https://github.com/
3)开发者自己创建的或者修改过的插件

2、制作构建服务器可用zip包

构建服务器需要上传zip格式的cordova压缩包,将cordova插件直接压缩为zip包即可。corodva插件常见的目录结构如下图:

注意:
zip点开应该有插件名称的目录
点开zip中插件名称的目录,下面才是插件所含的各个资源,此目录下必须有plugin.xml

3、将制作好的zip包上传到云构建服务器

1)访问云构建服务器后台地址
http://mbs.yyuap.com/ump/html/index.jsp
2)登录并上传zip包
使用开发工具的账号和密码登录,找到(构建管理->cordova插件),点击新增,选择制作的zip包上传,上传完成后,点击确认

3)检查插件名称确认上传工程
查看列表中的插件名称,是否和自己定义的cordova插件名称一致。
注意:如需更新这里的插件,可先删除旧的插件,后新增。

4、配置开发工具使用此插件

1)找到项目目录下config.xml文件
2)在config.xml文件上右键-打开方式-XML Editor
3)配置此插件信息,例如下图:

  1. <import id="cordova-plugin-wechat" type="web" ref="cordova">
  2. <parameter>WECHATAPPID=xxx</parameter>
  3. </import>

说明
a)import节点中,id属性为插件名称
b)parameter节点,为插件的参数信息,可以没有,也可以有多个,
c) 配置成功后,构建服务器在第一次构建打包时会自动去cordova 插件库下载当前最新的插件版本。如后期需要使用更高版本的cordova插件,可参考下一节中如何手动更新构建服务器上的cordova插件。构建服务器目前不支持自动更新cordova插件。
d)官网地址在http://cordova.apache.org/plugins/
例如以微信分享插件为例,还需对该插件要求的参数WECHATAPPID进行设置,具体设置可参见SummerAPI—微信分享
配置完毕后就可以在代码中按照cordova插件的使用说明进行开发。

5、保存并打包测试

开发并使用插件进行编写代码,完毕后选中工程在弹出的鼠标右键菜单中选中新云端打包即可,按照构建出来的app进行验证插件功能,如下图所示:

三、Cordova插件扩展开发实例

Cordova插件扩展开发实例可参见SummerAPI—微信分享

文档更新时间: 2018-06-06 13:54