Android移动APP开发笔记——Cordova（PhoneGap）通过CordovaPlugin插件调用 Activity 实例...

引言

Cordova（PhoneGap）採用的是HTML5+JavaScript混合模式来开发移动手机APP。因此当页面须要获取手机内部某些信息时（比如：联系人信息，坐标定位。短信等），程序就须要调用手机内部的API跟页面进行信息交换。Cordova 特别为此定制了完好的解决方式，以方便用户进行程序编辑。在这一章里将为大家逐一介绍Cordova与Actitity通讯的实现原理。

文件夹

一、CordovaPlugin类简单介绍

二、页面通过 cordova.exec 函数调用 CordovaPlugin 插件

三、CordovaInterface接口说明

四、页面通过CordovaPlugin插件调用Activity开发实例

一、CordovaPlugin类简单介绍

CordovaPlugin是Cordova插件的父类。用户自己定义的插件必须继承父类，它的主要经常使用属性例如以下

属性	具体说明
CordovaWebView	视图管理器。其中包含PluginManager、CordovaWebViewEngine、ICordovaCookieManager等多个对象，用于管理界面渲染，视图载入过程中的生命周期
CordovaInterface	定义startActivityForResult、setActivityResultCallback等主要方法，获取调用上下文中的Activity对象
CordovaPreferences	用于管理bundle中的属性值

表格1.1

CordovaPlugin的经常用法例如以下

方法	具体说明
void privateInitialize(String serviceName, CordovaInterface cordova, CordovaWebView webView, CordovaPreferences preferences)	插件初始化时运行，用于定义service名称。cordovaInterface接口。CodovaWebView视图，CordovaPreferences 属性等值
boolean execute(String action, String rawArgs, CallbackContext callbackContext)	在开发插件时，用户的自己定义方法。当页面调用插件时系统首先将会执行此方法
boolean execute(String action, JSONArray args, CallbackContext callbackContext)	同上
boolean execute(String action, CordovaArgs args, CallbackContext callbackContext)	同上
void onActivityResult(int requestCode, int resultCode, Intent intent)	在开发插件时，用户的自己定义方法。插件调用startActivityForResult后的回调函数。
String getServiceName()	获取在config文件里该服务的名称
Boolean shouldAllowRequest(String url)	推断是否同意此请求
Boolean shouldAllowNavigation(String url)	推断是否同意此导航
Boolean shouldOpenExternalUrl(String url)	推断是否打开外部链接
boolean onReceivedHttpAuthRequest(CordovaWebView view, ICordovaHttpAuthHandler handler, String host, String realm)
boolean onReceivedClientCertRequest(CordovaWebView view, ICordovaClientCertRequest request)

表格1.2

CordovaPlugin的具体解析可參考官网

http://cordova.apache.org/docs/en/3.4.0/guide_hybrid_plugins_index.md.html#Plugin%20Development%20Guide

回到文件夹

二、页面调用 CordovaPlugin 插件实例

大概了解 CordovaPlugin 类的用法后，以下为大家介绍一下页面调用插件的样例。首先打开文件res/xml/config.xml为插件进行配置。

<preference/>可用于执行环境中的经常使用參数，比如：全屏设置。滚动栏设置，背景色设置等等
<preference name="Fullscreen" value="true" />
<preference name="DisallowOverscroll" value="true"/>
<preference name="BackgroundColor" value="0xff0000ff"/>

<feature></feature>节点用于设置插件描写叙述，feature的name属性是设置插件的唯一标示。在页面调用插件时将通过name找到此插件
在开发插件时，先为此插件加入一个<feature>节点，在<param>中绑定插件的后台运行文件ShowMessagePlugin.java
<param name="android-package" value="org.apache.cordova.showmessage.ShowMessagePlugin" />

 1 <?

xml version='1.0' encoding='utf-8'?

