iOS 的Phonegap 插件开发 详解

  phonegap 提供了iOS 设备的基础特性来供html前段页面调用。但是这个也不能满足我们的项目需求，比如 二维码，APNS，截屏等。所以我们就要扩展。

 下面我就详细说下phonegap 的插件开发 和 扩展。

 在js中要扩展一个方法也很简单。

    Native.screenShot = function(options, onSuccess, onFail) {
        options = options || {};
        var quality = options.quality || 75;
        var destinationType = options.destinationType || 0;
        var encodingType = options.encodingType || 'JPEG';
        var targetWidth = options.targetWidth || -1;
        var targetHeight = options.targetHeight || -1;
        var saveToPhotoAlbum = options.saveToPhotoAlbum || false;

        cordova.exec(onSuccess, onFail, 'Screen', 'screenShot', [quality, //
        destinationType, //
        encodingType, //
        targetWidth, //
        targetHeight, //
        saveToPhotoAlbum]);
    }

上面就是我们对截屏功能的扩展。各个参数具体意思是：

     quality: 75, // 图片质量, 1-100(默认为75)  

     destinationType: 0, // 返回格式, 0:返回base64数据, 1:返回文件uri(默认以base64编码返回)

     encodingType: 'PNG', // 图片格式, JPEG或PNG(默认为JPEG)

     targetWidth: 640, // 最大分辨率宽度(默认值为-1,表示不限制)

     targetHeight: 960, // 最大分辨率高度(默认值为-1,表示不限制)

     saveToPhotoAlbum: true // 截屏图片是否保存到相册(默认不保存)

主要还是通过

cordova.exec(onSuccess, onFail, 'Screen', 'screenShot', []);

这个函数来执行的。

  js 的扩展基本完成了，剩下就是native 这边了。

native这边也很简单，只要我们继续它的一个CDVPlugin类就ok了。

 我们新建类CDVScreenShots类。

在config.xml中添加我们的插件CDVScreenShots。

 <plugin name="Screen"  value="CDVScreenShots" />

啊发发发Screen 是上面js 扩展方面的第三个参数，CDVScreenShots 是我们的native 的 类。上面意思就是 js 的 一个方法映射到本地的某个类。这里就是Screen 映射到本地的CDVScreenShots类。这一步是必须的。

然后在CDV.h中添加

#import "CDVScreenShots.h"

在上面js 扩展方面的第四个参数screenShot，这个其实是对应native 的 一个方法。也就是方面名。所以在CDVScreenShots 类中我们添加

- (void)screenShot:(CDVInvokedUrlCommand*)command;

这个方法。 这样基本就ok了。具体方法是

- (void)screenShot:(CDVInvokedUrlCommand*)command
{
    CDVPluginResult* pluginResult = nil;
    NSString* echo = @"这个是截屏功能";//这个地方是处理的结果，也就是native 的要返回给前端界面的参数，                              //这个只是举例而已，要安实际情况做处理。
    NSLog(@"echo==%@",echo);
    if (echo != nil && [echo length] > 0) {
        pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:echo];
    } else {
        pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR];
    }
    
    [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
}

这样就全部ok了。