重要提示:如果你同時使用 PhoneGap(Cordova)與 Sencha Touch,務必先引入 PhoneGap 的 js 檔,否則你開發的插件可能不會被呼叫!
1、建立工程。新建一個基於 PhoneGap 的專案(本文以 PhoneGap 1.3.0 為例)。
2、建立 PGPlugin 子類。在 Plugins 群組下新增一個繼承自 PGPlugin 的類別,命名為 MyPGPlugin。
#ifdef PHONEGAP_FRAMEWORK
#import <PhoneGap.h>
#else
#import "PGPlugin.h"
#endif
@interface MyPGPlugin : PGPlugin {
}
- (void)addStr:(NSMutableArray*)arguments withDict:(NSDictionary*)options;
@end
#import "MyPGPlugin.h"
@implementation MyPGPlugin
- (void)addStr:(NSMutableArray*)arguments withDict:(NSDictionary*)options
{
NSLog(@"%@", arguments);
NSString *callbackId = [arguments pop];
NSString *result = [NSString stringWithFormat:@"%@%@", [arguments objectAtIndex:0], [arguments objectAtIndex:1]];
PluginResult *pr = [PluginResult resultWithStatus:PGCommandStatus_OK messageAsString:result];
[self writeJavascript:[pr toSuccessCallbackString:callbackId]];
}
@end
3、建立 js 檔。在 www 資料夾下新建 MyPGPlugin.js:
// 構造方法
function MyPGPlugin() {
};
// 字串相加
MyPGPlugin.prototype.addStr = function(successCallback, failureCallback, str1, str2) {
PhoneGap.exec(successCallback, failureCallback, "MyPGPlugin", "addStr", [str1, str2]);
};
// 載入 MyPlugin 物件
PhoneGap.addConstructor(function() {
if(!window.plugins)
{
window.plugins = {};
}
window.plugins.myPGPlugin = new MyPGPlugin();
});
4、修改 PhoneGap.plist。展開 Plugins,按「+」新增一列,加入 key 為 MyPGPlugin、value 為 MyPGPlugin。
5、使用。在 index.html 中引入 js 並定義呼叫函式:
<script type="text/javascript" charset="utf-8" src="MyPGPlugin.js"></script>
function addStr(){
var str1 = "str1";
var str2 = "str2";
window.plugins.myPGPlugin.addStr(successCallback, failureCallback, str1, str2);
}
// 成功回呼
function successCallback(data){
alert("result:" + data);
}
// 失敗回呼
function failureCallback(data){
alert("error:" + data);
}
再加一個按鈕測試:
<button type="button" onclick='addStr()'>MyPGPlugin Test</button>
6、編譯執行即可看到效果。
· Adobe 官方說明:extending-phonegap-with-native-plugins-for-ios
· PhoneGap Wiki:How to Create a PhoneGap Plugin for iOS