2 <widget id="com.sun.androidapp" version="0.0.1" xmlns="http://www.w3.org/ns/widgets" xmlns:cdv="http://cordova.apache.org/ns/1.0"> 3  4 <preference name="loglevel" value="DEBUG" /> 5  6 <feature name="Whitelist"> 7 <param name="android-package" value="org.apache.cordova.whitelist.WhitelistPlugin" /> 8 <param name="onload" value="true" /> 9 </feature> 10 <feature name="ShowMessage"> 11 <param name="android-package" value="org.apache.cordova.showmessage.ShowMessagePlugin" /> 12 </feature> 13 <allow-intent href="market:*" /> 14  15 <name>AndroidTest</name> 16  17 <description> 18 A sample Apache Cordova application that responds to the deviceready event. 19 </description> 20  21 <author email="dev@cordova.apache.org" href="http://cordova.io"> 22 Apache Cordova Team 23 </author> 24  25 <content src="index.html" /> 26  27 <access origin="*" /> 28  29 <allow-intent href="http://*/*" /> 30 <allow-intent href="https://*/*" /> 31 <allow-intent href="tel:*" /> 32 <allow-intent href="sms:*" /> 33 <allow-intent href="mailto:*" /> 34 <allow-intent href="geo:*" /> 35 </widget>

建立org.apache.cordova.showmessage.ShowMessagePlugin类，且继承CordovaPlugin基类，并实现
bool execute(action,args,callbackcontext) 方法。当页面调用此插件时。默认运行此方法。

action 是唯一标识符。系统可依据不同的action进行不同的操作。
args是页面传入的參数，支持String， JsonArray。CordovaArgs 等三种不同的类型。

callbackcontext是系统的上下文。当完毕操作后调用callbackcontext.success（支持多类型參数）方法，表示插件操作已完毕。并把參数返还到页面。终于返回true代表插件运行成功，false代表运行失败

 1 package org.apache.cordova.showmessage;
 2
 3 public class ShowMessagePlugin extends CordovaPlugin {
 4     @Override
 5     public boolean execute(String action,JSONArray args,CallbackContext context)
 6             throws JSONException{
 7         if(action.equals("mydream")){
 8             String msg=args.getString(0)+"'s dream is to become a "+args.getString(1);
 9             context.success(msg);
10             return true;
11         }
12         return false;
13     }
14 }

在 cordova.js 包中。最经常使用的是 cordova.exec（success,failed,service,action,args）函数。页面正是通过此函数调用插件。
success 用于绑定插件运行成功后回调的回调函数
failed用于绑定运行失败的回调函数
service与config.xml配置文件里feature字节的name属性相相应
action与ShowMessagePlugin对象boolean excute方法中action參数相应，用于分辨插件运行的方法类型，插件可依据action类型的不同作出分类处理。
args为输入參数

 1        Name: <input type="text" id="txt1"/>&nbsp;&nbsp;&nbsp;&nbsp;
 2        Dream:<input type="text" id="txt2"/>&nbsp;&nbsp;&nbsp;&nbsp;
 3        <input type="button" οnclick="btnclick()" name="btn" value="Click"/> <br/>
 4        <label id="label"></label>
 5
 6        <script type="text/javascript">
 7
 8             function btnclick(){
 9                  var name=$("#txt1").val();
10                  var dream=$("#txt2").val();
11                  //通过 cordova.exec (success,failed,serviceName,action,args)函数调用插件
12                  cordova.exec(success,failed,"ShowMessage","mydream",[name,dream])
13             }
14
15             //成功调用插件，获取返回值后的页面处理函数
16             function success(result){
17                  if(result!=null)
18                      $("#label").html(result);
19                  else
20                      alert("no message");
21             }
22
23             //调用失败后的处理函数
24             function failed(msg){
25                  ......
26             }
27        </script>

測试结果

回到文件夹

三、CordovaInterface接口说明

CordovaInterface 接口默认是由 CordovaInterfaceImpl 类实现的。其中包含了一个Activity对象。当打开APP时 Cordova 会默认启动此 Activity 以承载 Cordova 核心引擎对程序进行管理。

ExecutorService 则负责对象对线程池进行管理，PluginManager则负责对插件进行管理。CordovaPlugin则是Cordova插件的父类。全部插件都必须继承CordovaPlugin。

