android apicloud 自定义插件

本文简单介绍使用as写一个简单的自定义apicloud模块(其中的示例是一个获取蓝牙地址的demo).

首先看一下目录结构:

 

 

红色方块内的是需要编写的,首先新建项目并添加一个module(Android Library类型)并添加依赖,新建一个任意名称Java文件写插件,module内存放的是java类的路径和调用的js名称(在我看来就是模块名称).

先看java文件:

 

/**
 * Created by th2 on 2017/8/15.
 * 本地蓝牙地址
 */

public class LocalBlueAddressDemo extends UZModule{

    public LocalBlueAddressDemo(UZWebView webView) {
        super(webView);
    }

    public void jsmethod_localBlueAddress(final UZModuleContext moduleContext){
        JSONObject json = new JSONObject();
        try {
            json.put("blueaddress",getBtAddressViaReflection());
        } catch (JSONException e) {
            e.printStackTrace();
        }
        moduleContext.success(json,true);
    }

    private String getBtAddressViaReflection() {
        BluetoothAdapter bluetoothAdapter = BluetoothAdapter.getDefaultAdapter();
        Object bluetoothManagerService = new Mirror().on(bluetoothAdapter).get().field("mService");
        if (bluetoothManagerService == null) {
            Log.w("TAG", "couldn't find bluetoothManagerService");
            return null;
        }
        Object address = new Mirror().on(bluetoothManagerService).invoke().method("getAddress").withoutArgs();
        if (address != null && address instanceof String) {
            Log.w("TAG", "using reflection to get the BT MAC address: " + address);
            return (String) address;
        } else {
            return null;
        }
    }
}

 

首先这个类必须继承UZModule并且方法名必须是jsmethod_方法名,如果不是上述类型是检测不到你的方法的,在其中你可以使用moduleContext.success()使用成功回调,这里是一个简单的获取蓝牙地址的方法.

然后看module.json:

 

{
   name:'taihuaBlueDemo',
   class:'com.example.bluelibrary.LocalBlueAddressDemo'
}

 

其中name就是插件的名称,class就是java的路径(包名+类名),注意,这里有个坑是不能按照官方的demo那样写成中括号类型的.然后rebuild一下项目(前提是你已经在项目中添加了依赖).

 

然后你会在bluelibrary>build>intermediates>bundles>release文件下找到一个classes.jar的文件,这个文件就是你生成的jar(当然可以改成任意名称).

然后你需要创建一个文件夹用来存放模块,其中文件夹名称就是模块名称.下面是文件夹目录结构:

 

res_blueDemo用来存放你的资源文件和AndroidManifest.xml,source里面存放你刚才获得的jar文件.然后将整个文件压缩.然后只要上传就可以了

 

js的调用时:

 

var demo = api.require('*******');
demo.localBlueAddress(function (ret, err) {  
  });

 

****就是模块的名字,localBlueAddress是方法的名称.

划重点!!!!!!!其中遇到的一个大坑,在我的插件中我使用的三方的依赖，导致我每次调用的时候都是报错.

比如说我在获取蓝牙地址的时候使用了mirror-1.6.1.jar这个文件,只需要下载它的jar文件再将它加入到source文件中就可以了,天啊撸,浪费了我好长的时间.