網上iOS關于cordova的資料繁多,但都不太全面細致,經過最近這段時間的研究使用,總結出這一份集成使用教程,可以滿足基本使用需求。調試環(huán)境Xcode9.4
1、參照cordova官網教程安裝相應環(huán)境,創(chuàng)建一個標準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
創(chuàng)建App:cd跳轉到你維護源代碼的目錄中,并創(chuàng)建你的cordova項目:
$ sudo cordova create hello com.example.hello HelloWorld
添加iOS平臺:所有后續(xù)命令都需要在項目目錄或者項目目錄的任何子目錄運行
$ cd hello
$ sudo cordova platform add ios --save
檢查你當前平臺設置狀況:
$ sudo cordova platform ls
這樣就創(chuàng)建了一個標準cordova項目,在hello文件夾上右鍵顯示簡介,解鎖訪問權限!不然打開項目xcode會提示沒有權限。打開讀與寫權限并應用到包含的項目。
用xcode打開hello項目(文件層級位置如下圖),編譯成功,至此創(chuàng)建完成
2、編輯插件,簡略常用命令,使用很簡單,cd到hello目錄下,執(zhí)行相應命令(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、基于上面創(chuàng)建的cordova標準項目,在已存iOS項目中集成cordova功能
注意:將cordova集成到其它項目中,在其它項目中不能使用cordova命令進行插件編輯相關功能,其它已存項目不是標準的cordova項目,只是將cordova功能和插件分別集成進去,當做多功能webView使用。插件的添加操作在創(chuàng)建的標準項目中用命令行執(zhí)行,然后手動添加相應插件的實現(xiàn)文件到其它已存項目中,刪除也是手動刪除插件及修改配置文件。
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 下,然后如下圖所示,點擊①中的按鍵,創(chuàng)建New Run Script Phase,②為創(chuàng)建的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相關內容放入統(tǒng)一管理。然后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];? ?
//防止自動留出狀態(tài)欄,使用全屏效果? ?
if (@available(iOS 11.0, *)) {? ? ? ?
((UIWebView*)(self.webView)).scrollView.contentInsetAdjustmentBehavior=UIScrollViewContentInsetAdjustmentNever;? ?
} else {? ? ? ? self.automaticallyAdjustsScrollViewInsets =NO;? ? }? ? ?
}@end
5.2、設置CordovaViewController頁面打開的H5地址
方式一:修改config.xml文件,設置啟動網頁地址,跳轉至CordovaViewController自動加載此地址
方式二:跳轉頁面前設置啟動地址,此地址優(yōu)先級比方式一要高,以此設置為準。
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功能的網頁,實現(xiàn)各種插件功能,例如返回、錄音、拍照、上傳圖片、調整狀態(tài)欄等功能。
6、添加新插件(只需要操作插件實現(xiàn)文件和config.xml配置文件)
6.1在標準項目hello中,用命令行添加新插件,見“2”步驟。添加的插件的實現(xiàn)內容都在hello—>platforms —>ios —>HelloWorld中Plugins文件夾中,包含所有插件的實現(xiàn)文件,把Plugins文件夾拖拽拷貝到新項目中,選中Copy items if needed選項,以后添加插件就只需要把插件的獨立文件夾拷貝到新項目的Plugins文件夾中即可,然后再配置注冊插件
6.2配置注冊插件,然后就可以使用插件了
參考標準hello項目中的config.xml文件內容變化,將相應插件的注冊語句拷貝到新項目的config.xml文件中的指定位置,就注冊成功了,在網頁中就能隨意調用了。
7、自定義插件,分為實現(xiàn)插件功能和注冊插件兩步,然后就能測試使用插件了
7.1創(chuàng)建插件文件繼承CDVPlugin
例如創(chuàng)建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
//方法實現(xiàn)
-(void)getToken:(CDVInvokedUrlCommand*)command{
? ? //定義返回值對象pluginResult
? ? CDVPluginResult* pluginResult =nil;
? ? if (AccessToken && AccessToken.length) {
? ? ? ? //有指定值,傳遞給網頁,Status執(zhí)行狀態(tài),messageAsString傳遞的內容
? ? ? ? pluginResult=[CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:AccessToken];
? ? }else{//錯誤情況
? ? ? ? pluginResult=[CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:@"UnLogin"];
? ? }
? ? //將創(chuàng)建的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>