cordova 自定义(plugin)插件开发

跟着白菜一起开发一个属于自己的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 目录下面是空的。

cordova 自定义(plugin)插件开发_第1张图片
插件目录结构图

plugin.xml文件

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

.


ibaicai



ibaicai.js文件

var exec = require('cordova/exec');
exports.coolMethod = function(arg0, success, error) {
    exec(success, error, "ibaicai", "coolMethod", [arg0]);
};

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

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



ibaicai

    




    
    
    
    
    
        
        
            
            
        
    


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

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

ibaicai.h

#import 
#import 
#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)插件开发)