Android---Native插件扩展机制v1.1.docxVIP

Native插件扩展机制功能描述：Native插件机制，是指针对native 开发者封装将具有特定功能但是平台没有封装的接口，封装成js调用Native功能，然后通过js扩展接口调用，以达到功能扩展的目的。AndroidSDK主要包括引擎jar包，接口类，android工程资源文件夹res，插件配置xml，widget文件夹等等。详细描述：引擎jar包engine_out_1.1.012_develop.jar位于工程目录的libs目录下，是利用appcan平台扩展native plugin的基础。接口类包括以下2个：EUExBase.java：封装用JS调用扩展native plugin的父类，需要继承，EUExCallback.java：与plugin的callback相关的一些常量资源文件夹（res文件夹）此文件夹中（包括子目录）已经定义或者命名的任何资源文件，不允许有任何重命名，删除等操作，这些资源文件属于AppCan平台所使用，一旦平台找不到相关资源文件，将报错退出。Error文件夹（assets目录下的error文件夹）error文件夹下存放网页访问错误时候显示的界面，必须拷贝到资源下，如果想定制自己的可以替换文件夹下资源但是不能修改文件名称，有可能导致文件找不到，加载方式同图片资源plugin.xmlplugin.xml 文件位于res目录下的xml目录中，是配置自定义native Plugin调用对象的xml文件，如果需要自定义对象和开发natvie plugin，必须在此文件中配置自定义js对象名和java类的包名类名。;widget 文件夹（assets目录下的widget文件夹）widget 文件夹为网页包，默认有config.xml 文件，基本数据已经默认填写，开发者只需修改部分参数即可，切勿删除config.xml 文件，widget文件也必须加载到工程中；配置工程打开eclipse，将appcan android工程导入。如图：等待eclipse自动编译完后，检查是否报错；如未报错，直接运行即可。其中：UexTestObject.java为自定义plugin的测试实例。Samples描述通过网页中调用native plugin 的开发流程：配置plugin.xml (1)、配置自定义对象，示例对象uexDemo对象配置如下：uexName：为封装的js对象的名称，可任意命名；className：与js对象映射的java对象的路径包名及类名；可定义多个plugin。(2)、定义与js对象映射的java类，此类必须继承自plugin的基础类：EUExBase，并实现或重写相关函数。UexTestObject.java具体回调网页方式请参考工程代码。API接口平台接入类平台的自带的生命周期函数进行了封装；JS调用Native plugin基础类------EUExBase.javaEUExBase对象成员描述：mBrwView：由构造函数传入的继承了Webview并封装了appcan 平台接口的EBrowserView的对象实例；mContext：AppCan平台的上下文，AppCan主Activity的实例。mUexId：AppCan平台为每个native扩展对象分配的id，主要做为startActivityForResult时的requestCode。EUExBase对象成员函数描述：- protected void jsCallback(String inCallbackName, int inOpCode, int inDataType, String inData)自定义对象完成一系列操作后回调网页js时的函数，其中：inCallbackName：网页中js函数的名称即所属js对象名称的集合。如：uexDemo.cbFunc1，即为uexDemo对象的func1函数被调用后，java回调js时的callback函数。inOpCode：网页中随机分配的不重复int类型的数值，主要用于区分一个js接口函数多次操作java中不同的对象。由网页调用native接口时传入。inDataType：本次回调网页js时，传给js的数据的数据类型，可参考EUExCallback对象下的静态值：F_C_TEXT，F_C_JSON，F_C_INT，F_C_STATUS。inData：回调给页面js的值。- protected void jsCallback(String inCallbackName, int inOpCode, int inDataType, int inData)同上。当返回的数据类型为F_C_INT等数值型时，需走这个callback。-protected void errorCallback(