要在studio上开发APICloud的模块,需要现在APICloud的官网上下载相对应的模块开发SDK(具体操作流程可以参考官方文档)。
将下载好的SDK解压并添加到studio中,创建android library模块,在app的bulid.gradle文件中添加compileproject(‘:模块名’)引用模块;
创建一个类来继承UZModule或者APIModule类,并重写其构造方法,并在app目录assets的uzmap文件夹的module.json文件中添加
{
“name”: “模块名”,
“class”: “继承了UZModule类的包路径”
}
在该类中添加publicvoidjsmethod_方法名(UZModuleContext moduleContext){} 固定格式的方法,引擎会自动将改函数映射为js函数,只需要在js中使用 var name= api.require(‘模块名’),加载模块,然后name调用对应的方法名即可。使用moduleContext的opt方法可以获取js传递的值(使用get方法,如果未传入对应的值,会报异常;而使用opt则会返回null,不会报异常),如想要将值回调给js,使用moduleContext的success或error方法即可。
打包:新建一个为模块名的文件夹,新建module.json文件,并将对应模块在app中module.json文件中的配置复制进来,
public class ModuleTest extends UZModule {
public void jsmethod_test(UZModuleContext moduleContext) {
String name = moduleContext.optString("name");
JSONObject ret = new JSONObject();
ret.put("pwd",123);
moduleContext.success(ret );
}
}
//js 调用,使用moduleDemo模块
var myModuleDemo= api.require('moduleDemo');
myModuleDemo.test({
name:'name'
},function(ret,err){
console.log(ret.pwd);
});
点击模块名字,点击bulid菜单下的Make Module+模块名 编译模块;
完成后将模块bulid/ouputs/arr路径下的-release.arr文件复制到上述文件夹中,并将-release去掉,将文件名改成和模块名一致。然后压缩成zip包,上传到APICloud的自定位模块。
APICloud不建议使用R文件,所以提供了UZResourcesIDFinder类来获取资源的id,
UZResourcesIDFinder.getResLayoutID(“布局文件名”) 获取布局文件id
UZResourcesIDFinder.getResIdID(“控件id”) 获取控件id