(原創(chuàng))Cordova從零到應用,iOS已存項目集成使用,插件自定義

網上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>


至此結束,按照以上步驟操作,可以滿足cordova的常規(guī)使用環(huán)境。

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯(lián)系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發(fā)布,文章內容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 229,619評論 6 539
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 99,155評論 3 425
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 177,635評論 0 382
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,539評論 1 316
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 72,255評論 6 410
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 55,646評論 1 326
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,655評論 3 444
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,838評論 0 289
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發(fā)現(xiàn)了一具尸體,經...
    沈念sama閱讀 49,399評論 1 335
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 41,146評論 3 356
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發(fā)現(xiàn)自己被綠了。 大學時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 43,338評論 1 372
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,893評論 5 363
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發(fā)生泄漏。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點故事閱讀 44,565評論 3 348
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,983評論 0 28
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 36,257評論 1 292
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 52,059評論 3 397
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 48,296評論 2 376

推薦閱讀更多精彩內容