Mac下使用Cordova在iOS應(yīng)用中自定義插件的兩種方式

前言:本文主要是針對對webapp開發(fā)有一定基礎(chǔ)和對Cordova有了一定的了解的人員,如果你是Cordova的初學者,建議先看看Cordova的相關(guān)介紹以及簡單的一些CLI命令使用。Cordova的相關(guān)介紹以及安裝推薦文章

一、使用Cordova新建一個ios項目

1.打開終端,輸入

cordova create Demo com.example.HelloWorld HelloWorld


1.1新建iOS項目

參數(shù)說明

第一個參數(shù):Demo為工程的文件夾名;

第二個參數(shù):(可選)com.example.HelloWorld為應(yīng)用程序的id名;

第三個參數(shù):(可選)HelloWorld為項目的名稱。

2.進入工程添加iOS平臺

cd Demo

cordova platform add ios

1.2.1添加iOS平臺

執(zhí)行完上述命令后,我們的文件目錄結(jié)構(gòu)如下

1.2.2工程目錄結(jié)構(gòu)

(注:執(zhí)行上面這個命令的時候會有些慢,耐心等待,如果命令執(zhí)行失敗,沒有生成ios這個目錄,就重新執(zhí)行這個命令)

3.運行并測試

用Xcode打開Demo->platforms->ios->HelloWorld.xcodeproj,編譯運行這個項目,出現(xiàn)以下結(jié)果則表示你的項目運行成功(因為是用Xcode進行編譯運行,所以下面的代碼編輯都是在Staging目錄下,原因見Cordova的相關(guān)介紹以及安裝推薦文章

1.3運行結(jié)果

二、利用cordova自定義js插件

1.編輯/定義插件

在Staging->www下新建一個目錄plugins,用來專門存放我們自定義的js插件,然后是新建插件的文件名cordova-js-plugin,最后是存放插件的源代碼目錄以及文件(以上命名可以根據(jù)個人習慣)。最終得到的目錄結(jié)構(gòu)如下

2.1 js插件目錄結(jié)構(gòu)

插件logger.js的源代碼和格式(這里只是一個簡單的例子)

cordova.define("cordova-js-plugin.logger",function(require, exports, module) {

? ? var logger = module.exports;

? ? logger.alterLog =function(){

? ? ? ?alert("你好!");

? ?};

});

2.注入插件

在Staging->www目錄下找到cordova_plugins.js文件,這個文件是專門用來向cordova注入我們自定義的插件的,注入的代碼參考如下(粗體部門為我們剛剛寫的插件logger.js)

cordova.define('cordova/plugin_list',function(require, exports, module) {

module.exports = [

? ?{

? ? ? "file":"plugins/cordova-js-plugin/www/logger.js",

? ? ? "id":"cordova-js-plugin.logger",

? ? ? "clobbers": [

? ? ? ? ?"logger"

? ? ? ]

? ?}

];

module.exports.metadata =

// TOP OF METADATA

{

? ?"cordova-plugin-whitelist":"1.2.2"

}

// BOTTOM OF METADATA

});

說明

? ? ? file:插件的文件路徑

? ? ? id:和定義插件時的名稱(即第一個參數(shù))保持一致

? ? ? clobbers:調(diào)用插件時使用的名稱

3.調(diào)用插件

在Staging->www下找到index.html文件,如果head下有以下第一行,就將它注釋掉,替換成第二行(第一行中的某些配置項會報錯,這個是cordova與原生的兼容性問題,不作深入討論)

2.2 index.html文件調(diào)整

接下來就是編寫調(diào)用的入口和代碼(代碼比較簡單,這里就直接上截圖)

2.3 測試js插件入口
2.4 調(diào)用js插件方法

運行結(jié)果如圖

2.5 運行結(jié)果
2.6 運行結(jié)果

三、利用cordova自定義oc插件

1.編輯/定義插件

在工程目錄下找到Plugins目錄,新建一個插件文件夾CDVOcPlugin,然后新建一個插件對應(yīng)的類,這個類是繼承CDVPlugin,最后的目錄結(jié)構(gòu)如下

3.1 oc插件目錄結(jié)構(gòu)

插件的定義和實現(xiàn)

//OCPlugin.h

#import <Cordova/CDVPlugin.h> //這個地方要看清,默認引用的頭文件如果不一樣,改成這樣

@interface OCPlugin :CDVPlugin

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

@end

//OCPlugin.m

#import "OCPlugin.h"

@implementation OCPlugin

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

? ?if (command.arguments.count>0) {

? ? ? //獲取到入?yún)?shù)組中的第一個元素

? ? ? NSString *param = command.arguments[0];

? ? ? //創(chuàng)建一個回調(diào)對象并附上String類型參數(shù)

? ? ? CDVPluginResult *pluginResult =?

? ? ? [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:

? ? ? [NSString stringWithFormat:@"傳入?yún)?shù):%@", param]];

? ? ? //通過cordova框架中的callBackID回調(diào)至JS的回調(diào)函數(shù)上

? ? ? [self.commandDelegate sendPluginResult:

? ? ? pluginResult callbackId:command.callbackId];

? ?} else {

? ? ? //如果沒有入?yún)?則回調(diào)JS失敗函數(shù)

? ? ? CDVPluginResult *pluginResult = ? ?

? ? ? [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR

? ? ? messageAsString:@"沒有傳入?yún)?shù)"];

? ? ? [self.commandDelegate sendPluginResult:

? ? ? pluginResult callbackId:command.callbackId];

? ? }

}

