PhoneGapの機能を拡張するにあたり，欠かせないのがPhoneGapプラグインです。サードパーティ製の便利なPhoneGapプラグインが多くリリースされていますが，中には旧バージョン向けに作成されたものもあり，現在のバージョンではうまく動作しないことがあります。最新のPhoneGapでプラグインを動作させるにあたり，必要な手順を確認しましょう。

PhoneGapプラグインのアップデート

旧バージョン向けに作成されたPhoneGapプラグインは，最新のPhoneGapのバージョンではうまく動作しないことがあります。バージョンを遡って，順繰りにプラグインのObjective-CコードやJavaコードを修正する必要があります。

PhoneGapはAdobeの買収やApacheへの寄贈，プロダクト名変更の経緯から，1.5.0以前と以後でコード中の名前空間が変更されました。また，PhoneGap 2.0.0にアップデートされた際にも多くの修正が加わり，ネイティブコードのほか，JavaScriptでプラグインを呼び出せるようにするための書き方も変更されています。

今回は，PhoneGapのアップグレードガイドや開発者のブログ，プラグインリポジトリの各種コミットログより，プラグインのアップデート手順をまとめて紹介します。

プラグインのアップデート手順（iOS）

基本的にCordova Plugin Upgrade Guideに記載されているとおりの手順でアップグレード可能です。JavaScriptのcordova.addPluginに関する部分以外は，公式マニュアルを参照しながらアップグレードを行うことをおすすめします。

iOS向けPhoneGapプラグインのアップデート手順は次のとおりです。

• PhoneGap 1.5.0以前向けに作成されたプラグインを，1.5.0に対応
• PhoneGap 1.5.0向けに作成されたプラグインを，1.6.x～1.9.0に対応
• PhoneGap 1.6.x～1.9.0向けに作成されたプラグインを，2.0.0に対応
• PhoneGap 2.0.0向けに作成されたプラグインを，2.1.0に対応

PhoneGap 1.5.0以前向けに作成されたプラグインを，1.5.0に対応

プラグイン中のJavaScriptファイル，Objective-Cヘッダファイル（.h⁠）⁠，および実装ファイル（.m）を修正します。

JavaScriptにおいて，PhoneGap名前空間がPhoneGap 1.5.0ですべてCordovaに変更されました。

// 修正前
PhoneGap.exec(...);
PhoneGap.addConstructor(function(){
    PhoneGap.addPlugin(...);
});

// 修正後
Cordova.exec(...);
Cordova.addConstructor(function(){
    Cordova.addPlugin(...);
});

Objective-Cコードにおいても同様，PhoneGapという名称はすべてCordovaに置きかえる必要があります。

// 修正前
#ifdef PHONEGAP_FRAMEWORK
#import <PhoneGap/PGPlugin.h>
[ super appViewController ] ... ]

// 修正後
#ifdef CORDOVA_FRAMEWORK
#import <Cordova/CDVlugin.h>
[self appViewController ... ]

PhoneGap 1.5.0向けに作成されたプラグインを，1.6.x～1.9.0に対応

プラグイン中のJavaScriptファイルを修正します。

JavaScript中のグローバルCordovaオブジェクト名は，小文字表記のcordovaとなりました。修正例は次のとおりです。

// 修正前
Cordova.exec(...);
Cordova.addConstructor(function(){
    Cordova.addPlugin(...);
});

// 修正後
cordova.exec(...);
cordova.addConstructor(function(){
    cordova.addPlugin(...);
});

PhoneGap 1.6.x～1.9.0向けに作成されたプラグインを，2.0.0に対応

プラグイン中のJavaScriptファイル，Objective-Cヘッダファイル（.h⁠）⁠，および実装ファイル（.m）を修正します。

PhoneGap 2.0.0ではcordova.jsよりaddPluginメソッドが削除されました。このため，プラグインのJavaScriptにてcordova.addPluginメソッドを使ってプラグインを登録しているコードは動作しなくなります。

cordova.addPluginでは，windowオブジェクトのplguins以下にプラグインを登録していました。この手法で修正を行えば，最低限の修正で済みます。修正例は次のとおりです。

// 修正前
cordova.addConstructor(function() {
    cordova.addPlugin('MyPlugin', new MyPlugin());
});

// 修正後
if(!window.plugins) 
{
    window.plugins = {};
}
if (!window.plugins.MyPlugin) 
{
    window.plugins.MyPlugin = new MyPlugin();
}

また，PhoneGap 2.0.0ではCordovaLibプロジェクトをサブプロジェクトとして扱います。Objective-CでCORDOVA_FRAMEWORKスタイルのインポートを行うにあたり，#import文を次のように修正します。

// 修正前
#import <Cordova/CDV.h>

// 修正後
#import "CDV.h"

PhoneGap 2.0.0では，verifyArgumentsメソッド, appViewControllerメソッドが削除されました。コード中にこれらのメソッドで機能が実装されている箇所は，ほかの方法で機能を実現する必要があります。

PhoneGap 2.0.0向けに作成されたプラグインを，2.1.0に対応

JSONKitと外部ライブラリとの名前空間の問題（CB-1000: Namespace issue of JSONKit and other external libraries / CB-1453: Namespace issue of JSONKit (JSONKitSerializingBlockAdditions)）で，接頭辞にcdvjk_を付けているコードを修正する必要があります。修正例は次のとおりです。

// 修正前
[myDict cdvjk_JSONString];

// 修正後
[myDict JSONString];

PhoneGap 2.1.0ではこのほかにも，プラグインシグネチャが更新されています。旧来のシグネチャは非推奨（deprecated）となっているので，次期バージョンでも利用したい場合は修正しておくと良いでしょう。

// 修正前
- (void) myMethod:(NSMutableArray*)arguments withDict:(NSMutableDictionary*)options;

// 修正後
- (void) myMethod:(CDVInvokedUrlCommand*)command;