前言:本文主要是針對對webapp開發有一定基礎和對Cordova有了一定的了解的人員,如果你是Cordova的初學者,建議先看看Cordova的相關介紹以及簡單的一些CLI命令使用。Cordova的相關介紹以及安裝推薦文章
一、使用Cordova新建一個ios項目
1.打開終端,輸入
cordova create Demo com.example.HelloWorld HelloWorld
參數說明
第一個參數:Demo為工程的文件夾名;
第二個參數:(可選)com.example.HelloWorld為應用程序的id名;
第三個參數:(可選)HelloWorld為項目的名稱。
2.進入工程添加iOS平臺
cd Demo
cordova platform add ios
執行完上述命令后,我們的文件目錄結構如下
(注:執行上面這個命令的時候會有些慢,耐心等待,如果命令執行失敗,沒有生成ios這個目錄,就重新執行這個命令)
3.運行并測試
用Xcode打開Demo->platforms->ios->HelloWorld.xcodeproj,編譯運行這個項目,出現以下結果則表示你的項目運行成功(因為是用Xcode進行編譯運行,所以下面的代碼編輯都是在Staging目錄下,原因見Cordova的相關介紹以及安裝推薦文章)
二、利用cordova自定義js插件
1.編輯/定義插件
在Staging->www下新建一個目錄plugins,用來專門存放我們自定義的js插件,然后是新建插件的文件名cordova-js-plugin,最后是存放插件的源代碼目錄以及文件(以上命名可以根據個人習慣)。最終得到的目錄結構如下
插件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:和定義插件時的名稱(即第一個參數)保持一致
? ? ? clobbers:調用插件時使用的名稱
3.調用插件
在Staging->www下找到index.html文件,如果head下有以下第一行,就將它注釋掉,替換成第二行(第一行中的某些配置項會報錯,這個是cordova與原生的兼容性問題,不作深入討論)
接下來就是編寫調用的入口和代碼(代碼比較簡單,這里就直接上截圖)
運行結果如圖
三、利用cordova自定義oc插件
1.編輯/定義插件
在工程目錄下找到Plugins目錄,新建一個插件文件夾CDVOcPlugin,然后新建一個插件對應的類,這個類是繼承CDVPlugin,最后的目錄結構如下
插件的定義和實現
//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) {
? ? ? //獲取到入參數組中的第一個元素
? ? ? NSString *param = command.arguments[0];
? ? ? //創建一個回調對象并附上String類型參數
? ? ? CDVPluginResult *pluginResult =?
? ? ? [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:
? ? ? [NSString stringWithFormat:@"傳入參數:%@", param]];
? ? ? //通過cordova框架中的callBackID回調至JS的回調函數上
? ? ? [self.commandDelegate sendPluginResult:
? ? ? pluginResult callbackId:command.callbackId];
? ?} else {
? ? ? //如果沒有入參,則回調JS失敗函數
? ? ? CDVPluginResult *pluginResult = ? ?
? ? ? [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR
? ? ? messageAsString:@"沒有傳入參數"];
? ? ? [self.commandDelegate sendPluginResult:
? ? ? pluginResult callbackId:command.callbackId];
? ? }
}
@end
2.注入插件
在Staging目錄下找到config.xml配置文件,通過如下配置注入我們的oc插件(配置較簡單,直接上圖)
說明
? ? ? feature name:調用時插件的名稱
? ? ? param name:插件包名 ?value:插件對用的oc類
3.調用插件
同調用js插件一樣,在index.html文件添加一個入口
接下來是插件調用的具體方式,在index.html文件里面加一個script標簽(重點是粗體部分)
<script type="text/javascript">
? ?//調用OC插件方法
? ?function clickOcPlugin() {
? ? ? //通過cordova將我們的插件名稱,方法名,參數,成功回調的func及失敗回調的func傳入
? ? ? cordova.exec(alertSuccess,alertFail,"ocplugin",
? ? ? "testOcPlugin",["Hello,world!"]);
? ?};
? ?//調用成功的回調函數
? ?functionalertSuccess(msg) {
? ? ? alert(msg);
? ?};
? ?//調用失敗的回調函數
? ?functionalertFail(msg) {
? ? ? alert("調用OC插件失敗: "+ msg);
? ?};
</script>
運行結果如圖
注:以上內容是我學習相關資料后的分享,如果有錯誤,請各位指出,也歡迎大家前來拍磚,灰常感謝!
附:源代碼在github上,點擊此處前往下載