@end

2.注入插件

在Staging目錄下找到config.xml配置文件,通過如下配置注入我們的oc插件(配置較簡單,直接上圖)

3.2 注入插件

說明

? ? ? feature name:調(diào)用時插件的名稱

? ? ? param name:插件包名 ?value:插件對用的oc類

3.調(diào)用插件

同調(diào)用js插件一樣,在index.html文件添加一個入口

3.3 調(diào)用插件的入口

接下來是插件調(diào)用的具體方式,在index.html文件里面加一個script標簽(重點是粗體部分)

<script type="text/javascript">

? ?//調(diào)用OC插件方法

? ?function clickOcPlugin() {

? ? ? //通過cordova將我們的插件名稱,方法名,參數(shù),成功回調(diào)的func及失敗回調(diào)的func傳入

? ? ? cordova.exec(alertSuccess,alertFail,"ocplugin",

? ? ? "testOcPlugin",["Hello,world!"]);

? ?};

? ?//調(diào)用成功的回調(diào)函數(shù)

? ?functionalertSuccess(msg) {

? ? ? alert(msg);

? ?};

? ?//調(diào)用失敗的回調(diào)函數(shù)

? ?functionalertFail(msg) {

? ? ? alert("調(diào)用OC插件失敗: "+ msg);

? ?};

</script>

運行結(jié)果如圖

3.4 運行結(jié)果
3.5 運行結(jié)果

注:以上內(nèi)容是我學習相關(guān)資料后的分享,如果有錯誤,請各位指出,也歡迎大家前來拍磚,灰常感謝!

附:源代碼在github上,點擊此處前往下載

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時請結(jié)合常識與多方信息審慎甄別。
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

  • Cordova自定義插件實戰(zhàn)# 使用前提 這篇文章是之前發(fā)表在CSDN上的,拿過來充數(shù)用的,其實那個時候也寫了不少...
    one_cup閱讀 1,665評論 5 3
  • Spring Cloud為開發(fā)人員提供了快速構(gòu)建分布式系統(tǒng)中一些常見模式的工具(例如配置管理,服務(wù)發(fā)現(xiàn),斷路器,智...
    卡卡羅2017閱讀 136,715評論 19 139
  • 昨天第一次寫簡書,感覺太生硬,有的東西只有自己懂了,沒有說的和明白,還望大家見諒,今天說一下自定義ionic插件的...
    會疼的白癡閱讀 5,063評論 7 4
  • 文/愚木 我想,當我看到你的時候 我會把陽光吸入胸膛 然后被一陣風撂上山崗 給一只白文鳥穿上花衣裳 我想,當時間被...
    愚木的簡書閱讀 402評論 1 6
  • 去年逛 github 的時候,發(fā)現(xiàn)一個仿今日頭條的項目鏈接,發(fā)現(xiàn)很多好玩的東西,比如顏色的漸變,F(xiàn)ragment ...
    魏魏魏魏閱讀 684評論 0 1

友情鏈接更多精彩內(nèi)容