You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by mw...@apache.org on 2013/09/10 19:36:58 UTC
[13/51] [abbrv] [partial] Move Japanese to docs/ja and Korean to
docs/ko.
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/2.1.0/guide/getting-started/symbian/index.md
----------------------------------------------------------------------
diff --git a/docs/ja/2.1.0/guide/getting-started/symbian/index.md b/docs/ja/2.1.0/guide/getting-started/symbian/index.md
new file mode 100644
index 0000000..9d63f40
--- /dev/null
+++ b/docs/ja/2.1.0/guide/getting-started/symbian/index.md
@@ -0,0 +1,78 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+Getting Started with Symbian
+============================
+
+このガイドは、 Cordova のための開発環境セットアップ方法、またシンプルなアプリの動かし方を解説します。 Cordova は以前は PhoneGap と呼ばれていたため、いくつかのサイトは PhoneGap という名前をまだ使用しています。
+
+ビデオチュートリアル:
+----------------
+
+- [Cordova Installer - Xcode 4 Template](http://www.youtube.com/v/R9zktJUN7AI?autoplay=1)
+
+
+1. 必要なもの
+---------------
+
+- Windows, OS X, または Linux
+
+他に [QT for Symbian](http://wiki.phonegap.com/w/page/16494811/PhoneGap-Symbian-%28Qt%29) や [Symbian with Sony Ericsson](http://wiki.phonegap.com/w/page/16494782/Getting-Started-with-PhoneGap-Symbian-(WRT-on-Sony-Ericsson)) といったガイドもあります。
+
+
+2. SDK と Cordova のインストール
+-------------------------
+
+- [cygwin](http://www.cygwin.com/setup.exe) をダウンロードし、インストールします (Windows のみ) 。デフォルトでは選択されていませんが、 "make" を選択してください
+- [Cordova](http://phonegap.com/download) の最新版をダウンロードし解凍します。これから Android ディレクトリと一緒に作業を進めます
+
+
+3. 新規プロジェクトの作成
+--------------------
+
+- cygwin で、 Cordova を解凍したディレクトリまで移動し、 Symbian ディレクトリに移動します
+
+
+4. Hello World の作成
+--------------
+
+- phonegap/symbian/framework/www にある index.html を好きなエディタで開きます
+- `body` タグの中にある `"Build your phonegap app here! Dude!"` を削除し、 `<h1>Hello World</h1>` を追加します
+- cygwin または terminal で、 make を実行します。これにより、 phonegap-symbian.wrt と app.wgz が作られます
+
+
+5A. シミュレーターへのデプロイ
+-----------------------
+
+- Mac もしくは Linux には、 [Aptana Studio](http://www.aptana.org/products/studio2/download) と [Nokia WRT Plug-in for Aptana Studio](http://www.forum.nokia.com/info/sw.nokia.com/id/00d62bd8-4214-4c86-b608-5f11b94dad54/Nokia_WRT_Plug_in_for_Aptana_Studio.html) をインストールする必要があります。これは、ブラウザベースの JavaScript エミュレーターを持っています
+- Windows は、S60 エミュレーターを持つ [S60 SDK](http://www.forum.nokia.com/info/sw.nokia.com/id/ec866fab-4b76-49f6-b5a5-af0631419e9c/S60_All_in_One_SDKs.html) をダウンロードします
+- エミュレーターに phonegap-symbian.wrt と app.wgz をロードします
+
+
+5B. デバイスへのデプロイ
+--------------------
+
+- phonegap-symbian.wrt と app.wgz を bluetooth または email を使ってデバイスにロードします
+
+
+終了
+-----
+
+さらに詳しいガイドは [ここ](http://wiki.phonegap.com/w/page/16494780/Getting-Started-with-Phonegap-Nokia-WRT) で確認できます。
+
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/2.1.0/guide/getting-started/tizen/index.md
----------------------------------------------------------------------
diff --git a/docs/ja/2.1.0/guide/getting-started/tizen/index.md b/docs/ja/2.1.0/guide/getting-started/tizen/index.md
new file mode 100644
index 0000000..c682eea
--- /dev/null
+++ b/docs/ja/2.1.0/guide/getting-started/tizen/index.md
@@ -0,0 +1,108 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+Getting Started with Tizen
+=========================
+
+このガイドは、 Cordova のための開発環境セットアップ方法、またシンプルなアプリの動かし方を解説します。 Cordova は以前は PhoneGap と呼ばれていたため、いくつかのサイトは PhoneGap という名前をまだ使用しています。
+
+1. 必要なもの
+---------------
+
+- Linux Ubuntu 10.04/10.10/11.04/11.10 32-bit, Windows XP SP3/7 32-bit.
+
+2. SDK と Cordova のインストール
+-------------------------
+
+- [Tizen SDK](https://developer.tizen.org/sdk) のダウンロードとインストール
+- [Cordova](http://phonegap.com/download) の最新版をダウンロードし解凍します。これから tizen ディレクトリと一緒に作業を進めます
+- (オプション) Tizen の Cordova テンプレートプロジェクトをインストール: copy the `/templates` ディレクトリの中身を Tizen Eclipse IDE の web templates ディレクトリにコピーします (例: `/home/my_username/tizen-sdk/IDE/Templates/web`)
+
+3. 新規プロジェクトの作成
+--------------------
+
+- **方法 #1: Cordova Tizen プロジェクトサンプルのインポート**
+ - Tizen Eclipse IDE を起動します
+ - **File** -> **Import** -> **Tizen Web Project** を選択します
+
+ 
+
+ - **Next** をクリックします
+ - **Select root directory** がチェックされていることを確認します
+ - **Copy projects into workspace** がチェックされていることを確認します
+ - **Browse** をクリックします
+ - Cordova Tizen の "samples" プロジェクトディレクトリのうちの一つ (例: `/cordova-basic`) を Browse し、選択します
+
+ 
+
+ - **Finish** をクリックします
+
+ 
+
+ - これで、プロジェクトはインポートされ **Project Explorer** ビューに表示されます
+
+- **方法 #2: Tizen Eclipse IDE の Cordova Tizen プロジェクトテンプレートの使用**
+ - Tizen Eclipse IDE を起動します
+ - **File** -> **New** -> **Tizen Web Project** を選択します
+ - 項目 **User Template** と **User defined** を選択します
+ - Tizen Cordova template のうちの一つ (e.g: **CordovaBasicTemplate**) を選択します
+ - **Project name** とその **Location** を入力します
+
+ 
+
+ - **Finish** をクリックします
+
+ 
+
+ - これで、プロジェクトは作成され **Project Explorer** ビューに表示されます
+
+4. Hello World の作成
+--------------
+- プロジェクトのビルド:
+
+ - **Project Explorer** ビューの中のプロジェクトを **右クリック** して **Build Project** を選択します
+
+ 
+
+ - プロジェクトのルートディレクトリに、ウィジェットパッケージが生成されているはずです (例: `cordova-basic.wgt`)
+
+ - **注意** Tizen Cordova プロジェクトで提供されているサンプルは、基本的な hello world アプリケーションではありません。それらは、 Battery Cordova API のシンプルな使用例です。
+
+
+5A. シミュレーターへのデプロイ
+-----------------------
+
+- **Project Explorer** ビューの中のプロジェクトを **右クリック** して **Run As** と **Tizen Web Simulator Application** を選択します
+
+ 
+
+5B. デバイス/エミュレーターのデプロイ
+--------------------
+
+- デバイスが正常に起動/接続/設定されていることを確認 ("Date and Time" 設定は正しく設定されている必要があります) します
+- **Connection Explorer** ビューでアプリケーションのデプロイ先を選択します (**Window** Menu -> **Show View** -> **Connection Explorer** を選択)
+
+ 
+
+- **Project Explorer** ビューの中のプロジェクトを **右クリック** して **Run As** と **Tizen Web Application** を選択します
+
+ 
+
+終了
+-----
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/2.1.0/guide/getting-started/webos/index.md
----------------------------------------------------------------------
diff --git a/docs/ja/2.1.0/guide/getting-started/webos/index.md b/docs/ja/2.1.0/guide/getting-started/webos/index.md
new file mode 100644
index 0000000..4b1a986
--- /dev/null
+++ b/docs/ja/2.1.0/guide/getting-started/webos/index.md
@@ -0,0 +1,78 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+Getting Started with WebOS
+==========================
+
+このガイドは、 Cordova のための開発環境セットアップ方法、またシンプルなアプリの動かし方を解説します。 Cordova は以前は PhoneGap と呼ばれていたため、いくつかのサイトは PhoneGap という名前をまだ使用しています。
+
+ビデオチュートリアル:
+----------------
+
+- [Cordova and HP Palm webOS quick start video](http://www.youtube.com/v/XEnAUbDRZfw?autoplay=1)
+- [How to convert iPhone app to a Palm](http://www.youtube.com/v/wWoJfQw79XI?autoplay=1)
+
+
+1. 必要なもの
+---------------
+
+- Windows, OS X, または Linux
+
+
+2. SDK と Cordova のインストール
+----------------------------
+
+- [Virtual Box](http://www.virtualbox.org/) のダウンロードとインストール
+- [WebOS SDK](http://developer.palm.com/index.php?option=com_content&view=article&layout=page&id=1788&Itemid=321/) のダウンロードとインストール
+- [cygwin SDK](http://developer.palm.com/index.php?option=com_content&view=article&layout=page&id=1788&Itemid=321) のダウンロードとインストール (Windows のみ) 。デフォルトでは選択されていませんが、 "make" を選択してください
+- [Cordova](http://phonegap.com/download) の最新版をダウンロードし解凍します。 これから webOS ディレクトリと一緒に作業を進めます。
+- [Mac App Store](http://itunes.apple.com/ca/app/xcode/id497799835?mt=12) のダウンロードとインストール (OSC のみ)
+- Command Line Tools for XCode のダウンロードとインストール (OSX のみ) 。 XCode の Preferences -> Downloads -> Components から、 Command Line Tools の install をクリックすることでインストールできます
+
+
+3. 新規プロジェクトの作成
+--------------------
+
+- ターミナルまたは cygwin を開き、 Cordova を解凍したフォルダーまで移動します。 webOS ディレクトリに移動します。
+
+4. Hello World の作成
+--------------
+
+phonegap/webOS/framework/www の中の index.html を好きなエディタで開きます。 body タグの後に `<h1>Hello World</h1>` を追加します
+
+
+5A. シミュレーターへのデプロイ
+-----------------------
+
+- アプリケーションフォルダーまたはスタートメニューからPlam エミュレーターを起動します
+- webOS ディレクトリ内で、ターミナルまたは cygwin で make を実行します
+
+
+5B. デバイスへのデプロイ
+--------------------
+
+- デバイスが [デベロッパーモードになっており、また接続されている](http://developer.palm.com/index.php?option=com_content&view=article&id=1552&Itemid=59#dev_mode) ことを確認します
+- webOS ディレクトリ内で、ターミナルまたは cygwin で make を実行します
+
+
+終了
+-----
+
+さらに詳しいガイドは [ここ](http://wiki.phonegap.com/w/page/16494781/Getting-Started-with-PhoneGap-webOS) で確認できます。
+
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/2.1.0/guide/getting-started/windows-phone/index.md
----------------------------------------------------------------------
diff --git a/docs/ja/2.1.0/guide/getting-started/windows-phone/index.md b/docs/ja/2.1.0/guide/getting-started/windows-phone/index.md
new file mode 100644
index 0000000..667c6c6
--- /dev/null
+++ b/docs/ja/2.1.0/guide/getting-started/windows-phone/index.md
@@ -0,0 +1,114 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+Getting Started with Windows Phone
+==================================
+
+このガイドは、 Cordova のための開発環境セットアップ方法、またシンプルなアプリの動かし方を解説します。 Cordova は以前は PhoneGap と呼ばれていたため、いくつかのサイトは PhoneGap という名前をまだ使用しています。
+
+ビデオチュートリアル:
+----------------
+
+- [Cordova and Windows Phone quick setup video](http://www.youtube.com/v/wO9xdRcNHIM?autoplay=1)
+- [Cordova and Windows Phone deep dive](http://www.youtube.com/v/BJFX1GRUXj8?autoplay=1)
+
+
+1. 必要なもの
+---------------
+
+- Windows 7 または Windows Vista with SP2
+
+注意: VM での動作は問題があります。もし Mac を使用している場合は、 bootcamp パーティションを Windows 7 または Vista でセットアップする必要があります。
+
+デバイスへのインストールとマーケットプレイスへの登録のために、以下が必要です:
+
+- [App Hub member](http://create.msdn.com/en-US/home/membership) になる
+
+
+2. SDK と Cordova のインストール
+----------------------------
+
+- [Windows Phone SDK](http://www.microsoft.com/download/en/details.aspx?displaylang=en&id=27570/) のダウンロードとインストール
+- [Cordova](http://phonegap.com/download) の最新版をダウンロードし解凍します。 これから lib\windows-phone\ サブフォルダーと一緒に作業を進めます。
+- CordovaStarter-x.x.x.zip のファイルを次のフォルダーにコピーします: \My Documents\Visual Studio 2010\Templates\ProjectTemplates\
+(もしテンプレートファイルが存在しない場合、これをビルドする必要があります。以下の 2.1 を参照してください)
+もし VisualStudio をインストールしたばかりの場合は、このフォルダーを作成するために一度起動する必要があります。
+"Visual C#" の "Silverlight for Windows Phone" サブフォルダーの代わりにこのプロジェクトを追加することも出来ます。これは、新しいプロジェクトを作るときにプロジェクトテンプレートがどこに表れるかに影響するだけです。また、このフォルダーを作成する必要があるかもしれません。
+
+
+2.1 テンプレートのビルド
+-----------------------------
+(このステップは必要ないかもしれません。もし lib\windows-phone がすでに CordovaStarter-x.x.x.zip ファイルを含んでいる場合は、このステップをスキップしてください)
+- Visual Studio Express for Windows Phone にある lib\windows-phone\templates\standalone\CordovaSolution.sln を開きます
+- ファイルメニューから 'Export Template...' を選びます
+- テンプレートタイプ 'Project template' を選びます
+- エクスポートするテンプレート名を指定します。例: CordovaStarter-2.1.0 は CordovaStarter-2.1.0.zip となります
+- 概要、アイコン画像、プレビュー画像などを必要に応じて追加します。これは、 Visual Studio の 'New Project' ダイアログで表示される内容になります
+- 注意: もし ('Automatically import the template ... ') を選択した場合、ステップ2 にある .zip ファイルのコピーは必要ありません
+- 'Finish' をクリックします
+
+
+3. 新規プロジェクトの作成
+--------------------
+
+- Visual Studio Express for Windows Phone を開き、 **New Project** を選択します。
+- **CordovaStarter** を選択します。 (テンプレートの説明の中に、バージョン番号が表示されます)
+ - 注意: もし見つからない場合は、 'Visual C#' を選択してみてください。
+- プロジェクト名を指定し、 OK をクリックします。
+
+ 
+
+
+4. プロジェクト構成の確認
+-------------------------------
+
+- 'www' フォルダーは Cordova の html/js/css ファイルとアプリのその他のリソースを含みます。
+- このフォルダーに追加した全てのコンテンツは Visual Studio プロジェクトの一部である必要があり、コンテンツとしてセットされている必要があります。
+
+ 
+
+
+5. ビルドとエミュレーターへのデプロイ
+-------------------------------
+
+- **Windows Phone Emulator** が上部のドロップダウンメニューにて選択されていることを確認します。
+- Windows Phone Emulator が選択されたドロップダウンメニューの隣にある緑の **play ボタン** をクリックするか、 F5 を押下しデバッグを開始します。
+
+ 
+ 
+
+
+6. デバイスのためにプロジェクトをビルド
+------------------------------------
+
+デバイスでアプリをテストするためには、デバイスは登録されていなければなりません。 [ここ][register-url] をクリックし、 Windows Phone へのデプロイとテストに関するドキュメントを読んでください。
+
+- デバイスが接続され、スクリーンがアンロックなことを確認します
+- Visual Studio で、上部のドロップダウンメニューから 'Windows Phone Device' を選択します
+- ドロップダウンメニューの隣にある緑の **play ボタン** をクリックするか、 F5 を押下しデバッグを開始します
+
+ 
+
+
+終了
+-----
+
+さらに詳しいガイドは [ここ](http://wiki.phonegap.com/w/page/48672055/Getting%20Started%20with%20PhoneGap%20Windows%20Phone%207) で確認できます。
+
+[register-url]: http://msdn.microsoft.com/en-us/library/windowsphone/develop/ff402565(v=vs.105).aspx
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/2.1.0/guide/plugin-development/android/index.md
----------------------------------------------------------------------
diff --git a/docs/ja/2.1.0/guide/plugin-development/android/index.md b/docs/ja/2.1.0/guide/plugin-development/android/index.md
new file mode 100644
index 0000000..910c54e
--- /dev/null
+++ b/docs/ja/2.1.0/guide/plugin-development/android/index.md
@@ -0,0 +1,154 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Developing a Plugin on Android
+
+プラグインの開発には、 Cordova-Android のアーキテクチャの理解が必要です。
+Cordova-Android は Android WebView とそれに付属するコールバックから構成されます。
+これらのプラグインは config.xml ファイル内にクラスマッピングとして表されています。
+
+プラグインは `Pluguin` クラスを継承した少なくとも1つの Java クラスによって構成されます。
+プラグインは `PluginResult` オブジェクトを返す `execute` メソッドを **必ず **実装しなければなりません。
+加えて、プラグイン作成のベストプラクティスとして、プラグインは pause と resume イベントをサポートし、またプラグイン間のメッセージのやりとりもサポートしているべきです。
+
+## プラグインクラスのマッピング
+
+プラグインの JavaScript 部分は常に `cordova.exec` メソッドを以下のように使います:
+
+ exec(<successFunction>, <failFunction>, <service>, <action>, [<args>]);
+
+これは WebView から Android ネイティブ側へのリクエストを整理し、
+おおよそ要約すると `service` クラスで `action` メソッドを、
+`args` 配列で渡された引数と一緒に呼び出すということになります。
+
+プラグインを Java ファイルで提供するしろ JAR でするにしろ、プラグインは必ず Cordova-Anroid アプリケーションの `res/xml` フォルダーにある `config.xml` ファイルに追加されていなければなりません。
+
+ <plugin name="<service_name>" value="<full_name_including_namespace>"/>
+
+サービス名 (name) は JavaScript の `exec` の中で定義したものと一致している必要があり、値 (value) は Java クラスへのネームスペースを含んだフルパスになります。これがないと、プラグインはコンパイルはされますが、
+Cordova からアクセスできない状態となります。
+
+## Android Java プラグインの作成
+
+私たちはプラグインリクエストをネイティブ側に送る JavaScript を作成しました。
+また、正しく `config.xml` ファイルでマッピングされた Android Java プラグインもあります。
+では、最終的に Android Java プラグインのクラスがどのようになるのか見ていきましょう。
+
+JavaScript の `exec` 関数によってプラグインに割り当てられたものは、
+プラグインのクラスの `execute` メソッドに渡されます。大半の `execute`
+の実装は以下のようになります:
+
+ public PluginResult execute(String action, JSONArray args, String callbackId) {
+ PluginResult.Status status = PluginResult.Status.OK;
+ String result = "";
+
+ try {
+ if (action.equals("beep")) {
+ this.beep(args.getLong(0));
+ }
+ return new PluginResult(status, result);
+ } catch (JSONException e) {
+ return new PluginResult(PluginResult.Status.JSON_EXCEPTION);
+ }
+ }
+
+基本的に `action` パラメーターの値を見て、クラス内の
+(プライベート) メソッドに割り振っていきます。
+また、任意でいくつかのパラメーターをそのメソッドに渡します。
+
+例外をキャッチしエラーを返すとき、 JavaScript へ返すエラーが Java で発生した例外に可能なかぎり近づけることは、明瞭さのためにも重要です。
+
+### Android プラグインの Echo プラグイン
+
+次を config.xml に追加します:
+
+ <plugin name="Echo" value="org.apache.cordova.plugin.Echo" />
+
+そして、次を Cordova-Android アプリケーションの中の
+`src/org/apache/cordova/plugin/Echo.java` に追加します:
+
+
+ package org.apache.cordova.plugin;
+
+ import org.apache.cordova.api.Plugin;
+ import org.apache.cordova.api.PluginResult;
+ import org.json.JSONArray;
+ import org.json.JSONException;
+ import org.json.JSONObject;
+
+ /**
+ * このクラスは JavaScript から呼び出された文字列をecho します。
+ */
+ public class App extends Plugin {
+
+ /**
+ * リクエストを実行し、 PluginResult を返します。
+ *
+ * @param action 実行するアクション名です。
+ * @param args プラグインへの引数の JSONArry です。
+ * @param callbackId JavaScript へコールバックするときに使うコールバック id です。
+ * @return ステータスとメッセージを伴った PluginResult オブジェクトです。
+ */
+ public PluginResult execute(String action, JSONArray args, String callbackId) {
+ try {
+ if (action.equals("echo")) {
+ String echo = args.getString(0);
+ if (echo != null && echo.length() > 0) {
+ return new PluginResult(PluginResult.Status.OK, echo);
+ } else {
+ return new PluginResult(PluginResult.Status.ERROR);
+ }
+ } else {
+ return new PluginResult(PluginResult.Status.INVALID_ACTION);
+ }
+ } catch (JSONException e) {
+ return new PluginResult(PluginResult.Status.JSON_EXCEPTION);
+ }
+ }
+ }
+
+コードを見ていきましょう。一番上には、必要なすべての Cordova に関する
+`import` 文が並んでいます。クラスは `Plugin` を継承しています - これはとても
+重要です。 `Plugin` インターフェースは `execute` メソッドを実装する必要が
+あります。メソッドは、最初に `action` を見ていきます。このプラグインは1つ
+のアクション `echo` のみをサポートしています。ほかのアクションは、ステータス
+が `INVALID_ACTION` となった `PluginResult` が返されます - これは JavaScript
+側でエラーコールバックへの呼び出しに変換されます。次に、 `args` に対して
+`getString` メソッドを使い、パラメーター配列から0番目のパラメーターを取得
+することにより、 echo する文字列を取り出します。ここで、少しパラメーターに
+対してチェックを行います: `null` チェックや文字列の長さが0でないかどうかなど
+です。もしそうであった場合は、ステータスが `ERROR` の `PluginResult` を
+返します (これはもうご存知の通り JavaScript 側でエラーコールバックを
+呼び出します)。もしこれらのチェックをパスしたら、ステータスが `OK` の
+`PluginResult` を返し、パラメーターとして受け取った `echo` 文字列を
+渡します。これが、 JavaScript 側で成功コールバック関数に変換されます。
+また、 `echo` パラメーターを JavaScript の成功コールバック関数に
+パラメーターとして渡します。
+
+## プラグインのデバッグ
+
+Eclipse は Android プロジェクトのデバッグに使用でき、 Java のソースファイルがプロジェクトに含まれている場合は、プラグインもデバッグできます。最新バージョンの Android Dev Tools のみ JAR にソースコードを付与でき、これは今回はフルでサポートされていません。
+
+## よくある落とし穴
+
+* プラグインは `CordovaInterface` オブジェクトへのアクセス権を持っています。このオブジェクトはアプリケーションで走っている Android の `Activity` へのアクセス権を持っています。この `Activity` は新しい Android `Intent` を起動するために必要な `Context` です。
+`CordovaInterface` は、結果として `Activity` を開始すること、また `Intent` がアプリケーションに戻ってきたときにコールバックをセットすることをプラグインに許可します。
+`Intent` システムは Android のプロセス間の連携に使われるため、これは非常に重要です。
+* プラグインは `Context` への直接アクセス権を以前のように持っていません。以前の `ctx` はもう廃止され、 2.0 リリースの6ヶ月後に削除されます。 `Context` にあった `ctx` が存在するすべてのメソッド、 `getContext()` と `getActivity()` は必要な正しいオブジェクトを返すことが可能です。
+* `webView.loadUrl()` を使って JavaScript を呼び出すことは避けてください。コールバックサーバーがある理由は、 JavaScript がスレッドセーフで実行されるためです。 `loadUrl` は明確に UI スレッドに割り込み、プラグインのユーザビリティーに影響します。
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/2.1.0/guide/plugin-development/bada/index.md
----------------------------------------------------------------------
diff --git a/docs/ja/2.1.0/guide/plugin-development/bada/index.md b/docs/ja/2.1.0/guide/plugin-development/bada/index.md
new file mode 100644
index 0000000..2732582
--- /dev/null
+++ b/docs/ja/2.1.0/guide/plugin-development/bada/index.md
@@ -0,0 +1,74 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+Developing a Plugin on Bada
+===========================
+
+プラグインは Bada 2.0 以上のみサポートしています。 Bada 1.2 はサポートしていません。
+
+Bada の実装はすべて JavaScript の実装です。そのため、カスタムプラグインを追加することは、プラグインコードによって CordovaJS を更新することになります。以下は、シンプルな _Hello World_ プラグインを追加するステップです:
+
+1. CordovaJS リポジトリーを clone します
+
+ git clone https://git-wip-us.apache.org/repos/asf/incubuator-cordova-js.git
+
+2. __lib/bada/plugin/bada/__ 以下に新しい JavaScript ファイルを作成し、 _HelloWorld.js_ と名前をつけます。以下の内容を追加します:
+
+ function HelloWorld() {
+ }
+
+ HelloWorld.prototype.printHello = function(success, fail, arg) {
+ alert(Osp.Core.StringHelper('Hello %1', arg[0]));
+ }
+
+ module.exports = new HelloWorld();
+
+3. __lib/bada/platform.js__ の objects プロパティーの下に、新しく作ったプラグインへのリンクを追加します:
+
+ objects: {
+ ...
+ HelloWorld: {
+ 'cordova/plugin/bada/HelloWorld'
+ },
+ ...
+ }
+ ...
+4. __lib/bada/exec.js__ のプラグインリストを、作ったプラグインを含むように更新します
+
+ var plugins = {
+ ...
+ "HelloWorld": require('cordova/plugin/bada/HelloWorld')
+ };
+5. これで、好きなようにユーザー向けの JavaScript を書くことができます。しかし、プラグインを実行するためには、以下のメソッドを呼び出す必要があることを忘れないで下さい
+
+ exec(succes, fail, 'HelloWorld', 'printHello', ['Jackson!']);
+
+ success はプラグインが正常に終了したときに実行される成功コールバック関数です
+ fail はプラグインが正常に終了しなかったときに実行されるエラーコールバック関数です
+ 'HelloWorld' はあなたのプラグインの名前です
+ 'printHello' はあなたのプラグインのアクション名です
+ 最後のパラメーターは、プラグインへの引数です
+
+6. 以下のコマンドを実行し、新しい共通 JavaScript を生成します (npm モジュールの jake がインストールされていることを確認して下さい)
+
+ jake
+
+7. 新しく生成された __pkg/cordova.bada.js__ を、 Bada プロジェクトの __Res/js__ 以下にコピーします
+
+6. 以上です！これで、あなたは新しい Bada プラグインを追加することができ、現在は Cordova Bada でサポートされていないたくさんの機能を実装できるようになりました。
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/2.1.0/guide/plugin-development/blackberry/index.md
----------------------------------------------------------------------
diff --git a/docs/ja/2.1.0/guide/plugin-development/blackberry/index.md b/docs/ja/2.1.0/guide/plugin-development/blackberry/index.md
new file mode 100644
index 0000000..8bc26d8
--- /dev/null
+++ b/docs/ja/2.1.0/guide/plugin-development/blackberry/index.md
@@ -0,0 +1,136 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+Developing a Plugin on BlackBerry
+=================================
+
+## Blackberry での Echo プラグインの作り方
+
+このガイドでは、 BlackBerry での Echo プラグインの作り方について説明します。
+もし上位のガイドである JavaScript パートのプラグインについてのガイドを読んでいない場合は、それを最初に読むことをおすすめします。
+加えて、 [Cordova Blackberry repo](https://git-wip-us.apache.org/repos/asf?p=cordova-blackberry-webworks.git;a=summary) をダウンロードしてください。
+
+Cordova-BlackBerry プロジェクトは Torch, Bold, Playbook といった BlackBerry デバイスへのデプロイを可能にします。
+通常の携帯端末タイプの BlackBerry (例, Torch と Bold) とタブレットタイプの Playbook の間には、デプロイ方法に差があります。
+この2つのコードはベースが違うため、1つを開発しているときは、もう1つのためにコードを複製してあげる必要があります。
+そのため、このガイドでは携帯端末にフォーカスし、タブレットにはフォーカスしません。
+将来的には、両方のプラットフォームをカバーする予定です。
+
+
+前のガイドからの続きで、 Echo プラグインは基本的にユーザーが `window.echo`
+関数で与えたメッセージを返します。
+
+Echo 関数:
+
+ window.echo = function(str, callback) {
+ cordova.exec(callback, function(err) {
+ callback('Nothing to echo.');
+ }, "Echo", "echo", [str]);
+ };
+
+## plugins.xml の修正
+
+このファイルはプロジェクトの中の www フォルダーにあり、 Cordova プロジェクトが使用しているすべてのプラグインへの参照を含みます。
+新しい参照を追加して、 cordova.exec が呼ばれたときに、 Cordova が `cordova.exec` の "Echo" 引数を
+これから書くネイティブコードの Echo クラスにマッピングすることが分かるようにします。
+
+ <plugins>
+ ...
+ <plugin name="Echo" value="org.apache.cordova.echo.Echo"/>
+ ...
+ </plugins>
+
+## Echo.java の追加
+
+もし value 属性の構造にお気づきなら、 Echo プラグインへの定義されたパスが見えるでしょう。
+Cordova BlackBerry Webworks のリポジトリーのルートフォルダーで、 framework と呼ばれるフォルダーを探してください。
+このフォルダーは BlackBerry 上で動くすべてのソースコードを含んでいます。
+このフォルダー以下の `framework/ext/src/org/apache/cordova` にフォルダーに辿りつくまで cd し続けます。
+この時すべてのプラグインフォルダーが見えるでしょう。また、それぞれのフォルダーの中身はプラグインのソースコードとなっています。
+ここで、フォルダー echo を `framework/ext/src/org/apache/cordova/echo` に作成し、
+`Echo.java` をこの中の `framework/ext/src/org/apache/cordova/echo/Echo.java` の位置に新規追加します。
+
+## Echo.java の実装
+
+プラグインの実装の基本的なアイデアは、 Plugin クラスを継承するクラスを作成し、
+PluginResult クラスを返す execute と呼ばれるメソッドを作成することです。
+cordova.exec へのすべての呼び出しは、クラス内で実行したいアクションと引数を渡します。
+この場合、 "echo" がクラス "Echo" 内で実行したいアクションで、 [str] が渡している引数です。
+
+ package org.apache.cordova.echo;
+
+ import org.apache.cordova.api.Plugin;
+ import org.apache.cordova.api.PluginResult;
+ import org.apache.cordova.json4j.JSONArray;
+ import org.apache.cordova.json4j.JSONException;
+ import org.apache.cordova.json4j.JSONObject;
+ /**
+ * BlackBerry でのプラグインの作り方デモのためのシンプルなプラグイン
+ * ユーザーがプラグインを呼び出したときのメッセージをそのまま返します
+ */
+ public final class Echo extends Plugin {
+
+ public static final String echo = "echo";
+
+ public PluginResult execute(String action, JSONArray args, String callbackId) {
+ PluginResult result = new PluginResult(PluginResult.Status.INVALID_ACTION, "Echo: Invalid action:" + action);
+ if(action.equals(echo)){
+ try {
+ String theMsg = args.getString(0);
+ if(theMsg!= null || theMsg.length()>0){
+ result = new PluginResult(PluginResult.Status.OK, theMsg);
+ }else{
+ result = new PluginResult(PluginResult.Status.ERROR, "Nothing to echo.");
+ }
+ } catch (JSONException e) {
+ result = new PluginResult(PluginResult.Status.JSON_EXCEPTION, e.getMessage());
+ }
+ }
+
+ return result;
+ }
+
+ }
+
+上のコードを見てみると、 execute メソッドの中で、最初にどんなアクションが来たかを調べているのが分かります。
+この Echo プラグインは1つのアクション "echo" のみを持つので、それのみをチェックします。
+もしプラグインに複数のアクションがあった場合は、 if 文を追加していき、これらをチェックしていきます。
+
+
+次に、 args パラメーターによって与えられた引数からメッセージを取得します。
+`String theMsg = args.getString(0);` とすることで、シンプルに一番最初の引数を取得することができます。
+
+いくつかのエラーチェックをし、もしメッセージが大丈夫そうなら、 ok ステータス (PluginResult.Status.OK) とメッセージ (theMsg) を持つ
+新しい PluginResult インスタンスを作ります。
+その後、 JavaScript に渡し、成功コールバック関数を呼び出す result を返します。
+もし何かエラーが起きた場合、 PluginResult.Status.ERROR, PluginResult.Status.JSON_EXCEPTION, PluginResult.Status.INVALID_ACTION といったような何種類かのステータス例外を返すことが出来ます。
+もしこのタイプの例外が返されたとき、 JavaScript 側ではエラーコールバックが
+呼び出されます。
+
+## www フォルダーの .jar の更新
+
+あなたのプロジェクト内で Echo.java の追加分が更新される必要があります。 .jar ファイルをビルドするためには、 BlackBerry Webworks リポジトリーのルートディレクトリに cd します。
+次の ant コマンドを使用します:
+
+ ant update -Dproject.path="~/path_to_my_project"
+
+これは build/ext フォルダーの中の新しい .jar ファイルをビルドします。
+`build/ext/cordova.jar` ファイルを プロジェクトの www/ext フォルダーにコピーします。
+
+もしすべてが上手くいったら、 BlackBerry で Echo プラグインが使用できるようになっているはずです。
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/2.1.0/guide/plugin-development/index.md
----------------------------------------------------------------------
diff --git a/docs/ja/2.1.0/guide/plugin-development/index.md b/docs/ja/2.1.0/guide/plugin-development/index.md
new file mode 100644
index 0000000..81da8db
--- /dev/null
+++ b/docs/ja/2.1.0/guide/plugin-development/index.md
@@ -0,0 +1,112 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# プラグイン開発ガイド
+
+Cordava プラグインは Cordova アプリケーション Webview と Cordava
+アプリケーションが走っているネイティブプラットフォームの機能的な
+橋渡しをします。プラグインはすべてのプラットフォームで使われる
+1つの JavaScript インターフェースに集約され、そのプラグイン
+インターフェースに従ったプラットフォーム独自のネイティブ実装が
+それぞれなされます。すべてのコア Cordova API はこのアーキテクチャ
+を用いて実装されています。
+
+このガイドはシンプルな Echo プラグインを書くために必要なステップを
+紹介していきます。 Echo プラグインは JavaScript から文字列を受け取り、
+それをサポートされているプラットフォームのネイティブ環境に渡します。
+このネイティブコードは同じ文字列を、プラグインの JavaScript の
+コールバックに含んで返します。
+
+このガイドから、より複雑なプラグインを書くために必要な概観や詳細が
+得られるはずです。
+
+## JavaScript
+
+すべてのプラグインの最初の一歩は JavaScript です。開発者が Cordova を
+使う理由は、 Objective-C でも Java でも C# でもなく、 JavaScript を使って
+コードが書けるからです。プラグインにとって JavaScript インターフェースは
+まさしく顔であり、もっとも重要な部分であると言えるでしょう。
+
+あなたはプラグインの JavaScript を好きなように構成できます。ただ一つ、
+Cordova JavaScript とネイティブ環境との間のコミュニケーションのために
+`cordova.exec` 関数を _使う必要があります_ 。以下が例です:
+
+ cordova.exec(function(winParam) {}, function(error) {}, "service",
+ "action", ["firstArgument", "secondArgument", 42,
+ false]);
+
+以下がパラメーターの詳細説明です:
+
+1. `function(winParam) {}` - 成功コールバック関数です。 `exec` の実行が
+ 正常に完了したとき、この関数が呼び出されます
+ (任意で返されたパラメーターと一緒に呼び出されます)
+2. `function(error) {}` - エラーコールバック関数です。もし操作が正常に
+ 完了しなかったとき、この関数が呼び出されます
+ (任意で返されたパラメーターと一緒に呼び出されます)
+3. `"service"` - ネイティブ側で呼び出されるサービス名です。これは
+ ネイティブクラスにマッピングされます。詳しくは、以下のネイティブ
+ ガイドで説明しています
+4. `"action"` - 呼び出されるアクション名です。 `exec` からの呼び出しを
+ 受けるネイティブクラスで取り出され、プラットフォームに依存して、
+ クラスのメソッドにマッピングされます。詳しくは、以下のネイティブ
+ ガイドで説明しています
+5. `[/* arguments */]` - ネイティブ環境に渡される引数です
+
+
+### Echo プラグイン JavaScript の例
+
+ window.echo = function(str, callback) {
+ cordova.exec(callback, function(err) {
+ callback('Nothing to echo.');
+ }, "Echo", "echo", [str]);
+ };
+
+詳しく見ていきましょう。プラグインを `window` に `echo` 関数として
+付与しています。プラグインのユーザーは以下のように使用します:
+
+
+ window.echo("echome", function(echoValue) {
+ alert(echoValue == "echome"); // should alert true.
+ });
+
+はじめに、 `exec` 関数の後ろ3つの引数について見ていきましょう。
+私たちは、 `Echo` "サービス" を呼び出し、 `echo` "アクション" を
+リクエストし、そして `window.echo` 関数の最初のパラメーターである
+文字列を含んだ配列を引数として渡しています。
+
+`exec` に渡される成功コールバック関数は `window.echo` が受取る
+コールバック関数を単純に参照しています。エラーコールバックについては
+もう少し手を加えています: もしネイティブ側でエラーコールバックを呼び出した
+場合は、単純に成功コールバックを呼び出し、 "デフォルト" 文字列を渡します。
+
+## ネイティブ
+
+プラグインの JavaScript の定義が終わったら、それに少なくとも1つの
+ネイティブ実装を付け加える必要があります。以下は Cordova がサポート
+しているそれぞれのプラットフォームに特化したガイドになります。
+以下のガイドでは引き続き、このガイドで作り始めた Echo プラグインを
+作成していきます。
+
+- Developing a Plugin on Android
+- Developing a Plugin on Bada
+- Developing a Plugin on BlackBerry
+- Developing a Plugin on iOS
+- Developing a Plugin on webOS
+- Developing a Plugin on Windows Phone
+- Developing a Plugin on Tizen
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/2.1.0/guide/plugin-development/ios/index.md
----------------------------------------------------------------------
diff --git a/docs/ja/2.1.0/guide/plugin-development/ios/index.md b/docs/ja/2.1.0/guide/plugin-development/ios/index.md
new file mode 100644
index 0000000..d1a7858
--- /dev/null
+++ b/docs/ja/2.1.0/guide/plugin-development/ios/index.md
@@ -0,0 +1,175 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Developing a Plugin on iOS
+
+プラグインの開発には、 Cordova-iOS のアーキテクチャの理解が必要です。 Conrdova-iOS は UIWebView から構成されています。インターセプト命令は、 URL の変化に応じて UIWebView に渡されます。これらのプラグインは .plist ファイルの Plugins キーにクラスマッピングとして表されています。
+
+プラグインは `CDVPlugin` クラスを継承した Objective-C のクラスです。
+
+## プラグインクラスのマッピング
+
+プラグインの JavaScript 部分は常に `cordova.exec` メソッドを以下のように使います:
+
+ exec(<successFunction>, <failFunction>, <service>, <action>, [<args>]);
+
+これは UIWebView から iOS ネイティブ側へのリクエストを整理し、おおよそ要約すると `service` クラスで `action` メソッドを、 `args` 配列で渡された引数と一緒に呼び出すということになります。
+
+このプラグインは、 Cordova-iOS アプリケーションのプロジェクトフォルダーの中の `Cordova.plist` ファイルの `Plugins` キー (辞書) に追加される必要があります。
+
+ <key>service_name</key>
+ <string>PluginClassName</string>
+
+`service_name` のキーは JavaScript の `exec` の中で使用しているものと一致している必要があり、値はプラグインの Objective-C クラスの名前になります。これがないと、プラグインはコンパイルされますが、 Cordova からアクセスできない状態となります。
+
+## iOS Cordova Plugin の作成
+
+私たちはプラグインリクエストをネイティブ側に送る JavaScript を作成しました。また、正しく `Cordova.plist` ファイルでマッピングされた iOS Objective-C プラグインもあります。では、最終的に iOS Objective-C プラグインのクラスがどのようになるのか見ていきましょう。
+
+JavaScript の `exec` 関数によってプラグインに割り当てられたものは、プラグインクラスの対応する `action` メソッドに渡されます。プラグインメソッドのシグネチャは次のようになります:
+
+ - (void) myMethod:(CDVInvokedUrlCommand*)command
+ {
+ CDVPluginResult* pluginResult = nil;
+ NSString* javaScript = nil;
+
+ @try {
+ NSString* myarg = [command.arguments objectAtIndex:0];
+
+ if (myarg != nil) {
+ pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];
+ javaScript = [pluginResult toSuccessCallbackString:command.callbackId];
+ }
+ } @catch (id exception) {
+ pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_JSON_EXCEPTION messageAsString:[exception reason]];
+ javaScript = [pluginResult toErrorCallbackString:command.callbackId];
+ }
+
+ [self writeJavascript:javaScript];
+ }
+
+1. [CDVInvokedUrlCommand.h](https://github.com/apache/cordova-ios/blob/master/CordovaLib/Classes/CDVInvokedUrlCommand.h)
+2. [CDVPluginResult.h](https://github.com/apache/cordova-ios/blob/master/CordovaLib/Classes/CDVPluginResult.h)
+
+
+## プラグインシグネチャ
+
+**Cordova 2.1.0** からサポートされた **新しいシグネチャ** は次のとおりです:
+
+ - (void) myMethod:(CDVInvokedUrlCommand*)command;
+
+**古い (非推奨)** シグネチャはつぎのとおりです:
+
+ - (void) myMethod:(NSMutableArray*)arguments withDict:(NSMutableDictionary*)options;
+
+基本的に、オプション辞書は新しいシグネチャでは削除されており、 callbackId は引数配列の 0 番目の要素ではなく、別のプロパティーとなっています。
+
+## iOS プラグインの Echo プラグイン
+
+`Cordova.plist` ファイルの `Plugins` キー (辞書) に以下を追加します:
+
+ <key>Echo</key>
+ <string>Echo</string>
+
+次のファイル (`Echo.h` と `Echo.m`) を Cordova-iOS アプリケーションフォルダーの中の
+プラグインフォルダーに追加します:
+
+ /********* Echo.h Cordova Plugin Header *******/
+
+ #import <Cordova/CDV.h>
+
+ @interface Echo : CDVPlugin
+
+ - (void) echo:(CDVInvokedUrlCommand*)command;
+
+ @end
+
+ /********* Echo.m Cordova Plugin Implementation *******/
+
+ #import "Echo.h"
+ #import <Cordova/CDV.h>
+
+ @implementation Echo
+
+ - (void) echo:(CDVInvokedUrlCommand*)command
+ {
+ CDVPluginResult* pluginResult = nil;
+ NSString* javaScript = nil;
+
+ @try {
+ NSString* echo = [command.arguments objectAtIndex:0];
+
+ if (echo != nil && [echo length] > 0) {
+ pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:echo];
+ javaScript = [pluginResult toSuccessCallbackString:command.callbackId];
+ } else {
+ pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR];
+ javaScript = [pluginResult toErrorCallbackString:command.callbackId];
+ }
+ } @catch (NSException* exception) {
+ pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_JSON_EXCEPTION messageAsString:[exception reason]];
+ javaScript = [pluginResult toErrorCallbackString:command.callbackId];
+ }
+
+ [self writeJavascript:javaScript];
+ }
+
+ @end
+
+
+コードを見ていきましょう。一番上には、必要なすべての Cordova に関する import 文が並んでいます。クラスは `CDVPlugin` を継承しています - これはとても重要です。
+
+このプラグインは 1 つのアクション `echo` のみをサポートしています。最初に、 `objectAtIndex` メソッドを `args` に使って引数配列 0 番目の要素である echo 用文字列を取得します。次に、 `objectAtIndex` メソッドを使って、引数配列の1番目の要素である echo 用文字列を取得します。ここで、少しパラメーターに対してチェックを行います: `nil` チェックや文字列の長さが0でないかどうかなどです。
+
+もしそうであった場合は、ステータスが `ERROR` の `PluginResult` を返します。もしこれらのチェックをパスしたら、ステータスが `OK` の `PluginResult` を返し、パラメーターとして受け取った `echo` 文字列を渡します。そして、もし正常な場合は `toSuccessCallbackString` メソッド、エラーの場合は `toErrorCallbackString` メソッドを呼びだして `PluginResult` を JavaScript に変換します。
+
+最後に、 JavaScript 側で成功またはエラーコールバック関数を実行するような JavaScript を書き出します。もし成功コールバックが呼ばれた場合は、 `echo` パラメーターをパラメーターとして渡します。
+
+## 一歩進んだプラグインの機能
+
+他にも、オーバーライド出来るメソッドについては以下を参照してください:
+
+1. [CDVPlugin.h](https://github.com/apache/cordova-ios/blob/master/CordovaLib/Classes/CDVPlugin.h)
+2. [CDVPlugin.m](https://github.com/apache/cordova-ios/blob/master/CordovaLib/Classes/CDVPlugin.m)
+
+例えば、 pausa, resume, app terminate, handleOpenURL events といったような機能を実装できます。
+
+## プラグインのデバッグ
+
+Objective-C 側でデバッグするには、 Xcode のビルトインのデバッガーを使用します。 JavaScript 側では、 [Apache Cordova Project の Weinre](https://github.com/apache/cordova-weinre) または [サードパーティ製の iWebInspector](http://www.iwebinspector.com/) を使用できます。
+
+iOS 6 では、 Safari 6.0 を使用して簡単に iOS 6 シミュレーター上で動いているアプリをデバッグできます。
+
+## よくある落とし穴
+
+* Cordova.plist にプラグインマッピングを追加することを忘れないでください - もし忘れている場合は、 Xcode のコンソールログにエラーが表示されます
+* 接続するすべてのホストを [ホワイトリスト](guide_whitelist_index.md.html#Domain%20Whitelist%20Guide) に追加することを忘れないで下さい - もし忘れている場合は、 Xcode のコンソールログにエラーが表示されます
+* もしアプリが復帰する際にイベント処理をしていて、イベント復帰時にアラートといったようなネイティブ関数を実行すると、アプリケーションが停止してしまいます。安全のため、 JavaScript 呼び出しをタイムアウト値0の setTimeout でラップしてください:
+
+ setTimeout(function() {
+ // 任意のコード
+ }, 0);
+
+## 非推奨のプラグインシグネチャに関する注意点
+
+**古い (非推奨)** シグネチャはつぎのとおりです:
+
+ - (void) myMethod:(NSMutableArray*)arguments withDict:(NSMutableDictionary*)options;
+
+Objective-C プラグインメソッドの `options` パラメーターは非推奨であり、使われるべきではありません。レガシー的な理由で、 `args` 配列の最後の JavaScript オブジェクト要素は、 Objective-C 側メソッドの `options` 辞書に渡されます。どんな JavaScript オブジェクトでも `args` 配列の最後の要素として渡されるべきであり、もし配列の途中の要素に JavaScript オブジェクトがあると、それ以降の Objective-C 側の配列のインデックスがでたらめになることに十分注意してください。 options 辞書はただ1つの JavaScript オブジェクトのみをサポートしており、また配列の一番最後の要素のみネイティブメソッドに渡されます。このようにエラーを起こしやすいので、 `options` は非推奨となっています。
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/2.1.0/guide/plugin-development/tizen/index.md
----------------------------------------------------------------------
diff --git a/docs/ja/2.1.0/guide/plugin-development/tizen/index.md b/docs/ja/2.1.0/guide/plugin-development/tizen/index.md
new file mode 100644
index 0000000..c210a26
--- /dev/null
+++ b/docs/ja/2.1.0/guide/plugin-development/tizen/index.md
@@ -0,0 +1,23 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+Developing a Plugin on Tizen
+============================
+
+プラグインは Tizen プラットフォームでは現在サポートされていません。
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/2.1.0/guide/plugin-development/webos/index.md
----------------------------------------------------------------------
diff --git a/docs/ja/2.1.0/guide/plugin-development/webos/index.md b/docs/ja/2.1.0/guide/plugin-development/webos/index.md
new file mode 100644
index 0000000..e341f4f
--- /dev/null
+++ b/docs/ja/2.1.0/guide/plugin-development/webos/index.md
@@ -0,0 +1,23 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+Developing a Plugin on webOS
+============================
+
+プラグインは webOS プラットフォームでは現在サポートされていません。
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/2.1.0/guide/plugin-development/windows-phone/index.md
----------------------------------------------------------------------
diff --git a/docs/ja/2.1.0/guide/plugin-development/windows-phone/index.md b/docs/ja/2.1.0/guide/plugin-development/windows-phone/index.md
new file mode 100644
index 0000000..fa2f5a0
--- /dev/null
+++ b/docs/ja/2.1.0/guide/plugin-development/windows-phone/index.md
@@ -0,0 +1,192 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+Developing a Plugin on Windows Phone
+====================================
+
+Windows Phone プラグインの開発には、 Cordova のアーキテクチャの理解が必要です。
+Cordova-WP7 は Javascript コードをホストし、
+ネイティブの API 呼び出しを管理する WebBrowser から構成されています。
+C# には継承可能な BaseCommand (`WP7CordovaClassLib.Cordova.Commands.BaseCommand`) クラスがあり、
+このクラスは開発者のために大半の基本的な機能を保持しています。
+
+1. プロジェクトを選択し、右クリックから 'Add -> New Item ...' を選びます
+ - どこに追加するかはあなたの自由ですが、できれば 'Plugins' フォルダーに追加してください
+2. 'Class' を選択し `Echo.cs` と名前をつけます
+ - このクラスの名前は `cordova.exec(win, fail, "Echo", ...)` で呼び出す名前と完全に一致している必要があります
+3. ベースクラスをインクルードします
+
+ using WP7CordovaClassLib.Cordova;
+ using WP7CordovaClassLib.Cordova.Commands;
+ using WP7CordovaClassLib.Cordova.JSON;
+
+4. BaseCommand クラスを継承します
+
+ public class Echo : BaseCommand
+ {
+ // ...
+ }
+
+5. JS から呼び出し可能なメソッドを追加します
+
+ public class Echo : BaseCommand
+ {
+ public void echo(string options)
+ {
+ // 全ての JS から呼び出されるメソッドはこのシグネチャを持つ必要があります
+ // publicで, void を返し, string の引数が 1 つ
+ }
+ }
+
+ネームスペース
+----------
+
+コマンドのデフォルトのネームスペースは:
+
+ namespace Cordova.Extension.Commands
+ {
+ // ...
+ }
+
+もし別のネームスペースを使用したい場合は、 `cordova.exec` の呼び出しの際にネームスペースが省略されていないクラス名を指定する必要があります。
+例えば、もし以下のように C# のクラスを定義した場合は:
+
+ namespace com.mydomain.cordovaExtensions
+ {
+ public class Echo : BaseCommand
+ {
+ // ...
+ }
+ }
+
+JS では、 exec を以下のように呼び出します:
+
+ codova.exec(win, fail, "com.mydomain.cordovaExtensions.Echo", ...);
+
+C# での引数の読み取り
+----------------------------------
+
+プラグインメソッドから受け取った値は文字列ですが、
+JavaScript のコードを見ると、実は文字列の配列を渡そうとしていた、ということがあります。
+JS での `cordova.exec` の呼び出し部分をみると、 `[str]` を渡していることがわかります:
+
+ cordova.exec(win, fail, "Echo", "echo", ["input string"]);
+
+ここで `Echo.echo` メソッドに渡された文字列を検証すると、
+値は実際には次であることがわかります:
+
+ "[\"input string\"]"
+
+全ての Javascript の exec 引数は、 C# に渡される前に JSON エンコードされます。
+
+もしこれを期待している値にしたい場合は、デコードする必要があります。
+シンプルに JSON のデシリアライゼーションを使います。
+
+ string optVal = JsonHelper.Deserialize<string[]>(options)[0];
+ // optVal は "input string" となります
+
+C# から JS へ結果を渡す
+-----------------------------
+
+ベースクラスの BaseCommand はデータを JS のコールバックハンドラーに渡すためのメソッドを提供しています。
+追加情報が必要なく、単にコマンドが成功したことを通知するためには、
+シンプルに以下を呼びます:
+
+ DispatchCommandResult(); // 空のプラグイン結果とともに、成功したとみなされコールバックします
+
+データを返すには、異なる形式の `DispatchCommandResult` を呼ぶ必要があります:
+
+ DispatchCommandResult(new PluginResult(PluginResult.Status.OK, "すべて計画通りにいきました。これは成功ハンドラーに渡される結果データです。"));
+
+構造化されたデータを JS に渡すには、 JSON 形式にエンコードされている必要があります:
+To pass structured object data back to JS, it should be encoded as a JSON string:
+
+ DispatchCommandResult(new PluginResult(PluginResult.Status.OK, "{result:\"うまくいきました！\"}"));
+
+エラーが発生したことを通知する場合には、 `DispatchCommandResult` を `PluginResult` を伴って呼ぶことができます:
+
+ DispatchCommandResult(new PluginResult(PluginResult.Status.ERROR, "Echo はエラーが発生したと伝えています"));
+
+プラグインの C# メソッドでのシリアライゼーションエラーの対処
+--------------------------------------------------------
+
+引数を解析するときに、万が一不正な入力があった場合のためにも try/catch ブロックを
+使用するとよいでしょう。以下は、 Cordova の C# コードで使われている方法です:
+
+ string optVal = null;
+
+ try
+ {
+ optVal = JsonHelper.Deserialize<string[]>(options)[0];
+ }
+ catch(Exception)
+ {
+ // 例外をキャッチし、 null 値と例外を一緒に対処します
+ }
+
+ if (optVal == null)
+ {
+ DispatchCommandResult(new PluginResult(PluginResult.Status.JSON_EXCEPTION));
+ }
+ else
+ {
+ // ... 任意のコードを続けます
+ }
+
+一歩進んだプラグインの機能
+-----------------------------
+
+オーバーライドできるその他の機能については以下を参照してください:
+
+1. [BaseCommand.cs](https://github.com/apache/cordova-wp7/blob/master/templates/standalone/cordovalib/Commands/BaseCommand.cs)
+
+例えば、 'pause' や 'resume' といったアプリケーションイベントもオーバーライドできます。
+
+### プラグインのデバッグ
+
+C# 側でデバッグするには、 Visual Studio のデバッガーを使用します。クラスの任意の箇所に
+ブレークポイントを設置してください。
+
+Windows Phone での Javascript のデバッグは少し難しいです。 `console.log` を使用して
+プラグインの状態を出力するなどの方法をとる必要があるでしょう。
+
+よくある落とし穴
+---------------
+
+- JavaScript 実装時に、プラグインに渡す引数を決める際には十分に注意してください。
+ 大半のデバイスは cordova.exec に渡される引数は配列であると期待していますが、
+ もし配列の中に異なる形式のオブジェクトが含まれる場合は、
+ デシリアライズが非常に困難、もしくは不可能となってしまいます。
+
+ cordova.exec(win, fail, "ServiceName", "MethodName", ["これは文字列です", 54, {literal:'trouble'}]);
+
+ - これは、以下のようなデコードが非常に困難な文字列を C# 側で受け取ることを意味します:
+
+ "[\"これは文字列です\", 54, { literal:'trouble' }]"
+
+ - exec を呼び出す前に、全てのパラメーターを文字列に変換することを考慮してください:
+
+ cordova.exec(win, fail, "ServiceName", "MethodName", ["これは文字列です", "54", "{literal:'trouble'}"]) ;
+
+ string[] optValues = JsonHelper.Deserialize<string[]>(options);
+
+- exec を呼び出す前に JavaScript コード内でパラメーターのチェックをすることを心がけましょう。
+ これは JS のコードをプラグインの異なるネイティブ実装間で
+ 再利用しやすくするという利点もあります。
+
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/2.1.0/guide/upgrading/android/index.md
----------------------------------------------------------------------
diff --git a/docs/ja/2.1.0/guide/upgrading/android/index.md b/docs/ja/2.1.0/guide/upgrading/android/index.md
new file mode 100644
index 0000000..c97de1e
--- /dev/null
+++ b/docs/ja/2.1.0/guide/upgrading/android/index.md
@@ -0,0 +1,172 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+Upgrading Cordova Android
+=========================
+
+
+これは、 Cordova を古いバージョンから新しいバージョンにアップグレードする必要がある人のためのドキュメントです。
+
+## 2.0.0 から 2.1.0 へのアップグレード ##
+
+1. プロジェクトの libs ディレクトリから cordova-2.0.0.jar を削除します
+2. プロジェクトの libs ディレクトリに cordova-2.1.0.jar を追加します
+3. もし Eclipse を使用している場合は、プロジェクトをリフレッシュし clean を実行します
+4. 新しい cordova-2.1.0.js をプロジェクトにコピーします
+5. HTML を、新しい cordova-2.1.0.js を使って更新します
+6. res/xml/config.xml を framework/res/xml/config.xml と同じとなるようにコピーします
+
+
+## 1.9.0 から 2.0.0 へのアップグレード ##
+
+1. プロジェクトの libs ディレクトリから cordova-1.9.0.jar を削除します
+2. プロジェクトの libs ディレクトリに cordova-2.0.0.jar を追加します
+3. もし Eclipse を使用している場合は、プロジェクトをリフレッシュし clean を実行します
+4. 新しい cordova-2.0.0.js をプロジェクトにコピーします
+5. HTML を、新しい cordova-2.0.0.js を使って更新します
+6. res/xml/config.xml を framework/res/xml/config.xml と同じとなるようにコピーします
+
+### 2.0.0 リリースに関する注意点
+config.xml は cordova.xml と plugins.xml に置き換わるものです。この新しい config.xml は前の2つのコンビネーションです。
+しかしながら古いファイルは廃止予定であり、現在はまだ動きますが、将来的のリリースでは動かなくなります。
+
+## 1.8.1 から 1.9.0 へのアップグレード ##
+
+1. プロジェクトの libs ディレクトリから cordova-1.8.0.jar を削除します
+2. プロジェクトの libs ディレクトリに cordova-1.9.0.jar を追加します
+3. もし Eclipse を使用している場合は、プロジェクトをリフレッシュし clean を実行します
+4. 新しい cordova-1.9.0.js をプロジェクトにコピーします
+5. HTML を、新しい cordova-1.9.0.js を使って更新します
+6. res/xml/plugins.xml を framework/res/xml/plugins.xml と同じとなるように更新します
+
+### 1.9.0 リリースに関する注意点
+
+- サードパーティーのプラグインは動く場合と、動かない場合があります。これは、 CordovaWebView がリリースされたためです。これらのプラグインはコンテキスト取得の際に、 getContext() または getActivity() を使用して CordovaInterface から取得する必要があります。
+もし Android アプリケーション開発を熟知していない場合は、プラグインの開発者に連絡を取り、彼らのバグトラッキングシステムにタスクとして登録するよう伝えてください。
+
+## 1.8.0 から 1.8.1 へのアップグレード ##
+
+1. プロジェクトの libs ディレクトリから cordova-1.8.0.jar を削除します
+2. プロジェクトの libs ディレクトリに cordova-1.8.1.jar を追加します
+3. もし Eclipse を使用している場合は、プロジェクトをリフレッシュし clean を実行します
+4. 新しい cordova-1.8.1.js をプロジェクトにコピーします
+5. HTML を、新しい cordova-1.8.1.js を使って更新します
+6. res/xml/plugins.xml を framework/res/xml/plugins.xml と同じとなるように更新します
+
+
+## 1.7.0 から 1.8.0 へのアップグレード ##
+
+1. プロジェクトの libs ディレクトリから cordova-1.7.0.jar を削除します
+2. プロジェクトの libs ディレクトリに cordova-1.8.0.jar を追加します
+3. もし Eclipse を使用している場合は、プロジェクトをリフレッシュし clean を実行します
+4. 新しい cordova-1.8.0.js をプロジェクトにコピーします
+5. HTML を、新しい cordova-1.8.0.js を使って更新します
+6. res/xml/plugins.xml を framework/res/xml/plugins.xml と同じとなるように更新します
+
+
+## 1.6.1 から 1.7.0 へのアップグレード ##
+
+1. プロジェクトの libs ディレクトリから cordova-1.6.1.jar を削除します
+2. プロジェクトの libs ディレクトリに cordova-1.7.0.jar を追加します
+3. もし Eclipse を使用している場合は、プロジェクトをリフレッシュし clean を実行します
+4. 新しい cordova-1.7.0.js をプロジェクトにコピーします
+5. res/xml/plugins.xml を framework/res/xml/plugins.xml と同じとなるように更新します
+
+
+## 1.6.0 から 1.6.1 へのアップグレード ##
+
+1. プロジェクトの libs ディレクトリから cordova-1.6.0.jar を削除します
+2. プロジェクトの libs ディレクトリに cordova-1.6.1.jar を追加します
+3. もし Eclipse を使用している場合は、プロジェクトをリフレッシュし clean を実行します
+4. 新しい cordova-1.6.1.js をプロジェクトにコピーします
+5. res/xml/plugins.xml を framework/res/xml/plugins.xml と同じとなるように更新します
+
+## 1.5.0 から 1.6.0 へのアップグレード ##
+
+1. プロジェクトの libs ディレクトリから cordova-1.5.0.jar を削除します
+2. プロジェクトの libs ディレクトリに cordova-1.6.0.jar を追加します
+3. もし Eclipse を使用している場合は、プロジェクトをリフレッシュし clean を実行します
+4. 新しい cordova-1.6.0.js をプロジェクトにコピーします
+5. HTML を、新しい cordova-1.6.0.js を使って更新します
+6. res/xml/plugins.xml を framework/res/xml/plugins.xml と同じとなるように更新します
+7. res/xml/phonegap.xml を、 framework/res/xml/cordova.xml と同じになるように res/xml/cordova.xml に置き換えます
+
+## 1.4.0 から 1.5.0 へのアップグレード ##
+
+1. プロジェクトの libs ディレクトリから phonegap-1.4.0.jar を削除します
+2. プロジェクトの libs ディレクトリに cordova-1.5.0.jar を追加します
+3. もし Eclipse を使用している場合は、プロジェクトをリフレッシュし clean を実行します
+4. 新しい cordova-1.5.0.js をプロジェクトにコピーします
+5. HTML を、新しい cordova-1.5.0.js を使って更新します
+6. res/xml/plugins.xml を framework/res/xml/plugins.xml と同じとなるように更新します
+7. res/xml/phonegap.xml を、 framework/res/xml/cordova.xml と同じになるように res/xml/cordova.xml に置き換えます
+
+## 1.3.0 から 1.4.0 へのアップグレード ##
+
+1. プロジェクトの libs ディレクトリから phonegap-1.3.0.jar を削除します
+2. プロジェクトの libs ディレクトリに phonegap-1.4.0.jar を追加します
+3. もし Eclipse を使用している場合は、プロジェクトをリフレッシュし clean を実行します
+4. 新しい phonegap-1.4.0.js をプロジェクトにコピーします
+5. HTML を、新しい phonegap-1.4.0.js を使って更新します
+6. res/xml/plugins.xml を framework/res/xml/plugins.xml と同じとなるように更新します
+7. res/xml/phonegap.xml を framework/res/xml/phonegap.xml と同じになるように更新します
+
+
+## 1.2.0 から 1.3.0 へのアップグレード ##
+
+1. プロジェクトの libs ディレクトリから phonegap-1.2.0.jar を削除します
+2. プロジェクトの libs ディレクトリに phonegap-1.3.0.jar を追加します
+3. もし Eclipse を使用している場合は、プロジェクトをリフレッシュし clean を実行します
+4. 新しい phonegap-1.3.0.js をプロジェクトにコピーします
+5. HTML を、新しい phonegap-1.3.0.js を使って更新します
+6. res/xml/plugins.xml を framework/res/xml/plugins.xml と同じとなるように更新します
+7. res/xml/phonegap.xml を framework/res/xml/phonegap.xml と同じになるように更新します
+
+
+## 1.1.0 から 1.2.0 へのアップグレード ##
+
+1. プロジェクトの libs ディレクトリから phonegap-1.1.0.jar を削除します
+2. プロジェクトの libs ディレクトリに phonegap-1.2.0.jar を追加します
+3. もし Eclipse を使用している場合は、プロジェクトをリフレッシュし clean を実行します
+4. 新しい phonegap-1.2.0.js をプロジェクトにコピーします
+5. HTML を、新しい phonegap-1.2.0.js を使って更新します
+6. res/xml/plugins.xml を framework/res/xml/plugins.xml と同じとなるように更新します
+7. res/xml/phonegap.xml を framework/res/xml/phonegap.xml と同じになるように更新します
+
+
+## 1.0.0 から 1.1.0 へのアップグレード ##
+
+1. プロジェクトの libs ディレクトリから phonegap-1.0.0.jar を削除します
+2. プロジェクトの libs ディレクトリに phonegap-1.1.0.jar を追加します
+3. もし Eclipse を使用している場合は、プロジェクトをリフレッシュし clean を実行します
+4. 新しい phonegap-1.1.0.js をプロジェクトにコピーします
+5. HTML を、新しい phonegap-1.1.0.js を使って更新します
+6. res/xml/plugins.xml を framework/res/xml/plugins.xml と同じとなるように更新します
+
+
+## 0.9.6 から 1.0.0 へのアップグレード ##
+
+1. プロジェクトの libs ディレクトリから phonegap-0.9.6.jar を削除します
+2. プロジェクトの libs ディレクトリに phonegap-1.0.0.jar を追加します
+3. もし Eclipse を使用している場合は、プロジェクトをリフレッシュし clean を実行します
+4. 新しい phonegap-1.0.0.js をプロジェクトにコピーします
+5. HTML を、新しい phonegap-1.0.0.js を使って更新します
+6. res/xml/plugins.xml を framework/res/xml/plugins.xml と同じとなるように更新します
+
+