美文网首页
cordova 自定义(plugin)插件开发

cordova 自定义(plugin)插件开发

作者: 孤独的白菜 | 来源:发表于2016-03-24 23:33 被阅读1314次

    跟着白菜一起开发一个属于自己的Cordova插件吧!GO,GO,GO!

    准备工作

    工具原料

    • Mac 电脑
    • Cordova环境
    • Cordova工程
    • xode

    开始创建插件

    打开终端,输入一下命令(PS:如果这里没有plugman命令,自己百度解决)

        plugman create --name ibaicai --plugin_id com.lichanglong.ibaicai --plugin_version 1.0.0
    

    插件的的目录结构

    插件的目录结构,如图。src 目录下面是空的。

    插件目录结构图

    plugin.xml文件

     該name
     提供模組名稱的最後一部分。 如果你想要使用cordova.require
     來導入你的外掛程式在 JavaScript 代碼中的其他部分,它一般
      可以無論你喜歡,和它的唯一事項。 模組名稱為< js-module > 是你的外掛程式id
    後, 跟名稱的值。 例如上面, id
    為chrome.socket
    的模組名稱是chrome.socket.Socket
    

    .
    <?xml version='1.0' encoding='utf-8'?>
    <plugin id="com.lichanglong.ibaicai" version="1.0.0" xmlns="http://apache.org/cordova/ns/plugins/1.0" xmlns:android="http://schemas.android.com/apk/res/android">
    <name>ibaicai</name>
    <js-module name="ibaicai" src="www/ibaicai.js">
    <clobbers target="cordova.plugins.ibaicai" />
    </js-module>
    </plugin>

    ibaicai.js文件

    var exec = require('cordova/exec');
    exports.coolMethod = function(arg0, success, error) {
        exec(success, error, "ibaicai", "coolMethod", [arg0]);
    };
    <!--这里要说活的是, success,errror都是一个回调,看我的调用代码就明白了,ibaicia:表示调用的ios类,也就是下面配置ios .h .m文件的别名。"coolMethod":表示调用类的的方法入口-->
    

    好了,到此处的时候一个插件就圆圆滚滚的开发完成了。_
    好了,扯了会儿犊子,继续吧。还没完呢。

    改造一下,plugin.xml里面的配置。

    <?xml version='1.0' encoding='utf-8'?>
    <plugin id="com.lichanglong.ibaicai" version="1.0.0" xmlns="http://apache.org/cordova/ns/plugins/1.0" xmlns:android="http://schemas.android.com/apk/res/android">
    <name>ibaicai</name>
    <js-module name="ibaicai" src="www/ibaicai.js">
        <clobbers target="cordova.plugins.ibaicai" />
    </js-module>
    
    <!-- iOS -->
    <platform name="ios">
        
        <header-file src="src/ios/ibaicai.h" />
        <source-file src="src/ios/ibaicai.m" />
        
        <config-file target="config.xml" parent="/*">
            <!--给ios的.h,.m文件起一个别名(PS:我的理解,如有错误,可以讨论,这个别名用于ibaicai.js的exec(success, error, "ibaicai", "coolMethod", [arg0]); 这段代码中的ibaicai-->
            <feature name="ibaicai">
                <!--ios 包, value:表示头文件的名字-->
                <param name="ios-package" value="ibaicai" />
            </feature>
        </config-file>
    </platform>
    </plugin>
    

    PS:这里的代码的意思我也就不在赘述了,详情请看plugins.xml

    然后在在 ibaica/src/ 目录下添加两个文件ibaicai.h、ibaicai.m,这儿也直接贴上代码。

    ibaicai.h

    #import <Foundation/Foundation.h>
    #import <Cordova/CDVPlugin.h>
    #import "AppDelegate.h"
    
    
    @interface ibaicai : CDVPlugin
    {
    }
    
    -(void) coolMethod: (CDVInvokedUrlCommand*)command;
    
    // retain command for async repsonses
    @property (nonatomic, strong) CDVInvokedUrlCommand* command;
    
    @end
    

    ibaicai.m

    #import "ibaicai.h"
    
    @implementation ibaicai
    
    @synthesize command;
    
    - (void)coolMethod:(CDVInvokedUrlCommand*)command
    {
        NSLog(@"Cordova iOS plugin test");
    
    }
    
    
    @end
    

    到这里了,白菜想说的是,这个简单的测试插件已经完全完成了,在js中可以直接调用了。是不是想问怎么调用呢?那么,请继续,看官们。其实,到这一步,一个插件的开发是完成了的(虽然,这个插件没有什么*用,但是也是一个插件呀!) ,那么接下来就是,向你自己的cordova工程添加我们的插件了。

    给工程添加插件

    打开终端,进入你的cordova工程目录,PS:这里的cordova工程已经添加了ios平台,详细的方法这里就不在赘述了;
    输入以下命令:

    cordova plugins add 这里是你插件的地址。这个地址可以是本地的地址,也可以是github上的地址(https://github.com/lichanglong2015/ibaicai)
    eg:cordova plugins add https://github.com/lichanglong2015/ibaicai
    

    编译工程

    插件打好之后,编译以下cordova 工程,执行如下命令。

    cordova build ios   
    

    调试插件

    执行上面的代码之后,终端出现"** BUILD SUCCEEDED **"提示,则说明编译成功。打开testPlugins/platforms/ios/HelloCordova.xcodeproj,运行此项目(PS:快捷键‘command+r’);
    这里我们用模拟器来测试,运行之后,你的Cordova程序在iOS模拟器上运行起来了,然后继续,打开Mac的safari->开发->Simulator->index.html(PS:开发菜单如果没有,自己百度怎么显示出来,这里不在赘述,打开之后其实就是一个类似于chrome的调试模式一样的。然后进入控制台,输入:

    cordova.plugins.ibaicai.coolMethod(function(){alert("成功")},function(){alert("失败")}) ,
    

    然后回车,回到xcode 看是否有输出信息。如果有,则证明js调用到了原生的ios了,这下想实现什么功能,就自由发挥吧.

    结语

    白菜研究Cordova插件有断时间了,中间是断断续续的,所踩过的坑基本也都说清楚了。唯一遗憾的我对代码的解释不够plugins.xml详解,其实把工程跑起来,然后对应着代码看,很容易就理解了。如果有问题,欢迎一起讨论。
    最后,本文的crdova工程源码http://pan.baidu.com/s/1bSza4A

    相关文章

      网友评论

          本文标题:cordova 自定义(plugin)插件开发

          本文链接:https://www.haomeiwen.com/subject/iiwrlttx.html