安卓SDK

手机ad - 图1

更新时间:2022-11-07 16:11:58
文档

动作(名称与参数)表

动作名称 动作说明 动作参数 动作参数说明 调用自定义方法 方法名称 自定义SDK中定义的方法名称 参数 调用自定义SDK的参数,是一个对象,比如{name:”abc”,id:11}

动作(回调)表

对应动作 结果引用 结果状态 结果引用属性 结果属性说明 调用自定义方法
属性·动作·事件

使用场景


iVX目前的发布为安卓app的功能,是通过将应用作为webview封装为本地资源,并在原生层提供各种webview中可使用的js接口来完成的。 在iVX系统封装的功能之外,用户还可以额外通过上传SDK的方法,来额外扩展原生java层的功能 比如,接入新的蓝牙协议,接入第三方的应用的前端接口sdk等等。

SDK使用流程


使用安卓SDK,首先需要在编辑器 - SDK资源处进行上传。
手机ad - 图2
安卓SDK本身是一个java的zip文件,需要按一定的结构和规范进行编写, 因此,您或者您的团队成员需要具有一定的原生安卓开发能力,才能使用安卓SDK功能,并不是任意一个第三方SDK都能直接上传编译的。
上传完SDK之后,在前端“SDK”入口中,选择一个SDK添加在前台,即可在应用中使用它。 使用方法,类似API组件 注意,一个应用只能添加一个安卓SDK 如果有多个模块的功能需要添加,可以在上传的SDK包中,同时添加多个功能模块
手机ad - 图3
使用安卓SDK调用SDK内方法可参见DEMO:
https://www.ivx.cn/ih5/app/template/download?id=4750

SDK文件编写规范


在SDK资源详情界面,点击添加前台SDK资源,点击模板格式下载模板调试壳应用。
手机ad - 图4
解压下载压缩包后,IvxExtApp文件夹整体为SDK调试用壳应用, 可在Android Studio打开进行调试
修改SDK功能的目录为 IvxExtApp\extlib\src\main\java\cn\ivx\extlib
1.添加SDK功能入口
extlib入口 IvxExtRouter.java, 添加SDK方法时,需要对应在IvxExtRouter方法内-对应补充对应fn和方法调用
手机ad - 图5
IvxExtRouter.java 文件内的其他内容-不需要修改,仅修改IvxExtRouterf方法即可
2.编写SDK具体功能
参考HelloHandler.java写法,调用功能的入口为重写的Handle方法
手机ad - 图6
3 编写SDK回调方法(如有需要)
extlib入口 IvxExtRouter.java,如果需要有在sdk端接收某些消息时,或着定时通讯回调到应用页面的情况,可以将事件名声明为一种 fn (注意不要与app调用sdk方法的fn重名)。
IvxExtRouter实例内使用 this.callback.HandleEvent(String eventName, String params);
通过这个动作,可以将回调消息从app上报到应用页面
手机ad - 图7
4 调用SDK回调方法(如有需要)
app的sdk调用回调方法通知,使用 IvxExtRouter 实例的 routeInner方法并传入回调名,回调参数即可。
手机ad - 图8
5 应用中监听回调消息
应用中目前可采用自定义函数注册监听回调函数,可以前台初始化或需要监听回调时调用
3.打包SDK库
打包方法,在测试壳应用的root目录使用命令: ./gradlew packLib 会在当前目录生成extlib.zip文件。 打包后可用Android Studio对测试壳项目进行调试。调试可应用通过后,方可上传SDK文件。

注意:上传SDK文件时只需要上传extlib.zip包即可