属性	具体说明
Activity	打开APP时 Cordova 会默认启动此 Activity 以承载 Cordova 核心引擎对程序进行管理
ExecutorService	对线程池进行管理
PluginManager	插件管理器，用于管理插件的生成，执行。结束等生命周期
CordovaPlugin	通过startActivityForResult方法绑定CordovaPlugin插件
ActivityResultHolder	内部类，封装了requestCode, resultCode, intent等对象

表格2.1

CordovaInterfaceImpl定义了三个最经常用法

方法	具体说明
void startActivityForResult(CordovaPlugin command, Intent intent, int requestCode)	绑定CordovaPlugin參数，并调用Activity对象的startActivityForResult(intent, requestCode)方法，依据 intent 绑定值跳转到相应的activity
void setActivityResultCallback(CordovaPlugin plugin)	激发CordovaPlugin对象的onActivityResult事件
boolean onActivityResult(int requestCode, int resultCode, Intent intent)	封装Acticity对象的onActivityResult回调函数，激发CordovaPlugin对象的onActivityResult事件

表格2.2

回到文件夹

四、页面通过CordovaPlugin插件调用Activity开发实例

类似于第一节实例，在页面通过cordova.exec（success,failed,service,action,args）方法调用插件。返回时调用success函数进行处理显示结果

 1        出游省份：
 2        <select id="select1">
 3           <option value='1' selected='selected'>黑龙江</option>
 4           <option value='2'>吉林</option>
 5           <option value='3'>辽宁</option>
 6        </select>
 7        <input type="button" onclick="btnclick()" name="btn" value="查找"/> <br/>
 8        路线景点：
 9        <label id="label"></label><br/>
10
11        <script type="text/javascript">
12
13             function btnclick(){
14                  var province=$("#select1").val();
15                  //通过 cordova.exec (success,failed,serviceName,actionName,args)函数调用插件
16                  cordova.exec(success,null,"ShowMessage","showMessage",[province]);
17             }
18
19             //成功调用插件。获取返回值后的页面处理函数
20             function success(result){
21                  if(result!=null)
22                      $("#label").html(result);
23                  else
24                      alert("no message");
25             }
26        </script>

插件通过推断action參数推断进行不同的处理，然后通过Intent对象绑定将要启动的Activity,最后通过CordovaInterface中的startActivityForResult（cordovaPlugin,intent,int）方法启动该Activity。当 Activity 结束后，系统将调用回调函数 onActivityResult(int requestCode, int resultCode, Intent intent)

在此说明一下Intent类的用途，此类主要用于绑定当前的活动与子活动之间关系，其中包括6种构造函数。

1、Intent() 空构造函数

2、Intent(Intent o) 拷贝构造函数

3、Intent(String action) 指定action类型的构造函数

4、Intent(String action, Uri uri) 指定Action类型和Uri的构造函数，URI主要是结合程序之间的数据共享ContentProvider

5、Intent(Context packageContext, Class<?> cls) 传入组件的构造函数，也就是此样例中使用到的

6、Intent(String action, Uri uri, Context packageContext, Class<?

> cls) 前两种结合体

Intent 类中封装了一个Bundle 对象 mExtras，可用于主活动与子活动之间传值，系统可通过 putExtra 方法把參数传入mExtras, 也可通过 getShortExtra、getIntExtra、getBooleanExtra、getByteExtra 等多个方法从mExtras 获取參数值。

 1 public class ShowMessagePlugin extends CordovaPlugin {
 2     private CallbackContext context;
 3
 4     @Override
 5     public boolean execute(String action,JSONArray args,CallbackContext context)
 6              throws JSONException{
 7         this.context=context;
 8         //依据action推断调用方法
 9         if(action.equals("showMessage")){
10             //通过Intent绑定将要调用的Activity
11             Intent intent=new Intent(this.cordova.getActivity(),SpotActivity.class);
12             //增加将要传输到activity中的參数
13             intent.putExtra("province", args.getString(0));
14             //启动activity
15             this.cordova.startActivityForResult(this, intent, 0);
16         }
17         return true;
18     }
19
20     @Override
21     public void onActivityResult(int requestCode, int resultCode, Intent intent) {
22         // 依据resultCode推断处理结果
23         if(resultCode==Activity.RESULT_OK){
24             String spot=intent.getStringExtra("spot");
25             context.success(spot);
26         }
27     }
28 }

