uniapp原生插件开发之调用原生方法(android)

由于uniapp官方更新,最新版的插件开发请跳转https://www.jianshu.com/p/89afba199d69

系列文章

uniapp插件开发与发布

需要实现的功能:

点击uniapp页面view,传递参数,调用android原生代码,然后原生代码处理数据,返回到uniapp页面

步骤

1.编写uniapp的视图页面

<template>
    <view class="content">
        <image class="logo" src="/static/logo.png" ></image>
        <view class="text-area">
            <text class="title">{{title}}</text>
        </view>
        
        <view @click="androidNative">点击调用android原生方法</view>
        
    </view>
</template>

<script>
    // 导入自己定义的插件js
    // var elitetyc = require('../../common/plugin.js');
    export default {
        data() {
            return {
                title: 'Hello',
                // plugins: elitetyc
            }
        },
        onLoad() {

        },
        methods: {
            // androidNative(){
            //  this.plugins.CalcNameAddNumFunction(
            //      "这段文字是uniapp传过来的",
            //      function(result) {
            //          uni.showToast({title:JSON.stringify(result),icon:'none',duration:5000});
            //      },
            //      function(result) {
            //          uni.showToast({title:result,icon:"none",duration:5000});
            //      }
            //  );
            // }
        }
    }
</script>

<style>
    .content {
        display: flex;
        flex-direction: column;
        align-items: center;
        justify-content: center;
    }

    .logo {
        height: 200upx;
        width: 200upx;
        margin-top: 200upx;
        margin-left: auto;
        margin-right: auto;
        margin-bottom: 50upx;
    }

    .text-area {
        display: flex;
        justify-content: center;
    }

    .title {
        font-size: 36upx;
        color: #8f8f94;
    }
</style>

代码中的注释是后面会用到的,咱们按步骤来,写好后的界面是这样,其实也就是创建一个项目后,加了一个view节点,并且增加了一个点击事件


B04D6E22-4DCF-4059-862E-3A576F91F14F.png

2.在当前uniapp目录下新建common目录,在目录下新建一个js文件,我这里叫plugin.js


8C1A31BB-EDC1-4675-B77D-489523687706.png

文件的内容如下
! function(root, factory) {  
if (typeof exports == 'object' && typeof module != 'undefined') {  
    module.exports = factory()  
} else if (typeof define == 'function' && define.amd) {  
    define(factory)  
} else {  
    document.addEventListener('plusready', function(){  
    // 修改此处为插件命名  注释---1
    var moduleName = 'elitetyc';   
    
    root.plus[moduleName] = factory()  
    },false);  
}  
}(this, function() {  
//在此处定义自己的方法  注释---2
var _BARCODE = 'elitetyc';  
var plugintest = {  
    // 这里定义了一个名叫CalcNameAddNumFunction的方法,传递三个参数,后面两个是回调函数
    CalcNameAddNumFunction: function(num, successCallback, errorCallback) {
        var success = typeof successCallback !== 'function' ? null : function(args) {
                successCallback(args);
            },
            fail = typeof errorCallback !== 'function' ? null : function(code) {
                errorCallback(code);
            };
      // 注释---3
        var callbackID = plus.bridge.callbackId(success, fail);
    // 注释---4
        return plus.bridge.exec(_BARCODE, "calcMyNameAddNum", [callbackID, num]);
    }
};  
return plugintest;  
});  

注释讲解:

  • 注释1:这里是定义插件的名称
  • 注释2:这里也是插件的名称,可以看到在后面的
plus.bridge.exec(_BARCODE, "calcMyNameAddNum", [callbackID, num]);

// 官方讲解有同步与异步,我这里只用了异步
void plus.bridge.execSync( String service, String action, Array<String> args );  
service: 插件类别名,对应dcloud_properties.xml的feature name。  
action: 调用android端插件方法名称。对应java文件的方法名。  
args: 参数列表。  

