网上iOS关于cordova的资料繁多，但都不太全面细致，经过最近这段时间的研究使用，总结出这一份集成使用教程，可以满足基本使用需求。调试环境Xcode9.4

1、参照cordova官网教程安装相应环境，创建一个标准cordova项目（http://cordova.axuer.com/docs/zh-cn/latest/guide/cli/index.html）

下载和安装Node.js。安装完成后你可以在命令行中使用node 和 npm 。

(可选)下载和安装git client, 如果你没有。安装成功后，你可以在命令行中使用git。 这个命令行使用下载git仓库中的资源。

安装cordova 模块使用Nodejs的npm工具。cordova模块会被npm工具自动下载。

$ sudo npm install -g cordova

创建App：cd跳转到你维护源代码的目录中，并创建你的cordova项目：

$ sudo cordova create hello com.example.hello HelloWorld

添加iOS平台：所有后续命令都需要在项目目录或者项目目录的任何子目录运行

$ cd hello

$ sudo cordova platform add ios --save

检查你当前平台设置状况:

$ sudo cordova platform ls

这样就创建了一个标准cordova项目，在hello文件夹上右键显示简介，解锁访问权限！不然打开项目xcode会提示没有权限。打开读与写权限并应用到包含的项目。

用xcode打开hello项目（文件层级位置如下图），编译成功，至此创建完成

2、编辑插件，简略常用命令，使用很简单，cd到hello目录下，执行相应命令（http://cordova.axuer.com/plugins/）

$ sudo cordova plugin search camera

$ sudo cordova plugin add cordova-plugin-camera

$ sudo cordova plugin remove cordova-plugin-camera

$ sudo  cordova plugin ls

添加的插件源文件在下图目录下，以后需要找到集成到其他已有项目：

3、测试插件，项目目录中包含两个config.xml配置文件，以下图标识配置文件为准，另外一个配置文件可以忽略，不用动。

3.1、修改配置文件中的“index.html”为测试插件的H5网页地址

3.2、配置文件中加入两行配置代码，允许在APP中打开链接，不然会自动跳转到safari打开网页。然后就可以运行调试插件了。

 <allow-navigation href="https://*/*" />

<allow-navigation href="http://*/*"  />

4、基于上面创建的cordova标准项目，在已存iOS项目中集成cordova功能

注意：将cordova集成到其它项目中，在其它项目中不能使用cordova命令进行插件编辑相关功能，其它已存项目不是标准的cordova项目，只是将cordova功能和插件分别集成进去，当做多功能webView使用。插件的添加操作在创建的标准项目中用命令行执行，然后手动添加相应插件的实现文件到其它已存项目中，删除也是手动删除插件及修改配置文件。

4.1、将Cordova本地相关文件copy到已存的项目中，hello/platforms/ios 路径下面需要copy的4个文件夹copy到新项目的根路径中

4.2、拷贝hello/platforms/ios/HelloWorld中的config.xml文件到对应的工程目录，到新项目的二级根目录下，如图

4.3、配置相关参数

4.3.1、打开新工程，进入工程TARGETS -> Build Phases 下，然后如下图所示，点击①中的按键，创建New Run Script Phase,②为创建的Run Script:

4.3.2、将下图中，①原名称Run Script修改为Copy www directory，然后将②中的选项去掉，最后将下面的代码字段复制到③中：

NODEJS_PATH=/usr/local/bin; NVM_NODE_PATH=~/.nvm/versions/node/`nvm version 2>/dev/null`/bin; N_NODE_PATH=`find /usr/local/n/versions/node/* -maxdepth 0 -type d 2>/dev/null | tail -1`/bin; XCODE_NODE_PATH=`xcode-select --print-path`/usr/share/xcs/Node/bin; PATH=$NODEJS_PATH:$NVM_NODE_PATH:$N_NODE_PATH:$XCODE_NODE_PATH:$PATH && node cordova/lib/copy-www-build-step.js 

4.3.3、在工程 Build Settings -> Other Linker Flags 中添加：-ObjC

（可选添加 -ObjC -all_load ，先不添加，添加后某些三方库会报错，有问题再添加）

4.3.4、在项目适当位置新建New Group，cordova文件夹，便于把cordova相关内容放入统一管理。然后Add Files to ... -> CordovaLib.xcodeproj，注意只是引入文件，取消选择Copy items if needed选项，不能改变实际文件结构，为任何添加的文件夹选择Create groups

4.3.5、Add Files to ... -> config.xml，同样只是引入，取消选择Copy items if needed选项

4.3.6、Add Files to ... -> www文件夹，同样只是引入，取消选择Copy items if needed选项

4.3.7、Schemes按照下图配置，选择CordovaLib，然后编译一次程序（command+B），然后配置下面几项

Build Phases -> Target Dependencies -> CordovaLib

Build Phases -> Link Binary With Libraries -> libCordova.a

Build Phases -> Link Binary With Libraries -> cordova.framework

官方要求库文件：AssetsLibrary.framework，CoreLocation.framework，CoreGraphics.framework，MobileCoreServices.framework