Activity 被触发后先通过 setContentView 方法绑定视图，再从intent 对象中获取输入參数进行处理。
完毕操作后。通过 Activity 类 setResult(int resultCode,Intent data) 方法绑定返回值，当中resultCode可被cordovaPlugin 插件用作推断返回值的处理结果。

最后调用 Activity 对象的 finish 方法关闭 SpotActivity，把返回值回传到 CordovaPlugin。

 1 public class SpotActivity extends Activity{
 2     private CheckBox chk1,chk2,chk3;
 3
 4     @Override
 5     public void onCreate(Bundle savedInstanceState){
 6         super.onCreate(savedInstanceState);
 7         //绑定视图
 8         setContentView(R.layout.goods_list);
 9         //从intent中获取输入參数
10         Integer province=Integer.parseInt(this.getIntent().getStringExtra("province"));
11         setSpots(province);
12     }
13
14     private void setSpots(Integer n){
15         this.chk1=(CheckBox)this.findViewById(R.id.checkBox1);
16         this.chk2=(CheckBox)this.findViewById(R.id.checkBox2);
17         this.chk3=(CheckBox)this.findViewById(R.id.checkBox3);
18         switch(n){
19             case 1:
20                 chk1.setText("漠河");
21                 chk2.setText("北极村");
22                 chk3.setText("九曲十八湾");
23                 break;
24             case 2:
25                 chk1.setText("长白山");
26                 chk2.setText("雾凇岛");
27                 chk3.setText("朝鲜自治州");
28                 break;
29             case 3:
30                 chk1.setText("鸭绿江");
31                 chk2.setText("笔架山");
32                 chk3.setText("凤凰山");
33                 break;
34             default:
35                 break;
36         }
37     }
38
39     public void btn_onClick(View view){
40         String spot="";
41         if(chk1.isChecked())
42             spot+=chk1.getText();
43         if(chk2.isChecked())
44             spot+=" "+chk2.getText();
45         if(chk3.isChecked())
46             spot+=" "+chk3.getText();
47         //通过setResult绑定返回值
48         Intent intent=new Intent();
49         intent.putExtra("spot",spot);
50         setResult(RESULT_OK,intent);
51         //关闭该activity，把返回值传回到cordovaPlugin插件
52         this.finish();
53     }
54 }

Activity 视图

 1 <?xml version="1.0" encoding="utf-8"?>
 2 <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
 3     android:layout_width="match_parent"
 4     android:layout_height="match_parent"
 5     android:layout_alignParentBottom="true"
 6     android:orientation="vertical" >
 7     <TextView
 8         android:layout_width="wrap_content"
 9         android:layout_height="wrap_content"
10         android:text="选择景点"
11         android:layout_marginTop="80dp"/>
12     <CheckBox
13         android:id="@+id/checkBox1"
14         android:layout_width="wrap_content"
15         android:layout_height="wrap_content"/>
16     <CheckBox
17         android:id="@+id/checkBox2"
18         android:layout_width="wrap_content"
19         android:layout_height="wrap_content"/>
20     <CheckBox
21         android:id="@+id/checkBox3"
22         android:layout_width="wrap_content"
23         android:layout_height="wrap_content"/>
24     <Button
25         android:id="@+id/button1"
26         style="?

android:attr/buttonStyleSmall"

27 android:layout_width="wrap_content" 28 android:layout_height="40dp" 29 android:text="确认" 30 android:layout_marginTop="20dp" 31 android:onClick="btn_onClick"/> 32 </LinearLayout>

activity 关闭后。cordovaPlugin 插件将调用回调函数 onActivityResult(int requestCode, int resultCode, Intent intent)，回调函数中可依据 resultCode 參数推断处理情况。依据不同的结果对intent 中的返回值 bundler 对象进行不同处理。

