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/01/02 23:25:39 UTC
[2/16] Copy docs/jp/2.0.0 to docs/jp/2.1.0
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/4272ca34/docs/jp/2.1.0/guide/getting-started/ios/index.md
----------------------------------------------------------------------
diff --git a/docs/jp/2.1.0/guide/getting-started/ios/index.md b/docs/jp/2.1.0/guide/getting-started/ios/index.md
new file mode 100644
index 0000000..842edb1
--- /dev/null
+++ b/docs/jp/2.1.0/guide/getting-started/ios/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 iOS
+========================
+
+このガイドは、 Apache Cordova のための開発環境セットアップ方法、また Apache Cordova のサンプルアプリの動かし方を解説します。
+
+必要なもの
+---------------
+- Xcode 4.3+
+- Xcode コマンドラインツール
+- Intel ベースの Mac OS X Lion 以上 (10.7+)
+- デバイスへのインストールに必要なもの:
+ - Apple iOS デバイス (iPhone, iPad, iPod Touch)
+ - iOS デベロッパー証明書
+
+SDK と Apache Cordova のインストール
+------------------------
+
+- [Mac App Store](http://itunes.apple.com/us/app/xcode/id497799835?mt=12) から Xcode をインストールします。
+- Xcode コマンドラインツール (Xcode Preferences -> Downloads -> Components -> Command Line Tools -> Install) をインストールします。
+- [Apache Cordova](http://phonegap.com/download) の最新版をダウンロードします。
+ - ダウンロードしたものを解凍します
+ - Apache Corder iOS は `lib/ios` ディレクトリ以下にあります
+
+新規プロジェクトの作成
+--------------------
+- **'Cordova-2.0.0.pkg'** インストーラーを実行し、インストールを完了します
+- **bin** フォルダー (ソース、もしくは .dmg から) をハードドライブ上にコピーします
+
+ 
+
+- **Terminal.app** を起動します
+- コピーした **bin** フォルダーを Dock にある **Terminal.app** のアイコンにドラッグします。これにより、新しいターミナルのウィンドウが開きます
+- `./create <project_folder_path> <bundle_id> <project_name>` を入力し、 **"Enter"** を押します
+
+ <project_folder_path> は新しい Cordova iOS プロジェクトへのパスを表します (もし既に存在する場合は、空である必要があります)
+ <package_name> はリバースドメインスタイルのパッケージ名を表します
+ <project_name> はプロジェクト名を表します
+
+ 
+
+
+- たった今作成した新しいプロジェクトフォルダーを **見つけます**
+- フォルダーの中の .xcodeproj を **起動します**
+
+
+シミュレーターへのデプロイ
+-----------------------
+
+- ツールバーにあるドロップダウンメニューから **Target** を **"HelloWorld"** (あなたのプロジェクト名) に変更します
+- ツールバーにあるドロップダウンメニューから **Active SDK** を **iOS [version] Simulator** に変更します
+
+ 
+
+- プロジェクトウィンドウのツールバーにある _Run_ ボタンをクリックします
+
+デバイスへのデプロイ
+--------------------
+
+- **Resources** グループの中にある `HelloWorld-Info.plist` を開きます
+- **BundleIdentifier** を Apple から提供された Identifer 、または自分の Identifer に変更します
+ - もし開発者ライセンスを持っている場合は、 [Assistant] (http://developer.apple.com/iphone/manage/overview/index.action) よりアプリを登録できます
+- ツールバーにあるドロップダウンメニューから **Target** を **"HelloWorld"** (あなたのプロジェクト名) に変更します
+- ツールバーにあるドロップダウンメニューから **Active SDK** を **[あなたのDevice名]** に変更します
+ - デバイスを USB で接続する必要があります
+
+ 
+
+- プロジェクトウィンドウのツールバーにある _Run_ ボタンをクリックします
+
+結果
+----------------
+- 緑色の点滅した **"device is ready"** のメッセージを伴った画面が見えるはずです
+
+ 
+
+Xcode の問題
+----------------
+もしヘッダーが無いなどに関連した編集での問題がある場合、ビルドプロダクトは **同じビルドディレクトリでビルドする** 必要があります。**"Xcode Preferences -> Locations -> Derived Data -> Advanced…"** の設定を **"Unique"** に変更する必要があるかもしれません。これは Xcode をインストールした直後のデフォルト設定ですが、もし古いバージョンからアップグレードした場合は昔の設定が残っており、その場合はアップデートする必要があります。
+
+また、 **Cordova-2.0.0.pkg** をインストールする時、 Xcode が起動していないことを確認擦る必要があります。もし起動していた場合は、 Xcode のセットされるべき値がセットされません。
+
+
+アプリを作成
+--------------
+
+これで Xcode プロジェクトのセットアップが完了し、シミュレーターまたはデバイスでビルドし動かすことが出来ます。
+アプリを書くために、 Xcode を使用する必要はありません。
+あなたの好きなテキストエディターを使い、 Xcode 、またはプロジェクトフォルダ (**cordova** サブフォルダ) 内で [コマンドラインツール](guide_command-line_index.md.html) でリビルド作業を行えます。
+Xcode は自動的に `www` ディレクトリ内にあるファイルの変化を検出します。
+
+コマンドラインツールの問題
+----------------
+もし **"Error: No developer directory found at /Developer. Run /usr/bin/xcode-select to update the developer directory path."** というエラーを見る場合、 Developer フォルダーを設定するために以下を実行してください:
+
+ sudo /usr/bin/xcode-select -switch /Applications/Xcode.app/Contents/Developer
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/4272ca34/docs/jp/2.1.0/guide/getting-started/symbian/index.md
----------------------------------------------------------------------
diff --git a/docs/jp/2.1.0/guide/getting-started/symbian/index.md b/docs/jp/2.1.0/guide/getting-started/symbian/index.md
new file mode 100644
index 0000000..9d63f40
--- /dev/null
+++ b/docs/jp/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/4272ca34/docs/jp/2.1.0/guide/getting-started/webos/index.md
----------------------------------------------------------------------
diff --git a/docs/jp/2.1.0/guide/getting-started/webos/index.md b/docs/jp/2.1.0/guide/getting-started/webos/index.md
new file mode 100644
index 0000000..4b1a986
--- /dev/null
+++ b/docs/jp/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/4272ca34/docs/jp/2.1.0/guide/getting-started/windows-phone/index.md
----------------------------------------------------------------------
diff --git a/docs/jp/2.1.0/guide/getting-started/windows-phone/index.md b/docs/jp/2.1.0/guide/getting-started/windows-phone/index.md
new file mode 100644
index 0000000..db77929
--- /dev/null
+++ b/docs/jp/2.1.0/guide/getting-started/windows-phone/index.md
@@ -0,0 +1,101 @@
+---
+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\
+もし VisualStudio をインストールしたばかりの場合は、このフォルダーを作成するために一度起動する必要があります。
+"Visual C#" の "Silverlight for Windows Phone" サブフォルダーの代わりにこのプロジェクトを追加することも出来ます。これは、新しいプロジェクトを作るときにプロジェクトテンプレートがどこに表れるかに影響するだけです。また、このフォルダーを作成する必要があるかもしれません。
+
+
+
+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. デバイスのためにプロジェクトをビルド
+------------------------------------
+
+デバイスでアプリをテストするためには、デバイスは登録されていなければなりません。 [ここ](http://msdn.microsoft.com/en-us/library/gg588378(v=VS.92).aspx) をクリックし、 Windows Phone へのデプロイとテストに関するドキュメントを読んでください。
+
+- デバイスが接続され、スクリーンがアンロックなことを確認します
+- Visual Studio で、上部のドロップダウンメニューから 'Windows Phone Device' を選択します
+- ドロップダウンメニューの隣にある緑の **play ボタン** をクリックするか、 F5 を押下しデバッグを開始します
+
+ 
+
+
+終了
+-----
+
+さらに詳しいガイドは [ここ](http://wiki.phonegap.com/w/page/48672055/Getting%20Started%20with%20PhoneGap%20Windows%20Phone%207) で確認できます。
+
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/4272ca34/docs/jp/2.1.0/guide/plugin-development/android/index.md
----------------------------------------------------------------------
diff --git a/docs/jp/2.1.0/guide/plugin-development/android/index.md b/docs/jp/2.1.0/guide/plugin-development/android/index.md
new file mode 100644
index 0000000..910c54e
--- /dev/null
+++ b/docs/jp/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/4272ca34/docs/jp/2.1.0/guide/plugin-development/bada/index.md
----------------------------------------------------------------------
diff --git a/docs/jp/2.1.0/guide/plugin-development/bada/index.md b/docs/jp/2.1.0/guide/plugin-development/bada/index.md
new file mode 100644
index 0000000..2732582
--- /dev/null
+++ b/docs/jp/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/4272ca34/docs/jp/2.1.0/guide/plugin-development/blackberry/index.md
----------------------------------------------------------------------
diff --git a/docs/jp/2.1.0/guide/plugin-development/blackberry/index.md b/docs/jp/2.1.0/guide/plugin-development/blackberry/index.md
new file mode 100644
index 0000000..d92c90c
--- /dev/null
+++ b/docs/jp/2.1.0/guide/plugin-development/blackberry/index.md
@@ -0,0 +1,138 @@
+---
+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=incubator-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;
+ import org.apache.cordova.util.Logger;
+ /**
+ * 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 {
+ JSONObject echoObj = new JSONObject();
+ String theMsg = args.getString(0);
+ if(theMsg.length()>0){
+ result = new PluginResult(PluginResult.Status.OK, theMsg);
+ }else{
+ result = new PluginResult(PluginResult.Status.ERROR, theMsg);
+ }
+ } 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/4272ca34/docs/jp/2.1.0/guide/plugin-development/index.md
----------------------------------------------------------------------
diff --git a/docs/jp/2.1.0/guide/plugin-development/index.md b/docs/jp/2.1.0/guide/plugin-development/index.md
new file mode 100644
index 0000000..1538786
--- /dev/null
+++ b/docs/jp/2.1.0/guide/plugin-development/index.md
@@ -0,0 +1,111 @@
+---
+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
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/4272ca34/docs/jp/2.1.0/guide/plugin-development/ios/index.md
----------------------------------------------------------------------
diff --git a/docs/jp/2.1.0/guide/plugin-development/ios/index.md b/docs/jp/2.1.0/guide/plugin-development/ios/index.md
new file mode 100644
index 0000000..e655d2d
--- /dev/null
+++ b/docs/jp/2.1.0/guide/plugin-development/ios/index.md
@@ -0,0 +1,157 @@
+---
+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` 配列で渡された引数と一緒に呼び出すということになります。
+
+Objective-C プラグインメソッドの `options` パラメーターは非推奨であり、使われるべきではありません。レガシー的な理由で、 `args` 配列の最後の JavaScript オブジェクト要素は、 Objective-C 側メソッドの `options` 辞書に渡されます。どんな JavaScript オブジェクトでも `args` 配列の最後の要素として渡されるべきであり、もし配列の途中の要素に JavaScript オブジェクトがあると、それ以降の Objective-C 側の配列のインデックスがでたらめになることに十分注意してください。 options 辞書はただ1つの JavaScript オブジェクトのみをサポートしており、また配列の一番最後の要素のみネイティブメソッドに渡されます。このようにエラーを起こしやすいので、 `options` は非推奨となっています。
+
+このプラグインは、 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:(NSMutableArray*)arguments withDict:(NSMutableDictionary*)options
+ {
+ NSString* callbackId = [arguments objectAtIndex:0];
+
+ CDVPluginResult* pluginResult = nil;
+ NSString* javaScript = nil;
+
+ @try {
+ NSString* myarg = [arguments objectAtIndex:1];
+
+ if (myarg != nil) {
+ pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];
+ javaScript = [pluginResult toSuccessCallbackString:callbackId];
+ }
+ } @catch (id exception) {
+ pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_JSON_EXCEPTION messageAsString:[exception reason]];
+ javaScript = [pluginResult toErrorCallbackString:callbackId];
+ }
+
+ [self writeJavascript:javaScript];
+ }
+
+
+### iOS プラグインの Echo プラグイン
+
+`Cordova.plist` ファイルの `Plugins` キー (辞書) に以下を追加します:
+
+ <key>Echo</key>
+ <string>Echo</string>
+
+次のファイル (`Echo.h` と `Echo.m`) を Cordova-iOS アプリケーションフォルダーの中の
+プラグインフォルダーに追加します:
+
+ /********* Echo.h Cordova Plugin Header *******/
+
+ #import <Cordova/CDVPlugin.h>
+
+ @interface Echo : CDVPlugin
+
+ - (void) echo:(NSMutableArray*)arguments withDict:(NSMutableDictionary*)options;
+
+ @end
+
+ /********* Echo.m Cordova Plugin Implementation *******/
+
+ #import "Echo.h"
+ #import <Cordova/CDVPluginResult.h>
+
+ @implementation Echo
+
+ - (void) echo:(NSMutableArray*)arguments withDict:(NSMutableDictionary*)options
+ {
+ NSString* callbackId = [arguments objectAtIndex:0];
+
+ CDVPluginResult* pluginResult = nil;
+ NSString* javaScript = nil;
+
+ @try {
+ NSString* echo = [arguments objectAtIndex:1];
+
+ if (echo != nil && [echo length] > 0) {
+ pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:echo];
+ javaScript = [pluginResult toSuccessCallbackString:callbackId];
+ } else {
+ pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR];
+ javaScript = [pluginResult toErrorCallbackString:callbackId];
+ }
+ } @catch (NSException* exception) {
+ pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_JSON_EXCEPTION messageAsString:[exception reason]];
+ javaScript = [pluginResult toErrorCallbackString:callbackId];
+ }
+
+ [self writeJavascript:javaScript];
+ }
+
+ @end
+
+
+コードを見ていきましょう。一番上には、必要なすべての Cordova に関する import 文が並んでいます。クラスは `CDVPlugin` を継承しています - これはとても重要です。
+
+このプラグインは1つのアクション `echo` のみをサポートしています。最初に、引数配列の0番目の要素である `callbackId` パラメーターを取得します。次に、 `objectAtIndex` メソッドを使って、引数配列の1番目の要素である echo 用文字列を取得します。ここで、少しパラメーターに対してチェックを行います: `nil` チェックや文字列の長さが0でないかどうかなどです。
+
+もしそうであった場合は、ステータスが `ERROR` の `PluginResult` を返します。もしこれらのチェックをパスしたら、ステータスが `OK` の `PluginResult` を返し、パラメーターとして受け取った `echo` 文字列を渡します。そして、もし正常な場合は `toSuccessCallbackString` メソッド、エラーの場合は `toErrorCallbackString` メソッドを呼びだして `PluginResult` を JavaScript に変換します。
+
+最後に、 JavaScript 側で成功またはエラーコールバック関数を実行するような JavaScript を書き出します。もし成功コールバックが呼ばれた場合は、 `echo` パラメーターをパラメーターとして渡します。
+
+## 一歩進んだプラグインの機能
+
+他にも、オーバーライド出来るメソッドについては以下を参照してください:
+
+1. [CDVPlugin.h](https://github.com/apache/incubator-cordova-ios/blob/master/CordovaLib/Classes/CDVPlugin.h)
+2. [CDVPlugin.m](https://github.com/apache/incubator-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/incubator-cordova-weinre) または [サードパーティ製の iWebInspector](http://www.iwebinspector.com/) を使用できます。
+
+## よくある落とし穴
+
+* Cordova.plist にプラグインマッピングを追加することを忘れないでください - もし忘れている場合は、 Xcode のコンソールログにエラーが表示されます
+* 接続するすべてのホストを [ホワイトリスト](guide_whitelist_index.md.html#Domain%20Whitelist%20Guide) に追加することを忘れないで下さい - もし忘れている場合は、 Xcode のコンソールログにエラーが表示されます
+* もしアプリが復帰する際にイベント処理をしていて、イベント復帰時にアラートといったようなネイティブ関数を実行すると、アプリケーションが停止してしまいます。安全のため、 JavaScript 呼び出しをタイムアウト値0の setTimeout でラップしてください:
+
+ setTimeout(function() {
+ // 任意のコード
+ }, 0);
+
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/4272ca34/docs/jp/2.1.0/guide/plugin-development/webos/index.md
----------------------------------------------------------------------
diff --git a/docs/jp/2.1.0/guide/plugin-development/webos/index.md b/docs/jp/2.1.0/guide/plugin-development/webos/index.md
new file mode 100644
index 0000000..e341f4f
--- /dev/null
+++ b/docs/jp/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/4272ca34/docs/jp/2.1.0/guide/plugin-development/windows-phone/index.md
----------------------------------------------------------------------
diff --git a/docs/jp/2.1.0/guide/plugin-development/windows-phone/index.md b/docs/jp/2.1.0/guide/plugin-development/windows-phone/index.md
new file mode 100644
index 0000000..35c3cbb
--- /dev/null
+++ b/docs/jp/2.1.0/guide/plugin-development/windows-phone/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 Windows Phone
+====================================
+
+準備中です...
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/4272ca34/docs/jp/2.1.0/guide/upgrading/android/index.md
----------------------------------------------------------------------
diff --git a/docs/jp/2.1.0/guide/upgrading/android/index.md b/docs/jp/2.1.0/guide/upgrading/android/index.md
new file mode 100644
index 0000000..1ab5edb
--- /dev/null
+++ b/docs/jp/2.1.0/guide/upgrading/android/index.md
@@ -0,0 +1,162 @@
+---
+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 を古いバージョンから新しいバージョンにアップグレードする必要がある人のためのドキュメントです。
+
+## 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 と同じとなるように更新します
+
+
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/4272ca34/docs/jp/2.1.0/guide/upgrading/bada/index.md
----------------------------------------------------------------------
diff --git a/docs/jp/2.1.0/guide/upgrading/bada/index.md b/docs/jp/2.1.0/guide/upgrading/bada/index.md
new file mode 100644
index 0000000..0aa5a9b
--- /dev/null
+++ b/docs/jp/2.1.0/guide/upgrading/bada/index.md
@@ -0,0 +1,48 @@
+---
+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 Bada
+======================
+
+これは、 Cordova を古いバージョンから新しいバージョンにアップグレードする
+必要がある人のためのドキュメントです。
+
+## 1.9.0 から 2.0.0 へのアップグレード ##
+
+1. 新しい JavaScript ファイルを使って `Res/js/cordova.js` を更新します
+
+## 1.8.x から 1.9.0 へのアップグレード ##
+
+1. 新しい JavaScript ファイルを使って `Res/js/cordova.js` を更新します
+
+## 1.7.0 から 1.8.x へのアップグレード ##
+
+1. cordova.bada.js ファイルを Res/js ディレクトリから削除します
+2. 新しい cordova.js ファイルを Res/js ディレクトリに追加します
+3. Res/index.html を、 cordova.js ではなく cordova.bada.js を参照するように更新します
+
+この行を次から:
+
+ <script type="text/javascript" src="./js/cordova.bada.js"></script>
+次に変更します:
+
+ <script type="text/javascript" src="./js/cordova.js"></script>
+
+Cordova 1.8 では、 Bada 1.2 は既にサポートされていません。
+このリポジトリは今後も使用したい方のためにアーカイブとして存続します。このため、これにはいくつかの廃止された API が含まれます。
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/4272ca34/docs/jp/2.1.0/guide/upgrading/blackberry/index.md
----------------------------------------------------------------------
diff --git a/docs/jp/2.1.0/guide/upgrading/blackberry/index.md b/docs/jp/2.1.0/guide/upgrading/blackberry/index.md
new file mode 100644
index 0000000..96b3506
--- /dev/null
+++ b/docs/jp/2.1.0/guide/upgrading/blackberry/index.md
@@ -0,0 +1,117 @@
+---
+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 BlackBerry
+============================
+
+これは、 Cordova を古いバージョンから新しいバージョンにアップグレードする必要がある人のためのドキュメントです。
+
+## 1.9.0 から 2.0.0 へのアップグレード ##
+
+www フォルダーのアップデート:
+
+1. アプリの `www/` フォルダーを開きます
+2. `ext/` フォルダーにある .jar ファイルを削除し更新します
+3. `ext-air/` フォルダーの内容を更新します
+4. 新しい `cordova-2.0.0.js` をプロジェクトにコピーします
+ - playbook の場合は `playbook/` フォルダーの中の .js ファイルを更新します
+5. HTML を、新しい `cordova-2.0.0.js` を使って更新します
+6. `www/plugins.xml` ファイルを更新します。2つのプラグインの
+ ネームスペース/サービスのラベルが変更されています。
+ 古い Capture 及び Contact プラグインを次から:
+
+ <plugin name="Capture" value="org.apache.cordova.media.MediaCapture"/>
+ <plugin name="Contact" value="org.apache.cordova.pim.Contact"/>
+
+ 次に変更します:
+
+ <plugin name="Capture" value="org.apache.cordova.capture.MediaCapture"/>
+ <plugin name="Contacts" value="org.apache.cordova.pim.Contact"/>
+
+
+サンプルフォルダーのアップデート (例, ant ツールを使ったアップデート):
+
+1. `sample/lib/` フォルダーを開きます
+2. `cordova.1.9.0/ext/` フォルダーにある .jar ファイルを更新します
+3. `cordova.1.9.0/ext-air/` フォルダーの内容を更新します
+4. `cordova.1.9.0/javascript/` フォルダーにある .js ファイルを更新します
+5. `sample/lib/` フォルダーを開き、 `cordova.1.9.0/` フォルダーの名前を `cordova.2.0.0/` に変更します
+6. `www/` フォルダーを新しい Cordova でアップデートするため、 `ant blackberry build` または `ant playbook build` とタイプします
+7. `www/` フォルダーを開き、新しい `cordova-2.0.0.js` を使って HTML を更新します
+8. `www/` フォルダーを開き `plugins.xml` ファイルを更新します。2つのプラグインの
+ ネームスペース/サービスのラベルが変更されています。
+ 古い Capture 及び Contact プラグインを次から:
+
+ <plugin name="Capture" value="org.apache.cordova.media.MediaCapture"/>
+ <plugin name="Contact" value="org.apache.cordova.pim.Contact"/>
+
+ 次に変更します:
+
+ <plugin name="Capture" value="org.apache.cordova.capture.MediaCapture"/>
+ <plugin name="Contacts" value="org.apache.cordova.pim.Contact"/>
+
+
+
+
+- 1.8.0 にアップグレードするには、 1.7.0 からアップグレードしてください
+
+## 1.7.0 から 1.8.0 へのアップグレード ##
+
+www フォルダーのアップデート:
+
+1. アプリの `www/` フォルダーを開きます
+2. `ext/` フォルダーにある .jar ファイルを削除し更新します
+3. `ext-air/` フォルダーの内容を更新します
+4. 新しい `cordova-1.8.0.js` をプロジェクトにコピーします
+ - playbook の場合は `playbook/` フォルダーの中の .js ファイルを更新します
+5. 新しい `cordova-1.8.0.js` を使って HTML を更新します
+6. `www/plugins.xml` ファイルを更新します。2つのプラグインの
+ ネームスペース/サービスのラベルが変更されています。
+ 古い Capture 及び Contact プラグインを次から:
+
+ <plugin name="Capture" value="org.apache.cordova.media.MediaCapture"/>
+ <plugin name="Contact" value="org.apache.cordova.pim.Contact"/>
+
+ 次に変更します:
+
+ <plugin name="Capture" value="org.apache.cordova.capture.MediaCapture"/>
+ <plugin name="Contacts" value="org.apache.cordova.pim.Contact"/>
+
+
+サンプルフォルダーのアップデート (例, ant ツールを使ったアップデート):
+
+1. `sample/lib/` フォルダーを開きます
+2. `cordova.1.7.0/ext/` フォルダーにある .jar ファイルを更新します
+3. `cordova.1.7.0/ext-air/` フォルダーの内容を更新します
+4. `cordova.1.7.0/javascript/` フォルダーにある .js ファイルを更新します
+5. `sample/lib/` フォルダーを開き、 `cordova.1.7.0/` フォルダーを `cordova.1.8.0/` へリネームします
+6. `www/` フォルダーを新しい Cordova でアップデートするため、 `ant blackberry build` または `ant playbook build` とタイプします
+7. `www/` フォルダーを開き、HTML を、新しい `cordova-1.8.0.js` を使って更新します
+8. `www/` フォルダーを開き `plugins.xml` ファイルを更新します。2つのプラグインの
+ ネームスペース/サービスのラベルが変更されています。
+ 古い Capture 及び Contact プラグインを次から:
+
+ <plugin name="Capture" value="org.apache.cordova.media.MediaCapture"/>
+ <plugin name="Contact" value="org.apache.cordova.pim.Contact"/>
+
+ 次に変更します:
+
+ <plugin name="Capture" value="org.apache.cordova.capture.MediaCapture"/>
+ <plugin name="Contacts" value="org.apache.cordova.pim.Contact"/>
+
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/4272ca34/docs/jp/2.1.0/guide/upgrading/index.md
----------------------------------------------------------------------
diff --git a/docs/jp/2.1.0/guide/upgrading/index.md b/docs/jp/2.1.0/guide/upgrading/index.md
new file mode 100644
index 0000000..5eccdfc
--- /dev/null
+++ b/docs/jp/2.1.0/guide/upgrading/index.md
@@ -0,0 +1,31 @@
+---
+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.
+---
+
+アップグレードガイド
+================
+
+> アプリケーションを最新の Apache Cordova にアップグレードする方法を解説します。
+
+- Upgrading Cordova Android
+- Upgrading Cordova BlackBerry
+- Upgrading Cordova iOS
+- Upgrading Cordova Symbian
+- Upgrading Cordova webOS
+- Upgrading Cordova Windows Phone
+- Upgrading Cordova Bada