iOS开发中Cordova的使用

Cordova

iOS Plugin Development Guide

在iOS的WebView开发中，经常会把Cordova作为增强版的WebView使用。关于本部分的实例可以参考笔者的iOSBoilerplate，可以在REAME.md中查看使用说明，也可以git clone 之后直接运行，按照指导进入相关页面。

Installation

引入Cordova主要包含三个步骤(怎么感觉有点像把大象塞到冰箱)：

（1）在Podfile中加入依赖项

可以使用pod search Cordova命令来搜索可用的Cordova版本，笔者是使用的4.0.1版本：

pod 'Cordova', '~> 4.0.1' # 支持Cordova WebView容器

添加完毕然后使用pod install命令下载即可。

（2）添加config.xml

config.xml即是主要的配置文件，在iOS中其需要放置到/AppName/config.xml这种样式。笔者的config.xml文件的示范为：

    iOSBoilerplate
    
        Cordova Demo in iOS Boilerplate
    
    
        Chevalier
    
    
    
    
    
    
    
    
    
    
    
    
    
        
    
    
        
        
    
    
    
    
        
        
    

（3）添加www文件夹

一般来说会把静态资源文件放置到www目录下，这边有一个小点需要注意下(不知道是不是笔者搞错了)，就是将www文件夹引入到XCode中的时候，注意不要选择Copy而是File Reference，即最终的文件夹应该是如下图所示的蓝色而不是黄色。

Network Configuration

• cordova-5-ios-9-security-policy-changes

有时候在iOS中进行配置的时候会发现部分网络请求被Ban，可以根据以下几个步骤进行排查。

（1）判断config.xml中是否设置了网络请求的白名单，老实说现在cordova-plugin-whitelist这个插件都没有了iOS端，不确定这个是不是需要的。

（2）在iOS 9之后默认是不允许非HTTPs的请求发出，所以要修改下配置允许发起HTTP请求。

NSAppTransportSecurity     NSAllowsArbitraryLoads     

（3）检查下 Content Security Policy

Content Security Policy一般用于对于网页内容的控制，不过这东西如果禁止了你访问网络，那么在浏览器内也是看得出来的。

Plugins

Config

任何一个插件首先需要在config.xml中进行注册：

有沒有指定插件的初始值設定項。相反，應使用插件 pluginInitialize 為其啟動邏輯方法。插件需要長時間運行的請求，如媒體重播、 聽眾，保持內部狀態應執行的背景活動 onReset 方法來清理這些活動。 在方法運行時UIWebView 定位到新的一頁或刷新，重新載入 JavaScript。

JS Modules

关于JS部分的详细配置可以参考官方的JS Modules部分，这里不做赘述，仅展示下基本的用法：

window.echo = function(str, callback) {
        cordova.exec(callback, function(err) {
            callback('Nothing to echo.');
        }, "CordovaPluginsBridge", "echo", [str]);
    };

调用：

window.echo("echome", function(echoValue) {
        alert(echoValue == "echome"); // should alert true.
    });

要注意，一般对于Cordova的调用要放到jQuery的$(document).ready()中。

iOS本地方法

JavaScript 調用觸發插件請求到本機的一邊，和相應的 iOS 目標 C 插件映射正確地在 config.xml 檔中，但最後 iOS 目標 C 插件類看起來像什麼？ 無論派往與 JavaScript 的插件 exec 函數傳遞到相應的插件類的 action 方法。 插件的方法有此簽名：

   - (void)myMethod:(CDVInvokedUrlCommand*)command    {        CDVPluginResult* pluginResult = nil;        NSString* myarg = [command.arguments objectAtIndex:0];        if (myarg != nil) {            pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];        } else {            pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:@"Arg was null"];        }        [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];    }

iOS CDVPluginResult 訊息類型

您可以使用 CDVPluginResult 來返回結果的多種類型回 JavaScript 回呼函數，使用類的方法，它們遵循這種模式：

    + (CDVPluginResult*)resultWithStatus:(CDVCommandStatus)statusOrdinal messageAs...

您可以創建 String ， Int ， Double ， Bool ， Array ， Dictionary ， ArrayBuffer ，和 Multipart 類型。 你可以也離開了任何參數來發送狀態，或返回錯誤，或甚至選擇不發送任何外掛程式的結果，在這種情況下既不回撥火。

請注意以下複雜的傳回值為：

• messageAsArrayBuffer預計 NSData* 並將轉換為 ArrayBuffer 在 JavaScript 回檔。 同樣，任何 ArrayBuffer JavaScript 發送到一個外掛程式都將轉換為NSData*.

• messageAsMultipart預計， NSArray* 包含任何其他支援類型，並將發送整個陣列作為 arguments 給您的 JavaScript 回檔。 這種方式，所有參數在序列化或反序列化作為必要的所以它是能夠安全返回 NSData* 作為多部分，但不是 Array /Dictionary.

异步执行

如果对于部分执行时间较长的代码，可以放在后台进程中执行。

    - (void)myPluginMethod:(CDVInvokedUrlCommand*)command
    {
        // Check command.arguments here.
        [self.commandDelegate runInBackground:^{
            NSString* payload = nil;
            // Some blocking logic...
            CDVPluginResult* pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:payload];
            // The sendPluginResult method is thread-safe.
            [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
        }];
    }