最后使用 callbackContext 对象中的 success(string) 方法把处理结果回传到页面;

处理结果：

回到文件夹

本章小结

Cordova（PhoneGap）技术使用了CordovaPlugin 插件化（模块化）技术。使用不同插件对不同HTML5页面进行分别处理。与此同一时候，系统也能够利用插件调用系统已有的地图、通信录、浏览器等多个API。与 HTML5 页面进行信息交换。真正实现HTML5与Android、iOS系统的无缝对接。

參考文章

Cordova（PhoneGap）通过CordovaPlugin插件调用 Activity 实例

最新版Cordova 5.1.1（PhoneGap）搭建开发环境

Apache2.2+Tomcat7.0整合配置具体解释

Windows Server 2008 R2 负载平衡入门篇

作者：风尘浪子

http://www.cnblogs.com/leslies2/p/cordovaPlugin.html

原创作品，转载时请注明作者及出处

转载于:https://www.cnblogs.com/jzdwajue/p/7199222.html

Android移动APP开发笔记——Cordova（PhoneGap）通过CordovaPlugin插件调用 Activity 实例...相关推荐

Android移动APP开发笔记——最新版Cordova 5.3.1（PhoneGap）搭建开发环境
引言简单介绍一下Cordova的来历,Cordova的前身叫PhoneGap,自被Adobe收购后交由Apache管理,并将其核心功能开源改名为Cordova.它能让你使用HTML5轻松调用本地AP ...
Android Native APP开发笔记：文件存储与访问
文章目录目的基础说明应用专属存储空间共享存储其它总结目的 APP开发与使用过程中免不了和文件打交道,对于Windows或Linux而言文件的存储与访问操作都很方便,直接通过文件系统路径和 ...
Android Studio App开发之网络通信中使用POST方式调用HTTP接口实现应用更新功能（附源码超详细必看）
运行有问题或需要源码请点赞关注收藏后评论区留言~~~ 一.POST方式调用HTTP接口 POST方式把接口地址与请求报文分开,允许使用自定义的报文格式,由此扩大了该方式的应用场景.POST请求与GET ...
Android Native APP开发笔记：从新建到打包流程记录
文章目录目的下载与安装新建项目与运行调试更换名称和图标打包应用 applicationId 版本控制真机调试总结题外话目的安卓是现在移动端平台占有率最大的平台,如果进行移动端用户应 ...
Android Native APP开发笔记：使用WebView控件加载网页
文章目录目的基础使用处理网页导航加载本地网页 Web和Native之间交互调试Web应用处理页面重绘总结目的 WebView是一个比较常用的控件,功能上也比较单一,就是用来加载网页的, ...
Android Native APP开发笔记：双击返回键退出应用单击返回键返回桌面
文章目录目的基础说明双击返回键退出应用单击返回键回到桌面总结目的双击返回键退出应用很早之前就是Android中非常常见的一种功能,而目前好多安卓应用为了应用常驻都改为使用单击返回键返 ...
android 推送图标大小,Android状态栏图标大小 – 使用Cordova / Phonegap推送插件
我正在使用Ionic(Cordova AngularJS)开发 Android应用程序.有了它,我使用推送插件( https://github.com/phonegap-build/PushPlugi ...
Android 开发笔记（一）按钮事件调用Activity
UI创建按钮及事件 Button mEmailSignInButton = (Button) findViewById(R.id.email_sign_in_button);mEmailSignInB ...
【Android】Parse开发笔记（1）—— 准备
一.简介 Parse是由 YC 孵化出来的.专为移动应用提供后台服务的云计算平台,为开发者包办繁琐的后台服务,让开发者只需专注于具体的开发工作.它提供任意数据保存.照片或其它文件存储.发送推送通知.创 ...

Android移动APP开发笔记——Cordova（PhoneGap）通过CordovaPlugin插件调用 Activity 实例...

Android移动APP开发笔记——Cordova（PhoneGap）通过CordovaPlugin插件调用 Activity 实例...相关推荐

最新文章

热门文章