重要提示:如果你同時使用 PhoneGap(Cordova)與 Sencha Touch,務必先引入 PhoneGap 的 js 檔,否則你開發的插件可能不會被呼叫。
PhoneGap 插件開發的簡單步驟如下:
先建立一個基於 PhoneGap 的工程,若還沒有 PhoneGap SDK,可到官網下載安裝(本文以 PhoneGap 1.3.0 為例)。
在 Plugins 群組下新增一個繼承自 PGPlugin 的子類,命名為 MyPGPlugin。
MyPGPlugin.h:
#ifdef PHONEGAP_FRAMEWORK
#import <PhoneGap/PGPlugin.h>
#else
#import "PGPlugin.h"
#endif
@interface MyPGPlugin : PGPlugin {
}
- (void)addStr:(NSMutableArray*)arguments withDict:(NSDictionary*)options;
@end
MyPGPlugin.m:
#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
在 www 資料夾下新建一個 js 檔,這裡也命名為 MyPGPlugin.js:
/**
* 構造方法
*/
function MyPGPlugin() {};
/**
* 字串相加
* @param str1, str2
*/
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();
});
展開 Plugins,按「+」號新增一列,加入 key 為 MyPGPlugin、value 為 MyPGPlugin。
在 index.html 中導入 js 檔:
<script type="text/javascript" charset="utf-8" src="MyPGPlugin.js"></script>
定義 js 函式(加在 onDeviceReady 函式定義之後):
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>
參考連結:
https://www.adobe.com/devnet/html5/articles/extending-phonegap-with-native-plugins-for-ios.html
https://prostorys.blog.51cto.com/1522778/843699
https://wiki.phonegap.com/w/page/36753496/How%20to%20Create%20a%20PhoneGap%20Plugin%20for%20iOS