void plus.bridge.exec( String service, String action, Array<String> args );  
service: 插件类别名,对应dcloud_properties.xml的feature name。  
action: 调用android端插件方法名称。对应java文件的方法名。  
args: 参数列表。  
  • 注释3:回调ID,后面原生代码中会用到,就好像你调用我,我有结果了,我该知道我把数据返回给谁把?这个id就是这个作用
  • 注释4:在上面有讲到过,这里需要注意的是前两个参数,第一个参数是插件类别名,后面再原生代码中的dcloud_properties.xml文件中会用到
    第二个参数,是android原生代码中的方法名要一致
    3.到这里uniapp页面差不多都编写完成了,我们使用android studio导入sdk中的插件项目示例HBuilder-Integrate-AS


    AB229329-5534-487D-8534-D3C08566840C.png

    导入完成后,我们需要在项目中新建一个java文件,并且继承自:StandardFeature ,我写好的代码如下,功能很简单,主要就是为了完成uniapp调用原生

public class ElitetycPluginTest extends StandardFeature {

    /**
     * 定义一个方法 将自己的名字加上数字进行返回
     * @param pWebview
     * @param array
     */
    public void calcMyNameAddNum(IWebview pWebview, JSONArray array){
//        获取回调ID
        String CallBackID = array.optString(0);
//        获取参数并计算(这里模拟原生处理)
        String newstring = "你好,这个字符串来自android原生代码,您传过来的参数是:"+array.optString(1);
//        构建回传参数
        JSONArray newArray = new JSONArray();
        newArray.put(newstring);
//        JSUtil.execCallback(IWebview pWebViewImpl,String pCallbackId,String pMessage,int pStatus,boolean pKeepCallback)
//        参数:
//        pWebViewImpl - webview对象
//        pCallbackId - 回调方法ID
//        pMessage - 回调信息
//        pStatus - 回调code值 如:OK、ERROR
//        pKeepCallback - js层回调function是否要保存

    // 第一个参数是当前函数的入参,直接传入, 第二个是根据入参获取的回调id,第三个是回调的数据,是一个json数组
        JSUtil.execCallback(pWebview,CallBackID,newstring,JSUtil.OK,false);
    }
}

这里的方法名calcMyNameAddNum需要和plugin.js中的plus.bridge.exec( String service, String action, Array<String> args ); 方法的action参数一致,必须一模一样
4.将第一步中的注释代码打开,都是很简单的,就是js文件的引入,点击事件的编写

<script>
    // 导入自己定义的插件js
    var elitetyc = require('../../common/plugin.js');
    export default {
        data() {
            return {
                title: 'Hello',
                plugins: elitetyc
            }
        },
        onLoad() {

        },
        methods: {
// 这里是点击事件的响应
            androidNative(){
        // 点击事件内部调用了plugin.js中暴露的方法     this.plugins.CalcNameAddNumFunction(
                    "这段文字是uniapp传过来的",
                    function(result) {
                        uni.showToast({title:JSON.stringify(result),icon:'none',duration:5000});
                    },
                    function(result) {
                        uni.showToast({title:result,icon:"none",duration:5000});
                    }
                );
            }
        }
    }
</script>

5.打开uniAPP刚才写的plugintest这个项目,点击发行,然后本地生成app资源


2BB96F0D-954D-4E6C-B3B7-2340C3A64B1A.png

等待完成后,在当前项目的unpackage里面会生成对应的资源包,然后拷贝到androidstudio项目的assets的apps目录下,一定要从带appid那一层拷贝,拷贝后的目录


854D2E66-3BE1-4A6E-B5C7-8966761F1FE2.png

6.修改配置文件
  • 修改assets目录下的data目录下的dclould_control.xml文件appid修改为,刚才自己uniapp的appid
  • 修改dclould_properties.xml ,在里面新建
<feature name="elitetyc" value="com.example.H5PlusPlugin.ElitetycPluginTest"/>

然后再androidstudio运行当前项目,然后点击视图,就可以看到toast弹窗


D9A6598D-BE68-449E-8CA1-39D952D48EAB.png
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 157,298评论 4 360
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 66,701评论 1 290
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 107,078评论 0 237
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,687评论 0 202
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,018评论 3 286
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,410评论 1 211
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,729评论 2 310
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,412评论 0 194
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,124评论 1 239
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,379评论 2 242
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 31,903评论 1 257
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,268评论 2 251
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 32,894评论 3 233
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,014评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,770评论 0 192
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,435评论 2 269
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,312评论 2 260

推荐阅读更多精彩内容