4.3.8、在Build Phases中添加一个new copy file,选择Destination为frameworks,添加cordova.framework

4.3.9、在GitHub上下载cordova-ios源码，用于从中获取完整的Cordova文件夹，拷贝到新项目指定位置（如图），然后从项目中删除CordovaLib.xcodeproj中红色缺失的Cordova文件夹

然后再重新Add Files to ... ->Cordova文件夹，浅引用添加新拷贝到项目中的Cordova文件夹到删除的位置即可，不然会报文件缺失错误

4.3.其它、Set the Xcode Preferences → Locations → Derived Data → Advanced... to Unique.

其它官方要求（仅做参考，可忽略）：http://cordova.axuer.com/docs/zh-cn/6.x/guide/platforms/ios/webview.html

至此cordova相关功能组件就集成配置完成了，接下来总结使用方法。

5、cordova在新项目中的使用，一般都是作为VC使用，既可以作为单独全屏webVC使用，也可将VC.view单独作为view使用。

5.1在新项目中新建CordovaViewController继承CDVViewController

.h文件

#import <UIKit/UIKit.h>

#import <Cordova/CDVViewController.h>

#import <Cordova/CDVCommandDelegateImpl.h>

#import <Cordova/CDVCommandQueue.h>

@interface CordovaViewController : CDVViewController

@end

.m文件

#import "CordovaViewController.h"

@interface CordovaViewController ()@end

@implementation CordovaViewController

- (void)viewDidLoad {       

[super viewDidLoad];   

//防止自动留出状态栏，使用全屏效果   

if (@available(iOS 11.0, *)) {       

((UIWebView*)(self.webView)).scrollView.contentInsetAdjustmentBehavior=UIScrollViewContentInsetAdjustmentNever;   

} else {        self.automaticallyAdjustsScrollViewInsets =NO;    }     

}@end

5.2、设置CordovaViewController页面打开的H5地址

方式一：修改config.xml文件，设置启动网页地址，跳转至CordovaViewController自动加载此地址

方式二：跳转页面前设置启动地址，此地址优先级比方式一要高，以此设置为准。

CordovaViewController *cordovaVC=[CordovaViewController new];       

cordovaVC.startPage=@"https://www.baidu.com";            

[[ShareMethod getCurrentVC].navigationController pushViewController:cordovaVC animated:YES];

附加：CordovaViewController页面内部刷新跳转指定网页方法：在CordovaViewController.m中

self.startPage=@"https://www.qq.com"; 

self.wwwFolderName = @"www";

NSURL *url = [self performSelector:@selector(appUrl)];

if (url){

    NSURLRequest *request = [[NSURLRequest alloc] initWithURL:url];

    [(UIWebView *)self.webView loadRequest:request];

}

5.3、然后在新项目中就可以随意跳转CordovaViewController，加载相应的带有cordova功能的网页，实现各种插件功能，例如返回、录音、拍照、上传图片、调整状态栏等功能。

6、添加新插件（只需要操作插件实现文件和config.xml配置文件）

6.1在标准项目hello中，用命令行添加新插件，见“2”步骤。添加的插件的实现内容都在hello—>platforms —>ios —>HelloWorld中Plugins文件夹中，包含所有插件的实现文件，把Plugins文件夹拖拽拷贝到新项目中，选中Copy items if needed选项，以后添加插件就只需要把插件的独立文件夹拷贝到新项目的Plugins文件夹中即可，然后再配置注册插件

6.2配置注册插件，然后就可以使用插件了

参考标准hello项目中的config.xml文件内容变化，将相应插件的注册语句拷贝到新项目的config.xml文件中的指定位置，就注册成功了，在网页中就能随意调用了。

7、自定义插件，分为实现插件功能和注册插件两步，然后就能测试使用插件了

7.1创建插件文件继承CDVPlugin

例如创建CDVGetToken插件：

CDVGetToken.h文件

#import <Foundation/Foundation.h>

#import <Cordova/CDVPlugin.h>

@interface CDVGetToken : CDVPlugin

//定义方法名，用于H5调用此方法，command中包含H5调用时传递过来的信息

//也包含消息的callbackId，用于指定返回给网页相应数据

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

@end

CDVGetToken.m文件

#import "CDVGetToken.h"

@implementation CDVGetToken

//方法实现

-(void)getToken:(CDVInvokedUrlCommand*)command{

    //定义返回值对象pluginResult

    CDVPluginResult* pluginResult =nil;

    if (AccessToken && AccessToken.length) {

        //有指定值，传递给网页，Status执行状态，messageAsString传递的内容

        pluginResult=[CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:AccessToken];

    }else{//错误情况

        pluginResult=[CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:@"UnLogin"];

    }

    //将创建的pluginResult返回数据给网页，需要指定command.callbackId

    [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];

}

@end

7.2、在config.xml中注册自定义的插件

<feature name="GetToken">

        <param name="ios-package" value="CDVGetToken" />

        <param name="onload" value="true" />

    </feature>

至此结束，按照以上步骤操作，可以满足cordova的常规使用环境。