Android移动APP开发笔记——Cordova(PhoneGap)通过CordovaPlugin插件调用 Activity 实例
Cordova(PhoneGap)採用的是HTML5+JavaScript混合模式来开发移动手机APP。因此当页面须要获取手机内部某些信息时(比如:联系人信息,坐标定位。短信等),程序就须要调用手机内部的API跟页面进行信息交换。Cordova 特别为此定制了完好的解决方式,以方便用户进行程序编辑。在这一章里将为大家逐一介绍Cordova与Actitity通讯的实现原理。
文件夹
二、页面通过 cordova.exec 函数调用 CordovaPlugin 插件
四、页面通过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的具体解析可參考官网
二、页面调用 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 <!-- 该APP名称 --> 15 <name>AndroidTest</name> 16 <!-- APP描写叙述 --> 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 <!-- 指定app可进行通信的域名。*为全部 --> 27 <access origin="*" /> 28 <!-- App默认仅仅请同意通过手机端直接打开。若想通过站点,SMS等方式调用APP,则须要设置allow-intent配置 --> 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"/> 2 Dream:<input type="text" id="txt2"/> 3 <input type="button" onclick="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) 方法把处理结果回传到页面;
处理结果: