Added 5.0.0 for russion docs
diff --git a/docs/ru/5.0.0/config.json b/docs/ru/5.0.0/config.json
new file mode 100644
index 0000000..9d3477d
--- /dev/null
+++ b/docs/ru/5.0.0/config.json
@@ -0,0 +1,18 @@
+{
+ "language": "Russian",
+ "merge": {
+ "events.md": [
+ "cordova/events/events.md",
+ "cordova/events/events.deviceready.md",
+ "cordova/events/events.pause.md",
+ "cordova/events/events.resume.md",
+ "cordova/events/events.backbutton.md",
+ "cordova/events/events.menubutton.md",
+ "cordova/events/events.searchbutton.md",
+ "cordova/events/events.startcallbutton.md",
+ "cordova/events/events.endcallbutton.md",
+ "cordova/events/events.volumedownbutton.md",
+ "cordova/events/events.volumeupbutton.md"
+ ]
+ }
+}
diff --git a/docs/ru/5.0.0/config_ref/images.md b/docs/ru/5.0.0/config_ref/images.md
new file mode 100644
index 0000000..456c251
--- /dev/null
+++ b/docs/ru/5.0.0/config_ref/images.md
@@ -0,0 +1,210 @@
+---
+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.
+---
+
+# Иконки и заставки
+
+В этом разделе показано, как настроить иконку приложения и дополнительные заставки для различных платформ, как при работе с Cordova CLI (описано в разделе Интерфейс Командной Строки) так и с помощью средств SDK специфических для платформы (подробнее в разделе Руководстве по поддерживаемым платформам).
+
+## Настройка иконок в CLI
+
+Когда работает в CLI вы можете определить app icon(s) через `<icon>` элемент ( `config.xml` ). Если значок не задан, то используется Apache Cordova логотип.
+
+ <icon src="res/ios/icon.png" platform="ios" width="57" height="57" density="mdpi" />
+
+
+src: (обязательно) указывает расположение файла изображения, относительно каталога проекта
+
+Платформа: (необязательно) Целевая платформа
+
+ширина: (необязательно) значок ширина в пикселях
+
+Высота: (необязательно) значок высота в пикселях
+
+Плотность: (опционально) android конкретные, указывает значок плотности
+
+Следующая конфигурация может использоваться для определения единого по умолчанию значок, который будет использоваться для всех платформ.
+
+ <icon src="res/icon.png" />
+
+
+Для каждой платформы можно также определить идеальное значков, заданных для различных разрешений экрана.
+
+Amazon Fire OS
+
+ <platform name="amazon-fireos">
+ <icon src="res/android/ldpi.png" density="ldpi" />
+ <icon src="res/android/mdpi.png" density="mdpi" />
+ <icon src="res/android/hdpi.png" density="hdpi" />
+ <icon src="res/android/xhdpi.png" density="xhdpi" />
+ </platform>
+
+
+Android
+
+ <platform name="android">
+ <icon src="res/android/ldpi.png" density="ldpi" />
+ <icon src="res/android/mdpi.png" density="mdpi" />
+ <icon src="res/android/hdpi.png" density="hdpi" />
+ <icon src="res/android/xhdpi.png" density="xhdpi" />
+ </platform>
+
+
+BlackBerry10
+
+ <platform name="blackberry10">
+ <icon src="res/bb10/icon-86.png" />
+ <icon src="res/bb10/icon-150.png" />
+ </platform>
+
+
+Смотрите документацию BlackBerry при ориентировании на набор различных размеров и языков. [http://developer.blackberry.com/html5/documentation/icon_element.html]
+
+Firefox OS
+
+ <platform name="firefoxos">
+ <icon src="res/ff/logo.png" width="60" height="60" />
+ </platform>
+
+
+iOS
+
+ <platform name="ios">
+ <!-- iOS 8.0+ -->
+ <!-- iPhone 6 Plus -->
+ <icon src="res/ios/icon-60@3x.png" width="180" height="180" />
+ <!-- iOS 7.0+ -->
+ <!-- iPhone / iPod Touch -->
+ <icon src="res/ios/icon-60.png" width="60" height="60" />
+ <icon src="res/ios/icon-60@2x.png" width="120" height="120" />
+ <!-- iPad -->
+ <icon src="res/ios/icon-76.png" width="76" height="76" />
+ <icon src="res/ios/icon-76@2x.png" width="152" height="152" />
+ <!-- iOS 6.1 -->
+ <!-- Spotlight Icon -->
+ <icon src="res/ios/icon-40.png" width="40" height="40" />
+ <icon src="res/ios/icon-40@2x.png" width="80" height="80" />
+ <!-- iPhone / iPod Touch -->
+ <icon src="res/ios/icon.png" width="57" height="57" />
+ <icon src="res/ios/icon@2x.png" width="114" height="114" />
+ <!-- iPad -->
+ <icon src="res/ios/icon-72.png" width="72" height="72" />
+ <icon src="res/ios/icon-72@2x.png" width="144" height="144" />
+ <!-- iPhone Spotlight and Settings Icon -->
+ <icon src="res/ios/icon-small.png" width="29" height="29" />
+ <icon src="res/ios/icon-small@2x.png" width="58" height="58" />
+ <!-- iPad Spotlight and Settings Icon -->
+ <icon src="res/ios/icon-50.png" width="50" height="50" />
+ <icon src="res/ios/icon-50@2x.png" width="100" height="100" />
+ </platform>
+
+
+Tizen
+
+ <platform name="tizen">
+ <icon src="res/tizen/icon-128.png" width="128" height="128" />
+ </platform>
+
+
+Windows Phone8
+
+ <platform name="wp8">
+ <icon src="res/wp/ApplicationIcon.png" width="99" height="99" />
+ <!-- tile image -->
+ <icon src="res/wp/Background.png" width="159" height="159" />
+ </platform>
+
+
+Windows8
+
+ <platform name="windows8">
+ <icon src="res/windows8/logo.png" width="150" height="150" />
+ <icon src="res/windows8/smalllogo.png" width="30" height="30" />
+ <icon src="res/windows8/storelogo.png" width="50" height="50" />
+ </platform>
+
+
+## Настройка заставки с помощью CLI
+
+В верхнего уровня `config.xml` файл (не один в `platforms` ), добавьте элементы конфигурации как те, которые указаны здесь.
+
+# Пример конфигурации
+
+Пожалуйста, обратите внимание, что значение атрибута «src» является относительно каталога проекта, а не в каталог www. Как угодно можно назвать исходного изображения. Внутреннее имя в приложении определяются Кордова.
+
+ <platform name="android">
+ <!-- you can use any density that exists in the Android project -->
+ <splash src="res/screen/android/splash-land-hdpi.png" density="land-hdpi"/>
+ <splash src="res/screen/android/splash-land-ldpi.png" density="land-ldpi"/>
+ <splash src="res/screen/android/splash-land-mdpi.png" density="land-mdpi"/>
+ <splash src="res/screen/android/splash-land-xhdpi.png" density="land-xhdpi"/>
+
+ <splash src="res/screen/android/splash-port-hdpi.png" density="port-hdpi"/>
+ <splash src="res/screen/android/splash-port-ldpi.png" density="port-ldpi"/>
+ <splash src="res/screen/android/splash-port-mdpi.png" density="port-mdpi"/>
+ <splash src="res/screen/android/splash-port-xhdpi.png" density="port-xhdpi"/>
+ </platform>
+
+ <platform name="ios">
+ <!-- images are determined by width and height. The following are supported -->
+ <splash src="res/screen/ios/Default~iphone.png" width="320" height="480"/>
+ <splash src="res/screen/ios/Default@2x~iphone.png" width="640" height="960"/>
+ <splash src="res/screen/ios/Default-Portrait~ipad.png" width="768" height="1024"/>
+ <splash src="res/screen/ios/Default-Portrait@2x~ipad.png" width="1536" height="2048"/>
+ <splash src="res/screen/ios/Default-Landscape~ipad.png" width="1024" height="768"/>
+ <splash src="res/screen/ios/Default-Landscape@2x~ipad.png" width="2048" height="1536"/>
+ <splash src="res/screen/ios/Default-568h@2x~iphone.png" width="640" height="1136"/>
+ <splash src="res/screen/ios/Default-667h.png" width="750" height="1334"/>
+ <splash src="res/screen/ios/Default-736h.png" width="1242" height="2208"/>
+ <splash src="res/screen/ios/Default-Landscape-736h.png" width="2208" height="1242"/>
+ </platform>
+
+ <platform name="wp8">
+ <!-- images are determined by width and height. The following are supported -->
+ <splash src="res/screen/wp8/SplashScreenImage.jpg" width="768" height="1280"/>
+ </platform>
+
+ <platform name="windows8">
+ <!-- images are determined by width and height. The following are supported -->
+ <splash src="res/screen/windows8/splashscreen.png" width="620" height="300"/>
+ </platform>
+
+ <platform name="blackberry10">
+ <!-- Add a rim:splash element for each resolution and locale you wish -->
+ <!-- http://developer.blackberry.com/html5/documentation/rim_splash_element.html -->
+ <rim:splash src="res/screen/windows8/splashscreen.png"/>
+ </platform>
+
+
+ <preference name="SplashScreenDelay" value="10000" />
+
+
+# Поддерживаемые платформы
+
+На данный момент (Кордова 3.5.0 июля 2014 года) следующие платформы поддерживают экраны-заставки.
+
+ android
+ ios
+ wp8
+ windows8
+ blackberry10
+
+
+# SplashScreen плагин
+
+Apache Cordova также предлагает специальные заставки экрана плагин, который может быть использован для программного отображения и скрытия заставки во время https://github.com/apache/cordova-plugin-splashscreen запуска приложения
\ No newline at end of file
diff --git a/docs/ru/5.0.0/config_ref/index.md b/docs/ru/5.0.0/config_ref/index.md
new file mode 100644
index 0000000..b72e06c
--- /dev/null
+++ b/docs/ru/5.0.0/config_ref/index.md
@@ -0,0 +1,188 @@
+---
+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.
+---
+
+# Файл config.xml
+
+Многие аспекты поведения приложения могут контролироваться с помощью глобального конфигурационного файла `config.xml`. Этот платформо-зависимый XML-файл основан на спецификации W3C [Упакованые веб-приложения (Packaged Web Apps)][1] и расширен для указаниях основных функций Cordova API, плагинов и настроек специфичных для платформы.
+
+ [1]: http://www.w3.org/TR/widgets/
+
+Для проектов, созданных с использованием Cordova CLI (описанном в разделе Интерфейс командной строки) этот файл можно найти в директории верхнего уровня:
+
+ app/config.xml
+
+
+Обратите внимание, что до версии 3.3.1-0.2.0, файл располагался в `app/www/config.xml`, и что размещение файла в этом месте по-прежнему поддерживается.
+
+При использовании командной строки для построения проекта, версии этого файла копируются без изменений в различные подкаталоги `platforms/`, например:
+
+ app/platforms/ios/AppName/config.xml
+ app/platforms/blackberry10/www/config.xml
+ app/platforms/android/res/xml/config.xml
+
+
+Этот раздел описывает параметры глобальной и кросс платформенной конфигурации. В следующих разделах для платформо-зависимых параметров:
+
+* Настройка iOS
+* Настройка Android
+* Настройка BlackBerry 10
+
+В дополнение к различным конфигурационным параметрам описанным ниже, можно также настроить основной набор изображений для приложения для каждой целевой платформы. Смотрите раздел Иконки и Заставки для дополнительной информации.
+
+## Основные элементы конфигурации
+
+Этот пример показывает значения по умолчанию в файле `config.xml` сформированном командой CLI `create`, описанной в разделе Интерфейс командной строки:
+
+ <widget id="com.example.hello" version="0.0.1">
+ <name>HelloWorld</name>
+ <description>
+ A sample Apache Cordova application that responds to the deviceready event.
+ </description>
+ <author email="dev@callback.apache.org" href="http://cordova.io">
+ Apache Cordova Team
+ </author>
+ <content src="index.html" />
+ <access origin="*" />
+ </widget>
+
+
+Следующие элементы конфигурации появляются в файле верхнего уровня `config.xml` и поддерживаются на всех существующих платформах Cordova:
+
+* Атрибут `id` элемента `<widget>` указывает идентификатор приложения в обратном формате доменных имен и атрибут `version` его полный номер версии в нотации майор/минор/патч.
+
+ Тег виджета могут также иметь атрибуты, которые определяют альтернативные версии, а именно versionCode для Android и CFBundleVersion для iOS. В разделе дополнительных версий ниже для деталей.
+
+* Элемент `<name>` определяет официальное имя приложения, как он отображается на главном экране устройства и в интерфейсе магазина приложений.
+
+* Элементы `<description>` и `<author>` определяют метаданные и контактную информацию, которые могут отображаться в каталоге магазина приложений.
+
+* Необязательный элемент `<content>` определяет стартовую страницу приложения в каталоге верхнего уровня веб ресурсов. Значением по умолчанию является `index.html` , которая обычно находится в каталоге верхнего уровня `www` проекта.
+
+* Элементы `<access>` определяют набор внешних доменов, с которым приложение имеет право взаимодействовать. Значение по умолчанию, показанное выше позволяет осуществлять доступ к любому серверу. Смотрите раздел Руководство по разрешению доступа к доменам для подробностей.
+
+* Элемент `<preference>` задает различные параметры как пару атрибутов `name`/`value`. Имя каждого параметра, указанного в атрибуте `name` указывается без учета регистра. Многие параметры являются уникальными для конкретных платформ, как это указано в начале этой страницы. В следующих разделах подробно описаны настройки, которые применяются к более чем одной платформе.
+
+### Дополнительное управление версиями
+
+Так, Android и iOS поддерживает вторую строку версии (или номер) помимо видимой в app магазины, [versionCode][2] для Android и [CFBundleVersion][3] для iOS. Ниже приведен пример, который явно задает versionCode и CFBundleVersion
+
+ [2]: http://developer.android.com/tools/publishing/versioning.html
+ [3]: http://stackoverflow.com/questions/4933093/cfbundleversion-in-the-info-plist-upload-error
+
+ <widget id="io.cordova.hellocordova"
+ version="0.0.1"
+ android-versionCode="7"
+ ios-CFBundleVersion="3.3.3">
+
+
+Если альтернативная версия не указана, будет использоваться следующие значения по умолчанию:
+
+ // assuming version = MAJOR.MINOR.PATCH-whatever
+ versionCode = PATCH + MINOR * 100 + MAJOR * 10000
+ CFBundleVersion = "MAJOR.MINOR.PATCH"
+
+
+## Глобальные настройки
+
+Следующие глобальные настройки применяются для всех платформ:
+
+* `Fullscreen` позволяет скрыть строку состояния в верхней части экрана. Значение по умолчанию — `false` . Пример:
+
+ <preference name="Fullscreen" value="true" />
+
+
+## Много-платформенный настройки
+
+Следующие параметры применяются для более чем одной платформы, но не ко всем из них:
+
+* `DisallowOverscroll` (логическое значение, по умолчанию `false` ): Установите в `true` если вы не хотите чтобы интерфейс отображал каких-либо обратной связи, когда пользователи прокручивают за начало или конец содержимого.
+
+ <preference name="DisallowOverscroll" value="true"/>
+
+
+ Применяется к Android и iOS. На iOS, совершение перелистывание за границу контента (overscroll) плавно возвращает положение контента назад в исходное положение. На Android это действие производит более тонкий светящийся эффект вдоль верхнего или нижнего края контента.
+
+* `BackgroundColor`: Задайте цвет фона приложения. Поддерживает шестнадцатеричное значение размером 4 байта, где первый байт представляющий альфа-канал и стандартные значения RGB для следующих трех байтов. В этом примере указывается голубой цвет:
+
+ <preference name="BackgroundColor" value="0xff0000ff"/>
+
+
+ Применяется к Android и BlackBerry. Переопределяет CSS, который доступен для *всех* платформ, например:`body{background-color:blue}`.
+
+* `HideKeyboardFormAccessoryBar`(логическое значение, по умолчанию `false` ): Установите в `true` чтобы скрыть дополнительную панель инструментов, которая появляется над клавиатурой, помогая пользователям перемещаться из одной формы ввода на другой.
+
+ <preference name="HideKeyboardFormAccessoryBar" value="true"/>
+
+
+ Применяется к iOS и BlackBerry.
+
+* `Orientation` (строка, по умолчанию `default`): позволяет вам заблокировать ориентацию и предотвратить интерфейс от вращения в ответ на изменения в ориентации. Возможные значения `default`, `landscape`, или `portrait`. Пример:
+
+ <preference name="Orientation" value="landscape" />
+
+
+ Кроме того можно указать любое значение платформо-зависимое значение для ориентации, если вы разместите элемент `<preference>` внутри элемента `<platform>`:
+
+ <platform name="android">
+ <preference name="Orientation" value="sensorLandscape" />
+ </platform>
+
+
+ Применяется к Android, iOS, WP8, Amazon Fire OS и Firefox OS.
+
+ **Примечание**: Значение `default` означает что Cordova удалит предпочитаемое значение orientation из файла конфигурации/манифеста платформы позволяя платформе использовать свое поведение по умолчанию.
+
+Значение «default» позволяет портретный и альбомный режимы - только после реализации функции обратного вызова. Я мог бы возможно повторно перефразировать это следующим образом:
+
+Для iOS ориентация может программно контролироваться путем определения Javascript функции обратного вызова для window:
+
+ /**
+ * @param {Number} degree - UIInterfaceOrientationPortrait: 0, UIInterfaceOrientationLandscapeRight: 90, UIInterfaceOrientationLandscapeLeft: -90, UIInterfaceOrientationPortraitUpsideDown: 180
+ * @returns {Boolean} Indicating if rotation should be allowed.
+ */
+ function shouldRotateToOrientation(degrees) {
+ return true;
+ }
+
+
+## Элемент *feature*
+
+При использовании командной строки для построения приложений, использовать команду `plugin`, чтобы включить API устройства. Это не изменяет файл `config.xml` верхнего уровня, так что элемент `<feature>` не применяется к вашему рабочему процессу. Если вы работаете непосредственно в SDK и с помощью платформа специфического `config.xml` файл в качестве источника, используется `<feature>` тег, чтобы включить API функции устройства и внешних плагинов. Эти элементы обычно присутствуют с разными значениями в платформо-зависимых файлах `config.xml`. К примеру, таким образом можно указать Device API для проектов Android:
+
+ <feature name="Device">
+ <param name="android-package" value="org.apache.cordova.device.Device" />
+ </feature>
+
+
+Вот как появляется элемент в проектах iOS:
+
+ <feature name="Device">
+ <param name="ios-package" value="CDVDevice" />
+ </feature>
+
+
+Смотрите подробную информацию о том, как определить каждую функции в разделе Справочник API. Также смотрите Руководство по разработке плагинов для получения дополнительной информации по плагинам.
+
+## Элемент *platform*
+
+При использовании командной строки для построения приложений, иногда бывает необходимо указать параметры или другие элементы, специфичные для конкретной платформы. Используйте элемент `<platform>` для указания конфигурации которая должна применяться только в файле `config.xml` определенной платформы. Например, вот как можно указать, что только на платформе Android следует использовать параметр Fullscreen:
+
+ <platform name="android">
+ <preference name="Fullscreen" value="true" />
+ </platform>
\ No newline at end of file
diff --git a/docs/ru/5.0.0/cordova/events/events.backbutton.md b/docs/ru/5.0.0/cordova/events/events.backbutton.md
new file mode 100644
index 0000000..fed1908
--- /dev/null
+++ b/docs/ru/5.0.0/cordova/events/events.backbutton.md
@@ -0,0 +1,79 @@
+---
+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.
+---
+
+# backbutton
+
+Событие возникает, когда пользователь нажимает кнопку "назад".
+
+ document.addEventListener("backbutton", yourCallbackFunction, false);
+
+
+## Подробности
+
+Чтобы переопределить поведение по умолчанию кнопки back, зарегистрируйте обработчик события `backbutton`, обычно путем вызова `document.addEventListener`, после того как вы произойдет событий `deviceready`. Более не требуется вызывать никакой другой метод для переопределения поведения кнопки back.
+
+## Поддерживаемые платформы
+
+* Amazon Fire OS
+* Android
+* BlackBerry 10
+* Windows Phone 8
+
+## Краткий пример
+
+ document.addEventListener("backbutton", onBackKeyDown, false);
+
+ function onBackKeyDown() {
+ // Handle the back button
+ }
+
+
+## Развернутый пример
+
+ <!DOCTYPE html>
+ <html>
+ <head>
+ <title>Back Button Example</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Wait for device API libraries to load
+ //
+ function onLoad() {
+ document.addEventListener("deviceready", onDeviceReady, false);
+ }
+
+ // device APIs are available
+ //
+ function onDeviceReady() {
+ // Register the event listener
+ document.addEventListener("backbutton", onBackKeyDown, false);
+ }
+
+ // Handle the back button
+ //
+ function onBackKeyDown() {
+ }
+
+ </script>
+ </head>
+ <body onload="onLoad()">
+ </body>
+ </html>
\ No newline at end of file
diff --git a/docs/ru/5.0.0/cordova/events/events.deviceready.md b/docs/ru/5.0.0/cordova/events/events.deviceready.md
new file mode 100644
index 0000000..9c402f2
--- /dev/null
+++ b/docs/ru/5.0.0/cordova/events/events.deviceready.md
@@ -0,0 +1,82 @@
+---
+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.
+---
+
+# deviceready
+
+Событие возникает, когда Cordova загружена полностью.
+
+ document.addEventListener("deviceready", yourCallbackFunction, false);
+
+
+## Подробности
+
+Это событие имеет важное значение для любого приложения. Оно сигнализирует, что Cordova API для устройств загружены и готовы для работы.
+
+Кордова состоит из двух наборов исходных кодов: родной язык платформы и JavaScript. В то время как основной код загружается, отображается экран загрузки. Однако JavaScript загружает только после того, как загружен DOM. Это означает, что веб-приложение потенциально может вызвать JavaScript функцию Cordova, прежде тем как соответствующий машинный код будет доступен.
+
+Событие `deviceready` возникает после полной загрузки Cordova. Когда событие происходит, вы можете безопасно вызывать API Cordova. Приложения обычно устанавливают обработчик события с помощью `document.addEventListener` после загрузки DOM HTML-документа.
+
+Поведение события `deviceready` несколько отличается от других событий. Любой обработчик событий, зарегистрированных после того событие `deviceready` произошло, вызывается немедленно.
+
+## Поддерживаемые платформы
+
+* Amazon Fire OS
+* Android
+* BlackBerry 10
+* iOS
+* Tizen
+* Windows Phone 8
+* Windows 8
+
+## Краткий пример
+
+ document.addEventListener("deviceready", onDeviceReady, false);
+
+ function onDeviceReady() {
+ // Now safe to use device APIs
+ }
+
+
+## Развернутый пример
+
+ <!DOCTYPE html>
+ <html>
+ <head>
+ <title>Device Ready Example</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Wait for device API libraries to load
+ //
+ function onLoad() {
+ document.addEventListener("deviceready", onDeviceReady, false);
+ }
+
+ // device APIs are available
+ //
+ function onDeviceReady() {
+ // Now safe to use device APIs
+ }
+
+ </script>
+ </head>
+ <body onload="onLoad()">
+ </body>
+ </html>
\ No newline at end of file
diff --git a/docs/ru/5.0.0/cordova/events/events.endcallbutton.md b/docs/ru/5.0.0/cordova/events/events.endcallbutton.md
new file mode 100644
index 0000000..a93688d
--- /dev/null
+++ b/docs/ru/5.0.0/cordova/events/events.endcallbutton.md
@@ -0,0 +1,79 @@
+---
+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.
+---
+
+# endcallbutton
+
+Это событие вызывается, когда пользователь нажимает кнопку окончания звонка.
+
+ document.addEventListener("endcallbutton", yourCallbackFunction, false);
+
+
+## Подробности
+
+Событие переопределяет поведение по умолчанию при окончании звонка.
+
+Приложения обычно должны использовать `window.addEventListener` чтобы добавить обработчик события после того как произойдет событие `deviceready`.
+
+## Поддерживаемые платформы
+
+* BlackBerry 10
+
+## Краткий пример
+
+ document.addEventListener("endcallbutton", onEndCallKeyDown, false);
+
+ function onEndCallKeyDown() {
+ // Handle the end call button
+ }
+
+
+## Развернутый пример
+
+ <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
+ "http://www.w3.org/TR/html4/strict.dtd">
+ <html>
+ <head>
+ <title>End Call Button Example</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Wait for device API libraries to load
+ //
+ function onLoad() {
+ document.addEventListener("deviceready", onDeviceReady, false);
+ }
+
+ // device APIs are available
+ //
+ function onDeviceReady() {
+ // Register the event listener
+ document.addEventListener("endcallbutton", onEndCallKeyDown, false);
+ }
+
+ // Handle the end call button
+ //
+ function onEndCallKeyDown() {
+ }
+
+ </script>
+ </head>
+ <body onload="onLoad()">
+ </body>
+ </html>
\ No newline at end of file
diff --git a/docs/ru/5.0.0/cordova/events/events.md b/docs/ru/5.0.0/cordova/events/events.md
new file mode 100644
index 0000000..88d5b09
--- /dev/null
+++ b/docs/ru/5.0.0/cordova/events/events.md
@@ -0,0 +1,50 @@
+---
+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.
+---
+
+# События
+
+> События жизненного цикла Cordova.
+
+## Типы событий
+
+* deviceready
+* pause
+* resume
+* backbutton
+* menubutton
+* searchbutton
+* startcallbutton
+* endcallbutton
+* volumedownbutton
+* volumeupbutton
+
+## События добавленные [cordova-plugin-battery-status][1]
+
+ [1]: https://github.com/apache/cordova-plugin-battery-status/blob/master/README.md
+
+* batterycritical
+* batterylow
+* batterystatus
+
+## События добавленные [cordova-plugin-network-information][2]
+
+ [2]: https://github.com/apache/cordova-plugin-network-information/blob/master/README.md
+
+* online
+* offline
\ No newline at end of file
diff --git a/docs/ru/5.0.0/cordova/events/events.menubutton.md b/docs/ru/5.0.0/cordova/events/events.menubutton.md
new file mode 100644
index 0000000..e223a6f
--- /dev/null
+++ b/docs/ru/5.0.0/cordova/events/events.menubutton.md
@@ -0,0 +1,81 @@
+---
+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.
+---
+
+# menubutton
+
+Событие возникает, когда пользователь нажимает кнопку меню.
+
+ document.addEventListener("menubutton", yourCallbackFunction, false);
+
+
+## Подробности
+
+Применение обработчика события переопределяет поведение кнопки меню по умолчанию.
+
+Приложения обычно должны использовать `window.addEventListener` чтобы добавить обработчик события после того как произойдет событие `deviceready`.
+
+## Поддерживаемые платформы
+
+* Amazon Fire OS
+* Android
+* BlackBerry 10
+
+## Краткий пример
+
+ document.addEventListener("menubutton", onMenuKeyDown, false);
+
+ function onMenuKeyDown() {
+ // Handle the back button
+ }
+
+
+## Развернутый пример
+
+ <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
+ "http://www.w3.org/TR/html4/strict.dtd">
+ <html>
+ <head>
+ <title>Menu Button Example</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Wait for device API libraries to load
+ //
+ function onLoad() {
+ document.addEventListener("deviceready", onDeviceReady, false);
+ }
+
+ // device APIs are available
+ //
+ function onDeviceReady() {
+ // Register the event listener
+ document.addEventListener("menubutton", onMenuKeyDown, false);
+ }
+
+ // Handle the menu button
+ //
+ function onMenuKeyDown() {
+ }
+
+ </script>
+ </head>
+ <body onload="onLoad()">
+ </body>
+ </html>
\ No newline at end of file
diff --git a/docs/ru/5.0.0/cordova/events/events.pause.md b/docs/ru/5.0.0/cordova/events/events.pause.md
new file mode 100644
index 0000000..f512b48
--- /dev/null
+++ b/docs/ru/5.0.0/cordova/events/events.pause.md
@@ -0,0 +1,91 @@
+---
+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.
+---
+
+# pause
+
+Событие возникает, когда приложение переводят в фоновом режиме.
+
+ document.addEventListener("pause", yourCallbackFunction, false);
+
+
+## Подробности
+
+Событие `pause` возникает, когда платформа переводит приложения в фоновом режиме, как правило, когда пользователь переключается на другое приложение.
+
+Приложения обычно должны использовать `window.addEventListener` чтобы добавить обработчик события после того как произойдет событие `deviceready`.
+
+## Поддерживаемые платформы
+
+* Amazon Fire OS
+* Android
+* BlackBerry 10
+* iOS
+* Windows Phone 8
+* Windows 8
+
+## Краткий пример
+
+ document.addEventListener("pause", onPause, false);
+
+ function onPause() {
+ // Handle the pause event
+ }
+
+
+## Развернутый пример
+
+ <!DOCTYPE html>
+ <html>
+ <head>
+ <title>Pause Example</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Wait for device API libraries to load
+ //
+ function onLoad() {
+ document.addEventListener("deviceready", onDeviceReady, false);
+ }
+
+ // device APIs are available
+ //
+ function onDeviceReady() {
+ document.addEventListener("pause", onPause, false);
+ }
+
+ // Handle the pause event
+ //
+ function onPause() {
+ }
+
+ </script>
+ </head>
+ <body onload="onLoad()">
+ </body>
+ </html>
+
+
+## Особенности iOS
+
+В обработчик события `pause`, все вызовы API Cordova или плагинов, которые идут через Objective-C не работают, а также любых интерактивных вызовов, например оповещения или вызовы `console.log()` . Они обрабатываются только когда приложение возобновляет работу, на следующий цикл выполнения.
+
+Специфичное для iOS событие `resign` доступно как альтернатива `pause` и определяет, когда пользователи включили кнопку **замка** чтобы заблокировать устройство с приложением работающим на переднем плане. Если приложение (и устройство) поддерживает многозадачность, это событие находится в паре с последующим событием `pause`, но только при работе в iOS 5. По сути всех заблокированных приложений в iOS 5, которые поддерживают многозадачность переводятся в фоновый режим. Чтобы приложение работало когда устройство заблокировано под iOS 5, необходимо отключить многозадачность приложения, установив [UIApplicationExitsOnSuspend][1] в значение `YES` . Чтобы выполняться когда устройство заблокировано на iOS 4, этот параметр не имеет значения.
+
+ [1]: http://developer.apple.com/library/ios/#documentation/general/Reference/InfoPlistKeyReference/Articles/iPhoneOSKeys.html
\ No newline at end of file
diff --git a/docs/ru/5.0.0/cordova/events/events.resume.md b/docs/ru/5.0.0/cordova/events/events.resume.md
new file mode 100644
index 0000000..80366b9
--- /dev/null
+++ b/docs/ru/5.0.0/cordova/events/events.resume.md
@@ -0,0 +1,105 @@
+---
+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.
+---
+
+# resume
+
+Событие возникает, когда приложение восстанавливается из фонового режима.
+
+ document.addEventListener("resume", yourCallbackFunction, false);
+
+
+## Подробности
+
+Событие `resume` возникает, когда платформа переводит приложения из фонового режима.
+
+Приложения обычно должны использовать `window.addEventListener` чтобы добавить обработчик события после того как произойдет событие `deviceready`.
+
+## Поддерживаемые платформы
+
+* Amazon Fire OS
+* Android
+* BlackBerry 10
+* iOS
+* Windows Phone 8
+* Windows 8
+
+## Краткий пример
+
+ document.addEventListener("resume", onResume, false);
+
+ function onResume() {
+ // Handle the resume event
+ }
+
+
+## Развернутый пример
+
+ <!DOCTYPE html>
+ <html>
+ <head>
+ <title>Resume Example</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Wait for device API libraries to load
+ //
+ function onLoad() {
+ document.addEventListener("deviceready", onDeviceReady, false);
+ }
+
+ // device APIs are available
+ //
+ function onDeviceReady() {
+ document.addEventListener("resume", onResume, false);
+ }
+
+ // Handle the resume event
+ //
+ function onResume() {
+ }
+
+ </script>
+ </head>
+ <body onload="onLoad()">
+ </body>
+ </html>
+
+
+## Особенности iOS
+
+Любых интерактивных функций, вызываемых из обработкика события `pause` выполнять позже, когда приложение возобновляет свою работу, как сигнализируется событием `resume`. К этому относятся оповещения, вызовы `console.log()` и все вызовы из плагинов или Cordova API, которые идут через Objective-C.
+
+* Событие **active**
+
+ Специфичные для iOS `active` событие доступно как альтернатива `resume` и определяет, когда пользователям отключить кнопку **замка** , чтобы разблокировать устройство с приложением работающим на переднем плане. Если для приложения (и устройства) включена поддержка многозадачности, это находится в паре с последующим событием `resume`, но только под iOS 5. По сути всех заблокированных приложений в iOS 5, которые поддерживают многозадачность переводятся в фоновый режим. Чтобы приложение работало когда устройство заблокировано под iOS 5, необходимо отключить многозадачность приложения, установив [UIApplicationExitsOnSuspend][1] в значение `YES`. Чтобы выполняться когда устройство заблокировано на iOS 4, этот параметр не имеет значения.
+
+* Событие **resume**
+
+ При вызове из обработчика событий `resume`, интерактивных функций, таких как `alert()`, эти функции должны быть обернуты в `setTimeout()` вызов с таймаутом нулю, или же в приложение зависает. Например:
+
+ document.addEventListener("resume", onResume, false);
+ function onResume() {
+ setTimeout(function() {
+ // TODO: do your thing!
+ }, 0);
+ }
+
+
+ [1]: http://developer.apple.com/library/ios/#documentation/general/Reference/InfoPlistKeyReference/Articles/iPhoneOSKeys.html
\ No newline at end of file
diff --git a/docs/ru/5.0.0/cordova/events/events.searchbutton.md b/docs/ru/5.0.0/cordova/events/events.searchbutton.md
new file mode 100644
index 0000000..9651908
--- /dev/null
+++ b/docs/ru/5.0.0/cordova/events/events.searchbutton.md
@@ -0,0 +1,79 @@
+---
+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.
+---
+
+# searchbutton
+
+Событие возникает, когда пользователь нажимает кнопку Поиск на Android.
+
+ document.addEventListener("searchbutton", yourCallbackFunction, false);
+
+
+## Подробности
+
+Если необходимо переопределить поведение по умолчанию кнопки поиск на Android вы можете зарегистрировать обработчик события для события «searchbutton».
+
+Приложения обычно должны использовать `window.addEventListener` чтобы добавить обработчик события после того как произойдет событие `deviceready`.
+
+## Поддерживаемые платформы
+
+* Android
+
+## Краткий пример
+
+ document.addEventListener("searchbutton", onSearchKeyDown, false);
+
+ function onSearchKeyDown() {
+ // Handle the search button
+ }
+
+
+## Развернутый пример
+
+ <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
+ "http://www.w3.org/TR/html4/strict.dtd">
+ <html>
+ <head>
+ <title>Search Button Example</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Wait for device API libraries to load
+ //
+ function onLoad() {
+ document.addEventListener("deviceready", onDeviceReady, false);
+ }
+
+ // device APIs are available
+ //
+ function onDeviceReady() {
+ // Register the event listener
+ document.addEventListener("searchbutton", onSearchKeyDown, false);
+ }
+
+ // Handle the search button
+ //
+ function onSearchKeyDown() {
+ }
+
+ </script>
+ </head>
+ <body onload="onLoad()">
+ </body>
+ </html>
\ No newline at end of file
diff --git a/docs/ru/5.0.0/cordova/events/events.startcallbutton.md b/docs/ru/5.0.0/cordova/events/events.startcallbutton.md
new file mode 100644
index 0000000..7c5c8a2
--- /dev/null
+++ b/docs/ru/5.0.0/cordova/events/events.startcallbutton.md
@@ -0,0 +1,79 @@
+---
+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.
+---
+
+# startcallbutton
+
+Событие возникает, когда пользователь нажимает кнопку начала звонка.
+
+ document.addEventListener("startcallbutton", yourCallbackFunction, false);
+
+
+## Подробности
+
+Если необходимо переопределить поведение по умолчанию начала вызова вы можете зарегистрировать обработчик для события `startcallbutton`.
+
+Приложения обычно должны использовать `window.addEventListener` чтобы добавить обработчик события после того как произойдет событие `deviceready`.
+
+## Поддерживаемые платформы
+
+* BlackBerry 10
+
+## Краткий пример
+
+ document.addEventListener("startcallbutton", onStartCallKeyDown, false);
+
+ function onStartCallKeyDown() {
+ // Handle the start call button
+ }
+
+
+## Развернутый пример
+
+ <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
+ "http://www.w3.org/TR/html4/strict.dtd">
+ <html>
+ <head>
+ <title>Start Call Button Example</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Wait for device API libraries to load
+ //
+ function onLoad() {
+ document.addEventListener("deviceready", onDeviceReady, false);
+ }
+
+ // device APIs are available
+ //
+ function onDeviceReady() {
+ // Register the event listener
+ document.addEventListener("startcallbutton", onStartCallKeyDown, false);
+ }
+
+ // Handle the start call button
+ //
+ function onStartCallKeyDown() {
+ }
+
+ </script>
+ </head>
+ <body onload="onLoad()">
+ </body>
+ </html>
\ No newline at end of file
diff --git a/docs/ru/5.0.0/cordova/events/events.volumedownbutton.md b/docs/ru/5.0.0/cordova/events/events.volumedownbutton.md
new file mode 100644
index 0000000..b2204fa
--- /dev/null
+++ b/docs/ru/5.0.0/cordova/events/events.volumedownbutton.md
@@ -0,0 +1,80 @@
+---
+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.
+---
+
+# volumedownbutton
+
+Событие возникает, когда пользователь нажимает кнопку уменьшения громкости.
+
+ document.addEventListener("volumedownbutton", yourCallbackFunction, false);
+
+
+## Подробности
+
+Если необходимо переопределить поведение по умолчанию кнопки уменьшения громкости вы можете зарегистрировать обработчик для события `volumedownbutton`.
+
+Приложения обычно должны использовать `window.addEventListener` чтобы добавить обработчик события после того как произойдет событие `deviceready`.
+
+## Поддерживаемые платформы
+
+* BlackBerry 10
+* Android
+
+## Краткий пример
+
+ document.addEventListener("volumedownbutton", onVolumeDownKeyDown, false);
+
+ function onVolumeDownKeyDown() {
+ // Handle the volume down button
+ }
+
+
+## Развернутый пример
+
+ <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
+ "http://www.w3.org/TR/html4/strict.dtd">
+ <html>
+ <head>
+ <title>Volume Down Button Example</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Wait for device API libraries to load
+ //
+ function onLoad() {
+ document.addEventListener("deviceready", onDeviceReady, false);
+ }
+
+ // device APIs are available
+ //
+ function onDeviceReady() {
+ // Register the event listener
+ document.addEventListener("volumedownbutton", onVolumeDownKeyDown, false);
+ }
+
+ // Handle the volume down button
+ //
+ function onVolumeDownKeyDown() {
+ }
+
+ </script>
+ </head>
+ <body onload="onLoad()">
+ </body>
+ </html>
\ No newline at end of file
diff --git a/docs/ru/5.0.0/cordova/events/events.volumeupbutton.md b/docs/ru/5.0.0/cordova/events/events.volumeupbutton.md
new file mode 100644
index 0000000..d6b61bf
--- /dev/null
+++ b/docs/ru/5.0.0/cordova/events/events.volumeupbutton.md
@@ -0,0 +1,80 @@
+---
+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.
+---
+
+# volumeupbutton
+
+Событие возникает, когда пользователь нажимает кнопку повышения громкости.
+
+ document.addEventListener("volumeupbutton", yourCallbackFunction, false);
+
+
+## Подробности
+
+Если необходимо переопределить поведение по умолчанию кнопки увличения громкости вы можете зарегистрировать обработчик для события `volumeupbutton`.
+
+Приложения обычно должны использовать `window.addEventListener` чтобы добавить обработчик события после того как произойдет событие `deviceready`.
+
+## Поддерживаемые платформы
+
+* BlackBerry 10
+* Android
+
+## Краткий пример
+
+ document.addEventListener("volumeupbutton", onVolumeUpKeyDown, false);
+
+ function onVolumeUpKeyDown() {
+ // Handle the volume up button
+ }
+
+
+## Развернутый пример
+
+ <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
+ "http://www.w3.org/TR/html4/strict.dtd">
+ <html>
+ <head>
+ <title>Volume Up Button Example</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Wait for device API libraries to load
+ //
+ function onLoad() {
+ document.addEventListener("deviceready", onDeviceReady, false);
+ }
+
+ // device APIs are available
+ //
+ function onDeviceReady() {
+ // Register the event listener
+ document.addEventListener("volumeupbutton", onVolumeUpKeyDown, false);
+ }
+
+ // Handle the volume up button
+ //
+ function onVolumeUpKeyDown() {
+ }
+
+ </script>
+ </head>
+ <body onload="onLoad()">
+ </body>
+ </html>
\ No newline at end of file
diff --git a/docs/ru/5.0.0/cordova/plugins/pluginapis.md b/docs/ru/5.0.0/cordova/plugins/pluginapis.md
new file mode 100644
index 0000000..23bffc7
--- /dev/null
+++ b/docs/ru/5.0.0/cordova/plugins/pluginapis.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.
+---
+
+# API плагинов
+
+Cordova поставляется с минимальным набором APIs, и проекты которым необходимы дополнительные API, добавляют их через плагины.
+
+Вы можете искать по все существующим плагинам (в том числе сторонние плагины) на [npm][1].
+
+ [1]: https://www.npmjs.com/search?q=ecosystem%3Acordova
+
+Традиционный набор плагинов Cordova следующий:
+
+* [Состояние батареи][2]
+
+ > Отслеживает статус батареи устройства.
+
+* [Камера][3]
+
+ > Получает фото используя камеру устройства.
+
+* [Консоль][4]
+
+ > Добавление дополнительных возможностей к console.log().
+
+* [Контакты][5]
+
+ > Взаимодействует с книгой контактов на устройстве.
+
+* [Устройство][6]
+
+ > Получает информацию об устройстве.
+
+* [Движение устройства (Акселерометр)][7]
+
+ > Используйте датчик движения устройства.
+
+* [Ориентация устройства (Компас)][8]
+
+ > Получите направление в котором указывает устройство.
+
+* [Диалоги][9]
+
+ > Визуальные уведомления на устройстве.
+
+* [Файловая система][10]
+
+ > Подключитесь к файловой системе устройства с помощью JavaScript.
+
+* [Передача файлов][11]
+
+ > Подключитесь к файловой системе устройства с помощью JavaScript.
+
+* [Географическое положение][12]
+
+ > Пусть ваше приложение знает свое местоположение.
+
+* [Глобализация][13]
+
+ > Добавляет представление объектов в виде принятом для выбранной локали.
+
+* [Внутренний браузер][14]
+
+ > Открывает URL-адреса в другом окне браузера внутри приложения.
+
+* [Аудио и видео][15]
+
+ > Записывайте и проигрывайте аудиофайлы.
+
+* [Захват аудио и видео][16]
+
+ > Создавайте медиа-файлы используя приложения по захвату медиа, на устройстве.
+
+* [Информацию о сети (подключение)][17]
+
+ > Быстро проверьте состояние сети интернет, и информацию о сети сотовой связи.
+
+* [Заставка][18]
+
+ > Показывайте и прячьте экран заставки приложения.
+
+* [Вибрация][19]
+
+ > API для вибрации устройства.
+
+* [Строка состояния][20]
+
+ > API-интерфейс для отображения, скрытия и настройке фона строки состояния.
+
+* [Список разрешенных ресурсов][21]
+
+ > Плагин для разрешение сетевых запросов. Должен быть установлен если вы хотите иметь возможность делать любые сетевые запросы в вашем приложении.
+
+* [Устаревший список разрешенных ресурсов][22]
+
+ > Плагин для использования старого стиля списка разрешенных ресурсов, прежде чем он был удален из платфор и изменил в виде текущего плагина списка разрешеных ресурсов.
+
+ [2]: https://www.npmjs.com/package/cordova-plugin-battery-status
+ [3]: https://www.npmjs.com/package/cordova-plugin-camera
+ [4]: https://www.npmjs.com/package/cordova-plugin-console
+ [5]: https://www.npmjs.com/package/cordova-plugin-contacts
+ [6]: https://www.npmjs.com/package/cordova-plugin-device
+ [7]: https://www.npmjs.com/package/cordova-plugin-device-motion
+ [8]: https://www.npmjs.com/package/cordova-plugin-device-orientation
+ [9]: https://www.npmjs.com/package/cordova-plugin-dialogs
+ [10]: https://www.npmjs.com/package/cordova-plugin-file
+ [11]: https://www.npmjs.com/package/cordova-plugin-file-transfer
+ [12]: https://www.npmjs.com/package/cordova-plugin-geolocation
+ [13]: https://www.npmjs.com/package/cordova-plugin-globalization
+ [14]: https://www.npmjs.com/package/cordova-plugin-inappbrowser
+ [15]: https://www.npmjs.com/package/cordova-plugin-media
+ [16]: https://www.npmjs.com/package/cordova-plugin-media-capture
+ [17]: https://www.npmjs.com/package/cordova-plugin-network-information
+ [18]: https://www.npmjs.com/package/cordova-plugin-splashscreen
+ [19]: https://www.npmjs.com/package/cordova-plugin-vibration
+ [20]: https://www.npmjs.com/package/cordova-plugin-statusbar
+ [21]: https://www.npmjs.com/package/cordova-plugin-whitelist
+ [22]: https://www.npmjs.com/package/cordova-plugin-legacy-whitelist
+
+Non-английский переводы документов этих плагинов можно найти, перейдя в репозитории github плагина и посмотрев в папке docs
\ No newline at end of file
diff --git a/docs/ru/5.0.0/cordova/storage/storage.md b/docs/ru/5.0.0/cordova/storage/storage.md
new file mode 100644
index 0000000..bd8cb66
--- /dev/null
+++ b/docs/ru/5.0.0/cordova/storage/storage.md
@@ -0,0 +1,65 @@
+---
+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.
+---
+
+# Хранилище
+
+> Обзор вариантов хранения данных для Cordova.
+
+Несколько API интерфейсов хранения данных доступны для приложений Cordova. Смотрите [html5rocks][1]. для более полного обзора и примеров.
+
+ [1]: http://www.html5rocks.com/en/features/storage
+
+## LocalStorage
+
+Также известен как *веб-хранилище*, *простое хранилище*, или его альтернативный интерфейс *хранилище сессии*, этот интерфейс API обеспечивает хранение пары ключ/значение и доступны в нижеуказанных реализациях WebView. Обратитесь к [спецификации W3C][2] для детальной информации.
+
+ [2]: http://www.w3.org/TR/webstorage/
+
+## WebSQL
+
+Этот API-интерфейс доступен в нижеуказанных реализациях WebView. [Спецификация базы данных Web SQL][3] предлагает более полнофункциональные таблицы базы данных с доступом к ним через SQL-запросы.
+
+ [3]: http://dev.w3.org/html5/webdatabase/
+
+Следующие платформы поддерживают WebSQL:
+
+* Android
+* BlackBerry 10
+* iOS
+* Tizen
+
+## IndexedDB
+
+Этот API-интерфейс доступен в нижеуказанных WebView. [Indexed DB][4] предоставляет больше возможностей, чем LocalStorage, но меньше, чем WebSQL.
+
+ [4]: http://www.w3.org/TR/IndexedDB/
+
+Следующие платформы поддерживают IndexedDB:
+
+* BlackBerry 10
+* Firefox OS
+* Windows Phone 8
+* Windows 8
+
+## Варианты на основе плагинов
+
+В дополнение к API хранилищ перечисленных выше, [File API][5] позволяет вам кешировать данные в локальной файловой системе. Другие [плагины Cordova][6] предоставляют схожие варианты хранения данных.
+
+ [5]: https://github.com/apache/cordova-plugin-file/blob/master/doc/index.md
+ [6]: http://plugins.cordova.io/
\ No newline at end of file
diff --git a/docs/ru/5.0.0/guide/appdev/privacy/index.md b/docs/ru/5.0.0/guide/appdev/privacy/index.md
new file mode 100644
index 0000000..d53a58b
--- /dev/null
+++ b/docs/ru/5.0.0/guide/appdev/privacy/index.md
@@ -0,0 +1,57 @@
+---
+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.
+---
+
+# Руководство по конфиденциальности
+
+Мобильная конфиденциальность является важным вопросом, который каждый разработчик приложения должен учитывать. Ваши пользователи ожидают, что их частная информация, будут собираться и обрабатываться вашим приложением надлежащим образом. Кроме того есть все большее число юрисдикций, которые сейчас имеют юридические требования в отношении конфиденциальности в отношении мобильных устройств.
+
+Это руководство о конфиденциальности мобильных приложений следует рассматривать *заготовку* решающую некоторые наиболее значительные проблемы. Оно излагает некоторые общепринятые практики и предоставляет ссылки на другие более подробные руководства и материалы.
+
+* **Политика конфиденциальности**: Ваше приложение должно включать политику конфиденциальности которая описывает области, такие как, что за информацию приложение собирает от своих пользователей и о них, как эта информация используется, с кому она может быть передана, и как пользователели могут совершить выбор относительно своей конфиденциальности в рамках приложения. Чтобы помочь пониманию, вы должны использовать обычный язык и избегать использование технического жаргона. Вы должны сделать вашу политику конфиденциальности доступной пользователям для рассмотрения до загрузки, например в описании приложения в магазине приложений. Кроме того вы должны сделать вашу политику конфиденциальности доступной в рамках самого приложения. Ограниченный размер дисплеев мобильных устройств создает проблемы для отображения политик конфиденциальности для пользователей. Рассмотреть вопрос о разработке *краткой формы* политики, которая включает в себя наиболее важную информацию, а затем предоставить ссылку на «полную форму» политики для тех, кто заинтересован в более подробной информации. Некоторые группы пытаются разработать стандарты на основе значков для сообщения о применяемых практиках конфиденциальности, которые вы можете хотеть рассматривать после того, как эти стандарты будут достаточно зрелыми.
+
+* **Сбор конфиденциальной информации**: сбор конфиденциальной личной информации приложением поднимает важные конфиденциальности. Примеры конфиденциальной личной информации включая финансовую информацию, информацию о здоровье и информацию от ваших детей или о ваших детях. Это также включает информацию, полученную от некоторых датчиков и баз данных, как правило, находящихся на мобильных устройствах и таблетках, таких как информация о географическом положении, контакты/телефонной книги, микрофон/камера и сохраненных снимках/видео. Смотрите на следующих страницах документации для получения дополнительной информации: [Камера][1], [Захват аудио и видео][2], [Контакты][3]и [Геолокация][4]. Как правило следует получить разрешения пользователя прежде чем собирать конфиденциальную информацию и, если это возможно, предоставляет механизм управления, который позволяет пользователю легко изменить разрешения. Операционные системы где работают приложения могут в этом помогать в некоторых случаях, представляя диалоговые окна запрашивающие разрешение пользователя, непосредственно перед сбором информации. В этих случаях не забудьте воспользоваться любой возможностью для настройки текста диалогового окна для уточнения, как приложение использует и, если применимо, разделяет такую информацию с третьими лицами.
+
+* **Избегайте делать сюрпризы пользователю**: Если приложение собирает или использует информацию способом который может быть необычным для пользователей в свете основной цели вашего приложения (например, музыкальный плейер которые получает доступ к сохраненным изображениям), вы должны принять похожие шаги как при сборе личной информации. То есть настоятельно рекомендуется использование диалоговых окон появляющихся перед совершением действия, для информирования пользователя о сборе или использовани его информацию и, при необходимости, обеспечивать соответствующий контроль конфиденциальности.
+
+* **Сбор данных третьей стороной или обмена данными с третьими лицами**: Если ваше приложение собирает информацию, которая предоставляется другой компании--такой как социальная платформа или рекламная сеть (например, если ваше приложение отображает рекламу)--вы должны сообщить пользователям об этом сборе и обмена данными. Как минимум, ваша политика конфиденциальности должна описывать сбор информации и ее обмен и, если это уместно, предлагать пользователям возможность управления или отказа от такого сбора или обмена информацией.
+
+* **Ограничение сбора и безопасность**: пользователи доверяют вашему приложению свою информацию и они ожидают, что вы будете принимать соответствующие предосторожности, чтобы защитить ее. Один из лучших способов избежать компромиссов в безопасности личной информации в первую очередь является на собирать информацию, если ваше приложение не имеет конкретных и законных оснований для сбора. Для информации, которая должна быть получена, убедитесь, что вы применяете надлежащие мер безопасности для защиты этой информации, хранятся ли они на устройстве или на ваших серверах. Следует также разработать политику хранения соответствующих данных, которая осуществляется в пределах приложения и на ваших серверы.
+
+ [1]: cordova_camera_camera.md.html
+ [2]: cordova_media_capture_capture.md.html
+ [3]: cordova_contacts_contacts.md.html
+ [4]: cordova_geolocation_geolocation.md.html
+
+Ниже приведены некоторые дополнительные полезные руководства по мобильной конфиденциальности для разработчиков:
+
+* Генеральный прокурор Калифорнии, [Конфиденциальность в движении: рекомендации для мобильных экосистем][5]
+
+* Центр демократии и технологии, Форум будущего конфиденциальности, [ лучшии практики для разработчиков мобильных приложений][6]
+
+* CTIA-Ассоциация беспроводной связи, [передовые практики и руководства для услуг на основе местоположение][7]
+
+* Федеральная торговая комиссия, [мобильная конфиденциальность информации: укрепление доверия через прозрачность][8]
+
+* Форум Будущее конфиденциальности, веб-сайт [Конфиденциальность приложения][9]
+
+ [5]: http://oag.ca.gov/sites/all/files/pdfs/privacy/privacy_on_the_go.pdf
+ [6]: http://www.futureofprivacy.org/wp-content/uploads/Best-Practices-for-Mobile-App-Developers_Final.pdf
+ [7]: http://www.ctia.org/business_resources/wic/index.cfm/AID/11300
+ [8]: http://www.ftc.gov/os/2013/02/130201mobileprivacyreport.pdf
+ [9]: http://www.applicationprivacy.org
\ No newline at end of file
diff --git a/docs/ru/5.0.0/guide/appdev/security/index.md b/docs/ru/5.0.0/guide/appdev/security/index.md
new file mode 100644
index 0000000..14b58df
--- /dev/null
+++ b/docs/ru/5.0.0/guide/appdev/security/index.md
@@ -0,0 +1,105 @@
+---
+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.
+---
+
+# Руководство по безопасности
+
+Следующее руководство содержит некоторые рекомендации по безопасности, которые следует учитывать при разработке приложений Cordova. Имейте в виду, что безопасность-это очень сложная тема, и поэтому это руководство не является исчерпывающим. Если вы считаете, что вы можете внести свой вклад в это руководстве, пожалуйста, не стесняйтесь создать запрос в баг трекере Cordova в разделе [«Documentation»][1]. Это руководство предназначено, чтобы быть применимым к любой разработке на Cordova (все платформы), но следует отметить некоторые особенности платформ.
+
+ [1]: https://issues.apache.org/jira/browse/CB/component/12316407
+
+## В данном руководстве рассматриваются следующие темы:
+
+* Список разрешенных ресурсов
+* IFRAME и механизм идентификатора обратного вызова
+* Закрепление сертификата
+* Самозаверенные сертификаты
+* Шифрованное хранилище
+* Общие советы
+* Рекомендуемые статьи и другие ресурсы
+
+## Список разрешенных ресурсов
+
+* Прочтите и разберитесь в разделе "Инструкция по доступу к внешним ресурсам"
+
+* Резрешение определенных доменов не работает на Android API 10 и ниже, и в WP8 для iframe и XMLHttpRequest. Это значит, злоумышленник может загрузить любой домен в iframe и любой сценарий на странице внутри iframe и получить непосредственный доступ к Cordova JavaScript-объектам и соответствующим Java-объектам. Вы должны принять это во внимание при создании приложений для этих платформ. На практике это означает, что вы должны убедится, что вы разрабатываете для Android API версии выше 10, и по возможности не использовать iframe для загрузки внешнего содержимого - используйте плагин inAppBrowser или другие сторонние плагины.
+
+## IFRAME и механизм идентификатора обратного вызова
+
+Если содержимое подается в iframe из whitelisted домена, этот домен будет иметь доступ к родной мост Кордова. Это означает, что если вы белый сторонние рекламные сети и обслуживать эти объявления через iframe, вполне возможно, что вредоносные объявление будет возможность вырваться из iframe и выполнять вредоносные действия. Из-за этого как правило не следует использовать фреймы если вы контролируете сервера, на котором содержание iframe. Также, обратите внимание, что существуют сторонние плагины доступны для поддержки рекламных сетей. Обратите внимание, что это утверждение верно не для iOS, который перехватывает все, включая iframe соединения.
+
+## Закрепление сертификата
+
+Кордова не поддерживает закрепление истинное свидетельство. Главным препятствием для этого является отсутствие родного API в Android для перехвата соединений SSL для выполнения проверки сертификата сервера. (Хотя это возможно для сертификата, закрепление на Android в Java с помощью JSSE, webview на андроид написан на C++, и соединения сервера обрабатываются webview для вас, поэтому невозможно использовать Java и JSSE там.) Поскольку Apache Cordova предназначен предлагать последовательного интерфейсов API на нескольких платформах, не имея возможности в основных платформ ломает эту последовательность.
+
+Есть способы для закрепления сертификат, как проверка, Открытый ключ сервера (отпечатков пальцев) это ожидаемое значение при запуске приложения или другие неоднократно в течение жизни вашего приложения. Сторонние плагины доступны для Кордова, который может сделать это. Однако это не то же самое, как истинный сертификат, закрепления, который автоматически проверяет ожидаемое значение каждого соединения с сервером.
+
+## Самозаверенные сертификаты
+
+Использование самоподписывающихся сертификатов на вашем сервере не рекомендуется. Если вы желаете SSL, то настоятельно рекомендуется что ваш сервер имеет сертификат, который должным образом подписан известным центром сертификации (центр сертификации). Неспособность true сертификат закрепление делает это важно.
+
+Причина заключается, что принимая самозаверяющие сертификаты обходит проверка цепочки сертификатов, которая позволяет любой сертификат сервера, чтобы считаться допустимым в устройство. Это открывает сообщение man-in--middle атак. Она становится очень легко для хакера не только перехватывать и читать весь обмен данными между устройством и сервером, но и изменять сообщения. Устройство никогда не будут знать, что это происходит потому, что он не проверяет, что сертификат сервера подписан доверенным центром сертификации. Устройство имеет никаких доказательств того, что сервер является кто он ожидает. Из-за легкости делает человек в середине нападение принимая самозаверяющие сертификаты лишь незначительно лучше, чем просто выполнение http вместо https на ненадежной сети. Да, трафик будет зашифрован, но он может быть зашифрован с помощью ключа от man-in--middle, поэтому человек в середине может получить доступ все, так что шифрование бесполезно Кроме пассивных наблюдателей. Пользователи доверять SSL для обеспечения безопасности, и это будет намеренно делать это небезопасно, так что использование SSL становится заблуждение. Если это будет использоваться на доверенной сети (то есть, ты полностью внутри контролируемого предприятия), то до сих пор самозаверяющие сертификаты не рекомендуется. Две рекомендации, содержащиеся в доверенной сети, просто использовать http, потому что сама сеть является доверенным, или для получения сертификата, подписанного доверенным центром сертификации (не самоподписанный). Сеть доверенных или нет.
+
+Принципы, описанные здесь, не являются специфическими для Apache Cordova, они применяются для всех связь клиент сервер.
+
+При запуске Кордова на Android, с помощью `android:debuggable="true"` в приложения манифест позволит ошибки SSL, например сертификат цепи ошибок проверки на самозаверяющие сертификаты. Так что вы можете использовать самозаверяющие сертификаты в этой конфигурации, но это не конфигурация, которая должна использоваться, когда ваше приложение находится в производстве. Он предназначен для использования только во время разработки приложения.
+
+## Шифрованное хранилище
+
+(TBD)
+
+## Общие советы
+
+### Не использовать Android Пряник!
+
+* Установите уровень выше, чем 10 мин цели sdk. API 10 является пряник, и пряник больше не поддерживается Google или устройство производителями и поэтому не рекомендуем команды Кордова.
+* Пряников было показано, чтобы быть небезопасно и один из самых ориентированных мобильных ОС [http://www.mobilemag.com/2012/11/06/andriod-2-3-gingerbread-security/][2].
+* Белый на андроиде не работает с пряников или ниже. Это означает, что злоумышленник может загрузить вредоносный код в iframe, который затем будет иметь доступ ко всем API, Кордова и могли бы использовать этот доступ для кражи личных данных, отправлять SMS-сообщения на платные номера и выполнения других вредоносных действий.
+
+ [2]: http://bgr.com/2012/11/06/android-security-gingerbread-malware/
+
+### Используйте InAppBrowser для внешних ссылок
+
+* Использование InAppBrowser при открытии ссылки на любой внешний веб-сайт. Это гораздо безопаснее, чем белый, имя домена и включая содержимое непосредственно в приложении, потому что InAppBrowser будет использовать функции безопасности родной браузер и веб-сайт не даст доступ к среде Кордова. Даже если вы доверяете веб-сайт третьей стороны и включить его непосредственно в приложении, что веб-сайт третьей стороны можно связать с вредоносного веб-содержимого.
+
+### Проверка всех входных данных пользователя
+
+* Всегда проверяют все данные, что приложение принимает. Это включает в себя имена пользователей, пароли, даты, загруженных средств массовой информации и т.д. Поскольку злоумышленник может манипулировать HTML и JS активы (либо декомпиляции приложения или с помощью средств отладки как chrome://inspect), эта проверка следует также выполнить на вашем сервере, особенно перед передачей данных в любой серверной службе.
+* Другие источники, где данные должны быть проверены: документы пользователей, контактов, push-уведомления
+
+### Не кэшируйте конфиденциальные данных
+
+* Если имена пользователей, пароль, геолокации информацию и другие важные данные находятся в кэше, он мог бы потенциально быть получены позднее неавторизованным пользователем или приложением.
+
+### Не используйте функцию eval(), за исключением случаев если вы знаете, что вы делаете
+
+* Функция eval() JavaScript имеет долгую историю злоупотребляют. Неправильное использование может открыть код для атак, отладка трудности и медленнее выполнение кода.
+
+### Не думайте, что ваш исходный код является безопасным
+
+* Поскольку Cordova-приложение строится на основе HTML и JavaScript, которые упаковываются в контейнере платформы, не следует считать ваш код безопасным. Это позволяет произвести реверс-инжиниринг Cordova-приложения.
+
+## Рекомендуемые статьи и другие ресурсы
+
+* [HTML5 безопасности шпаргалку, подробно как для защиты приложения HTML5][3]
+* [PhoneGap и статьи о безопасности устройства, например с помощью зашифрованных данных][4]
+* [Официальный документ о безопасности хорошо известны недостатки в Webview на основе гибридных приложений][5]
+
+ [3]: https://www.owasp.org/index.php/HTML5_Security_Cheat_Sheet
+ [4]: https://github.com/phonegap/phonegap/wiki/Platform-Security
+ [5]: http://www.cis.syr.edu/~wedu/Research/paper/webview_acsac2011.pdf
\ No newline at end of file
diff --git a/docs/ru/5.0.0/guide/appdev/whitelist/index.md b/docs/ru/5.0.0/guide/appdev/whitelist/index.md
new file mode 100644
index 0000000..27f9571
--- /dev/null
+++ b/docs/ru/5.0.0/guide/appdev/whitelist/index.md
@@ -0,0 +1,141 @@
+---
+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.
+---
+
+# Инструкция по доступу к внешним ресурсам
+
+Список разрешенных доменов это модель безопасности, которая контролирует доступ во внешние домены, к которому ваше приложение не имеет доступа. Cordova предоставляет настраиваемую политику безопасности для определения, к каким внешним сайтам может быть получен доступ. По умолчанию новые приложения настроены для доступа к любому сайту. Прежде чем переносить приложение для рабочую среду, следует сформулировать список разрешений и разрешить доступ к определенным сетевым доменам и поддоменам.
+
+Для Android и iOS (по состоянию на их версии 4.0) политики безопасности Cordova могут быть расширяемым через инерфейс плагина. Ваше приложение должно использовать [cordova-plugin-whitelist][1], так как он обеспечивает лучшую безопасность и настраиваемость, чем более ранние версии Cordova. Хотя это возможно осуществить свой собственный плагин управления доступом к внешним ресурсам, это не рекомендуется, за исключением случая если ваше приложение имеет весьма специфические требования политики безопасности. Смотрите [cordova-plugin-whitelist][1] за подробностями об использовании и настройке.
+
+ [1]: https://github.com/apache/cordova-plugin-whitelist
+
+Cordova следует спецификации [W3C Доступ виджета][2], которая опирается на элемент `<access>` в файле `config.xml` приложения, чтобы включить сетевой доступ к отдельным доменам. Для проектов которые погалаются на процесс с использованием командной строки, описанный в разделе "Интерфейс командной строки", этот файл расположен в корневой папке проекта. В противном случае при использовании пути разработки с использованием платформо-ориентированного кода, места расположения указаны в разделах ниже. (См. различные руководства платформ для получения дополнительной информации на каждой платформе.)
+
+ [2]: http://www.w3.org/TR/widgets-access/
+
+В следующих примерах демонстрируется синтаксис `<access>` списка разрешенных ресурсов:
+
+* Доступ к [google.com][3]:
+
+ <access origin="http://google.com" />
+
+
+* Доступ по защищенному протоколу к [google.com][4] (`https://`):
+
+ <access origin="https://google.com" />
+
+
+* Доступ к поддомену [maps.google.com][5]:
+
+ <access origin="http://maps.google.com" />
+
+
+* Доступ для всех поддоменов для домена [google.com][3], например, [mail.google.com][6] и [docs.google.com][7]:
+
+ <access origin="http://*.google.com" />
+
+
+* Доступ ко *всем* доменам, например, [google.com][3] и [developer.mozilla.org][8]:
+
+ <access origin="*" />
+
+
+ Это значение по умолчанию для вновь созданных проектов CLI.
+
+ [3]: http://google.com
+ [4]: https://google.com
+ [5]: http://maps.google.com
+ [6]: http://mail.google.com
+ [7]: http://docs.google.com
+ [8]: http://developer.mozilla.org
+
+Имейте ввиду что некоторые сайты могут автоматически перенаправить вас со своей домашней страницы на другой URL, например используя протокол HTTPS или на домен специфичный для страны пользователя. Например http://www.google.com будет перенаправлять на использование протокола SSL/TLS по адресу https://www.google.com и затем может перенаправить на оснввании вашего географического расположения, например https://www.google.co.uk. Такие сценарии могут потребовать измененных или дополнительных записей в списке разрешенных доменов по отношению к вашим первоначальным требованиям. Пожалуйста, учитывайте это, когда вы строите ваш список разрешенных доменов.
+
+Обратите внимание, что список разрешенных доменов применяется только к основным WebView Cordova и не применяется к InAppBrowser WebView или при открытии ссылки в веб-браузере системы.
+
+## Список разрешений Amazon Fire OS
+
+Список разрешений расположен в`res/xml/config.xml`.
+
+## Список разрешений Android
+
+Как указано выше см. [cordova-plugin-whitelist][1] для подробностей. Для cordova-android до 4.0.0 версии смотрите старые версии этой документации.
+
+## Список разрешений iOS
+
+Как указано выше см. [cordova-plugin-whitelist][1] для подробностей. Для cordova-ios до 4.0.0 версии смотрите старые версии этой документации.
+
+## Список разрешений BlackBerry 10
+
+Разрешающие правила могут быть найдены в `www/config.xml`.
+
+Использование шаблонов в BlackBerry 10 отличается от остальных платформы двумя способами:
+
+* Любой контент, к которому получается доступ с использованием `XMLHttpRequest` должн быть объявлен явным образом. Установка `origin="*"` в этом случае не работает. Как вариант, веб-безопасность можно отключить с помощью параметра `WebSecurity`, описанном в разделе Настройка BlackBerry:
+
+ <preference name="websecurity" value="disable" />
+
+
+* Как альтернатива параметру `*.domain` , установите дополнительный атрибут `subdomains` со значением `true`. Он установлен в `false` по умолчанию. Например, следующее описание позволяет получить доступ к `google.com` , `maps.google.com` , и `docs.google.com`:
+
+ <access origin="http://google.com" subdomains="true" />
+
+
+ А следующее описание ограничивает доступ до `google.com`:
+
+ <access origin="http://google.com" subdomains="false" />
+
+
+ Укажите доступ ко всем доменам, в том числе для протокола локальной файловой системы `file://`:
+
+ <access origin="*" subdomains="true" />
+
+(За более подробной информацией о поддерживаемых функциях, смотрите документации BlackBerry по [тегу access][9].)
+
+ [9]: https://developer.blackberry.com/html5/documentation/ww_developing/Access_element_834677_11.html
+
+## Firefox OS
+
+В Firefox OS нет концепции разрешения определенного домена. Вместо этого есть специальное разрешение называемое [SystemXHR][10]. Существует необходимость добавить это разрешение в `config.xml`:
+
+ [10]: https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest#Permissions
+
+ <platform name="firefoxos">
+ <permission name="systemXHR" privileged="true" description="load data from server" />
+ </platform>
+
+
+Объект`XMLHttpRequest` должен быть инстанцирован с двумя параметрами `mozAnon` и `mozSystem`:
+
+ var request = new XMLHttpRequest({
+ mozAnon: true,
+ mozSystem: true});
+
+
+Это решение является прозрачным, так что нет никакой разницы при использовании его совместно с другими платформами.
+
+## Список разрешений Windows Phone
+
+Списки разрешающий правил для Windows Phone 7 и 8 находятся в файле `config.xml` приложения.
+
+## Список разрешений Tizen
+
+Списки разрешающий правил находятся в файле приложения `config.xml`. Платформа рассчитывает на тот же атрибут `subdomains` что и платформа BlackBerry. (За более детальной информацией о поддерживаемых функциях, смотрите документацию Tizen по [тегу access][11].)
+
+ [11]: https://developer.tizen.org/help/index.jsp?topic=%2Forg.tizen.web.appprogramming%2Fhtml%2Fide_sdk_tools%2Fconfig_editor_w3celements.htm
\ No newline at end of file
diff --git a/docs/ru/5.0.0/guide/cli/index.md b/docs/ru/5.0.0/guide/cli/index.md
new file mode 100644
index 0000000..eb00714
--- /dev/null
+++ b/docs/ru/5.0.0/guide/cli/index.md
@@ -0,0 +1,403 @@
+---
+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.
+---
+
+# Интерфейс командной строки
+
+Это руководство показывает, как создать приложения и развернуть их на различных мобильных платформах с использованием `cordova` интерфейса командной строки (CLI). Эта программа позволяет вам создавать новые проекты, собирать их на различных платформах, и запускать ваше приложение на устройствах или в эмуляторах. CLI является основным инструментом используемым для кросс платформенного процесса разработки, описанного в разделе "Введение". В другом случае вы также можете использовать CLI для инициализации кода проекта, а затем переключиться на использование SDK различных платформ и другие инструменты командной строки для дальнейшей разработки.
+
+## Необходимые условия
+
+Перед запуском любого средства командной строки, необходимо установить пакет SDK для каждой платформы, для которой вы хотите разрабатывать. (См. раздел "Руководство по поддерживаемым платформам" для получения более подробной информации.)
+
+Чтобы добавить поддержку платформы или перестроить проект для какой либо платформы, вы должны запустить интерфейс командной строки на том же компьютере, который поддерживает SDK платформы. CLI поддерживает следующие комбинации:
+
+* iOS (Mac)
+* Amazon Fire OS (Mac, Linux, Windows)
+* Android (Mac, Linux, Windows)
+* BlackBerry 10 (Mac, Linux, Windows)
+* Windows Phone 8 (Windows)
+* Окна (Windows)
+* Firefox OS (Mac, Linux, Windows)
+
+На Mac командная строка доступна с помощью приложения *Терминал*. На ПК он доступен как приложение *Командная строка* в разделе *Аксессуары*.
+
+**Примечание**: Для Windows платформ, вы по прежнему можете вести свою разработку на Mac запуская Windows в виртуальной машине или в режиме двойной загрузки. Доступные параметры см. в разделах "Руководство для платформы Windows Phone 8" или "Руководство по платформе Windows".
+
+Скорее всего, вы будете запускать CLI с различных компьютеров, тем больше имеет смысл поддерживать удаленный репозиторий, откуда вы будете забирать рабочие материалы в локальные каталоги.
+
+## Установка CLI Cordova
+
+Средство командной строки Cordova распространяется как пакет npm в готовом к использованию формате. Нет необходимости для его компиляции из исходного кода.
+
+Чтобы установить инструмент командной строки `cordova`, выполните следующие действия:
+
+1. Скачайте и установите [Node.js][1]. После установки вы должны быть возможность выполнять `node` и `npm` в командной строке. При желании, вы можете дополнительно использовать инструмент, как например `nvm` или `nave` для управления вашей установкой Node.js.
+
+2. Скачайте и установите [git клиент][2], если у вас его еще нет. После установки вы должны быть способны вызвать `git` из вашей командной строки. Даже несмотря на то, что вы не будете использовать `git` вручную, CLI использовать для загрузки некоторых ресурсов при создании нового проекта.
+
+3. Установите модуль `cordova` с помощью инструмента `npm` Node.js. Модуль `cordova` будет автоматически загружен `npm`.
+
+ [1]: http://nodejs.org/
+ [2]: http://git-scm.com/
+
+* В OS X и Linux:
+
+ $ sudo npm install -g cordova
+
+
+ В OS X и Linux, может быть необходимым предварять команду `npm` командой `sudo` чтобы установить этот инструмент разработки, в защищенные каталоги, такие как `usr/local/share`. Если вы используете инструмент nvm/nave и имеете доступ на запись к каталогу установки, префикс `sudo` можно опустить. Есть [больше подсказок][3] по использованию `npm` без `sudo`, если вы имеете желание сделать это.
+
+* В Windows:
+
+ C:\>npm install -g cordova
+
+
+ Упомянутый выше флаг `-g` указывает `npm` установить `cordova` глобально. В противном случае он будет установлен в подкаталоге `node_modules` текущего рабочего каталога.
+
+ Вам может понадобиться добавить каталог `npm` в переменную `PATH` вашего окружения, для того чтобы вызывать глобально установленные `npm` модули. В Windows `npm` обычно можно найти в каталоге `C:\Users\username\AppData\Roaming\npm`. На OS X и Linux его обычно можно найти в каталоге `/usr/local/share/npm`.
+
+ Журнал установки может приводить к ошибкам, для любого не установленного SDK платформы.
+
+ После установки вы должны иметь возможность запускать `cordova` в командной строке без аргументов, и это должно напечатать текст справки.
+
+ [3]: http://justjs.com/posts/npm-link-developing-your-own-npm-modules-without-tears
+
+## Создание приложения
+
+Перейдите в каталог, где вы сохранили ваш исходный код и выполнить команду следующего вида:
+
+ $ cordova create hello com.example.hello HelloWorld
+
+
+Завершение команды может длиться дольше нескольких секунд, поэтому будьте терпеливы. Запуск команды с опцией `-d` будет показывать информацию о прогрессе операции.
+
+Первый аргемент - *hello* указывает каталог в котором будет сформирован ваш проект. Этот каталог не должен существовать, Cordova создаст его для вас. Подкаталог `www` созданной директории будет содержать домашнюю страницу вашего приложения, совместно с ресурсами в каталогах `css`, `js`, и `img`, что соответствует общепринятым соглашениям по наименованию файлов и каталогов принятых в веб-разработке. Эти активы будут храниться в локальной файловой системе устройства, не служил удаленно. Файл `config.xml` содержит важные метаданные необходимые для формирования и распространения приложения.
+
+Второй аргумент `com.example.hello` указывает идентификатор вашего проекта в обратном формате доменных имен. Этот аргумент необязателен, но только если вы также пропустите третий аргумент, потому что аргументы определяются в зависимости от их позиций. Вы можете изменить это значение позже в файле `config.xml`, но вам надо учитывать что возможно код сформированный вне `config.xml` использует это значение, как например имена Java пакетов. Значение по умолчанию `io.cordova.hellocordova`, но рекомендуется чтобы вы выбрали подходящее значение.
+
+Третий аргумент `HelloWorld` указывает отображаемое имя приложения. Этот аргумент является необязательным. Вы можете изменить это значение позже в файле `config.xml`, но вам надо учитывать что возможно код сформированный вне `config.xml` использует это значение, как например имена Java классов. Значением по умолчанию является `HelloCordova`, но мы рекомендуем вам выбрать подходящее значение.
+
+## Добавление платформ
+
+Все последующие команды должны быть выполняться в каталоге проекта или любых подкаталогах в его пределах:
+
+ $ cd hello
+
+
+Перед тем, как можно построить проект, необходимо указать набор целевых платформ. Ваши возможности по запуску этих команд зависят от того поддерживает ваш компьютер каждое SDK, и установили ли вы соответствующее SDK. Запустите любую из этих команд на Mac:
+
+ $ cordova platform add ios
+ $ cordova platform add amazon-fireos
+ $ cordova platform add android
+ $ cordova platform add blackberry10
+ $ cordova platform add firefoxos
+
+
+Запустите любую из этих команд на Windows компьютере, где *wp* ссылается на различные версии операционной системы Windows Phone:
+
+ $ cordova платформа добавить wp8 $ cordova платформа добавить добавить $ cordova платформы windows Амазонки fireos $ cordova платформа добавить android $ cordova платформа добавить blackberry10 $ cordova платформа добавить firefoxos
+
+
+Выполните это, чтобы проверить ваш текущий набор платформ:
+
+ $ cordova platforms ls
+
+
+(Обратите внимание, что команды `platform` и `platforms` являются синонимами.)
+
+Выполните одну из следующих команд, которые являются синонимами, чтобы удалить платформу:
+
+ $ cordova platform remove blackberry10
+ $ cordova platform rm amazon-fireos
+ $ cordova platform rm android
+
+
+Выполнение команд для добавления или удаления платформ затрагивает содержимое каталога *platforms* проекта, где каждая указанная платформа представлена как подкаталог. Исходный каталог *www* повторяется в подкаталоге каждой платформы, например вы можете увидеть его в `platforms/ios/www` или `platforms/android/assets/www`. Потому что CLI постоянно копирует файлы из исходной папки *www*, следует изменять только эти файлы, а не файлы, расположенные в подкаталогах *platforms*. При использовании системы управления версиями, следует добавить папку с исходным кодом *www*, наряду с папкой *merges* в вашу систему управления версиями. (Дополнительные сведения о папке *merges* можно найти в разделе "Настройка каждой платформы" ниже.)
+
+**Предупреждение**: При использовании CLI для построения вашего приложение, вы *не* должны редактировать какие либо файлы в каталоге `/platforms/` за исключением того случая если вы знаете что вы делаете, или в документации указано обратное. Файлы в этом каталоге обычно перезаписываются при подготовке приложений к построения, или при переустановке плагина.
+
+Если вы хотите в данный момент, можно использовать IDE, как например Eclipse или Xcode чтобы открыть проект который вы создали. Вам будет нужно открыть производный набор ресурсов из каталога `/platforms/` для разработки с использованием SDK. Это потому что специфичные для SDK метаданные хранятся в соответствующем подкаталоге `/platforms/`. (См. раздел "Руководство по поддерживаемым платформам" для получения информации о том как разрабатывать приложение в каждой IDE.) Используйте этот подход, если вы просто хотите инициализироавть проект с использованием CLI и потом переключиться на SDK для работы с инструментами платформы.
+
+Продолжайте читать если вы хотите использовать кросс-платформенный процесс разработки (CLI) для всего цикла разработки.
+
+## Построение приложения
+
+По умолчанию скрипт `cordova create` создает каркас веб приложения чья домашняя страница это файл проекта `www/index.html`. Изменяйте это приложения как вы желаете, но любая инициализация должна быть указана как часть обработчика события `deviceready`, используемого по умолчанию из `www/js/index.js`.
+
+Выполните следующую команду для итеративного построения проекта:
+
+ $ cordova build
+
+
+Это создает код платформы в подкаталоге проекта `platforms`. При необходимости можно ограничить применения каждой сборки для выбранных платформ:
+
+ $ cordova build ios
+
+
+Команда `cordova build` это сокращение для следующих команд, которые в этом примере нацелены на одну платформу:
+
+ $ cordova prepare ios
+ $ cordova compile ios
+
+
+В этом случае, как только вы запустили `prepare`, вы можете использовать Xcode SDK компании Apple как альтернативу для изменения и компиляции платформо-зависимого кода, который кордова создала в каталоге `platforms/ios`. Вы можете использовать тот же подход для SDK других платформ.
+
+## Тестирование приложения на эмуляторе или устройстве
+
+SDK для мобильных платформ часто поставляются с эмуляторами которые выполняют образ устройства, таким образом что вы можете запустить ваше приложение из главного экрана и посмотреть как оно взаимодействует с различными функциями платформы. Выполните команду как указано ниже для перепостроения приложения запуска его в эмуляторе указанной платформы:
+
+ $ cordova emulate android
+
+
+Некоторые мобильные платформы эмулируют определенное устройство по умолчанию, как например iPhone для проектов iOS. Для других платформы, вам может понадобиться сперва ассоциировать устройство с эмулятором.
+
+**Примечание**: Поддержка эмулятора в настоящее время недоступна для Amazon Fire ОС.
+
+(См. "Руководство по поддерживаемым платформам" для подробной информации). Например вы можете сначала выполнить команду `android` для запуска Android SDK, а затем запустить образ конкретного устройства, которое запускает его согласно поведению по умолчанию:
+
+![][4]
+
+ [4]: img/guide/cli/android_emulate_init.png
+
+Последующая команда `cordova emulate` обновляет образ эмулятор для отображения последней версии приложение, которое теперь доступно для запуска с главного экрана:
+
+![][5]
+
+ [5]: img/guide/cli/android_emulate_install.png
+
+Поочередно можно подключить телефон к компьютеру и тестирование приложения непосредственно на нем:
+
+ $ cordova run android
+
+
+Перед выполнением этой команды, необходимо настроить устройство для тестирования, следуя процедурам, которые различаются для каждой платформы. В устройствах Android и Amazon Fire ОС вам придется включить функцию **Отладка USB** на устройстве и возможно добавить драйвер, USB в зависимости от вашего окружения разработки. Смотрите раздел "Руководство по поддерживаемым платформам" за подробностями о требованиях каждой платформы.
+
+## Добавить функции плагина
+
+При построении или просмотре нового проекта, приложение по умолчанию не делает очень много. Вы можете изменить приложение различными способами используя преимущества стандартных веб-технологий, но для того чтобы приложение тесно взаимодействовало с различными функциями устройства, вам необходимо добавить плагины которые предоставят доступ к базовым функциям Cordova API.
+
+*Плагин* это немного дополнительного кода которые предоставляет интерфейс к встроенным компонентам платформы. ВЫ можете создать свой собственный интерфейс плагина, к примеры для проектирования гибридного приложения которое совмещает Cordova WebView с встроенными компонентами. (За подробной информацией смотрите "Интеграция WebViews" и [Руководство по разработке плагинов][6].) В основном, вы будете добавлять плагин чтобы включить одну из базовых функций Cordova описанном в Спровочнике API.
+
+ [6]: guide_hybrid_plugins_index.md.html#Plugin%20Development%20Guide
+
+Начиная с версии 3.0 при создании проекта Cordova она не содержит каких-либо плагинов настоящей. Это новое поведение по умолчанию. Какие плагины вы хотите, даже основные плагины, должен быть явно добавлен.
+
+Список этих плагинов, включая дополнительные сторонние плагины, сообщества, можно найти в реестре по адресу [plugins.cordova.io][7]. Вы можете использовать CLI для поиска плагинов в этом реестре. К примеру поиск `bar` и `code` возвращает один результат который содержит оба слова без учета регистра:
+
+ [7]: http://plugins.cordova.io/
+
+ $ cordova plugin search bar code
+
+ com.phonegap.plugins.barcodescanner - Scans Barcodes
+
+
+Поиск только по слову `bar` возвращает дополнительный результат:
+
+ cordova-plugin-statusbar - Cordova StatusBar Plugin
+
+
+Команда `cordova plugin add` требует чтобы вы указали репозиторий для кода плагина. Вот пример как вы можете использовать CLI для добавления функций в приложение:
+
+* Базовая информация устройства (Device API):
+
+ $ cordova plugin add cordova-plugin-device
+
+
+* Сетевое подключение и События батареи:
+
+ $ cordova plugin add cordova-plugin-network-information
+ $ cordova plugin add cordova-plugin-battery-status
+
+
+* Акселерометр, компас и информация о расположении:
+
+ $ cordova plugin add cordova-plugin-device-motion
+ $ cordova plugin add cordova-plugin-device-orientation
+ $ cordova plugin add cordova-plugin-geolocation
+
+
+* Камера, воспроизведение мультимедиа и съемка:
+
+ $ cordova plugin add cordova-plugin-camera
+ $ cordova plugin add cordova-plugin-media-capture
+ $ cordova plugin add cordova-plugin-media
+
+
+* Доступ к файлам на устройстве или по сети (File API):
+
+ $ cordova plugin add cordova-plugin-file
+ $ cordova plugin add cordova-plugin-file-transfer
+
+
+* Уведомление с помощью диалогового окна или вибрации:
+
+ $ cordova plugin add cordova-plugin-dialogs
+ $ cordova plugin add cordova-plugin-vibration
+
+
+* Контакты:
+
+ $ cordova plugin add cordova-plugin-contacts
+
+
+* Глобализация:
+
+ $ cordova plugin add cordova-plugin-globalization
+
+
+* Заставка:
+
+ $ cordova plugin add cordova-plugin-splashscreen
+
+
+* Открытие новых окон браузера (InAppBrowser):
+
+ $ cordova plugin add cordova-plugin-inappbrowser
+
+
+* Консоль отладки:
+
+ $ cordova plugin add cordova-plugin-console
+
+
+**Примечание**: CLI добавляет код плагина соответствующим образом для каждой платформы. Если вы хотите разработать с использованием инструментов низкого уровня или SDK платформы, как описано в разделе "Обзор", необходимо запустить утилиту Plugman которая добавит плагины отдельно для каждой платформы. (Для получения дополнительной информации, см. раздел "Использование Plugman для управления плагинами".)
+
+Используйте `plugin ls` (или `plugin list`, или просто `plugin`) для просмотра установленных на данный момент плагинов. Для каждого установленного плагина отображается его идентификатор:
+
+ $ cordova plugin ls # or 'plugin list'
+ [ 'cordova-plugin-console' ]
+
+
+Чтобы удалить плагин, сошлитесь к нему по тому же идентификатору, который появляется в списке. Например таким образом вы бы удалили поддержку для консоли отладки из версии релиза:
+
+ $ cordova plugin rm cordova-plugin-console
+ $ cordova plugin remove cordova-plugin-console # same
+
+
+Вы можете удалять или добавлять плагины пакетно указывая более чем один аргумент для соответствующей команды:
+
+ $ cordova plugin add cordova-plugin-console cordova-plugin-device
+
+
+## Расширенные параметры плагина
+
+При добавлении плагина, некоторые параметры позволяют указать откуда взять плагин. Приведенные выше примеры использования общепринятого реестра `registry.cordova.io`, и плагин определяется по его `id`:
+
+ $ cordova plugin add cordova-plugin-console
+
+
+`Id` также может включать номер версии плагина, добавленный после символа `@`. Версия `latest` — это псевдоним для самой последней версии. Например:
+
+ $ cordova plugin add cordova-plugin-console@latest
+ $ cordova plugin add cordova-plugin-console@0.2.1
+
+
+Если плагин не зарегистрирована в `registry.cordova.io`, но расположен в другом репозитории git, вы можете указать альтернативный URL-адрес:
+
+ $ cordova plugin add https://github.com/apache/cordova-plugin-console.git
+
+
+Приведенный выше пример git получает плагин из последней версии ветки master, но альтернативная git ссылка например тег или другая ветка могут быть добавлены после символа `#`:
+
+ $ cordova plugin add https://github.com/apache/cordova-plugin-console.git#r0.2.0
+
+
+Если плагин (и его файл `plugin.xml`) находится в подкаталоге репозитария git, вы можете указать его после символа `:`. Обратите внимание, что символ `#` все еще необходим:
+
+ $ cordova plugin add https://github.com/someone/aplugin.git#:/my/sub/dir
+
+
+Вы также можете объединить как ссылку git так и подкаталоги:
+
+ $ cordova plugin add https://github.com/someone/aplugin.git#r0.0.1:/my/sub/dir
+
+
+Как вариант укажите локальный путь к папке плагина, который содержит файл `plugin.xml`:
+
+ $ cordova plugin add ../my_plugin_dir
+
+
+## Использование каталога *merges* для настройки каждой платформы
+
+Хотя Cordova позволяет легко развертывать приложение на разных платформах, иногда необходимо добавить индивидуальные настройки. В этом случае вы не хотите изменить исходные файлы в различных каталогах `www` в каталоге верхнего уровня `платформы`, потому что они регулярно заменяются из кросс-платформенного источника - каталога верхнего уровня `www`.
+
+Вместо этого в каталог верхнего уровня `merges` предоставляет место для указания ресурсов для развертывания на определенных платформах. Каждый платформо-зависимый подкаталог `merges` отражает повторяет структуру директории `www`, и позволяет переопределить или добавить файлы, как это необходимо. Например вот как вы, возможно, использует `merges` чтобы увеличить размер шрифта по умолчанию для устройств Android и Amazon Fire ОС:
+
+* Измените файл `www/index.html`, добавив ссылку на дополнительный CSS-файл, `overrides.css` в данном случае:
+
+ <link rel="stylesheet" type="text/css" href="css/overrides.css" />
+
+
+* При необходимости создайте пустой `www/css/overrides.css` файл, который будет применяться для всех построений отличных от Android, предотвращая ошибку недостающего файла.
+
+* Создайте `css` подкаталог внутри `merges/android` , затем добавьте соответствующий файл `overrides.css`. Укажите CSS, который переопределяет 12 пунктовый размер шрифта по умолчанию, указанный в `www/css/index.css` , например:
+
+ body { font-size:14px; }
+
+
+При повторном построении проекта, Android версия будет содержать измененный размер шрифта, в то время как другие платформы остаются неизменными.
+
+Можно также использовать `merges` для добавления файлов, изначально не присутствующих в каталоге `www`. Например приложение может включить изображение для *кнопки Назал* в интерфейсе iOS, хранимом в `merges/ios/img/back_button.png`, в то время как версия Android вместо этого может перехватывать захватить события `backbutton` от соответствующей аппаратной кнопки.
+
+## Команды справки
+
+Cordova имеет несколько глобальных команд, которые могут помочь вам, если вы застряли или возникли проблемы. Команда `help` отображает все доступные команды Cordova и их синтаксис:
+
+ $ cordova help
+ $ cordova # same
+
+
+Кроме того вы можете получить более подробную справку по определенной команде. Например:
+
+ $ cordova run --help
+
+
+Команда `info` формирует список потенциально полезных сведений, например установленных платформ и плагинов, версии SDK для каждой платформы и версии CLI и `node.js`:
+
+ $ cordova info
+
+
+Она представляет информацию на экран и перенаправляет выходные данные в локальный файл `info.txt`.
+
+**Примечание**: в настоящее время, доступны только сведения о платформах iOS и Android.
+
+## Обновление Cordova и вашего проекта
+
+После установки утилиты `cordova`, вы можете всегда обновить ее до последней версии, выполнив следующую команду:
+
+ $ sudo npm update -g cordova
+
+
+Используйте этот синтаксис для установки определенной версии:
+
+ $ sudo npm install -g cordova@3.1.0-0.2.0
+
+
+Запустите `cordova - v`, чтобы увидеть, какая версия в настоящее время установлена. Выполните команду `npm info` для более длинного списка, который включает в себя текущую версию и другие доступные номера версий:
+
+ $ npm info cordova
+
+
+Кордова 3.0 является первая версия поддерживающая интерфейс командной строки, описанные в этом разделе. Если вы обновляете проект с версии ранее чем 3.0, необходимо создать новый проект, как описано выше, а затем скопировать старые ресурсы приложения в каталог верхнего уровня `www`. Там, где это применимо, далее сведения об обновлении до 3.0 доступны в разделе "Руководство по поддерживаемым платформам". После обновления к интерфейсу командной строки `cordova` используйте `npm update` чтобы оставаться актуальным, более длительные процедуры, описанные там более не актуальны.
+
+Cordova 3.0 + по-прежнему может требовать различных изменений структуры каталогов уровня проекта и других зависимостей. После того, как вы выполните команду `npm` указанную выше для обновления Cordova, необходимо убедиться, что ресурсы вашего проекта соответствуют требованиям последней версии. Выполните команды указанную ниже для каждой платформы, под которую вы создаете приложение:
+
+ $ cordova platform update android
+ $ cordova platform update ios
+ ...etc.
\ No newline at end of file
diff --git a/docs/ru/5.0.0/guide/hybrid/plugins/index.md b/docs/ru/5.0.0/guide/hybrid/plugins/index.md
new file mode 100644
index 0000000..95f87f1
--- /dev/null
+++ b/docs/ru/5.0.0/guide/hybrid/plugins/index.md
@@ -0,0 +1,160 @@
+---
+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.
+---
+
+# Руководство по разработке плагинов
+
+*Плагин* представляет собой пакет из встраиваемого кода, который позволяет WebView Cordova, в котором отображается приложение, взаимодействовать с платформой, на которой работает плагин. Плагины предоставляют доступ к функциям устройства и платформы, которые обычно недоступны для веб-приложений. Все основные функции Cordova API реализованы в виде плагинов, и многие другие доступны, что включение функций, таких как сканеры штрих-кодов, NFC-коммуникации, или адаптировать календарь интерфейсов. Существует [реестр][1] доступных плагинов.
+
+ [1]: http://plugins.cordova.io
+
+Плагины составляют единый интерфейс JavaScript наряду с соответствующей библиотеки машинного кода для каждой поддерживаемой платформы. По сути это скрывает различные реализации машинного кода за общий интерфейс JavaScript.
+
+Этот раздел шаги через простой *эхо* плагин, который передает строку из JavaScript на родной платформе и обратно, один, который можно использовать в качестве модели для создания гораздо более сложные функции. В этом разделе обсуждаются основные плагинная структура и интерфейс JavaScript с видом на улицу. Для каждого соответствующего родной интерфейс см. список в конце этого раздела.
+
+В дополнение к этим инструкциям, при подготовке к написать плагин, то лучше посмотреть на [Существующие плагины][2] для руководства.
+
+ [2]: http://cordova.apache.org/#contribute
+
+## Создание плагина
+
+Разработчики приложений используют команду CLI `plugin add` (обсуждается в разделе "Интерфейс командной строки") чтобы применить плагин к проекту. Аргумент для этой команды является URL-адрес для *git* -репозиторий, содержащий код плагина. Этот пример реализует API устройств в Кордова:
+
+ $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-device.git
+
+
+Репозиторий плагинов должен предоставлять файл манифеста верхнего уровня `plugin.xml` . Есть много способов для настройки этого файла, подробности о которых доступны в описании плагина. Эта сокращенная версия плагина `Device` обеспечивает простой пример для использования в качестве модели:
+
+ <?xml version="1.0" encoding="UTF-8"?>
+ <plugin xmlns="http://apache.org/cordova/ns/plugins/1.0"
+ id="cordova-plugin-device" version="0.2.3">
+ <name>Device</name>
+ <description>Cordova Device Plugin</description>
+ <license>Apache 2.0</license>
+ <keywords>cordova,device</keywords>
+ <js-module src="www/device.js" name="device">
+ <clobbers target="device" />
+ </js-module>
+ <platform name="ios">
+ <config-file target="config.xml" parent="/*">
+ <feature name="Device">
+ <param name="ios-package" value="CDVDevice"/>
+ </feature>
+ </config-file>
+ <header-file src="src/ios/CDVDevice.h" />
+ <source-file src="src/ios/CDVDevice.m" />
+ </platform>
+ </plugin>
+
+
+Атрибут `id` тега верхнего уровня `plugin` использует тот же формат реверс домена для идентификации плагина как и приложения, к которым он добавляется. Тег `js-module` указывает путь к общим интерфейсом JavaScript. Тег `platform` указывает соответствующий набор кода платформы, для платформы `ios` в данном случае. Тег `config-file` инкапсулирует тег `feature`, который вводится доабавляется в платформо-зависимый файл `config.xml`, чтобы уведомить платформу о дополнительном коде библиотеки. Теги `header-file` и `source-file` указывают путь к файлам библиотеки компонентов.
+
+## Проверка плагина
+
+Вы можете использовать `plugman` утилита для проверки, является ли плагин устанавливает правильно для каждой платформы. Установка `plugman` с помощью следующей команды [node][3] :
+
+ [3]: http://nodejs.org/
+
+ $ npm install -g plugman
+
+
+Вам нужен корректный каталог исходного кода приложения, например каталог верхнего уровня `www`, включенных в проект, созданный CLI, как описано в разделе "Интерфейс командной строки". Убедитесь, что домашняя страница приложения `index.html` ссылаются на имя файла интерфейса плагина JavaScript, как будто он расположен в той же директории с исходным кодом:
+
+ <script src="myplugin.js"></script>
+
+
+Затем выполните команду, такую как нижеуказанную, для тестирования что iOS зависимости загрузились должным образом:
+
+ $ plugman install --platform ios --project /path/to/my/project/www --plugin /path/to/my/plugin
+
+
+Для подробной информации о параметрах `plugman`, см. "Использование Plugman для управления расширениями". Для получения информации о том, как на самом деле *отладки* плагины увидеть родной интерфейс каждой из платформ, перечисленных в нижней части этой страницы.
+
+## Интерфейс JavaScript
+
+JavaScript предоставляет интерфейс передней, что делает его может быть самой важной частью плагин. Ваш плагин JavaScript можно структурировать, однако вам нравится, но вам нужно вызвать `cordova.exec` для взаимодействия с родной платформой, используя следующий синтаксис:
+
+ cordova.exec(function(winParam) {},
+ function(error) {},
+ "service",
+ "action",
+ ["firstArgument", "secondArgument", 42, false]);
+
+
+Вот как работает каждого параметра:
+
+* `function(winParam) {}`: Функция обратного вызова успех. Предполагая ваш `exec` вызов завершается успешно, эта функция выполняет наряду с каких-либо параметров, вы проходите к нему.
+
+* `function(error) {}`: Функция обратного вызова ошибки. Если операция не завершена успешно, эта функция выполняется с параметром необязательные ошибки.
+
+* `"service"`: Имя службы, для вызова на родной стороне. Это соответствует в родной класс, для которого более подробная информация доступна в родной гидов, перечисленных ниже.
+
+* `"action"`: Имя действия вызова на родной стороне. Это обычно соответствует методу собственного класса. Смотрите собственного руководства, перечисленных ниже.
+
+* `[/* arguments */]`: Массив аргументов для передачи в родной среде.
+
+## Пример JavaScript
+
+В этом примере показан один из способов реализовать интерфейс 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.
+ });
+
+
+Посмотрите на три последние аргументы для `cordova.exec` функции. Первые звонки `Echo` *службы*, имя класса. Второй просит `echo` *действий*, метода в этом классе. В-третьих, массив аргументов, содержащих строку эхо, которая является `window.echo` функция в первый параметр.
+
+Успех обратного вызова передается в `exec` это просто ссылка на функцию обратного вызова `window.echo` принимает. Если родной платформе инициирует обратный вызов для ошибки, он просто вызывает успех обратного вызова и передает ему строку по умолчанию.
+
+## Интерфейсы
+
+После того, как вы определяете JavaScript для вашего плагина, необходимо дополнить его по крайней мере один собственной реализации. Детали для каждой платформы перечислены ниже, и каждый основывается на простой пример эхо плагин выше:
+
+* Плагины для Amazon Fire OS
+* Плагины для Android
+* Плагины для iOS
+* Плагины для BlackBerry 10
+* Плагины Windows Phone 8
+* Плагины Windows
+
+Платформа Tizen не поддерживает плагины.
+
+## Публикации плагины
+
+После того как вы развивать ваш плагин, вы можете опубликовать и поделиться им с сообществом. Вы можете опубликовать ваш плагин в [реестра][1] Cordova (на основе [`npmjs`][4]) или в любом другом основанном на `npmjs` реестре. Другие разработчики могут установить его автоматически с помощью `plugman` или Кордова CLI. (Подробную информацию о каждом пути разработки, см. "Использование Plugman для управления расширениями" и "Интерфейс командной строки".)
+
+ [4]: https://github.com/isaacs/npmjs.org
+
+Чтобы опубликовать плагин, вам нужно использовать `plugman` инструмент и пройти через следующие шаги:
+
+ $ plugman adduser # that is if you don't have an account yet
+ $ plugman publish /path/to/your/plugin
+
+
+Вот оно что!
+
+Запуск `plugman --help` перечислены другие доступные команды на основе реестра.
\ No newline at end of file
diff --git a/docs/ru/5.0.0/guide/hybrid/webviews/index.md b/docs/ru/5.0.0/guide/hybrid/webviews/index.md
new file mode 100644
index 0000000..3b2625c
--- /dev/null
+++ b/docs/ru/5.0.0/guide/hybrid/webviews/index.md
@@ -0,0 +1,29 @@
+---
+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.
+---
+
+# Интеграция WebViews
+
+Кордова приложений обычно реализуются как на основе браузера *WebView* в пределах собственной мобильной платформы. В этом разделе показано, как, для поддержки платформ, для создания собственных WebView компоненты, которые в полной мере использовать API, Кордова. Затем можно развернуть эти компоненты приложений Cordova наряду с собственными компонентами в гибридном приложении.
+
+Чтобы развернуть WebView, вы должны быть знакомы с каждой родной среды программирования. Ниже приведены инструкции для поддерживаемых платформ.
+
+* WebView в Amazon Fire OS
+* WebViews в Android
+* WebViews в iOS
+* Windows Phone 8.0 WebViews
\ No newline at end of file
diff --git a/docs/ru/5.0.0/guide/next/index.md b/docs/ru/5.0.0/guide/next/index.md
new file mode 100644
index 0000000..5ab48bf
--- /dev/null
+++ b/docs/ru/5.0.0/guide/next/index.md
@@ -0,0 +1,250 @@
+---
+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.
+---
+
+# Последующие шаги
+
+Для разработчиков, иметь представление о том, как использовать Cordova CLI и использовать плагины, есть несколько вещей, вы можете хотеть рассматривать исследования рядом с построения лучшего, более мощные приложений Cordova. Следующий документ предлагает советы по различным темам, касающимся передовой практики, испытаний, модернизации и другие темы, но не предназначен быть директивный характер. Рассмотрим это вашей отправной точкой для вашего роста, как разработчик Кордова. Кроме того если вы видите то, что можно улучшить, пожалуйста, [внести][1]!
+
+ [1]: http://cordova.apache.org/#contribute
+
+Данное руководство содержит следующие разделы:
+
+* Лучшие практики
+* Обработка обновлений
+* Тестирование
+* Отладка
+* Пользовательский интерфейс
+* Особые соображения
+* Ногу
+* Получение справки
+
+# Лучшие практики
+
+## 1) Спа-ваш друг
+
+Прежде всего - приложений Cordova следует принять дизайн спа (одной страницы приложения). Слабо определены, Спа это клиентское приложение, которое запускается из одного запроса веб-страницы. Пользователь загружает начальный набор ресурсов (HTML, CSS и JavaScript) и дальнейшего обновления (показывая новый взгляд, загрузки данных) делается через AJAX. Курорты широко используются для более сложных клиентских приложений. GMail является прекрасным примером этого. После загрузки GMail, mail просмотров, редактирования и Организации выполняются путем обновления DOM вместо фактически оставляя на текущей странице для загрузки полностью новый.
+
+С помощью спа может помочь вам организовать ваше приложение более эффективным образом, но она также имеет конкретные преимущества для приложений Cordova. Cordova-приложение необходимо дождаться события deviceready прежде чем какие-либо плагины могут быть использованы. Если вы не использовать спа, и пользователь нажимает перейти от одной страницы к другой, вам придется ждать deviceready огонь снова прежде чем вы делаете использовать плагин. Это легко забыть, как ваше приложение получает больше.
+
+Даже если вы не хотите использовать Cordova, создание мобильного приложения без использования архитектуры одной страницы будет иметь серьезные производительность последствия. Это потому, что Навигация между страницами потребует скрипты, активов и т.д., необходимо перезагрузить. Даже если эти активы кэшируются, по-прежнему будет проблем производительности.
+
+Примеры спа библиотек, которые можно использовать в приложениях Cordova являются:
+
+* [AngularJS][2]
+* [EmberJS][3]
+* [Костяк][4]
+* [Кэндо пользовательского интерфейса][5]
+* [Монака][6]
+* [ReactJS][7]
+* [Sencha Touch][8]
+* [jQuery Mobile][9]
+
+ [2]: http://angularjs.org
+ [3]: http://emberjs.com
+ [4]: http://backbonejs.org
+ [5]: http://www.telerik.com/kendo-ui
+ [6]: http://monaca.mobi/en/
+ [7]: http://facebook.github.io/react/
+ [8]: http://www.sencha.com/products/touch/
+ [9]: http://jquerymobile.com
+
+И много, много, больше.
+
+## 2) производительность.
+
+Один из самых больших ошибок, можно сделать новый разработчик Кордова является предположить, что производительность, они получают на столе машины является то же самое, они получат на мобильном устройстве. Хотя наших мобильных устройств получили более мощные каждый год, они по-прежнему не хватает мощности и производительности рабочего стола. Мобильные устройства, как правило, имеют гораздо меньше оперативной памяти и GPU, что является далеко от их стола (или даже ноутбук) братьев. Полный список советов здесь будет слишком много, но вот несколько вещей, чтобы иметь в виду (с перечнем больше ресурсов в конце для дальнейших исследований).
+
+**Щелкните по сравнению с Touch** - крупнейший и самый простой ошибкой, вы можете сделать должна использовать события click. Хотя эти «работы» просто отлично на мобильный, большинство устройств вводят 300 мс задержки на них для того, чтобы различить прикосновение и коснуться событие «hold». С помощью `touchstart` , или `touchend` , приведет к резкому улучшению - 300 мс не звучит как много, но это может привести к отрывисто обновления пользовательского интерфейса и поведения. Следует также учитывать тот факт, что «touch» события не поддерживаются на не webkit-браузерами, см [CanIUse][10]. Для того, чтобы справиться с эти ограничения, вы можете оформить различные библиотеки, такие как HandJS и Fastouch.
+
+ [10]: http://caniuse.com/#search=touch
+
+**Переходы CSS против манипуляции DOM** - с использованием аппаратного ускорения переходы CSS будет значительно лучше, чем использование JavaScript для создания анимации. Смотрите список ресурсов в конце этого раздела для примеров.
+
+**Сетей сосать** - ОК, сети не всегда сосать, но задержку мобильных сетей, даже хорошие мобильные сети, намного хуже, чем вы, вероятно, думаете. Приложение рабочего стола, который хлебает вниз 500 строк данных JSON, каждые 30 секунд, будет медленнее на мобильное устройство, а также батарея hog. Имейте в виду, что Кордова apps имеют несколько способов для сохранения данных в приложении (LocalStorage и файловой системе, например). Кэшировать данные локально и учитывать количество данных, отправляемых и обратно. Это особенно важно, когда ваше приложение подключается через сотовую сеть.
+
+**Дополнительный выигрыш в производительности статьи и ресурсы**
+
+* [«Вы наполовину assed он»][11]
+* [«Топ 10 Советы по повышению производительности для PhoneGap и гибридных приложений»][12]
+* «Быстрые приложения и сайты с JavaScript»: http://channel9.msdn.com/Events/Build/2013/4-313
+
+ [11]: http://sintaxi.com/you-half-assed-it
+ [12]: http://coenraets.org/blog/2013/10/top-10-performance-techniques-for-phonegap-and-hybrid-apps-slides-available/
+
+## 3) признавать и обрабатывать автономный статус
+
+Смотрите предыдущий совет о сетях. Не только вы можете быть на медленных сетях, это вполне возможно для вашего приложения в полностью автономном режиме. Приложение должно обрабатывать это интеллигентая(ый) образом. Если ваше приложение не произойдет, люди будут думать, что ваше приложение не работает. Учитывая, насколько легко это для обработки (Кордова поддерживает прослушивание для оффлайн и онлайн событие) нет абсолютно никаких оснований для вашего приложения не реагировать, хорошо, когда запускать в автономном режиме. Будьте уверены, чтобы проверить (см. ниже раздел тестирование) вашего приложения и не забудьте проверить, как ваше приложение обрабатывает при запуске в одном государстве и затем переключиться на другой.
+
+Обратите внимание, что онлайн и оффлайн события, а также API подключения сети не является совершенным. Вам придется полагаться на с помощью XHR-запрос, чтобы увидеть, если оно действительно оффлайн или онлайн. В конце дня быть уверен, добавить той или иной форме поддержку для сетевых проблем - в самом деле, в Apple store (и возможно другие магазины) будут отвергать apps которые не обрабатывает должным образом оффлайн/онлайн государств. Для более подробного обсуждения этой темы см [«Является эта вещь по?»][13]
+
+ [13]: http://blogs.telerik.com/appbuilder/posts/13-04-23/is-this-thing-on-%28part-1%29
+
+# Обработка обновлений
+
+## Обновление проектов Кордова
+
+Если ваш существующий проект был создан с помощью Cordova 3.x, можно обновить проект, выполнив следующие действия:
+
+ Кордова Платформа обновления имя платформы ios, android, и др.
+
+
+Если ваш существующий проект был создан в версии до Кордова 3.x, вероятно было бы лучше, чтобы создать новый проект 3.x Кордова, а затем скопируйте код и ресурсы вашего существующего проекта в новый проект. Типичные действия:
+
+* Создайте новый проект 3.x Кордова (Кордова создание...)
+* Скопируйте папку www из старого проекта в новый проект
+* Скопируйте любые параметры конфигурации из старого проекта в новый проект
+* Добавьте любые плагины, используемые в старого проекта в новый проект
+* Создайте свой проект
+* Тест, тест, тест!
+
+Независимо от предыдущей версии проекта абсолютно важно, что вы читаете на то, что было изменено в обновленной версии, как обновление может нарушить ваш код. Лучшее место, чтобы найти эту информацию будет в выпуске опубликованы на блоге Кордова и в хранилищах. Необходимо тщательно протестировать приложение, чтобы проверить правильность работы после выполнения обновления.
+
+Примечание: некоторые плагины не могут быть совместимы с новой версией Кордова. Если плагин не совместим, вы можете быть в состоянии найти замену плагин, который делает то, что вам нужно, или может потребоваться отложить модернизацию вашего проекта. Кроме того изменить плагин, чтобы он работать под новой версии и вносить обратно в общины.
+
+## Обновления плагинов
+
+По состоянию на Cordova 3.4 не существует механизма для обновления измененных плагины, с помощью одной команды. Вместо этого удалить плагин и добавить его обратно в ваш проект, и будет установлена новая версия:
+
+ Кордова плагин rm com.some.plugin cordova плагин добавить com.some.plugin
+
+
+Не забудьте проверить обновленный плагин документации, как вам может потребоваться настроить код для работы с новой версией. Кроме того проверьте, что новая версия плагина работает с версией вашего проекта Кордова.
+
+Всегда проверяйте свои приложения, чтобы обеспечить, что установка нового плагина не нарушил что-то, что вы не планировали.
+
+Если ваш проект имеет много плагинов, которые необходимо обновить, он может сэкономить время для создания оболочки или пакетный сценарий, который удаляет и добавляет плагины с помощью одной команды.
+
+# Тестирование
+
+Супер важно, тестирование приложений. Кордова команда использует Жасмин, но любой дружественный отряд веб-тестирования решение будет делать.
+
+## Тестирование на тренажере против на реальном устройстве
+
+Это не редкость для использования настольных браузеров и тренажеры/эмуляторы устройств при разработке Cordova-приложение. Однако это невероятно важно, что вы протестировали свое приложение на столько физических устройств, как вы, возможно, может:
+
+* Тренажеры являются именно: тренажеры. Например ваше приложение может работать в симуляторе iOS без проблем, но он может не на реальном устройстве (особенно в определенных обстоятельствах, например состояние нехватки памяти). Или, ваше приложение может на самом деле не на тренажере, хотя она прекрасно работает на реальном устройстве.
+* Эмуляторы являются именно: Эмуляторы. Они не представляют, насколько хорошо ваше приложение будет работать на физическом устройстве. Например некоторые эмуляторы может сделать ваше приложение с искаженными дисплеем, в то время как реальное устройство не имеет никаких проблем. (Если вы столкнулись с этой проблемой, отключите узел GPU в эмуляторе).
+* Тренажеры обычно быстрее, чем физическое устройство. Эмуляторы, с другой стороны, как правило, медленнее. Не судите производительность вашего приложения, как он выполняет в тренажере или эмуляторе. Судья производительность вашего приложения, как он работает на спектр реальных устройств.
+* Невозможно получить хорошую почувствовать, как приложение реагирует на ваши прикосновения, используя эмулятор или симулятор. Вместо этого запуск приложения на реальном устройстве можно отметить проблемы с размерами элементов пользовательского интерфейса, отзывчивость и др.
+* Хотя было бы неплохо иметь возможность проверить только на одно устройство на платформе, то лучше проверить на многих устройствах, спортивные много различных версий ОС. К примеру что работает на вашей конкретной Android смартфон может не на другом устройстве Android. То, что работает на устройстве iOS 7 может не на устройстве iOS 6.
+
+Это, конечно же, невозможно проверить на все возможные устройства на рынке. По этой причине то целесообразно набирать много тестеров, которые имеют различные устройства. Хотя они не будут ловить каждую проблему, имеются хорошие шансы, что они откроют причуды и вопросы, которые вы бы никогда не найти в одиночку.
+
+Подсказка: Это возможно на устройствах Android Nexus легко прошить различных версий Android на устройстве. Этот простой процесс позволит вам легко тестировать приложения на различных уровнях с помощью одного устройства Андроид без аннулирования гарантии или требуя «побег из тюрьмы» или «корень» ваше устройство. Изображения фабрика Google Android и инструкции находятся в: https://developers.google.com/android/nexus/images#instructions
+
+# Отладка
+
+Отладка Cordova требуется небольшая Настройка. В отличие от настольных приложений вы не можете просто открыть dev инструменты на вашем мобильном устройстве и начать отладку, к счастью, есть некоторые большие альтернативы.
+
+## iOS Отладка
+
+### Xcode
+
+С помощью Xcode можно отлаживать iOS родной стороне Cordova-приложение. Убедитесь, что область отладки показывает (вид-> отладки район). После того, как ваше приложение выполняется на устройстве (или симулятор), вывод журнала можно просмотреть в области отладки. Это где будет печатать любые ошибки или предупреждения. Также можно установить точки останова в файлах источника. Это позволит вам просматривать состояние переменных в то время и шаг через код по одной строке за один раз. Состояние переменных отображается в области отладки, когда точка останова. Как только ваше приложение и работает на устройстве, вы можете принести вверх в Safari веб-инспектор (как описано ниже) для отладки в webview и js части вашего приложения. Для более подробной информации и помощи, найти в руководстве Xcode: [Руководство по отладке Xcode][14]
+
+ [14]: https://developer.apple.com/library/mac/documentation/ToolsLanguages/Conceptual/Xcode_Overview/DebugYourApp/DebugYourApp.html#//apple_ref/doc/uid/TP40010215-CH18-SW1
+
+### Safari удаленной отладки с веб-инспектор
+
+С Safari веб-инспектор можно отлаживать код webview и js в Cordova-приложение. Это работает только на OSX и только с iOS 6 (и выше). Он использует Safari для подключения к устройству (или симулятор) и будет подключаться к Cordova-приложение браузера dev инструменты. Вы получаете то, что вы ожидаете от dev tools - инспекции/манипуляции DOM, отладчик JavaScript, сеть инспекции, консоли и многое другое. Как Xcode с Safari веб-инспектор можно установить точки останова в коде JavaScript и посмотреть состояние переменных в то время. Можно просмотреть ошибки, предупреждения или сообщения, которые выводятся на консоль. Можно также выполнять команды JavaScript непосредственно из консоли, как ваше приложение выполняется. Для более подробной информации о том, как установить его вверх и то, что вы можете сделать, увидеть эту прекрасную блоге: <http://moduscreate.com/enable-remote-web-inspector-in-ios-6/> и это руководство: [Safari веб-инспектор руководство][15]
+
+ [15]: https://developer.apple.com/library/safari/documentation/AppleApplications/Conceptual/Safari_Developer_Guide/Introduction/Introduction.html
+
+## Хром удаленной отладки
+
+Практически же, как в версии Safari, это работает только с Android, но может быть использован с любой настольной операционной системы. Это требует как минимум Андроид 4.4 (KitKat), минимальный уровень API 19 и хром 30 + (на столе). После подключения, вы получите тот же опыт хром Dev Tools для мобильных приложений, как приложения для настольных. Даже лучше Chrome Dev инструменты имеют зеркальный вариант, который показывает ваше приложение работает на мобильном устройстве. Это больше, чем просто представление - вы можете прокручивать и нажмите от dev tools и обновляет на мобильном устройстве. Подробнее об удаленной отладки Chrome можно найти здесь: <https://developers.google.com/chrome/mobile/docs/debugging>
+
+Это позволяет использовать Chrome Dev инструменты для проверки приложений iOS, через прокси WebKit: <https://github.com/google/ios-webkit-debug-proxy/>
+
+## Пульсации
+
+Пульсация — обои на основе эмулятор для Кордова проектов. По сути он позволяет запускать Cordova-приложение в вашем настольном приложении и поддельные различные функции Кордова. Например он позволяет имитировать акселерометр для тестирования трясти события. Это подделки камеры API, позволяя выбрать картинку с вашего жесткого диска. Пульсации позволяет вам сосредоточиться на пользовательский код, а не беспокоиться о Кордове плагины. Вы можете узнать больше о пульсации здесь: <http://ripple.incubator.apache.org/>
+
+## Weinre
+
+Weinre создает локальный сервер, который может содержать клиент удаленной отладки для приложений Cordova. После того как установил и начал его, вы скопировать строку кода в Cordova-приложение и перезапустите его. Затем можно открыть панель инструментов dev на рабочем столе для работы с приложением. Weinre не как фантазии, как Chrome и Safari удаленной отладки, но имеет преимущества работы с гораздо большей спектр операционных систем и платформ. Дополнительную информацию можно найти здесь: <http://people.apache.org/~pmuellr/weinre/docs/latest/>
+
+## Другие варианты
+
+* BlackBerry 10 поддерживает отладку также: [Документация][16]
+* Вы можете отлаживать, а также с помощью диспетчера приложений Firefox, [этот блог][17] и эту [статью MDN][18].
+* Дополнительные примеры и объяснения выше отладки советы, см: <http://developer.telerik.com/featured/a-concise-guide-to-remote-debugging-on-ios-android-and-windows-phone/>
+
+ [16]: https://developer.blackberry.com/html5/documentation/v2_0/debugging_using_web_inspector.html
+ [17]: https://hacks.mozilla.org/2014/02/building-cordova-apps-for-firefox-os/
+ [18]: https://developer.mozilla.org/en-US/Apps/Tools_and_frameworks/Cordova_support_for_Firefox_OS#Testing_and_debugging
+
+# Пользовательский интерфейс
+
+Здание Cordova-приложение, которое выглядит хорошо на мобильный может быть сложной задачей, особенно для разработчиков. Многие люди решили использовать UI framework, чтобы сделать это проще. Вот краткий список опций, которые вы можете хотеть рассматривать.
+
+* [jQuery Mobile][9] - jQuery Mobile автоматически повышает ваш макет для мобильных оптимизации. Он также обрабатывает создание спа для вас автоматически.
+* [Ionic][19] -это мощная инфраструктура пользовательского интерфейса на самом деле имеет свой собственный CLI для обработки создания проекта.
+* [Храповик][20] - привлечены к вам люди, которые создали Bootstrap.
+* [Кэндо UI][5] - открытым исходным кодом пользовательского интерфейса и платформа приложений от Telerik.
+* [Автоэмаль][21]
+* [ReactJS][7]
+
+ [19]: http://ionicframework.com/
+ [20]: http://goratchet.com/
+ [21]: http://topcoat.io
+
+При создании интерфейса пользователя, важно думать о всех платформ, которые вы ориентируетесь и различия между ожиданиям пользователя. Например, Android приложение, которое имеет интерфейс iOS стиль будет вероятно не хорошо сочетаются с пользователей. Это иногда даже применяется в различных магазинах приложений. Из-за этого, важно, что вы уважаете конвенций каждой платформы и поэтому знакомы с различными руководящими принципами человеческого интерфейса: * [iOS][22] * [Android][23] * [Windows Phone][24]
+
+ [22]: https://developer.apple.com/library/ios/documentation/userexperience/conceptual/MobileHIG/index.html
+ [23]: https://developer.android.com/designWP8
+ [24]: http://dev.windowsphone.com/en-us/design/library
+
+## Дополнительные пользовательского интерфейса статьи и ресурсы
+
+Хотя браузеров становится все больше и больше стандартов жалобы, мы все еще живем в мире, префиксом (-webkit и - г-жа) следующие статьи ценно при разработке UI в для кросс-браузер приложений: <http://blogs.windows.com/windows_phone/b/wpdev/archive/2012/11/15/adapting-your-webkit-optimized-site-for-internet-explorer-10.aspx>
+
+# Особые соображения
+
+Хотя Cordova упрощает кросс платформенной разработки, это просто не возможно обеспечить 100% изоляция от родной базовой платформы. Так что надо знать ограничений.
+
+## Особенности платформы
+
+При чтении документации, искать разделы, которые структура различных поведений или требования на различных платформах. Если они присутствуют, они будут в разделе под названием «Android причуды», «причуды iOS», и т.д. Прочитайте эти причуды и быть осведомлены о них, как вы работаете с Кордова.
+
+## Загрузка удаленного содержимого
+
+Вызов функции Cordova JavaScript с удаленной загрузки HTML-страницы (HTML-страницы, не хранятся локально на устройстве) является неподдерживаемая конфигурация. Это потому что Кордова была не предназначены для этого, и сообщество Apache Cordova делает не тестирования данной конфигурации. Хотя она может работать в некоторых случаях, она не рекомендуется и не поддерживается. Есть проблемы с политики единого происхождения, сохраняя JavaScript и родной части Cordova синхронизированы на той же версии (так как они соединены через частной API, которые могут изменяться), в надежности удаленного контента, вызов собственных функций местных и потенциальный отказ магазина app.
+
+Отображение удаленного загрузки HTML-содержимое в webview должно быть сделано с помощью Кордова в InAppBrowser. InAppBrowser разработан таким образом, что JavaScript, работает там не имеют доступа к API JavaScript Кордова по причинам, перечисленным выше. Пожалуйста, обратитесь к руководству по безопасности.
+
+# Ногу
+
+Вот несколько способов, чтобы держать в курсе Кордова.
+
+* Подписаться на [блог Кордова][25].
+* Подписаться на [список разработчиков][26]. Обратите внимание - это не группа поддержки! Скорее это место, где обсуждается развитие Кордова.
+
+ [25]: http://cordova.apache.org/#news
+ [26]: http://cordova.apache.org/#mailing-list
+
+# Получение справки
+
+Следующие ссылки являются лучшими местами, чтобы получить помощь для Кордова:
+
+* StackOverflow: <http://stackoverflow.com/questions/tagged/cordova> с помощью тега Cordova, можно просматривать и просматривать все вопросы Кордова. Обратите внимание, что StackOverflow автоматически преобразует тег «Phonegap», чтобы «Кордова», так что таким образом вы будете иметь доступ к исторических вопросов, а также
+* PhoneGap группы Google: [https://groups.google.com/forum/#! форум/phonegap][27] этой группе Google был старый форум поддержки для когда Кордова по-прежнему называется PhoneGap. Хотя есть еще много Cordova пользователей, которые часто эта группа, Кордова сообщество выразило заинтересованность в упор меньше на этой группы и вместо этого с помощью StackOverflow для поддержки
+* Встреча: <http://phonegap.meetup.com> - рассмотреть возможность найти местных Кордова/PhoneGap встреча группы
+
+ [27]: https://groups.google.com/forum/#!forum/phonegap
\ No newline at end of file
diff --git a/docs/ru/5.0.0/guide/overview/index.md b/docs/ru/5.0.0/guide/overview/index.md
new file mode 100644
index 0000000..54e56c8
--- /dev/null
+++ b/docs/ru/5.0.0/guide/overview/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.
+---
+
+# Введение
+
+Apache Cordova — это платформа разработки мобильных приложений с открытым исходным кодом. Она позволяет использовать стандартные веб-технологии, такие как HTML5, CSS3 и JavaScript для кросс платформенной разработки, избегая родного языка разработки для каждой из мобильных платформ. Приложения выполняются внутри обертки нацеленной на каждую платформу и полагаются на стандартные API для доступа к датчикам устройства, данным и состоянию сети.
+
+Apache Cordova закончил инкубационный период в октябре 2012 года как основной проект в рамках Apache Software Foundation (ASF). Через участие в ASF, будущее развитие Cordova, обеспечит открытое руководство проектом. Он всегда будет оставаться бесплатным и с открытым исходным кодом под лицензией Apache версии 2.0. Посетите [cordova.apache.org][1] для получения дополнительной информации.
+
+ [1]: http://cordova.apache.org
+
+Используйте Apache Cordova, если вы:
+
+* Мобильный разработчик и хотите расширить приложение на более чем одну платформу, без необходимости повторно реализовать его для каждого языка разработки платформ и набора инструментов.
+
+* веб-разработчик и хотите, чтобы развернуть веб-приложение, который упаковано для распространения в различных магазинах приложений.
+
+* Мобильный разработчик, заинтересованный в смешивания компонентов собственного приложения с *WebView* (Специальный браузер окно), можно получить доступ к API уровне устройства, или если вы хотите разработать плагин интерфейс между родной и WebView компонентами.
+
+## Основные компоненты
+
+Пиложения Cordova полагаются на общий файл `config.xml`, который содержит информацию о приложении и определяет параметры, влияющие на то как приложенеи работает, такие как, реагирует ли оно на изменение ориентации устройства. Этот файл соответствует спецификации W3C [Упакованные веб-приложения][2], или *widget*, .
+
+ [2]: http://www.w3.org/TR/widgets/
+
+Само приложение реализована как веб-страницы, по умолчанию локальный файл под названием *index.html*, который ссылается на любой CSS, JavaScript, изображения, файлы мультимедиа или другие ресурсы необходимы для его запуска. Приложение выполняет как *WebView* в пределах оболочки приложения, которую вы распространяете в магазины приложений.
+
+WebView с поддержкой Cordova может представлять приложения и полностью его пользовательский интерфейс. На некоторых платформах она также может быть компонентом в больших, гибридные приложения, который объединяют WebView с другими компонентами приложения. (Подробную информацию см. в разделе "Интеграция WebViews".)
+
+Интерфейс *плагина* доступен для Cordova и других компоненты, для взаимодействия друг с другом. Это позволяет вызывать код на языке платформы из JavaScript. В идеале на нескольких платформах устройств согласуются JavaScript API, чтобы этот машинный код. Начиная с версии 3.0 плагины предоставляют привязки к стандартным API интерфейсам устройства. Сторонние плагины предоставляют дополнительные привязки для функции не обязательно доступных на всех платформах. Можно найти эти сторонние плагины в [реестре плагинов][3] и использовать их в своем приложении. Вы можете также разработать свои собственные плагины, как описано в разделе "Руководство по разработке плагинов". Плагины могут оказаться необходимыми, например, для связи между Cordova и собственными компонентами.
+
+ [3]: http://plugins.cordova.io
+
+**Примечание**: начиная с версии 3.0, при создании проекта Cordova, она не имеет каких-либо плагинов настоящей. Это новое поведение по умолчанию. Какие плагины вы хотите, даже основные плагины, должен быть явно добавлен.
+
+Кордова не предоставляет каких-либо виджетов пользовательского интерфейса или MV * рамки. Cordova предоставляет только во время выполнения, в которой те могут выполнять. Если вы хотите использовать UI-виджеты и/или механизма MV, вам нужно будет выбрать те и включить их в приложение себя как материалы третьей стороны.
+
+## Пути разработки
+
+Начиная с версии 3.0 можно использовать два основных рабочих процесса для создания мобильных приложений. Хотя вы можете использовать любой рабочий процесс для выполнения одной и той же задачи, каждый из этих путей имеет свои преимущества:
+
+* **Кросс платформенный рабочий процесс**: Используйте этот рабочий процесс если вы хотите, чтобы ваше приложение запускалось на максимально возможном количестве мобильных платформ, с минимальными нуждами для платформо-специфической разработки. Этот рабочий процесс формируется возле утилиты `cordova`, также известном как Cordova *CLI*, который был введен начиная с Cordova 3.0. CLI это высоко уровневый инструмент который позволяет построить проекты для как можно большего количества платформа одновременно, абстрагируя как можно больше функциональности низко-уровневых скриптов. CLI копирует общий набор web ресурсво в подкаталоги для каждой мобильной платформы, делает любые необходимые изменения в конфигурацию для каждой платформы, запускает сценарии сборки для создания исполняемых файлов приложения. CLI также предоставляет общий интерфейс для применения плагинов для вашего приложения. Для более подробной информации о CLI увидеть интерфейс командной строки. Если у вас есть необходимость по центру платформы рабочего процесса, Рабочий процесс кросс платформенный рекомендуется.
+
+* **Платформо-ориентированный процесс разработки**: Используйте этот процесс если вы хотите сфокусироваться на построении приложения для одной платформы и вам будет необходимо вносить модификации на низком уровне. Вы должны использовать этот подход, к примеру, если вы хотите чтобы ваше приложение совмещало собственные компоненты с веб-ориентированными компонентами Cordova, как описано в разделе "Встраивание WebView". Как правило этот рабочий процесс используется, если необходимо изменить проект с помощью SDK. Этот рабочий процесс опирается на набор скриптов более низкого уровня, которые приспособлены для каждой поддерживаемой платформы и отдельную утилита Plugman, которая позволяет применять плагины индивидуально к выбранной платформе. Хотя вы можете использовать этот рабочий процесс для создания кросс платформенных приложений, это как правило сложнее, потому что отсутствие утилит более высокого уровня означает, отдельные циклов сборки и модификации плагинов для каждой платформы. Тем не менее этот рабочий процесс позволяет вам более широкий доступ к вариантам разработки, предоставляемые каждым SDK и важно для сложных гибридных приложений. Различные руководства платформы для подробной информации смотрите на утилиты доступны оболочки каждой платформы.
+
+Изначально, может быть легче всего использовать кросс платформенный рабочий процесс для создания приложения, как описано в разделе "Интерфейс командной строки". Затем у вас есть возможность перейти к платформо-ориентированному процессу разработки, если требуется большая степень контроля, предоставляемую SDK. Низкоуровневые утилиты доступны на [cordova.apache.org][1] в отдельной рассылке чем CLI. Для проектов, первоначально созданные CLI, эти инструменты доступны также в различных каталогах `platforms/*/cordova` проекта.
+
+**Примечание**: после того, как вы перейти от рабочего процесса на основе CLI к платформо-ориентированному процессу и инструментам командной строки, вы не сможете вернуться назад. CLI поддерживает общий набор кросс платформенный исходного кода, который при каждом построении он использует чтобы изменить платформо-зависимый исходный код. Чтобы сохранить любые изменения, внесенные вами в платформо-зависимые ресурсы, вам нужно перейти к платформо-ориентированным инструментам, которые игнорируют кросс платформенный исходный код и вместо этого полагаются на платформо-зависимый исходный код.
+
+## Установка Кордова
+
+Установка Cordova будет отличаться в зависимости от рабочего процесса выше, вы выбираете:
+
+* Кросс платформенный рабочий процесс: смотрите раздел "Интерфейс командной строки".
+
+* По центру платформы рабочего процесса: смотрите раздел "Руководство по поддерживаемым платформам".
+
+После установки Cordova, рекомендуется, что вы прочитали раздел "Руководство по поддерживаемым платформам" для мобильных платформ, для которых вы будете разрабатывать. Мы также рекомендуем также просмотреть разделы "Руководство по конфиденциальности", "Руководство по безопасности" и "Последующие шаги". Для настройки Cordova, смотрите раздел "Файл config.xml". Для доступа к функциям платформы на устройстве из JavaScript, обращайтесь к "API плагинов". И обращайтесь к другим включеным руководствам при необходимости.
\ No newline at end of file
diff --git a/docs/ru/5.0.0/guide/platforms/amazonfireos/config.md b/docs/ru/5.0.0/guide/platforms/amazonfireos/config.md
new file mode 100644
index 0000000..14a68c4
--- /dev/null
+++ b/docs/ru/5.0.0/guide/platforms/amazonfireos/config.md
@@ -0,0 +1,68 @@
+---
+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.
+---
+
+# Настройка Amazon Fire OS
+
+Файл `config.xml` управляет основные параметрами приложения, которые применяются к каждому приложению и экземпляру CordovaWebView. Этот раздел детализирует параметры, которые применяются только к продуктам построенным на платформе Amazon Fire ОС. Смотрите [Файл config.xml][1] для получения информации о глобальных параметрах конфигурации.
+
+ [1]: config_ref_index.md.html#The%20config.xml%20File
+
+* `KeepRunning` (логическое значение, по умолчанию `true` ): определяет, остается ли приложение работает в фоновом режиме после вызова события `pause`. Установка значения в `false` не завершает приложение после события `pause`, но просто останавливает выполнение кода в Cordova WebView в то время пока приложение находится в фоновом режиме.
+
+ <preference name="KeepRunning" value="false"/>
+
+
+* `ErrorUrl` (URL-адрес, По умолчанию используется `null`): Если установлено, будет отображаться странице ссылки на ошибку в приложении вместо диалоговое окно с заголовком «Ошибка приложения».
+
+ <preference name="ErrorUrl" value="error.html"/>
+
+
+* `LoadingDialog` (строка, по умолчанию `null`): Если указано, отображает диалоговое окно с заданным заголовком и сообщение и индикатор загрузки, при загрузке первой странице приложения. Заголовок и сообщение разделяются запятой в этой строке значение, и что запятая удаляется перед отображением диалогового окна.
+
+ <preference name="LoadingDialog" value="Please wait, the app is loading"/>
+
+
+* `LoadingPageDialog` (строки, по умолчанию `null`): так же, как `LoadingDialog`, но для загрузки каждой страницы следующей за первой страницей в приложении.
+
+ <preference name="LoadingPageDialog" value="Please wait, the data is loading"/>
+
+
+* `LoadUrlTimeoutValue` (число, значение по умолчанию — `20000`): при загрузке страницы, указывает продолжительность времени ожидания в миллисекундах, перед тем как произойдет ошибка ожидания. Этот пример определяет 10 секунд, а не 20:
+
+ <preference name="LoadUrlTimeoutValue" value="10000"/>
+
+
+* `SplashScreen`: Имя файла, минус его расширение в каталоге `res/drawable`. Различные ресурсы должны использовать это общее название в разных подкаталогах.
+
+ <preference name="SplashScreen" value="splash"/>
+
+
+* `SplashScreenDelay`(число, значение по умолчанию `5000` ): определяет количество времени в течение которого отображается заставка.
+
+ <preference name="SplashScreenDelay" value="10000"/>
+
+
+* `ShowTitle` (логическое значение, по умолчанию `false`): Показать заголовок в верхней части экрана.
+
+ <preference name="ShowTitle" value="true"/>
+
+
+* `LogLevel` (строка, по умолчанию `ERROR` ): устанавливает минимальный уровень протоколирования, через который будет фильтроваться протоколируемые сообщения из вашего приложения. Допустимыми значениями являются `ERROR`, `WARN`, `INFO`, `DEBUG`, и `VERBOSE`.
+
+ <preference name="LogLevel" value="VERBOSE"/>
\ No newline at end of file
diff --git a/docs/ru/5.0.0/guide/platforms/amazonfireos/index.md b/docs/ru/5.0.0/guide/platforms/amazonfireos/index.md
new file mode 100644
index 0000000..cfb0801
--- /dev/null
+++ b/docs/ru/5.0.0/guide/platforms/amazonfireos/index.md
@@ -0,0 +1,189 @@
+---
+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.
+---
+
+# Руководство для платформы Amazon Fire OS
+
+В этом руководстве показано, как настроить среду разработки SDK для развертывания приложений Cordova на устройства Amazon Fire ОС, такие как Kindle Fire HDX.
+
+Смотрите ниже для более подробной информации конкретной платформы:
+
+* Настройка Amazon Fire OS
+* WebView в Amazon Fire OS
+* Плагины для Amazon Fire OS
+
+## Введение
+
+По ориентации платформы Amazon Fire OS, Кордова разработчики могут создавать гибридные веб-приложения, использующие преимущества передовых веб двигателя интегрированы устройства Kindle Fire. Amazon WebView API (AWV) является средой выполнения производных хрома веб эксклюзивные огонь ОС. Дроп-ин замены WebView, который поставляется с Android-устройств, AWV делает возможным для создания лучшего выполнения и более мощные гибридных веб-приложений, предоставляя поддержку для более быстрый движок JavaScript (V8), удаленной отладки и оптимизации аппаратного обеспечения для устройств Kindle Fire, включая ускоренной 2D холст, и доступ к HTML5 функций, не поддерживаемых Android построен в WebView, такие как: Calc CSS, формы проверки, getUserMedia, IndexedDB, рабочих веб-процессов, WebSockets и WebGL.
+
+Дополнительные сведения об интерфейсе API WebView Амазонки смотрите Амазонки портал разработчика [страницы HTML5 гибридных приложений][1]. Для вопросов о получении работы и другие вопросы поддержки, пожалуйста, смотрите на портал разработчика Амазонки [форумы - гибридных приложений HTML5][2].
+
+ [1]: https://developer.amazon.com/public/solutions/platforms/android-fireos/docs/building-and-testing-your-hybrid-app
+ [2]: http://forums.developer.amazon.com/forums/category.jspa?categoryID=41
+
+## Требования и поддержка
+
+Разработка приложений Cordova для Amazon Fire ОС требует установки различных файлов поддержки, включая все необходимое для разработки Android, а также Amazon WebView SDK. Проверьте список ниже для требуемых установок:
+
+* Интерфейс командной строки
+* [Android SDK][3]
+* [Apache Ant][4]
+* [Amazon WebView SDK][1]
+
+ [3]: http://developer.android.com/sdk/
+ [4]: http://ant.apache.org
+
+## Установка
+
+### Android SDK и Apache Ant
+
+Установите Android SDK с сайта [developer.android.com/sdk][3]. Вам может быть представлен выбор куда установить SDK, в противном случае переместить загруженный каталог `adt-bundle`, туда где вы храните средства разработки.
+
+Вам нужно запустить Android SDK Manager ( `android` из командной строки) по крайней мере один раз перед началом проекта Кордова. Убедитесь в том установить самую последнюю версию Android SDK инструменты и SDK платформы **специально API уровня 19**. Пожалуйста, смотрите [настройки вашей среды разработки][5] на портале разработчика Амазонки для получения дополнительных сведений о настройке среды разработки для устройств Kindle Fire OS.
+
+ [5]: https://developer.amazon.com/public/resources/development-tools/ide-tools/tech-docs/01-setting-up-your-development-environment
+
+Установка Apache Ant построить инструмент [загрузки бинарного дистрибутива муравей][6], распаковки в директорию, в которую можно обратиться позднее. Смотрите [муравей руководство][7] для получения дополнительной информации.
+
+ [6]: http://ant.apache.org/bindownload.cgi
+ [7]: http://ant.apache.org/manual/index.html
+
+Для Кордова средства командной строки для работы, вам необходимо включить Android SDK `tools` , `platform-tools` и `apache-ant/bin` каталогов в среде PATH.
+
+#### Путь Mac/Linux
+
+На Mac, Linux или других Unix подобных платформах, вы можете использовать текстовый редактор для создания или изменения `~/.bash_profile` файл, добавив строку, например, в зависимости от того, где установлен пакет SDK и муравей:
+
+ экспорт путь = ${путь}: / развития/АТД Комплект/sdk/платформы tools: / развития/АТД Комплект/sdk/инструменты: / развитие/apache муравей/bin
+
+
+Это предоставляет доступ к средствам SDK во вновь открытом терминале Windows. В противном случае выполните нижеуказанную команду, чтобы сделать изменения доступными в текущем сеансе:
+
+ $ source ~/.bash_profile
+
+
+#### Путь к каталогу Windows
+
+Чтобы изменить путь среды на Windows:
+
+* Нажмите на меню " **Пуск** " в левом нижнем углу рабочего стола, щелкните правой кнопкой мыши на **Мой комьютер**, а затем нажмите кнопку **Свойства**.
+
+* Нажмите кнопку **Дополнительные параметры системы** в столбце слева.
+
+* В открывшемся диалоговом нажмите **Переменные среды**.
+
+* Выберите переменную **PATH** и нажмите **редактировать**.
+
+* Добавьте следующее в путь, основанный на где вы установили SDK и муравей, например:
+
+ ;C:\Development\adt-bundle\sdk\platform-tools;C:\Development\adt-bundle\sdk\tools;C:\Development\apache-ant\bin
+
+
+* Сохраните значение и закройте оба диалоговые окна.
+
+* Вам также нужно будет включить Java. Откройте командную строку и введите `java` , если она не запущена, добавить местоположение двоичных файлов Java в ваш путь также. Убедитесь, что JAVA_HOME % указывает установленный каталог JDK. Возможно, вам придется добавить среды JAVA_HOME переменной отдельно.
+
+ ; %JAVA_HOME%\bin
+
+
+### Amazon WebView SDK
+
+Для создания приложений Cordova целевой платформы Amazon Fire ОС, вам нужно скачать, распаковать и установить файлы поддержки Amazon WebView SDK. Этот шаг нужно будет только сделать для вашего первого проекта Amazon Fire OS.
+
+* Скачать Амазонка WebView SDK от [Amazon разработчик портала][1].
+
+* Копия `awv_interface.jar` из загруженного пакета SDK Кордова в рабочий каталог. Создайте папку commonlibs(shown below), если он не существует:
+
+ **Mac/Linux:** `~/.cordova/lib/commonlibs/`
+
+ **Windows:** `%USERPROFILE%\.cordova\lib\commonlibs`
+
+## Создайте новый проект для Amazon Fire ОС
+
+Используйте утилиту `cordova` для настройки нового проекта, как описано в разделе "Интерфейс командной строки Cordova". Например выполните в каталоге исходного кода:
+
+ $ cordova create hello com.example.hello "HelloWorld"
+ $ cd hello
+ $ cordova platform add amazon-fireos
+ $ cordova build
+
+
+***Примечание:*** В первый раз Амазонки fireos платформа установлена на вашей системе, он загрузит соответствующие файлы в рабочий каталог Cordova, но будет потом не как не хватает файлов поддержки AWV SDK (см. выше). Следуйте приведенным выше инструкциям, чтобы установить `awv_interface.jar` , затем удалить и повторно добавить Амазонки fireos платформа для вашего проекта. Этот шаг нужно будет только сделать для первого проекта Amazon Fire OS.
+
+## Развертывание на устройство
+
+Для публикации приложение непосредственно на устройство, убедитесь, что включена отладка USB на вашем устройстве, как описано на [сайте разработчика Android][8] и используя кабель мини-USB, подключите устройство к вашей системе.
+
+ [8]: http://developer.android.com/tools/device.html
+
+Вы можете опубликовать приложение на устройство из командной строки:
+
+ $ cordova запускать Амазонки fireos
+
+
+Альтернативно в Eclipse, щелкните правой кнопкой мыши проект и выберите **выполнить как → приложения для Android**.
+
+**Примечание**: в настоящее время тестирование через эмулятор не поддерживается для Amazon WebView на основе приложения, дополнительно Амазонки WebView API доступна только на огонь OS устройств. Для получения дополнительной информации смотрите в документации [SDK API WebView Амазонки][1] .
+
+### Запуск флаги
+
+Команда run принимает необязательные параметры, как указано в документе Cordova интерфейс командной строки, огонь OS также принимает дополнительные `--debug` флаг, который позволит хрома в инструменты разработчика для отладки удаленного веб.
+
+Чтобы использовать средства разработчика, введите:
+
+ $ cordova run --debug amazon-fireos
+
+
+Это даст возможность средства на запуск клиента. Вы можете подключиться к клиенту по переадресации портов с помощью Android Debug Bridge (АБР) ссылаясь на имя пакета приложения.
+
+Например:
+
+ АБР вперед tcp:9222 localabstract:com.example.helloworld.devtools
+
+
+Затем можно использовать DevTools через браузер на основе Chromium, перейдя на:`http://localhost:9222`.
+
+### Опциональная поддержка Eclipse
+
+После создания, можно использовать Eclipse, которая приходит вместе с Android SDK, чтобы изменить проект. Помните, что изменения, сделанные через Eclipse будут перезаписаны, если вы продолжаете использовать инструменты командной строки Кордова.
+
+* Запустите приложение **Eclipse** .
+
+* Выберите пункт меню **Создать проект** .
+
+* Выберите **Android-проект из существующего кода** из диалогового окна полученный и нажмите **Далее**: ![][9]
+
+* Перейдите к `hello` , или какой был создан каталог для проекта, затем в подкаталог `platforms/amazon-fireos`.
+
+* Затмение покажет вам привет и Привет CorddovaLib - 2 проектов для добавления. Добавьте оба.
+
+* Нажмите кнопку **Готово**.
+
+ [9]: img/guide/platforms/android/eclipse_new_project.png
+
+После того, как откроется окно Eclipse, красный **X** может показаться, указывая на нерешенные проблемы. Если это так, выполните следующие дополнительные действия:
+
+* Щелкните правой кнопкой мыши на папке проекта.
+
+* В результате диалоговом окне **Свойства** выберите **Android** из области переходов.
+
+* Для целевого объекта build проекта выберите самый высокий уровень Android API (в настоящее время API уровня 19) у вас установлена.
+
+* Нажмите **кнопку ОК**.
+
+* Выберите **Очистить** из меню **Проект** . Это должно исправить все ошибки в проекте.
\ No newline at end of file
diff --git a/docs/ru/5.0.0/guide/platforms/amazonfireos/plugin.md b/docs/ru/5.0.0/guide/platforms/amazonfireos/plugin.md
new file mode 100644
index 0000000..674ae1f
--- /dev/null
+++ b/docs/ru/5.0.0/guide/platforms/amazonfireos/plugin.md
@@ -0,0 +1,103 @@
+---
+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.
+---
+
+# Плагины для Amazon Fire OS
+
+Следуйте инструкциям, приведенным в разделе "Справочник плагинов Android" для информации о разработке пользовательских плагинов.
+
+## Пример плагина Amazon Fire OS Эхо
+
+Для сопоставления интерфейса JavaScript функция *echo*, описанная в разделе "Плагины приложения", используйте `plugin.xml` для вставки спецификации `feature` в файл `config.xml` платформы:
+
+ <platform name="amazon-fireos">
+ <config-file target="config.xml" parent="/*">
+ <feature name="Echo">
+ <param name="android-package" value="org.apache.cordova.plugin.Echo"/>
+ </feature>
+ </config-file>
+ </platform>
+
+
+Затем добавить следующий файл `src/org/apache/cordova/plugin/Echo.java`:
+
+ package org.apache.cordova.plugin;
+
+ import org.apache.cordova.CordovaPlugin;
+ import org.apache.cordova.CallbackContext;
+
+ import org.json.JSONArray;
+ import org.json.JSONException;
+ import org.json.JSONObject;
+
+ /**
+ * This class echoes a string called from JavaScript.
+ */
+ public class Echo extends CordovaPlugin {
+
+ @Override
+ public boolean execute(String action, JSONArray args, CallbackContext callbackContext) throws JSONException {
+ if (action.equals("echo")) {
+ String message = args.getString(0);
+ this.echo(message, callbackContext);
+ return true;
+ }
+ return false;
+ }
+
+ private void echo(String message, CallbackContext callbackContext) {
+ if (message != null && message.length() > 0) {
+ callbackContext.success(message);
+ } else {
+ callbackContext.error("Expected one non-empty string argument.");
+ }
+ }
+ }
+
+
+Если вы хотите повторно использовать код плагина Android для платформы Amazon Fire OS, измените plugin.xml так чтобы он указывал на исходный файл в папке `android`. Например,
+
+ <platform name="amazon-fireos">
+ <config-file target="config.xml" parent="/*">
+ <feature name="Echo">
+ <param name="android-package" value="org.apache.cordova.plugin.Echo"/>
+ </feature>
+ </config-file>
+ <source-file src="src/android/Echo.java" target-dir="src/org/apache/cordova/plugin" />
+ </platform>
+
+
+Если вы хотите написать плагин, специализироавнный для платформы Amazon Fire OS, создайте папку с именем `amazon` под ваш плагин src/ папку и изменить plugin.xml на исходный файл в каталоге `amazon`. Например,
+
+ <platform name="amazon-fireos">
+ <config-file target="config.xml" parent="/*">
+ <feature name="Echo">
+ <param name="android-package" value="org.apache.cordova.plugin.Echo"/>
+ </feature>
+ </config-file>
+ <source-file src="src/amazon/Echo.java" target-dir="src/org/apache/cordova/plugin" />
+ </platform>
+
+
+## Использование Amazon WebView в вашем плагине
+
+Cordova для Amazon Fire OS использует пользовательские Amazon WebView, который построен на открытым исходным кодом проекта Chromium. Он обеспечивает GPU ускорение и оптимизирован для плавной производительности на Kindle Fire.
+
+Чтобы понять, как наилучшим образом использовать Amazon WebView в вашем проекте, посетите [Портал разработчиков Amazon][1].
+
+ [1]: https://developer.amazon.com/sdk/fire/IntegratingAWV.html
\ No newline at end of file
diff --git a/docs/ru/5.0.0/guide/platforms/amazonfireos/webview.md b/docs/ru/5.0.0/guide/platforms/amazonfireos/webview.md
new file mode 100644
index 0000000..8974951
--- /dev/null
+++ b/docs/ru/5.0.0/guide/platforms/amazonfireos/webview.md
@@ -0,0 +1,126 @@
+---
+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.
+---
+
+# WebView в Amazon Fire OS
+
+Начиная с 3.3.0, Cordova можно использовать в качестве компонента приложений Amazon Fire OS. Amazon Fire ОС ссылается на этот компонент как `CordovaWebView` . `CordovaWebView` расширяет Amazon WebView, который построен на открытом исходном коде проекта Chromium. Используя эту функцию, веб-приложений можно использовать последние веб-стандарты HTML5, работающие в современной веб среде.
+
+Если вы не знакомы с Amazon Fire ОС, необходимо сначала ознакомиться с руководством ОС платформы Amazon огонь и установили последнюю SDK, прежде чем пытаться более необычный вариант развития встраивания WebView.
+
+## Необходимые условия
+
+* Кордова 3.3.0 или больше
+
+* Android SDK, последней версии
+
+* Amazon WebView SDK
+
+## Руководство по использованию CordovaWebView в проекте OS Amazon Fire
+
+1. Следовать этим инструкциям, убедитесь, что у вас есть дистрибутив последней Кордова. Скачать его с [cordova.apache.org][1] и распакуйте его пакет Amazon Fire OS.
+
+2. Скачать и распаковать [Amazon WebView SDK][2], затем скопируйте awv_interface.jar в каталог `/framework/libs`. Создайте каталог libs/, если он не существует.
+
+3. Перейдите к пакету `/framework` директорию и запустить `ant jar` . Он создаёт Кордова `.jar` файл, как`/framework/cordova-x.x.x.jar`.
+
+4. Скопируйте файл `.jar` в каталог `/libs` Android-проекта.
+
+5. Добавьте в приложение следующий файл `/res/xml/main.xml`, с `layout_height`, `layout_width` и `id` модицифированными в соответствии с нуждами приложения:
+
+ <org.apache.cordova.CordovaWebView
+ android:id="@+id/tutorialView"
+ android:layout_width="match_parent"
+ android:layout_height="match_parent" />
+
+
+6. Измените вашу деятельность так, чтобы этот класс реализовал `CordovaInterface` . Вы должны реализовать описанные методы этого интерфейса. Вы можете скопировать их из `/framework/src/org/apache/cordova/CordovaActivity.java`, или реализовать их самостоятельно. Нижеуказанный фрагмент кода показывает простое приложение , которое использует интерфейс. Обратите внимание, что id упоминаемого окна соответствует `id` атрибут, указанный в XML-фрагменте показаном выше:
+
+ public class CordovaViewTestActivity extends Activity implements CordovaInterface {
+ CordovaWebView cwv;
+ /* Called when the activity is first created. */
+ @Override
+ public void onCreate(Bundle savedInstanceState) {
+ super.onCreate(savedInstanceState);
+ setContentView(R.layout.main);
+ cwv = (CordovaWebView) findViewById(R.id.tutorialView);
+ Config.init(this);
+ cwv.loadUrl(Config.getStartUrl());
+ }
+
+
+ [1]: http://cordova.apache.org
+ [2]: https://developer.amazon.com/sdk/fire/IntegratingAWV.html#installawv
+
+Если вы используете камеру, следует также реализовать следующее:
+
+ @Override
+ public void setActivityResultCallback(CordovaPlugin plugin) {
+ this.activityResultCallback = plugin;
+ }
+ /**
+ * Launch an activity for which you would like a result when it finished. When this activity exits,
+ * your onActivityResult() method is called.
+ *
+ * @param command The command object
+ * @param intent The intent to start
+ * @param requestCode The request code that is passed to callback to identify the activity
+ */
+ public void startActivityForResult(CordovaPlugin command, Intent intent, int requestCode) {
+ this.activityResultCallback = command;
+ this.activityResultKeepRunning = this.keepRunning;
+
+ // If multitasking turned on, then disable it for activities that return results
+ if (command != null) {
+ this.keepRunning = false;
+ }
+
+ // Start activity
+ super.startActivityForResult(intent, requestCode);
+ }
+
+ @Override
+ /**
+ * Called when an activity you launched exits, giving you the requestCode you started it with,
+ * the resultCode it returned, and any additional data from it.
+ *
+ * @param requestCode The request code originally supplied to startActivityForResult(),
+ * allowing you to identify who this result came from.
+ * @param resultCode The integer result code returned by the child activity through its setResult().
+ * @param data An Intent, which can return result data to the caller (various data can be attached to Intent "extras").
+ */
+ protected void onActivityResult(int requestCode, int resultCode, Intent intent) {
+ super.onActivityResult(requestCode, resultCode, intent);
+ CordovaPlugin callback = this.activityResultCallback;
+ if (callback != null) {
+ callback.onActivityResult(requestCode, resultCode, intent);
+ }
+ }
+
+
+Наконец, не забудьте добавить пул потоков, в противном случае у плагинов не будет потоков где можно будет выполняться:
+
+ @Override
+ public ExecutorService getThreadPool() {
+ return threadPool;
+ }
+
+
+1. Скопировать HTML и JavaScript файлы приложения в каталог `/assets/www` проекта Amazon Fire OS.
+
+2. Скопируйте `config.xml` из `/framework/res/xml` для в каталог `/res/xml` вашего проекта.
\ No newline at end of file
diff --git a/docs/ru/5.0.0/guide/platforms/android/config.md b/docs/ru/5.0.0/guide/platforms/android/config.md
new file mode 100644
index 0000000..ec87514
--- /dev/null
+++ b/docs/ru/5.0.0/guide/platforms/android/config.md
@@ -0,0 +1,83 @@
+---
+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.
+---
+
+# Конфигурация Android
+
+Файл `config.xml` управляет основные параметрами приложения, которые применяются к каждому приложению и экземпляру CordovaWebView. Этот раздел описывает настройки, которые применяются только к построениям для Android. Смотрите [Файл config.xml][1] для получения информации о глобальных параметрах конфигурации.
+
+ [1]: config_ref_index.md.html#The%20config.xml%20File
+
+* `KeepRunning` (логическое значение, по умолчанию `true` ): определяет, остается ли приложение работает в фоновом режиме после вызова события `pause`. Установка значения в `false` не завершает приложение после события `pause`, но просто останавливает выполнение кода в Cordova WebView в то время пока приложение находится в фоновом режиме.
+
+ <preference name="KeepRunning" value="false"/>
+
+
+* `LoadUrlTimeoutValue` (число, значение по умолчанию — `20000`): при загрузке страницы, указывает продолжительность времени ожидания в миллисекундах, перед тем как произойдет ошибка ожидания. Этот пример определяет 10 секунд, а не 20:
+
+ <preference name="LoadUrlTimeoutValue" value="10000"/>
+
+
+* `SplashScreen`(строка, по умолчанию `splash`): Имя файла, минус его расширение в каталоге `res/drawable`. Различные ресурсы должны использовать это общее название в разных подкаталогах.
+
+ <preference name="SplashScreen" value="mySplash"/>
+
+
+* `SplashScreenDelay` (число, значение по умолчанию `3000`): определяет количество времени в течение которого отображается заставка.
+
+ <preference name="SplashScreenDelay" value="10000"/>
+
+
+* `InAppBrowserStorageEnabled` (логическое значение, по умолчанию `true`): Контролирует имеют ли страницы открытые в InAppBrowser возможность получить доступ к тому же хранилищу localStorage и WebSQL, что и страницы открытые с помощью браузера по умолчанию.
+
+ <preference name="InAppBrowserStorageEnabled" value="true"/>
+
+
+* `LoadingDialog` (строка, по умолчанию `null`): Если указано, отображает диалоговое окно с заданным заголовком и сообщение и индикатор загрузки, при загрузке первой странице приложения. Заголовок и сообщение разделяются запятой в этой строке значение, и что запятая удаляется перед отображением диалогового окна.
+
+ <preference name="LoadingDialog" value="My Title,My Message"/>
+
+
+* `LoadingPageDialog` (строки, по умолчанию `null`): так же, как `LoadingDialog`, но для загрузки каждой страницы следующей за первой страницей в приложении.
+
+ <preference name="LoadingPageDialog" value="My Title,My Message"/>
+
+
+* `ErrorUrl` (URL-адрес, По умолчанию используется `null`): Если установлено, будет отображаться странице ссылки на ошибку в приложении вместо диалоговое окно с заголовком «Ошибка приложения».
+
+ <preference name="ErrorUrl" value="myErrorPage.html"/>
+
+
+* `ShowTitle` (логическое значение, по умолчанию `false`): Показать заголовок в верхней части экрана.
+
+ <preference name="ShowTitle" value="true"/>
+
+
+* `LogLevel` (строка, по умолчанию `ERROR` ): устанавливает минимальный уровень протоколирования, через который будет фильтроваться протоколируемые сообщения из вашего приложения. Допустимыми значениями являются `ERROR`, `WARN`, `INFO`, `DEBUG`, и `VERBOSE`.
+
+ <preference name="LogLevel" value="VERBOSE"/>
+
+
+* `SetFullscreen` (логическое значение, по умолчанию `false`): то же, что параметр `Fullscreen` в глобальной конфигурации этого XML-файла. Этот элемент специфический для Android элемент считается устаревшим и замененным глобальным элементом `Fullscreen` и будет удален в будущей версии.
+
+* `AndroidLaunchMode`(строки, по умолчанию `singleTop` ): задает действие `android:launchMode` атрибут. Это меняет то, что происходит, когда приложение запускается из приложения значок или намерения и уже работает. Допустимыми значениями являются `standard` , `singleTop` , `singleTask` ,`singleInstance`.
+
+ <preference name="AndroidLaunchMode" value="singleTop"/>
+
+
+* `DefaultVolumeStream`(строки, по умолчанию `default` , добавил в Кордова android 3.7.0): устанавливает объем которых объем аппаратные кнопки ссылка на. По умолчанию это «вызов» для «СМИ» для планшетов и телефонов. Установите это для «медиа», чтобы иметь всегда изменить громкость медиа кнопки громкости вашего приложения. Обратите внимание, что при использовании плагина Кордова в СМИ, кнопки громкости будет динамически изменить для контроля объема средств массовой информации, когда любые мультимедийные объекты являются активными.
\ No newline at end of file
diff --git a/docs/ru/5.0.0/guide/platforms/android/index.md b/docs/ru/5.0.0/guide/platforms/android/index.md
new file mode 100644
index 0000000..5bad2f8
--- /dev/null
+++ b/docs/ru/5.0.0/guide/platforms/android/index.md
@@ -0,0 +1,272 @@
+---
+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.
+---
+
+# Руководство для платформы Android
+
+В этом руководстве показано, как настроить среду SDK для развертывания приложений Cordova для устройств на базе Android и как при необходимости использовать специфические для Android средства командной строки в вашем рабочем процессе построения приложений. Вам нужно установить Android SDK независимо от того, хотите ли вы использовать эти инструменты или использовать кросс-платформенный Cordova CLI для построения приложения. Для сравнения двух вариантов разработки см. Обзор. Дополнительные сведения о CLI, см. "Интерфейс командной строки".
+
+## Требования и поддержка
+
+Cordova для Android необходим Android SDK, который может быть установлен на операционных системах OS X, Linux или Windows. Смотрите [системные требования][1] Android SDK.
+
+ [1]: http://developer.android.com/sdk/index.html#Requirements
+
+Cordova поддерживает Android 4.0.x (начиная с уровня Android API 14) и выше. Как правило версии Android перестают поддерживается Cordova после того как они опустится ниже 5% на [панель распространения][2] Google . Версии Android менее чем API уровня 10, и версии 3.x (Honeycomb, уровни API 11-13) упали значительно ниже этого 5%-го порога.
+
+ [2]: http://developer.android.com/about/dashboards/index.html
+
+## Установка инструментов Cordova
+
+Если вы хотите использовать Android-ориентированные инструменты Cordova совместно с SDK, скачайте Cordova с [cordova.apache.org][3]. В противном случае этот раздел можно проигнорировать, если вы планируете использовать кросс-платформенное средство CLI, описанное в разделе "Интерфейс командной строки".
+
+ [3]: http://cordova.apache.org
+
+Страница для скачивания Cordova содержит различные архивы для каждой платформы. Убедитесь в том распаковываете соответствующий архив, `android` в данном случае, в пустой каталог. Соотвествующие выполняемые утилиты будут доступны в каталоге `bin` верхнего уровня. (Обратитесь при необходимости к **README** файлу за более подробными инструкциями.)
+
+Эти инструменты командной строки позволят вам создавать, собирать и запускать приложения для Android. За информаций о дополнительных интерфейсах командной строки которые позволяют встраивать возможности плагинов среди разных платформ, смотрите раздел "Использование Plugman для управления плагинами". Смотрите раздел "Плагины приложения" для детальной информации о том как разрабатывать плагины.
+
+## Установите Java Development Kit (JDK)
+
+Установить [Java Development Kit (JDK) 7][4] или более поздней версии.
+
+ [4]: http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html
+
+При установке на Windows, необходимо также задать переменную окружающей среды `JAVA_HOME` в соотвествии с каталогом установки JDK (например, C:\Program Files\Java\jdk1.7.0_75).
+
+## Установить Android SDK
+
+Установите [SDK Android Stand-alone SDK Tools][5] или [Android Studio][6]. Продолжите с `Android Studio` если планируется разработка новых плагинов Cordova для Android или использовать встроенных средств для запуска и отладки на Android платформе. В противном случае `Android Stand-alone SDK Tools` вполне достаточно для построения и развертывания приложения на Android.
+
+ [5]: http://developer.android.com/sdk/installing/index.html?pkg=tools
+ [6]: http://developer.android.com/sdk/installing/index.html?pkg=studio
+
+Подробные инструкции по установке доступны как часть установки.
+
+Чтобы инструменты командной строки Cordova работали, или другое CLI которое основано на них, вам необходимо включить каталоги SDK `tools` и `platform-tools` в вашу переменную окружения `PATH`. На Mac, вы можете использовать текстовый редактор для создания или изменения файла `~/.bash_profile`, добавив линию, наподобие нижеуказанной, в зависимости от того где установлен SDK:
+
+ export PATH=${PATH}:/Development/android-sdk/platform-tools:/Development/android-sdk/tools
+
+
+Эта строка в `~/.bash_profile` добавляет эти инструменты во вновь открытых окнах терминала. Если ваше окно терминала уже открыт в OSX, или чтобы избежать процедуры выхода/входа на Linux, выполните ниже указанную команду, чтобы сделать эти инструменты доступными в текущем окне терминала:
+
+ $ источника ~/.bash_profile
+
+
+Чтобы изменить переменную окружения `PATH` на Windows 7:
+
+1. Нажмите на меню " **Пуск** " в левом нижнем углу рабочего стола, щелкните правой кнопкой мыши на **Мой комьютер**, а затем нажмите кнопку **Свойства**.
+
+2. Нажмите кнопку **Дополнительные параметры системы** в столбце слева.
+
+3. В открывшемся диалоговом нажмите **Переменные среды**.
+
+4. Выберите переменную **PATH** и нажмите **редактировать**.
+
+5. Добавьте следующее в `PATH`, в зависимости от того куда был установлен пакет SDK, например:
+
+ ;C:\Development\android-sdk\platform-tools;C:\Development\android-sdk\tools
+
+
+6. Сохраните значение и закройте оба диалоговые окна.
+
+## Установить пакеты SDK
+
+Откройте Android SDK Manager (например, через терминал: `android`) и установить:
+
+1. Android 5.1.1 (API 22) platform SDK
+2. Android SDK Build-tools version 19.1.0 или выше
+3. Android Support Repository (Extras)
+
+Смотрите [Установка пакетов SDK][7] для получения более подробной информации.
+
+ [7]: http://developer.android.com/sdk/installing/adding-packages.html
+
+## Настройка эмулятора
+
+По умолчанию Android sdk не предоставляет никаких эмуляторов. Вы можете создать новый, запустив `android` в командной строке. Выбрать **Tools → Manage AVDs** (Android Virtual Devices), затем выберите любой элемент из **Device Definitions** в появившемся диалоговом окне:
+
+![][8]
+
+ [8]: img/guide/platforms/android/asdk_device.png
+
+Нажмите **Create AVD**, при необходимости изменяя имя, затем нажмите **ОК**, чтобы принять изменения:
+
+![][9]
+
+ [9]: img/guide/platforms/android/asdk_newAVD.png
+
+После этого AVD появляется в списке **Android Virtual Devices**:
+
+![][10]
+
+ [10]: img/guide/platforms/android/asdk_avds.png
+
+Чтобы открыть эмулятор как отдельное приложение, выберите AVD и нажать кнопку **Start**. Android запускается, также как он запускается на устройстве, с дополнительные элементы управления, доступными для аппаратных кнопок:
+
+![][11]
+
+ [11]: img/guide/platforms/android/asdk_emulator.png
+
+Для более быстрый восприятия можно использовать `Ускорение виртуальной машины` для повышения скорости выполнения. Многие современные процессоры предоставляют расширения для выполнения виртуальных машин более эффективно. Прежде чем пытаться использовать этот тип ускорения, необходимо определить, поддерживает ли процессор вашей текущей системы развития, одну из следующих технологий виртуализации:
+
+* **Технология Виртуализации Intel** (VT-x, vmx) → [Список процессоров поддерживающих Intel VT-x][12]
+* **Виртуализация AMD** (AMD-V, SVM), поддерживается только Linux (начиная с May 2006, все процессоры AMD включают AMD-V, за исключением Sempron).
+
+ [12]: http://ark.intel.com/products/virtualizationtechnology
+
+Еще один способ узнать, если ваш процессор поддерживает технологию VT-x, это путем выполнения `Утилита идентификации процессора Intel`, для `Windows` вы можете скачать ее с сайта [Центр загрузки Intel ][13], или можно использовать [утилиту booteable][14], который является `ОС-независимой`.
+
+ [13]: https://downloadcenter.intel.com/Detail_Desc.aspx?ProductID=1881&DwnldID=7838
+ [14]: https://downloadcenter.intel.com/Detail_Desc.aspx?ProductID=1881&DwnldID=7840&lang=eng
+
+После установки и выполнения `Утилита идентификации процессора Intel` в Windows, вы получите следующее окно, чтобы проверить, поддерживает ли ваш процессор технологии виртуализации:
+
+![][15]
+
+ [15]: img/guide/platforms/android/intel_pid_util_620px.png
+
+Для того, чтобы ускорить эмулятор, вам нужно скачать и установить один или несколько образов системы `Intel x86 Atom`, а также `Менеджер выполнения аппаратного ускорения Intel (HAXM)`.
+
+Откройте ваш Android SDK Manager и выберите образ системы `Intel x86 Atom`, для той версии, которую вы хотите проверить. Затем перейдите в раздел `Extras` и выберите `Intel x86 Emulator Accelerator (HAXM)` и установить эти пакеты:
+
+![][16]
+
+ [16]: img/guide/platforms/android/asdk_man_intel_image_haxm.png
+
+После загрузки, запустите инсталлятор Intel, который доступен в вашем Android SDK в каталоге `extras/intel/Hardware_Accelerated_Execution_Manager`. **Примечание**: `Если у вас есть проблемы с установкой пакета, вы можете найти более подробную информацию и пошаговое руководство в этой` [статье Intel][17].
+
+ [17]: http://software.intel.com/en-us/android/articles/speeding-up-the-android-emulator-on-intel-architecture
+
+1. Установить одно или несколько образов системы `Intel x86 Atom`, а также `Intel Hardware Accelerated Execution Manager`, доступных в разделе **Extras**.
+
+2. Запустите инсталлятор Intel, который доступен в вашем Android SDK в каталоге `extras/intel/Hardware_Accelerated_Execution_Manager`.
+
+3. Создайте новый AVD с выбрав в качестве цели образ Intel.
+
+4. При запуске эмулятора, удостоверьтесь что нет сообщений об ошибке, указывающих на сбой загрузки модулей HAX.
+
+## Создание нового проекта
+
+На данный момент для создания нового проекта можно выбрать между кросс-платформенным инструментом CLI, описанным в разделе "Интерфейс командной строки", или набор Android-ориентированных инструментов. Из каталога с исходным кодом, вот подход CLI:
+
+ $ cordova create hello com.example.hello HelloWorld
+ $ cd hello
+ $ cordova platform add android
+ $ ccordova prepare # or "cordova build"
+
+
+Вот соотвествующий низкоуровневый подход для Unix и Windows:
+
+ $ /path/to/cordova-android/bin/create /path/to/new/hello com.example.hello HelloWorld
+ C:\path\to\cordova-android\bin\create.bat C:\path\to\new\hello com.example.hello HelloWorld
+
+
+## Построение проекта
+
+Если вы используете CLI для разработки, каталога `www` проекта содержит исходные файлы. Запустите любой из нижеследующего в каталоге проекта для перепостроения приложения:
+
+ $ cordova build # build all platforms that were added
+ $ cordova build android # build debug for only Android
+ $ cordova build android --debug # build debug for only Android
+ $ cordova build android --release # build release for only Android
+
+
+Если вы используете Android-ориентированные инструментыв разработке, используйте другой подход. После того как вы создали проект, исходный код приложения по умолчанию доступен в подкаталоге `assets/www`. Последующие команды доступны в подкаталоге `cordova` проекта.
+
+Команда `build` очищает файлы проекта и перестраивает приложение. Вот синтаксис для Mac и Windows. Первая пара примеров создает отладочную информацию, и второй подписывает приложения для релиза:
+
+ $ /path/to/project/cordova/build --debug
+ C:\path\to\project\cordova\build.bat --debug
+
+ $ /path/to/project/cordova/build --release
+ C:\path\to\project\cordova\build.bat --release
+
+
+## Развертывание приложения
+
+Чтобы развернуть приложение на эмуляторе или устройстве из командной строки можно использовать утилиту CLI `cordova` :
+
+ $ cordova emulate android #to deploy the app on a default iOS emulator
+ $ cordova run android --device #to deploy the app on a connected device
+
+
+В противном случае используйте интерфейс альтернативной оболочки:
+
+ $ /path/to/project/cordova/run --emulator
+ $ /path/to/project/cordova/run --device
+
+
+Можно использовать **cordova run android --list** чтобы увидеть все доступные цели и **cordova run android --target=имя_устройства** для запуска приложения на конкретном устройстве или эмуляторе (например, `cordova run android --target="Nexus4_emulator"`).
+
+Чтобы увидеть дополнительные параметры построения и запуска также можно использовать **cordova run --help**.
+
+Эта команда установаливает приложение на главной странице и запускает его:
+
+![][18]
+
+ [18]: img/guide/platforms/android/emulator2x.png
+
+Когда вы запускаете приложение с помощью `run`, вы также собираете его с помощью `build` автоматически. Вы можете добавить дополнительные флаги `--debug`, `--release`, и `--nobuild` для управления как приложение будет построен, или даже когда перепостроение необходимо:
+
+ $ /path/to/project/cordova/run --emulator --nobuild
+
+
+## Другие команды
+
+Следующие команды задают детальное протоколирование приложения, во время его работы:
+
+ $ /path/to/project/cordova/log
+ C:\path\to\project\cordova\log.bat
+
+
+Следующие команды очищают файлы проекта:
+
+ $ /path/to/project/cordova/clean
+ C:\path\to\project\cordova\clean.bat
+
+
+## Откройте новый проект в SDK
+
+После того, как платформа android добавлена в ваш проект, вы можете открыть проект в [Android Studio][6]:
+
+1. Запустите приложение **Android Studio** .
+
+2. Выберите пункт **Import Project (Eclipse ADT, Gradle, etc)**.
+
+ ![][19]
+
+3. Выберите местоположение, где платформа android сохраняется (`ваш/каталог/проекта/platforms/android`).
+
+ ![][20]
+
+4. Для вопроса `Gradle Sync` можно просто ответить **Yes**.
+
+ [19]: img/guide/platforms/android/asdk_import_project.png
+ [20]: img/guide/platforms/android/asdk_import_select_location.png
+
+Все готово теперь и можно построить и запустить приложение непосредственно из `Android студии`.
+
+![][21]
+
+ [21]: img/guide/platforms/android/asdk_import_done.png
+
+Увидеть [обзор Android студии][22] и и [Построение и запуск из Android студии][23] для более подробной информации.
+
+ [22]: http://developer.android.com/tools/studio/index.html
+ [23]: http://developer.android.com/tools/building/building-studio.html
\ No newline at end of file
diff --git a/docs/ru/5.0.0/guide/platforms/android/plugin.md b/docs/ru/5.0.0/guide/platforms/android/plugin.md
new file mode 100644
index 0000000..608cef4
--- /dev/null
+++ b/docs/ru/5.0.0/guide/platforms/android/plugin.md
@@ -0,0 +1,179 @@
+---
+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.
+---
+
+# Плагины для Android
+
+Этот раздел содержит сведения о том, как реализовать плагин в коде на платформе Android. Прежде чем читать этот раздел, изучите раздел "Расширения приложения" для обзора структуры плагина и его общий интерфейс JavaScript. Этот раздел продолжает демонстрировать пример *echo* плагина, который соообщается из WebView Cordova с кодом платформы и в обратную строну. Еще один пример см. также комментарии в файле [CordovaPlugin.java][1].
+
+ [1]: https://github.com/apache/cordova-android/blob/master/framework/src/org/apache/cordova/CordovaPlugin.java
+
+Android плагины основаны на проекте Cordova-Android, который состоит из Android WebView с хуками, прилагаемыми к нему. Плагины представляются как сопоставления классов в файле `config.xml`. Модуль состоит из по крайней мере из одного Java-класса, который расширяет класс `CordovaPlugin`, и переопределяющий один из его методов - `execute`. Как лучшая практика, плагин также должен обрабатывать `pause` и `resume` события, наряду с любой передачи сообщений между плагинами. Плагины с длительные запросы, фоновой активностью такие как воспроизведение мультимедиа, слушатели или внутреннее состояние следует также реализовать метод `onReset()`. Он выполняется, когда `WebView` переходит на новую страницу или обновляется, что приводит к перезагрузке JavaScript.
+
+## Сопоставление классов плагина
+
+Интерфейс JavaScript плагин использует метод `cordova.exec` следующим образом:
+
+ Exec (< successFunction >, < failFunction >, < служба >, < действия > [< args >]);
+
+
+Это маршалирует запрос от WebView к коду Android, вызывая метод `action` класса `service`, с дополнительными аргументами, передаваемые в массиве `args`.
+
+Распространяете ли вы плагин как Java-файл или файл *jar*, плагин должен быть указан в вашем файле `res/xml/config.xml` Cordova-Android приложения. См. "Расширения приложения" для получения дополнительной информации о том, как использовать файл `plugin.xml` для вставки следующего элемента `feature`:
+
+ <feature name="<service_name>">
+ <param name="android-package" value="<full_name_including_namespace>" />
+ </feature>
+
+
+Имя службы должен соответствовать той службе, которая используется в JavaScript вызове `exec`. Значение является идентификатором класса Java включая полное пространство имен. В противном случае плагин может компилировать, но по-прежнему будет недоступным для Cordova.
+
+## Инициализация плагин его жизненный цикл
+
+Один экземпляр объекта плагин создается для каждого `WebView` . Плагины не создаются до тех пор, пока они первый раз не ссылается из JavaScript вызова, за исключением если `<param>` с атрибутом `onload` имеет значение `"true"` в `config.xml` . Например:
+
+ <feature name="Echo">
+ <param name="android-package" value="<full_name_including_namespace>" />
+ <param name="onload" value="true" />
+ </feature>
+
+
+Следует использовать метод плагина `initialize` для логики инициализации плагина.
+
+ @Override
+ public void initialize(CordovaInterface cordova, CordovaWebView webView) {
+ super.initialize(cordova, webView);
+ // your init code here
+ }
+
+
+## Написание Java плагин Android
+
+Вызов из JavaScript выполняет запрос к стороне платформы, и соответствующий Java плагин привязан корректно в файле `config.xml`, но как выглядит окончательный Java-класс плагина для Android? Все, что отправляется в плагин с JavaScript функцией `exec` передается в метод класса `execute`. Большинство реализаций `execute` выглядят следующим образом:
+
+ @Override общественного boolean выполнение (строка действия, JSONArray args, CallbackContext callbackContext) бросает JSONException {если («beep".equals(action)) {this.beep(args.getLong(0));
+ callbackContext.success();
+ Возвращает значение true;
+ } Возвращает значение false; / / Возвращения ложные результаты в сообщение об ошибке «MethodNotFound».
+ }
+
+
+Параметр `action` функции JavaScript `exec` соответствует закрытому методу класса куда диспетчиризуются необязательные параметры.
+
+При перехвате исключений и возвращении ошибки, важно для ясности, чтобы ошибки возвращены в JavaScript соотвествовали именам исключений Java как можно больше.
+
+## Работа с потоками
+
+JavaScript плагине *не* выполняются в основном потоке интерфейса `WebView`, вместо этого, он работает в потоке `WebCore`, как это делает метод `execute`. Если вам нужно взаимодействовать с интерфейсом пользователя, следует использовать следующие изменения:
+
+ @Override
+ public boolean execute(String action, JSONArray args, final CallbackContext callbackContext) throws JSONException {
+ if ("beep".equals(action)) {
+ final long duration = args.getLong(0);
+ cordova.getActivity().runOnUiThread(new Runnable() {
+ public void run() {
+ ...
+ callbackContext.success(); // Thread-safe.
+ }
+ });
+ return true;
+ }
+ return false;
+ }
+
+
+Используйте следующее, если вам не нужно запускать в главном потоке интерфейсе, но не хотите также блокировать поток `WebCore`:
+
+ @Override
+ public boolean execute(String action, JSONArray args, final CallbackContext callbackContext) throws JSONException {
+ if ("beep".equals(action)) {
+ final long duration = args.getLong(0);
+ cordova.getThreadPool().execute(new Runnable() {
+ public void run() {
+ ...
+ callbackContext.success(); // Thread-safe.
+ }
+ });
+ return true;
+ }
+ return false;
+ }
+
+
+## Пример плагина Echo Android
+
+Для сопоставления интерфейса JavaScript функция *echo*, описанная в разделе "Плагины приложения", используйте `plugin.xml` для вставки спецификации `feature` в файл `config.xml` платформы:
+
+ <platform name="android">
+ <config-file target="config.xml" parent="/*">
+ <feature name="Echo">
+ <param name="android-package" value="org.apache.cordova.plugin.Echo"/>
+ </feature>
+ </config-file>
+ </platform>
+
+
+Затем добавить следующий файл `src/org/apache/cordova/plugin/Echo.java`:
+
+ package org.apache.cordova.plugin;
+
+ import org.apache.cordova.CordovaPlugin;
+ import org.apache.cordova.CallbackContext;
+
+ import org.json.JSONArray;
+ import org.json.JSONException;
+ import org.json.JSONObject;
+
+ /**
+ * This class echoes a string called from JavaScript.
+ */
+ public class Echo extends CordovaPlugin {
+
+ @Override
+ public boolean execute(String action, JSONArray args, CallbackContext callbackContext) throws JSONException {
+ if (action.equals("echo")) {
+ String message = args.getString(0);
+ this.echo(message, callbackContext);
+ return true;
+ }
+ return false;
+ }
+
+ private void echo(String message, CallbackContext callbackContext) {
+ if (message != null && message.length() > 0) {
+ callbackContext.success(message);
+ } else {
+ callbackContext.error("Expected one non-empty string argument.");
+ }
+ }
+ }
+
+
+Необходимые импорты в верхней части файла наследуют класс от `CordovaPlugin`, чей метод `execute()` переопределяется для получения сообщений от `exec()` . Метод `execute()` сначала проверяет значение `action` , для которого в этом случае есть только одно действительное значение - `echo`. Любое другое значение параметра action возвращает `false` и приводит к ошибке `INVALID_ACTION`, которая передается интерфейсу обратного вызова об ошибке на стороне JavaScript.
+
+Далее, этот метод извлекает эхо-строку, используя метод `getString` объекта `args`, определяя первый параметр передаваемый методу. После того, как значение передается в закрытый метод `echo`, это параметр проверяется, чтобы убедиться, что это не `null` и не является пустой строкой, в этом случае `callbackContext.error()` вызывает ошибку на стороне JavaScript. Если различные проверки проходят успешно, `callbackContext.success()` передает исходное значение строки `message` обратно в JavaScript в качестве параметре функции успешного вызова.
+
+## Интеграция с Android
+
+Android предоставляет систему `Intent`, которая позволяет процессам взаимодействовать друг с другом. Плагины имеют доступ к объекту `CordovaInterface`, который можно получить доступ к Android `Activity` которая запустила приложение. Это `Context` необходимые для запуска нового `Intent` Android. `CordovaInterface` позволяет плагинам запускать `Activity` для получения результата и установить функцию обратного вызова которая выполнится когда `Intent` вернутся приложению.
+
+По состоянию на Cordova 2.0, плагины больше не имеют прямого доступа к `Context` и член класса `ctx` член является устаревшим. Все `ctx` методы существуют в `Context` , так что оба `getContext()` и `getActivity()` могут возвращать требуемый объект.
+
+## Отладка Android плагинов
+
+Eclipse позволяет отлаживать плагины как исходный код Java, включенный в проект. Только последняя версия Android Developer Tools позволяет вам прикрепить исходный код к *JAR* зависимостям, так что эта функция пока не поддерживается полностью.
\ No newline at end of file
diff --git a/docs/ru/5.0.0/guide/platforms/android/tools.md b/docs/ru/5.0.0/guide/platforms/android/tools.md
new file mode 100644
index 0000000..70b2bfa
--- /dev/null
+++ b/docs/ru/5.0.0/guide/platforms/android/tools.md
@@ -0,0 +1,190 @@
+---
+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.
+---
+
+# Руководство по инструментам командной строки Android
+
+В этом руководстве показано, как использовать набор платформо-ориентированных инструментов Cordova для разработки приложений на Android. Этот путь разработки, описанный в разделе "Обзор", может предложить вам больший спектр вариантов разработки чем кросс платформенный инструмент CLI, описанные в разделе "Интерфейс командной строки". Например вам нужно использовать инструменты командной строки при развертывании настраиваемого Cordova WebView наряду с собственными компонентами. Перед использованием любой путь разработки, сначала необходимо настроить среду Android SDK, как описано в разделе "Руководство платформы Android".
+
+Чтобы включить инструменты оболочки для Android, скачайте Cordova с [cordova.apache.org][1]. Загружаемый файл содержит отдельные архивы для каждой платформы. Разверните каждый, для которого вы хотите разрабатывать который, `android` в данном случае. Соответствующие инструменты обычно доступны в папке верхнего уровня `bin`, в противном случае проконсультируйтесь в файле **README** для более подробные инструкции.
+
+ [1]: http://cordova.apache.org
+
+Эти инструменты командной строки позволят вам создавать, собирать и запускать приложения для Android. За информаций о дополнительных интерфейсах командной строки которые позволяют встраивать возможности плагинов среди разных платформ, смотрите раздел "Использование Plugman для управления плагинами". Смотрите раздел "Плагины приложения" для детальной информации о том как разрабатывать плагины.
+
+## Создание проекта
+
+Запуск `create` команду, указав существующий путь к проекту, реверс домен стиль пакета идентификатор и отображаемое имя приложения. Вот синтаксис для Mac/Linux и Windows:
+
+ $ /path/to/cordova-android/bin/create /path/to/project com.example.project_name ProjectName
+
+ C:\>\path\to\cordova-android\bin\create.bat \path\to\project com.example.project_name ProjectName
+
+
+## Сборка
+
+Это удаляет, затем выполняет построение проекта.
+
+Отладка, на Windows или Mac/Linux:
+
+ $ /path/to/project/cordova/build --debug
+
+ C:\>\path\to\project\cordova\build.bat --debug
+
+
+Релиз, на Windows или Mac/Linux:
+
+ $ /path/to/project/cordova/build --release
+
+ C:\>\path\to\project\cordova\build.bat --release
+
+
+## Запуск приложения
+
+Команда `run` принимает следующие *необязательные* параметры:
+
+* Целевая спецификация. Это включает в себя `--emulator` , `--device`, или`--target=<targetID>`.
+
+* Спецификация сборки. Это включает в себя `--debug` , `--release` , или`--nobuild`.
+
+ $ /path/to/project/cordova/run [Target] [Build]
+
+ C:\>\path\to\project\cordova\run.bat [Target] [Build]
+
+
+Убедитесь, что вы создали по крайней мере одно виртуальное устройство Android, в противном случае вам будет предложено сделать это с помощью команды `android`. Если несколько AVD доступны как цель, вам будет предложено выбрать одно из них. По умолчанию команда `run` определяет подключенное устройство, или в настоящее время работающий эмулятор, если устройство не найдено.
+
+## Подпись приложения
+
+Вы можете просмотреть требования для подписанния Android приложений: http://developer.android.com/tools/publishing/app-signing.html
+
+Чтобы подписать приложение, необходимо следующие параметры: * Keystore (`--keystore`): путь к двоичному файлу, который может содержать набор ключей. * Keystore password (`--storePassword`): пароль для хранилища ключей * Alias (`--alias`): id определеяющий закрытый ключ, используемый для подписания. * Password (`--password`): пароль для указанного закрытого ключа. * Type of the keystore (`--keystoreType`): pkcs12, jks (по умолчанию: автоматическое определение на основе расширения файла) эти параметры могут быть заданы с помощью аргументов командной строки выше для скриптов `build` или `run`.
+
+Кроме того их можно указать в файле конфигурации сборки (build.json) с помощью аргумента (`--buildConfig`). Ниже приведен пример файла конфигурации построения:
+
+ {
+ "android": {
+ "debug": {
+ "keystore": "..\android.keystore",
+ "storePassword": "android",
+ "alias": "mykey1",
+ "password" : "password",
+ "keystoreType": ""
+ },
+ "release": {
+ "keystore": "..\android.keystore",
+ "storePassword": "",
+ "alias": "mykey2",
+ "password" : "password",
+ "keystoreType": ""
+ }
+ }
+ }
+
+
+Для подписи релизной версии, пароли могут быть исключены и система построения будет выдавать запрос на пароль.
+
+Существует также поддержка смешивать аргументы командной строки и параметры в файле build.json. Приоритет будут получать значения из аргументов командной строки. Это может быть полезно для задания паролей в командной строке.
+
+## Ведение журнала
+
+ $ /path/to/project/cordova/log
+
+ C:\>\path\to\project\cordova\log.bat
+
+
+## Очистка
+
+ $ /path/to/project/cordova/clean
+
+ C:\>\path\to\project\cordova\clean.bat
+
+
+## Сборка с Gradle
+
+Начиная с cordova-android@4.0.0, сборка проекта использует [Gradle][2]. Для инструкций по построению с помощью ANT, используйте более старую версию документации.
+
+ [2]: http://www.gradle.org/
+
+### Свойства Gradle
+
+Эти [свойства][3] могут быть установлены для настройки процесса сборки:
+
+ [3]: http://www.gradle.org/docs/current/userguide/tutorial_this_and_that.html
+
+* **cdvBuildMultipleApks** (по умолчанию: false)
+
+ Если этот параметр установлен, то будут создаваться несколько APK файлов: один для каждой платформы, поддерживаемой библиотеками проектов (x86, ARM, и т.д.). Это может быть важно, если ваш проект использует большие бинарные библиотеки, которые могут резко увеличить размер создаваемого APK.
+
+ Если не задано, то будет создаваться один APK, который может использоваться на всех устройствах.
+
+* **cdvVersionCode**
+
+ Переопределяет versionCode установленный в `AndroidManifest.xml`
+
+* **cdvReleaseSigningPropertiesFile** (по умолчанию: release-signing.properties)
+
+ Путь к файлу .properties, содержащую информацию о подписях для релизных сборок. Этот файл должен выглядеть:
+
+ storeFile=relative/path/to/keystore.p12
+ storePassword=SECRET1
+ storeType=pkcs12
+ keyAlias=DebugSigningKey
+ keyPassword=SECRET2
+
+
+ `storePassword` и `keyPassword` являются необязательными и будет запрашиваться, если пропущены.
+
+* **cdvDebugSigningPropertiesFile** (по умолчанию: debug-signing.properties)
+
+ Так же, как cdvReleaseSigningPropertiesFile, но для отладочного построения. Полезно, когда вам нужно использовать ключ подписи совместно с другими разработчиками.
+
+* **cdvMinSdkVersion**
+
+ Переопределяет значение `minSdkVersion` в `AndroidManifest.xml`. Полезно при создании нескольких APK на основе версии SDK.
+
+* **cdvBuildToolsVersion**
+
+ Переопределяет автоматически обнаруженное значение `android.buildToolsVersion` .
+
+* **cdvCompileSdkVersion**
+
+ Переопределяет автоматически обнаруженное значение `android.compileSdkVersion` .
+
+### Расширение build.gradle
+
+Если вам нужно настроить `build.gradle`, вместо того, чтобы редактировать его напрямую, следует создать одноуровневый файл с именем `build-extras.gradle`. Этот файл будет включен основным `build.gradle` если он существует. Вот пример:
+
+ # Example build-extras.gradle
+ # This file is included at the beginning of `build.gradle`
+ ext.cdvDebugSigningPropertiesFile = '../../android-debug-keys.properties'
+ # When set, this function allows code to run at the end of `build.gradle`
+ ext.postBuildExtras = {
+ android.buildTypes.debug.applicationIdSuffix = '.debug'
+ }
+
+
+Обратите внимание, что плагины могут также включать файлы `build-extras.gradle` через:
+
+ <framework src="some.gradle" custom="true" type="gradleReference" />
+
+
+### Пример сборки
+
+ export ORG_GRADLE_PROJECT_cdvMinSdkVersion=14
+ cordova build android -- --gradleArg=-PcdvBuildMultipleApks=true
\ No newline at end of file
diff --git a/docs/ru/5.0.0/guide/platforms/android/upgrade.md b/docs/ru/5.0.0/guide/platforms/android/upgrade.md
new file mode 100644
index 0000000..44eee8f
--- /dev/null
+++ b/docs/ru/5.0.0/guide/platforms/android/upgrade.md
@@ -0,0 +1,498 @@
+---
+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.
+---
+
+# Обновление для Android
+
+В этом руководстве показано, как изменить Android проекты при обновлении старых версий Cordova. Большинство этих инструкций применимы для проектов, созданных со старым набором средств командной строки, которые предшествуют утилите CLI `cordova`. Смотрите раздел "Интерфейс командной строки" для получения информации как обновить версию CLI.
+
+## Обновление до 4.0.0
+
+Это конкретные шаги обновления которые необходимо выполнить чтобы использовать существенные изменения в 4.0.0. Во-первых необходимы общие шаги обновления, как показано ниже.
+
+Для проектов-CLI выполните:
+
+ bin/обновить путь/к/проекта
+
+
+Для проектов CLI:
+
+1. Обновите версию `cordova` CLI. Смотрите "Интерфейс командной строки".
+
+2. Запустите `cordova platform update android` в ваших проектах.
+
+### Обновление списка разрешенных ресурсов
+
+Теперь вся функциональность списка разрешенных ресурсов реализована через плагин. Без плагина ваше приложение более не защищен списком разрешенных ресурсов после обновления до 4.0.0. Cordova имеет два плагина для списка разрешенных ресурсов, которые обеспечивают различные уровни защиты.
+
+1. Плагин `cordova-plugin-whitelist` *(рекомендуемый)*
+
+ * Настоятельно рекомендуется этот плагин, так как лг более безопасный и более настраиваемый, чем список разрешенных ресурсов в предыдущих версиях
+ * Смотрите [cordova-plugin-whitelist][1] для подробностей по необходимым изменения конфигурации
+ * Run: `cordova plugin add cordova-plugin-crosswalk-webview`
+
+2. Плагин `cordova-plugin-legacy-whitelist`
+
+ * Этот плагин обеспечивает такое же поведение списка разрешенных ресурсов, как и предыдущие версии. Смотрите [cordova-plugin-legacy-whitelist][2]
+ * Изменения конфигурации не требуются, но она обеспечивает меньшую защиту, чем рекомендованный плагин
+ * Run: `cordova plugin add cordova-plugin-legacy-whitelist`
+
+ [1]: https://github.com/apache/cordova-plugin-whitelist
+ [2]: https://github.com/apache/cordova-plugin-legacy-whitelist
+
+### Использование Crosswalk WebView
+
+По умолчанию ваше приложение будет продолжать использовать системный WebView, предоставляемый устройством. Если вы хотите вместо этого использовать WebView CrossWalk, просто добавьте плагин CrossWalk:
+
+ cordova plugin add cordova-plugin-crosswalk-webview
+
+
+После добавления плагина, ваше приложение получит WebView Crosswalk установленным и правильно настроеным.
+
+### Обновление к плагину Splashscreen
+
+Если ваше приложение использовала экрана-заставку, то эта функциональность была перемещена в плагин. Параметры конфигурации для экрана-заставки остались неизменными. Единственный требуемый шаг для обновления это добавление плагина:
+
+ cordova plugin add cordova-plugin-splashscreen
+
+
+## Обновление до 3.7.1 с 3.6.0
+
+Для проектов-CLI выполните:
+
+ bin/обновить путь/к/проекта
+
+
+Для проектов CLI:
+
+1. Обновите версию `cordova` CLI. Смотрите "Интерфейс командной строки".
+
+2. Запустите `cordova platform update android` в ваших проектах.
+
+## Обновление до 3.3.0 с 3.2.0
+
+Следуйте тем же инструкциям что и для `3.2.0`.
+
+Начиная с 3.3.0, среда выполнения Cordova теперь компилируется как Android библиотека вместо Jar. Это не должно иметь никакого эффекта при использовании из командной строки, но пользователям IDE нужно будет импортировать новые проекты `MyProject-CordovaLib` в их рабочее пространство.
+
+## Обновление до 3.2.0 с 3.1.0
+
+Для проектов, которые были созданы с помощью cordova CLI:
+
+1. Обновите версию `cordova` CLI. Смотрите "Интерфейс командной строки".
+
+2. Run `cordova platform update android`
+
+Для проектов, не созданных с помощью cordova CLI выполните:
+
+ bin/update <project_path>
+
+
+**Предупреждение:** На Android 4.4 - Android 4.4.3, создание элемента ввода input type="file" не открывает диалоговое окно выбора файла. Это регрессия из Chromium на Android, и проблемы могут быть воспроизведены в автономном браузер Chrome на Android (см. http://code.google.com/p/android/issues/detail?id=62220) предложенное решение заключается в использовании плагинов FileTransfer и File для Android 4.4. Можно прослушивать событие onClick для input type="file" и затем показывать пользовательский интерфейс средства выбора файлов. Для того, чтобы связать данные формы с загрузки, можно использовать JavaScript для присоединения значений формы к составному запросу POST, что делает FileTransfer.
+
+## Обновление до 3.1.0 с 3.0.0
+
+Для проектов, которые были созданы с помощью cordova CLI:
+
+1. Обновите версию `cordova` CLI. Смотрите "Интерфейс командной строки".
+
+2. Run `cordova platform update android`
+
+Для проектов, не созданных с помощью cordova CLI выполните:
+
+ bin/update <project_path>
+
+
+## Обновление до CLI (3.0.0) с 2.9.0
+
+1. Создайте новый проект Apache Cordova 3.0.0 используя Cordova CLI, как описано в разделе "Интерфейс командной строки".
+
+2. Добавьте ваши платформы в проект Cordova, например: `cordova
+platform add ios`.
+
+3. Скопируйте содержимое каталога `www` в каталог `www` проекта Cordova который вы только что создали.
+
+4. Скопируйте любые платформенные ресурсы из старого проекта в соответствующие каталоги в `platforms/android`: это директория где расположен проект cordova-android.
+
+5. Используйте Сordova CLI для установки необходимых вам плагинов. Обратите внимание что CLI интерпретирует все базовые APIs как плагины, так что они тоже должны быть добавлены. Только плагины для версии 3.0.0 поддерживаются CLI.
+
+## Обновление до 3.0.0 с 2.9.0
+
+1. Создайте новый проект Apache Cordova Android.
+
+2. Скопируйте содержимое каталога `www` в новый проект.
+
+3. Скопируйте любые ресурсы платформы Android из каталога `res` в новый проект.
+
+4. Скопируйте любые плагины, которые вы установили из подкаталогов `src` в новый проект.
+
+5. Убедитесь что вы обновили любые устаревшие ссылки `<plugin>` из вашего старого файла `config.xml` в новое определение в `<feature>`.
+
+6. Обновите ссылки с пакета `org.apache.cordova.api` на `org.apache.cordova`.
+
+ **Примечание**: все основные API были удалены и должны быть установлены как плагины. Для подробной информации смотрите раздел "Использование Plugman для управления расширениями".
+
+## Обновление до 2.9.0 с 2.8.0
+
+1. Run `bin/update <project_path>`.
+
+## Обновление до 2.8.0 с 2.7.0
+
+1. Удалить `cordova-2.7.0.jar` из каталога проекта `libs`.
+
+2. Добавить `cordova-2.8.0.jar` в каталог проекта `libs`.
+
+3. Если вы используете Eclipse, обновите ваш проект Eclipse и выполните clean.
+
+<!-- SS Eclipse -->
+
+1. Скопируйте новый `cordova.js` в ваш проект.
+
+2. Обновите ваш HTML, чтобы использовать новый `cordova.js` файл.
+
+3. Скопируйте `res/xml/config.xml` файл в соответствии с `framework/res/xml/config.xml`.
+
+4. Обновите `framework/res/xml/config.xml` чтобы иметь одинаковые параметры, как это было ранее.
+
+5. Скопируйте файлы из `bin/templates/cordova` в каталог проекта `cordova`.
+
+## Обновление до 2.7.0 с 2.6.0
+
+1. Удалить `cordova-2.6.0.jar` из каталога проекта `libs`.
+
+2. Добавить `cordova-2.7.0.jar` в каталог проекта `libs`.
+
+3. Если вы используете Eclipse, обновите ваш проект Eclipse и выполните clean.
+
+4. Скопируйте новый `cordova-2.7.0.js` в ваш проект.
+
+5. Обновите ваш HTML, чтобы использовать новый `cordova-2.7.0.js` файл.
+
+6. Копия `res/xml/config.xml` соответствовать`framework/res/xml/config.xml`.
+
+7. Обновите `framework/res/xml/config.xml` чтобы иметь одинаковые параметры, как это было ранее.
+
+8. Скопируйте файлы из `bin/templates/cordova` в каталог проекта `cordova`.
+
+## Обновление до 2.6.0 от 2.5.0
+
+1. Удалить `cordova-2.5.0.jar` из каталога проекта `libs`.
+
+2. Добавить `cordova-2.6.0.jar` в каталог проекта `libs`.
+
+3. Если вы используете Eclipse, обновите ваш проект Eclipse и выполните clean.
+
+4. Скопируйте новый `cordova-2.6.0.js` в ваш проект.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-2.6.0.js` файл.
+
+6. Копия `res/xml/config.xml` соответствовать`framework/res/xml/config.xml`.
+
+7. Обновите `framework/res/xml/config.xml` чтобы иметь одинаковые параметры, как это было ранее.
+
+8. Скопируйте файлы из `bin/templates/cordova` в каталог проекта `cordova`.
+
+Запустите `bin/update <project>` из пути проекта, перечисленным в исходном каталоге Cordova.
+
+## Обновление до 2.5.0 с 2.4.0
+
+1. Удалить `cordova-2.4.0.jar` из каталога проекта `libs`.
+
+2. Добавить `cordova-2.5.0.jar` в каталог проекта `libs`.
+
+3. Если вы используете Eclipse, обновите ваш проект Eclipse и выполните clean.
+
+4. Скопируйте новый `cordova-2.5.0.js` в ваш проект.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-2.5.0.js` файл.
+
+6. Копия `res/xml/config.xml` соответствовать`framework/res/xml/config.xml`.
+
+7. Обновите `framework/res/xml/config.xml` чтобы иметь одинаковые параметры, как это было ранее.
+
+8. Скопируйте файлы из `bin/templates/cordova` в каталог проекта `cordova`.
+
+## Обновление до 2.4.0 от 2.3.0
+
+1. Удалить `cordova-2.3.0.jar` из каталога проекта `libs`.
+
+2. Добавить `cordova-2.4.0.jar` в каталог проекта `libs`.
+
+3. Если вы используете Eclipse, обновите ваш проект Eclipse и выполните clean.
+
+4. Скопируйте новый `cordova-2.4.0.js` в ваш проект.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-2.4.0.js` файл.
+
+6. Копия `res/xml/config.xml` соответствовать`framework/res/xml/config.xml`.
+
+7. Скопируйте файлы из `bin/templates/cordova` в каталог проекта `cordova`.
+
+## Обновление до 2.3.0 от 2.2.0
+
+1. Удалить `cordova-2.2.0.jar` из каталога проекта `libs`.
+
+2. Добавить `cordova-2.3.0.jar` в каталог проекта `libs`.
+
+3. Если вы используете Eclipse, обновите ваш проект Eclipse и выполните clean.
+
+4. Скопируйте новый `cordova-2.3.0.js` в ваш проект.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-2.3.0.js` файл.
+
+6. Копия `res/xml/config.xml` соответствовать`framework/res/xml/config.xml`.
+
+7. Скопируйте файлы из `bin/templates/cordova` в каталог проекта `cordova`.
+
+## Обновление до 2.2.0 из 2.1.0
+
+1. Удалить `cordova-2.1.0.jar` из каталога проекта `libs`.
+
+2. Добавить `cordova-2.2.0.jar` в каталог проекта `libs`.
+
+3. Если вы используете Eclipse, обновите ваш проект Eclipse и выполните clean.
+
+4. Скопируйте новый `cordova-2.2.0.js` в ваш проект.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-2.2.0.js` файл.
+
+6. Копия `res/xml/config.xml` соответствовать`framework/res/xml/config.xml`.
+
+7. Скопируйте файлы из `bin/templates/cordova` в каталог проекта `cordova`.
+
+## Обновление до 2.1.0 с 2.0.0
+
+1. Удалить `cordova-2.0.0.jar` из каталога проекта `libs`.
+
+2. Добавить `cordova-2.1.0.jar` в каталог проекта `libs`.
+
+3. Если вы используете Eclipse, обновите ваш проект 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`.
+
+7. Скопируйте файлы из `bin/templates/cordova` в каталог проекта `cordova`.
+
+## Обновление до 2.0.0 от 1.9.0
+
+1. Удалить `cordova-1.9.0.jar` из каталога проекта `libs`.
+
+2. Добавить `cordova-2.0.0.jar` в каталог проекта `libs`.
+
+3. Если вы используете Eclipse, обновите ваш проект 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`. Старые файлы являются устаревшими и хотя они по-прежнему работают в 2.0.0, перестанут работать в будущих выпусках.
+
+## Обновление с 1.8.1 до 1.9.0
+
+1. Удалить `cordova-1.8.1.jar` из проекта `libs` каталог.
+
+2. Добавить `cordova-1.9.0.jar` в каталог проекта `libs`.
+
+3. Если вы используете Eclipse, обновите ваш проект 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`.
+
+Из-за введения `CordovaWebView` в релизе 1.9.0, плагины третьих лиц могут не работать. Эти плагины должны получать контекст из `CordovaInterface` с помощью `getContext()` или `getActivity()`. Если вы не являетесь опытным разработчиком Android, пожалуйста, свяжитесь с сопровождающим плагин лицом и добавьте эту задачу в их баг трекер.
+
+## Обновление с 1.8.0 до 1.8.1
+
+1. Удалить `cordova-1.8.1.jar` из проекта `libs` каталог.
+
+2. Добавить `cordova-1.8.1.jar` в каталог проекта `libs`.
+
+3. Если вы используете Eclipse, обновите ваш проект 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.8.0 от 1.7.0
+
+1. Удалить `cordova-1.7.0.jar` из каталога проекта `libs`.
+
+2. Добавить `cordova-1.8.0.jar` в каталог проекта `libs`.
+
+3. Если вы используете Eclipse, обновите ваш проект 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.8.0 от 1.7.0
+
+1. Удалить `cordova-1.7.0.jar` из каталога проекта `libs`.
+
+2. Добавить `cordova-1.8.0.jar` в каталог проекта `libs`.
+
+3. Если вы используете Eclipse, обновите ваш проект 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. Удалить `cordova-1.6.1.jar` из каталога проекта `libs`.
+
+2. Добавить `cordova-1.7.0.jar` в каталог проекта `libs`.
+
+3. Если вы используете Eclipse, обновите ваш проект 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. Удалить `cordova-1.6.0.jar` из каталога проекта `libs`.
+
+2. Добавить `cordova-1.6.1.jar` в каталог проекта `libs`.
+
+3. Если вы используете Eclipse, обновите ваш проект 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. Удалить `cordova-1.5.0.jar` из каталога проекта `libs`.
+
+2. Добавить `cordova-1.6.0.jar` в каталог проекта `libs`.
+
+3. Если вы используете Eclipse, обновите ваш проект 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` на `res/xml/cordova.xml` для соотвествия файлу `framework/res/xml/cordova.xml`.
+
+## Обновление с 1.4.0 до 1.5.0
+
+1. Удалить `phonegap-1.4.0.jar` из каталога проекта `libs`.
+
+2. Добавить `cordova-1.5.0.jar` в каталог проекта `libs`.
+
+3. Если вы используете Eclipse, обновите ваш проект 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` на `res/xml/cordova.xml` для соотвествия файлу `framework/res/xml/cordova.xml`.
+
+## Обновление с 1.3.0 до 1.4.0
+
+1. Удалить `phonegap-1.3.0.jar` из каталога проекта `libs`.
+
+2. Добавить `phonegap-1.4.0.jar` в каталог проекта `libs`.
+
+3. Если вы используете Eclipse, обновите ваш проект 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` в соответствии c `framework/res/xml/phonegap.xml`.
+
+## Обновление с 1.2.0 до 1.3.0
+
+1. Удалить `phonegap-1.2.0.jar` из каталога проекта `libs`.
+
+2. Добавить `phonegap-1.3.0.jar` в каталог проекта `libs`.
+
+3. Если вы используете Eclipse, обновите ваш проект Eclipse и выполните clean.
+
+4. Скопируйте новый `phonegap-1.3.0.js` в ваш проект.
+
+5. Обновите ваш HTML, чтобы использовать новый файл `phonegap-1.2.0.js`.
+
+6. Обновите `res/xml/plugins.xml` в соответствии с `framework/res/xml/plugins.xml`.
+
+7. Обновление `res/xml/phonegap.xml` в соответствии c `framework/res/xml/phonegap.xml`.
+
+## Обновление до 1.2.0 с 1.1.0
+
+1. Удалить `phonegap-1.1.0.jar` из каталога проекта `libs`.
+
+2. Добавить `phonegap-1.2.0.jar` в каталог проекта `libs`.
+
+3. Если вы используете Eclipse, обновите ваш проект 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` в соответствии c `framework/res/xml/phonegap.xml`.
+
+## Обновление до 1.1.0 с 1.0.0
+
+1. Удалить `phonegap-1.0.0.jar` из каталога проекта `libs`.
+
+2. Добавить `phonegap-1.1.0.jar` в каталог проекта `libs`.
+
+3. Если вы используете Eclipse, обновите ваш проект 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`.
+
+## Обновление до 1.0.0 с 0.9.6
+
+1. Удалить `phonegap-0.9.6.jar` из каталога проекта `libs`.
+
+2. Добавить `phonegap-1.0.0.jar` в каталог проекта `libs`.
+
+3. Если вы используете Eclipse, обновите ваш проект 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`.
\ No newline at end of file
diff --git a/docs/ru/5.0.0/guide/platforms/android/upgrading.md b/docs/ru/5.0.0/guide/platforms/android/upgrading.md
new file mode 100644
index 0000000..216c45c
--- /dev/null
+++ b/docs/ru/5.0.0/guide/platforms/android/upgrading.md
@@ -0,0 +1,430 @@
+---
+
+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.
+---
+
+# Обновление Android
+
+В этом руководстве показано, как изменить Android проектов для обновления старых версий Кордова. Большинство этих инструкций применимы для проектов, созданных с старого набора средств командной строки, которые предшествуют `cordova` утилиты CLI. Увидеть интерфейс командной строки для получения информации как обновить версию инфраструктуры CLI.
+
+## Обновление до 3.3.0 3.2.0
+
+Следуйте же instructinos как для`3.2.0`.
+
+Начиная с 3.3.0, Кордова выполнения теперь компилируется как Android библиотеки вместо Jar. Это должно иметь никакого эффекта для использования командной строки, но IDE пользователям нужно будет импортировать новые `MyProject-CordovaLib` проекта в их область.
+
+## Обновление до 3.2.0 3.1.0
+
+Для проектов, которые были созданы с Кордова CLI:
+
+1. Обновление `cordova` CLI-версия. Увидеть интерфейс командной строки.
+
+2. Запуск`cordova platform update android`
+
+Для проектов, не созданных с Кордова CLI выполните:
+
+ bin/update <project_path>
+
+
+## Обновление с 3.0.0 до 3.1.0
+
+Для проектов, которые были созданы с Кордова CLI:
+
+1. Обновление `cordova` CLI-версия. Увидеть интерфейс командной строки.
+
+2. Запуск`cordova platform update android`
+
+Для проектов, не созданных с Кордова CLI выполните:
+
+ bin/update <project_path>
+
+
+## Обновление к CLI (3.0.0) с 2.9.0
+
+1. Создайте новый проект Apache Cordova 3.0.0 используя cordova CLI, как описано в интерфейс командной строки.
+
+2. Добавьте ваш платформ проекта cordova, например:`cordova
+platform add android`.
+
+3. Копировать содержимое вашего проекта `www` каталог `www` каталог в корневом каталоге проекта cordova, вы только что создали.
+
+4. Скопируйте любые собственные активы из старого проекта в соответствующие каталоги под `platforms/android` : этот каталог является, где существует собственный проект cordova-android.
+
+5. Используйте средство CLI cordova для установки любых плагинов, что вам нужно. Обратите внимание, что CLI обрабатывает все основные API плагинов, так что они могут и должны быть добавлены. Только 3.0.0 плагины совместимы с CLI.
+
+## Обновление до 3.0.0 от 2.9.0
+
+1. Создайте новый проект Apache Cordova Android.
+
+2. Скопируйте содержимое вашего `www` каталог в новый проект.
+
+3. Скопируйте любые родной Android активы от вашего `res` каталог в новый проект.
+
+4. Скопируйте любые плагины вы установили от `src` подкаталоги в новый проект.
+
+5. Не забудьте обновить любой устаревшей `<plugin>` ссылки из вашего старого `config.xml` файл в новый `<feature>` спецификации.
+
+6. Обновить ссылки на `org.apache.cordova.api` пакет, чтобы быть`org.apache.cordova`.
+
+ **Примечание**: все основные API были удалены и должны быть установлены как плагины. Для подробной информации смотрите с помощью Plugman управление плагины руководство.
+
+## Обновление до 2.9.0 с 2.8.0
+
+1. Запуск`bin/update <project_path>`.
+
+## Обновление до 2.8.0 с 2.7.0
+
+1. Удалить `cordova-2.7.0.jar` из проекта `libs` каталог.
+
+2. Добавить `cordova-2.8.0.jar` в проект `libs` каталог.
+
+3. Если вы используете Eclipse, обновите ваш проект Eclipse и сделать чистой.
+
+<!-- SS Eclipse -->
+
+1. Скопируйте новый `cordova.js` в ваш проект.
+
+2. Обновить ваш HTML, чтобы использовать новый `cordova.js` файл.
+
+3. Копия `res/xml/config.xml` файл в соответствии с`framework/res/xml/config.xml`.
+
+4. Обновление `framework/res/xml/config.xml` имеют одинаковые параметры, как это было ранее.
+
+5. Скопируйте файлы из `bin/templates/cordova` в проект `cordova` каталог.
+
+## Обновление до 2.7.0 с 2.6.0
+
+1. Удалить `cordova-2.6.0.jar` из проекта `libs` каталог.
+
+2. Добавить `cordova-2.7.0.jar` в проект `libs` каталог.
+
+3. Если вы используете Eclipse, обновите ваш проект Eclipse и сделать чистой.
+
+4. Скопируйте новый `cordova-2.7.0.js` в ваш проект.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-2.7.0.js` файл.
+
+6. Копия `res/xml/config.xml` для соответствия`framework/res/xml/config.xml`.
+
+7. Обновление `framework/res/xml/config.xml` имеют одинаковые параметры, как это было ранее.
+
+8. Скопируйте файлы из `bin/templates/cordova` в проект `cordova` каталог.
+
+## Обновление до 2.6.0 от 2.5.0
+
+1. Удалить `cordova-2.5.0.jar` из проекта `libs` каталог.
+
+2. Добавить `cordova-2.6.0.jar` в проект `libs` каталог.
+
+3. Если вы используете Eclipse, обновите ваш проект Eclipse и сделать чистой.
+
+4. Скопируйте новый `cordova-2.6.0.js` в ваш проект.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-2.6.0.js` файл.
+
+6. Копия `res/xml/config.xml` для соответствия`framework/res/xml/config.xml`.
+
+7. Обновление `framework/res/xml/config.xml` имеют одинаковые параметры, как это было ранее.
+
+8. Скопируйте файлы из `bin/templates/cordova` в проект `cordova` каталог.
+
+Запустить `bin/update <project>` с пути проекта перечислены в Cordova исходного каталога.
+
+## Обновление до 2.5.0 с 2.4.0
+
+1. Удалить `cordova-2.4.0.jar` из проекта `libs` каталог.
+
+2. Добавить `cordova-2.5.0.jar` в проект `libs` каталог.
+
+3. Если вы используете Eclipse, обновите ваш проект Eclipse и сделать чистой.
+
+4. Скопируйте новый `cordova-2.5.0.js` в ваш проект.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-2.5.0.js` файл.
+
+6. Копия `res/xml/config.xml` для соответствия`framework/res/xml/config.xml`.
+
+7. Обновление `framework/res/xml/config.xml` имеют одинаковые параметры, как это было ранее.
+
+8. Скопируйте файлы из `bin/templates/cordova` в проект `cordova` каталог.
+
+## Обновление до 2.4.0 от 2.3.0
+
+1. Удалить `cordova-2.3.0.jar` из проекта `libs` каталог.
+
+2. Добавить `cordova-2.4.0.jar` в проект `libs` каталог.
+
+3. Если вы используете Eclipse, обновите ваш проект Eclipse и сделать чистой.
+
+4. Скопируйте новый `cordova-2.4.0.js` в ваш проект.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-2.4.0.js` файл.
+
+6. Копия `res/xml/config.xml` для соответствия`framework/res/xml/config.xml`.
+
+7. Скопируйте файлы из `bin/templates/cordova` в проект `cordova` каталог.
+
+## Обновление до 2.3.0 от 2.2.0
+
+1. Удалить `cordova-2.2.0.jar` из проекта `libs` каталог.
+
+2. Добавить `cordova-2.3.0.jar` в проект `libs` каталог.
+
+3. Если вы используете Eclipse, обновите ваш проект Eclipse и сделать чистой.
+
+4. Скопируйте новый `cordova-2.3.0.js` в ваш проект.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-2.3.0.js` файл.
+
+6. Копия `res/xml/config.xml` для соответствия`framework/res/xml/config.xml`.
+
+7. Скопируйте файлы из `bin/templates/cordova` в проект `cordova` каталог.
+
+## Обновление до 2.2.0 из 2.1.0
+
+1. Удалить `cordova-2.1.0.jar` из проекта `libs` каталог.
+
+2. Добавить `cordova-2.2.0.jar` в проект `libs` каталог.
+
+3. Если вы используете Eclipse, обновите ваш проект Eclipse и сделать чистой.
+
+4. Скопируйте новый `cordova-2.2.0.js` в ваш проект.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-2.2.0.js` файл.
+
+6. Копия `res/xml/config.xml` для соответствия`framework/res/xml/config.xml`.
+
+7. Скопируйте файлы из `bin/templates/cordova` в проект `cordova` каталог.
+
+## Обновление до 2.1.0 с 2.0.0
+
+1. Удалить `cordova-2.0.0.jar` из проекта `libs` каталог.
+
+2. Добавить `cordova-2.1.0.jar` в проект `libs` каталог.
+
+3. Если вы используете Eclipse, обновите ваш проект Eclipse и сделать чистой.
+
+4. Скопируйте новый `cordova-2.1.0.js` в ваш проект.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-2.1.0.js` файл.
+
+6. Копия `res/xml/config.xml` для соответствия`framework/res/xml/config.xml`.
+
+7. Скопируйте файлы из `bin/templates/cordova` в проект `cordova` каталог.
+
+## Обновление до 2.0.0 от 1.9.0
+
+1. Удалить `cordova-1.9.0.jar` из проекта `libs` каталог.
+
+2. Добавить `cordova-2.0.0.jar` в проект `libs` каталог.
+
+3. Если вы используете Eclipse, обновите ваш проект Eclipse и сделать чистой.
+
+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` . Старые файлы являются устаревшими и хотя они по-прежнему работают в 2.0.0, перестанет работать в будущих выпусках.
+
+## Обновление с 1.8.1 на 1.9.0
+
+1. Удалить `cordova-1.8.0.jar` из проекта `libs` каталог.
+
+2. Добавить `cordova-1.9.0.jar` в проект `libs` каталог.
+
+3. Если вы используете Eclipse, обновите ваш проект Eclipse и сделать чистой.
+
+4. Скопируйте новый `cordova-1.9.0.js` в ваш проект.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-1.9.0.js` файл.
+
+6. Обновление `res/xml/plugins.xml` для соответствия`framework/res/xml/plugins.xml`.
+
+Из-за введения `CordovaWebView` в 1.9.0 релиз, сторонние плагины могут не работать. Эти плагины нужно получить контекст из `CordovaInterface` с помощью `getContext()` или `getActivity()` . Если вы не являетесь опытным разработчиком Android, пожалуйста, свяжитесь с сопровождающим плагин и добавьте эту задачу в их баг трекер.
+
+## Обновление до 1.8.0 от 1.8.0
+
+1. Удалить `cordova-1.8.0.jar` из проекта `libs` каталог.
+
+2. Добавить `cordova-1.8.1.jar` в проект `libs` каталог.
+
+3. Если вы используете Eclipse, обновите ваш проект Eclipse и сделать чистой.
+
+4. Скопируйте новый `cordova-1.8.1.js` в ваш проект.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-1.8.1.js` файл.
+
+6. Обновление `res/xml/plugins.xml` для соответствия`framework/res/xml/plugins.xml`.
+
+## Обновление до 1.8.0 от 1.7.0
+
+1. Удалить `cordova-1.7.0.jar` из проекта `libs` каталог.
+
+2. Добавить `cordova-1.8.0.jar` в проект `libs` каталог.
+
+3. Если вы используете Eclipse, обновите ваш проект Eclipse и сделать чистой.
+
+4. Скопируйте новый `cordova-1.8.0.js` в ваш проект.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-1.8.0.js` файл.
+
+6. Обновление `res/xml/plugins.xml` для соответствия`framework/res/xml/plugins.xml`.
+
+## Обновление до 1.8.0 от 1.7.0
+
+1. Удалить `cordova-1.7.0.jar` из проекта `libs` каталог.
+
+2. Добавить `cordova-1.8.0.jar` в проект `libs` каталог.
+
+3. Если вы используете Eclipse, обновите ваш проект Eclipse и сделать чистой.
+
+4. Скопируйте новый `cordova-1.8.0.js` в ваш проект.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-1.8.0.js` файл.
+
+6. Обновление `res/xml/plugins.xml` в соответствии`framework/res/xml/plugins.xml`.
+
+## Обновление до версии 1.7.0 от 1.6.1
+
+1. Удалить `cordova-1.6.1.jar` из проекта `libs` каталог.
+
+2. Добавить `cordova-1.7.0.jar` в проект `libs` каталог.
+
+3. Если вы используете Eclipse, обновите ваш проект Eclipse и сделать чистой.
+
+4. Скопируйте новый `cordova-1.7.0.js` в ваш проект.
+
+5. Обновление `res/xml/plugins.xml` для соответствия`framework/res/xml/plugins.xml`.
+
+## Обновление до 1.6.1 от 1.6.0
+
+1. Удалить `cordova-1.6.0.jar` из проекта `libs` каталог.
+
+2. Добавить `cordova-1.6.1.jar` в проект `libs` каталог.
+
+3. Если вы используете Eclipse, обновите ваш проект Eclipse и сделать чистой.
+
+4. Скопируйте новый `cordova-1.6.1.js` в ваш проект.
+
+5. Обновление `res/xml/plugins.xml` в соответствии`framework/res/xml/plugins.xml`.
+
+## Обновление до 1.6.0 от 1.5.0
+
+1. Удалить `cordova-1.5.0.jar` из проекта `libs` каталог.
+
+2. Добавить `cordova-1.6.0.jar` в проект `libs` каталог.
+
+3. Если вы используете Eclipse, обновите ваш проект Eclipse и сделать чистой.
+
+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` с `res/xml/cordova.xml` для соответствия`framework/res/xml/cordova.xml`.
+
+## Обновление до 1.5.0 от 1.4.0
+
+1. Удалить `phonegap-1.4.0.jar` из проекта `libs` каталог.
+
+2. Добавить `cordova-1.5.0.jar` в проект `libs` каталог.
+
+3. Если вы используете Eclipse, обновите ваш проект Eclipse и сделать чистой.
+
+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` с `res/xml/cordova.xml` в соответствии`framework/res/xml/cordova.xml`.
+
+## Обновление до 1.4.0 от 1.3.0
+
+1. Удалить `phonegap-1.3.0.jar` из проекта `libs` каталог.
+
+2. Добавить `phonegap-1.4.0.jar` в проект `libs` каталог.
+
+3. Если вы используете Eclipse, обновите ваш проект Eclipse и сделать чистой.
+
+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.3.0 от 1.2.0
+
+1. Удалить `phonegap-1.2.0.jar` из проекта `libs` каталог.
+
+2. Добавить `phonegap-1.3.0.jar` в проект `libs` каталог.
+
+3. Если вы используете Eclipse, обновите ваш проект Eclipse и сделать чистой.
+
+4. Скопируйте новый `phonegap-1.3.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.2.0 от 1.1.0
+
+1. Удалить `phonegap-1.1.0.jar` из проекта `libs` каталог.
+
+2. Добавить `phonegap-1.2.0.jar` в проект `libs` каталог.
+
+3. Если вы используете Eclipse, обновите ваш проект Eclipse и сделать чистой.
+
+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.1.0 1.0.0
+
+1. Удалить `phonegap-1.0.0.jar` из проекта `libs` каталог.
+
+2. Добавить `phonegap-1.1.0.jar` в проект `libs` каталог.
+
+3. Если вы используете Eclipse, обновите ваш проект Eclipse и сделать чистой.
+
+4. Скопируйте новый `phonegap-1.1.0.js` в ваш проект.
+
+5. Обновить ваш HTML, чтобы использовать новый `phonegap-1.1.0.js` файл.
+
+6. Обновление `res/xml/plugins.xml` в соответствии`framework/res/xml/plugins.xml`.
+
+## Обновление до 1.0.0 от 0.9.6
+
+1. Удалить `phonegap-0.9.6.jar` из проекта `libs` каталог.
+
+2. Добавить `phonegap-1.0.0.jar` в проект `libs` каталог.
+
+3. Если вы используете Eclipse, обновите ваш проект Eclipse и сделать чистой.
+
+4. Скопируйте новый `phonegap-1.0.0.js` в ваш проект.
+
+5. Обновить ваш HTML, чтобы использовать новый `phonegap-1.0.0.js` файл.
+
+6. Добавить `res/xml/plugins.xml` в соответствии`framework/res/xml/plugins.xml`.
\ No newline at end of file
diff --git a/docs/ru/5.0.0/guide/platforms/android/webview.md b/docs/ru/5.0.0/guide/platforms/android/webview.md
new file mode 100644
index 0000000..1b6f412
--- /dev/null
+++ b/docs/ru/5.0.0/guide/platforms/android/webview.md
@@ -0,0 +1,113 @@
+---
+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.
+---
+
+# WebViews в Android
+
+В этом руководстве показано, как встраивать компонент Cordova WebView в рамках более крупных приложений Android. Дополнительные сведения о том, как эти компоненты могут взаимодействовать друг с другом смотрите раздел "Расширения приложения".
+
+Если вы не знакомы с Android, следует сначала ознакомиться с "Руководство для платформы Android" и установить последнюю версию Android перед тем как пробовать делать не обычное встраивание WebView в ваше приложение. Начиная с Cordova 1.9, платформа Android опирается на компонент `CordovaWebView`, который построен на устаревшем компоненте `CordovaActivity`, который был до версии 1.9.
+
+1. Следуя этим инструкциям, убедитесь, что у вас есть дистрибутив последней версии Cordova. Скачайте его с [cordova.apache.org][1] и распакуйте пакет для Android.
+
+2. Перейдите в каталог `/framework` пакета Android и запустить `ant jar` . Это создаёт `.jar` файл Cordova, вида `/framework/cordova-x.x.x.jar`.
+
+3. Скопируйте файл `.jar` в каталог `/libs` Android-проекта.
+
+4. Добавьте в приложение следующий файл `/res/xml/main.xml`, с `layout_height`, `layout_width` и `id` модицифированными в соответствии с нуждами приложения:
+
+ <org.apache.cordova.CordovaWebView
+ android:id="@+id/tutorialView"
+ android:layout_width="match_parent"
+ android:layout_height="match_parent" />
+
+
+5. Измените вашу деятельность так, чтобы этот класс реализовал `CordovaInterface`. Вы должны реализовать описанные методы этого интерфейса. Вы можете скопировать их из `/framework/src/org/apache/cordova/CordovaActivity.java`, или реализовать их самостоятельно. В следующем фрагменте кода показано простое приложение, которое опирается на интерфейс. Обратите внимание, что id упоминаемого окна соответствует `id` атрибут, указанный в XML-фрагменте показаном выше:
+
+ public class CordovaViewTestActivity extends Activity implements CordovaInterface {
+ CordovaWebView cwv;
+ /* Called when the activity is first created. */
+ @Override
+ public void onCreate(Bundle savedInstanceState) {
+ super.onCreate(savedInstanceState);
+ setContentView(R.layout.main);
+ cwv = (CordovaWebView) findViewById(R.id.tutorialView);
+ Config.init(this);
+ cwv.loadUrl(Config.getStartUrl());
+ }
+
+
+6. Если приложение должно использовать камеру, реализуйте следующее:
+
+ @Override
+ public void setActivityResultCallback(CordovaPlugin plugin) {
+ this.activityResultCallback = plugin;
+ }
+ /**
+ * Launch an activity for which you would like a result when it finished. When this activity exits,
+ * your onActivityResult() method is called.
+ *
+ * @param command The command object
+ * @param intent The intent to start
+ * @param requestCode The request code that is passed to callback to identify the activity
+ */
+ public void startActivityForResult(CordovaPlugin command, Intent intent, int requestCode) {
+ this.activityResultCallback = command;
+ this.activityResultKeepRunning = this.keepRunning;
+
+ // If multitasking turned on, then disable it for activities that return results
+ if (command != null) {
+ this.keepRunning = false;
+ }
+
+ // Start activity
+ super.startActivityForResult(intent, requestCode);
+ }
+
+ @Override
+ /**
+ * Called when an activity you launched exits, giving you the requestCode you started it with,
+ * the resultCode it returned, and any additional data from it.
+ *
+ * @param requestCode The request code originally supplied to startActivityForResult(),
+ * allowing you to identify who this result came from.
+ * @param resultCode The integer result code returned by the child activity through its setResult().
+ * @param data An Intent, which can return result data to the caller (various data can be attached to Intent "extras").
+ */
+ protected void onActivityResult(int requestCode, int resultCode, Intent intent) {
+ super.onActivityResult(requestCode, resultCode, intent);
+ CordovaPlugin callback = this.activityResultCallback;
+ if (callback != null) {
+ callback.onActivityResult(requestCode, resultCode, intent);
+ }
+ }
+
+
+7. Наконец, не забудьте добавить пул потоков, иначе у плагинов не будет потоков, на которых они будет выполняться:
+
+ @Override
+ public ExecutorService getThreadPool() {
+ return threadPool;
+ }
+
+
+8. Скопируйте файлы HTML и JavaScript приложения в каталог `/assets/www` проекта Android.
+
+9. Скопируйте `config.xml` файл из `/framework/res/xml` в каталог `/res/xml` проекта.
+
+ [1]: http://cordova.apache.org
\ No newline at end of file
diff --git a/docs/ru/5.0.0/guide/platforms/blackberry/config.md b/docs/ru/5.0.0/guide/platforms/blackberry/config.md
new file mode 100644
index 0000000..4b54a52
--- /dev/null
+++ b/docs/ru/5.0.0/guide/platforms/blackberry/config.md
@@ -0,0 +1,22 @@
+---
+
+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.
+---
+
+# BlackBerry конфигурации
+
+Ежевика полностью поддерживает [Виджет спецификации W3C][1] , а также проприетарные расширения ОПРАВЫ. Пожалуйста, смотрите полный [WebWorks ежевики документации относительно config.xml][2] для деталей.
+
+ [1]: http://www.w3.org/TR/widgets/
+ [2]: https://developer.blackberry.com/html5/documentation/working_with_config_xml_file_1866970_11.html
\ No newline at end of file
diff --git a/docs/ru/5.0.0/guide/platforms/blackberry/index.md b/docs/ru/5.0.0/guide/platforms/blackberry/index.md
new file mode 100644
index 0000000..a3ddbe3
--- /dev/null
+++ b/docs/ru/5.0.0/guide/platforms/blackberry/index.md
@@ -0,0 +1,164 @@
+---
+
+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.
+---
+
+# Руководство по платформы ежевики
+
+В этом руководстве показано, как настроить среду SDK для приложений для платформы ежевики до версии 10. Если вы хотите цели самой последней версии, смотрите в руководстве платформы BlackBerry 10. Смотрите ниже для более подробной информации конкретной платформы:
+
+* BlackBerry конфигурации
+* Модернизация BlackBerry
+* Ежевика плагины
+* Средства командной строки ежевики
+
+Средства командной строки относятся к версии до Cordova 3.0. Сведения о текущем интерфейсе см интерфейс командной строки.
+
+## Требования и поддержка
+
+Эта версия BlackBerry не поддерживается `cordova` средство, описанное в интерфейс командной строки, но отдельный набор средств командной строки. Скачайте дистрибутив Cordova от [cordova.apache.org][1].
+
+ [1]: http://cordova.apache.org/#download
+
+Cordova для BlackBerry опирается на [BlackBerry WebWorks framework][2], который доступен для Windows XP (32-разрядная), Windows 7 (32-разрядные и 64-бит) и Mac (OS X 10.6.4+). WebWorks приложения могут *только* быть развернут на следующих платформах ежевики:
+
+ [2]: https://bdsc.webapps.blackberry.com/html5
+
+* BlackBerry OS 5.0 и выше
+* BlackBerry PlayBook
+* Ежевика 10 (QNX)
+
+WebWorks требует Java Development Kit (JDK). Для Windows используйте 32-разрядной версии [Oracle JDK][3]. Java в устанавливается по умолчанию в Mac OS X, вплоть до версии 10.7, которая требует [отдельной установки][4]. Это также требует Apache Ant, который на Mac является частью установки Java. Windows версия доступна с [ant.apache.org][5].
+
+ [3]: http://www.oracle.com/technetwork/java/javase/downloads/index.html#jdk
+ [4]: http://support.apple.com/kb/DL1421
+ [5]: http://ant.apache.org/bindownload.cgi
+
+## Установите SDK
+
+Скачать и установить соответствующий WebWorks SDK для вашего развития. BlackBerry PlayBook и BlackBerry смартфон WebWorks SDK можно загрузить из следующих источников.
+
+* \[BlackBerry PlayBook SDK\] (https://developer.blackberry.com/html5/download/#playbook) и [Adobe Air SDK][6]
+
+* \[Ежевики Smartphones SDK\] (https://developer.blackberry.com/html5/download/#smartphones)
+
+ [6]: http://www.adobe.com/devnet/air/air-sdk-download.html
+
+## Зарегистрироваться для ключей подписи
+
+Если вы хотите опубликовать приложение на мире App ежевики, или на фактическом устройстве, вам будет нужно зарегистрировать для набора бесплатные ключи подписывания кода. Для этого заполните [BlackBerry клавиш бланке заказа][7]. Как только вы получите ваши ключи подписи, они требуют установки. Смотрите [веб-сайт BlackBerry HTML5/WebWorks][8] для получения информации.
+
+ [7]: https://www.blackberry.com/SignedKeys
+ [8]: https://developer.blackberry.com/html5/documentation/signing_setup_bb10_apps_2008396_11.html
+
+## Установить Кордова
+
+Скачайте и распакуйте последнюю копию [Кордова][1].
+
+## Создание нового проекта
+
+* Открыть терминал командной строки и перейдите к где вы распаковали Cordova.
+
+* Существует каталог для каждой платформы, которая поддерживает Cordova. Перейдите к `blackberry` каталог.
+
+* `blackberry`Каталог содержит несколько подкаталогов. `example`Каталог содержит полный проект Cordova. Копия `example` каталог в другое место на вашем компьютере и перемещаться там.
+
+* Редактировать `project.properties` файла для указания WebWorks SDK, вы используете. Например ниже приведены соответствующие параметры для BlackBerry PlayBook, смартфон BlackBerry (OS5-7) или BlackBerry 10 (QNX):
+
+ playbook.bbwp.dir=C:\\Program Files\\Research In Motion\\BlackBerry WebWorks SDK for TabletOS 2.1.0.6\\bbwp
+ blackberry.bbwp.dir=C:\\Program Files\\Research In Motion\\BlackBerry WebWorks Packager
+ qnx.bbwp.dir=C:\\Program Files (x86)\\Research In Motion\\BlackBerry 10 WebWorks SDK 1.0.2.9
+
+
+Они соответствуют параметрам, которые указываются при построении проекта. Первый раз при запуске этих команд, они создают приложения «HelloWorld»:
+
+ cordova/build playbook
+ cordova/build blackberry
+ cordova/build qnx
+
+
+Вместе с SDK необходимо зарегистрировать ключ подписи кода и отладки маркер. Ключ подписи позволяет распространять приложения через BlackBerry World. Маркер отладки позволяет проверить неподписанные приложения на BlackBerry эмуляторе или устройстве. Вам не нужно создавать самостоятельно и установить маркер отладки; Если ввести пароль хранилища ключей, сценарий построения создает и устанавливает маркер отладки для вас. Чтобы настроить ключ подписи, перейдите на веб-сайт BlackBerry для получения, убедившись в том сохранить пароль, указанный вами. Затем запустите `blackberry-signer` Утилита, которая входит в состав SDK. Ежевика предоставляет более подробную информацию здесь:
+
+* [Зарегистрироваться для вашего кода, ключ подписи][9]
+
+* [Настройка компьютера для подписи кода][10]
+
+* [полное руководство по настройке среды SDK][11]
+
+ [9]: https://www.blackberry.com/SignedKeys/codesigning.html
+ [10]: http://developer.blackberry.com/html5/documentation/set_up_for_signing.html
+ [11]: http://developer.blackberry.com/native/documentation/bb10/com.qnx.doc.native_sdk.quickstart/topic/set_up_your_environment.html
+
+## Развертывание в эмулятор
+
+Эмуляторов смартфонов blackBerry доступны только на Windows. BlackBerry PlayBook Эмуляторы требуют VMWare Player (Windows) или VMWare Fusion (Mac OS X). WebWorks SDK предоставляет по умолчанию эмулятор, но дополнительные Эмуляторы доступны [через ежевику][12].
+
+ [12]: http://us.blackberry.com/developers/resources/simulators.jsp
+
+Из каталога проекта, типа `./cordova/run <target>` , заменяя `<target>` либо с `qnx` , `playbook` , или `blackberry` . Обратите внимание, что для BlackBerry 10 и пьес, эмулятор виртуальный образ уже должен быть запущен.
+
+Смотрите ниже для получения дополнительной информации:
+
+* [BlackBerry PlayBook][13]
+
+* [Смартфон blackBerry][14]
+
+ [13]: https://developer.blackberry.com/html5/documentation/using_the_tablet_simulator_1866980_11.html
+ [14]: https://developer.blackberry.com/html5/documentation/run_your_app_on_smartphone_sim_1876976_11.html
+
+Для BlackBerry Playbook, отредактируйте `project.properties` для настройки файл `playbook.sim.ip` и `playbook.sim.password` Свойства. Эмулятор IP-адрес доступен через **Параметры** приложения на начальном экране. Включить **безопасности и конфиденциальности → режим развития** параметр для отображения адреса. Пароль можно также задать в закладке **безопасность и конфиденциальность** .
+
+Смартфон BlackBerry, отредактируйте `project.properties` для настройки файл `blackberry.sim.dir` и `blackberry.sim.bin` Свойства. Вам нужно бежать разделителей пути при задании пути каталогов в Windows, например:`C:\\Program
+Files\\BlackBerry\\Simulator`.
+
+После того, как эмулятор установлена и запущена, выполните одно из следующих действий, чтобы установить приложение на главном экране:
+
+ cordova/run playbook
+ cordova/run blackberry
+
+
+Если вы пробуждены ли устройство подключено к вашему компьютеру, ответить без.
+
+**Примечание:** На BlackBerry OS 5, приложение установлено в `Downloads` каталог.
+
+## Развернуть устройстве
+
+Для развертывания приложения на устройство, он должен быть подключен, и вы должны быть зарегистрированы для кода ключей подписи, как описано выше. Также, для развертывания приложения на BlackBerry PlayBook, **Параметры → Безопасность → режим развития** должна быть включена опция.
+
+Измените на BlackBerry PlayBook, `project.properties` файл и изменить следующие действия, чтобы отразить IP и пароль устройства как descibed выше, вместе с подписания пароль ключа, вы создали:
+
+Из каталога проекта, типа `./cordova/run <target>` , заменяя `<target>` либо с `qnx` , `playbook` , или`blackberry`.
+
+На смартфон BlackBerry (OS5-7), укажите `blackberry.sigtool.password` свойства как подписи пароль ключа.
+
+Затем от каталога проекта, выполните одну из команд бы посмотреть приложение в эмулятор:
+
+ cordova/run playbook
+ cordova/run blackberry
+
+
+Если вы пробуждены ли устройство подключено к вашему компьютеру, ответьте Да.
+
+**Примечание:** На BlackBerry OS 5, приложение установлено в `Downloads` каталог.
+
+## Дополнительная информация
+
+Следующие статьи может помочь решить общие проблемы при разработке приложений для платформы BlackBerry WebWorks:
+
+* [Ежевика WebWorks развития ловушек][15]
+
+* [Лучшие практики для упаковки приложений WebWorks][16]
+
+ [15]: http://supportforums.blackberry.com/t5/Web-and-WebWorks-Development/Common-BlackBerry-WebWorks-development-pitfalls-that-can-be/ta-p/624712
+ [16]: https://bdsc.webapps.blackberrycom/html5/documentation/ww_developing/bestpractice_compiling_ww_apps_1873324_11.html
\ No newline at end of file
diff --git a/docs/ru/5.0.0/guide/platforms/blackberry/plugin.md b/docs/ru/5.0.0/guide/platforms/blackberry/plugin.md
new file mode 100644
index 0000000..d52b171
--- /dev/null
+++ b/docs/ru/5.0.0/guide/platforms/blackberry/plugin.md
@@ -0,0 +1,102 @@
+---
+
+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.
+---
+
+# BlackBerry плагины
+
+В этом руководстве показано, как разработать эхо плагин на ежевике. Руководство по разработке плагин обеспечивает широкий обзор, с которой вы уже должны быть знакомы, и это руководство забирает где он листья. Кроме того Скачайте [Cordova BlackBerry репозитория][1].
+
+ [1]: https://git-wip-us.apache.org/repos/asf?p=cordova-blackberry-webworks.git;a=summary
+
+`Cordova-BlackBerry`Проект позволяет развернуть к приборам ежевики как факел, полужирный и пьес. Playbook использует другой код базы чем других портативных устройств BlackBerry, для которых необходимо дублировать ваши усилия в области развития. В этом руководстве основное внимание на портативные устройства, а не таблетки. (В будущем, это руководство должны охватывать обе платформы).
+
+Эхо плагин по существу возвращает все сообщения пользователя предоставляет `window.echo` функции:
+
+ window.echo = function(str, callback) {
+ cordova.exec(callback, function(err) {
+ callback('Nothing to echo.');
+ }, "Echo", "echo", [str]);
+ };
+
+
+## Изменение plugins.xml
+
+Вашего проекта `www/plugins.xml` Каталог содержит все необходимые ссылки на проекте Cordova плагины. Добавить дополнительные ссылки так что когда `cordova.exec` это называется, Кордова знает как сопоставить `Echo` аргумент `cordova.exec` для `Echo` класс, который мы хотим написать изначально:
+
+ <feature name="Echo">
+ <param name="blackberry-package" value="org.apache.cordova.echo.Echo" />
+ </feature>
+
+
+## Добавление Echo.java
+
+Если вы заметили структуры атрибута value, вы увидите определенный путь, что приводит к эхо плагин. В корневом каталоге Cordova BlackBerry WebWorks репо, найдите каталог, называемый `framework` . Этот каталог содержит весь исходный код, который изначально работает на ежевике. Перейдите к `framework/ext/src/org/apache/cordova` . На данный момент вы увидите все плагин directorys, внутри которого содержится исходный код. Так что добавьте каталог эхо для `framework/ext/src/org/apache/cordova/echo` и создайте файл с именем `Echo.java` в`framework/ext/src/org/apache/cordova/echo/Echo.java`.
+
+## Написание Echo.java
+
+Основная идея написания плагина является создание класса, который расширяет плагин класс и метод, называемый `execute` вернуться `PluginResult` класс. Любой звонок, сделанный в `cordova.exec` проходит в действие для выполнения в пределах класса, а также аргументы. В этом случае «эхо» являются действия, мы хотим выполнять в пределах класса «Эхо» и [силы] аргументы, которые мы проходим в.
+
+ 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;
+ /**
+ * A simple plugin to demonstrate how to build a plugin for BlackBerry
+ * Basically echos back the msg that a user calls to this plugin
+ */
+ 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` , поэтому мы будем только проверять для этого. Если наш плагин больше действий, это просто вопрос добавления более условной тесты для этих действий.
+
+Затем мы будем захватить сообщения, поступающие из аргументов, которая поставляется параметр args. Мы можем взять первый аргумент, просто делать`String theMsg = args.getString(0);`.
+
+Мы сделаем некоторые проверки ошибок и если сообщение выглядит нормально, мы будет создан экземпляр нового PluginResult со статусом ОК: `PluginResult.Status.OK` и вернуть сообщение: `theMsg` . После этого мы вернуть результат который быть передан обратно в JavaScript, чтобы быть уволены в успех обратного вызова. Если что-то не удается, мы можем вернуть различные состояния исключения, как `PluginResult.Status.ERROR` , `PluginResult.Status.JSON_EXCEPTION` , или `PluginResult.Status.INVALID_ACTION` . При передаче обратно, эти типы результатов огонь сбой обратного вызова в JavaScript.
+
+## Обновление .jar в www каталоге вашего проекта
+
+Добавил `Echo.java` необходимо обновить в проекте. Для создания `.jar` файла, перейдите к BlackBerry WebWorks репо корневой каталог и запустить `ant` команду:
+
+ муравей обновление - Dproject.path="~/path_to_my_project»
+
+
+Это создает новый `.jar` файл в `build/ext` каталог. Копия `build/ext/cordova.jar` файл в ваш `project/www/ext` каталог.
+
+Если все пойдет хорошо, что позволяет использовать плагин эхо в BlackBerry.
\ No newline at end of file
diff --git a/docs/ru/5.0.0/guide/platforms/blackberry/tools.md b/docs/ru/5.0.0/guide/platforms/blackberry/tools.md
new file mode 100644
index 0000000..6dc9702
--- /dev/null
+++ b/docs/ru/5.0.0/guide/platforms/blackberry/tools.md
@@ -0,0 +1,60 @@
+---
+
+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.
+---
+
+# BlackBerry средства командной строки
+
+`cordova`Утилиты командной строки является высокого уровня инструментом, который позволяет создавать приложения на нескольких платформах за один раз. Старой версии Cordova framework предоставляет наборы средств командной строки для каждой платформы. Чтобы использовать их в качестве альтернативы для CLI, вам нужно скачать эту версию Cordova с [cordova.apache.org][1]. Загружаемый файл содержит отдельные архивы для каждой платформы. Разверните узел платформы, которую вы хотите цели. Инструменты, описанные здесь обычно доступны в верхнего уровня `bin` каталог, в противном случае консультироваться с файлом **README** для получения более подробной направлениях.
+
+ [1]: http://cordova.apache.org
+
+## Создание проекта
+
+Запустите `create` команду, указав существующий путь к проекту, идентификатор домена реверсивные пакета и отображаемое имя приложения. Вот синтаксис для Mac и Windows:
+
+ $ /path/to/cordova-blackberry-webworks/bin/create /path/to/my_new_project com.example.project_name ProjectName
+ $ /path/to/cordova-blackberry-webworks/bin/create.bat /path/to/my_new_project com.example.project_name ProjectName
+
+
+**Примечание:** Платформа ежевики игнорирует заполнитель имя пакета ( `com.example.project_name` ), но он по-прежнему требуется для использования в кросс платформенных средств.
+
+## Построение проекта
+
+Для BlackBerry проектов, пожалуйста убедитесь, что вы настроить `project.properties` файл в корневом каталоге вашего проекта Кордова. Вам нужно сделать это для снабжения вашего BlackBerry, подписание пароль ключа и указать различные места для BlackBerry WebWorks SDK и BlackBerry эмулятор исполняемые файлы.
+
+ $ /path/to/my_new_project/cordova/build <platform>
+ $ /path/to/my_new_project/cordova/build.bat <platform>
+
+
+## Запуск эмулятора
+
+Для BlackBerry проектов, пожалуйста убедитесь, что вы настроить `project.properties` файл в корневом каталоге проекта Cordova. Вам нужно сделать это для снабжения вашего BlackBerry, подписание пароль ключа и указать различные места для BlackBerry WebWorks SDK и BlackBerry эмулятор исполняемые файлы.
+
+ $ /path/to/my_new_project/cordova/run <platform>
+
+
+а затем выберите «Нет», когда появится:
+
+ У вас есть BlackBerry устройства, подключенного к вашему компьютеру? (y/n) $ /path/to/my_new_project/cordova/run <platform>
+
+
+а затем выберите «Нет», когда появится:
+
+ У вас есть BlackBerry устройства, подключенного к вашему компьютеру? (y/n)
+
+
+## Ведение журнала
+
+К сожалению в настоящее время поддерживается потокового журналы прямо с устройства. Однако BlackBerry предлагает встроенную поддержку веб-инспектор для Playbook и BlackBerry смартфонов BlackBerry OS версии 7.0 и выше. Вы также можете получить доступ журналы вашего приложения (включая любые вызовы `console.log` ) на вашем устройстве, удерживая нажатой клавишу "ALT '' от домашнего экрана и введя '' lglg'' ключи.
\ No newline at end of file
diff --git a/docs/ru/5.0.0/guide/platforms/blackberry/upgrade.md b/docs/ru/5.0.0/guide/platforms/blackberry/upgrade.md
new file mode 100644
index 0000000..53e6407
--- /dev/null
+++ b/docs/ru/5.0.0/guide/platforms/blackberry/upgrade.md
@@ -0,0 +1,430 @@
+---
+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.
+---
+
+# Обновление BlackBerry
+
+В этом руководстве показано, как изменить проекты BlackBerry при обновлении старых версий Cordova. Большинство этих инструкций применимы для проектов, созданных со старым набором средств командной строки, которые предшествуют утилите CLI `cordova`. Смотрите раздел "Интерфейс командной строки" для получения информации как обновить версию CLI.
+
+## Обновление проектов 2.8.0 до 2.9.0
+
+BlackBerry 10:
+
+1. Загрузите и распакуйте исходный код Cordova 2.9.0 в постоянное место на вашем жестком диске, например в `~/Cordova-2.9.0`.
+
+2. Закройте все запущенные инструменты SDK: Eclipse, Momentics и тому подобное.
+
+3. Перейдите в каталог, где вы положили загруженный выше исходный код, используя unix-терминал: Terminal.app, Bash, Cygwin и т.д.
+
+4. Создайте новый проект, как описано в "Руководство по инструментам BlackBerry". Это станет домашним каталогом вашего обновленного проекта.
+
+5. Скопировать исходный код вашего проекта из каталога `/www` старого проекта в каталог `/www` нового проекта.
+
+6. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `cordova.js`.
+
+### BlackBerryOS/Playbook
+
+1. Загрузите и распакуйте исходный код Cordova 2.9.0 в постоянное место на вашем жестком диске, например в `~/Cordova-2.9.0`.
+
+2. Закройте все запущенные инструменты SDK: Eclipse, Momentics и тому подобное.
+
+3. Перейдите в каталог, где вы положили загруженный выше исходный код, используя unix-терминал: Terminal.app, Bash, Cygwin и т.д.
+
+4. Создайте новый проект, как описано в разделе "Руководство инструментов BlackBerry". Вам нужны будут ресурсы из нового проекта.
+
+5. Скопируйте файл `www/cordova.js` из нового проекта в папке `www` и удалите файл `www/cordova.js`.
+
+6. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `cordova.js`.
+
+7. Скопируйте каталог `native` из нового проекта в существующий проект, перезаписывая старый каталог `native`.
+
+8. Скопируйте каталог `lib` из нового проекта в существующий проект, перезаписывая старый каталог `lib`.
+
+9. Скопируйте каталог `cordova` из нового проекта в существующий проект, перезаписывая старый каталог `cordova`.
+
+## Обновление проектов 2.7.0 до 2.8.0
+
+BlackBerry 10:
+
+BlackBerry 10 использует новый инструмент CLI и управляет основными API как плагинами. Инструкции по миграции проекта в новый проект, а не обновление существующего проекта, в связи со сложностью обновления старого проекта. Также обратите внимание, что cordova js скрипт файл теперь называется «cordova.js» и больше не содержит строку версии.
+
+1. Загрузите и распакуйте исходный код Cordova 2.8.0 в постоянное место на вашем жестком диске, например в `~/Cordova-2.8.0`.
+
+2. Закройте все запущенные инструменты SDK: Eclipse, Momentics и тому подобное.
+
+3. Перейдите в каталог, где вы положили загруженный выше исходный код, используя unix-терминал: Terminal.app, Bash, Cygwin и т.д.
+
+4. Создайте новый проект, как описано в "Руководство по инструментам BlackBerry". Это станет домашним каталогом вашего обновленного проекта.
+
+5. Скопировать исходный код вашего проекта из каталога `/www` старого проекта в каталог `/www` нового проекта.
+
+6. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `cordova.js`.
+
+BlackBerryOS/Playbook:
+
+1. Загрузите и распакуйте исходный код Cordova 2.8.0 в постоянное место на вашем жестком диске, например в `~/Cordova-2.8.0`.
+
+2. Закройте все запущенные инструменты SDK: Eclipse, Momentics и тому подобное.
+
+3. Перейдите в каталог, где вы положили загруженный выше исходный код, используя unix-терминал: Terminal.app, Bash, Cygwin и т.д.
+
+4. Создайте новый проект, как описано в разделе "Руководство инструментов BlackBerry". Вам нужны будут ресурсы из нового проекта.
+
+5. Скопируйте файл `www/cordova.js` из нового проекта в папке `www` и удалите файл `www/cordova.js`.
+
+6. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `cordova.js`.
+
+7. Скопируйте каталог `native` из нового проекта в существующий проект, перезаписывая старый каталог `native`.
+
+8. Скопируйте каталог `lib` из нового проекта в существующий проект, перезаписывая старый каталог `lib`.
+
+9. Скопируйте каталог `cordova` из нового проекта в существующий проект, перезаписывая старый каталог `cordova`.
+
+## Обновление проектов 2.6.0 до 2.7.0
+
+1. Загрузите и распакуйте исходный код Cordova 2.7.0 в постоянное место на вашем жестком диске, например в `~/Cordova-2.7.0`.
+
+2. Закройте все запущенные инструменты SDK: Eclipse, Momentics и тому подобное.
+
+3. Перейдите в каталог, где вы положили загруженный выше исходный код, используя unix-терминал: Terminal.app, Bash, Cygwin и т.д.
+
+4. Создайте новый проект, как описано в разделе "Руководство инструментов BlackBerry". Вам нужны будут ресурсы из нового проекта.
+
+5. Скопируйте файл `www/cordova-2.7.0.js` из нового проекта в папке `www` и удалите файл `www/cordova-2.6.0.js`.
+
+6. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `cordova.js`.
+
+7. Скопируйте каталог `native` из нового проекта в существующий проект, перезаписывая старый каталог `native`.
+
+8. Скопируйте каталог `lib` из нового проекта в существующий проект, перезаписывая старый каталог `lib`.
+
+9. Скопируйте каталог `cordova` из нового проекта в существующий проект, перезаписывая старый каталог `cordova`.
+
+## Обновление до 2.6.0 от 2.5.0
+
+Обновление в каталог загрузки PhoneGap:
+
+Рекомендуется, что вы скачать свежую копию всего каталога.
+
+Однако здесь новые детали, необходимые для частичного обновления:
+
+1. Обновить файл cordova.blackberry.js в `Phonegap-2.6.0/lib/blackberry/javascript` каталог.
+
+2. Обновление `ext` , `ext-air` , и `ext-qnx` в `Phonegap-2.6.0/lib/blackberry/framework` каталог.
+
+3. Обновление `build.xml` файл в `Phonegap-2.6.0/lib/blackberry` каталог.
+
+4. Обновление `Phonegap-2.6.0/lib/blackberry/bin` каталог.
+
+5. Обновление `VERSION` файл в `Phonegap-2.6.0/lib/blackberry` каталог.
+
+Обновление каталога `example/` или перенос существующего проекта:
+
+1. Откройте каталог `www`, который содержит приложение.
+
+2. Удалить и обновить файл .jar в `ext/` каталог.
+
+3. Обновить содержимое `ext-air/` каталог.
+
+4. Обновить содержимое `ext-qnx/` каталог.
+
+5. Скопируйте новый `cordova-2.6.0.js` в ваш проект.
+
+6. Обновить ваш HTML, чтобы использовать новый `cordova-2.6.0.js` файл.
+
+## Обновление до 2.5.0 с 2.4.0
+
+Обновление в каталог загрузки PhoneGap:
+
+Рекомендуется, что вы скачать свежую копию всего каталога.
+
+Однако здесь новые детали, необходимые для частичного обновления:
+
+1. Обновить файл cordova.blackberry.js в `Phonegap-2.5.0/lib/blackberry/javascript` каталог.
+
+2. Обновление `ext` , `ext-air` , и `ext-qnx` в `Phonegap-2.5.0/lib/blackberry/framework` каталог.
+
+3. Обновление `build.xml` файл в `Phonegap-2.5.0/lib/blackberry` каталог.
+
+4. Обновление `Phonegap-2.5.0/lib/blackberry/bin` каталог.
+
+5. Обновление `VERSION` файл в `Phonegap-2.5.0/lib/blackberry` каталог.
+
+Обновление в примере / каталог или перенос существующего проекта:
+
+1. Откройте каталог `www`, который содержит приложение.
+
+2. Удалить и обновить файл .jar в `ext/` каталог.
+
+3. Обновить содержимое `ext-air/` каталог.
+
+4. Обновить содержимое `ext-qnx/` каталог.
+
+5. Скопируйте новый `cordova-2.5.0.js` в ваш проект.
+
+6. Обновить ваш HTML, чтобы использовать новый `cordova-2.5.0.js` файл.
+
+## Обновление до 2.4.0 от 2.3.0
+
+Обновление только `www` Каталог:
+
+1. Откройте каталог `www`, который содержит приложение.
+
+2. Удалить и обновить файл .jar в `ext/` каталог.
+
+3. Обновить содержимое `ext-air/` каталог.
+
+4. Скопируйте новый `cordova-2.4.0.js` в ваш проект.
+
+ * Если playbook, тогда обновите .js файл в каталоге `playbook/`.
+ * Если BlackBerry 10, затем обновить файл JS в `qnx/` каталог.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-2.4.0.js` файл.
+
+Обновление каталога sample (т.е., обновления с использованием инструментов ant):
+
+1. Открытые `sample/lib/` каталог.
+
+2. Обновить файл .jar в `cordova.2.3.0/ext/` каталог.
+
+3. Обновить содержимое `cordova.2.3.0/ext-air/` каталог.
+
+4. Обновить содержимое `cordova.2.3.0/ext-qnx/` каталог.
+
+5. Обновить файл .js в `cordova.2.3.0/javascript/` каталог.
+
+6. Открытые `sample/lib/` каталог и переименовать `cordova.2.3.0/` Каталог`cordova.2.4.0/`.
+
+7. Наберите `ant blackberry build` или `ant playbook build` чтобы обновить каталог `www` с обновленной версией Cordova.
+
+8. Откройте каталог `www` и обновить ваш HTML, чтобы использовать новый файл `cordova-2.4.0.js`.
+
+## Обновление до 2.3.0 от 2.2.0
+
+Обновление только `www` Каталог:
+
+1. Откройте каталог `www`, который содержит приложение.
+
+2. Удалить и обновить файл .jar в `ext/` каталог.
+
+3. Обновить содержимое `ext-air/` каталог.
+
+4. Скопируйте новый `cordova-2.3.0.js` в ваш проект.
+
+ * Если playbook, тогда обновите .js файл в каталоге `playbook/`.
+ * Если BlackBerry 10, затем обновить файл JS в `qnx/` каталог.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-2.3.0.js` файл.
+
+Обновление каталога sample (т.е., обновления с использованием инструментов ant):
+
+1. Открытые `sample/lib/` каталог.
+
+2. Обновить файл .jar в `cordova.2.2.0/ext/` каталог.
+
+3. Обновить содержимое `cordova.2.2.0/ext-air/` каталог.
+
+4. Обновить содержимое `cordova.2.2.0/ext-qnx/` каталог.
+
+5. Обновить файл .js в `cordova.2.2.0/javascript/` каталог.
+
+6. Открытые `sample/lib/` каталог и переименовать `cordova.2.2.0/` Каталог`cordova.2.3.0/`.
+
+7. Наберите `ant blackberry build` или `ant playbook build` чтобы обновить каталог `www` с обновленной версией Cordova.
+
+8. Откройте каталог `www` и обновить ваш HTML, чтобы использовать новый файл `cordova-2.3.0.js`.
+
+## Обновление до 2.2.0 из 2.1.0
+
+Обновление только каталог www:
+
+1. Откройте каталог `www`, который содержит приложение.
+
+2. Удалить и обновить файл .jar в `ext/` каталог.
+
+3. Обновить содержимое `ext-air/` каталог.
+
+4. Скопируйте новый `cordova-2.2.0.js` в ваш проект.
+
+ * Если playbook, тогда обновите .js файл в каталоге `playbook/`.
+ * Если BlackBerry 10, затем обновить файл JS в `qnx/` каталог.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-2.2.0.js` файл.
+
+Обновление каталога sample (т.е., обновления с использованием инструментов ant):
+
+1. Открытые `sample/lib/` каталог.
+
+2. Обновить файл .jar в `cordova.2.1.0/ext/` каталог.
+
+3. Обновить содержимое `cordova.2.1.0/ext-air/` каталог.
+
+4. Обновить содержимое `cordova.2.1.0/ext-qnx/` каталог.
+
+5. Обновить файл .js в `cordova.2.1.0/javascript/` каталог.
+
+6. Открытые `sample/lib/` каталог и переименовать `cordova.2.1.0/` Каталог`cordova.2.2.0/`.
+
+7. Наберите `ant blackberry build` или `ant playbook build` чтобы обновить каталог `www` с обновленной версией Cordova.
+
+8. Откройте каталог `www` и обновить ваш HTML, чтобы использовать новый файл `cordova-2.2.0.js`.
+
+## Обновление до 2.1.0 с 2.0.0
+
+Обновление только `www` Каталог:
+
+1. Откройте каталог `www`, который содержит приложение.
+
+2. Удалить и обновить файл .jar в `ext/` каталог.
+
+3. Обновить содержимое `ext-air/` каталог.
+
+4. Скопируйте новый `cordova-2.1.0.js` в ваш проект.
+
+ * Если playbook, тогда обновите .js файл в каталоге `playbook/`.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-2.1.0.js` файл.
+
+Обновление каталога sample (т.е., обновления с использованием инструментов ant):
+
+1. Открытые `sample/lib/` каталог.
+
+2. Обновить файл .jar в `cordova.2.0.0/ext/` каталог.
+
+3. Обновить содержимое `cordova.2.0.0/ext-air/` каталог.
+
+4. Обновить файл .js в `cordova.2.0.0/javascript/` каталог.
+
+5. Открытые `sample/lib/` каталог и переименовать `cordova.2.0.0/` Каталог`cordova.2.1.0/`.
+
+6. Наберите `ant blackberry build` или `ant playbook build` чтобы обновить каталог `www` с обновленной версией Cordova.
+
+7. Откройте каталог `www` и обновить ваш HTML, чтобы использовать новый файл `cordova-2.1.0.js`.
+
+## Обновление до 2.0.0 от 1.9.0
+
+Обновление только `www` Каталог:
+
+1. Откройте каталог `www`, который содержит приложение.
+
+2. Удалить и обновить файл .jar в `ext/` каталог.
+
+3. Обновить содержимое `ext-air/` каталог.
+
+4. Скопируйте новый `cordova-2.0.0.js` в ваш проект.
+
+ * Если playbook, тогда обновите .js файл в каталоге `playbook/`.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-2.0.0.js` файл.
+
+6. Обновите файл `www/plugins.xml`. Два плагины изменили свои имена служб/пространства имен. Измените старые записи для плагинов Захвата и Контакты:
+
+ <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"/>
+
+
+Обновление каталога sample (т.е., обновления с использованием инструментов ant):
+
+1. Открытые `sample/lib/` каталог.
+
+2. Обновить файл .jar в `cordova.1.9.0/ext/` каталог.
+
+3. Обновить содержимое `cordova.1.9.0/ext-air/` каталог.
+
+4. Обновить файл .js в `cordova.1.9.0/javascript/` каталог.
+
+5. Открытые `sample/lib/` каталог и переименовать `cordova.1.9.0/` Каталог`cordova.2.0.0/`.
+
+6. Наберите `ant blackberry build` или `ant playbook build` чтобы обновить каталог `www` с обновленной версией Cordova.
+
+7. Откройте каталог `www` и обновить ваш HTML, чтобы использовать новый файл `cordova-2.0.0.js`.
+
+8. Откройте каталог `www` и обновите файл `www/plugins.xml`. Два плагины изменили свои имена служб/пространства имен. Измените старые записи для плагинов Захвата и Контакты:
+
+ <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.8.0 от 1.7.0
+
+Обновление только `www` Каталог:
+
+1. Откройте каталог `www`, который содержит приложение.
+
+2. Удалить и обновить файл .jar в `ext/` каталог.
+
+3. Обновить содержимое `ext-air/` каталог.
+
+4. Скопируйте новый `cordova-1.8.0.js` в ваш проект.
+
+ * Если playbook, тогда обновите .js файл в каталоге `playbook/`.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-1.8.0.js` файл.
+
+6. Обновите файл `www/plugins.xml`. Два плагины изменили свои имена служб/пространства имен. Измените старые записи для плагинов Захвата и Контакты:
+
+ <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"/>
+
+
+Обновление каталога sample (т.е., обновления с использованием инструментов ant):
+
+1. Открытые `sample/lib/` каталог.
+
+2. Обновить файл .jar в `cordova.1.7.0/ext/` каталог.
+
+3. Обновить содержимое `cordova.1.7.0/ext-air/` каталог.
+
+4. Обновить файл .js в `cordova.1.7.0/javascript/` каталог.
+
+5. Открытые `sample/lib/` каталог и переименовать `cordova.1.7.0/` Каталог`cordova.1.8.0/`.
+
+6. Наберите `ant blackberry build` или `ant playbook build` чтобы обновить каталог `www` с обновленной версией Cordova.
+
+7. Откройте каталог `www` и обновить ваш HTML, чтобы использовать новый файл `cordova-1.8.0.js`.
+
+8. Откройте каталог `www` и обновите файл `www/plugins.xml`. Два плагины изменили свои имена служб/пространства имен. Измените старые записи для плагинов Захвата и Контакты:
+
+ <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"/>
\ No newline at end of file
diff --git a/docs/ru/5.0.0/guide/platforms/blackberry/upgrading.md b/docs/ru/5.0.0/guide/platforms/blackberry/upgrading.md
new file mode 100644
index 0000000..5db2359
--- /dev/null
+++ b/docs/ru/5.0.0/guide/platforms/blackberry/upgrading.md
@@ -0,0 +1,423 @@
+---
+
+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.
+---
+
+# Модернизация BlackBerry
+
+В этом руководстве показано, как изменить BlackBerry проекты для обновления старых версий Cordova. Эти инструкции относятся к проектов, созданных с старого набора средств командной строки, которые предшествуют `cordova` утилиты CLI. Увидеть интерфейс командной строки для информации как обновить версию инфраструктуры CLI.
+
+## Проекты модернизации 2.8.0 2.9.0
+
+Ежевика 10:
+
+1. Скачайте и распакуйте Cordova 2.9.0 Источник в постоянное место на вашем жестком диске, например`~/Cordova-2.9.0`.
+
+2. Закройте все запущенные инструментов SDK: Eclipse, Momentics и тому подобное.
+
+3. Перейдите в каталог, где вы положили загруженных исходных выше, используя unix как терминал: Terminal.app, Баш, Cygwin и т.д.
+
+4. Создайте новый проект, как описано в BlackBerry утилиты командной строки. Это становится дома обновленный проект.
+
+5. Скопировать источник вашего проекта из старого проекта `/www` каталог нового проекта `/www` каталог.
+
+6. Обновить ссылку сценарий Кордова в ваш `www/index.html` файл (и любые другие файлы, которые содержат ссылку на сценарий) для указания на новый `cordova.js` файл.
+
+### BlackberryOS обеспечение/Playbook
+
+1. Скачайте и распакуйте Cordova 2.9.0 Источник в постоянное место на вашем жестком диске, например`~/Cordova-2.9.0`.
+
+2. Закройте все запущенные инструментов SDK: Eclipse, Momentics и тому подобное.
+
+3. Перейдите в каталог, где вы положили загруженных исходных выше, используя unix как терминал: Terminal.app, Баш, Cygwin и т.д.
+
+4. Создайте новый проект, как описано в iOS утилиты командной строки. Вам нужен активов от этого нового проекта.
+
+5. Копия `www/cordova.js` файл из нового проекта в ваш `www` каталог и удалить ваш `www/cordova.js` файл.
+
+6. Обновить ссылку сценарий Кордова в ваш `www/index.html` файл (и любые другие файлы, которые содержат ссылку на сценарий) для указания на новый `cordova.js` файл.
+
+7. Копия `native` каталог из нового проекта в существующий проект, перезаписывая старый `native` каталог.
+
+8. Копия `lib` каталог из нового проекта в существующий проект, перезаписывая старый `lib` каталог.
+
+9. Копия `cordova` каталог из нового проекта в существующий проект, перезаписывая старый `cordova` каталог.
+
+## Проекты модернизации 2.7.0 2.8.0
+
+Ежевика 10:
+
+BlackBerry 10 использует новый инструмент CLI и управляет основные API как плагины. Инструкции миграции проекта в новый проект, а не обновление существующего проекта, в связи со сложностью обновления старого проекта. Также обратите внимание, что Кордова js скрипт файл теперь называется «cordova.js» и больше не содержит строку версии.
+
+1. Скачайте и распакуйте Cordova 2.8.0 Источник в постоянное место на вашем жестком диске, например`~/Cordova-2.8.0`.
+
+2. Закройте все запущенные инструментов SDK: Eclipse, Momentics и тому подобное.
+
+3. Перейдите в каталог, где вы положили загруженных исходных выше, используя unix как терминал: Terminal.app, Баш, Cygwin и т.д.
+
+4. Создайте новый проект, как описано в BlackBerry утилиты командной строки. Это становится дома обновленный проект.
+
+5. Скопировать источник вашего проекта из старого проекта `/www` каталог нового проекта `/www` каталог.
+
+6. Обновить ссылку сценарий Кордова в ваш `www/index.html` файл (и любые другие файлы, которые содержат ссылку на сценарий) для указания на новый `cordova.js` файл.
+
+BlackberryOS обеспечение/пьес:
+
+1. Скачайте и распакуйте Cordova 2.8.0 Источник в постоянное место на вашем жестком диске, например`~/Cordova-2.8.0`.
+
+2. Закройте все запущенные инструментов SDK: Eclipse, Momentics и тому подобное.
+
+3. Перейдите в каталог, где вы положили загруженных исходных выше, используя unix как терминал: Terminal.app, Баш, Cygwin и т.д.
+
+4. Создайте новый проект, как описано в iOS утилиты командной строки. Вам нужен активов от этого нового проекта.
+
+5. Копия `www/cordova.js` файл из нового проекта в ваш `www` каталог и удалить ваш `www/cordova.js` файл.
+
+6. Обновить ссылку сценарий Кордова в ваш `www/index.html` файл (и любые другие файлы, которые содержат ссылку на сценарий) для указания на новый `cordova.js` файл.
+
+7. Копия `native` каталог из нового проекта в существующий проект, перезаписывая старый `native` каталог.
+
+8. Копия `lib` каталог из нового проекта в существующий проект, перезаписывая старый `lib` каталог.
+
+9. Копия `cordova` каталог из нового проекта в существующий проект, перезаписывая старый `cordova` каталог.
+
+## Проекты модернизации 2.6.0 2.7.0
+
+1. Скачайте и распакуйте Cordova 2.7.0 Источник в постоянное место на вашем жестком диске, например`~/Cordova-2.7.0`.
+
+2. Закройте все запущенные инструментов SDK: Eclipse, Momentics и тому подобное.
+
+3. Перейдите в каталог, где вы положили загруженных исходных выше, используя unix как терминал: Terminal.app, Баш, Cygwin и т.д.
+
+4. Создайте новый проект, как описано в BlackBerry утилиты командной строки. Вам нужен активов от этого нового проекта.
+
+5. Копия `www/cordova-2.7.0.js` файл из нового проекта в ваш `www` каталог и удалить ваш `www/cordova-2.6.0.js` файл.
+
+6. Обновить ссылку сценарий Кордова в ваш `www/index.html` файл (и любые другие файлы, которые содержат ссылку на сценарий) для указания на новый `cordova-2.7.0.js` файл.
+
+7. Копия `native` каталог из нового проекта в существующий проект, перезаписывая старый `native` каталог.
+
+8. Копия `lib` каталог из нового проекта в существующий проект, перезаписывая старый `lib` каталог.
+
+9. Копия `cordova` каталог из нового проекта в существующий проект, перезаписывая старый `cordova` каталог.
+
+## Обновление до 2.6.0 с 2.5.0
+
+Обновления в каталог загрузки PhoneGap:
+
+Рекомендуется, что вы скачать свежую копию всего каталога.
+
+Однако вот новые детали, необходимые для частичного обновления:
+
+1. Обновить файл cordova.blackberry.js в `Phonegap-2.6.0/lib/blackberry/javascript` каталог.
+
+2. Обновление `ext` , `ext-air` , и `ext-qnx` в `Phonegap-2.6.0/lib/blackberry/framework` каталог.
+
+3. Обновление `build.xml` файл в `Phonegap-2.6.0/lib/blackberry` каталог.
+
+4. Обновление `Phonegap-2.6.0/lib/blackberry/bin` каталог.
+
+5. Обновление `VERSION` файл в `Phonegap-2.6.0/lib/blackberry` каталог.
+
+Обновление `example/` каталог или перенос существующего проекта:
+
+1. Открыть ваш `www/` каталог, который содержит приложение.
+
+2. Удалить и обновить файл .jar в `ext/` каталог.
+
+3. Обновить содержимое `ext-air/` каталог.
+
+4. Обновить содержимое `ext-qnx/` каталог.
+
+5. Скопируйте новый `cordova-2.6.0.js` в ваш проект.
+
+6. Обновить ваш HTML, чтобы использовать новый `cordova-2.6.0.js` файл.
+
+## Обновление до 2.5.0 с 2.4.0
+
+Обновления в каталог загрузки PhoneGap:
+
+Рекомендуется, что вы скачать свежую копию всего каталога.
+
+Однако вот новые детали, необходимые для частичного обновления:
+
+1. Обновить файл cordova.blackberry.js в `Phonegap-2.5.0/lib/blackberry/javascript` каталог.
+
+2. Обновление `ext` , `ext-air` , и `ext-qnx` в `Phonegap-2.5.0/lib/blackberry/framework` каталог.
+
+3. Обновление `build.xml` файл в `Phonegap-2.5.0/lib/blackberry` каталог.
+
+4. Обновление `Phonegap-2.5.0/lib/blackberry/bin` каталог.
+
+5. Обновление `VERSION` файл в `Phonegap-2.5.0/lib/blackberry` каталог.
+
+Обновление в примере / каталог или перенос существующего проекта:
+
+1. Открыть ваш `www/` каталог, который содержит приложение.
+
+2. Удалить и обновить файл .jar в `ext/` каталог.
+
+3. Обновить содержимое `ext-air/` каталог.
+
+4. Обновить содержимое `ext-qnx/` каталог.
+
+5. Скопируйте новый `cordova-2.5.0.js` в ваш проект.
+
+6. Обновить ваш HTML, чтобы использовать новый `cordova-2.5.0.js` файл.
+
+## Обновление 2.4.0 с 2.3.0
+
+Обновление только `www` каталога:
+
+1. Открыть ваш `www/` каталог, который содержит приложение.
+
+2. Удалить и обновить файл .jar в `ext/` каталог.
+
+3. Обновить содержимое `ext-air/` каталог.
+
+4. Скопируйте новый `cordova-2.4.0.js` в ваш проект.
+
+ * Если пьес, а затем обновление .js файл в `playbook/` каталог.
+ * Если BlackBerry 10, затем обновить файл JS в `qnx/` каталог.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-2.4.0.js` файл.
+
+Обновление каталога образцов (например, обновления средствами муравей):
+
+1. Открытые `sample/lib/` каталог.
+
+2. Обновление файла .jar в `cordova.2.3.0/ext/` каталог.
+
+3. Обновить содержимое `cordova.2.3.0/ext-air/` каталог.
+
+4. Обновить содержимое `cordova.2.3.0/ext-qnx/` каталог.
+
+5. Обновить файл .js в `cordova.2.3.0/javascript/` каталог.
+
+6. Открытые `sample/lib/` каталог и переименовать `cordova.2.3.0/` Каталог`cordova.2.4.0/`.
+
+7. Тип `ant blackberry build` или `ant playbook build` для обновления `www/` каталог с обновленный Cordova.
+
+8. Открытые `www/` каталог и обновить ваш HTML, чтобы использовать новый `cordova-2.4.0.js` файл.
+
+## Обновления 2.3.0 из 2.2.0
+
+Обновление только `www` каталога:
+
+1. Открыть ваш `www/` каталог, который содержит приложение.
+
+2. Удалить и обновить файл .jar в `ext/` каталог.
+
+3. Обновить содержимое `ext-air/` каталог.
+
+4. Скопируйте новый `cordova-2.3.0.js` в ваш проект.
+
+ * Если пьес, а затем обновление .js файл в `playbook/` каталог.
+ * Если BlackBerry 10, затем обновить файл JS в `qnx/` каталог.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-2.3.0.js` файл.
+
+Обновление каталога образцов (например, обновления средствами муравей):
+
+1. Открытые `sample/lib/` каталог.
+
+2. Обновление файла .jar в `cordova.2.2.0/ext/` каталог.
+
+3. Обновить содержимое `cordova.2.2.0/ext-air/` каталог.
+
+4. Обновить содержимое `cordova.2.2.0/ext-qnx/` каталог.
+
+5. Обновить файл .js в `cordova.2.2.0/javascript/` каталог.
+
+6. Открытые `sample/lib/` каталог и переименовать `cordova.2.2.0/` Каталог`cordova.2.3.0/`.
+
+7. Тип `ant blackberry build` или `ant playbook build` для обновления `www/` каталог с обновленный Cordova.
+
+8. Открытые `www/` каталог и обновить ваш HTML, чтобы использовать новый `cordova-2.3.0.js` файл.
+
+## Обновление до 2.2.0 из 2.1.0
+
+Обновление только www каталога:
+
+1. Открыть ваш `www/` каталог, который содержит приложение.
+
+2. Удалить и обновить файл .jar в `ext/` каталог.
+
+3. Обновить содержимое `ext-air/` каталог.
+
+4. Скопируйте новый `cordova-2.2.0.js` в ваш проект.
+
+ * Если пьес, а затем обновление .js файл в `playbook/` каталог.
+ * Если BlackBerry 10, затем обновить файл JS в `qnx/` каталог.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-2.2.0.js` файл.
+
+Обновление каталога образцов (например, обновления средствами муравей):
+
+1. Открытые `sample/lib/` каталог.
+
+2. Обновление файла .jar в `cordova.2.1.0/ext/` каталог.
+
+3. Обновить содержимое `cordova.2.1.0/ext-air/` каталог.
+
+4. Обновить содержимое `cordova.2.1.0/ext-qnx/` каталог.
+
+5. Обновить файл .js в `cordova.2.1.0/javascript/` каталог.
+
+6. Открытые `sample/lib/` каталог и переименовать `cordova.2.1.0/` Каталог`cordova.2.2.0/`.
+
+7. Тип `ant blackberry build` или `ant playbook build` для обновления `www/` каталог с обновленный Cordova.
+
+8. Открытые `www/` каталог и обновить ваш HTML, чтобы использовать новый `cordova-2.2.0.js` файл.
+
+## Обновление 2.1.0 с 2.0.0
+
+Обновление только `www` каталога:
+
+1. Открыть ваш `www/` каталог, который содержит приложение.
+
+2. Удалить и обновить файл .jar в `ext/` каталог.
+
+3. Обновить содержимое `ext-air/` каталог.
+
+4. Скопируйте новый `cordova-2.1.0.js` в ваш проект.
+
+ * Если пьес, а затем обновление .js файл в `playbook/` каталог.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-2.1.0.js` файл.
+
+Обновление каталога образцов (например, обновления средствами муравей):
+
+1. Открытые `sample/lib/` каталог.
+
+2. Обновление файла .jar в `cordova.2.0.0/ext/` каталог.
+
+3. Обновить содержимое `cordova.2.0.0/ext-air/` каталог.
+
+4. Обновить файл .js в `cordova.2.0.0/javascript/` каталог.
+
+5. Открытые `sample/lib/` каталог и переименовать `cordova.2.0.0/` Каталог`cordova.2.1.0/`.
+
+6. Тип `ant blackberry build` или `ant playbook build` для обновления `www/` каталог с обновленный Cordova.
+
+7. Открытые `www/` каталог и обновить ваш HTML, чтобы использовать новый `cordova-2.1.0.js` файл.
+
+## Обновление до 2.0.0 от 1.9.0
+
+Обновление только `www` каталога:
+
+1. Открыть ваш `www/` каталог, который содержит приложение.
+
+2. Удалить и обновить файл .jar в `ext/` каталог.
+
+3. Обновить содержимое `ext-air/` каталог.
+
+4. Скопируйте новый `cordova-2.0.0.js` в ваш проект.
+
+ * Если пьес, а затем обновление .js файл в `playbook/` каталог.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-2.0.0.js` файл.
+
+6. Обновление вашего `www/plugins.xml` файл. Два плагины изменил их лейблом служба имен. Измените старые записи для захвата и контакт плагины от:
+
+ <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. Открытые `sample/lib/` каталог.
+
+2. Обновление файла .jar в `cordova.1.9.0/ext/` каталог.
+
+3. Обновить содержимое `cordova.1.9.0/ext-air/` каталог.
+
+4. Обновить файл .js в `cordova.1.9.0/javascript/` каталог.
+
+5. Открытые `sample/lib/` каталог и переименовать `cordova.1.9.0/` Каталог`cordova.2.0.0/`.
+
+6. Тип `ant blackberry build` или `ant playbook build` для обновления `www/` каталог с обновленный Cordova.
+
+7. Открытые `www/` каталог и обновить ваш HTML, чтобы использовать новый `cordova-2.0.0.js` файл.
+
+8. Открытые `www/` каталог и обновление `plugins.xml` файл. Два плагины изменил их лейблом служба имен. Измените старые записи для захвата и контакт плагины от:
+
+ <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.8.0 с 1.7.0
+
+Обновление только `www` каталога:
+
+1. Открыть ваш `www/` каталог, который содержит приложение.
+
+2. Удалить и обновить файл .jar в `ext/` каталог.
+
+3. Обновить содержимое `ext-air/` каталог.
+
+4. Скопируйте новый `cordova-1.8.0.js` в ваш проект.
+
+ * Если пьес, а затем обновление .js файл в `playbook/` каталог.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-1.8.0.js` файл.
+
+6. Обновление вашего `www/plugins.xml` файл. Два плагины изменил их лейблом служба имен. Измените старые записи для захвата и контакт плагины от:
+
+ <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. Открытые `sample/lib/` каталог.
+
+2. Обновление файла .jar в `cordova.1.7.0/ext/` каталог.
+
+3. Обновить содержимое `cordova.1.7.0/ext-air/` каталог.
+
+4. Обновить файл .js в `cordova.1.7.0/javascript/` каталог.
+
+5. Открытые `sample/lib/` каталог и переименовать `cordova.1.7.0/` Каталог`cordova.1.8.0/`.
+
+6. Тип `ant blackberry build` или `ant playbook build` для обновления `www/` каталог с обновленный Cordova.
+
+7. Открытые `www/` каталог и обновить ваш HTML, чтобы использовать новый `cordova-1.8.0.js` файл.
+
+8. Открытые `www/` каталог и обновление `plugins.xml` файл. Два плагины изменил их лейблом служба имен. Измените старые записи для захвата и контакт плагины от:
+
+ <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"/>
\ No newline at end of file
diff --git a/docs/ru/5.0.0/guide/platforms/blackberry10/config.md b/docs/ru/5.0.0/guide/platforms/blackberry10/config.md
new file mode 100644
index 0000000..559ae21
--- /dev/null
+++ b/docs/ru/5.0.0/guide/platforms/blackberry10/config.md
@@ -0,0 +1,38 @@
+---
+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.
+---
+
+# Конфигурации BlackBerry 10
+
+Файл `config.xml` управляет основные параметрами приложения, которые применяются к каждому приложению и экземпляру CordovaWebView. Этот раздел описывает настройки, которые применяются только к BlackBerry 10. Смотрите [Файл config.xml][1] для получения информации о глобальных параметрах конфигурации.
+
+ [1]: config_ref_index.md.html#The%20config.xml%20File
+
+* `ChildBrowser` (`disable` или значение по умолчанию `enable` ): отключает дочерние окна браузера. По умолчанию приложения запускает окно вторичного браузера для отображения ресурсов, через `window.open()` или указав `_blank` в качестве целевого объекта привязки. Укажите `disable` чтобы переопределить это поведение по умолчанию.
+
+ <preference name="ChildBrowser" value="disable"/>
+
+
+* `PopupBlocker` (`enable` или значение по умолчанию `disable` ): Включает блокировщик всплывающих окон, который предотвращает вызовы `window.open()` . По умолчанию всплывающие окна отображаются во второстепенном окне браузера. Установка предпочтение `enable` предотвращает отображение на всех.
+
+ <preference name="PopupBlocker" value="enable"/>
+
+
+* `WebSecurity` (`disable` или значение по умолчанию `enable` ): значение `disable` для переопределения параметров веб-безопасности, позволяя доступ к удаленному содержимому из неизвестных источников. Эта настройка предназначена только для удобства разработки только, так что удалите его перед упаковкой приложения для распространения. Для опубликованных приложений, все URI должен быть известны и разрешены с использованием `<access>` элемента, описанный в разделе "Инструкция по доступу к внешним ресурсам".
+
+ <preference name="WebSecurity" value="disable"/>
\ No newline at end of file
diff --git a/docs/ru/5.0.0/guide/platforms/blackberry10/index.md b/docs/ru/5.0.0/guide/platforms/blackberry10/index.md
new file mode 100644
index 0000000..70fe0ce
--- /dev/null
+++ b/docs/ru/5.0.0/guide/platforms/blackberry10/index.md
@@ -0,0 +1,257 @@
+---
+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.
+---
+
+# Руководство для платформы BlackBerry 10
+
+В этом руководстве показано, как настроить среду SDK для развертывания приложений Cordova на устройствах BlackBerry 10. Для предыдущих версий BlackBerry вы должны использовать другую версию SDK и другой набор средств командной строки, описанные в руководстве платформы BlackBerry. Для BlackBerry 10 вам необходимо установить SDK независимо от того, хотите ли вы использовать кросс платформенное CLI Cordova для разработки или более узкий набор платформо-ориентированных средств командной строки. Для сравнения двух вариантов разработки см. Обзор. Подробную информацию о каждом способе смотрите в разделе "Руководство по инструментам командной строки BlackBerry 10".
+
+## Требования
+
+Среда разработки доступна на Windows, Mac и Linux.
+
+Разработчикам следует использовать утилиту `cordova` в сочетании с BlackBerry WebWorks SDK или BlackBerry Native SDK. Смотрите раздел "Интерфейс командной строки" для получения информации как установить `cordova`, добавлять проекты, построить и развернуть их для каждой платформы.
+
+Симулятор BlackBerry 10:
+
+* Процессор: Intel dual core 2.0 ГГц/AMD Athlon 4200 + или выше
+* Место на диске: 10 ГБ
+* Оперативной памяти: 4 ГБ
+* Виртуализация: одно из следующих действий:
+ * **Технология виртуализации Intel** (VT, VT-x, vmx) → [Intel VT-x список поддерживаемых процессоров][1]
+ * **AMD виртуализации** (AMD-V, SVM) (С мая 2006 года все процессоры AMD включают AMD-V за исключением Sempron).
+
+ [1]: http://ark.intel.com/products/virtualizationtechnology
+
+Дополнительные сведения о требованиях: [Требования к симулятору BB10][2].
+
+ [2]: http://developer.blackberry.com/devzone/develop/simulator/simulator_systemrequirements.html
+
+## Установите BlackBerry WebWorks SDK
+
+Скачать и установить BlackBerry WebWorks SDK с [developer.blackberry.com][3]
+
+ [3]: https://developer.blackberry.com/html5/download/
+
+Программа установки добавит инструменты командной строки к вашем пути. В зависимости от вашей ОС может потребоваться открыть новое окно терминала или повторно войти в систему.
+
+## Установите BlackBerry Native SDK
+
+Если вам нужно скомпилировать в машинный код, например, при разработке собственного плагина, будет необходимо установить BlackBerry Native SDK.
+
+Чтобы получить BlackBerry Native SDK, скачать и установить IDE для BlackBerry с [developer.blackberry.com][4], а затем используя IDE, установить BlackBerry Native SDK. После установки вам нужно добавить свои средства командной строки к системному пути.
+
+ [4]: http://developer.blackberry.com/native/download/
+
+В Windows:
+
+* Перейти к **мой компьютер → Свойства → Дополнительно → Переменные среды**.
+
+* Добавьте каталог установки Native SDK к пути, например:
+
+ ;C:\bbndk\host_10_1_0_132\win32\x86\usr\bin\
+
+
+На Mac и Linux:
+
+* Отредактируйте файл `~/.bash_profile`, добавив строку, наподобие нижеуказанной, изменив ее в зависимости от того, где был установлен Native SDK:
+
+ $ export PATH=${PATH}:/Applications/bbndk/host_10_1_0_132/darwin/x86/usr/bin/
+
+
+ или для Native SDK 10.2:
+
+ $ export PATH=${PATH}:/Applications/Momentics.app/host_10_2_0_15/darwin/x86/usr/bin/
+
+
+* Выполните следующие действия, чтобы применить изменения в текущем сеансе:
+
+ $ источника ~/.bash_profile
+
+
+Если у вас есть любые проблемы со средой, используя Native SDK выполните из командной строки, соответствующий для вашей платформы файл, расположенный в пути установки:
+
+* На Windows → оболочку MS-DOS:
+
+ C:\> \bbndk\bbndk-env_xx_xx_xx_xxxx.bat
+
+
+* На Windows → оболочка bash git:
+
+ $ `\bbndk\bbndk-env_xx_xx_xx_xxxx.bat`
+
+
+* На Linux → установлен в качестве пользователя root:
+
+ $ `./opt/bbndk/bbndk-env_xx_xx_xx_xxxx.sh`
+
+
+* На Linux → установлен как не root пользователя:
+
+ $ `./home/username/bbndk/bbndk-env_xx_xx_xx_xxxx.sh`
+
+
+* На Mac:
+
+ $ `/Developer/SDKs/bbndk/bbndk-env_xx_xx_xx_xxxx.sh`
+
+
+## Настройка для подписывания
+
+Если вы хотите проверить на устройстве или распространять приложения через BlackBerry World, ваша система должна быть сконфигурирована для подписи кода.
+
+Для получения ключа подписи, перейдите к \[Форма покупки ключей BlackBerry\] (https://www.blackberry.com/SignedKeys/codesigning.html).
+
+Выберите первый флажок: «для BlackBerry10 приложений, разработанных с использованием BlackBerry NDK» и затем войти на сайт или создайте новый BBID.
+
+Введите пароль и нажмите кнопку «Get Token», чтобы загрузить bbidtoken.csk. Сохраните этот файл в расположение по умолчанию для вашей ОС, которая будет отображаться на странице загрузки.
+
+Последним шагом является создания сертификата подписи:
+
+ $ blackberry-keytool -genkeypair -storepass <password> -author 'Your Name’
+
+
+## Создание проекта
+
+Используйте утилиту `cordova` для настройки нового проекта, как описано в разделе "Интерфейс командной строки Cordova". Например выполните в каталоге исходного кода:
+
+ $ cordova create hello com.example.hello
+ $ cd hello
+ $ cordova platform add blackberry10
+ $ cordova build
+
+
+## Развертывание на эмулятор
+
+Если вы хотите запустить эмулятор устройства, загрузите и установите симулятор BlackBerry 10.
+
+* [Скачать][4]
+* [Приступая к работе][5]
+
+ [5]: http://developer.blackberry.com/devzone/develop/simulator/blackberry_10_simulator_start.html
+
+Перед тестированием приложения на эмуляторе или устройстве, необходимо включить режим разработки.
+
+Запустить образ эмулятора, затем выберите **Настройки** на главном экране:
+
+![][6]
+
+ [6]: img/guide/platforms/blackberry10/bb_home.png
+
+Перейдите к разделу **Безопасности и конфиденциальность → Режим разработки** и включить опцию:
+
+![][7]
+
+ [7]: img/guide/platforms/blackberry10/bb_devel.png
+
+Дополнительный набор утилит командной строки включаются при установке платформы BlackBerry 10 для вашего проекта. Следующая команда, в данном случае вызваная из каталога проекта верхнего уровня, связывает целевой объект с именем *emu* с IP-адресом указанным выше.
+
+* В Windows:
+
+ $ platforms\blackberry10\cordova\target.bat add emu 169.254.0.1 -t simulator
+
+
+* На Mac/Linux:
+
+ $ platforms/blackberry10/cordova/target add emu 169.254.0.1 -t simulator
+
+
+Затем выполните команду `emulate` для просмотра приложения:
+
+ $ cordova emulate blackberry10
+
+
+## Развертывание на устройство
+
+Чтобы развернуть на устройстве, убедитесь, что оно подключено к компьютеру. Включить режим разработки и получить IP-адрес как описано в разделе по эмулятору выше. Вам также нужно будет получить ПИН-код из приложения **Настройки** в разделе **Об устройстве → Оборудование**:
+
+![][8]
+
+ [8]: img/guide/platforms/blackberry10/bb_pin.png
+
+Запустите утилиту командной строки чтобы связать имя с IP адресом, паролем устройства и ПИН-кодом.
+
+* В Windows:
+
+ $ platforms\blackberry10\cordova\target.bat add mydevice 169.254.0.1 -t device --password 123456 --pin FFFF972E
+
+
+* На Mac/Linux:
+
+ $ platforms/blackberry10/cordova/target add mydevice 169.254.0.1 -t device --password 123456 --pin FFFF972E
+
+
+где:
+
+* `--password` указывает на пароль, необходимый чтобы разблокировать устройство.
+
+* `--pin` относится к PIN устройства, полученный из приложения **Настройки**.
+
+Затем выполните команду `run` для просмотра приложений:
+
+ $ cordova run blackberry10
+
+
+Если маркер отладки еще не настроен для устройства, сообщение об ошибке предложит вам использовать скрипт платформы run, c паролем который вы указали при регистрации для ключей подписи.
+
+* В Windows:
+
+ $ platforms\blackberry10\cordova\run.bat --device --keystorepass mysecret
+
+
+* На Mac/Linux:
+
+ $ platforms/blackberry10/cordova/run --device --keystorepass mysecret
+
+
+## Отладка с WebInspector
+
+При отладке на устройстве или эмуляторе, вы можете запустить WebInspector удаленно для просмотра внутреннего состояния приложения. Запрос отображает URL-адрес, который позволяет вам подключиться к приложению через стандартный веб-браузер. Для получения дополнительной информации см. [Отладка с помощью WebInspector][9].
+
+ [9]: http://developer.blackberry.com/html5/documentation/web_inspector_overview_1553586_11.html
+
+## Создание релиз версии
+
+По умолчанию команда `cordova build` создает файл неподписанный файл пакета *.bar* который подходит для тестирования на устройстве или симуляторе.
+
+Используйте `--release` для создания релиз версии подходящей для распространения через BlackBerry World.
+
+ $ cordova build --release --keystorepass <signing password>
+
+
+Параметр `--keystorepass` определяет пароль, заданные при настройке вашего компьютера для подписи приложений.
+
+## Развертывание в других местах
+
+В инструкциях выше предполагается что устройство подключено через USB или симулятор выполняется на локальном компьютере. Также можно развернуть приложение в других местах.
+
+Дополнительный набор утилит командной строки включаются при установке платформы BlackBerry 10 для вашего проекта. Следующая команда, в данном случае вызваная из каталога проекта верхнего уровня, связывает целевой объект с именем *emu* с IP-адресом.
+
+* В Windows:
+
+ $ platforms\blackberry10\cordova\build.bat --release --keystorepass mysecret
+
+
+* На Mac/Linux:
+
+ $ platforms/blackberry10/cordova/build --release --keystorepass mysecret
+
+
+После того, как цель определена, вы можете передавать ее команде run с помощью `--target`:
+
+ $ cordova run blackberry10 --target=emu
\ No newline at end of file
diff --git a/docs/ru/5.0.0/guide/platforms/blackberry10/plugin.md b/docs/ru/5.0.0/guide/platforms/blackberry10/plugin.md
new file mode 100644
index 0000000..25b876f
--- /dev/null
+++ b/docs/ru/5.0.0/guide/platforms/blackberry10/plugin.md
@@ -0,0 +1,203 @@
+---
+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.
+---
+
+# Плагины для BlackBerry 10
+
+Этот раздел содержит сведения о том, как реализовать код родной плагин на платформе BlackBerry 10. Прежде чем читать это, прочтите секции "Архитектура плагинов" для обзор структуры плагина и его общего JavaScript интерфейса. Этот раздел продолжает демонстрировать образец плагина *echo*, который взаимодействует с WebView Cordova на стороне платформы и наоборот.
+
+Плагин Echo просто возвращает любую строку, которую функция `window.echo` отправляет из JavaScript:
+
+ window.echo = function(str, callback) {
+ cordova.exec(callback, function(err) {
+ callback('Nothing to echo.');
+ }, "Echo", "echo", [str]);
+ };
+
+
+Cordova плагин для BlackBerry 10 содержит как JavaScript так и код платформы, которые общаются друг с другом через фреймворк, предоставляемый JNEXT. Каждый плагин должен также включать файл `plugin.xml`.
+
+## Создание класса плагина
+
+Для создания основной части вашего плагина, откройте BlackBerry 10 NDK IDE и выберите **File → New → BlackBerry Project → Native Extension → BlackBerry 10**. Введите нужное имя и расположение проекта, затем нажмите кнопку **Finish**.
+
+Проект, созданный в среде IDE содержит примеры кода для плагина памяти. Вы можете перезаписать или изменить эти файлы для реализации собственного функционала:
+
+* `*name*_js.hpp`: Заголовок C++ для кода JNEXT.
+
+* `*name*_js.cpp`: Код C++ для JNEXT.
+
+Родной интерфейс для модуля JNEXT может быть просмотрен в файле заголовка плагина, расположенном в каталоге public проекта. К вашим услугам также константы и сервисных функций, доступных из кода платформы. Плагин должен быть производным от класса `JSExt`, который определен в `plugin.h` . То есть необходимо реализовать следующий класс:
+
+ class JSExt
+ {
+ public:
+ virtual ~JSExt() {};
+ virtual string InvokeMethod( const string& strCommand ) = 0;
+ virtual bool CanDelete( void ) = 0;
+ private:
+ std::string m_id;
+ };
+
+
+Плаин должн включать заголовочный файл `plugin.h`. В примере `Echo`, вы используете `JSExt` как указано в следующем `echo_js.hpp` файле:
+
+ #include "../public/plugin.h"
+ #include <string>
+
+ #ifndef ECHO_JS_H_
+ #define ECHO_JS_H_
+
+ class Echo : public JSExt
+ {
+ public:
+ explicit Echo(const std::string& id);
+ virtual ~Echo();
+ virtual std::string InvokeMethod(const std::string& command);
+ virtual bool CanDelete();
+ private:
+ std::string m_id;
+ };
+
+ #endif // ECHO_JS_H_
+
+
+`m_id` атрибут содержит `JNEXT` id для объекта, который передается в класс в качестве аргумента конструктора. Он необходим для стороны платформы чтобы вызывать события на стороне JavaScript. Метод `CanDelete` определяет, может ли быть удален объект определенный на строне платформы. Функция `InvokeMethod` вызывается в результате запроса со стороны JavaScript для вызова метода из данного конкретного объекта. Единственный аргумент этой функции является строка, передаваемая из JavaScript, который анализируется этим методом для определения, какой из методов собственного объекта должен быть выполнен. Эти методы реализуются в `echo_js.cpp` . Вот функция `InvokeMethod` для `Echo`:
+
+ string Echo::InvokeMethod(const string& command) {
+
+ //parse command and args from string
+ int index = command.find_first_of(" ");
+ string strCommand = command.substr(0, index);
+ string strValue = command.substr(index + 1, command.length());
+
+ // Determine which function should be executed
+ if (strCommand == "echo") {
+ return strValue;
+ } else {
+ return "Unsupported Method";
+ }
+ }
+
+
+Плагин платформы должен также реализовывать следующие функции обратного вызова:
+
+* `extern char* onGetObjList( void );`
+
+* `extern JSExt* onCreateObject( const string& strClassName, const string& strObjId );`
+
+Функция `onGetObjList` возвращает разделенный запятыми список классов, поддерживаемых JNEXT. JNEXT использует эту функцию для определения набора классов, которые могут быть созданы JNEXT. Плагин `Echo` реализует следующе в `echo_js.cpp`:
+
+ char* onGetObjList() {
+ static char name[] = "Echo";
+ return name;
+ }
+
+
+Функция `onCreateObject` принимает два параметра. Первый, это имя запрашиваемого класса который должен быть создан для стороны JavaScript, с допустимыми именами как те которые были возвращены из `onGetObjList` . Вторым параметром является уникальный идентификатор объекта класса. Этот метод возвращает указатель на созданный объект плагина. Плагин `Echo` реализует следующе в `echo_js.cpp`:
+
+ JSExt* onCreateObject(const string& className, const string& id) {
+ if (className == "Echo") {
+ return new Echo(id);
+ }
+ return NULL;
+ }
+
+
+## Создание плагина JavaScript
+
+Плагин должен содержать следующие файлы JavaScript:
+
+* `client.js`: Это файл считается клиентской стороной и содержит API для Cordova-приложения. API в вызовах `client.js` делает вызовы к `index.js` . API в `client.js` также связывает функции обратного вызова с событиями, которые вызывают эти функции.
+
+* `index.js`: Cordova загружает `index.js` и делает его доступным через шлюз cordova.exec. Файл `client.js` делает вызовы к API в файле `index.js`, который в свою очередь делает вызов к JNEXT для взаимодействия со стороной платформы.
+
+Стороне клиента и сервера (`client.js` и `index.js`) взаимодействует через функцию `cordova.exec`. Файлу `client.js` нужно вызывать функцию `exec` и предоставить необходимые аргументы. Плагин `Echo` реализует следующее в файле `client.js`:
+
+ var service = "org.apache.cordova.blackberry.echo",
+ exec = cordova.require("cordova/exec");
+
+ module.exports = {
+ echo: function (data, success, fail) {
+ exec(success, fail, service, "echo", { data: data });
+ }
+ };
+
+
+Компонент `index.js` использует JNEXT для взаимодействия со стороной платформы. Присоединение функции конструктора с именем `Echo` к JNEXT позволяет выполнять следующие основные операции с помощью функции `init`:
+
+* Укажите необходимый модуль, экспортируемые со стороны платформы. Имя необходимого модуля должно соответствовать имени файла общей библиотеки (`.so` файл):
+
+ JNEXT.require("libecho")
+
+
+* Создайте объект используя полученный модуль и сохраните идентификатор, который был возвращен:
+
+ self.m_id = JNEXT.createObject("libecho.Echo");
+
+
+ Когда приложение вызывает функцию `echo` из `client.js` , которая в свою очередь, вызывает функцию `echo` из `index.js`, откуда объект `PluginResult` отправляет данные как ответ обратно в `client.js` . Так как аргумент `args`, передаваемый в функции был преобразован с помощью `JSON.stringfy()` и закодирован как `URIcomponent`, вам необходимо вызвать следующее:
+
+ data = JSON.parse(decodeURIComponent(args.data));
+
+
+Теперь вы можете отправить данные обратно, как показано ниже:
+
+ module.exports = {
+ echo: function (success, fail, args, env) {
+ var result = new PluginResult(args, env),
+ data = JSON.parse(decodeURIComponent(args.data)),
+ response = echo.getInstance().echo(data);
+ result.ok(response, false);
+ }
+ };
+
+
+## Архитектура плагинов
+
+Вы можете разместить артефакты плагина, включая файл `plugin.xml`, исходные файлы JavaScript и C++ и двоичные файлы `.so` в любой структуре каталогов, до тех пор, пока вы правильно указываете расположение файлов в файле `plugin.xml`. Вот типичная структура:
+
+***project_directory*** (раздел настроек plugin.xml)
+
+* **www** (>client.js)
+* **src**
+ * **blackberry10** (>index.js, **native** >*.cpp, *.hpp)
+ * **device** (>*двоичный файл* * .so)
+ * **simulator** (>*двоичный файл* * .so)
+
+В списке отображаются иерархические отношения между каталогами верхнего уровня. Скобки показывает содержимое данного каталога. Все имена каталогов отображаются полужирным шрифтом. Именам файлов предшествует знак `>`.
+
+## Файл *plugin.xml*
+
+Файл `plugin.xml` содержит пространства имен расширения и другие метаданные. Настройте плагин `Echo` следующим образом:
+
+ <plugin xmlns="http://www.phonegap.com/ns/plugins/1.0"
+ id="org.apache.cordova.blackberry.echo"
+ version="1.0.0">
+ <js-module src="www/client.js">
+ <merges target="navigator" />
+ </js-module>
+ <platform name="blackberry10">
+ <source-file src="src/blackberry10/index.js" />
+ <lib-file src="src/blackberry10/native/device/libecho.so" arch="device" />
+ <lib-file src="src/blackberry10/native/simulator/libecho.so" arch="simulator" />
+ <config-file target="www/config.xml" parent="/widget">
+ <feature name="org.apache.cordova.blackberry.echo" value="org.apache.cordova.blackberry.echo" />
+ </config-file>
+ </platform>
+ </plugin>
\ No newline at end of file
diff --git a/docs/ru/5.0.0/guide/platforms/blackberry10/tools.md b/docs/ru/5.0.0/guide/platforms/blackberry10/tools.md
new file mode 100644
index 0000000..2d382f3
--- /dev/null
+++ b/docs/ru/5.0.0/guide/platforms/blackberry10/tools.md
@@ -0,0 +1,141 @@
+---
+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.
+---
+
+# Руководство по инструментам командной строки BlackBerry 10
+
+Утилита командной строки `cordova` является инструментом высокого уровня, который позволяет вам создавать приложения сразу на нескольких платформах. Более старые версии фреймворка Cordova предоставляли наборы средств командной строки для каждой платформы. Чтобы использовать их в качестве альтернативы для CLI, вам нужно скачать эту версию Cordova с [cordova.apache.org][1]. Загружаемый файл содержит отдельные архивы для каждой платформы. Распакуйте платформу, для которой вы хотите разрабатывать. Инструменты, описанные здесь обычно доступны в каталоге верхнего уровня `bin`, в противном случае проконсультируйтесь с файлом **README** для получения более подробных указаний.
+
+ [1]: http://cordova.apache.org
+
+Сведения о низкоуровневом интерфейсе командной строки, который управляет плагинами смотрите в разделе "Использование Plugman для управления расширениями". Смотрите раздел "Расширения приложения" для подробной информации о том, как разрабатывать плагины.
+
+Если вам нужна помощь по любой команды, перечисленной ниже, введите команду вместе с аргументами `-h` или `-help`, которые поддерживаются всеми командами и которые предоставляют описания для каждого из имеющихся аргументов.
+
+## Создание приложения
+
+Команда `create` создает новый проект:
+
+ bin/create <path-to-project> <project-package> <project-name>
+
+
+где
+
+* `<path-to-project>` Указывает каталог, где вы хотите чтобы проект был создан
+
+* `<project-package>` Указывает идентификатор в стиле обратного именования доменов
+
+* `<project-name>` Задает отображаемое имя приложения
+
+**Примечание**: команда `create` загружает зависимости установки через команду `npm install`. В зависимости от разрешения системы и каталога установки может потребоваться права администратора. Если есть проблемы на OSX/Linux, запустите `sudo npm install` перед использованием команды `create`. На Windows, запустите `npm install` в командной строке, открытой с правами администратора.
+
+## Задать целевое устройство
+
+Команда `target` позволяет управлять эмулятором или устройствами BlackBerry, которые используются для тестирования приложения. Можно добавить или удалить целевое устройство или задать целевое устройство как цель для развертывания по умолчанию.
+
+### Добавьте целевой объект
+
+ <path-to-project>/cordova/target add <name> <ip-address> [-t | --type <device | simulator>] [-p | --password <password>] [--pin <device-pin>]
+
+
+где
+
+* `<name>` Указывает уникальное имя для целевого устройства.
+
+* `<ip-address>` Указывает IP-адрес устройства BlackBerry или симулятора.
+
+* `-p | --password <password>` Указывает пароль для устройства или эмулятора. Это необходимо, только если устройство или эмулятор защищен паролем.
+
+* `--pin <device-pin>` Указывает PIN устройства BlackBerry, который идентифицирует устройство как допустимый хост для маркера отладки. Этот аргумент является обязательным только при создании маркера отладки.
+
+### Удаление целевого устройства
+
+ <path-to-project>/cordova/target remove <name>
+
+
+### Задать целевое устройство по умолчанию
+
+ <path-to-project>/cordova/target default <name>
+
+
+## Построение приложения
+
+Команда `build` строит проект как файл .bar. Вы можете создавать приложения в режиме релиза, (который создает подписанный .bar файл) или в режиме отладки (который создает неподписанный .bar файл).
+
+### Построение приложения в режиме релиза
+
+ <path-to-project>/cordova/build release [-k | --keystorepass <password>] [-b | --buildId <number>] [-p | --params <params-JSON-file>]
+
+
+где
+
+* `-k | --keystorepass <password>` Указывает пароль, который вы определили, когда вы настроили ваш компьютер для подписи приложений.
+
+* `-b | --buildId <number>` Задает номер версии сборки приложения. Как правило это число должно увеличивается от предыдущей версии по мере создания новых подписанных версий. Этот аргумент является необязательным.
+
+* `-p | --params <params-JSON-file>` Определяет JSON файл, содержащий дополнительные параметры для передачи вызываемым инструменты. Этот аргумент является необязательным.
+
+### ППостроение приложения в режиме отладки
+
+ <path-to-project>/cordova/build debug [<target>] [-k | --keystorepass <password>] [-p | --params <params-JSON-file>] [-ll | --loglevel <error|warn|verbose>]
+
+
+где
+
+* `<target>` Указывает имя ранее добавленного целевого устройства. Если `<target>` не указан, используется устройство по умолчанию, если оно было задано. Этот аргумент необходим только если если вы хотите чтобы скрипт развернул приложение на устройстве BlackBerry, или эмуляторе и вы еще не создали целевое устройство по умолчанию. Кроме того если `<target>` – это устройство, то это устройство должно быть подключено к компьютеру через USB-соединение или должно быть подключено к той же сети Wi-Fi, что и ваш компьютер.
+
+* `-k | --keystorepass <password>` Указывает пароль, который вы определили, когда вы настроили ваш компьютер для подписи приложений. Этот пароль используется также для создания маркера отладки. Этот аргумент является требуется только если вы хотите чтобы скрипт создал и установил маркер отладки для вас.
+
+* `-p | --params <params-JSON-file>` Определяет JSON файл, содержащий дополнительные параметры передаваемые вызываемым инструментам.
+
+* `-ll | --loglevel <level>` Задает уровень ведения журнала. Уровень ведения журнала может быть одним из значений `error`, `warn`, или `verbose`.
+
+Если вы ранее задали целевое устройство по умолчанию (и ранее установили маркер отладки, если эта цель является устройством BlackBerry), вы можете запустить сценарий без аргументов и скрипт создат пакет вашего прилоежния и развернет его на целевое устройство по умолчанию. Например:
+
+ <path-to-project>/cordova/build debug
+
+
+## Запуск приложения
+
+Команда `run` развертывает последнее построение приложения на указанное устройство BlackBerry или эмулятор. Для развертывания приложения, необходимо задать целевое устройство:
+
+ <path-to-project>/cordova/run <target>
+
+
+...`<target>` Указывает имя ранее добавленного целевого устройства. Если `<target>` является устройством, то оно должен быть подключен к компьютеру через кабель USB, или же быть в той же сети Wi-Fi, что и ваш компьютер.
+
+## Управление плагинами
+
+Команда `target` позволяет добавлять и удалять плагины. Для выбора локально расположенного плагина:
+
+ <path-to-project>/cordova/plugin fetch <path-to-plugin>
+
+
+Просмотреть список установленных плагинов:
+
+ <path-to-project>/cordova/plugin ls
+
+
+Добавление плагина:
+
+ <path-to-project>/cordova/plugin add <name>
+
+
+Удаление плагина:
+
+ <path-to-project>/cordova/plugin rm <name>
\ No newline at end of file
diff --git a/docs/ru/5.0.0/guide/platforms/blackberry10/upgrade.md b/docs/ru/5.0.0/guide/platforms/blackberry10/upgrade.md
new file mode 100644
index 0000000..41966b6
--- /dev/null
+++ b/docs/ru/5.0.0/guide/platforms/blackberry10/upgrade.md
@@ -0,0 +1,490 @@
+---
+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.
+---
+
+# Обновление для BlackBerry 10
+
+В этом руководстве показано, как изменить проекты BlackBerry при обновлении старых версий Cordova. Большинство этих инструкций применимы для проектов, созданных со старым набором средств командной строки, которые предшествуют утилите CLI `cordova`. Смотрите раздел "Интерфейс командной строки" для получения информации как обновить версию CLI.
+
+## Обновление проектов с 3.6.0 до 4.0.0
+
+Для проектов-CLI выполните:
+
+ bin/обновить путь/к/проекта
+
+
+Для проектов CLI:
+
+1. Обновите версию `cordova` CLI. Смотрите "Интерфейс командной строки".
+
+2. Выполните команду `cordova platform update blackberry` в существующих проектах.
+
+## Обновление до 3.2.0 с 3.1.0
+
+Для проектов, которые были созданы с помощью cordova CLI:
+
+1. Обновите версию `cordova` CLI. Смотрите "Интерфейс командной строки".
+
+2. Запустите `cordova platform update blackberry`
+
+Для проектов, не созданных с помощью cordova CLI выполните:
+
+ bin/update <project_path>
+
+
+## Обновление до 3.1.0 с 3.0.0
+
+1. Создайте новый проект Apache Cordova 3.1.0 используя Cordova CLI, как описано в разделе "Интерфейс командной строки".
+
+2. Добавьте вашу платформ в проект Cordova, например: `cordova
+platform add blackberry10`.
+
+3. Скопируйте содержимое каталога `www` исходного проекта в каталог `www` в корне проекта cordova, который вы только что создали.
+
+4. Скопируйте или перезапишите любые ресурсы платформы из вашего первоначального проекта ( `Resources`, и т.д.)
+
+5. Скопируйте файл `config.xml` в каталог `www` и удалить любые определения плагинов. Вам нужно изменить настройки здесь, а не в каталоге платформы.
+
+6. Используйте средство CLI cordova для установки любых плагинов, которые вам нужны. Обратите внимание, что CLI обрабатывает все основные API как плагины, так что они могут и должны быть добавлены. Только плагины отмеченые 3.0.0 и выше, совместимы с CLI.
+
+7. Построение и тестирование.
+
+Пожалуйста, обратите внимание, что CLI поддерживает платформу BlackBerry10 исключительно. Для поддержки PlayBook и BBOS, смотрите Cordova версии 2.9.0 см и ниже.
+
+## Обновление до CLI (3.0.0) с 2.9.0
+
+1. Создайте новый проект Apache Cordova 3.0.0 используя Cordova CLI, как описано в разделе "Интерфейс командной строки".
+
+2. Добавьте вашу платформ в проект Cordova, например: `cordova
+platform add blackberry10`.
+
+3. Скопируйте содержимое каталога `www` исходного проекта в каталог `www` в корне проекта cordova, который вы только что создали.
+
+4. Скопируйте или перезапишите любые ресурсы платформы из вашего первоначального проекта ( `Resources`, и т.д.)
+
+5. Скопируйте файл `config.xml` в каталог `www` и удалить любые определения плагинов. Вам нужно изменить настройки здесь, а не в каталоге платформы.
+
+6. Используйте Сordova CLI для установки необходимых вам плагинов. Обратите внимание что CLI интерпретирует все базовые APIs как плагины, так что они тоже должны быть добавлены. Только плагины для версии 3.0.0 поддерживаются CLI.
+
+7. Построение и тестирование.
+
+## Обновление проектов 2.8.0 до 2.9.0
+
+Для BlackBerry 10:
+
+1. Загрузите и распакуйте исходный код Cordova 2.9.0 в постоянное место на вашем жестком диске, например в `~/Cordova-2.9.0`.
+
+2. Закройте все запущенные инструменты SDK: Eclipse, Momentics и тому подобное.
+
+3. Перейдите в каталог, где вы положили загруженный выше исходный код, используя unix-терминал: Terminal.app, Bash, Cygwin и т.д.
+
+4. Создайте новый проект, как описано в "Руководство по инструментам BlackBerry". Это станет домашним каталогом вашего обновленного проекта.
+
+5. Скопировать исходный код вашего проекта из каталога `/www` старого проекта в каталог `/www` нового проекта.
+
+6. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `cordova.js`.
+
+Для BlackBerryOS/Playbook:
+
+1. Загрузите и распакуйте исходный код Cordova 2.9.0 в постоянное место на вашем жестком диске, например в `~/Cordova-2.9.0`.
+
+2. Закройте все запущенные инструменты SDK: Eclipse, Momentics и тому подобное.
+
+3. Перейдите в каталог, где вы положили загруженный выше исходный код, используя unix-терминал: Terminal.app, Bash, Cygwin и т.д.
+
+4. Создайте новый проект, как описано в разделе "Руководство инструментов BlackBerry". Вам нужны будут ресурсы из нового проекта.
+
+5. Скопируйте файл `www/cordova.js` из нового проекта в папке `www` и удалите файл `www/cordova.js`.
+
+6. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `cordova.js`.
+
+7. Скопируйте каталог `native` из нового проекта в существующий проект, перезаписывая старый каталог `native`.
+
+8. Скопируйте каталог `lib` из нового проекта в существующий проект, перезаписывая старый каталог `lib`.
+
+9. Скопируйте каталог `cordova` из нового проекта в существующий проект, перезаписывая старый каталог `cordova`.
+
+## Обновление проектов 2.7.0 до 2.8.0
+
+BlackBerry 10 использует новый инструмент CLI и управляет основными API как плагинами. Инструкции по миграции проекта в новый проект, а не обновление существующего проекта, в связи со сложностью обновления старого проекта. Также обратите внимание, что cordova js скрипт файл теперь называется «cordova.js» и больше не содержит строку версии.
+
+1. Загрузите и распакуйте исходный код Cordova 2.8.0 в постоянное место на вашем жестком диске, например в `~/Cordova-2.8.0`.
+
+2. Закройте все запущенные инструменты SDK: Eclipse, Momentics и тому подобное.
+
+3. Перейдите в каталог, где вы положили загруженный выше исходный код, используя unix-терминал: Terminal.app, Bash, Cygwin и т.д.
+
+4. Создайте новый проект, как описано в "Руководство по инструментам BlackBerry". Это станет домашним каталогом вашего обновленного проекта.
+
+5. Скопировать исходный код вашего проекта из каталога `/www` старого проекта в каталог `/www` нового проекта.
+
+6. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `cordova.js`.
+
+Для BlackBerryOS/Playbook:
+
+1. Загрузите и распакуйте исходный код Cordova 2.8.0 в постоянное место на вашем жестком диске, например в `~/Cordova-2.8.0`.
+
+2. Закройте все запущенные инструменты SDK: Eclipse, Momentics и тому подобное.
+
+3. Перейдите в каталог, где вы положили загруженный выше исходный код, используя unix-терминал: Terminal.app, Bash, Cygwin и т.д.
+
+4. Создайте новый проект, как описано в разделе "Руководство инструментов BlackBerry". Вам нужны будут ресурсы из нового проекта.
+
+5. Скопируйте файл `www/cordova.js` из нового проекта в папке `www` и удалите файл `www/cordova.js`.
+
+6. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `cordova.js`.
+
+7. Скопируйте каталог `native` из нового проекта в существующий проект, перезаписывая старый каталог `native`.
+
+8. Скопируйте каталог `lib` из нового проекта в существующий проект, перезаписывая старый каталог `lib`.
+
+9. Скопируйте каталог `cordova` из нового проекта в существующий проект, перезаписывая старый каталог `cordova`.
+
+## Обновление проектов 2.6.0 до 2.7.0
+
+1. Загрузите и распакуйте исходный код Cordova 2.7.0 в постоянное место на вашем жестком диске, например в `~/Cordova-2.7.0`.
+
+2. Закройте все запущенные инструменты SDK: Eclipse, Momentics и тому подобное.
+
+3. Перейдите в каталог, где вы положили загруженный выше исходный код, используя unix-терминал: Terminal.app, Bash, Cygwin и т.д.
+
+4. Создайте новый проект, как описано в разделе "Руководство инструментов BlackBerry". Вам нужны будут ресурсы из нового проекта.
+
+5. Скопируйте файл `www/cordova-2.7.0.js` из нового проекта в папке `www` и удалите файл `www/cordova-2.6.0.js`.
+
+6. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `cordova.js`.
+
+7. Скопируйте каталог `native` из нового проекта в существующий проект, перезаписывая старый каталог `native`.
+
+8. Скопируйте каталог `lib` из нового проекта в существующий проект, перезаписывая старый каталог `lib`.
+
+9. Скопируйте каталог `cordova` из нового проекта в существующий проект, перезаписывая старый каталог `cordova`.
+
+## Обновление до 2.6.0 от 2.5.0
+
+Обновление в каталог загрузки PhoneGap:
+
+Рекомендуется, что вы скачать свежую копию всего каталога.
+
+Однако здесь новые детали, необходимые для частичного обновления:
+
+1. Обновить файл cordova.blackberry.js в `Phonegap-2.6.0/lib/blackberry/javascript` каталог.
+
+2. Обновление `ext` , `ext-air` , и `ext-qnx` в `Phonegap-2.6.0/lib/blackberry/framework` каталог.
+
+3. Обновление `build.xml` файл в `Phonegap-2.6.0/lib/blackberry` каталог.
+
+4. Обновление `Phonegap-2.6.0/lib/blackberry/bin` каталог.
+
+5. Обновление `VERSION` файл в `Phonegap-2.6.0/lib/blackberry` каталог.
+
+Обновление в примере / каталог или перенос существующего проекта:
+
+1. Откройте каталог `www`, который содержит приложение.
+
+2. Удалить и обновить файл .jar в `ext/` каталог.
+
+3. Обновить содержимое `ext-air/` каталог.
+
+4. Обновить содержимое `ext-qnx/` каталог.
+
+5. Скопируйте новый `cordova-2.6.0.js` в ваш проект.
+
+6. Обновить ваш HTML, чтобы использовать новый `cordova-2.6.0.js` файл.
+
+## Обновление до 2.5.0 с 2.4.0
+
+Обновление в каталог загрузки PhoneGap:
+
+Рекомендуется, что вы скачать свежую копию всего каталога.
+
+Однако здесь новые детали, необходимые для частичного обновления:
+
+1. Обновить файл cordova.blackberry.js в `Phonegap-2.5.0/lib/blackberry/javascript` каталог.
+
+2. Обновление `ext` , `ext-air` , и `ext-qnx` в `Phonegap-2.5.0/lib/blackberry/framework` каталог.
+
+3. Обновление `build.xml` файл в `Phonegap-2.5.0/lib/blackberry` каталог.
+
+4. Обновление `Phonegap-2.5.0/lib/blackberry/bin` каталог.
+
+5. Обновление `VERSION` файл в `Phonegap-2.5.0/lib/blackberry` каталог.
+
+Обновление в примере / каталог или перенос существующего проекта:
+
+1. Откройте каталог `www`, который содержит приложение.
+
+2. Удалить и обновить файл .jar в `ext/` каталог.
+
+3. Обновить содержимое `ext-air/` каталог.
+
+4. Обновить содержимое `ext-qnx/` каталог.
+
+5. Скопируйте новый `cordova-2.5.0.js` в ваш проект.
+
+6. Обновить ваш HTML, чтобы использовать новый `cordova-2.5.0.js` файл.
+
+## Обновление до 2.4.0 от 2.3.0
+
+Обновление только `www` Каталог:
+
+1. Откройте каталог `www`, который содержит приложение.
+
+2. Удалить и обновить файл .jar в `ext/` каталог.
+
+3. Обновить содержимое `ext-air/` каталог.
+
+4. Скопируйте новый `cordova-2.4.0.js` в ваш проект.
+
+ * Если playbook, тогда обновите .js файл в каталоге `playbook/`.
+ * Если BlackBerry 10, затем обновить файл JS в `qnx/` каталог.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-2.4.0.js` файл.
+
+Обновление каталога образцов (например, обновления через ant tools):
+
+1. Открытые `sample/lib/` каталог.
+
+2. Обновить файл .jar в `cordova.2.3.0/ext/` каталог.
+
+3. Обновить содержимое `cordova.2.3.0/ext-air/` каталог.
+
+4. Обновить содержимое `cordova.2.3.0/ext-qnx/` каталог.
+
+5. Обновить файл .js в `cordova.2.3.0/javascript/` каталог.
+
+6. Открытые `sample/lib/` каталог и переименовать `cordova.2.3.0/` Каталог`cordova.2.4.0/`.
+
+7. Наберите `ant blackberry build` или `ant playbook build` чтобы обновить каталог `www` с обновленной версией Cordova.
+
+8. Откройте каталог `www` и обновить ваш HTML, чтобы использовать новый файл `cordova-2.4.0.js`.
+
+## Обновление до 2.3.0 от 2.2.0
+
+Обновление только `www` Каталог:
+
+1. Откройте каталог `www`, который содержит приложение.
+
+2. Удалить и обновить файл .jar в `ext/` каталог.
+
+3. Обновить содержимое `ext-air/` каталог.
+
+4. Скопируйте новый `cordova-2.3.0.js` в ваш проект.
+
+ * Если playbook, тогда обновите .js файл в каталоге `playbook/`.
+ * Если BlackBerry 10, затем обновить файл JS в `qnx/` каталог.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-2.3.0.js` файл.
+
+Обновление каталога образцов (например, обновления через ant tools):
+
+1. Открытые `sample/lib/` каталог.
+
+2. Обновить файл .jar в `cordova.2.2.0/ext/` каталог.
+
+3. Обновить содержимое `cordova.2.2.0/ext-air/` каталог.
+
+4. Обновить содержимое `cordova.2.2.0/ext-qnx/` каталог.
+
+5. Обновить файл .js в `cordova.2.2.0/javascript/` каталог.
+
+6. Открытые `sample/lib/` каталог и переименовать `cordova.2.2.0/` Каталог`cordova.2.3.0/`.
+
+7. Наберите `ant blackberry build` или `ant playbook build` чтобы обновить каталог `www` с обновленной версией Cordova.
+
+8. Откройте каталог `www` и обновить ваш HTML, чтобы использовать новый файл `cordova-2.3.0.js`.
+
+## Обновление до 2.2.0 из 2.1.0
+
+Обновление только каталог www:
+
+1. Откройте каталог `www`, который содержит приложение.
+
+2. Удалить и обновить файл .jar в `ext/` каталог.
+
+3. Обновить содержимое `ext-air/` каталог.
+
+4. Скопируйте новый `cordova-2.2.0.js` в ваш проект.
+
+ * Если playbook, тогда обновите .js файл в каталоге `playbook/`.
+ * Если BlackBerry 10, затем обновить файл JS в `qnx/` каталог.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-2.2.0.js` файл.
+
+Обновление каталога образцов (например, обновления через ant tools):
+
+1. Открытые `sample/lib/` каталог.
+
+2. Обновить файл .jar в `cordova.2.1.0/ext/` каталог.
+
+3. Обновить содержимое `cordova.2.1.0/ext-air/` каталог.
+
+4. Обновить содержимое `cordova.2.1.0/ext-qnx/` каталог.
+
+5. Обновить файл .js в `cordova.2.1.0/javascript/` каталог.
+
+6. Открытые `sample/lib/` каталог и переименовать `cordova.2.1.0/` Каталог`cordova.2.2.0/`.
+
+7. Наберите `ant blackberry build` или `ant playbook build` чтобы обновить каталог `www` с обновленной версией Cordova.
+
+8. Откройте каталог `www` и обновить ваш HTML, чтобы использовать новый файл `cordova-2.2.0.js`.
+
+## Обновление до 2.1.0 с 2.0.0
+
+Обновление только `www` Каталог:
+
+1. Откройте каталог `www`, который содержит приложение.
+
+2. Удалить и обновить файл .jar в `ext/` каталог.
+
+3. Обновить содержимое `ext-air/` каталог.
+
+4. Скопируйте новый `cordova-2.1.0.js` в ваш проект.
+
+ * Если playbook, тогда обновите .js файл в каталоге `playbook/`.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-2.1.0.js` файл.
+
+Обновление каталога образцов (например, обновления через ant tools):
+
+1. Открытые `sample/lib/` каталог.
+
+2. Обновить файл .jar в `cordova.2.0.0/ext/` каталог.
+
+3. Обновить содержимое `cordova.2.0.0/ext-air/` каталог.
+
+4. Обновить файл .js в `cordova.2.0.0/javascript/` каталог.
+
+5. Открытые `sample/lib/` каталог и переименовать `cordova.2.0.0/` Каталог`cordova.2.1.0/`.
+
+6. Наберите `ant blackberry build` или `ant playbook build` чтобы обновить каталог `www` с обновленной версией Cordova.
+
+7. Откройте каталог `www` и обновить ваш HTML, чтобы использовать новый файл `cordova-2.1.0.js`.
+
+## Обновление до 2.0.0 от 1.9.0
+
+Обновление только `www` Каталог:
+
+1. Откройте каталог `www`, который содержит приложение.
+
+2. Удалить и обновить файл .jar в `ext/` каталог.
+
+3. Обновить содержимое `ext-air/` каталог.
+
+4. Скопируйте новый `cordova-2.0.0.js` в ваш проект.
+
+ * Если playbook, тогда обновите .js файл в каталоге `playbook/`.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-2.0.0.js` файл.
+
+6. Обновите файл `www/plugins.xml`. Два плагины изменили свои имена служб/пространства имен. Измените старые записи для плагинов Захвата и Контакты:
+
+ <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 tools):
+
+1. Открытые `sample/lib/` каталог.
+
+2. Обновить файл .jar в `cordova.1.9.0/ext/` каталог.
+
+3. Обновить содержимое `cordova.1.9.0/ext-air/` каталог.
+
+4. Обновить файл .js в `cordova.1.9.0/javascript/` каталог.
+
+5. Открытые `sample/lib/` каталог и переименовать `cordova.1.9.0/` Каталог`cordova.2.0.0/`.
+
+6. Наберите `ant blackberry build` или `ant playbook build` чтобы обновить каталог `www` с обновленной версией Cordova.
+
+7. Откройте каталог `www` и обновить ваш HTML, чтобы использовать новый файл `cordova-2.0.0.js`.
+
+8. Откройте каталог `www` и обновите файл `www/plugins.xml`. Два плагины изменили свои имена служб/пространства имен. Измените старые записи для плагинов Захвата и Контакты:
+
+ <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.8.0 от 1.7.0
+
+Обновление только `www` Каталог:
+
+1. Откройте каталог `www`, который содержит приложение.
+
+2. Удалить и обновить файл .jar в `ext/` каталог.
+
+3. Обновить содержимое `ext-air/` каталог.
+
+4. Скопируйте новый `cordova-1.8.0.js` в ваш проект.
+
+ * Если playbook, тогда обновите .js файл в каталоге `playbook/`.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-1.8.0.js` файл.
+
+6. Обновите файл `www/plugins.xml`. Два плагины изменили свои имена служб/пространства имен. Измените старые записи для плагинов Захвата и Контакты:
+
+ <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 tools):
+
+1. Открытые `sample/lib/` каталог.
+
+2. Обновить файл .jar в `cordova.1.7.0/ext/` каталог.
+
+3. Обновить содержимое `cordova.1.7.0/ext-air/` каталог.
+
+4. Обновить файл .js в `cordova.1.7.0/javascript/` каталог.
+
+5. Открытые `sample/lib/` каталог и переименовать `cordova.1.7.0/` Каталог`cordova.1.8.0/`.
+
+6. Наберите `ant blackberry build` или `ant playbook build` чтобы обновить каталог `www` с обновленной версией Cordova.
+
+7. Откройте каталог `www` и обновить ваш HTML, чтобы использовать новый файл `cordova-1.8.0.js`.
+
+8. Откройте каталог `www` и обновите файл `www/plugins.xml`. Два плагины изменили свои имена служб/пространства имен. Измените старые записи для плагинов Захвата и Контакты:
+
+ <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"/>
\ No newline at end of file
diff --git a/docs/ru/5.0.0/guide/platforms/blackberry10/upgrading.md b/docs/ru/5.0.0/guide/platforms/blackberry10/upgrading.md
new file mode 100644
index 0000000..ea59436
--- /dev/null
+++ b/docs/ru/5.0.0/guide/platforms/blackberry10/upgrading.md
@@ -0,0 +1,466 @@
+---
+
+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.
+---
+
+# Модернизация BlackBerry 10
+
+В этом руководстве показано, как изменить BlackBerry проекты для обновления старых версий Cordova. Большинство этих инструкций применимы для проектов, созданных с старого набора средств командной строки, которые предшествуют `cordova` утилиты CLI. Увидеть интерфейс командной строки для получения информации как обновить версию инфраструктуры CLI.
+
+## Обновление до 3.2.0 3.1.0
+
+Для проектов, которые были созданы с Кордова CLI:
+
+1. Обновление `cordova` CLI-версия. Увидеть интерфейс командной строки.
+
+2. Запуск`cordova platform update blackberry`
+
+Для проектов, не созданных с Кордова CLI выполните:
+
+ bin/обновить < project_path >
+
+
+## Обновление до 3.1.0 с 3.0.0
+
+1. Создайте новый проект Apache Cordova 3.1.0, используя cordova CLI, как описано в интерфейс командной строки.
+
+2. Добавьте ваш платформ в Кордове проект, например:`cordova
+platform add blackberry10`.
+
+3. Скопируйте содержимое исходного проекта `www` каталог `www` директорию в корне проекта cordova, вы только что создали.
+
+4. Копирование или перезаписать любые родной активы от вашего первоначального проекта ( `Resources` , и т.д.)
+
+5. Копия `config.xml` файл `www` каталог и удалите любые определения плагин. Вам нужно изменить настройки здесь, а не в каталоге платформы.
+
+6. Используйте средство CLI cordova для установки любых плагинов, что вам нужно. Обратите внимание, что CLI обрабатывает все основные API плагинов, так что они могут и должны быть добавлены. Только плагины отмечены 3.0.0 и выше, совместимы с CLI.
+
+7. Построение и тестирование.
+
+Пожалуйста, обратите внимание, что CLI поддерживает платформу BlackBerry10 исключительно. PlayBook и BBOS, Кордова версии 2.9.0 см и ниже.
+
+## Обновление к CLI (3.0.0) с 2.9.0
+
+1. Создайте новый проект Apache Cordova 3.0.0 используя cordova CLI, как описано в интерфейс командной строки.
+
+2. Добавьте ваш платформ в Кордове проект, например:`cordova
+platform add blackberry10`.
+
+3. Скопируйте содержимое оригинального проекта `www` каталог `www` каталог в корневом каталоге проекта cordova, вы только что создали.
+
+4. Копирование или перезаписать любые родной активы от вашего первоначального проекта ( `Resources` , и т.д.)
+
+5. Копия `config.xml` файл `www` каталог и удалите любые определения плагин. Вам нужно изменить настройки здесь, а не в каталоге платформы.
+
+6. Используйте средство CLI cordova для установки любых плагинов, что вам нужно. Обратите внимание, что CLI обрабатывает все основные API плагинов, так что они могут и должны быть добавлены. Только 3.0.0 плагины совместимы с CLI.
+
+7. Построение и тестирование.
+
+## Проекты модернизации 2.8.0 2.9.0
+
+Для BlackBerry 10:
+
+1. Скачайте и распакуйте Cordova 2.9.0 Источник постоянного каталог на жестком диске, например`~/Cordova-2.9.0`.
+
+2. Закройте все запущенные инструментов SDK: Eclipse, Momentics и тому подобное.
+
+3. Перейдите в каталог, где вы положили загруженных исходных выше, используя unix как терминал: Terminal.app, Баш, Cygwin и т.д.
+
+4. Создайте новый проект, как описано в BlackBerry утилиты командной строки. Это становится домом обновленный проект.
+
+5. Скопируйте ваш источник проектов из старого проекта `/www` каталог для нового проекта `/www` каталог.
+
+6. Обновить ссылку сценарий Кордова в ваш `www/index.html` файл (и любые другие файлы, которые содержат ссылку на сценарий) для указания на новый `cordova.js` файл.
+
+Для BlackberryOS обеспечение/пьес:
+
+1. Загрузите и извлеките Cordova 2.9.0 Источник постоянного каталог на вашем жестком диске, например для`~/Cordova-2.9.0`.
+
+2. Закройте все запущенные инструментов SDK: Eclipse, Momentics и тому подобное.
+
+3. Перейдите в каталог, где вы положили загруженных исходных выше, используя unix как терминал: Terminal.app, Баш, Cygwin и т.д.
+
+4. Создайте новый проект, как описано в iOS утилиты командной строки. Вам нужен активов от этого нового проекта.
+
+5. Копия `www/cordova.js` файл из нового проекта в ваш `www` каталог и удалить ваш `www/cordova.js` файл.
+
+6. Обновить ссылку сценарий Кордова в ваш `www/index.html` файл (и любые другие файлы, которые содержат ссылку на сценарий) для указания на новый `cordova.js` файл.
+
+7. Копия `native` каталог из нового проекта в существующий проект, перезаписывая старые `native` каталог.
+
+8. Копия `lib` каталог из нового проекта в существующий проект, перезаписывая старые `lib` каталог.
+
+9. Копия `cordova` каталог из нового проекта в существующий проект, перезаписывая старые `cordova` каталог.
+
+## Проекты модернизации 2.7.0 2.8.0
+
+BlackBerry 10 использует новый инструмент CLI и управляет основные API как плагины. Инструкции по миграции проекта в новый проект, а не обновление существующего проекта, в связи со сложностью обновления старого проекта. Также обратите внимание, что Кордова js скрипт файл теперь называется «cordova.js» и больше не содержит строку версии.
+
+1. Скачайте и распакуйте Cordova 2.8.0 Источник постоянного каталог на жестком диске, например`~/Cordova-2.8.0`.
+
+2. Закройте все запущенные инструментов SDK: Eclipse, Momentics и тому подобное.
+
+3. Перейдите в каталог, где вы положили загруженных исходных выше, используя unix как терминал: Terminal.app, Баш, Cygwin и т.д.
+
+4. Создайте новый проект, как описано в BlackBerry утилиты командной строки. Это становится домом обновленный проект.
+
+5. Скопируйте ваш источник проектов из старого проекта `/www` каталог для нового проекта `/www` каталог.
+
+6. Обновить ссылку сценарий Кордова в ваш `www/index.html` файл (и любые другие файлы, которые содержат ссылку на сценарий) для указания на новый `cordova.js` файл.
+
+Для BlackberryOS обеспечение/пьес:
+
+1. Загрузите и извлеките Cordova 2.8.0 Источник постоянного каталог на вашем жестком диске, например для`~/Cordova-2.8.0`.
+
+2. Закройте все запущенные инструментов SDK: Eclipse, Momentics и тому подобное.
+
+3. Перейдите в каталог, где вы положили загруженных исходных выше, используя unix как терминал: Terminal.app, Баш, Cygwin и т.д.
+
+4. Создайте новый проект, как описано в iOS утилиты командной строки. Вам нужен активов от этого нового проекта.
+
+5. Копия `www/cordova.js` файл из нового проекта в ваш `www` каталог и удалить ваш `www/cordova.js` файл.
+
+6. Обновите ссылку на сценарий Кордова в ваш `www/index.html` файл (и любые другие файлы, которые содержат ссылку на сценарий) на новый `cordova.js` файл.
+
+7. Копия `native` каталог из нового проекта в существующий проект, перезаписывая старый `native` каталог.
+
+8. Копия `lib` каталог из нового проекта в существующий проект, перезаписывая старый `lib` каталог.
+
+9. Копия `cordova` каталог из нового проекта в существующий проект, перезаписывая старый `cordova` каталог.
+
+## Проекты модернизации 2.6.0 2.7.0
+
+1. Загрузите и извлеките Cordova 2.7.0 Источник постоянного каталог на вашем жестком диске, например для`~/Cordova-2.7.0`.
+
+2. Выйти из любой работающей инструментов SDK: затмение, Momentics и тому подобное.
+
+3. Перейдите в каталог, где вы положили загруженных исходных выше, используя unix как терминал: Terminal.app, Баш, Cygwin, и т.д.
+
+4. Создайте новый проект, как описано в BlackBerry утилиты командной строки. Вам нужен активов от этого нового проекта.
+
+5. Копия `www/cordova-2.7.0.js` файл из нового проекта в ваш `www` каталог и удалить ваш `www/cordova-2.6.0.js` файл.
+
+6. Обновите ссылку на сценарий Кордова в ваш `www/index.html` файл (и любые другие файлы, которые содержат ссылку на сценарий) на новый `cordova-2.7.0.js` файл.
+
+7. Копия `native` каталог из нового проекта в существующий проект, перезаписывая старые `native` каталог.
+
+8. Копия `lib` каталог из нового проекта в существующий проект, перезаписывая старые `lib` каталог.
+
+9. Копия `cordova` каталог из нового проекта в существующий проект, перезаписывая старые `cordova` каталог.
+
+## Обновление до 2.6.0 от 2.5.0
+
+Обновление в каталог загрузки PhoneGap:
+
+Рекомендуется, что вы скачать свежую копию всего каталога.
+
+Однако здесь новые детали, необходимые для частичного обновления:
+
+1. Обновить файл cordova.blackberry.js в `Phonegap-2.6.0/lib/blackberry/javascript` каталог.
+
+2. Обновление `ext` , `ext-air` , и `ext-qnx` в `Phonegap-2.6.0/lib/blackberry/framework` каталог.
+
+3. Обновление `build.xml` файл в `Phonegap-2.6.0/lib/blackberry` каталог.
+
+4. Обновление `Phonegap-2.6.0/lib/blackberry/bin` каталог.
+
+5. Обновление `VERSION` файл в `Phonegap-2.6.0/lib/blackberry` каталог.
+
+Обновление в примере / каталог или перенос существующего проекта:
+
+1. Открыть свой `www/` каталог, который содержит приложение.
+
+2. Удалить и обновить файл .jar в `ext/` каталог.
+
+3. Обновить содержимое `ext-air/` каталог.
+
+4. Обновить содержимое `ext-qnx/` каталог.
+
+5. Скопируйте новый `cordova-2.6.0.js` в ваш проект.
+
+6. Обновить ваш HTML, чтобы использовать новый `cordova-2.6.0.js` файл.
+
+## Обновление до 2.5.0 с 2.4.0
+
+Обновление в каталог загрузки PhoneGap:
+
+Рекомендуется, что вы скачать свежую копию всего каталога.
+
+Однако здесь новые детали, необходимые для частичного обновления:
+
+1. Обновить файл cordova.blackberry.js в `Phonegap-2.5.0/lib/blackberry/javascript` каталог.
+
+2. Обновление `ext` , `ext-air` , и `ext-qnx` в `Phonegap-2.5.0/lib/blackberry/framework` каталог.
+
+3. Обновление `build.xml` файл в `Phonegap-2.5.0/lib/blackberry` каталог.
+
+4. Обновление `Phonegap-2.5.0/lib/blackberry/bin` каталог.
+
+5. Обновление `VERSION` файл в `Phonegap-2.5.0/lib/blackberry` каталог.
+
+Обновление в примере / каталог или перенос существующего проекта:
+
+1. Открыть ваш `www/` каталог, который содержит приложение.
+
+2. Удалить и обновить файл .jar в `ext/` каталог.
+
+3. Обновить содержимое `ext-air/` каталог.
+
+4. Обновить содержимое `ext-qnx/` каталог.
+
+5. Скопируйте новый `cordova-2.5.0.js` в ваш проект.
+
+6. Обновить ваш HTML, чтобы использовать новый `cordova-2.5.0.js` файл.
+
+## Обновление до 2.4.0 от 2.3.0
+
+Обновление только `www` каталога:
+
+1. Открыть свой `www/` каталог, который содержит приложение.
+
+2. Удалить и обновить файл .jar в `ext/` каталог.
+
+3. Обновить содержимое `ext-air/` каталог.
+
+4. Скопируйте новый `cordova-2.4.0.js` в ваш проект.
+
+ * Если playbook, а затем обновление .js файл в `playbook/` каталог.
+ * Если BlackBerry 10, затем обновить файл JS в `qnx/` каталог.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-2.4.0.js` файл.
+
+Обновление каталога образцов (например, обновления через инструменты муравей):
+
+1. Открытые `sample/lib/` каталог.
+
+2. Обновить файл .jar в `cordova.2.3.0/ext/` каталог.
+
+3. Обновить содержимое `cordova.2.3.0/ext-air/` каталог.
+
+4. Обновить содержимое `cordova.2.3.0/ext-qnx/` каталог.
+
+5. Обновить файл .js в `cordova.2.3.0/javascript/` каталог.
+
+6. Открытые `sample/lib/` каталог и переименовать `cordova.2.3.0/` Каталог`cordova.2.4.0/`.
+
+7. Типа `ant blackberry build` или `ant playbook build` для обновления `www/` каталог с обновленный Кордова.
+
+8. Открытые `www/` каталог и обновить ваш HTML, чтобы использовать новый `cordova-2.4.0.js` файл.
+
+## Обновление до 2.3.0 от 2.2.0
+
+Обновление только `www` Каталог:
+
+1. Открыть свой `www/` каталог, который содержит приложение.
+
+2. Удалить и обновить файл .jar в `ext/` каталог.
+
+3. Обновить содержимое `ext-air/` каталог.
+
+4. Скопируйте новый `cordova-2.3.0.js` в ваш проект.
+
+ * Если playbook, а затем обновление .js файл в `playbook/` каталог.
+ * Если BlackBerry 10, затем обновить файл JS в `qnx/` каталог.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-2.3.0.js` файл.
+
+Обновление каталога образцов (например, обновления через инструменты муравей):
+
+1. Открытые `sample/lib/` каталог.
+
+2. Обновить файл .jar в `cordova.2.2.0/ext/` каталог.
+
+3. Обновить содержимое `cordova.2.2.0/ext-air/` каталог.
+
+4. Обновить содержимое `cordova.2.2.0/ext-qnx/` каталог.
+
+5. Обновить файл .js в `cordova.2.2.0/javascript/` каталог.
+
+6. Открытые `sample/lib/` каталог и переименовать `cordova.2.2.0/` Каталог`cordova.2.3.0/`.
+
+7. Типа `ant blackberry build` или `ant playbook build` для обновления `www/` каталог с обновленный Кордова.
+
+8. Открытые `www/` каталог и обновить ваш HTML, чтобы использовать новый `cordova-2.3.0.js` файл.
+
+## Обновление до 2.2.0 из 2.1.0
+
+Обновление только каталог www:
+
+1. Открыть свой `www/` каталог, который содержит приложение.
+
+2. Удалить и обновить файл .jar в `ext/` каталог.
+
+3. Обновить содержимое `ext-air/` каталог.
+
+4. Скопируйте новый `cordova-2.2.0.js` в ваш проект.
+
+ * Если playbook, а затем обновление .js файл в `playbook/` каталог.
+ * Если BlackBerry 10, затем обновить файл JS в `qnx/` каталог.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-2.2.0.js` файл.
+
+Обновление каталога образцов (например, обновления через инструменты муравей):
+
+1. Открытые `sample/lib/` каталог.
+
+2. Обновить файл .jar в `cordova.2.1.0/ext/` каталог.
+
+3. Обновить содержимое `cordova.2.1.0/ext-air/` каталог.
+
+4. Обновить содержимое `cordova.2.1.0/ext-qnx/` каталог.
+
+5. Обновить файл .js в `cordova.2.1.0/javascript/` каталог.
+
+6. Открытые `sample/lib/` каталог и переименовать `cordova.2.1.0/` Каталог`cordova.2.2.0/`.
+
+7. Типа `ant blackberry build` или `ant playbook build` для обновления `www/` каталог с обновленный Кордова.
+
+8. Открытые `www/` каталог и обновить ваш HTML, чтобы использовать новый `cordova-2.2.0.js` файл.
+
+## Обновление до 2.1.0 с 2.0.0
+
+Обновление только `www` каталога:
+
+1. Открыть свой `www/` каталог, который содержит приложение.
+
+2. Удалить и обновить файл .jar в `ext/` каталог.
+
+3. Обновить содержимое `ext-air/` каталог.
+
+4. Скопируйте новый `cordova-2.1.0.js` в ваш проект.
+
+ * Если playbook, а затем обновление .js файл в `playbook/` каталог.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-2.1.0.js` файл.
+
+Обновление каталога образцов (например, обновления через инструменты муравей):
+
+1. Открытые `sample/lib/` каталог.
+
+2. Обновить файл .jar в `cordova.2.0.0/ext/` каталог.
+
+3. Обновить содержимое `cordova.2.0.0/ext-air/` каталог.
+
+4. Обновить файл .js в `cordova.2.0.0/javascript/` каталог.
+
+5. Открытые `sample/lib/` каталог и переименовать `cordova.2.0.0/` Каталог`cordova.2.1.0/`.
+
+6. Типа `ant blackberry build` или `ant playbook build` для обновления `www/` каталог с обновленный Кордова.
+
+7. Открытые `www/` каталог и обновить ваш HTML, чтобы использовать новый `cordova-2.1.0.js` файл.
+
+## Обновление до 2.0.0 от 1.9.0
+
+Обновление только `www` каталога:
+
+1. Открыть свой `www/` каталог, который содержит приложение.
+
+2. Удалить и обновить файл .jar в `ext/` каталог.
+
+3. Обновить содержимое `ext-air/` каталог.
+
+4. Скопируйте новый `cordova-2.0.0.js` в ваш проект.
+
+ * Если playbook, а затем обновление .js файл в `playbook/` каталог.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-2.0.0.js` файл.
+
+6. Обновление ваш `www/plugins.xml` файл. Два плагины изменил их лейблом служба имен. Измените старые записи для захвата и контакт плагинов от:
+
+ < имя плагина = «Захват» value="org.apache.cordova.media.MediaCapture"/ >< плагин имя = «Контакт» value="org.apache.cordova.pim.Contact"/ >
+
+ Кому:
+
+ < имя плагина = «Захват» value="org.apache.cordova.capture.MediaCapture"/ >< плагин имя «Контакты» value="org.apache.cordova.pim.Contact"/ = >
+
+
+Обновление каталога образцов (например, обновления через инструменты муравей):
+
+1. Открытые `sample/lib/` каталог.
+
+2. Обновить файл .jar в `cordova.1.9.0/ext/` каталог.
+
+3. Обновить содержимое `cordova.1.9.0/ext-air/` каталог.
+
+4. Обновить файл .js в `cordova.1.9.0/javascript/` каталог.
+
+5. Открытые `sample/lib/` каталог и переименовать `cordova.1.9.0/` Каталог`cordova.2.0.0/`.
+
+6. Типа `ant blackberry build` или `ant playbook build` для обновления `www/` каталог с обновленный Кордова.
+
+7. Открытые `www/` каталог и обновить ваш HTML, чтобы использовать новый `cordova-2.0.0.js` файл.
+
+8. Открытые `www/` каталог и обновление `plugins.xml` файл. Два плагины изменил их лейблом служба имен. Измените старые записи для захвата и контакт плагинов от:
+
+ <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.8.0 от 1.7.0
+
+Обновление только `www` Каталог:
+
+1. Открыть свой `www/` каталог, который содержит приложение.
+
+2. Удалить и обновить файл .jar в `ext/` каталог.
+
+3. Обновить содержимое `ext-air/` каталог.
+
+4. Скопируйте новый `cordova-1.8.0.js` в ваш проект.
+
+ * Если playbook, а затем обновление .js файл в `playbook/` каталог.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-1.8.0.js` файл.
+
+6. Обновление ваш `www/plugins.xml` файл. Два плагины изменил их лейблом служба имен. Измените старые записи для захвата и контакт плагинов от:
+
+ < имя плагина = «Захват» value="org.apache.cordova.media.MediaCapture"/ >< плагин имя = «Контакт» value="org.apache.cordova.pim.Contact"/ >
+
+ Кому:
+
+ < имя плагина = «Захват» value="org.apache.cordova.capture.MediaCapture"/ >< плагин имя «Контакты» value="org.apache.cordova.pim.Contact"/ = >
+
+
+Обновление каталога образцов (например, обновления через ant tools):
+
+1. Открытые `sample/lib/` каталог.
+
+2. Обновить файл .jar в `cordova.1.7.0/ext/` каталог.
+
+3. Обновить содержимое `cordova.1.7.0/ext-air/` каталог.
+
+4. Обновить файл .js в `cordova.1.7.0/javascript/` каталог.
+
+5. Открытые `sample/lib/` каталог и переименовать `cordova.1.7.0/` Каталог`cordova.1.8.0/`.
+
+6. Типа `ant blackberry build` или `ant playbook build` для обновления `www/` каталог с обновленный Кордова.
+
+7. Открытые `www/` каталог и обновить ваш HTML, чтобы использовать новый `cordova-1.8.0.js` файл.
+
+8. Открытые `www/` каталог и обновление `plugins.xml` файл. Два плагины изменил их лейблом служба имен. Измените старые записи для захвата и контакт плагинов от:
+
+ <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"/>
\ No newline at end of file
diff --git a/docs/ru/5.0.0/guide/platforms/firefoxos/config.md b/docs/ru/5.0.0/guide/platforms/firefoxos/config.md
new file mode 100644
index 0000000..5c69d50
--- /dev/null
+++ b/docs/ru/5.0.0/guide/platforms/firefoxos/config.md
@@ -0,0 +1,20 @@
+---
+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.
+---
+
+# FirefoxOS конфигурация
\ No newline at end of file
diff --git a/docs/ru/5.0.0/guide/platforms/firefoxos/index.md b/docs/ru/5.0.0/guide/platforms/firefoxos/index.md
new file mode 100644
index 0000000..3683fbf
--- /dev/null
+++ b/docs/ru/5.0.0/guide/platforms/firefoxos/index.md
@@ -0,0 +1,92 @@
+---
+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.
+---
+
+# Руководство для платформы Firefox OS
+
+В этом руководстве показано, как настроить вашу среду разработки для развертывания приложений Cordova на устройствах Firefox OS, а также тестировать и опубликовывать эти приложения.
+
+## Требования и поддержка
+
+Firefox OS приложения являются просто веб-приложениями, с добавлением файла manifest.webapp, который определяет метаданные о приложении и позволяет ему быть установленым на устройстве Firefox OS. Любая платформа которую поддерживает Cordova может быть использована.Чтобы узнать больше о создании веб-приложений, обратитесь в [App Center][1] на [MDN][2].
+
+ [1]: https://developer.mozilla.org/en-US/Apps
+ [2]: https://developer.mozilla.org/en-US/
+
+## Установка и настройка среды
+
+Сначала установить [Node.js][3], а затем установить пакет Cordova следующим образом:
+
+ [3]: http://nodejs.org/
+
+ $ npm install -g cordova
+
+
+Далее создайте тестовое приложения Cordova, а затем перейдите в созданную директорию:
+
+ $ cordova create test-app
+ $ cd test-app
+
+
+Добавьте Firefox OS как поддерживаемую платформа в приложение следующим образом:
+
+ $ cordova platform add firefoxos
+
+
+Это создает приложение Firefox OS в каталоге platforms/firefoxos/www, который в настоящее время выглядит так же как и каталог www, за исключением того, что он содержит файл манифеста Firefox (manifest.webapp) внутри директории www.
+
+## Разработка вашего приложения
+
+На данный момент вы готовы к работе — изменить код внутри test-app/www на все, что вы хотите. Вы можете добавить [поддерживаемые плагины]() в приложение, с помощью «cordova plugin add», например:
+
+ cordova plugin add cordova-plugin-device
+ cordova plugin add cordova-plugin-vibration
+
+
+Когда написан код приложения, развертывайте ваши изменений в Firefox OS приложении, которые вы добавили в в проект с помощью
+
+ $ cordova prepare firefoxos
+
+
+Для создания упакованного приложения можно архивировать каталог platforms/firefoxos/www. Вы можете также просто построить его с помощью
+
+ $ cordova build firefoxos
+
+
+Упаковонное приложение Firefox OS будет собрано в platforms/firefoxos/build/package.zip
+
+## Тестирование и отладка
+
+Приложение может быть протестировано с помощью Firefox OS [Web IDE][4].
+
+ [4]: https://developer.mozilla.org/en-US/docs/Tools/WebIDE
+
+Когда вы подключените App Manager к вашему тестовому устройству/симулятору, выберите параметр «Add Packaged App», то убедитесь, что вы указываете на каталог test-app/platforms/firefoxos/www/ для включения приложения в интерфейсе App Manager.
+
+Здесь можно установить приложение на ваше тестовое устройство/симулятор (с кнопкой «Update»). С помощью кнопки «Debug» можно выполнить отладку приложения и отредактировать его код по живому.
+
+Примечание: Прежде чем публиковать приложение вы должны проверить его с помощью [App validator][5].
+
+ [5]: https://marketplace.firefox.com/developers/validator
+
+## Публикация приложения в Firefox Marketplace
+
+Можно отправить ваше приложение в Firefox Marketplace или опубликовать его самостоятельно. Посетите [Зону Firefox Marketplace][6] на MDN, чтобы узнать больше о том, как сделать это; [Параметры публикации App][7] является лучшим местом для начала.
+
+ [6]: https://developer.mozilla.org/en-US/Marketplace
+ [7]: https://developer.mozilla.org/en-US/Marketplace/Publishing/Publish_options
\ No newline at end of file
diff --git a/docs/ru/5.0.0/guide/platforms/index.md b/docs/ru/5.0.0/guide/platforms/index.md
new file mode 100644
index 0000000..3ff2d70
--- /dev/null
+++ b/docs/ru/5.0.0/guide/platforms/index.md
@@ -0,0 +1,83 @@
+---
+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.
+---
+
+# Руководство по поддерживаемым платформам
+
+До начала разработки на любой из платформ, перечисленных ниже, установите Кордова в интерфейс командной строки (CLI). (Подробности см. в интерфейс командной строки).
+
+Для разработки приложений Cordova, необходимо установить пакет SDK для каждой мобильной платформы, которую вы выбрали. Эта установка необходима независимо вне зависимости от того, собираетесь ли вы делать большую часть работы в SDK или использовать CLI для вашего цикла сборки.
+
+Каждое *Руководство по работе с платформой* перечисленные ниже говорит вам, что нужно знать для настройки среды разработки каждой платформы: где получить SDK, как настроить эмуляторы устройств, как подключить устройства для тестирования и как управлять ключами подписывания. Дополнительные руководства представляют информацию для каждой платформы уникальный набор параметров настройки, инструкции для добавления плагинов, как обновить платформы и специфические параметры командной строки, которые служат в качестве нижнего уровня альтернативой `cordova` утилиты командной строки.
+
+## Amazon Fire OS
+
+* Руководство для платформы Amazon Fire OS
+* Настройка Amazon Fire OS
+* WebView в Amazon Fire OS
+* Плагины для Amazon Fire OS
+
+## Android
+
+* Руководство для платформы Android
+* Руководство по инструментам командной строки Android
+* Конфигурация Android
+* Плагины для Android
+* WebViews в Android
+* Обновление для Android
+
+## BlackBerry 10
+
+* Руководство для платформы BlackBerry 10
+* Руководство по инструментам командной строки BlackBerry 10
+* Конфигурации BlackBerry 10
+* Плагины для BlackBerry 10
+* Модернизация BlackBerry 10
+
+## Firefox OS
+
+* Руководство для платформы Firefox OS
+
+## iOS
+
+* Руководство для платформы iOS
+* Руководство по инструментам командной строки iOS
+* Конфигурация iOS
+* Плагины для iOS
+* WebViews в iOS
+* Обновление для iOS
+
+## Ubuntu
+
+* Руководство для платформы Ubuntu
+
+## Windows Phone 8
+
+* Руководство для платформы Windows Phone 8
+* Windows Phone 8 плагины
+* Обновление Windows Phone 8
+
+## Windows
+
+* Руководство по платформе Windows
+* Windows плагины
+* Обновление для Windows 8
+
+## Tizen
+
+* Руководство для платформы Tizen
\ No newline at end of file
diff --git a/docs/ru/5.0.0/guide/platforms/ios/config.md b/docs/ru/5.0.0/guide/platforms/ios/config.md
new file mode 100644
index 0000000..ebc2914
--- /dev/null
+++ b/docs/ru/5.0.0/guide/platforms/ios/config.md
@@ -0,0 +1,93 @@
+---
+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.
+---
+
+# Конфигурация iOS
+
+Файл `config.xml` управляет основные параметрами приложения, которые применяются к каждому приложению и экземпляру CordovaWebView. Этот раздел описывает настройки, которые применяются только к платформе iOS. Смотрите [Файл config.xml][1] для получения информации о глобальных параметрах конфигурации.
+
+ [1]: config_ref_index.md.html#The%20config.xml%20File
+
+* `EnableViewportScale` (логическое значение, по умолчанию `false`): Установите `true` чтобы разрешить тегу meta viewport либо отключить или ограничить диапазон масштабирования экрана пользователем, который включен по умолчанию.
+
+ <preference name="EnableViewportScale" value="true"/>
+
+
+ Установите viewport следующим образом в HTML, чтобы отключить масштабирование и гибко подстраивать содержимое в WebView во время отрисовывания:
+
+ < мета имя = «просмотра» содержание =' ширина = устройства ширина, первоначальный масштаб = 1, пользователь масштабируемых = no' / >
+
+
+* `MediaPlaybackRequiresUserAction` (логическое значение, по умолчанию `false` ): Установите `true` чтобы запретить автоматическое воспроизведение HTML5 видео или аудио с использованием атрибуте `autoplay` или через JavaScript.
+
+ <preference name="MediaPlaybackRequiresUserAction" value="true"/>
+
+
+* `AllowInlineMediaPlayback` (логическое значение, по умолчанию `false` ): Установите `true` чтобы разрешить воспроизведение мультимедиа HTML5 появляться *встроено* в пределах экрана, с помощью стандартных элементов управления браузера, а не элементы управления платформы. Чтобы это работало, добавьте атрибут `webkit-playsinline` к любому элементу `<video>`.
+
+ <preference name="AllowInlineMediaPlayback" value="true"/>
+
+
+* `BackupWebStorage` (строка, либо `none`, `local`, или значение по умолчанию `cloud`): Установите `cloud` чтобы разрешить сохранение веб-данных при резервном копировании через iCloud. Установите `local` для того чтобы разрешить только в локальных резервных копия при синхронизации через iTunes. Установите `none` чтобы предотвратить создание резервных копий веб-данных.
+
+ <preference name="BackupWebStorage" value="local"/>
+
+
+* `TopActivityIndicator` (строка, по умолчанию `gray` ): контролирует появление небольшого вращающийся значка в строке состояния, указывающее значительную активность процессора. Допустимыми значениями являются `whiteLarge`, `white`, и `gray`.
+
+ <preference name="TopActivityIndicator" value="white"/>
+
+
+* `KeyboardDisplayRequiresUserAction` (логическое значение, по умолчанию `true`): Установите `false` чтобы разрешить клавиатуре появляются при вызове `focus()` на формах ввода.
+
+ <preference name="KeyboardDisplayRequiresUserAction" value="false"/>
+
+
+* `SuppressesIncrementalRendering` (логическое значение, по умолчанию `false` ): Установите `true` чтобы ожидать, пока все содержимое будет получено до того, как оно будет отображаться на экране.
+
+ <preference name="SuppressesIncrementalRendering" value="true"/>
+
+
+* `GapBetweenPages`(float, значение по умолчанию `` ): размер разрыва, в точках, между страницами.
+
+ <preference name="GapBetweenPages" value="0"/>
+
+
+* `PageLength` (float, значение по умолчанию ``): размер каждой страницы, в точках, в направление протяженности страницы. Когда PaginationMode — справа налево или слева направо, это свойство представляет ширину каждой страницы. Когда PaginationMode сверху вниз или снизу вверх, это свойство представляет высоту каждой страницы. Значение по умолчанию равно 0, что означает, что макет использует размер viewport-а, чтобы определить размеры страницы.
+
+ <preference name="PageLength" value="0"/>
+
+
+* `PaginationBreakingMode` (строки, по умолчанию `page`): допустимые значения `page` и `column`. Порядок, в котором происходит разрыв столбца или страницы. Это свойство определяет, будут ли определенные CSS свойства относительно разрыва столбца и страницы применяться или игнорироваться. Когда это свойство имеет значение `column`, содержимое страницы обрабатывает CSS свойства, относящиеся к разрыву колонки в месте разрыва страницы.
+
+ <preference name="PaginationBreakingMode" value="page"/>
+
+
+* `PaginationMode` (строка, по умолчанию `unpaginated`): допустимые значения `unpaginated`, `leftToRight`, `topToBottom`, `bottomToTop`, и `rightToLeft`. Это свойство определяет является ли содержимое в WebView разбитым на страницы, которые заполняют один экран одновременно, или как представлены один длинный прокручиваемый список. Если установить paginated, это свойство переключает страничный макет содержимого, заставляя WebView использовать значения использования значения PageLength и GapBetweenPages для перерисовки его содержимого.
+
+ <preference name="PaginationMode" value="unpaginated"/>
+
+
+* `UIWebViewDecelerationSpeed` (строка, по умолчанию `normal` ): допустимые значения `normal`, `fast`. Это свойство контролирует скорость замедления импульса прокрутки. `normal` это скорость по умолчанию для большиства приложений платформы, и `fast` является значением по умолчанию для Mobile Safari.
+
+ <preference name="UIWebViewDecelerationSpeed" value="fast" />
+
+
+* `ErrorUrl` (строка, не установлено по умолчанию): Если установлено, будет отображать указанную локальную страницу, при ошибке в приложении.
+
+ <preference name="ErrorUrl" value="myErrorPage.html"/>
\ No newline at end of file
diff --git a/docs/ru/5.0.0/guide/platforms/ios/index.md b/docs/ru/5.0.0/guide/platforms/ios/index.md
new file mode 100644
index 0000000..71af566
--- /dev/null
+++ b/docs/ru/5.0.0/guide/platforms/ios/index.md
@@ -0,0 +1,214 @@
+---
+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.
+---
+
+# Руководство для платформы iOS
+
+В этом руководстве показано, как настроить среду разработки SDK для развертывания приложений Cordova для iOS-устройств, таких как iPhone и iPad. Смотрите ниже для более подробной информации конкретной платформы:
+
+* Конфигурация iOS
+* Обновление для iOS
+* WebViews в iOS
+* Плагины для iOS
+* Руководство по инструментам командной строки iOS
+
+Средства командной строки относятся к версии Cordova до 3.0. Смотрите раздел "Интерфейс командной строки" для информации о текущем интерфейсе интерфейс командной строки.
+
+## Требования и поддержка
+
+Инструменты Apple ®, необходимые для создания приложений iOS, выполняются только в операционной системе OS X на компьютерах Mac на базе Intel. Xcode ® 6.0 (минимальная требуемая версия) работает только на OS X версии 10.9 (Mavericks) или выше и включает в себя iOS 8 SDK (Software Development Kit). Чтобы отправить приложений в Apple App Store℠ требует последние версии инструментария Apple.
+
+Вы можете проверить многие из функций Cordova, используя эмулятор iOS установленный с iOS SDK и Xcode, но вам нужно реальное устройство чтобы полностью проверить все функции приложения перед отправкой его в App Store. Устройство должно иметь установленным по крайней мере iOS 6.x , минимальная версия iOS поддерживаемая начиная с Cordova 3.0. Подерживаемые устройства включают все модели iPad ®, iPhone ® 3GS и выше и iPod ® Touch 3-го поколения или позднее. Для установки приложений на устройство, необходимо также быть членом компании Apple [iOS разработчик программы][1], которая стоит $99 в год. В этом руководстве показано, как развернуть приложения в эмуляторе iOS, для которого не нужно зарегистрироваться в программе developer.
+
+ [1]: https://developer.apple.com/programs/ios/
+
+Инструменты [Ios-sim][2] и [ios-deploy][3] позволяют вам запустить приложение iOS на iOS симуляторе или iOS устройстве из командной строки.
+
+ [2]: https://www.npmjs.org/package/ios-sim
+ [3]: https://www.npmjs.org/package/ios-deploy
+
+## Установите SDK
+
+Существует два способа для загрузки Xcode:
+
+* из [App Store][4], доступных путем поиска «Xcode» в приложении **App Store** .
+
+* от [Apple Developer Downloads][5], который требует регистрации в качестве разработчиков Apple.
+
+ [4]: https://itunes.apple.com/us/app/xcode/id497799835?mt=12
+ [5]: https://developer.apple.com/downloads/index.action
+
+После установки Xcode, некоторые инструменты командной строки должны быть доступны чтобы инструменты Cordova запускались. В меню **Xcode** выберите **Preferences**, а затем вкладку **Downloads** . На панели **Components** нажмите кнопку **Install** рядом с списком **Command Line Tools**.
+
+## Установить средства развертывания
+
+Запустите из терминала командной строки:
+
+ $ npm install -g ios-sim
+ $ npm install -g ios-deploy
+
+
+## Создание нового проекта
+
+Используйте утилиту `cordova` для настройки нового проекта, как описано в разделе "Интерфейс командной строки Cordova". Например выполните в каталоге исходного кода:
+
+ $ cordova create hello com.example.hello "HelloWorld"
+ $ cd hello
+ $ cordova platform add ios
+ $ cordova prepare # or "cordova build"
+
+
+## Развертывание приложения
+
+Для развертывания приложения на подключенном iOS устройстве:
+
+ $ cordova run ios --device
+
+
+Для развертывания приложения на iOS эмуляторе по умолчанию:
+
+ $ cordova emulate ios
+
+
+Можно использовать **cordova run android --list** чтобы увидеть все доступные цели и **cordova run android --target=имя_устройства** для запуска приложения на конкретном устройстве или эмуляторе (например, `cordova run android --target="Nexus4_emulator"`).
+
+Чтобы увидеть дополнительные параметры построения и запуска также можно использовать **cordova run --help**.
+
+## Откройте проект в SDK
+
+Как только платформа ios добавлена в проект, вы можете открыть его из в Xcode. Дважды щелкните, чтобы открыть файл `hello/platforms/ios/hello.xcodeproj`. Экран должен выглядеть следующим образом:
+
+![][6]
+
+ [6]: img/guide/platforms/ios/helloworld_project.png
+
+## Развертывание на эмулятор
+
+Для предварительного просмотра приложения в эмуляторе iOS:
+
+1. Убедитесь, что на левой панели выбран файл *.xcodeproj* .
+
+2. Выберите приложение **hello** на панели справа.
+
+3. Выберите предполагаемый устройство из меню **схема** панели инструментов, таких как iPhone 6.0 симулятор как подчеркнул здесь:
+
+ ![][7]
+
+4. Нажмите кнопку **Run** , который появляется в панели же для левой части **схемы**. Это строит, развертывает и запускает приложение в эмуляторе. Отдельный эмулятор приложение открывает для отображения приложения:
+
+ ![][8]
+
+ Только один эмулятор может выполняться одновременно, так что если вы хотите протестировать приложение в эмуляторе другой, вам нужно выйти из эмулятора приложения и запускать различные цели в пределах Xcode.
+
+ [7]: img/guide/platforms/ios/select_xcode_scheme.png
+ [8]: img/guide/platforms/ios/HelloWorldStandard.png
+
+Xcode идет с встроенным эмулятором для последних версий iPhone и iPad. Более старые версии могут быть доступны из панели **→ Preferences → Downloads → Components**.
+
+## Развертывание на устройство
+
+Подробные сведения о различных требований для развертывания на устройстве обратитесь к разделу *Настройка развития и распределения ресурсов* документа [Рабочий процесс при использовании инструментов для iOS][9] компании Apple. Вкратце вам нужно выполнить следующие действия перед развертыванием:
+
+ [9]: http://developer.apple.com/library/ios/#documentation/Xcode/Conceptual/ios_development_workflow/00-About_the_iOS_Application_Development_Workflow/introduction.html#//apple_ref/doc/uid/TP40007959
+
+1. Присоединяйтесь к компании Apple iOS разработчик программы.
+
+2. Создайте *профиль подготовки* в [iOS Provisioning портал][10]. Вы можете использовать его *Развития провизионирования помощник* для создания и установки профиля и сертификат Xcode требует.
+
+3. Убедитесь, что раздел *Подписи кода* *Удостоверения подписи кода* в параметры проекта для провизионирования имя профиля.
+
+ [10]: https://developer.apple.com/ios/manage/overview/index.action
+
+Чтобы развернуть на устройстве:
+
+1. Используйте кабель USB, подключите устройство к ваш Mac.
+
+2. Выберите имя проекта в окне Xcode **схема** раскрывающемся списке.
+
+3. Выберите устройство из списка **устройств** . Если он подключен через USB, но по-прежнему не отображается, нажмите кнопку **Организатор** для устранения любых ошибок.
+
+4. Нажмите на кнопку **Run** для построения, развертывания и запуска приложения на вашем устройстве.
+
+## Общие проблемы
+
+**Предупреждение об устаревании**: когда интерфейс программирования приложения (API) изменяется или заменяется другим API, он помечается как *deprecated*. API по-прежнему работает в ближайшем будущем, но со временем удаляется. Некоторые из этих устаревших интерфейсов отражаются в Apache Cordova, и Xcode выдает предупреждения о них, когда вы собираете и развертываете приложение.
+
+Xcode предупреждение о методе `invokeString`, касается функциональности, которая запускает приложение по пользовательскому URL-адресу. В то время как механизм для загрузки из пользовательских URL-адресов изменился, этот код по-прежнему присутствует и предоставлять функциональность обратной совместимости для приложений, созданные с более старыми версиями Cordova. Пример приложения не использует эту функциональность, поэтому эти предупреждения можно игнорировать. Чтобы избежать отображения этих предупреждений, удалите код, который ссылается на устаревшие invokeString API:
+
+* Отредактируйте файл *Classes/MainViewController.m* , окружают следующий блок кода с `/*` и `*/` комментарии, как показано ниже, затем введите **Command-s** , чтобы сохранить файл:
+
+ (void)webViewDidFinishLoad:(UIWebView*)theWebView
+ {
+ // only valid if ___PROJECTNAME__-Info.plist specifies a protocol to handle
+ /*
+ if (self.invokeString) {
+ // this is passed before the deviceready event is fired, so you can access it in js when you receive deviceready
+ NSLog(@"DEPRECATED: window.invokeString - use the window.handleOpenURL(url) function instead, which is always called when the app is launched through a custom scheme url.");
+ NSString* jsString = [NSString stringWithFormat:@"var invokeString = \"%@\";", self.invokeString];
+ [theWebView stringByEvaluatingJavaScriptFromString:jsString];
+ }
+ */
+ // Black base color for background matches the native apps
+ theWebView.backgroundColor = [UIColor blackColor];
+
+ return [super webViewDidFinishLoad:theWebView];
+ }
+
+
+* Отредактируйте файл *Classes/AppViewDelegate.m* , закомментируйте следующую строку, вставляя двойной косой черты, как показано ниже, а затем введите **Command-s** , чтобы сохранить файл:
+
+ //self.viewController.invokeString = invokeString;
+
+
+* Нажмите **Command-b** , перестройте проект и устранить эти предупреждения.
+
+<!-- Does this fix only last until the next "cordova prepare"? -->
+
+**Отсутсвующие заголовки**: ошибки компиляции, связанные с недостающими заголовками в результате проблем с расположение сборки и может быть исправлено через настройки Xcode:
+
+1. Выберите **Xcode → настройки → места**.
+
+2. В разделе **Данные** нажмите кнопку **Дополнительно** и выберите **уникальный** как **Расположение сборки** , как показано здесь:
+
+ ![][11]
+
+ [11]: img/guide/platforms/ios/xcode_build_location.png
+
+Это параметр по умолчанию для новой установки Xcode, но он может быть установлен по-другому после обновления старой версии Xcode.
+
+Для получения дополнительной информации обратитесь к документации компании Apple:
+
+* [Начало разработки iOS приложений сегодня][12] предоставляет быстрый обзор шагов для разработки iOS приложения.
+
+* [Член центра Домашняя страница][13] содержит ссылки на несколько iOS технических ресурсов, включая технические ресурсы, подготовки портала, распространения руководств и форумы сообщества.
+
+* [Инструменты рабочего процесса руководства для iOS][9]
+
+* [Руководство пользователя Xcode][14]
+
+* [Видеосессии][15] от Всемирной Конференции Разработчиков Apple 2012 (WWDC2012)
+
+* [Команда xcode-select][16], которая помогает указать правильную версию Xcode, если более чем одна версия установлена.
+
+ [12]: http://developer.apple.com/library/ios/#referencelibrary/GettingStarted/RoadMapiOS/index.html#//apple_ref/doc/uid/TP40011343
+ [13]: https://developer.apple.com/membercenter/index.action
+ [14]: http://developer.apple.com/library/ios/#documentation/ToolsLanguages/Conceptual/Xcode4UserGuide/000-About_Xcode/about.html#//apple_ref/doc/uid/TP40010215
+ [15]: https://developer.apple.com/videos/wwdc/2012/
+ [16]: http://developer.apple.com/library/mac/#documentation/Darwin/Reference/ManPages/man1/xcode-select.1.html
+
+(Mac®, OS X®, Apple®, Xcode®, App Store℠, iPad®, iPhone®, iPod® и Finder® являются товарными знаками Apple Inc.)
\ No newline at end of file
diff --git a/docs/ru/5.0.0/guide/platforms/ios/plugin.md b/docs/ru/5.0.0/guide/platforms/ios/plugin.md
new file mode 100644
index 0000000..c09cac1
--- /dev/null
+++ b/docs/ru/5.0.0/guide/platforms/ios/plugin.md
@@ -0,0 +1,181 @@
+---
+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.
+---
+
+# Плагины для iOS
+
+Этот раздел содержит сведения о том, как реализовать код родной плагин на платформе iOS. Прежде чем читать это, увидеть приложения плагины обзор структуры плагина и его общий интерфейс JavaScript. Этот раздел продолжает демонстрировать пример *echo* плагина, который соообщается из WebView Cordova с кодом платформы и в обратную строну.
+
+IOS плагин реализован как Objective-C класс, который расширяет `CDVPlugin` класс. Для JavaScript `exec` метода `service` параметр для сопоставления с Objective-C класс, каждый плагин должен быть зарегистрирован как `<feature>` в каталоге именованного приложения тег `config.xml` файл.
+
+## Сопоставление классов плагина
+
+Часть JavaScript плагин использует `cordova.exec` метод следующим образом:
+
+ Exec (< successFunction >, < failFunction >, < служба >, < действия > [< args >]);
+
+
+Это маршалирует запрос от `UIWebView` в сторону родной iOS эффективно вызова `action` метод `service` класса, с аргументами, переданными в `args` массив.
+
+Укажите плагин как `<feature>` тег в Кордова iOS приложения проекта `config.xml` файл, используя `plugin.xml` файл, чтобы придать этой разметки автоматически, как описано в приложении плагины:
+
+ <feature name="LocalStorage">
+ <param name="ios-package" value="CDVLocalStorage" />
+ </feature>
+
+
+Функция `name` атрибут должен соответствовать указан как JavaScript `exec` вызова `service` параметр. `value`Атрибут должен соответствовать имени плагина Objective-C класса. `<param>`Элемента `name` всегда должно быть `ios-package` . Если не следовать этим рекомендациям, может скомпилировать плагин, но Cordova до сих пор не может быть возможность доступа к ней.
+
+## Инициализация плагин его жизненный цикл
+
+Для жизни каждого из них создается один экземпляр объекта плагин `UIWebView` . Плагины создаются обычно при первом обращении путем вызова из JavaScript. В противном случае они могут быть созданы путем установки `param` с именем `onload` для `true` в `config.xml` файл:
+
+ <feature name="Echo">
+ <param name="ios-package" value="Echo" />
+ <param name="onload" value="true" />
+ </feature>
+
+
+Существует *нет* места для инициализатора для плагинов. Вместо этого следует использовать плагины `pluginInitialize` метод для их запуска логики.
+
+Плагины с долго выполняющихся запросов, фон деятельности, такие как воспроизведение мультимедиа, слушателей или что поддерживать внутреннее состояние следует осуществлять `onReset` метод для очистки этих мероприятий. Метод работает, когда `UIWebView` переходит на новую страницу или обновления, которая перезагружает JavaScript.
+
+## Написание iOS Cordova плагин
+
+Вызов JavaScript запускает запрос плагин к родной стороне, и соответствующие iOS плагин Objective-C отображается правильно в `config.xml` файл, но как окончательный iOS Objective-C модуль класса взгляд? Все, что отправляется в плагин с JavaScript в `exec` функция передается в соответствующий класс плагин `action` метод. Метод плагин имеет подпись:
+
+ - (void)myMethod:(CDVInvokedUrlCommand*)command
+ {
+ CDVPluginResult* pluginResult = nil;
+ NSString* myarg = [command.arguments objectAtIndex:0];
+
+ if (myarg != nil) {
+ pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];
+ } else {
+ pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:@"Arg was null"];
+ }
+ [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
+ }
+
+
+Для более подробной информации, см. `[CDVInvokedUrlCommand.h](https://github.com/apache/cordova-ios/blob/master/CordovaLib/Classes/CDVInvokedUrlCommand.h)` , `[CDVPluginResult.h](https://github.com/apache/cordova-ios/blob/master/CordovaLib/Classes/CDVPluginResult.h)` , и`[CDVCommandDelegate.h](https://github.com/apache/cordova-ios/blob/master/CordovaLib/Classes/CDVCommandDelegate.h)`.
+
+## iOS CDVPluginResult типы сообщений
+
+Вы можете использовать `CDVPluginResult` для возвращения различных результата типа обратно в обратных вызовов JavaScript, с помощью методов класса, следовать этой схеме:
+
+ + (CDVPluginResult*)resultWithStatus:(CDVCommandStatus)statusOrdinal messageAs...
+
+
+Вы можете создать `String` , `Int` , `Double` , `Bool` , `Array` , `Dictionary` , `ArrayBuffer` , и `Multipart` типов. Вы можете также оставить вне каких-либо аргументов, чтобы отправить статус, или возвращает ошибку, или даже не решили отправить любой плагин результат, в этом случае срабатывает ни обратного вызова.
+
+Обратите внимание на следующие для сложных возвращаемых значений:
+
+* `messageAsArrayBuffer`ожидает `NSData*` и преобразует `ArrayBuffer` в обратного вызова JavaScript. Кроме того, любой `ArrayBuffer` отправляет плагин JavaScript преобразуются в`NSData*`.
+
+* `messageAsMultipart`ожидает `NSArray*` содержащие любые другие поддерживаемые типы и отправляет весь массив как `arguments` для обратного вызова JavaScript. Таким образом, все аргументы сериализуются и десериализуются как необходимости, так что это безопасно вернуться `NSData*` как составной, а не как `Array` /`Dictionary`.
+
+## Эхо iOS плагин пример
+
+Для сопоставления интерфейса JavaScript функция *echo*, описанная в разделе "Плагины приложения", используйте `plugin.xml` для вставки спецификации `feature` в файл `config.xml` платформы:
+
+ <platform name="ios">
+ <config-file target="config.xml" parent="/*">
+ <feature name="Echo">
+ <param name="ios-package" value="Echo" />
+ </feature>
+ </config-file>
+ </platform>
+
+
+Тогда мы хотели бы добавить следующие `Echo.h` и `Echo.m` файлы в `Plugins` папку в каталоге приложений 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* echo = [command.arguments objectAtIndex:0];
+
+ if (echo != nil && [echo length] > 0) {
+ pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:echo];
+ } else {
+ pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR];
+ }
+
+ [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
+ }
+
+ @end
+
+
+Необходимого импорта в верхней части файла расширяет класс от `CDVPlugin` . В этом случае плагин поддерживает только один `echo` действий. Он получает эхо строку путем вызова `objectAtIndex` метод получить первый параметр `arguments` массив, который соответствует аргументам, принятому JavaScript в `exec()` функции.
+
+Он проверяет параметр, чтобы убедиться, что это не `nil` или является пустой строкой, возвращая `PluginResult` с `ERROR` статус, если это так. Если параметр проходит проверку, он возвращает `PluginResult` с `OK` статус, проходя в оригинале `echo` строка. Наконец, он отправляет результат `self.commandDelegate` , которая выполняет `exec` метода успех или неудача обратные вызовы на стороне JavaScript. Если успех обратного вызова вызывается, он проходит в `echo` параметр.
+
+## iOS интеграции
+
+`CDVPlugin`Класса есть другие методы, которые можно переопределить ваш плагин. Например, вы можете захватить `pause` , `resume` , прервать app и `handleOpenURL` события. См [CDVPlugin.h][1] и [CDVPlugin.m][2] для руководства.
+
+ [1]: https://github.com/apache/cordova-ios/blob/master/CordovaLib/Classes/CDVPlugin.h
+ [2]: https://github.com/apache/cordova-ios/blob/master/CordovaLib/Classes/CDVPlugin.m
+
+## Работа с потоками
+
+Плагин методы обычно выполняются в том же потоке, что основной интерфейс. Если ваш плагин требует большой обработки или требует блокирующий вызов, вам следует использовать фоновый поток. Например:
+
+ - (void)myPluginMethod:(CDVInvokedUrlCommand*)command
+ {
+ // Check command.arguments here.
+ [self.commandDelegate runInBackground:^{
+ NSString* payload = nil;
+ // Some blocking logic...
+ CDVPluginResult* pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:payload];
+ // The sendPluginResult method is thread-safe.
+ [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
+ }];
+ }
+
+
+## Отладка iOS плагины
+
+Для отладки на стороне Objective-C, требуется встроенный отладчик Xcode's. Для JavaScript на iOS 5.0 или позднее можно использовать [Weinre, проект Apache Cordova][3], или [iWebInspector, сторонняя утилита][4]. Для iOS 8 вы можете подключиться через Safari 8.0 к приложению которое работает в симуляторе iOS 8.
+
+ [3]: https://github.com/apache/cordova-weinre
+ [4]: http://www.iwebinspector.com/
+
+## Наиболее распространенные ошибки
+
+* Не забудьте добавить ваш плагин сопоставление `config.xml` . Если вы забыли, ошибка регистрируется в консоли Xcode.
+
+* Не забудьте добавить любые узлы, при подключении к в белый список, как описано в "Инструкция по доступу к внешним ресурсам". Если вы забыли, ошибка регистрируется в консоли Xcode.
\ No newline at end of file
diff --git a/docs/ru/5.0.0/guide/platforms/ios/tools.md b/docs/ru/5.0.0/guide/platforms/ios/tools.md
new file mode 100644
index 0000000..9cd33c9
--- /dev/null
+++ b/docs/ru/5.0.0/guide/platforms/ios/tools.md
@@ -0,0 +1,61 @@
+---
+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.
+---
+
+# Руководство по инструментам командной строки iOS
+
+В этом руководстве показано, как использовать Кордова в набор инструментов по центру платформы shell для разработки приложений для iOS. Этот путь разработки, описанный в разделе "Введение", может предложить вам больший спектр вариантов разработки чем кросс платформенный инструмент CLI, описанные в разделе "Интерфейс командной строки". Например вам нужно использовать инструменты оболочки при развертывании настраиваемого Cordova WebView наряду с собственными компонентами. Перед тем как использовать какой то путь разработки, сначала необходимо настроить среду SDK, как описано в разделе "Руководство для платформы iOS". Эти инструменты полагаются на командной строки средства Xcode таких как `xcode-select` и`xcodebuild`.
+
+Чтобы включить инструменты оболочки для iOS, скачайте Cordova с [cordova.apache.org][1]. Загружаемый файл содержит отдельные архивы для каждой платформы. Разверните каждый вы хотите настроить таргетинг, `ios` в данном случае. Соответствующие инструменты обычно доступны в профиле верхнего уровня `bin` каталог, в противном случае консультироваться файл **README** для получения более подробной направлениях.
+
+ [1]: http://cordova.apache.org
+
+Эти инструменты позволяют создавать, строить и запускать приложения для iOS. За информаций о дополнительных интерфейсах командной строки которые позволяют встраивать возможности плагинов среди разных платформ, смотрите раздел "Использование Plugman для управления расширениями". Смотрите раздел "Плагины приложения" для детальной информации о том как разрабатывать плагины.
+
+## Создание проекта
+
+Запустите `create` команду, указав существующий путь к проекту, реверс домен стиль пакет идентификатор и отображаемое имя приложения.
+
+ $ ./path/to/cordova-ios/bin/create /path/to/my_new_project com.example.project_name ProjectName
+
+
+## Построение проекта
+
+ $ /path/to/my_new_project/cordova/build
+
+
+## Запустить приложение на эмуляторе
+
+ $ /path/to/my_new_project/cordova/run --emulator
+
+
+## Запуск приложения на устройстве
+
+ $ /path/to/my_new_project/cordova/run --device
+
+
+## Релиз
+
+ $ /path/to/my_new_project/cordova/build --release
+
+
+(измените `cordova/build-release.xcconfig` файл для указания вашего сертификата подписи кода)
+
+## Ведение журнала
+
+ $ /path/to/my_new_project/cordova/log
\ No newline at end of file
diff --git a/docs/ru/5.0.0/guide/platforms/ios/upgrade.md b/docs/ru/5.0.0/guide/platforms/ios/upgrade.md
new file mode 100644
index 0000000..b2c171f
--- /dev/null
+++ b/docs/ru/5.0.0/guide/platforms/ios/upgrade.md
@@ -0,0 +1,811 @@
+---
+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.
+---
+
+# Обновление для iOS
+
+В этом руководстве показано, как изменить проекты iOS для обновления старых версий Кордова. Большинство из этих инструкций применяются для проектов, созданных с старого набора средств командной строки, которые предшествуют `cordova` утилиты CLI. Увидеть интерфейс командной строки для получения информации как обновить версию инфраструктуры CLI.
+
+**Примечание**: требуется Xcode 6. В настоящее время чтобы опубликовать приложение в Apple App Store, вы должны использовать последнюю версию iOS SDK, на данный момент iOS 8 которая включается только с Xcode 6.
+
+## Обновление проектов с 3.6.0 до 4.0.0
+
+Для проектов-CLI выполните:
+
+ bin/обновить путь/к/проекта
+
+
+Для проектов CLI:
+
+1. Обновите версию `cordova` CLI. Смотрите "Интерфейс командной строки".
+
+2. Запустите `cordova platform update ios` в ваших проектах.
+
+## Обновление проектов с 3.3.0 до 3.4.0
+
+Для проектов-CLI выполните:
+
+ bin/обновить путь/к/проекта
+
+
+Для проектов CLI:
+
+1. Обновите версию `cordova` CLI. Смотрите "Интерфейс командной строки".
+
+2. Запуск`cordova platform update ios`
+
+## Обновление проектов с 3.2.0 до 3.3.0
+
+Для проектов-CLI выполните:
+
+ bin/обновить путь/к/проекта
+
+
+Для проектов CLI:
+
+1. Обновите версию `cordova` CLI. Смотрите "Интерфейс командной строки".
+
+2. Запуск`cordova platform update ios`
+
+## Обновление проектов с 3.1.0 до 3.2.0
+
+Для проектов-CLI выполните:
+
+ bin/обновить путь/к/проекта
+
+
+Для проектов CLI:
+
+1. Обновите версию `cordova` CLI. Смотрите "Интерфейс командной строки".
+
+2. Запуск`cordova platform update ios`
+
+## Обновление проектов с 3.0.0 до 3.1.0
+
+Для проектов-CLI выполните:
+
+ bin/обновить путь/к/проекта
+
+
+Для проектов CLI:
+
+1. Обновите версию `cordova` CLI. Смотрите "Интерфейс командной строки".
+
+2. Запуск`cordova platform update ios`
+
+Проблемы iOS 7:
+
+1. Удалите `width=device-width, height=device-height` из содержащегося в файле `index.html` `viewport` `meta` тега. (См. [соответствующую ошибку][1].)
+
+2. Обновите ваши media, media-capture и splashscreen плагины для поддержки iOS 7.
+
+ [1]: https://issues.apache.org/jira/browse/CB-4323
+
+Проблемы Xcode 5:
+
+1. Обновите параметры проекта, если Xcode 5 предлагает вам сделать это (в Issues Navigator).
+
+2. Обновите настройки **Compiler for C/C++/Objective-C**, в вкладке **Build Settings**, раздел **Build Options**. Выберите **Default compiler (Apple LLVM 5.0)**.
+
+## Обновление до CLI (3.0.0) с 2.9.0
+
+1. Создайте новый проект Apache Cordova 3.0.0 используя Cordova CLI, как описано в разделе "Интерфейс командной строки".
+
+2. Добавьте ваши платформы в проект Cordova, например: `cordova
+platform add ios`.
+
+3. Скопируйте содержимое каталога `www` исходного проекта в каталог `www` в корне проекта cordova, который вы только что создали.
+
+4. Скопируйте или перезапишите любые платформо-специфичные ресурсы из вашего оригинального проекта (`Resources`, и т.д.), убедитесь что любые новые файлы добавлены в `.xcodeproj` проект. Проект iOS собирается в каталоге `platforms\ios`.
+
+5. Скопируйте файл `config.xml` в папку `www` и удалите определения любых плагинов. Измените настройки здесь, а не в каталоге платформы.
+
+6. Используйте Сordova CLI для установки необходимых вам плагинов. Обратите внимание что CLI интерпретирует все базовые APIs как плагины, так что они тоже должны быть добавлены. Только плагины для версии 3.0.0 поддерживаются CLI.
+
+7. Построение и тестирование.
+
+## Обновление проектов с 2.9.0 до 3.0.0
+
+1. Загрузите и распакуйте исходный код Cordova 3.0.0 в постоянное место на вашем жестком диске, например в `~/Cordova-3.0.0`.
+
+2. Если оно выполняется, закройте Xcode.
+
+3. С помощью Terminal.app, перейдите в каталог, где вы положили загруженных исходных выше.
+
+4. Создайте новый проект, как описано в разделе "Руководство инструментов iOS". Вам нужны будут ресурсы из нового проекта.
+
+5. Копия `www/cordova.js` (Обратите внимание, что он не имеет суффикса версии больше, версия в сам файл в заголовке) файл из нового проекта в `www` каталог и удалить `www/cordova.js` файл.
+
+6. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `cordova.js`.
+
+7. Удалить `CordovaLib` каталог и копию `CordovaLib` каталог из нового проекта в корневой директории вашего проекта.
+
+**Примечание**: начиная с Cordova 3.0.0, плагины изначально не установлены плагины, и вам нужно использовать утилиту командной строки `plugman` для их установки. Смотрите раздел "Использование Plugman для управления расширениями".
+
+## Обновление проектов 2.8.0 до 2.9.0
+
+1. Загрузите и распакуйте исходный код Cordova 2.9.0 в постоянное место на вашем жестком диске, например в `~/Cordova-2.9.0`.
+
+2. Если оно выполняется, закройте Xcode.
+
+3. С помощью Terminal.app, перейдите в каталог, где вы положили загруженных исходных выше.
+
+4. Создайте новый проект, как описано в разделе "Руководство инструментов iOS". Вам нужны будут ресурсы из нового проекта.
+
+5. Копия `www/cordova.js` (Обратите внимание, что он не имеет суффикса версии больше, версия в сам файл в заголовке) файл из нового проекта в `www` каталог и удалить `www/cordova.js` файл.
+
+6. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `cordova.js`.
+
+7. Удалить `CordovaLib` каталог и копию `CordovaLib` каталог из нового проекта в корневой директории вашего проекта.
+
+## Обновление проектов 2.7.0 до 2.8.0
+
+1. Загрузите и распакуйте исходный код Cordova 2.8.0 в постоянное место на вашем жестком диске, например в `~/Cordova-2.8.0`.
+
+2. Если оно выполняется, закройте Xcode.
+
+3. С помощью Terminal.app, перейдите в каталог, где вы положили загруженных исходных выше.
+
+4. Создайте новый проект, как описано в разделе "Руководство инструментов iOS". Вам нужны будут ресурсы из нового проекта.
+
+5. Скопируйте файл `www/cordova.js` (Обратите внимание, что он больше не имеет суффикса версии, версия в самом заголовке файла) из нового проекта в папку `www` и удалить файл `www/cordova-2.7.0.js` .
+
+6. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `cordova.js`.
+
+7. Обновите любые теги `<plugin>` в файле `config.xml` на теги `<feature>`. Обратите внимание, что существующие теги `<plugin>` по-прежнему будут работать, но являются устаревшими. Вы можете скопировать эту информацию в файл `config.xml` для нового проекта. Например:
+
+ <plugins>
+ <plugin name="LocalStorage" value="CDVLocalStorage" />
+ <!-- other plugins -->
+ </plugins>
+
+ <!-- change to: (note that a <feature> tag is on the same level as <plugins> -->
+ <feature name="LocalStorage">
+ <param name="ios-package" value="CDVLocalStorage" />
+ </feature>
+ <!-- other <feature> tags -->
+
+
+8. Удалить `CordovaLib` каталог и копию `CordovaLib` каталог из нового проекта в корневой директории вашего проекта.
+
+9. Добавьте эти два фреймворка в проект:
+
+ OpenAL
+ ImageIO
+
+
+10. Обновите для цели построения вашего проекта **Build Settings**. В разделе **Linking → Other Linker Flags**, измените **"-Obj-C"** на **"-ObjC"**.
+
+11. Обновите для цели построения вашего проекта **Build Settings**. В разделе **Linking → Other Linker Flags**, измените **"-all_load"** на `-force\_load ${BUILT\_PRODUCTS\_DIR}/libCordova.a`. Вам только нужно будет это сделать, если у вас есть проблемы, определенные в [этом запросе.][2].
+
+ [2]: https://issues.apache.org/jira/browse/CB-3458
+
+## Обновление проектов 2.6.0 до 2.7.0
+
+1. Загрузите и распакуйте исходный код Cordova 2.7.0 в постоянное место на вашем жестком диске, например в `~/Cordova-2.7.0`.
+
+2. Если оно выполняется, закройте Xcode.
+
+3. С помощью Terminal.app, перейдите в каталог, где вы положили загруженных исходных выше.
+
+4. Создайте новый проект, как описано в разделе "Руководство инструментов iOS". Вам нужны будут ресурсы из нового проекта.
+
+5. Скопируйте файл `www/cordova-2.7.0.js` из нового проекта в папке `www` и удалите файл `www/cordova-2.6.0.js`.
+
+6. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `cordova.js`.
+
+7. Обновите (или замените, если вы никогда не изменяли файл) файл `AppDelegate.m` в соотвествии такому же файлу из нового проекта (см. [этот diff][3]).
+
+8. В файле `config.xml`, [удалите эту строку][4].
+
+9. Удалить `CordovaLib` каталог и копию `CordovaLib` каталог из нового проекта в корневой директории вашего проекта.
+
+ [3]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/Classes/AppDelegate.m;h=5c05ac80e056753c0e8736f887ba9f28d5b0774c;hp=623ad8ec3c46f656ea18c6c3a190d650dd64e479;hb=c6e71147386d4ad94b07428952d1aae0a9cbf3f5;hpb=c017fda8af00375a453cf27cfc488647972e9a23
+ [4]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/config.xml;h=537705d76a5ef6bc5e57a8ebfcab78c02bb4110b;hp=8889726d9a8f8c530fe1371c56d858c34552992a;hb=064239b7b5fa9a867144cf1ee8b2fb798ce1f988;hpb=c9f233250d4b800f3412eeded811daaafb17b2cc
+
+## Обновление проектов 2.5.0 до 2.6.0
+
+1. Загрузите и распакуйте исходный код Cordova 2.6.0 в постоянное место на вашем жестком диске, например в `~/Cordova-2.6.0`.
+
+2. Если оно выполняется, закройте Xcode.
+
+3. С помощью Terminal.app, перейдите в каталог, где вы положили загруженных исходных выше.
+
+4. Создайте новый проект, как описано в разделе "Руководство инструментов iOS". Вам нужны будут ресурсы из нового проекта.
+
+5. Скопируйте файл `www/cordova-2.6.0.js` из нового проекта в папке `www` и удалите файл `www/cordova-2.5.0.js`.
+
+6. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `cordova-2.6.0.js`.
+
+7. Обновите (или замените, если вы никогда не изменяли файл) файл `AppDelegate.m` в соотвествии такому же файлу из нового проекта (см. [этот diff][5]).
+
+8. В файле `config.xml`, [добавьте эту новую строку][6].
+
+9. В файле `config.xml`, [добавьте эту новую строку][7].
+
+10. В файле `config.xml`, [UIWebViewBounce был изменен на DisallowOverscroll, и значения по умолчанию отличаются][8].
+
+11. В файле `config.xml` параметр `EnableLocation` является устаревшим.
+
+12. Удалить `CordovaLib` каталог и копию `CordovaLib` каталог из нового проекта в корневой директории вашего проекта.
+
+ [5]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/Classes/AppDelegate.m;h=124a56bb4f361e95616f44d6d6f5a96ffa439b60;hp=318f79326176be8f16ebc93bad85dd745f4205b6;hb=a28c7712810a63396e9f32fa4eb94fe3f8b93985;hpb=36acdf55e4cab52802d73764c8a4b5b42cf18ef9
+ [6]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/config.xml;h=1555b5e81de326a07efe0bccaa5f5e2326b07a9a;hp=0652d60f8d35ac13c825c572dca6ed01fea4a540;hb=95f16a6dc252db0299b8e2bb53797995b1e39aa1;hpb=a2de90b8f5f5f68bd9520bcbbb9afa3ac409b96d
+ [7]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/config.xml;h=d307827b7e67301171a913417fb10003d43ce39d;hp=04260aa9786d6d74ab20a07c86d7e8b34e31968c;hb=97b89edfae3527828c0ca6bb2f6d58d9ded95188;hpb=942d33c8e7174a5766029ea1232ba2e0df745c3f
+ [8]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/config.xml;h=8889726d9a8f8c530fe1371c56d858c34552992a;hp=d307827b7e67301171a913417fb10003d43ce39d;hb=57982de638a4dce6ae130a26662591741b065f00;hpb=ec411f18309d577b4debefd9a2f085ba719701d5
+
+## Обновление проектов 2.4.0 до 2.5.0
+
+1. Загрузите и распакуйте исходный код Cordova 2.5.0 в постоянное место на вашем жестком диске, например в `~/Cordova-2.5.0`.
+
+2. Если оно выполняется, закройте Xcode.
+
+3. С помощью Terminal.app, перейдите в каталог, где вы положили загруженных исходных выше.
+
+4. Создайте новый проект, как описано в разделе "Руководство инструментов iOS". Вам нужны будут ресурсы из нового проекта.
+
+5. Скопируйте файл `www/cordova-2.5.0.js` из нового проекта в папке `www` и удалите файл `www/cordova-2.4.0.js`.
+
+6. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `cordova-2.5.0.js`.
+
+7. Обновите (или замените, если вы никогда не изменяли файл) файл `AppDelegate.m` в соотвествии такому же файлу из нового проекта (см. [этот diff][9]).
+
+8. В файле `config.xml`, [добавьте эту строки][10].
+
+9. В файле `config.xml` , [измените корневой элемент, изменить его с cordova на widget][11].
+
+10. В файле `config.xml`, [удалите параметры OpenAllWhitelistURLsInWebView][12].
+
+11. Удалить каталог `cordova` и скопируйте каталог `cordova` из нового проекта в корневой каталог вашего проекта. В 2.5.0 это обновит скрипты.
+
+12. Удалить `CordovaLib` каталог и копию `CordovaLib` каталог из нового проекта в корневой директории вашего проекта.
+
+ [9]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/Classes/AppDelegate.m;h=318f79326176be8f16ebc93bad85dd745f4205b6;hp=6dc7bfc84f0ecede4cc43d2a3256ef7c5383b9fe;hb=4001ae13fcb1fcbe73168327630fbc0ce44703d0;hpb=299a324e8c30065fc4511c1fe59c6515d4842f09
+ [10]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/config.xml;h=903944c4b1e58575295c820e154be2f5f09e6314;hp=721c734120b13004a4a543ee25f4287e541f34be;hb=ae467249b4a256bd31ee89aea7a06f4f2316b8ac;hpb=9e39f7ef8096fb15b38121ab0e245a3a958d9cbb
+ [11]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/config.xml;h=64e71636f5dd79fa0978a97b9ff5aa3860a493f5;hp=d8579352dfb21c14e5748e09b2cf3f4396450163;hb=0e711f8d09377a7ac10ff6be4ec17d22cdbee88d;hpb=57c3c082ed9be41c0588d0d63a1d2bfcd2ed878c
+ [12]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/config.xml;h=721c734120b13004a4a543ee25f4287e541f34be;hp=7d67508b70914aa921a16e79f79c00512502a8b6;hb=187bf21b308551bfb4b98b1a5e11edf04f699791;hpb=03b8854bdf039bcefbe0212db937abd81ac675e4
+
+## Обновление проектов 2.3.0 до 2.4.0
+
+1. Загрузите и распакуйте исходный код Cordova 2.4.0 в постоянное место на вашем жестком диске, например в `~/Cordova-2.4.0`.
+
+2. Если оно выполняется, закройте Xcode.
+
+3. С помощью Terminal.app, перейдите в каталог, где вы положили загруженных исходных выше.
+
+4. Создайте новый проект, как описано в разделе "Руководство инструментов iOS". Вам нужны будут ресурсы из нового проекта.
+
+5. Скопируйте файл `www/cordova-2.4.0.js` из нового проекта в папке `www` и удалите файл `www/cordova-2.3.0.js`.
+
+6. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `cordova-2.4.0.js`.
+
+7. Обновите (или замените, если вы никогда не изменяли файл) файл `MainViewController.m` в соотвествии такому же файлу из нового проекта (см. [этот diff][13]).
+
+8. Обновите (или замените, если вы никогда не изменяли файл) файл `AppDelegate.m` в соотвествии такому же файлу из нового проекта (см. [этот diff][14]).
+
+9. В файле `config.xml`, [добавьте эту новую строку][15].
+
+10. Удалить каталог `cordova` и скопируйте каталог `cordova` из нового проекта в корневой каталог вашего проекта. В 2.4.0 это обновит скрипты.
+
+11. Удалить `CordovaLib` каталог и копию `CordovaLib` каталог из нового проекта в корневой директории вашего проекта.
+
+12. Добавьте AssetsLibrary.framework как ресурс в ваш проект. (См. [документацию Apple][16] для получения инструкций о том, как это сделать.).
+
+ [13]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/Classes/MainViewController.m;h=5f9eeac15c2437cd02a6eb5835b48374e9b94100;hp=89da1082d06ba5e5d0dffc5b2e75a3a06d5c2aa6;hb=b4a2e4ae0445ba7aec788090dce9b822d67edfd8;hpb=a484850f4610e73c7b20cd429a7794ba829ec997
+ [14]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/Classes/AppDelegate.m;h=6dc7bfc84f0ecede4cc43d2a3256ef7c5383b9fe;hp=1ca3dafeb354c4442b7e149da4f281675aa6b740;hb=6749c17640c5fed8a7d3a0b9cca204b89a855baa;hpb=deabeeb6fcb35bac9360b053c8bf902b45e6de4d
+ [15]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/config.xml;h=7d67508b70914aa921a16e79f79c00512502a8b6;hp=337d38da6f40c7432b0bce05aa3281d797eec40a;hb=6749c17640c5fed8a7d3a0b9cca204b89a855baa;hpb=deabeeb6fcb35bac9360b053c8bf902b45e6de4d
+ [16]: https://developer.apple.com/library/ios/#recipes/xcode_help-project_editor/Articles/AddingaLibrarytoaTarget.html
+
+## Обновление проектов 2.2.0 до 2.3.0
+
+1. Загрузите и распакуйте исходный код Cordova 2.3.0 в постоянное место на вашем жестком диске, например в `~/Cordova-2.3.0`.
+
+2. Если оно выполняется, закройте Xcode.
+
+3. С помощью Terminal.app, перейдите в каталог, где вы положили загруженных исходных выше.
+
+4. Создайте новый проект, как описано в разделе "Руководство инструментов iOS". Вам нужны будут ресурсы из нового проекта.
+
+5. Скопируйте файл `www/cordova-2.3.0.js` из нового проекта в папке `www` и удалите файл `www/cordova-2.2.0.js`.
+
+6. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `cordova-2.3.0.js`.
+
+7. Обновите (или замените, если вы никогда не изменяли файл) файл `MainViewController.m` в соотвествии такому же файлу из нового проекта.
+
+8. Удалить каталог `cordova` и скопируйте каталог `cordova` из нового проекта в корневой каталог вашего проекта. В 2.3.0 это обновит скрипты.
+
+9. Удалить `CordovaLib` каталог и копию `CordovaLib` каталог из нового проекта в корневой директории вашего проекта.
+
+10. Преобразуйте файл `Cordova.plist` в файл `config.xml`, запустив сценарий `bin/cordova\_plist\_to\_config\_xml` на вашем файле проекта.
+
+11. Добавьте плагин InAppBrowser в `config.xml`, путем добавления этого тега в `cordova>< plugins><`:
+
+ <plugin name="InAppBrowser" value="CDVInAppBrowser" />
+
+
+12. Обратите внимание, что плагины Objective-C, более *не* whitelisted. Чтобы разрешить ваши соединения с помощью списка разрешенных ресурсов приложение, вам нужно задать заголовок `User-Agent` для соединения таким же как пользовательский агент у основного Cordova WebView. Вы можете получить это, обратившись к свойство `userAgent` основного контроллера представления. Основной контроллер представления (`CDVViewController`) также имеет метод `URLisAllowed` который позволяет вам проверить, прошел ли URL-адрес ограничения списка разрешенных ресурсов.
+
+13. Изменения API устройства:
+
+ * Для iOS, device.platform использовалась для возвращения `iPhone`, `iPad` или `iPod Touch`; Теперь она возвращает (правильно) `iOS`.
+ * Для iOS, device.name (являющееся устаревшим для всех платформ) используется для возвращения имени устройства пользователя (например, ‘Shazron’s iPhone 5′); сейчас это свойство возвращает тоже что должен возвращать device.platform: `iPhone`, `iPad` или `iPod Touch`.
+ * Для всех платформ, существует новое свойство под названием device.model; оно возвращает определенную модель устройства , например `iPad2,5` (для других платформ, это свойство возвращает то что должно возвращать свойство device.name).
+
+## Обновление проектов 2.1.0 до 2.2.0
+
+1. Загрузите и распакуйте исходный код Cordova 2.2.0 в постоянное место на вашем жестком диске, например в `~/Cordova-2.2.0`.
+
+2. Если оно выполняется, закройте Xcode.
+
+3. С помощью Terminal.app, перейдите в каталог, где вы положили загруженных исходных выше.
+
+4. Создайте новый проект, как описано в разделе "Руководство инструментов iOS". Вам нужны будут ресурсы из нового проекта.
+
+5. Скопируйте файл `www/cordova-2.2.0.js` из нового проекта в папке `www` и удалите файл `www/cordova-2.1.0.js`.
+
+6. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `cordova-2.2.0.js`.
+
+7. Обновите (или замените, если вы никогда не изменяли файл) файл `MainViewController.m` в соотвествии такому же файлу из нового проекта:
+
+ * Updated → viewWillAppear
+
+8. Скопируйте каталог `cordova` из нового проекта в корневую папку вашего проекта. В 2.2.0 она имеет обновленный сценарий 'emulate'.
+
+9. Далее обновите ссылку проекта `CordovaLib` . Начиная с Cordova 2.1.0, мы не используем больше переменную Xcode CORDOVALIB для указания где находится `CordovaLib` , ссылка теперь является абсолютной ссылкой.
+
+ 1. Запустите Terminal.app
+ 2. Перейдите к папке, где установлена Cordova (см. шаг 1), в подкаталог `bin`
+ 3. Запустите сценарий указанный ниже, где первым параметром является путь к файлу проекта `.xcodeproj` :
+
+ `update_cordova_subproject path/to/your/project/xcodeproj`
+
+**Примечание**: В 2.2.0, сценарий `bin/create` копирует в подпапку `CordovaLib` проекта. Чтобы иметь тот же тип установки, просто скопируйте корректный `CordovaLib` в каталог проекта и обновить местоположение проекта `CordovaLib` (относительно проекта) в инспекторе файлов Xcode.
+
+## Обновление проектов 2.0.0 до 2.1.0
+
+С Cordova 2.1.0 проект `CordovaLib` был обновлен для использования **Автоматического подсчета ссылок (ARC)**. Вам не нужно обновление до **ARC** для использования CordovaLib, но если вы хотите обновить проект для использования **ARC**, пожалуйста используйте мастер миграции Xcode из меню: **Edit → Refactor → Convert to Objective-C ARC...**, снимите флажок libCordova.a, а затем запустите мастер для завершения.
+
+1. Загрузите и распакуйте исходный код Cordova 2.1.0 в постоянное место на вашем жестком диске, например в `~/Cordova-2.1.0`.
+
+2. Если оно выполняется, закройте Xcode.
+
+3. С помощью Terminal.app, перейдите в каталог, где вы положили загруженных исходных выше.
+
+4. Создайте новый проект, как описано в разделе "Руководство инструментов iOS". Вам нужны будут ресурсы из нового проекта.
+
+5. Скопируйте файл `www/cordova-2.1.0.js` из нового проекта в папке `www` и удалите файл `www/cordova-2.0.0.js`.
+
+6. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `cordova-2.1.0.js`.
+
+7. Обновите (или замените, если вы никогда не изменяли файл) файл `AppDelegate.m` в соотвествии такому же файлу из нового проекта:
+
+ * Edited → application:didFinishLaunchingWithOptions:
+ * Added → application:supportedInterfaceOrientationsForWindow:
+
+8. Обновите (или замените, если вы никогда не изменяли файл) файл `MainViewController.m` в соотвествии такому же файлу из нового проекта:
+
+ * Added → viewWillAppear
+
+9. Скопируйте каталог `cordova` из нового проекта в корневой директории вашего проекта. В 2.1.0 этот каталог содержит обновленные скрипты для поддержки пути с пробелами.
+
+10. Удалите ссылки на файл `VERSION` файл из проекта (*не* тот который расположен в `CordovaLib`).
+
+11. Далее обновите ссылку проекта `CordovaLib` . Начиная с Cordova 2.1.0, мы не используем больше переменную Xcode CORDOVALIB для указания где находится `CordovaLib` , ссылка теперь является абсолютной ссылкой.
+
+ 1. Запустите Terminal.app
+ 2. Перейдите к папке, где установлена Cordova (см. шаг 1), в подкаталог `bin`
+ 3. Запустите сценарий указанный ниже, где первым параметром является путь к файлу проекта `.xcodeproj` :
+
+ `update_cordova_subproject path/to/your/project/xcodeproj`
+
+## Обновление проектов с 1.9.0 до 2.0.0
+
+1. Установите Cordova 2.0.0.
+
+2. Создайте новый проект, как описано в разделе "Руководство инструментов iOS". Вам нужны будут ресурсы из нового проекта.
+
+3. Скопируйте файл `www/cordova-2.0.0.js` из нового проекта в папке `www` и удалите файл `www/cordova-1.9.0.js`.
+
+4. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `cordova-2.0.0.js`.
+
+5. Скопируйте каталог `cordova` из нового проекта в корневой каталог вашего проекта (если вы хотите средства командной строки для проекта).
+
+6. Добавьте новую запись в разделе `Plugins` в файле `Cordova.plist` , в группе **Supporting Files** . Ключ `Device` и значение `CDVDevice`.
+
+7. Удалите `Cordova.framework`.
+
+8. Удалите `verify.sh` из группы **Supporting Files** .
+
+9. Выберите значок проекта в Project Navigator, выберите **Target** для проекта, а затем выберите вкладку **Build Settings** .
+
+10. Найдите **Preprocessor Macros**, затем удалите все значения **CORDOVA_FRAMEWORK=1**.
+
+11. Найдите каталог `CordovaLib`, который был установлен на ваш жесткий диск, в поддиректории `Documents` в вашей домашней папке.
+
+12. Найдите файл `CordovaLib.xcodeproj` в папке `CordovaLib` , а затем перетащите этот файл в ваш проект. Он должен отображаться как подпроект.
+
+13. Постройте ваш проект, вы должны получить некоторые ошибки, связанные с директивой `#import` .
+
+14. Для ошибок `#import` измените любой импорт в двойных кавычках в следующем стиле:
+
+ #import "CDV.h"
+
+
+ в стиль, основанный на скобках:
+
+ #import <Cordova/CDV.h>
+
+
+ и удалите любые `#ifdef` обертки вокруг любого импорта Cordova, они больше не нужны (импорты теперь унифицированы)
+
+15. Снова соберите свой проект, и он более не должен иметь каких-либо ошибок `#import` .
+
+16. Выберите **значок проекта** в Project Navigator, выберите **Target** проекта, а затем выберите вкладку **Build Phases** .
+
+17. Разверните фазу **Target Dependencies**, а затем выберите **+** кнопку.
+
+18. Выберите цель `CordovaLib` , а затем выберите кнопку **Add** .
+
+19. Разверните первый этап **Link Binary with Libraries** (он уже должен содержать кучу фреймворков), а затем выберите кнопку **+**.
+
+20. Выберите статическую библиотеку `libCordova.a` , а затем выберите кнопку **Add** .
+
+21. Удалите фазу **Run Script** .
+
+22. Выберите **значок проекта** в Project Navigator, выберите **Target** проекта, а затем выберите вкладку **Build Phases**.
+
+23. Найдите **Other Linker Flags** и добавьте значения **-force_load** **-Obj-С**.
+
+24. Разверните `CordovaLib` под-проект.
+
+25. Найдите файл `VERSION`, перетащите ее в ваш основной проект (мы хотим создать ссылку на него, не копию).
+
+26. Выберите переключатель **Create groups for any added folders**, а затем выберите кнопку **Finish**.
+
+27. Выберите файл `VERSION`, который вы только что перетащили на предыдущем шаге.
+
+28. Нажмите сочетание клавиш **Option-Command-1**, чтобы показать **File Inspector** (или пункт меню **View → Utilities → Show File Inspector**).
+
+29. Выбрать **Relative to CORDOVALIB** в **File Inspector** для раскрывающегося меню для **Location**.
+
+30. Xcode предпочтения **Xcode Preferences → Locations → Derived Data → Advanced...** можно присвоить **Unique**, так что унифицированные заголовки можно будет найти.
+
+31. Выберите **значок проекта** в Project Navigator, выберите **Target** проекта, а затем выберите вкладку **Build Phases**.
+
+32. Найдите **Header Search Paths**. Для этого параметра, добавьте эти три значения, включая кавычки:
+
+ "$(TARGET_BUILD_DIR)/usr/local/lib/include"
+
+ "$(OBJROOT)/UninstalledProducts/include"
+
+ "$(BUILT_PRODUCTS_DIR)"
+
+
+33. Найдите **Other Linker Flags**. Для этого параметра, добавьте это значение:
+
+ -weak_framework CoreFoundation
+
+
+34. Постройте свой проект, это должно скомпилировать и связать **без** вопросов.
+
+35. Выберите проект в раскрывающемся списке **Scheme** , а затем выберите **iPhone 5.1 Simulator**.
+
+36. Выберите кнопку **Run** .
+
+**Примечание**: Если ваш проект не работает как ожидалось в симуляторе, пожалуйста обратите внимание на любые ошибки в журнале консоли Xcode для подсказки.
+
+## Обновление проектов 1.8.x до 1.9.0
+
+1. Установите Cordova 1.9.0.
+
+2. Создайте новый проект. Вам понадобится некоторые из активов от этого нового проекта.
+
+3. Скопируйте файл `www/cordova-1.9.0.js` из нового проекта в папке `www` и удалите файл `www/cordova-1.8.x.js`.
+
+4. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `cordova-1.9.0.js`.
+
+**Примечание**: 1.9.0 поддерживает новый boolean параметр `Cordova.plist` `BackupWebStorage` . Он включен по умолчанию, поэтому установите его в `значение false,` чтобы отключить его, особенно на iOS 6. Смотреть [Release Notes: Safari and UIKit Section][17]
+
+ [17]: https://developer.apple.com/library/prerelease/ios/#releasenotes/General/RN-iOSSDK-6_0/_index.html
+
+## Обновление проектов 1.7.0 до 1.8.x
+
+1. Установите Cordova 1.8.0.
+
+2. Создайте новый проект. Вам понадобится некоторые из активов от этого нового проекта.
+
+3. Скопируйте файл `www/cordova-1.8.0.js` из нового проекта в папке `www` и удалите файл `www/cordova-1.7.x.js`.
+
+4. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `cordova-1.8.0.js`.
+
+Если вы собираетесь использовать Capture API, вам понадобится новые ресурсы для **iPad с retina дисплеем**:
+
+1. Скопируйте элемент `Resources/Capture.bundle` из нового проекта в каталог проекта, перезапишите ваш существующий элемент `Resources/Capture.bundle` .
+
+2. В вашем проекте выберите пункт `Capture.bundle` в навигаторе проекта в Xcode, нажмите клавишу **Delete**, а затем выберите **Remove Reference** в появившемся диалоговом окне.
+
+3. Перетащите новый `Capture.bundle` из шага 1 выше, в навигаторе проекта в Xcode, а затем выберите переключатель **Create groups for any added folders** .
+
+## Обновление проектов 1.6.x до 1.7.0
+
+1. Установите Cordova 1.7.0.
+
+2. Создайте новый проект. Вам понадобится некоторые из активов от этого нового проекта.
+
+3. Скопируйте файл `www/cordova-1.7.0.js` из нового проекта в папке `www` и удалите файл `www/cordova-1.6.0.js`.
+
+4. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `cordova-1.7.0.js`.
+
+## Обновление проектов 1.5.0 до 1.6.x
+
+1. Установите Cordova 1.6.1.
+
+2. Сделайте резервную копию файлов `AppDelegate.m`, `AppDelegate.h`, `MainViewController.m`, `MainViewController.h` и `Cordova.plist` в вашем проекте.
+
+3. Создайте новый проект. Вам понадобится некоторые из активов от этого нового проекта.
+
+4. Скопируйте эти файлы из нового проекта в папке проекта 1.5.0 на диске, заменив старые файлы (сперва сделайте резервное копирование файлов из шага 2 указанного выше):
+
+ AppDelegate.h
+ AppDelegate.m
+ MainViewController.h
+ MainViewController.m
+ Cordova.plist
+
+
+5. Добавьте в свой проект Xcode все новые файлы `MainViewController` и `AppDelegate` .
+
+6. Скопируйте файл `www/cordova-1.6.0.js` из нового проекта в папке `www` и удалите файл `www/cordova-1.5.0.js`.
+
+7. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `cordova-1.6.1.js`.
+
+8. Добавьте в проект новый файл `Cordova.plist` . Это необходимо потому, что имена основных служб плагинов должны измениться, чтобы соответствовать тем же службам в Android и BlackBerry, для единого файла Cordova JavaScript (`cordova-js`).
+
+9. Интегрируйте любые настройки, записи **Plugins** и **ExternalHosts**, которые вы имели в вашем **резервном Cordova.plist** в новый `Cordova.plist`.
+
+10. Интегрируйте любой код уникальный для конкретного проекта, который вы сохранили в резервной копии `AppDelegate.h` и `AppDelegate.m` в новые файлы `AppDelegate` . Любой код `UIWebViewDelegate` или `CDVCommandDelegate` в `AppDelegate.m` должен уйти в `MainViewController.m` (см. закомментированные разделы в этом файле).
+
+11. Интегрируйте любой код уникальный для конкретного проекта, который вы сохранили в резервной копии `MainViewController.h` и `MainViewController.m` в новые файлы MainViewController.
+
+12. Нажмите на значок проекта в диспетчере структуры проекта, выберите **Project**, а затем выберите вкладку **Build Settings** .
+
+13. Введите **Compiler for C/C++/Objective-C** в поле поиска.
+
+14. Выберите значение **Apple LLVM Compiler 3.1** .
+
+## Обновление проектов 1.4.x до 1.5.0
+
+1. Установите Cordova 1.5.0.
+
+2. Создайте новый проект и запустите его один раз. Вам понадобится некоторые из активов от этого нового проекта.
+
+3. Скопируйте файл `www/cordova-1.5.0.js` из нового проекта в папке `www` и удалите файл `www/phonegap-1.4.x.js`.
+
+4. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `cordova-1.5.0.js`.
+
+5. Найти `PhoneGap.framework` в вашем навигаторе проекта, выберите его.
+
+6. Нажмите кнопку **Delete** и удалить ссылку на `PhoneGap.framework` в диспетчере структуры проекта.
+
+7. Введите сочетание клавиш **Option-Command-A**, это должно открыть выпадающий список для добавления файлов в проект (лист **Add Files...** ). Убедитесь, что выбран переключатель **Created groups for any added folders** .
+
+8. Введите сочетание клавиш **Command-Shift-G** , которая должна открыть другой выпадающий список для вас, чтобы перейти к папке (**Go to the folder:** лист).
+
+9. Введите `/Users/Shared/Cordova/Frameworks/Cordova.framework` в **Go to the folder:** лист, а затем нажмите кнопку **Go** .
+
+10. Нажмите на кнопку **Add** в окне **Add Files...** .
+
+11. Выберите `Cordova.framework` в диспетчере структуры проекта.
+
+12. Введите сочетание клавиш **Option-Command-1** , чтобы открыть **File Inspector**.
+
+13. Выберите **Absolute Path** в **File Inspector** для раскрывающегося меню в **Location**.
+
+14. Введите сочетание клавиш **Option-Command-A**, это должно открыть выпадающий список для добавления файлов в проект (лист **Add Files...** ). Убедитесь, что выбран переключатель **Created groups for any added folders** .
+
+15. Введите сочетание клавиш **Command-Shift-G** , которая должна открыть другой выпадающий список для вас, чтобы перейти к папке (**Go to the folder:** лист).
+
+16. Введите `~/Documents/CordovaLib/Classes/deprecated` в окне **Go to the folder:**, а затем нажмите кнопку **Go** .
+
+17. Нажмите на кнопку **Add** в окне **Add Files...**.
+
+18. В файлах `AppDelegate.h`, `AppDelegate.m`и `MainViewController.h` замените весь блок `#ifdef PHONEGAP_FRAMEWORK` на:
+
+ #import "CDVDeprecated.h"
+
+
+19. Выберите **значок проекта** в Project Navigator, выберите **Target** проекта, а затем выберите вкладку **Build Phases**.
+
+20. Найдите **Framework Search Paths**.
+
+21. Замените существующее значение на `/Users/Shared/Cordova/Frameworks`.
+
+22. Найдите **Preprocessor Macros**.
+
+23. Для первого (комбинированного) значения, замените значение на **CORDOVA_FRAMEWORK=YES**.
+
+24. Выберите вкладку **Build Phases** .
+
+25. Разверните узел **Run Script**.
+
+26. Замените все вхождения **PhoneGap** на **Cordova**.
+
+27. Найдите файл `PhoneGap.plist` в диспетчере структуры проекта и щелкните на имени файла, для того, чтобы войти в режим редактирования имени.
+
+28. Переименуйте `PhoneGap.plist` в `Cordova.plist`.
+
+29. Щелкните правой кнопкой мыши `Cordova.plist` и выберите **Open As → Source Code**.
+
+30. Нажмите **Option-Command-F**, выберите **Replace** из раскрывающегося списка в верхней левой части окна исходного кода.
+
+31. Введите `com.phonegap` для строки поиска и `org.apache.cordova` для строки замены, а затем нажмите кнопку **Replace All** .
+
+32. Введите **PG** для строки поиска и **CDV** для строки замены, а затем нажмите кнопку **Replace All** .
+
+33. Нажмите **Command-B**, для построения. У вас до сих пор остались устаревшие коды от которых вы можете избавиться в будущем (см. `CDVDeprecated.h`. К примеру, заменить классы в коде, использующие PG* на CDV*).
+
+## Обновление проектов 1.4.0 до 1.4.1
+
+1. Установите Cordova 1.4.1.
+
+2. Сделайте резервную копию `MainViewController.m`.
+
+3. Создайте новый проект. Вам понадобится некоторые из активов от этого нового проекта.
+
+4. Скопируйте файл `MainViewController.m` из нового проекта в каталог проекта 1.4.0на диске, заменив старый файл (сперва сделайте резервное копирования ваших файлов из шага 2 указанного выше).
+
+5. Добавьте файл `MainViewController.m` в ваш проект Xcode.
+
+6. Интегрируйте любой код уникальный для конкретного проекта, который вы сохранили в резервной копии `MainViewController.m` в новый файл.
+
+7. Обновление файла `phonegap-1.4.0.js` является необязательным, в JavaScript между 1.4.0 и 1.4.1 ничего не изменилось.
+
+## Обновление проектов с 1.3.0 до 1.4.0
+
+1. Установите Cordova 1.4.0.
+
+2. Сделайте резервную копию `AppDelegate.m` и `AppDelegate.h` в вашем проекте.
+
+3. Создайте новый проект. Вам понадобится некоторые из активов от этого нового проекта.
+
+4. Скопируйте эти файлы из нового проекта в папке проекта 1.3.0 на диске, заменив старые файлы (сперва сделайте резервное копирование файлов из шага 2 указанного выше):
+
+ AppDelegate.h
+ AppDelegate.m
+ MainViewController.h
+ MainViewController.m
+ MainViewController.xib
+
+
+5. Добавьте файл `MainViewController.m` в ваш проект Xcode.
+
+6. Скопируйте файл `www/phonegap-1.4.0.js` из нового проекта в папке `www` и удалите файл `www/phonegap-1.3.0.js`.
+
+7. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `phonegap-1.4.0.js`.
+
+8. Добавьте новую запись под `Plugins` в `PhoneGap.plist` файл. Ключ `com.phonegap.battery` и значение`PGBattery`.
+
+9. Интегрировать любой код конкретного проекта, у вас есть в вашей резервной копии `AppDelegate.h` и `AppDelegate.m` в новой AppDelegate файлы.
+
+## Обновление проектов с 1.2.0 до 1.3.0
+
+1. Установите Cordova 1.3.0.
+
+2. Сделайте резервную копию `AppDelegate.m` и `AppDelegate.h` в вашем проекте.
+
+3. Создайте новый проект. Вам понадобится некоторые из активов от этого нового проекта.
+
+4. Скопируйте эти файлы из нового проекта в папке проекта 1.2.0 на диске, заменив старые файлы (сперва сделайте резервное копирование файлов из шага 2 указанного выше):
+
+ AppDelegate.h
+ AppDelegate.m
+ MainViewController.h
+ MainViewController.m
+ MainViewController.xib
+
+
+5. Добавьте файл `MainViewController.m` в ваш проект Xcode.
+
+6. Скопируйте файл `www/phonegap-1.3.0.js` из нового проекта в папке `www` и удалите файл `www/phonegap-1.2.0.js`.
+
+7. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `phonegap-1.3.0.js`.
+
+8. Добавьте новую запись под `Plugins` в `PhoneGap.plist` файл. Ключ `com.phonegap.battery` и значение`PGBattery`.
+
+9. Интегрировать любой код конкретного проекта, у вас есть в вашей резервной копии `AppDelegate.h` и `AppDelegate.m` в новой AppDelegate файлы.
+
+## Обновление проектов с 1.1.0 до 1.2.0
+
+1. Установите Cordova 1.2.0.
+
+2. Сделайте резервную копию `AppDelegate.m` и `AppDelegate.h` в вашем проекте.
+
+3. Создайте новый проект. Вам понадобится некоторые из активов от этого нового проекта.
+
+4. Скопируйте эти файлы из нового проекта в папке проекта 1.1.0 на диске, заменив старые файлы (сперва сделайте резервное копирование файлов из шага 2 указанного выше):
+
+ AppDelegate.h
+ AppDelegate.m
+ MainViewController.h
+ MainViewController.m
+ MainViewController.xib
+
+
+5. Добавьте файл `MainViewController.m` в ваш проект Xcode.
+
+6. Скопируйте файл `www/phonegap-1.2.0.js` из нового проекта в папке `www` и удалите файл `www/phonegap-1.1.0.js`.
+
+7. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `phonegap-1.2.0.js`.
+
+8. Добавьте новую запись под `Plugins` в `PhoneGap.plist` файл. Ключ `com.phonegap.battery` и значение`PGBattery`.
+
+9. Интегрировать любой код конкретного проекта, у вас есть в вашей резервной копии `AppDelegate.h` и `AppDelegate.m` в новой AppDelegate файлы.
+
+## Обновление проектов с 1.0.0 до 1.1.0
+
+1. Установите Cordova 1.1.0.
+
+2. Сделайте резервную копию `AppDelegate.m` и `AppDelegate.h` в вашем проекте.
+
+3. Создайте новый проект. Вам понадобится некоторые из активов от этого нового проекта.
+
+4. Скопируйте эти файлы из нового проекта в папке проекта 1.0.0 на диске, заменив старые файлы (сперва сделайте резервное копирование файлов из шага 2 указанного выше):
+
+ AppDelegate.h
+ AppDelegate.m
+ MainViewController.h
+ MainViewController.m
+ MainViewController.xib
+
+
+5. Добавьте файл `MainViewController.m` в ваш проект Xcode.
+
+6. Скопируйте файл `www/phonegap-1.1.0.js` из нового проекта в папке `www` и удалите файл `www/phonegap-1.0.0.js`.
+
+7. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `phonegap-1.1.0.js`.
+
+8. Добавьте новую запись под `Plugins` в `PhoneGap.plist` файл. Ключ `com.phonegap.battery` и значение`PGBattery`.
+
+9. Интегрировать любой код конкретного проекта, у вас есть в вашей резервной копии `AppDelegate.h` и `AppDelegate.m` в новой AppDelegate файлы.
+
+## Обновление проектов с 0.9.6 до 1.0.0
+
+1. Установите Cordova 1.0.0.
+
+2. Сделайте резервную копию `AppDelegate.m` и `AppDelegate.h` в вашем проекте.
+
+3. Создайте новый проект. Вам понадобится некоторые из активов от этого нового проекта.
+
+4. Скопируйте эти файлы из нового проекта в папке проекта 0.9.6 на диске, заменив старые файлы (сперва сделайте резервное копирование файлов из шага 2 указанного выше):
+
+ AppDelegate.h
+ AppDelegate.m
+ MainViewController.h
+ MainViewController.m
+ MainViewController.xib
+
+
+5. Добавьте файл `MainViewController.m` в ваш проект Xcode.
+
+6. Скопируйте файл `www/phonegap-1.0.0.js` из нового проекта в папке `www` и удалите файл `www/phonegap-0.9.6.js`.
+
+7. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `phonegap-1.0.0.js`.
+
+8. Добавьте новую запись под `Plugins` в `PhoneGap.plist` файл. Ключ `com.phonegap.battery` и значение`PGBattery`.
+
+9. Интегрировать любой код конкретного проекта, у вас есть в вашей резервной копии `AppDelegate.h` и `AppDelegate.m` в новой AppDelegate файлы.
\ No newline at end of file
diff --git a/docs/ru/5.0.0/guide/platforms/ios/upgrading.md b/docs/ru/5.0.0/guide/platforms/ios/upgrading.md
new file mode 100644
index 0000000..91f21bd
--- /dev/null
+++ b/docs/ru/5.0.0/guide/platforms/ios/upgrading.md
@@ -0,0 +1,768 @@
+---
+
+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.
+---
+
+# Обновление iOS
+
+В этом руководстве показано, как изменять проекты iOS для обновления старых версий Cordova. Большинство этих инструкций применимы для проектов, созданных с старого набора средств командной строки, которые предшествуют `cordova` утилиты CLI. Увидеть интерфейс командной строки для получения информации как обновить версию инфраструктуры CLI.
+
+**Примечание**: Xcode 4.6 не требуется, рекомендуется Xcode 5. В настоящее время представить в Apple App Store, следует использовать последнюю поставляется версию iOS SDK, который является iOS 7. iOS 7 SDK пока не требуется, но это может быстро измениться.
+
+## Обновление 3.1.0 проектов до 3.2.0
+
+Для проектов-CLI выполните:
+
+ bin/обновить путь/к/проекта
+
+
+Для проектов CLI:
+
+1. Обновление `cordova` CLI-версия. Увидеть интерфейс командной строки.
+
+2. Запуск`cordova platform update ios`
+
+## Обновления 3.0.0 проектов для 3.1.0
+
+Для проектов-CLI выполните:
+
+ bin/обновить путь/к/проекта
+
+
+Для проектов CLI:
+
+1. Обновление `cordova` CLI-версия. Увидеть интерфейс командной строки.
+
+2. Запуск`cordova platform update ios`
+
+iOS 7 вопросов:
+
+1. Удалить `width=device-width, height=device-height` из `index.html` файла `viewport` `meta` тег. (См. [соответствующую ошибку][1].)
+
+2. Обновление средств массовой информации, средства массовой информации захват и splashscreen основные плагины для iOS 7 поддержки.
+
+ [1]: https://issues.apache.org/jira/browse/CB-4323
+
+Xcode 5 вопросов:
+
+1. Обновите параметры проекта, если Xcode 5 предлагает вам сделать это (в навигаторе вопросы).
+
+2. Обновление вашего **компилятор для C / C + +/ Objective-C** настройки, на вкладке **Параметры построения** , раздел **Параметры построения** . Выберите **по умолчанию компилятор (Apple LLVM 5.0)**.
+
+## Обновление к CLI (3.0.0) с 2.9.0
+
+1. Создайте новый проект Apache Cordova 3.0.0 используя cordova CLI, как описано в интерфейс командной строки.
+
+2. Добавьте ваш платформ в Кордове проект, например:`cordova
+platform add ios`.
+
+3. Скопируйте содержимое проекта `www` каталог `www` каталог в корневом каталоге проекта cordova, вы только что создали.
+
+4. Копирование или перезаписать любые родной активы от вашего первоначального проекта ( `Resources` , и т.д.), что, конечно, чтобы добавить новые файлы в `.xcodeproj` проекта. Проект iOS строит внутри `platforms\ios` каталог.
+
+5. Копия вашего `config.xml` в `www` каталог и удалить любой плагин определения. Измените настройки здесь, а не каталог платформы.
+
+6. Используйте средство CLI cordova для установки любых плагинов, что вам нужно. Обратите внимание, что CLI обрабатывает все основные API плагинов, так что они могут и должны быть добавлены. Только 3.0.0 плагины совместимы с CLI.
+
+7. Построение и тестирование.
+
+## Проекты модернизации 2.9.0 3.0.0
+
+1. Загрузите и извлеките Cordova 3.0.0 Источник постоянного каталог на вашем жестком диске, например для`~/Documents/Cordova-3.0.0`.
+
+2. Закройте Xcode, если она запущена.
+
+3. С помощью Terminal.app, перейдите в каталог, где вы положили загруженных исходных выше.
+
+4. Создайте новый проект, как описано в iOS утилиты командной строки. Вам нужен активов от этого нового проекта.
+
+5. Копия `www/cordova.js` (Обратите внимание, что он не имеет суффикса версии больше, версия в сам файл в заголовке) файл из нового проекта в ваш `www` каталог и удалить ваш `www/cordova.js` файл.
+
+6. Обновите ссылку на сценарий Кордова в ваш `www/index.html` файл (и любые другие файлы, которые содержат ссылку на сценарий) на новый `cordova.js` файл.
+
+7. Удалить ваш `CordovaLib` каталог и копию `CordovaLib` каталог из нового проекта в корневой директории вашего проекта.
+
+**Примечание**: начиная с Кордова 3.0.0, предварительно не установлены плагины, и вам нужно использовать `plugman` утилита командной строки, чтобы установить их самостоятельно. Смотрите в разделе Использование Plugman для управления плагинами.
+
+## Проекты модернизации 2.8.0 2.9.0
+
+1. Загрузите и извлеките Cordova 2.9.0 Источник постоянного каталог на вашем жестком диске, например для`~/Documents/Cordova-2.9.0`.
+
+2. Закройте Xcode, если она запущена.
+
+3. С помощью Terminal.app, перейдите в каталог, где вы положили загруженных исходных выше.
+
+4. Создайте новый проект, как описано в iOS утилиты командной строки. Вам нужен активов от этого нового проекта.
+
+5. Копия `www/cordova.js` (Обратите внимание, что он не имеет суффикса версии больше, версия в сам файл в заголовке) файл из нового проекта в ваш `www` каталог и удалить ваш `www/cordova.js` файл.
+
+6. Обновите ссылку на сценарий Кордова в ваш `www/index.html` файл (и любые другие файлы, которые содержат ссылку на сценарий) на новый `cordova.js` файл.
+
+7. Удалить ваш `CordovaLib` каталог и копию `CordovaLib` каталог из нового проекта в корневой директории вашего проекта.
+
+## Проекты модернизации 2.7.0 2.8.0
+
+1. Загрузите и извлеките Cordova 2.8.0 Источник постоянного каталог на вашем жестком диске, например для`~/Documents/Cordova-2.8.0`.
+
+2. Закройте Xcode, если она запущена.
+
+3. С помощью Terminal.app, перейдите в каталог, где вы положили загруженных исходных выше.
+
+4. Создайте новый проект, как описано в iOS утилиты командной строки. Вам нужен активов от этого нового проекта.
+
+5. Копия `www/cordova.js` (Обратите внимание, что он не имеет суффикса версии больше, версия в сам файл в заголовке) файл из нового проекта в ваш `www` каталог и удалить ваш `www/cordova-2.7.0.js` файл.
+
+6. Обновите ссылку на сценарий Кордова в ваш `www/index.html` файл (и любые другие файлы, которые содержат ссылку на сценарий) на новый `cordova.js` файл.
+
+7. Обновлять любой `<plugin>` теги в `config.xml` файл `<feature>` теги. Обратите внимание, что существующие `<plugin>` теги по-прежнему работать, но являются устаревшими. Вы можете скопировать эту информацию в `config.xml` файл для нового проекта. Например:
+
+ <plugins>
+ <plugin name="LocalStorage" value="CDVLocalStorage" />
+ <!-- other plugins -->
+ </plugins>
+
+ <!-- change to: (note that a <feature> tag is on the same level as <plugins> -->
+ <feature name="LocalStorage">
+ <param name="ios-package" value="CDVLocalStorage" />
+ </feature>
+ <!-- other <feature> tags -->
+
+
+8. Удалить `CordovaLib` каталог и копию `CordovaLib` каталог из нового проекта в корневой директории вашего проекта.
+
+9. Добавьте эти две структуры в проект:
+
+ OpenAL ImageIO
+
+
+10. Обновление вашего проекта целевые **Параметры построения**. В разделе **Связывание → другие флаги компоновщика**, измените **«- Obj - C»** быть **"-ObjC»**.
+
+11. Обновление вашего проекта целевые **Параметры построения**. В разделе **Связывание → другие флаги компоновщика**, измените **»-all_load «** быть `-force\_load ${BUILT\_PRODUCTS\_DIR}/libCordova.a` . Вам только нужно будет это сделать, если у вас есть проблемы, определенные в [этот вопрос.][2].
+
+ [2]: https://issues.apache.org/jira/browse/CB-3458
+
+## Проекты модернизации 2.6.0 2.7.0
+
+1. Загрузите и извлеките Cordova 2.7.0 Источник постоянного каталог на вашем жестком диске, например для`~/Documents/Cordova-2.7.0`.
+
+2. Закройте Xcode, если она запущена.
+
+3. С помощью Terminal.app, перейдите в каталог, где вы положили загруженных исходных выше.
+
+4. Создайте новый проект, как описано в iOS утилиты командной строки. Вам нужен активов от этого нового проекта.
+
+5. Копия `www/cordova-2.7.0.js` файл из нового проекта в ваш `www` каталог и удалить ваш `www/cordova-2.6.0.js` файл.
+
+6. Обновите ссылку на сценарий Кордова в ваш `www/index.html` файл (и любые другие файлы, которые содержат ссылку на сценарий) на новый `cordova-2.7.0.js` файл.
+
+7. Обновление (или заменить, если вы никогда не изменил файл) ваш `AppDelegate.m` файл согласно одной из нового проекта (см. [это diff][3]).
+
+8. В вашем `config.xml` файла, [удалите эту строку][4].
+
+9. Удалить ваш `CordovaLib` каталог и копию `CordovaLib` каталог из нового проекта в корневой директории вашего проекта.
+
+ [3]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/Classes/AppDelegate.m;h=5c05ac80e056753c0e8736f887ba9f28d5b0774c;hp=623ad8ec3c46f656ea18c6c3a190d650dd64e479;hb=c6e71147386d4ad94b07428952d1aae0a9cbf3f5;hpb=c017fda8af00375a453cf27cfc488647972e9a23
+ [4]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/config.xml;h=537705d76a5ef6bc5e57a8ebfcab78c02bb4110b;hp=8889726d9a8f8c530fe1371c56d858c34552992a;hb=064239b7b5fa9a867144cf1ee8b2fb798ce1f988;hpb=c9f233250d4b800f3412eeded811daaafb17b2cc
+
+## Проекты модернизации 2.5.0 2.6.0
+
+1. Загрузите и извлеките Cordova 2.6.0 Источник постоянного каталог на вашем жестком диске, например для`~/Documents/Cordova-2.6.0`.
+
+2. Закройте Xcode, если она запущена.
+
+3. С помощью Terminal.app, перейдите в каталог, где вы положили загруженных исходных выше.
+
+4. Создайте новый проект, как описано в iOS утилиты командной строки. Вам нужен активов от этого нового проекта.
+
+5. Копирование проекта `www/cordova-2.6.0.js` файл в ваш `www` каталог и удалить ваш `www/cordova-2.5.0.js` файл.
+
+6. Обновить ссылку скрипт Кордова в ваш `www/index.html` файл (а также любые другие файлы, ссылки на сценарий) сослаться на новый `cordova-2.6.0.js` файл.
+
+7. Обновление (или заменить, если вы никогда не изменил файл) ваш `AppDelegate.m` файл согласно одной из нового проекта (см. [это diff][5]).
+
+8. В вашем `config.xml` файла, [добавьте эту строку][6].
+
+9. В вашем `config.xml` файла, [добавьте эту строку][7].
+
+10. В ваш `config.xml` файл, [UIWebViewBounce был изменен на DisallowOverscroll, и значения по умолчанию отличаются][8].
+
+11. В ваш `config.xml` файл, `EnableLocation` предпочтение является устаревшим.
+
+12. Удалить ваш `CordovaLib` каталог и копию `CordovaLib` каталог из нового проекта в корневой директории вашего проекта.
+
+ [5]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/Classes/AppDelegate.m;h=124a56bb4f361e95616f44d6d6f5a96ffa439b60;hp=318f79326176be8f16ebc93bad85dd745f4205b6;hb=a28c7712810a63396e9f32fa4eb94fe3f8b93985;hpb=36acdf55e4cab52802d73764c8a4b5b42cf18ef9
+ [6]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/config.xml;h=1555b5e81de326a07efe0bccaa5f5e2326b07a9a;hp=0652d60f8d35ac13c825c572dca6ed01fea4a540;hb=95f16a6dc252db0299b8e2bb53797995b1e39aa1;hpb=a2de90b8f5f5f68bd9520bcbbb9afa3ac409b96d
+ [7]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/config.xml;h=d307827b7e67301171a913417fb10003d43ce39d;hp=04260aa9786d6d74ab20a07c86d7e8b34e31968c;hb=97b89edfae3527828c0ca6bb2f6d58d9ded95188;hpb=942d33c8e7174a5766029ea1232ba2e0df745c3f
+ [8]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/config.xml;h=8889726d9a8f8c530fe1371c56d858c34552992a;hp=d307827b7e67301171a913417fb10003d43ce39d;hb=57982de638a4dce6ae130a26662591741b065f00;hpb=ec411f18309d577b4debefd9a2f085ba719701d5
+
+## Обновление 2.4.0 проектов для 2.5.0
+
+1. Загрузите и извлеките Cordova 2.5.0 Источник постоянного каталог на вашем жестком диске, например для`~/Documents/Cordova-2.5.0`.
+
+2. Закройте Xcode, если она запущена.
+
+3. С помощью Terminal.app, перейдите в каталог, где вы положили загруженных исходных выше.
+
+4. Создайте новый проект, как описано в iOS утилиты командной строки. Вам нужен активов от этого нового проекта.
+
+5. Копия `www/cordova-2.5.0.js` файл из нового проекта в ваш `www` каталог и удалить ваш `www/cordova-2.4.0.js` файл.
+
+6. Обновите ссылку на сценарий Кордова в ваш `www/index.html` файл (и любые другие файлы, которые содержат ссылку на сценарий) на новый `cordova-2.5.0.js` файл.
+
+7. Обновление (или заменить, если вы никогда не изменил файл) ваш `AppDelegate.m` файл согласно одной из нового проекта (см. [это diff][9]).
+
+8. В вашем `config.xml` файла, [добавить эти новые линии][10].
+
+9. В вашем `config.xml` файла, [изменить корневой элемент, изменить его от Кордова виджет][11].
+
+10. В ваш `config.xml` файл, [Удалить OpenAllWhitelistURLsInWebView предпочтения][12].
+
+11. Удалить ваш `cordova` каталог и копию `cordova` каталог из нового проекта в корневой директории вашего проекта. В 2.5.0 это обновление скриптов.
+
+12. Удалить ваш `CordovaLib` каталог и копию `CordovaLib` каталог из нового проекта в корневой директории вашего проекта.
+
+ [9]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/Classes/AppDelegate.m;h=318f79326176be8f16ebc93bad85dd745f4205b6;hp=6dc7bfc84f0ecede4cc43d2a3256ef7c5383b9fe;hb=4001ae13fcb1fcbe73168327630fbc0ce44703d0;hpb=299a324e8c30065fc4511c1fe59c6515d4842f09
+ [10]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/config.xml;h=903944c4b1e58575295c820e154be2f5f09e6314;hp=721c734120b13004a4a543ee25f4287e541f34be;hb=ae467249b4a256bd31ee89aea7a06f4f2316b8ac;hpb=9e39f7ef8096fb15b38121ab0e245a3a958d9cbb
+ [11]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/config.xml;h=64e71636f5dd79fa0978a97b9ff5aa3860a493f5;hp=d8579352dfb21c14e5748e09b2cf3f4396450163;hb=0e711f8d09377a7ac10ff6be4ec17d22cdbee88d;hpb=57c3c082ed9be41c0588d0d63a1d2bfcd2ed878c
+ [12]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/config.xml;h=721c734120b13004a4a543ee25f4287e541f34be;hp=7d67508b70914aa921a16e79f79c00512502a8b6;hb=187bf21b308551bfb4b98b1a5e11edf04f699791;hpb=03b8854bdf039bcefbe0212db937abd81ac675e4
+
+## Обновление 2.3.0 проекты 2.4.0
+
+1. Загрузите и извлеките Cordova 2.4.0 Источник постоянного каталог на вашем жестком диске, например для`~/Documents/Cordova-2.4.0`.
+
+2. Если оно выполняется, закройте Xcode.
+
+3. С помощью Terminal.app, перейдите в каталог, где вы положили загруженных исходных выше.
+
+4. Создайте новый проект, как описано в iOS утилиты командной строки. Вам нужен активов от этого нового проекта.
+
+5. Копия `www/cordova-2.4.0.js` файл из нового проекта в ваш `www` каталог и удалить ваш `www/cordova-2.3.0.js` файл.
+
+6. Обновите ссылку на сценарий Кордова в ваш `www/index.html` файл (и любые другие файлы, которые содержат ссылку на сценарий) на новый `cordova-2.4.0.js` файл.
+
+7. Обновление (или заменить, если вы никогда не изменяли файлы) ваш `MainViewController.m` файл согласно одной из нового проекта (см. [это diff][13]).
+
+8. Обновление (или заменить, если вы никогда не изменил файл) ваш `AppDelegate.m` файл согласно одной из нового проекта (см. [это diff][14]).
+
+9. В вашем `config.xml` файла, [добавьте эту строку][15].
+
+10. Удалить ваш `cordova` каталог и копию `cordova` каталог из нового проекта в корневой директории вашего проекта. В 2.4.0 это фиксированная сценарии.
+
+11. Удалить ваш `CordovaLib` каталог и копию `CordovaLib` каталог из нового проекта в корневой директории вашего проекта.
+
+12. Добавьте AssetsLibrary.framework как ресурс в проект. (См [Apple в документации][16] для получения инструкций о том, как сделать это.).
+
+ [13]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/Classes/MainViewController.m;h=5f9eeac15c2437cd02a6eb5835b48374e9b94100;hp=89da1082d06ba5e5d0dffc5b2e75a3a06d5c2aa6;hb=b4a2e4ae0445ba7aec788090dce9b822d67edfd8;hpb=a484850f4610e73c7b20cd429a7794ba829ec997
+ [14]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/Classes/AppDelegate.m;h=6dc7bfc84f0ecede4cc43d2a3256ef7c5383b9fe;hp=1ca3dafeb354c4442b7e149da4f281675aa6b740;hb=6749c17640c5fed8a7d3a0b9cca204b89a855baa;hpb=deabeeb6fcb35bac9360b053c8bf902b45e6de4d
+ [15]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/config.xml;h=7d67508b70914aa921a16e79f79c00512502a8b6;hp=337d38da6f40c7432b0bce05aa3281d797eec40a;hb=6749c17640c5fed8a7d3a0b9cca204b89a855baa;hpb=deabeeb6fcb35bac9360b053c8bf902b45e6de4d
+ [16]: https://developer.apple.com/library/ios/#recipes/xcode_help-project_editor/Articles/AddingaLibrarytoaTarget.html
+
+## Проекты модернизации 2.2.0 2.3.0
+
+1. Загрузите и извлеките Cordova 2.3.0 Источник постоянного каталог на вашем жестком диске, например для`~/Documents/Cordova-2.3.0`.
+
+2. Если оно выполняется, закройте Xcode.
+
+3. С помощью Terminal.app, перейдите в каталог, где вы положили загруженных исходных выше.
+
+4. Создайте новый проект, как описано в iOS утилиты командной строки. Вам нужен активов от этого нового проекта.
+
+5. Копия `www/cordova-2.3.0.js` файл из нового проекта в ваш `www` каталог и удалить ваш `www/cordova-2.2.0.js` файл.
+
+6. Обновите ссылку на сценарий Кордова в ваш `www/index.html` файл (и любые другие файлы, которые содержат ссылку на сценарий) на новый `cordova-2.3.0.js` файл.
+
+7. Обновление (или заменить, если вы никогда не изменил файл) ваш `MainViewController.m` согласно одной из нового проекта.
+
+8. Удалить ваш `cordova` каталог и копию `cordova` каталог из нового проекта в корневой директории вашего проекта. В 2.3.0 это имеет новые сценарии.
+
+9. Удалить ваш `CordovaLib` каталог и копию `CordovaLib` каталог из нового проекта в корневой директории вашего проекта.
+
+10. Конвертировать ваш `Cordova.plist` файл `config.xml` , запустив сценарий `bin/cordova\_plist\_to\_config\_xml` на файле проекта.
+
+11. Добавить плагин InAppBrowser для вашего `config.xml` , добавив этот тег под `<cordova><plugins>` :
+
+ < плагин имя = значение «InAppBrowser» = «CDVInAppBrowser» / >
+
+
+12. Обратите внимание, что плагины Objective-C, *не* whitelisted больше. Белый список подключений с приложение whitelist, вам нужно установить `User-Agent` заголовок подключения к же агент пользователя как основной Cordova WebView. Вы можете получить, обратившись к `userAgent` собственности, основной вид-контроллера. Основной вид контроллера ( `CDVViewController` ) также имеет `URLisAllowed` метод для вас, чтобы проверить, прошел ли URL-адрес whitelist.
+
+13. Изменения устройства API:
+
+ * Для iOS, device.platform используется для возвращения `iPhone` , `iPad` или `iPod Touch` ; теперь она возвращает (правильно)`iOS`.
+ * Для iOS, device.name (теперь устарела для всех платформ) используется для возвращения имени пользователя устройства (например ' Shazron's iPhone 5 '); Теперь она возвращается то, что device.platform используется для возвращения: `iPhone` , `iPad` или`iPod Touch`.
+ * Для всех платформ есть новое свойство, называемое device.model; Это возвращает модель конкретного устройства, например `iPad2,5` (для других платформ, это возвращает то, что device.name используется для возвращения).
+
+## Обновление 2.1.0 проекты 2.2.0
+
+1. Загрузите и извлеките Cordova 2.2.0 Источник постоянного каталог на вашем жестком диске, например для`~/Documents/Cordova-2.2.0`.
+
+2. Если оно выполняется, закройте Xcode.
+
+3. С помощью Terminal.app, перейдите в каталог, где вы положили загруженных исходных выше.
+
+4. Создайте новый проект, как описано в iOS утилиты командной строки. Вам нужен активов от этого нового проекта.
+
+5. Копия `www/cordova-2.2.0.js` файл из нового проекта в ваш `www` каталог и удалить ваш `www/cordova-2.1.0.js` файл.
+
+6. Обновите ссылку на сценарий Кордова в ваш `www/index.html` файл (и любые другие файлы, которые содержат ссылку на сценарий) на новый `cordova-2.2.0.js` файл.
+
+7. Обновление (или заменить, если вы никогда не изменил файл) ваш `MainViewController.m` согласно одной из нового проекта:
+
+ * Обновление → viewWillAppear
+
+8. Копия `cordova` каталог из нового проекта в корневой директории вашего проекта. В 2.2.0 это имеет обновленный сценарий «подражать».
+
+9. Далее, обновить ваш `CordovaLib` подпроект ссылку. Начиная с Кордова 2.1.0, мы не используем переменную CORDOVALIB Xcode больше при ссылке где `CordovaLib` проживает, ссылка является ссылкой на абсолютный теперь.
+
+ 1. Запуск Terminal.app
+ 2. Перейдите к папке, где установлен Кордова (см. шаг 1), в `bin` подкаталог
+ 3. Запустите сценарий ниже, где первый параметр — путь к вашему проекту `.xcodeproj` файл:
+
+ `update_cordova_subproject path/to/your/project/xcodeproj`
+
+**Примечание**: В 2.2.0, `bin/create` сценарий копия в `CordovaLib` подпроект в ваш проект. Чтобы иметь тот же тип установки, просто скопируйте в правом `CordovaLib` в каталоге проекта и обновление `CordovaLib` югу расположение (относительно проекта) в Xcode инспектора файлов проекта.
+
+## Проекты модернизации 2.0.0 до 2.1.0
+
+С Кордова 2.1.0 `CordovaLib` был обновлен для использования **Автоматического подсчета ссылок (ARC)**. Вам не нужно для обновления до **дуги** для использования CordovaLib, но если вы хотите обновить проект для использования **дуги**, пожалуйста используйте мастер миграции Xcode из меню: **Правка → переделать → преобразовать в Objective-C ARC...**, снимите флажок libCordova.a, а затем запустить мастер для завершения.
+
+1. Загрузите и извлеките Cordova 2.1.0 Источник постоянного каталог на вашем жестком диске, например для`~/Documents/Cordova-2.1.0`.
+
+2. Если оно выполняется, закройте Xcode.
+
+3. С помощью Terminal.app, перейдите в каталог, где вы положили загруженных исходных выше.
+
+4. Создайте новый проект, как описано в iOS утилиты командной строки. Вам нужен активов от этого нового проекта.
+
+5. Копия `www/cordova-2.1.0.js` файл из нового проекта в ваш `www` каталог и удалить ваш `www/cordova-2.0.0.js` файл.
+
+6. Обновите ссылку на сценарий Кордова в ваш `www/index.html` файл (и любые другие файлы, которые содержат ссылку на сценарий) на новый `cordova-2.1.0.js` файл.
+
+7. Обновление (или заменить, если вы никогда не изменил файл) ваш `AppDelegate.m` согласно одной из нового проекта:
+
+ * Редактировать → применения: didFinishLaunchingWithOptions:
+ * Добавлено → применения: supportedInterfaceOrientationsForWindow:
+
+8. Обновление (или заменить, если вы никогда не изменил файл) ваш `MainViewController.m` согласно одной из нового проекта:
+
+ * Добавлено → viewWillAppear
+
+9. Копия `cordova` каталог из нового проекта в корневой директории вашего проекта. В 2.1.0 это имеет обновленные скрипты для поддержки пути с пробелами.
+
+10. Удалить `VERSION` файла ссылку из вашего проекта (*не* один в`CordovaLib`).
+
+11. Далее, обновить ваш `CordovaLib` подпроект ссылку. Начиная с Кордова 2.1.0, мы не используем переменную CORDOVALIB Xcode больше при ссылке где `CordovaLib` проживает, ссылка является ссылкой на абсолютный теперь.
+
+ 1. Запуск Terminal.app
+ 2. Перейдите к папке, где установлен Кордова (см. шаг 1), в `bin` подкаталог
+ 3. Запустите сценарий ниже, где первый параметр — путь к вашему проекту `.xcodeproj` файл:
+
+ `update_cordova_subproject путь/к/your/проекта/xcodeproj`
+
+## Проекты модернизации 1.9.0 2.0.0
+
+1. Установите Cordova 2.0.0.
+
+2. Создайте новый проект, как описано в iOS утилиты командной строки. Вам нужен активов от этого нового проекта.
+
+3. Копия `www/cordova-2.0.0.js` файл из нового проекта в ваш `www` каталог и удалить ваш `www/cordova-1.9.0.js` файл.
+
+4. Обновите ссылку на сценарий Кордова в ваш `www/index.html` файл (и любые другие файлы, которые содержат ссылку на сценарий) на новый `cordova-2.0.0.js` файл.
+
+5. Копия `cordova` каталог из нового проекта в корневой каталог вашего проекта (если вы хотите проект средства командной строки).
+
+6. Добавьте новую запись под `Plugins` в ваш `Cordova.plist` файл, в группе **Поддержки файлов** . Ключ `Device` и значение`CDVDevice`.
+
+7. Удалить`Cordova.framework`.
+
+8. Удалить `verify.sh` из группы **Поддержки файлов** .
+
+9. Выберите значок проекта в диспетчере структуры проекта, выберите **целевой**проект, а затем выберите вкладку **Параметры построения** .
+
+10. Поиск для **Макросов препроцессора**, затем удалите всю **CORDOVA_FRAMEWORK = 1** значения.
+
+11. Найдите `CordovaLib` каталог, который был установлен на вашем жестком диске в вашей домашней папке `Documents` подкаталога.
+
+12. Найдите `CordovaLib.xcodeproj` файл `CordovaLib` каталог, а затем перетащить файл в ваш проект. Он должен отображаться как подпроекта.
+
+13. Создайте свой проект, вы должны получить некоторые ошибки, связанные с `#import` директивы.
+
+14. Для `#import` ошибки, изменить любую цитату на основе импорта в этом стиле:
+
+ #import "CDV.h"
+
+
+ в этот стиль, основанный на скобки:
+
+ #import <Cordova/CDV.h>
+
+
+ и удалите `#ifdef` оболочек вокруг любой Cordova импорта, они больше не нужны (импорт теперь едины)
+
+15. Снова создайте свой проект, и он не должен иметь какие-либо `#import` ошибки.
+
+16. Выберите **значок проекта** в диспетчере структуры проекта, выберите **целевой**проект, а затем выберите вкладку **Построение этапов** .
+
+17. Разверните этапа **Целевого объекта зависимостей** , а затем выберите **+** кнопку.
+
+18. Выберите `CordovaLib` цели, а затем выберите кнопку **Добавить** .
+
+19. Разверните первый этап **Двоичные связь с библиотеками** (он уже должен содержать кучу рамок), а затем выберите **+** кнопку.
+
+20. Выберите `libCordova.a` статическую библиотеку, а затем выберите кнопку **Добавить** .
+
+21. Удаление фазы **Запуска скрипта** .
+
+22. Выберите **значок проекта** в диспетчере структуры проекта, выберите **целевой**проект, а затем выберите вкладку **Параметры построения** .
+
+23. Искать **Другие флаги компоновщика**и добавьте значения **-force_load** **- Obj -** c.
+
+24. Разверните `CordovaLib` подпроекта.
+
+25. Найти `VERSION` файл, перетащите его в ваш основной проект (мы хотим создать ссылку на него, не копия).
+
+26. Выберите переключатель **создать группы для любой дополнительной папки** , а затем выберите кнопку **Готово** .
+
+27. Выберите `VERSION` файл, который вы только что вытащили на предыдущем шаге.
+
+28. Введите сочетание клавиш **Option-Command-1** , чтобы показать **Файл инспектора** (или menuitem **посмотреть → общих назначений → показать файл инспектор**).
+
+29. Выбрать **по отношению к CORDOVALIB** в **Файл инспектора** для раскрывающегося меню для **местоположения**.
+
+30. Xcode предпочтения **предпочтения Xcode → места → данные → передовые...** можно присвоить **уникальный**, так что единого заголовки можно найти.
+
+31. Выберите **значок проекта** в диспетчере структуры проекта, выберите ваши **цели**, а затем выберите вкладку **Параметры построения** .
+
+32. Поиск **путей поиска заголовка**. Для этого параметра, добавьте эти три значения, включая котировки:
+
+ "$(TARGET_BUILD_DIR)/usr/local/lib/include"
+
+ "$(OBJROOT)/UninstalledProducts/include"
+
+ "$(BUILT_PRODUCTS_DIR)"
+
+
+33. Поиск **другие флаги компоновщика**. Для этого параметра, добавьте это значение:
+
+ -weak_framework CoreFoundation
+
+
+34. Создайте свой проект, следует скомпилировать и связать **без** вопросов.
+
+35. Выберите проект в раскрывающемся списке **схемы** , а затем выберите **iPhone 5.1 симулятор**.
+
+36. Выберите кнопку **Run** .
+
+**Примечание**: Если ваш проект не работает как ожидалось в симуляторе, пожалуйста принять к сведению любые ошибки в журнале консоли в Xcode для подсказки.
+
+## Обновление проектов 1.8.x до 1.9.0
+
+1. Установите Cordova 1.9.0.
+
+2. Создайте новый проект. Вам понадобится некоторые из активов от этого нового проекта.
+
+3. Копия `www/cordova-1.9.0.js` файл из нового проекта в ваш `www` каталог и удалить ваш `www/cordova-1.8.x.js` файл.
+
+4. Обновите ссылку на сценарий Кордова в ваш `www/index.html` файл (и любые другие файлы, которые содержат ссылку на сценарий) на новый `cordova-1.9.0.js` файл.
+
+**Примечание**: 1.9.0 поддерживает новый `BackupWebStorage` логическое `Cordova.plist` параметр. Она включена по умолчанию, поэтому установите его в `false` отключить ее, особенно на iOS 6. Смотреть [заметки о выпуске: сафари и UIKit секции][17]
+
+ [17]: https://developer.apple.com/library/prerelease/ios/#releasenotes/General/RN-iOSSDK-6_0/_index.html
+
+## Проекты модернизации 1.7.0 1.8.x
+
+1. Установите Cordova 1.8.0.
+
+2. Создайте новый проект. Вам понадобится некоторые из активов от этого нового проекта.
+
+3. Копия `www/cordova-1.8.0.js` файл из нового проекта в ваш `www` каталог и удалить ваш `www/cordova-1.7.x.js` файл.
+
+4. Обновите ссылку на сценарий Кордова в ваш `www/index.html` файл (и любые другие файлы, которые содержат ссылку на сценарий) на новый `cordova-1.8.0.js` файл.
+
+Если вы собираетесь использовать API захвата, вам понадобится новый **iPad retina дисплей** активов:
+
+1. Копия `Resources/Capture.bundle` элемент из нового проекта в каталог проекта, помарок существующих `Resources/Capture.bundle` пункта.
+
+2. В вашем проекте, выберите `Capture.bundle` элемент в навигаторе проекта в Xcode, введите клавишу **Delete** , а затем выберите **Удалить ссылку** из появившемся диалоговом.
+
+3. Перетащите новый `Capture.bundle` от шаг 1 выше в навигаторе проекта в Xcode, затем выберите **создать группы для любых папок, добавлен** переключатель.
+
+## Обновление проектов 1.6.x на 1.7.0
+
+1. Установите Cordova 1.7.0.
+
+2. Создайте новый проект. Вам понадобится некоторые из активов от этого нового проекта.
+
+3. Копия `www/cordova-1.7.0.js` файл из нового проекта в ваш `www` каталог и удалить ваш `www/cordova-1.6.0.js` файл.
+
+4. Обновите ссылку на сценарий Кордова в ваш `www/index.html` файл (и любые другие файлы, которые содержат ссылку на сценарий) на новый `cordova-1.7.0.js` файл.
+
+## Обновление 1.5.0 проектов к 1.6.x
+
+1. Установите Cordova 1.6.1.
+
+2. Сделайте резервную копию `AppDelegate.m` , `AppDelegate.h` , `MainViewController.m` , `MainViewController.h` , и `Cordova.plist` в вашем проекте.
+
+3. Создайте новый проект. Вам понадобится некоторые из активов от этого нового проекта.
+
+4. Скопируйте эти файлы из нового проекта в папке проекта 1.5.0-based на диске, заменив старые файлы (резервное копирование файлов сначала из шага 2 выше):
+
+ AppDelegate.h
+ AppDelegate.m
+ MainViewController.h
+ MainViewController.m
+ Cordova.plist
+
+
+5. Добавить все новые `MainViewController` и `AppDelegate` файлы в ваш проект Xcode.
+
+6. Копия `www/cordova-1.6.1.js` файл из нового проекта в ваш `www` каталог и удалить ваш `www/cordova-1.5.0.js` файл.
+
+7. Обновите ссылку на сценарий Кордова в ваш `www/index.html` файл (и любые другие файлы, которые содержат ссылку на сценарий) на новый `cordova-1.6.1.js` файл.
+
+8. Добавить новый `Cordova.plist` файл в ваш проект. Это необходимо потому, что основной плагин имена должны меняться, чтобы соответствовать те от Android и BlackBerry, для единой (файл JavaScript Кордова`cordova-js`).
+
+9. Интегрировать любые настройки, **плагины** и **ExternalHosts** записи, которые вы имели в вашей **резервной Cordova.plist** в новый`Cordova.plist`.
+
+10. Интегрировать любой код конкретного проекта, у вас есть в вашей резервной копии `AppDelegate.h` и `AppDelegate.m` в новом `AppDelegate` файлов. Любой `UIWebViewDelegate` или `CDVCommandDelegate` код в `AppDelegate.m` нужно идти в `MainViewController.m` сейчас (см. разделы комментарии в этом файле).
+
+11. Интегрировать любой код конкретного проекта, у вас есть в вашей резервной копии `MainViewController.h` и `MainViewController.m` в новой MainViewController файлы.
+
+12. Нажмите на значок проекта в диспетчере структуры проекта, выберите **проект**, а затем выберите вкладку **Параметры построения** .
+
+13. Введите **компилятор для C / C + +/ Objective-C** в поле поиска.
+
+14. Выберите значение **3.1 компилятора LLVM Apple** .
+
+## Обновление проектов 1.4.x для 1.5.0
+
+1. Установите Cordova 1.5.0.
+
+2. Создайте новый проект и запустите его один раз. Вам понадобится некоторые из активов от этого нового проекта.
+
+3. Копия `www/cordova-1.5.0.js` файл из нового проекта в ваш `www` каталог и удалить ваш `www/phonegap-1.4.x.js` файл.
+
+4. Обновить ссылку скрипт Кордова в ваш `www/index.html` файл (и любые другие файлы, которые содержат ссылку на сценарий) чтобы указать новый Кордова `cordova-1.5.0.js` файла.
+
+5. Найти `PhoneGap.framework` в вашем навигаторе проекта, выберите его.
+
+6. Введите ключ **Удалить** и удалить `PhoneGap.framework` ссылка в диспетчере структуры проекта.
+
+7. Введите сочетание клавиш **Option-Command-A** , который следует падение вниз лист для добавления файлов в проект (лист **Добавить файлы...** ). Убедитесь, что выбран переключатель **группы создана для любых папок, добавил** .
+
+8. Введите сочетание клавиш **Command-Shift-G** , который следует падение вниз другой лист для вас, чтобы перейти к папке ( **перейдите в папку:** лист).
+
+9. Введите `/Users/Shared/Cordova/Frameworks/Cordova.framework` в **перейдите в папку:** лист, а затем нажмите кнопку **Go** .
+
+10. Нажмите на кнопку **Добавить** в окне **Добавить файлы...** .
+
+11. Выберите `Cordova.framework` в диспетчере структуры проекта.
+
+12. Введите сочетание клавиш **Option-Command-1** , чтобы показать **Файл инспектор**.
+
+13. Выберите **Абсолютный путь** в **Инспектора файлов** для раскрывающегося меню для **местоположения**.
+
+14. Введите сочетание клавиш **Option-Command-A** , который следует падение вниз лист для добавления файлов в проект (лист **Добавить файлы...** ). Убедитесь, что выбран переключатель **группы создана для любых папок, добавил** .
+
+15. Введите сочетание клавиш **Command-Shift-G** , который следует падение вниз другой лист для вас, чтобы перейти к папке ( **перейдите в папку:** лист).
+
+16. Введите `~/Documents/CordovaLib/Classes/deprecated` в **перейдите в папку:** лист, а затем нажмите кнопку **Go** .
+
+17. Нажмите на кнопку **Добавить** в окне **Добавить файлы...** .
+
+18. В вашем `AppDelegate.h` , `AppDelegate.m` , и `MainViewController.h` файлы, заменить весь `#ifdef PHONEGAP_FRAMEWORK` блок с:
+
+ #import «CDVDeprecated.h»
+
+
+19. Нажмите на **значок проекта** в диспетчере структуры проекта, выберите ваши **цели**, а затем выберите вкладку **Параметры построения** .
+
+20. Поиск **путей поиска рамки**.
+
+21. Замените существующее значение с`/Users/Shared/Cordova/Frameworks`.
+
+22. Поиск для **макросов препроцессора**.
+
+23. Для первого (комбинированные) значения, замените значение с **CORDOVA_FRAMEWORK = YES**.
+
+24. Выберите вкладку **Build фазы** .
+
+25. Разверните узел **запустить сценарий**.
+
+26. Замените все вхождения **PhoneGap** с **Кордова**.
+
+27. Найти ваш `PhoneGap.plist` файл в диспетчере структуры проекта и щелкните на имени файла, после того, как войти в режим редактирования имени.
+
+28. Переименуйте `PhoneGap.plist` в`Cordova.plist`.
+
+29. Щелкните правой кнопкой мыши `Cordova.plist` и выберите команду **Открыть как → исходный код**.
+
+30. Нажмите **Option-Command-F**, выберите **заменить** из раскрывающегося списка в верхней левой части окна исходного кода.
+
+31. Введите `com.phonegap` для поиска строки, и `org.apache.cordova` для замены строки, затем нажмите кнопку **Заменить все** .
+
+32. Введите **PG** для строки поиска и **CDV** для замены строки, а затем нажмите кнопку **Заменить все** .
+
+33. Нажмите **Command-B** , чтобы построить. Вы до сих пор затраченной, которые вы можете избавиться в будущем (см. `CDVDeprecated.h` . К примеру, заменить классы в коде, использующие PG * CDV *).
+
+## Проекты модернизации 1.4.0 1.4.1
+
+1. Установите Cordova 1.4.1.
+
+2. Сделайте резервную копию`MainViewController.m`.
+
+3. Создайте новый проект. Вам нужно некоторые из активов от этого нового проекта.
+
+4. Копия `MainViewController.m` файл из нового проекта в папке проекта 1.4.0-based на диске, заменив старый файл (резервного копирования ваших файлов от шаг 2 выше).
+
+5. Добавить `MainViewController.m` файл в ваш проект Xcode.
+
+6. Интегрировать любой код конкретного проекта, у вас есть в вашем резервные `MainViewController.m` в новый файл.
+
+7. Обновление `phonegap-1.4.0.js` файл не является обязательным, в JavaScript между 1.4.0 и 1.4.1 ничего не изменилось.
+
+## Обновление 1.3.0 проектов до 1.4.0
+
+1. Установите Cordova 1.4.0.
+
+2. Сделайте резервную копию `AppDelegate.m` и `AppDelegate.h` в вашем проекте.
+
+3. Создайте новый проект. Вам нужно некоторые из активов от этого нового проекта.
+
+4. Скопируйте эти файлы из нового проекта в папке проекта 1.3.0-based на диске, заменив старые файлы (резервное копирование файлов сначала из шага 2 выше):
+
+ AppDelegate.h
+ AppDelegate.m
+ MainViewController.h
+ MainViewController.m
+ MainViewController.xib
+
+
+5. Добавить все `MainViewController` файлы в ваш проект Xcode.
+
+6. Копия `www/phonegap-1.4.0.js` файл из нового проекта в ваш `www` каталог и удалить ваш `www/phonegap-1.3.0.js` файл.
+
+7. Обновите ссылку на сценарий Кордова в ваш `www/index.html` файл (и любые другие файлы, которые содержат ссылку на сценарий) на новый `phonegap-1.4.0.js` файл.
+
+8. Добавьте новую запись под `Plugins` в ваш `PhoneGap.plist` файл. Ключ `com.phonegap.battery` и значение`PGBattery`.
+
+9. Интегрировать любой код конкретного проекта, у вас есть в вашем резервные `AppDelegate.h` и `AppDelegate.m` в новые файлы AppDelegate.
+
+## Обновление 1.2.0 проекты 1.3.0
+
+1. Установите Cordova 1.3.0.
+
+2. Сделайте резервную копию `AppDelegate.m` и `AppDelegate.h` в вашем проекте.
+
+3. Создайте новый проект. Вам понадобится некоторые из активов от этого нового проекта.
+
+4. Скопируйте эти файлы из нового проекта в папке проекта 1.2.0-based на диске, заменив старые файлы (резервное копирование файлов сначала из шага 2 выше):
+
+ AppDelegate.h
+ AppDelegate.m
+ MainViewController.h
+ MainViewController.m
+ MainViewController.xib
+
+
+5. Добавить все `MainViewController` файлы в ваш проект Xcode.
+
+6. Копия `www/phonegap-1.3.0.js` файл из нового проекта в ваш `www` каталог и удалить ваш `www/phonegap-1.2.0.js` файл.
+
+7. Обновите ссылку на сценарий Кордова в ваш `www/index.html` файл (и любые другие файлы, которые содержат ссылку на сценарий) на новый `phonegap-1.3.0.js` файл.
+
+8. Добавьте новую запись под `Plugins` в ваш `PhoneGap.plist` файл. Ключ `com.phonegap.battery` и значение`PGBattery`.
+
+9. Интегрировать любой код конкретного проекта, у вас есть в вашей резервной копии `AppDelegate.h` и `AppDelegate.m` в новой AppDelegate файлы.
+
+## Обновление 1.1.0 проектов до 1.2.0
+
+1. Установите Cordova 1.2.0.
+
+2. Сделайте резервную копию `AppDelegate.m` и `AppDelegate.h` в вашем проекте.
+
+3. Создайте новый проект. Вам понадобится некоторые из активов от этого нового проекта.
+
+4. Скопируйте эти файлы из нового проекта в папке проекта 1.1.0-based на диске, заменив старые файлы (резервное копирование файлов сначала из шага 2 выше):
+
+ AppDelegate.h
+ AppDelegate.m
+ MainViewController.h
+ MainViewController.m
+ MainViewController.xib
+
+
+5. Добавить все `MainViewController` файлы в ваш проект Xcode.
+
+6. Копия `www/phonegap-1.2.0.js` файл из нового проекта в ваш `www` каталог и удалить ваш `www/phonegap-1.1.0.js` файл.
+
+7. Обновите ссылку на сценарий Кордова в ваш `www/index.html` файл (и любые другие файлы, которые содержат ссылку на сценарий) на новый `phonegap-1.2.0.js` файл.
+
+8. Добавьте новую запись под `Plugins` в ваш `PhoneGap.plist` файл. Ключ `com.phonegap.battery` и значение`PGBattery`.
+
+9. Интегрировать любой код конкретного проекта, у вас есть в вашей резервной копии `AppDelegate.h` и `AppDelegate.m` в новой AppDelegate файлы.
+
+## Проекты модернизации 1.0.0 1.1.0
+
+1. Установите Cordova 1.1.0.
+
+2. Сделайте резервную копию `AppDelegate.m` и `AppDelegate.h` в вашем проекте.
+
+3. Создайте новый проект. Вам понадобится некоторые из активов от этого нового проекта.
+
+4. Скопируйте эти файлы из нового проекта в папке проекта 1.0.0-based на диске, заменив старые файлы (резервное копирование файлов сначала из шага 2 выше):
+
+ AppDelegate.h
+ AppDelegate.m
+ MainViewController.h
+ MainViewController.m
+ MainViewController.xib
+
+
+5. Добавить все `MainViewController` файлы в ваш проект Xcode.
+
+6. Копия `www/phonegap-1.1.0.js` файл из нового проекта в ваш `www` каталог и удалить ваш `www/phonegap-1.0.0.js` файл.
+
+7. Обновите ссылку на сценарий Кордова в ваш `www/index.html` файл (и любые другие файлы, которые содержат ссылку на сценарий) на новый `phonegap-1.1.0.js` файл.
+
+8. Добавьте новую запись под `Plugins` в ваш `PhoneGap.plist` файл. Ключ `com.phonegap.battery` и значение`PGBattery`.
+
+9. Интегрировать любой код конкретного проекта, у вас есть в вашей резервной копии `AppDelegate.h` и `AppDelegate.m` в новой AppDelegate файлы.
+
+## Проекты модернизации 0.9.6 для 1.0.0
+
+1. Установите Cordova 1.0.0.
+
+2. Сделайте резервную копию `AppDelegate.m` и `AppDelegate.h` в вашем проекте.
+
+3. Создайте новый проект. Вам понадобится некоторые из активов от этого нового проекта.
+
+4. Скопируйте эти файлы из нового проекта в папке проекта 0.9.6-based на диске, заменив старые файлы (резервное копирование файлов сначала из шага 2 выше):
+
+ AppDelegate.h
+ AppDelegate.m
+ MainViewController.h
+ MainViewController.m
+ MainViewController.xib
+
+
+5. Добавить все `MainViewController` файлы в ваш проект Xcode.
+
+6. Копия `www/phonegap-1.0.0.js` файл из нового проекта в ваш `www` каталог и удалить ваш `www/phonegap-0.9.6.js` файл.
+
+7. Обновите ссылку на сценарий Кордова в ваш `www/index.html` файл (и любые другие файлы, которые содержат ссылку на сценарий) на новый `phonegap-1.0.0.js` файл.
+
+8. Добавьте новую запись под `Plugins` в ваш `PhoneGap.plist` файл. Ключ `com.phonegap.battery` и значение`PGBattery`.
+
+9. Интегрировать любой код конкретного проекта, у вас есть в вашей резервной копии `AppDelegate.h` и `AppDelegate.m` в новой AppDelegate файлы.
\ No newline at end of file
diff --git a/docs/ru/5.0.0/guide/platforms/ios/webview.md b/docs/ru/5.0.0/guide/platforms/ios/webview.md
new file mode 100644
index 0000000..4146b8d
--- /dev/null
+++ b/docs/ru/5.0.0/guide/platforms/ios/webview.md
@@ -0,0 +1,149 @@
+---
+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.
+---
+
+# WebViews в iOS
+
+В этом руководстве показано, как внедрить компонент WebView Cordova поддержкой в рамках более крупных приложений iOS. Дополнительные сведения о том, как эти компоненты могут взаимодействовать друг с другом смотрите приложение плагины.
+
+Поддержка iOS WebViews начал с Кордова версии 1.4, с помощью `Cleaver` компонент, для которого шаблон Xcode выступает в качестве эталонной реализации. Кордова 2.0 и более поздних версий поддерживают только реализация на основе подпроекта Кливер.
+
+Эти инструкции требуют по крайней мере Cordova 3.x и Xcode 6.0, совместно с файлом `config.xml` из только что созданного проекта iOS. Процедура в интерфейс командной строки можно использовать для создания нового проекта, а затем получить `config.xml` файл в подкаталоге именованного приложения в`platforms/ios`.
+
+Следовать этим инструкциям, убедитесь, что у вас есть дистрибутив последней Кордова. Скачать его с [cordova.apache.org][1] и разархивируйте его пакет iOS.
+
+ [1]: http://cordova.apache.org
+
+## Добавление Cleaver в Xcode проект (подпроект CordovaLib)
+
+1. Если оно выполняется, закройте Xcode.
+
+2. Откройте терминал и перейдите в исходный каталог для iOS Кордова.
+
+3. Копия `config.xml` файла, описанного выше в каталог проекта.
+
+4. Откройте Xcode и использовать Finder для копирования `config.xml` файл в окно своей **Структуры проекта** .
+
+5. Выберите **создать группы для любой дополнительной папки** и нажмите кнопку **Готово**.
+
+6. Используйте Finder для копирования `CordovaLib/CordovaLib.xcodeproj` файл в Xcode в **Диспетчере структуры проекта**
+
+7. Выберите `CordovaLib.xcodeproj` в рамках **проекта навигатор**.
+
+8. Введите сочетание клавиш **Option-Command-1** , чтобы показать **Файл инспектор**.
+
+9. Выберите **относительный группу** в **Инспектора файлов** в раскрывающемся меню для **местоположения**.
+
+10. Выберите **значок проекта** в **Диспетчере структуры проекта**, выберите **Цель**, а затем выберите вкладку **Параметры построения** .
+
+11. Добавить `-force_load` и `-Obj-C` для значения **Другие флаги компоновщика** .
+
+12. Нажмите на **значок проекта** в диспетчере структуры проекта, выберите **Цель**, а затем выберите вкладку **Построение этапов** .
+
+13. Расширять **связь двоичные файлы с библиотеками**.
+
+14. Выберите **+** кнопку и добавьте следующие **рамки**. При необходимости в **Диспетчере структуры проекта**, переместите их в группе **рамки** :
+
+ AssetsLibrary.framework
+ CoreLocation.framework
+ CoreGraphics.framework
+ MobileCoreServices.framework
+
+
+15. Разверните узел **Целевого объекта зависимостей**, приставки с этим ярлыком, если существует более одного окна.
+
+16. Выберите **+** кнопку и добавить `CordovaLib` создания продукта.
+
+17. Разверните **Двоичные файлы связь с библиотеками**, приставки с этим ярлыком, если существует более одного окна.
+
+18. Выберите **+** кнопку и добавить`libCordova.a`.
+
+19. Задать **Xcode предпочтения → места → полученных данных → передовые...** **уникальным**.
+
+20. Выберите **значок проекта** в диспетчере структуры проекта, выберите ваши **цели**, а затем выберите вкладку **Параметры построения** .
+
+21. Поиск **путей поиска заголовка**. Для этого параметра, добавьте эти три значения ниже, включая котировки:
+
+ "$(TARGET_BUILD_DIR)/usr/local/lib/include"
+ "$(OBJROOT)/UninstalledProducts/include"
+ "$(BUILT_PRODUCTS_DIR)"
+
+
+ По состоянию на Cordova 2.1.0 `CordovaLib` был обновлен для использования **Автоматического подсчета ссылок (ARC)**. Вам не нужно обновить до **дуги** для использования `CordovaLib` , но если вы хотите обновить проект для использования **дуги**, следует использовать мастер миграции Xcode от **Правка → переделать → преобразовать в Objective-C ARC...** меню, **снимите флажок libCordova.a**, затем запустите мастер до завершения.
+
+## С помощью CDVViewController
+
+1. Добавьте следующий заголовок:
+
+ #import <Cordova/CDVViewController.h>
+
+
+2. Создайте экземпляр нового `CDVViewController` и сохраните его где-нибудь, например, для свойства класса:
+
+ CDVViewController* viewController = [CDVViewController new];
+
+
+3. При необходимости задайте `wwwFolderName` свойства, которое по умолчанию равно `www` :
+
+ viewController.wwwFolderName = @"myfolder";
+
+
+4. При необходимости задайте начальную страницу `config.xml` файла `<content>` тег, либо локальный файл:
+
+ <content src="index.html" />
+
+
+ .. или удаленный веб-узел:
+
+ <content src="http://apache.org" />
+
+
+5. При необходимости задайте `useSplashScreen` свойства, которое по умолчанию равно `NO` :
+
+ viewController.useSplashScreen = YES;
+
+
+6. Задайте **кадр представления**. Всегда установите это как Последнее свойство:
+
+ viewController.view.frame = CGRectMake(0, 0, 320, 480);
+
+
+7. Добавьте в представление Кливер:
+
+ [myView addSubview:viewController.view];
+
+
+## Добавление HTML, CSS и JavaScript активы
+
+1. Создайте новый каталог в рамках проекта, `www` например.
+
+2. Поместите HTML, CSS и JavaScript активов в этот каталог.
+
+3. Чтобы скопировать каталог в окне **Навигатора проекта** Xcode используйте Finder.
+
+4. Выберите пункт **создать папку ссылки для любых папок, добавлен**.
+
+5. Установите соответствующие `wwwFolderName` и `startPage` свойства для каталога, вы первоначально создали, или использовать значения по умолчанию (указанный в предыдущем разделе) при создании экземпляра`CDVViewController`.
+
+ /*
+ if you created a folder called 'myfolder' and
+ you want the file 'mypage.html' in it to be
+ the startPage
+ */
+ viewController.wwwFolderName = @"myfolder";
+ viewController.startPage = @"mypage.html"
\ No newline at end of file
diff --git a/docs/ru/5.0.0/guide/platforms/tizen/index.md b/docs/ru/5.0.0/guide/platforms/tizen/index.md
new file mode 100644
index 0000000..c60b451
--- /dev/null
+++ b/docs/ru/5.0.0/guide/platforms/tizen/index.md
@@ -0,0 +1,115 @@
+---
+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.
+---
+
+# Руководство для платформы Tizen
+
+В этом руководстве описывается, как настроить среду разработки SDK для развертывания приложений Cordova для устройств под управлением операционной системы Tizen.
+
+## Требования и поддержка
+
+Tizen SDK требует Linux Ubuntu 10.04/10.10/11.04/11.10 (32-бит) или Windows XP SP3/7 (32-бит).
+
+Разработчики должны использовать `cordova` утилита в сочетании с Tizen SDK. Увидеть интерфейс командной строки для получения информации, как установить его, добавить проекты, а затем построить и развернуть проект.
+
+## Установите SDK
+
+Скачать Tizen SDK от [tizen.org][1].
+
+ [1]: https://developer.tizen.org/sdk
+
+<!--
+
+- (optional) Install Tizen Cordova template projects: copy the
+ `/templates` directory content into the Tizen Eclipse IDE web
+ templates directory (e.g.:
+ `/home/my_username/tizen-sdk/IDE/Templates/web`).
+
+- __Method #2: Use Tizen Eclipse IDE Cordova Tizen project templates__
+ - Launch Tizen Eclipse IDE
+ - Select __File → New → Tizen Web Project__
+ - Select __User Template__ and __User defined__ items
+ - Select one of the Tizen Cordova template (e.g.: __CordovaBasicTemplate__)
+ - Fill the __Project name__ and its target __Location__
+
+ 
+
+ - Click __Finish__
+
+ 
+
+ - Your project should now appear in the __Project Explorer__ view
+
+-->
+
+## Откройте проект в SDK
+
+1. Запуск Tizen Eclipse IDE.
+
+2. Выберите **файл → импорт → Tizen веб-проекта**:
+
+ ![][2]
+
+3. Нажмите **Далее**.
+
+4. Убедитесь, что **выберите корневой каталог** установлен.
+
+5. Убедитесь, что установлен **копирования проектов в рабочую область** .
+
+6. Нажмите **Обзор** и выберите Cordova Tizen `samples` каталог проекта (такие как `/cordova-basic` ):
+
+ ![][3]
+
+7. Нажмите кнопку **Готово**. Теперь ваш проект должен быть импортированы и появляются в представлении **Обозреватель проектов** :
+
+ ![][4]
+
+ [2]: img/guide/platforms/tizen/import_project.png
+ [3]: img/guide/platforms/tizen/import_widget.png
+ [4]: img/guide/platforms/tizen/project_explorer.png
+
+Чтобы перестроить проект, щелкните правой кнопкой мыши в представлении **Обозреватель проектов** и выберите **Построить проект**:
+
+![][5]
+
+ [5]: img/guide/platforms/tizen/build_project.png
+
+В корневом каталоге проекта должен создать файл пакета виджета, например *hello.wgt* .
+
+## Развертывание на эмулятор
+
+Щелкните правой кнопкой мыши проект в представлении **Project Explorer** и выберите **Запуск как → Tizen симулятор веб-приложения**:
+
+![][6]
+
+ [6]: img/guide/platforms/tizen/runas_web_sim_app.png
+
+## Развертывание на устройство
+
+* Убедитесь, что целевое устройство должным образом начали, подключено и настроено. Необходимо правильно задать его параметры **даты и времени** .
+
+* Выберите цель развертывания приложения с помощью **Connection Explorer** представления: **окна → Показать вид → Connection Explorer**.
+
+ ![][7]
+
+* Щелкните правой кнопкой мыши проект в представлении **Обозреватель проектов** , а затем выберите **запустить → Tizen веб-приложения**:
+
+ ![][8]
+
+ [7]: img/guide/platforms/tizen/connection_explorer.png
+ [8]: img/guide/platforms/tizen/runas_web_app.png
\ No newline at end of file
diff --git a/docs/ru/5.0.0/guide/platforms/ubuntu/index.md b/docs/ru/5.0.0/guide/platforms/ubuntu/index.md
new file mode 100644
index 0000000..ade236a
--- /dev/null
+++ b/docs/ru/5.0.0/guide/platforms/ubuntu/index.md
@@ -0,0 +1,94 @@
+---
+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.
+---
+
+# Руководство для платформы Ubuntu
+
+## Первоначальный релиз
+
+Добро пожаловать на первоначального выпуска Ubuntu платформы поддержки в Кордове. С этого выпуска основное внимание развивается на системе Ubuntu и использование рабочего процесса кросс платформенный, говорится в обзоре. Это включает в себя добавление платформы Ubuntu для вашего проекта, добавив стандартные плагины Cordova и построение и запуск приложения для платформы Ubuntu.
+
+### Ubuntu SDK
+
+Вы также можете установить среду разработки Ubuntu QtCreator. Смотрите [developer.ubuntu.com][1] для получения дополнительной информации. (QtCreator SDK не требуется для добавления поддержки платформы Ubuntu в приложение Cordova).
+
+ [1]: http://developer.ubuntu.com
+
+### Ubuntu среды выполнения платформы
+
+Ubuntu является хорошо известна своей среды рабочего стола (для ноутбуков, ПК и т.п.). Ubuntu Touch расширяет ОС Ubuntu на телефоны и планшеты. Ubuntu среды выполнения платформы имеют различных Процессорных архитектур (x 86, armhf, и т.д.). Приложения и плагин код должен быть скомпилирован соответствующим образом. Поддержка этой широкой области стремительно развивается в Ubuntu.
+
+### Последняя информация
+
+Для получения последней информации о поддержке приложение Cordova для платформ среды выполнения Ubuntu см [wiki.ubuntu.com/Cordova][2].
+
+ [2]: http://wiki.ubuntu.com/Cordova
+
+## Требования к платформе разработки
+
+Для этого первоначального выпуска платформы разработки должна быть Ubuntu Desktop. Ubuntu 13.10 (кодовое имя 'дерзкий') или более поздней версии требуется для полного набора поддерживаемых возможностей.
+
+Вы можете установить Кордова на не Ubuntu системы (с помощью НПМ), но важных возможностей предоставляются только через Ubuntu debian пакетов на данный момент.
+
+## Установка Кордова
+
+Добавьте в Ubuntu Cordova [Личный архив пакетов][3] Ubuntu системы:
+
+ [3]: https://launchpad.net/~cordova-ubuntu/+archive/ppa
+
+ $ sudo add-apt-repository ppa:cordova-ubuntu/ppa
+ $ sudo apt-get update
+
+
+Установите пакет cordova-cli (и его зависимости):
+
+ $ sudo apt-get install cordova-cli
+
+
+## Проект рабочего процесса
+
+### Создание проекта
+
+Создает приложение в `hello` каталог, чье отображаемое имя `HelloWorld` :
+
+ $ cordova create hello com.example.hello HelloWorld
+
+
+### Перейти в каталог проекта
+
+ $ cd hello
+
+
+### Добавьте платформа Ubuntu
+
+ $ cordova platform add ubuntu
+
+
+### Построить для Ubuntu
+
+ $ cordova build ubuntu
+
+
+### Запуск приложения
+
+ $ cordova run ubuntu
+
+
+### Добавление плагина камеры
+
+ $ cordova plugin add cordova-plugin-camera
\ No newline at end of file
diff --git a/docs/ru/5.0.0/guide/platforms/win8/index.md b/docs/ru/5.0.0/guide/platforms/win8/index.md
new file mode 100644
index 0000000..d784d92
--- /dev/null
+++ b/docs/ru/5.0.0/guide/platforms/win8/index.md
@@ -0,0 +1,190 @@
+---
+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.
+---
+
+# Руководство по платформе Windows
+
+В этом руководстве показано, как настроить среду разработки SDK для создания и развертывания приложений Cordova для Windows 8, Windows 8.1 и 8.1 Windows Phone. Он показывает, как использовать инструменты либо оболочки для создания и построения приложения, или кросс платформенный Cordova CLI обсуждаются в "Интерфейс командной строки". (См. Введение для сравнения этих вариантов развития). В этом разделе также показано, как изменять Cordova приложения в среде Visual Studio. Независимо от того, какой подход вы принимаете вам нужно установить SDK для Visual Studio, как описано ниже.
+
+Смотрите "Обновление для Windows 8" для информации о том, как обновить существующие проекты Windows 8 Cordova.
+
+Window Phone 8 (wp8) остается в качестве отдельной платформы, подробности в "Руководство для платформы Windows Phone 8".
+
+Cordova WebView под управлением ОС Windows полагаются на Internet Explorer 10 (Windows 8.0) и Internet Explorer 11 (Windows 8.1 и Windows Phone 8.1) как их движок рендеринга, так что с практической точки зрения мощный отладчик в IE можно использовать для тестирования любого веб-контента, который не вызвает API Cordova. Блог разработчиков Windows Phone предоставляет [полезные рекомендации][1] о том, как поддержка IE наряду с сопоставимыми WebKit-браузерами.
+
+ [1]: http://blogs.windows.com/windows_phone/b/wpdev/archive/2012/11/15/adapting-your-webkit-optimized-site-for-internet-explorer-10.aspx
+
+## Требования и поддержка
+
+Для разработки приложений для платформы Windows необходимо:
+
+* Windows 8.1, 32 или 64-разрядная машина (*Домашняя*, *Профессиональная*или *Корпортативное* издание) с как минимум 4 ГБ ОЗУ.
+
+* Для эмуляторов Windows Phone, Профессиональная версия Windows 8.1 (x64) или выше и процессор, который поддерживает [клиент Hyper-V и перевода адресов второго уровня (SLAT)][2]. Ознакомительная версия Windows 8.1 Enterprise доступна из [Microsoft Developer Network][3].
+
+* [Visual Studio 2013 для Windows][4] (Экспресс или выше).
+
+ [2]: https://msdn.microsoft.com/en-us/library/windows/apps/ff626524(v=vs.105).aspx#hyperv
+ [3]: http://msdn.microsoft.com/en-US/evalcenter/jj554510
+ [4]: http://www.visualstudio.com/downloads/download-visual-studio-vs#d-express-windows-8
+
+Приложения, скомпилированные под Windows 8.1 *не* запускаються под Windows 8.0. Приложения для Windows 8.0 совместимы с 8.1.
+
+Следуйте инструкциям на [windowsstore.com][5] для отправки приложения в магазин Windows.
+
+ [5]: http://www.windowsstore.com/
+
+Для разработки Cordova приложения для Windows, вы можете использовать ПК под управлением Windows, но может также разрабатывать на Mac, либо путем запуска в среде виртуальной машины, либо с помощью Boot Camp для двойной загрузки Windows 8.1 раздела. Проконсультируйтесь с этими ресурсами для настройки среды разработки Windows на Mac:
+
+* [VMWare Fusion][6]
+
+* [Parallels Desktop][7],
+
+* [Boot Camp][8].
+
+ [6]: http://msdn.microsoft.com/en-US/library/windows/apps/jj945426
+ [7]: http://msdn.microsoft.com/en-US/library/windows/apps/jj945424
+ [8]: http://msdn.microsoft.com/en-US/library/windows/apps/jj945423
+
+## Установите SDK
+
+Установить *Ultimate*, *Premium*или *Professional* выпуски [Visual Studio][4] 2013.
+
+![][9]
+
+ [9]: img/guide/platforms/win8/win8_installSDK.png
+
+## Использование инструментов командной строки Cordova
+
+Если вы хотите использовать инструменты оболочки Windows в центре Кордовы в сочетании с SDK, у вас есть два основных варианта:
+
+* Доступ к ним локально из кода проекта, созданного CLI. Они доступны в каталоге `platforms/windows/` после добавления платформы `windows` , как описано ниже.
+
+* Скачайте их из отдельного дистрибутива на [cordova.apache.org][10]. Дистрибутив Cordova содержит отдельные архивы для каждой платформы. Убедитесь в том что распаковываете соответствующий архив, `cordova-windows` в этом случае, в пустой каталог. Соответствующие утилиты командной строки доступны в каталоге `package/bin` . (Обратитесь при необходимости к **README** файлу за более подробными инструкциями.)
+
+ [10]: https://www.apache.org/dist/cordova/platforms/
+
+Эти оболочки инструменты позволяют создавать, строить и запускать приложения Windows. За информаций о дополнительных интерфейсах командной строки которые позволяют встраивать возможности плагинов среди разных платформ, смотрите раздел "Использование Plugman для управления расширениями".
+
+## Создание нового проекта
+
+На данный момент для создания нового проекта можно выбрать между кросс-платформенным инструментом CLI, описанным в разделе "Интерфейс командной строки", или набор инструментов для Windows. Ниже CLI подход создает приложение с именем *HelloWorld* в каталог нового проекта `hello` :
+
+ > cordova create hello com.example.hello HelloWorld
+ > cd hello
+ > cordova platform add windows
+
+
+Вот соответствующий подход shell инструмент более низкого уровня:
+
+ C:\path\to\cordova-windows\package\bin\create.bat C:\path\to\new\hello com.example.hello HelloWorld
+
+
+## Построение проекта
+
+Если вы используете CLI для разработки, каталога `www` проекта содержит исходные файлы. Запустите любой из нижеследующего в каталоге проекта для перепостроения приложения:
+
+ > cordova build
+ > cordova build windows # do not rebuild other platforms
+ > cordova build windows --debug # generates debugging information
+ > cordova build windows --release # signs the apps for release
+
+
+Вот соответствующий подход shell инструмент более низкого уровня:
+
+ C:\path\to\project\cordova\build.bat --debug
+ C:\path\to\project\cordova\build.bat --release
+ C:\path\to\project\cordova\clean.bat
+
+
+## Настройка целевой версии Windows
+
+По умолчанию, команда `build` производит два пакета: Windows 8.0 и 8.1 Windows Phone. Чтобы обновить пакет Windows до версии 8.1 следующие параметры конфигурации должны быть добавлены в файл конфигурации (`config.xml`).
+
+ <preference name='windows-target-version' value='8.1' />
+
+
+После того, как вы добавите этот параметр, команда `build` начнет создавать пакеты Windows 8.1 и 8.1 Windows Phone.
+
+## Развертывание приложения
+
+Развертывание пакета Windows:
+
+ > cordova run windows -- --win # explicitly specify Windows as deployment target
+ > cordova run windows # `run` uses Windows package by default
+
+
+Развертывание пакета Windows Phone:
+
+ > cordova run windows -- --phone # deploy app to Windows Phone 8.1 emulator
+ > cordova run windows --device -- --phone # deploy app to connected device
+
+
+Можно использовать **cordova run windows --list** чтобы увидеть все доступные цели и **cordova run windows --target=target_name \-- -|-phone** для запуска приложения на конкретном устройстве или эмуляторе (например, `cordova run windows --target="Emulator 8.1 720P 4.7 inch" -- --phone`).
+
+Чтобы увидеть дополнительные параметры построения и запуска также можно использовать **cordova run --help**.
+
+## Откройте проект в SDK и развертывание приложения
+
+После того, как вы построите Cordova-приложение, как описано выше, вы можете открыть его в Visual Studio. Различные команды `build` создют файл решения Visual Studio (*.sln*). Откройте файл в Проводнике, чтобы изменить проект в Visual Studio:
+
+![][11]
+
+ [11]: img/guide/platforms/win8/win8_sdk_openSLN.png
+
+Компонент `CordovaApp` отображается внутри решения, и его каталог `www` содержит исходный код, включая домашнюю страницу `index.html` :
+
+![][12]
+
+ [12]: img/guide/platforms/win8/win8_sdk.png
+
+Элементы управления ниже главного меню Visual Studio позволяют вам тестировать или развертывать приложения:
+
+![][13]
+
+ [13]: img/guide/platforms/win8/win8_sdk_deploy.png
+
+При выбранном пункте **Локальный компьютер** нажмите зеленую стрелку, чтобы установить приложение на том же компьютере где работает Visual Studio. Как только вы сделаете это, приложение появляется в списках приложений Windows 8:
+
+![][14]
+
+ [14]: img/guide/platforms/win8/win8_sdk_runApp.png
+
+Каждый раз, когда вы перестроить приложение, версия доступная в интерфейсе обновляется.
+
+После появления в списке приложений, удерживайте нажатой клавишу **CTRL** это позволяет закрепить приложение на главный экран:
+
+![][15]
+
+ [15]: img/guide/platforms/win8/win8_sdk_runHome.png
+
+Обратите внимание, что если вы открываете приложение в среде виртуальной машины, вам может понадобиться нажать в углах или по бокам окна переключения приложений или получить доступ к дополнительным функциям:
+
+![][16]
+
+ [16]: img/guide/platforms/win8/win8_sdk_run.png
+
+Альтернативно выберите параметр развертывания **Симулятор** для просмотра приложения, как если бы она была установлена на планшетном устройстве:
+
+![][17]
+
+ [17]: img/guide/platforms/win8/win8_sdk_sim.png
+
+В отличие от развертывания на настольные системы этот параметр позволяет имитировать ориентацию планшета, его местоположение и изменять его параметры сети.
+
+**Примечание**: Сверяйтесь с разделом "Введение" для понимания когда использовать инструменты командной строки Cordova а когда инструменты SDK в вашем рабочем процессе. Cordova CLI опирается на кросс платформенной исходный код, который постоянно перезаписывает файлы платформы, используемые SDK. Если вы хотите использовать SDK для изменения проекта, используйте низкоуровневые инструменты командной строки как альтернативу CLI.
\ No newline at end of file
diff --git a/docs/ru/5.0.0/guide/platforms/win8/plugin.md b/docs/ru/5.0.0/guide/platforms/win8/plugin.md
new file mode 100644
index 0000000..1a68ea8
--- /dev/null
+++ b/docs/ru/5.0.0/guide/platforms/win8/plugin.md
@@ -0,0 +1,204 @@
+---
+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.
+---
+
+# Плагины Windows
+
+Этот раздел содержит сведения о том, как реализовать плагин для использования в приложении Магазин Windows. Прежде чем читать это, увидеть приложения плагины обзор структуры плагина и его общий интерфейс JavaScript. Этот раздел продолжает демонстрировать образец *эхо* плагин, который общается с webview Кордова на родной платформе и обратно.
+
+Важно отметить, что Windows поддерживает разработку непосредственно в Javascript, что означает «родной» части в только в особых случаях.
+
+## Создание плагина Windows в JavaScript
+
+Эти инструкции предназначены для создания чистой плагин JavaScript. Понимая это имеет решающее значение для понимания того, как для добавления управляемого/машинного биты.
+
+Кордова Windows плагины являются по существу тонкой оболочкой вокруг существующих WinJS предоставляет функции, но предполагая, что вы хотите определить ваш JS общий интерфейс для нескольких устройств, вы обычно будет иметь 1 JS файл, предоставляющий API.
+
+ // inside file echoplugin.js
+ var EchoPlugin = {
+ // the echo function calls successCallback with the provided text in strInput
+ // if strInput is empty, it will call the errorCallback
+ echo:function(successCallback, errorCallback, strInput) {
+ cordova.exec(successCallback,errorCallback,"EchoPlugin","echo",[strInput]);
+ }
+ }
+
+
+## Внутри Кордова исп на Windows
+
+Функция cordova.exec определена по-разному на каждой платформе, это потому, что каждая платформа имеет его собственный способ общения между js код приложения и код родной оболочки. Но в случае Windows, нет никаких собственную оболочку, поэтому вызов exec существует для обеспечения согласованности. Вашу работу только плагин js непосредственно в EchoPlugin.echo, можно сделать что-то вроде:
+
+ // inside file echoplugin.js ( this is what NOT to do if you want to reuse the JS API cross platform )
+ var EchoPlugin = {
+ echo:function(successCallback,errorCallback,strInput) {
+ if(!strInput || !strInput.length) {
+ errorCallback("Error, something was wrong with the input string. =>" + strInput);
+ }
+ else {
+ successCallback(strInput + "echo");
+ }
+ }
+ }
+
+
+Это будет может работать нормально, однако это означает, что вам понадобится echoPlugin.js разные версии для разных платформ, и возможно вы могли бы проблемы несоответствия в вашей реализации. Как правило мы решили имитировать native API внутри cordova.exec на Windows, так что мы могли бы запустить тот же код JS и не требуется переписывать его на платформе и также воспользоваться любой проверки параметров, или другой общий код, предоставляемых разработчиками, которые работали на других платформах.
+
+## Кордова исп прокси
+
+В Windows cordova предоставляет прокси-сервер, который можно использовать для регистрации объекта, который будет обрабатывать все cordova.exec вызовы API.
+
+Например если вы хотели предоставить реализацию для акселерометра API, вы могли бы сделать это:
+
+cordova.commandProxy.add («Акселерометр», {начало: function() {/ / ваш код здесь...} / /... и на остальной части API здесь});
+
+Так что в нашем случае, мы будем считать что код в echoplugin.js обработки кросс-платформенный соответствующих JavaScript и мы можем просто написать прокси для Windows
+
+ // in file echopluginProxy.js
+ cordova.commandProxy.add("EchoPlugin",{
+ echo:function(successCallback,errorCallback,strInput) {
+ if(!strInput || !strInput.length) {
+ errorCallback("Error, something was wrong with the input string. =>" + strInput);
+ }
+ else {
+ successCallback(strInput + "echo");
+ }
+ }
+ });
+
+
+Определение плагин
+
+Если мы хотим, чтобы пользователи нашего плагина, чтобы иметь возможность легко установить наш плагин, нам нужно будет определить ее согласно как PlugMan определяет плагины. Подробнее об этом в [Спец плагин][1]
+
+ [1]: plugin_ref_spec.md.html#Plugin%20Specification
+
+ <?xml version="1.0" encoding="UTF-8"?>
+ <plugin xmlns="http://apache.org/cordova/ns/plugins/1.0"
+ id="com.risingj.echoplugin"
+ version="0.1.0">
+
+ <js-module src="www/echoplugin.js" name="echoplugin">
+ <clobbers target="window.echoplugin" />
+ </js-module>
+
+ <!-- windows -->
+ <platform name="windows">
+ <js-module src="src/windows/echopluginProxy.js" name="EchoProxy">
+ <merges target="" />
+ </js-module>
+ </platform>
+
+ <!-- other platforms -->
+
+ </plugin>
+
+
+Это дает нам рабочую Windows JavaScript плагин, который использует общий файл (echoplugin.js) и использует прокси-сервер для обеспечения Windows только часть осуществления (echopluginProxy.js). Так как мы добавим управляемого/машинного кода к этому? Ну, мы собираемся начать то же самое, только разница будет, что мы делаем внутри в echopluginProxy методы.
+
+# Как WinJS получает доступ управляемого/машинного кода
+
+В Windows, WinJS, авторские приложения способны взаимодействовать с машинным кодом, это между ОП доступен для компонентов Среда выполнения Windows. Детали, многочисленны, и это руководство будет охватывать только основы. Корпорация Майкрософт предоставляет гораздо больше информации [здесь][2].
+
+ [2]: http://msdn.microsoft.com/en-us/library/windows/apps/hh441569.aspx
+
+Когда вы создаете ваш компонент Среда выполнения Windows, любой класс, который определяется как «общественного ссылочного класса sealed» считается «активируемого класса» и будет можно вызывать из JavaScript.
+
+ // in your header file .h
+ namespace EchoRuntimeComponent
+ {
+ public ref class EchoPluginRT sealed
+ {
+ public:
+ static Platform::String^ Echo(Platform::String^ input);
+ }
+ }
+
+ // in the implementation file .cpp
+ using namespace EchoRuntimeComponent;
+ using namespace Platform;
+
+ Platform::String^ EchoPluginRT::Echo(Platform::String^ input)
+ {
+ if(input->IsEmpty())
+ {
+ return "Error: input string is empty.";
+ }
+ else
+ {
+ return input->ToString() + "echo";
+ }
+ }
+
+
+Теперь, чтобы для нас, чтобы вызывать машинный код, мы используем пространство имен, имя класса и lowerCamelCase метод, который мы называем.
+
+var res = EchoRuntimeComponent.EchoPluginRT.echo("boom"); Переезд это наш файл echopluginProxy.js, мы получаем это:
+
+ // in file echopluginProxy.js
+ cordova.commandProxy.add("EchoPlugin",{
+ echo:function(successCallback,errorCallback,strInput) {
+ var res = EchoRuntimeComponent.EchoPluginRT.echo(strInput);
+ if(res.indexOf("Error") == 0) {
+ errorCallback(res);
+ }
+ else {
+ successCallback(res);
+ }
+ }
+ });
+
+
+И вот это, у нас есть конец в конец при поддержке C++ js вызываемой плагин для использования в Apache Cordova Windows!
+
+# Некоторые технические примечания:
+
+* обратный вызов обычно является асинхронной, так вызовом обратного вызова сразу ожидается, вероятно, не вызывающим. На практике если вызов не async, следует по крайней мере использовать javascript таймаут заставить называться асинхронного обратного вызова.
+* Активируемых классов можно сделать все виды awesome, как событие, диспетчеризации, асинхронных обратных вызовов, передавая собственные типы объектов, массивы, коллекции, перегруженные методы и многое другое. Я рекомендую, что вы делаете вашу домашнюю работу.
+* Если вы будете придерживаться общих Windows Phone 8.0 и вызовы Windows SDK API, вы будете способны использовать один и тот же компонент среды выполнения (машинный или управляемый бит) в Windows Phone 8.0 Apache Cordova плагин. ~ Следите за этот пост.
+
+# Определение ваш плагин
+
+Теперь у нас есть плагин рабочих, нам необходимо пересмотреть определение плагин от ранее, так что мы можем опубликовать его. Теперь мы можем добавить компонент выполнения как основы. Обратите внимание, что тип выходных данных WindowsRuntimeComponent может быть .winmd или DLL
+
+ <?xml version="1.0" encoding="UTF-8"?>
+ <plugin xmlns="http://apache.org/cordova/ns/plugins/1.0"
+ id="com.risingj.echoplugin"
+ version="0.2.0">
+
+ <js-module src="www/echoplugin.js" name="echoplugin">
+ <clobbers target="window.echoplugin" />
+ </js-module>
+
+ <!-- windows -->
+ <platform name="windows">
+ <js-module src="src/windows/echopluginProxy.js" name="EchoProxy">
+ <merges target="" />
+ </js-module>
+ <framework src="src/windows/EchoRuntimeComponent.winmd" custom="true"/>
+ </platform>
+
+ <!-- other platforms -->
+
+ </plugin>
+
+
+Вот это, теперь у вас есть распространяемый плагин, что вы можете поделиться со всем миром! Одна вещь к примечанию, лишь недавно была добавлена поддержка для добавления рамок в проект Windows Cordova, так что вам будет нужно убедиться, что ваше cordova инструментов текущем. Кордова cli и Кордова plugman поддерживает добавление, удаление собственных резервных плагины.
+
+> cordova plugin add com.risingj.echoplugin or > plugman install --platform windows --plugin com.risingj.echoplugin --project .
+
+https://github.com/purplecabbage/cordova-runtimecomp-echoplug
\ No newline at end of file
diff --git a/docs/ru/5.0.0/guide/platforms/win8/tools.md b/docs/ru/5.0.0/guide/platforms/win8/tools.md
new file mode 100644
index 0000000..f98b26a
--- /dev/null
+++ b/docs/ru/5.0.0/guide/platforms/win8/tools.md
@@ -0,0 +1,37 @@
+---
+
+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.
+---
+
+# Средства командной строки Windows 8
+
+`cordova`Утилиты командной строки является высокого уровня инструмент, который позволяет вам создавать приложения сразу на нескольких платформах. Старые версии структуры Cordova предоставляет наборы средств командной строки для каждой платформы. Чтобы использовать их в качестве альтернативы для CLI, вам нужно скачать эту версию Cordova с [cordova.apache.org][1]. Загружаемый файл содержит отдельные архивы для каждой платформы. Разверните узел платформы, которую вы хотите цели. Инструменты, описанные здесь обычно доступны в профиле верхнего уровня `bin` каталог, в противном случае консультироваться с файлом **README** для получения более подробной направлениях.
+
+ [1]: http://cordova.apache.org
+
+Сведения о низкоуровневый интерфейс командной строки, который позволяет плагины см с помощью Plugman для управления плагинами. Смотрите приложение плагины обзор.
+
+## ОС Windows 8
+
+Средства командной строки Windows 8 поддерживают только создание новых проектов. Команды должны быть запущены из строки cmd или powershell.
+
+## Создание проекта
+
+Запуск `create` команды со следующими параметрами:
+
+* Путь к вашему новому проекту Cordova Windows 8
+
+* Имя пакета, после обратного домена стиль Конвенции. Это становится по умолчанию пространство имен.
+
+* Название проекта
\ No newline at end of file
diff --git a/docs/ru/5.0.0/guide/platforms/win8/upgrade.md b/docs/ru/5.0.0/guide/platforms/win8/upgrade.md
new file mode 100644
index 0000000..832fa7f
--- /dev/null
+++ b/docs/ru/5.0.0/guide/platforms/win8/upgrade.md
@@ -0,0 +1,59 @@
+---
+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.
+---
+
+# Обновление для Windows 8
+
+В этом руководстве показано, как изменить проекты Windows 8 для обновления старых версий Кордова. Большинство этих инструкций применимы для проектов, созданных со старым набором средств командной строки, которые предшествуют утилите CLI `cordova`. Смотрите раздел "Интерфейс командной строки" для получения информации как обновить версию CLI.
+
+## Обновление до 4.0.0 с 3.1.0 или позднее
+
+Для проектов, которые были созданы с помощью cordova CLI:
+
+1. Обновите версию `cordova` CLI. Смотрите "Интерфейс командной строки".
+
+2. Запуск`cordova platform update windows8`.
+
+Для проектов, не созданных с помощью cordova CLI выполните:
+
+ bin\update <project_path>
+
+
+## Обновление до 3.1.0
+
+Кордова CLI поддержка для Windows 8 была введена в Кордове 3.1.0. Для обновления, мы предлагаем создание новой CLI Cordova проекта и движущихся над всеми необходимыми активами.
+
+## Обновление до 2.9.0 с 2.8.0
+
+Следующие команды должно быть сделано из среды Visual Studio чтобы убедиться что обновление/удаляются все ссылки на проект.
+
+1. Удалить `cordova-2.8.0.js` из проекта `www` каталог.
+
+2. Добавить `cordova.js` файл из источника в проект `www` каталог. (Обратите внимание, что файл больше не содержит номер версии в имени файла).
+
+3. Построение и тестирование!
+
+## Обновление до 2.8.0 с 2.7.0
+
+Следующие команды должно быть сделано из среды Visual Studio чтобы убедиться что обновление/удаляются все ссылки на проект.
+
+1. Удалить `cordova-2.7.0.js` из проекта `www` каталог.
+
+2. Добавить `cordova.js` файл из источника в проект `www` каталог. (Обратите внимание, что файл больше не содержит номер версии в имени файла).
+
+3. Построение и тестирование!
\ No newline at end of file
diff --git a/docs/ru/5.0.0/guide/platforms/win8/upgrading.md b/docs/ru/5.0.0/guide/platforms/win8/upgrading.md
new file mode 100644
index 0000000..59a5ba7
--- /dev/null
+++ b/docs/ru/5.0.0/guide/platforms/win8/upgrading.md
@@ -0,0 +1,56 @@
+---
+
+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.
+---
+
+# Обновление для Windows 8
+
+В этом руководстве показано, как изменять проекты Windows 8 для обновления старых версий Cordova. Большинство этих инструкций применимы для проектов, созданных с старого набора средств командной строки, которые предшествуют `cordova` утилиты CLI. Увидеть интерфейс командной строки для получения информации как обновить версию инфраструктуры CLI.
+
+## Обновление до 3.2.0 от 3.1.0
+
+Для проектов, которые были созданы с Кордова CLI:
+
+1. Обновление `cordova` CLI-версия. Увидеть интерфейс командной строки.
+
+2. Запуск`cordova platform update windows8`.
+
+Для проектов, не созданных с Кордова CLI выполните:
+
+ bin\update <project_path>
+
+
+## Обновление до 3.1.0
+
+Кордова CLI поддержка для Windows 8 была введена в Кордове 3.1.0. Для обновления, мы предлагаем создание новой CLI Cordova проекта и движущихся над всеми необходимыми активами.
+
+## Обновление до 2.9.0 с 2.8.0
+
+Следующие команды должно быть сделано из среды Visual Studio чтобы убедиться что обновление/удаляются все ссылки на проект.
+
+1. Удалить `cordova-2.8.0.js` из проекта `www` каталог.
+
+2. Добавить `cordova.js` файл из источника в проект `www` каталог. (Обратите внимание, что этот файл больше не содержит номер версии в имени файла).
+
+3. Построение и тестирование!
+
+## Обновление до 2.8.0 с 2.7.0
+
+Следующие команды должно быть сделано из среды Visual Studio чтобы убедиться что обновление/удаляются все ссылки на проект.
+
+1. Удалить `cordova-2.7.0.js` из проекта `www` каталог.
+
+2. Добавить `cordova.js` файл из источника в проект `www` каталог. (Обратите внимание, что файл больше не содержит номер версии в имени файла).
+
+3. Построение и тестирование!
\ No newline at end of file
diff --git a/docs/ru/5.0.0/guide/platforms/wp7/index.md b/docs/ru/5.0.0/guide/platforms/wp7/index.md
new file mode 100644
index 0000000..edc158f
--- /dev/null
+++ b/docs/ru/5.0.0/guide/platforms/wp7/index.md
@@ -0,0 +1,104 @@
+---
+
+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.
+---
+
+# Руководство по платформы Windows Phone 7
+
+Данное руководство демонстрирует как настроить среду разработки для развертывания приложений на устройствах Windows Phone 7. Приложения также работают на устройствах Windows Phone 8, с помощью интерфейса API, но версия 7 не хватает некоторых IE10 дополнительных функций, доступных в Windows Phone 8. Приложения Windows Phone 8 делать *не* запускаются на устройствах Windows Phone 7.
+
+Смотрите ниже для более подробной информации конкретной платформы, которая применяется для обеих версий:
+
+* Обновление Windows Phone
+* Windows Phone плагины
+* Windows Phone средств командной строки
+
+Средства командной строки относятся к версии до 3.0 Кордова. Смотрите информацию о текущем интерфейсе интерфейс командной строки.
+
+## Системные требования
+
+Использовать Windows 7 или Windows 8 (Pro) или Windows Vista с пакетом обновления 2. 64-Разрядная версия (x 64) Windows требуется для SDK. Pro версия рекомендуется для запуска эмулятора устройства.
+
+Зарегистрироваться и оплатить счет [Центр разработчиков Windows Phone][1] если вы хотите установить приложения на реальном устройстве или представить его на рынке.
+
+ [1]: http://dev.windowsphone.com/en-us/publish
+
+**Примечание**: выполнение пакета SDK в виртуальной машине могут представлять вызовы. Читайте [Windows Phone на Mac][2] для идеи о разработке решений.
+
+ [2]: http://aka.ms/BuildaWP8apponaMac
+
+## Установить SDK и Кордова
+
+Скачать и установить [Windows Phone SDK][3].
+
+ [3]: http://www.microsoft.com/download/en/details.aspx?displaylang=en&id=27570/
+
+Загрузите и распакуйте последнюю копию [Кордова][4]. Вам нужно работать `lib\windows-phone-8\wp7` подкаталога, `lib\windows-phone-8\wp8` содержит 8 телефон Windwos версия Кордова.
+
+ [4]: http://phonegap.com/download
+
+Копия `CordovaWP7_x_x_x.zip` файл `\My Documents\Visual
+Studio 2012\Templates\ProjectTemplates\` каталог.
+
+## Создание шаблона
+
+**Примечание**: этот шаг пропустить, если `lib\windows-phone` уже содержит каталог `CordovaWP7_x_x_x.zip` файлов.
+
+Для упрощения разработки Cordova расслоения сценарий для создания шаблонов Visual Studio. Они позволяют вам быстро создавать Cordova apps, и при необходимости их можно изменить. Ниже шаги показывают, как создать его.
+
+### Запустите пакетный файл для создания и установки шаблонов
+
+Содержит корень репо `createTemplates.bat` файл. Дважды щелкните этот файл создает два `.zip` файлы: `CordovaWP7_x_x_x.zip` и `CordovaWP8_x_x_x.zip` , где *ххх* — номер текущей версии. Чтобы использовать эти файлы в Visual Studio, скопируйте их в `My Documents\Visual Studio
+2012\Templates\ProjectTemplates\` подкаталога. Вы могл после этого создать новое меню **приложений Apache Cordova Windows Phone_ из Visual Studio __File → новый проект** .
+
+Если вы запустите пакетный файл из командной строки, можно также вызвать с параметром для автоматической установки:
+
+ >createTemplates.bat -install
+
+
+## Создание нового проекта
+
+* Откройте Visual Studio Express для Windows Phone и выберите **Новый проект**.
+
+* Выберите **CordovaWP7**. Версия номер отображается в описании шаблона.
+
+* Присвойте проекту имя и нажмите **OK**.
+
+## Обзор структуры проекта
+
+`www`Каталог функции `html` , `js` , и `css` подкаталоги и любые другие ресурсы требует вашего приложения. Любое дополнительное содержимое должно быть частью проекта Visual Studio, и он должен быть задан как содержание.
+
+Следующий пример структуры представляет собой 2.3.0 проекта, но могут варьироваться в зависимости от установленной версии:
+
+![][5]
+
+ [5]: img/guide/platforms/wp8/projectStructure.png
+
+## Постройте проект для устройства
+
+Перед тестированием приложения на устройстве, устройство должно быть зарегистрировано. Документации [корпорации Майкрософт][6] сведения о том, как развернуть и протестировать на Windows Phone 7. Таковы основные шаги:
+
+ [6]: http://msdn.microsoft.com/en-us/library/windowsphone/develop/ff402565(v=vs.105).aspx
+
+* Убедитесь, что ваш телефон подключен, и экран разблокирован.
+
+* В Visual Studio выберите **устройство** в раскрывающемся меню в верхней.
+
+* Нажмите кнопку зеленый **играть** рядом с главного меню раскрывающегося списка для запуска отладки, или же введите **F5**.
+
+![][7]
+
+ [7]: img/guide/platforms/wp7/wpd.png
+
+На данный момент вы сделали.
\ No newline at end of file
diff --git a/docs/ru/5.0.0/guide/platforms/wp8/index.md b/docs/ru/5.0.0/guide/platforms/wp8/index.md
new file mode 100644
index 0000000..259158e
--- /dev/null
+++ b/docs/ru/5.0.0/guide/platforms/wp8/index.md
@@ -0,0 +1,190 @@
+---
+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.
+---
+
+# Руководство для платформы Windows Phone 8
+
+В этом руководстве показано, как настроить среду разработки SDK для развертывания приложений Cordova для устройств Windows Phone. Он фокусируется на Windows Phone 8, но дополнительные сведения о том, как поддержка Windows Phone 7.
+
+Оно показывает, как использовать либо инструменты командной строки, специфические для Windows Phone для создания и построения приложения, или кросс платформенный Cordova CLI описываемый в "Интерфейс командной строки". (См. Введение для сравнения этих процессов разработки.) В этом разделе также показано, как открыть приложений Cordova, так что вы можете изменять их в среде Visual Studio. Независимо от того, какой подход вы принимаете вам нужно установить Windows Phone SDK, как описано ниже.
+
+Смотрите следующие детали, характерные для платформы Windows Phone:
+
+* Плагины Windows Phone 8
+* Обновление Windows Phone 8
+
+Для платформы Windows Phone 8 Cordova WebView опирается на Internet Explorer 10 как ее движок, так что с практической точки зрения IE10 мощный отладчик можно использовать для тестирования любого веб-контента, который не вызвать API Cordova. Блог разработчиков Windows Phone предоставляет [полезные рекомендации][1] о том, как поддержать IE10 наряду с сопоставимыми WebKit-браузерами.
+
+ [1]: http://blogs.windows.com/windows_phone/b/wpdev/archive/2012/11/15/adapting-your-webkit-optimized-site-for-internet-explorer-10.aspx
+
+## Требования и поддержка
+
+Вам потребуется следующее:
+
+* 64-разрядная версия Windows 8 Pro, установочного диска или файла образа диска *ISO* . Ознакомительная версия доступна в [Microsoft Developer Network][2]. Версия Pro является необходимым для запуска эмулятора устройства.
+
+* [Windows Phone SDK][3].
+
+ [2]: http://msdn.microsoft.com/en-US/evalcenter/jj554510
+ [3]: https://dev.windowsphone.com/en-us/downloadsdk
+
+Для разработки приложений Cordova для устройств Windows Phone, вы можете использовать ПК под управлением Windows, но вы можете также разрабатывать на Mac, либо путем запуска в среде виртуальной машины, либо с помощью Boot Camp для двойной загрузки Windows раздела. Консультации эти ресурсы для настройки среды разработки необходимо Windows на Mac:
+
+* **VMWare Fusion**: для установки виртуальной машины Windows 8, выполните инструкции, предоставляемые [Microsoft Developer Network][4], то увидеть Настройка VMWare Fusion для получения информации о подготовке виртуальной среды для запуска эмулятора, в комплекте с SDK.
+
+* **Parallels Desktop**: для установки виртуальной машины Windows 8, выполните инструкции, предоставляемые [Microsoft Developer Network][5], затем смотрите "Настройка Parallels Desktop" для получения информации о подготовке виртуальной среды для запуска эмулятора, поставляемого в комплекте с SDK.
+
+ [4]: http://msdn.microsoft.com/en-US/library/windows/apps/jj945426
+ [5]: http://msdn.microsoft.com/en-US/library/windows/apps/jj945424
+
+<!--
+- __VirtualBox__: To set up the Windows 8 virtual machine, follow the
+ installation instructions provided by the [Microsoft Developer
+ Network](http://msdn.microsoft.com/en-US/library/windows/apps/jj945425).
+
+ 2DO: virtualBox doesn't work yet; any extra config info?
+-->
+
+* **Лагерь ботинка**: чтобы настроить раздел Windows 8, следуйте инструкциям по установке, представленной в [Microsoft Developer Network][6].
+
+ [6]: http://msdn.microsoft.com/en-US/library/windows/apps/jj945423
+
+Если вы разрабатываете на ПК, его процессор должен поддерживать Виртуализация (*VT-x* на Intel) и [Перевода адресов второго уровня (SLAT)][7]. Обратитесь к [Intel список процессоров][8]. Виртуализация обычно отключена по умолчанию, поэтому необходимо включить в настройках BIOS. ПК должен иметь по крайней мере 6,5 ГБ свободного дискового пространства и 4 ГБ оперативной памяти.
+
+ [7]: http://en.wikipedia.org/wiki/Second_Level_Address_Translation
+ [8]: http://ark.intel.com/Products/VirtualizationTechnology
+
+## С помощью инструментов Cordova оболочки
+
+Если вы хотите использовать инструменты Windows Phone-центру оболочки Cordova вместе с SDK, у вас есть два основных варианта:
+
+* Доступ к ним локально из проекта кода, созданного CLI. Они доступны в `platforms/wp8/cordova` Каталог после добавления `wp8` платформа, как описано ниже.
+
+* Скачайте их из отдельных распределения на [cordova.apache.org][9]. Кордова дистрибутив содержит отдельные архивы для каждой платформы. Будьте уверены, чтобы расширить в соответствующий архив, `cordova-wp8\wp8` в данном случае, в пустой каталог. Соответствующие пакетных утилит доступны в верхнего уровня `bin` каталог. (Обратитесь к **README** файл при необходимости для более подробные инструкции.)
+
+ [9]: http://cordova.apache.org
+
+Эти оболочки инструменты позволяют создавать, строить и запускать приложения Windows Phone. За информаций о дополнительных интерфейсах командной строки которые позволяют встраивать возможности плагинов среди разных платформ, смотрите раздел "Использование Plugman для управления плагинами". Смотрите приложение плагины для руководства по разработке плагинов и Windows Phone 8 плагинов для сведения, специфичные для платформы Windows Phone.
+
+## Установите SDK
+
+Установите последнюю версию пакета SDK Windows Phone от **Скачиваний** области [dev.windowsphone.com][3]. Вы можете также установить последние пакеты обновления эмулятора.
+
+![][10]
+
+ [10]: img/guide/platforms/wp8/wp8_downloadSDK.png
+
+## Создание нового проекта
+
+На данный момент для создания нового проекта можно выбрать между кросс-платформенным инструментом CLI, описанным в разделе "Интерфейс командной строки", или набор инструментов для Windows Phone. С в каталоге исходного кода, а вот подход CLI:
+
+ > cordova create hello com.example.hello HelloWorld
+ > cd hello
+ > cordova platform add wp8
+
+
+Вот соответствующий подход shell инструмент более низкого уровня:
+
+ C:\path\to\cordova-wp8\bin\create.bat C:\path\to\new\hello com.example.hello HelloWorld
+
+
+## Построение проекта
+
+Если вы используете CLI для разработки, каталога `www` проекта содержит исходные файлы. Запустите любой из нижеследующего в каталоге проекта для перепостроения приложения:
+
+ > cordova build
+ > cordova build wp8 # do not rebuild other platforms
+
+
+Если вы используете инструменты Windows Phone специфические оболочки в процессе развития, существует другой подход. После создания проекта приложения по умолчанию источник доступен в `projects\wp8\www` подкаталога. Последующие команды доступны в `cordova` подкаталога на том же уровне.
+
+`build`Команда очищает файлы проекта и перестраивает app. Первый пример генерирует отладочную информацию, и второй подписывает apps для выпуска:
+
+ C:\path\to\project\cordova\build.bat --debug
+ C:\path\to\project\cordova\build.bat --release
+
+
+`clean`Команда помогает вымывать каталогов в рамках подготовки к следующей `build` :
+
+ C:\path\to\project\cordova\clean.bat
+
+
+## Развертывание на эмулятор
+
+К этому моменту можно использовать утилиту CLI `cordova` для развертывания приложения на эмулятор из командной строки:
+
+ > cordova emulate wp8
+
+
+В противном случае используйте интерфейс альтернативной оболочки:
+
+ C:\path\to\project\cordova\run
+
+
+По умолчанию `run` сценарий вызывает эмулятор флаг и принимает дополнительные построения флаги, для которого `--debug` предоставляет значение по умолчанию:
+
+ C:\path\to\project\cordova\run --emulator --debug
+ C:\path\to\project\cordova\run --emulator --release
+ C:\path\to\project\cordova\run --emulator --nobuild
+
+
+Эмулятор запускает образа устройства с установленным приложением. От домашнего экрана перейдите на панель приложения для запуска приложения **HelloWorld** . Это показывает запуск с его заставка, после чего его основной интерфейс приложения:
+
+![][11]
+
+ [11]: img/guide/platforms/wp8/wp8_emulator.png
+
+Основные элементы эмулятора на правом верхнем углу экрана устройства позволяют переключаться между книжной и альбомной ориентации. **>** Кнопка открывает больше элементов управления, которые позволяют протестировать более сложных установок и жесты:
+
+![][12]
+
+ [12]: img/guide/platforms/wp8/wp8_emulator_orient.png
+
+Эти дополнительные элементы управления также позволяют изменять местоположение устройства или для моделирования последовательностей движений:
+
+![][13]
+
+ [13]: img/guide/platforms/wp8/wp8_emulator_loc.png
+
+## Развертывание на устройство
+
+Перед тестированием приложения на устройстве, устройство должно быть зарегистрировано. Документации [корпорации Майкрософт][14] сведения о том, как развернуть и протестировать на Windows Phone 8. Кроме того убедитесь, что телефон подключен к компьютеру, и экран разблокируется.
+
+ [14]: http://msdn.microsoft.com/en-us/library/windowsphone/develop/ff402565.aspx
+
+Затем запустите следующую команду CLI для запуска приложения на устройстве:
+
+ > cordova run wp8
+
+
+Он соответствует этой команды оболочки более низкого уровня:
+
+ C:\path\to\project\cordova\run --device
+
+
+Кроме того если вы работаете в Visual Studio, выберите **Устройство Windows Phone** из раскрывающегося меню в верхней, а затем нажмите зеленый **играть** кнопку рядом, или же введите **F5**.
+
+## Изменить проект в SDK
+
+После того, как вы строите Cordova-приложение, как описано выше, вы можете открыть его с SDK. Различные `build` команды создается файл Visual Studio решения (*.sln*). Откройте файл, чтобы изменить проект в Visual Studio. Веб-исходный код доступен в рамках проекта `www` каталог. А также другие средства SDK предоставляет, управления ниже меню позволяет запустить приложение в эмуляторе Windows Phone:
+
+![][15]
+
+ [15]: img/guide/platforms/wp8/wp8_vs.png
+
+Сверяйтесь с разделом "Введение" о том как использовать интерфейс командной строки Cordova командной или SDK в вашем рабочем процессе. Кордова CLI опирается на кросс платформенной исходный код, который постоянно перезаписывает файлы платформы, используемые в SDK. Если вы хотите работать в рамках SDK, используйте инструменты низкого уровня оболочки как альтернатива CLI.
\ No newline at end of file
diff --git a/docs/ru/5.0.0/guide/platforms/wp8/parallels.md b/docs/ru/5.0.0/guide/platforms/wp8/parallels.md
new file mode 100644
index 0000000..b4c5600
--- /dev/null
+++ b/docs/ru/5.0.0/guide/platforms/wp8/parallels.md
@@ -0,0 +1,41 @@
+---
+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.
+---
+
+# Настройка Parallels Desktop
+
+В этом разделе показано, как настроить Parallels Desktop на Mac, так что вы можете использовать Cordova для создания приложений Windows Phone.
+
+[Microsoft Developer Network][1] содержит общие инструкции для запуска Windows в Parallels Desktop. После установки Windows, выполните следующие действия:
+
+ [1]: http://msdn.microsoft.com/en-US/library/windows/apps/jj945424
+
+1. В Parallels Desktop выберите образ диска Windows 8, вы подготовили и выберите **Параметры**.
+
+2. Выберите параметры **Общие → процессоры** . Укажите *два* ЦП. Укажите по крайней мере 2 ГБ памяти, даже если он выходит за пределы рекомендуемого диапазона:
+
+ ![][2]
+
+3. Чтобы иметь возможность запускать образ эмулятора устройства в виртуальной машине Windows 8, выберите настройки, **оптимизации** и включение **Вложенных виртуализации**.
+
+ ![][3]
+
+ [2]: img/guide/platforms/wp8/parallel_cpu_opts.png
+ [3]: img/guide/platforms/wp8/parallel_optimize_opts.png
+
+После выполнения этих шагов, вы будете готовы к установке Windows Phone SDK. Смотрите Руководство для платформы Windows Phone 8 для подробностей.
\ No newline at end of file
diff --git a/docs/ru/5.0.0/guide/platforms/wp8/plugin.md b/docs/ru/5.0.0/guide/platforms/wp8/plugin.md
new file mode 100644
index 0000000..b757209
--- /dev/null
+++ b/docs/ru/5.0.0/guide/platforms/wp8/plugin.md
@@ -0,0 +1,207 @@
+---
+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.
+---
+
+# Плагины Windows Phone 8
+
+Этот раздел содержит сведения о том, как реализовать собственный плагин на платформе Windows Phone. Прежде чем читать этот раздел, смотрите "Руководство по разработке плагинов" для понимания структуры плагина и его общий интерфейс JavaScript. Этот раздел продолжает демонстрировать образец плагина *echo*, который взаимодействует с WebView Cordova на стороне платформы и наоборот.
+
+Писать плагин для Кордова на Windows Phone требуется базовое понимание архитектуры в Кордове. Кордова-WP8 состоит из `WebBrowser` , содержит код JavaScript приложения и управляет родной вызовы API. Вы можете расширить C# `BaseCommand` класса ( `WPCordovaClassLib.Cordova.Commands.BaseCommand` ), которая поставляется с большинство функциональных возможностей, вам необходимо:
+
+1. Выберите ваш проект и щелкните правой кнопкой мыши выбрать **Добавить → новый элемент...** Если вы хотите, вы можете добавить его в `Plugins` папку.
+
+2. Выберите **класс** и назовите его `Echo.cs` . Этот класс имя должно *точно* соответствовать что вы называете указать в качестве службы в `cordova.exec()` вызов на стороне JavaScript.
+
+3. Включить осуществление базовых классов:
+
+ using WPCordovaClassLib.Cordova;
+ using WPCordovaClassLib.Cordova.Commands;
+ using WPCordovaClassLib.Cordova.JSON;
+
+
+4. Расширить свой класс от `BaseCommand` :
+
+ public class Echo : BaseCommand
+ {
+ // ...
+ }
+
+
+5. Добавить `echo` метод, который можно вызывать из JavaScript:
+
+ public class Echo : BaseCommand
+ {
+ public void echo(string options)
+ {
+ // all JS callable plugin methods MUST have this signature!
+ // public, returning void, 1 argument that is a string
+ }
+ }
+
+
+Смотреть [BaseCommand.cs][1] класс для методов, доступных для плагина для переопределения. Например плагин может перехватывать события «pause» и «resume».
+
+ [1]: https://github.com/apache/cordova-wp8/blob/master/wp8/template/cordovalib/Commands/BaseCommand.cs
+
+## Пространства имён
+
+Пространство имен по умолчанию для неквалифицированных команды является:
+
+ namespace Cordova.Extension.Commands
+ {
+ // ...
+ }
+
+
+Если вы хотите задать собственных имен, вам нужно позвонить в полное `cordova.exec` . Например, если вы хотите определить класс C# следующим образом:
+
+ namespace com.mydomain.cordovaExtensions
+ {
+ public class Echo : BaseCommand
+ {
+ // ...
+ }
+ }
+
+
+JavaScript необходимо будет вызвать `exec` , как это:
+
+ cordova.exec(win, fail, "com.mydomain.cordovaExtensions.Echo", ...);
+
+
+## Интерпретации аргументов в C
+
+В примере, рассмотренном в плагины приложения данные, которые получает ваш плагин является строкой, но что, если вы хотите передать массив строк? Предположим, что JavaScript `cordova.exec` вызова задается следующим образом:
+
+ cordova.exec(win, fail, "Echo", "echo", ["input string"]);
+
+
+Значение `options` строка, передаваемая в `Echo.echo` метод является JSON:
+
+ "[\"input string\"]"
+
+
+Все JavaScript `exec` аргументы JSON кодируются перед передачей в C# и поэтому нужно декодировать:
+
+ string optVal = JsonHelper.Deserialize<string[]>(options)[0];
+ // optVal now has the value of "input string"
+
+
+## Результаты тестирования из C# в JavaScript
+
+`BaseCommand`Класс предоставляет методы для передачи данных обратного вызова обработчиков JavaScript. Если вы хотите просто сигнал успеха без сопровождающих результата, вы можете просто позвонить:
+
+ DispatchCommandResult();
+ // calls back with an empty plugin result, considered a success callback
+
+
+Чтобы передать данные обратно, вам нужно позвонить `DispatchCommandResult` по-разному:
+
+ DispatchCommandResult(new PluginResult(PluginResult.Status.OK, "Everything went as planned, this is a result that is passed to the success handler."));
+
+
+Используйте зашифрованную строку JSON для передачи данных структурированных объектов обратно в JavaScript:
+
+ DispatchCommandResult(new PluginResult(PluginResult.Status.OK, "{result:\"super awesome!\"}"));
+
+
+Чтобы сигнал об ошибке, вызовите `DispatchCommandResult` с `PluginResult` объект, состояние которого является `ERROR` :
+
+ DispatchCommandResult(new PluginResult(PluginResult.Status.ERROR, "Echo signaled an error"));
+
+
+## Обработка ошибок сериализации
+
+При интерпретации аргументов, `try` / `catch` блоки помогают отсеивать плохие ввода. Эта модель появляется на протяжении код Cordova C#:
+
+ string optVal = null;
+
+ try
+ {
+ optVal = JsonHelper.Deserialize<string[]>(options)[0];
+ }
+ catch(Exception)
+ {
+ // simply catch the exception, we handle null values and exceptions together
+ }
+
+ if (optVal == null)
+ {
+ DispatchCommandResult(new PluginResult(PluginResult.Status.JSON_EXCEPTION));
+ }
+ else
+ {
+ // ... continue on to do our work
+ }
+
+
+## Плагин жизни
+
+Плагины с долго выполняющихся запросов, фон деятельности, такие как воспроизведение мультимедиа, слушателей или что поддерживать внутреннее состояние следует осуществлять `onReset` метод для очистки этих мероприятий. Метод выполняется, когда CordovaView WebBrowser переходит на новую страницу или обновления, которая перезагружает JavaScript.
+
+ // defined in WPCordovaClassLib.Cordova.Commands.BaseCommand
+ public virtual void OnReset() { }
+
+
+## Плагин XML
+
+Ниже показано, как использовать `plugin.xml` файла для указания плагин исходных файлов на платформе Windows Phone. См приложение плагины обзор, и "Спецификация расширений" для подробной информации об имеющихся вариантах.
+
+* `<source-file>`Элемент определяет все ресурсы плагин, например *.cs*, *.xaml*, *. xaml.cs*и *DLL-* файлов и графических ресурсов.
+
+* `<config-file>`Элемент определяет элементы для вставки в файл конфигурации. Этот пример добавляет плагин на платформу `config.xml` файл:
+
+ <config-file target="config.xml" parent="/*">
+ <feature name="PluginName">
+ <param name="wp-package" value="PluginName"/>
+ </feature>
+ </config-file>
+
+
+ Этот пример добавляет возможность контактов `WMAppManifest.xml` файл:
+
+ <config-file target="Properties/WMAppManifest.xml" parent="/Deployment/App/Capabilities">
+ <Capability Name="ID_CAP_CONTACTS" />
+ </config-file>
+
+
+## Отладка плагины
+
+Использование отладчика Visual Studio для отладки работы плагина C# компонент. Точку останова можно установить в любой из методов, предоставляемых в вашем классе.
+
+JavaScript является более сложным для отладки на Windows Phone. Вам нужно использовать `console.log` для вывода плагин государство, или сообщить себя от ошибок.
+
+## Наиболее распространенные ошибки
+
+* Будьте осторожны, чтобы не передавать аргументы из JavaScript к родной стороне, которые трудно десериализовать формат JSON. Большинство платформ устройств ожидать аргумент, передаваемый `cordova.exec()` быть массива, например следующие:
+
+ cordova.exec(win, fail, "ServiceName", "MethodName", ["this is a string", 54, {literal:'trouble'}]);
+
+
+ Это может привести к чрезмерно сложным строковое значение для C# для декодирования:
+
+ "[\"this is a string\", 54, { literal:'trouble' }]"
+
+
+ Вместо этого, рассмотреть вопрос о преобразовании *всех* параметров в строки перед вызовом `exec()` и декодирования каждой отдельно:
+
+ cordova.exec(win, fail, "ServiceName", "MethodName", ["this is a string", "54", "{literal:'trouble'}"]);
+ string[] optValues = JsonHelper.Deserialize<string[]>(options);
+
+
+* Как правило, лучше проверить параметры в JavaScript перед вызовом `exec()` . Это позволяет повторно использовать код и вытащить ненужные функции из плагина различных встроенных реализаций.
\ No newline at end of file
diff --git a/docs/ru/5.0.0/guide/platforms/wp8/tools.md b/docs/ru/5.0.0/guide/platforms/wp8/tools.md
new file mode 100644
index 0000000..40f1a27
--- /dev/null
+++ b/docs/ru/5.0.0/guide/platforms/wp8/tools.md
@@ -0,0 +1,91 @@
+---
+
+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.
+---
+
+# Windows Phone средств командной строки
+
+`cordova`Утилиты командной строки является высокого уровня инструмент, который позволяет вам создавать приложения сразу на нескольких платформах. Старые версии структуры Cordova предоставляет наборы средств командной строки для каждой платформы. Чтобы использовать их в качестве альтернативы для CLI, вам нужно скачать эту версию Cordova с [cordova.apache.org][1]. Загружаемый файл содержит отдельные архивы для каждой платформы. Разверните узел платформы, которую вы хотите цели. Инструменты, описанные здесь обычно доступны в профиле верхнего уровня `bin` каталог, в противном случае консультироваться с файлом **README** для получения более подробной направлениях.
+
+ [1]: http://cordova.apache.org
+
+Сведения о низкоуровневый интерфейс командной строки, который позволяет плагины см с помощью Plugman для управления плагинами. Смотрите приложение плагины обзор.
+
+## Windows Phone
+
+Средства командной строки Windows Phone поддерживает создание, строительство и запуск новых проектов. Команды должны быть запущены из строки cmd или powershell.
+
+Репо WP8 теперь включает в себя код для построения WP7 + WP8 apps. Repo есть подкаталоги для каждого: `wp7/` и`wp8/`.
+
+## Создание проекта
+
+Есть 2 способа идти о создании нового приложения Apache Cordova WP7 или WP8.
+
+### Запустите пакетный файл для создания и установки шаблонов
+
+* Содержит корень репо `createTemplates.bat` файл. Дважды она генерирует два `.zip` файлы: `CordovaWP7_x_x_x.zip` и `CordovaWP8_x_x_x.zip` , где *ххх* — номер текущей версии. Чтобы легко использовать эти файлы в Visual Studio, скопируйте их в `My Documents\Visual Studio
+2012\Templates\ProjectTemplates\` . Затем вы могл создать Apache Cordova Windows Phone приложения из Visual Studio **файл → новый проект** меню.
+
+* Если вы запустите пакетный файл из командной строки, вы также можете позвонить с параметром для автоматической установки
+
+Запустите сценарий:
+
+ >createTemplates.bat -install
+
+
+### Использовать скрипты Create в командной строке
+
+Запуск `create` команду, указав существующий путь к проекту, реверс домен стиль пакета идентификатор и отображаемое имя приложения. Вот синтаксис для Windows Phone 7 и 8:
+
+ >.\wp7\bin\create PathToNewProject [ PackageName ] [ AppName ]
+ >.\wp8\bin\create PathToNewProject [ PackageName ] [ AppName ]
+
+ >PathToNewProject : The path to where you wish to create the project
+ >PackageName : The namespace for the project (default is Cordova.Example)
+ >AppName : The name of the application (default is CordovaWP8AppProj or CordovaWP7AppProj)
+
+ >examples:
+ >.\wp7\bin\create C:\path\to\my_new_project
+ >.\wp8\bin\create C:\path\to\my_new_project io.cordova.example CordovaWP8App
+
+
+Запустите Visual Studio и откройте файл решения (SLN) в (C:\path\to\my\_new\_project)
+
+Построить и запустить его
+
+## Построение проекта (чистой, а затем построить)
+
+* Отладка
+
+ $ C:\path\to\my\_new\_project\cordova\build --debug
+
+* Релиз
+
+ $ C:\path\to\my\_new\_project\cordova\build --release
+
+## Запуск приложения
+
+Выполните команду «run» со следующими *необязательными* параметрами
+
+* Целевая спецификация. Это включает в себя `--emulator` , `--device` , или`--target=<targetID>`.
+
+* Создание спецификации. Это включает в себя `--debug` , `--release` , или`--nobuild`.
+
+ $ C:\path\to\my\_new\_project\cordova\run \[Target\] \[Build\]
+
+По умолчанию `run` команда вызывается с `--emulator --debug` если флаги не предоставляются.
+
+## Очистка
+
+ $ C:\path\to\my_new_project\cordova\clean
\ No newline at end of file
diff --git a/docs/ru/5.0.0/guide/platforms/wp8/upgrade.md b/docs/ru/5.0.0/guide/platforms/wp8/upgrade.md
new file mode 100644
index 0000000..a69b1a7
--- /dev/null
+++ b/docs/ru/5.0.0/guide/platforms/wp8/upgrade.md
@@ -0,0 +1,92 @@
+---
+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.
+---
+
+# Обновление Windows Phone 8
+
+В этом руководстве показано, как изменить проекты Windows Phone 8, для обновления от более старых версий Cordova. Большинство этих инструкций применимы для проектов, созданных со старым набором средств командной строки, которые предшествуют утилите CLI `cordova`. Смотрите раздел "Интерфейс командной строки" для получения информации как обновить версию CLI. В следующем разделе показано, как обновить не-CLI и CLI проекты.
+
+## Обновление проектов с 3.6.0 до 4.0.0
+
+Для проектов-CLI выполните:
+
+ bin/обновить путь/к/проекта
+
+
+Для проектов CLI:
+
+1. Обновите версию `cordova` CLI. Смотрите "Интерфейс командной строки".
+
+2. Запуск `cordova platform update wp8` в существующих проектах.
+
+## Обновление до 3.2.0 от 3.1.0
+
+Для проектов, которые были созданы с помощью cordova CLI:
+
+1. Обновите версию `cordova` CLI. Смотрите "Интерфейс командной строки".
+
+2. Выполните `cordova platform update wp8`
+
+Для проектов, не созданных с помощью cordova CLI выполните:
+
+ bin/update <project_path>
+
+
+## Обновление до 3.1.0 с 3.0.0
+
+Для проектов, которые были созданы с помощью cordova CLI:
+
+1. Обновите версию `cordova` CLI. Смотрите "Интерфейс командной строки".
+
+2. Запуск`cordova platform update wp8`
+
+Для проектов, не созданных с помощью cordova CLI выполните:
+
+ bin\update <project_path>
+
+
+## Обновление к CLI (3.0.0) с 2.9.0
+
+1. Создайте новый проект Apache Cordova 3.0.0 используя cordova CLI, как описано в интерфейс командной строки.
+
+2. Добавьте ваш платформ в Кордове проект, например:`cordova
+platform add wp8`.
+
+3. Скопируйте содержимое каталога `www` исходного проекта в каталог `www` в корне проекта cordova, который вы только что создали.
+
+4. Скопируйте или замените любые ресурсы платформы из вашего исходного проекта (`SplashScreen`, `ApplicationIcon`, и т.д.), удостовертесь что добавили все новые файлы в `.csproj` файл. Проект Windows phone собирается внутри каталога `platforms\wp8`.
+
+5. Используйте Сordova CLI для установки необходимых вам плагинов. Обратите внимание что CLI интерпретирует все базовые APIs как плагины, так что они тоже должны быть добавлены. Только плагины для версии 3.0.0 поддерживаются CLI.
+
+6. Построение и тестирование.
+
+## Обновление до 3.0.0 (не CLI) с 2.x
+
+В окне Обозреватель решений Visual Studio:
+
+1. Создайте новый проект Apache Cordova WP8 3.0.0.
+
+2. Скопируйте содержимое каталога `www` в новый проект и убедитесь что эти элементы добавлены в проект VS.
+
+3. Скопируйте и перезапишите любую заставку, или иконку.
+
+4. Скопируйте любые плагины из каталога `plugins` в новый проект и убедитесь, что они также добавлены в проект VS.
+
+5. Постройте и протестируйте.
+
+**Примечание**: все основные API удалены из Cordova версии 3.0 и должен быть установлены отдельно как плагины. Дополнительные сведения о том, как повторно включить эти функции в рабочем процессе без использования CLI см. "Использование Plugman для управления расширениями".
\ No newline at end of file
diff --git a/docs/ru/5.0.0/guide/platforms/wp8/upgrading.md b/docs/ru/5.0.0/guide/platforms/wp8/upgrading.md
new file mode 100644
index 0000000..30b0cb1
--- /dev/null
+++ b/docs/ru/5.0.0/guide/platforms/wp8/upgrading.md
@@ -0,0 +1,418 @@
+---
+
+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.
+---
+
+# Обновление Windows Phone
+
+В этом руководстве показано, как изменить Windows Phone проектов, обе версии 7 и 8, для обновления старых версий Cordova. Большинство этих инструкций применимы для проектов, созданных с старого набора средств командной строки, которые предшествуют `cordova` утилиты CLI. Увидеть интерфейс командной строки для получения информации как обновить версию инфраструктуры CLI. В следующем разделе показано, как перейти от проектов-CLI.
+
+## Обновление до 3.2.0 с 3.1.0
+
+Для проектов, которые были созданы с cordova CLI:
+
+1. Обновление `cordova` CLI-версия. Увидеть интерфейс командной строки.
+
+2. Запуск `cordova platform update wp8` (или `wp7` , на платформах, вы добавили в проект).
+
+Для проектов, не создан с cordova CLI выполните:
+
+ bin\update <project_path>
+
+
+## Обновление до 3.1.0 с 3.0.0
+
+Для проектов, которые были созданы с Кордова CLI:
+
+1. Обновление `cordova` CLI-версия. Увидеть интерфейс командной строки.
+
+2. Запуск `cordova platform update wp8` (или `wp7` , на платформах, вы добавили в проект).
+
+Для проектов, не созданных с Кордова CLI выполните:
+
+ bin\update <project_path>
+
+
+## Обновление до CLI (3.0.0) с 2.9.0
+
+1. Создайте новый проект Apache Cordova 3.0.0 используя Cordova CLI, как описано в разделе "Интерфейс командной строки".
+
+2. Добавьте ваши платформы в проект Cordova, например: `cordova
+platform add wp7 wp8`.
+
+3. Скопируйте содержимое каталога `www` в каталог `www` проекта Cordova который вы только что создали.
+
+4. Скопируйте или замените любые ресурсы платформы из вашего исходного проекта (`SplashScreen`, `ApplicationIcon`, и т.д.), удостовертесь что добавили все новые файлы в `.csproj` файл. Проект Windows Phone собирается внутри папок `platforms\wp7` или `platforms\wp8`.
+
+5. Используйте Сordova CLI для установки необходимых вам плагинов. Обратите внимание что CLI интерпретирует все базовые APIs как плагины, так что они тоже должны быть добавлены. Только плагины для версии 3.0.0 поддерживаются CLI.
+
+6. Построение и тестирование.
+
+## Обновление до 3.0.0 (не CLI) с 2.9.0
+
+В окне Обозреватель решений Visual Studio:
+
+1. Создайте новый проект Apache Cordova WP7 или WP8 3.0.0.
+
+2. Скопируйте содержимое вашего `www` каталога в новый проект и убедитесь, что эти элементы добавляются в проект VS.
+
+3. Скопируйте и перезаписать любой экран-заставку, или значок изображения.
+
+4. Скопируйте любые плагины от `plugins` каталог на новый проект и убедитесь, что они также добавляются в проект VS.
+
+5. Построение и тестирование.
+
+**Примечание**: все основные API удаляются от Кордова версии 3.0 и должен быть установлен отдельно как плагины. Дополнительные сведения о том, как повторно включить эти функции в рабочем-CLI см с помощью Plugman для управления плагинами.
+
+## Обновление до 2.9.0 с 2.8.0
+
+В окне Обозреватель решений Visual Studio:
+
+1. Создайте новый Apache Cordova WP7 или WP8 2.9.0 проекта.
+
+2. Скопируйте содержимое вашего `www` каталога в новый проект и убедитесь, что эти элементы добавляются в проект VS.
+
+3. Обновить имя `cordova.js` в теге HTML, если это по-прежнему используя cordova-VERSION.js (должно быть просто`cordova.js`).
+
+4. Скопируйте и перезаписать любой экран-заставку, или изображения значка.
+
+5. Скопируйте любые плагины от `plugins` каталог на новый проект и убедитесь, что они также добавляются в файл .csproj.
+
+6. Построение и тестирование.
+
+## Обновление до 2.8.0 с 2.7.0
+
+В окне Обозреватель решений Visual Studio:
+
+1. Создайте новый Apache Cordova WP7 или WP8 2.8.0 проекта.
+
+2. Скопируйте содержимое вашего `www` каталога в новый проект и убедитесь, что эти элементы добавляются в проект VS.
+
+3. Обновить ваш HTML, чтобы использовать новый `cordova.js` файл. (Обратите внимание на отсутствие номер версии в имени файла.)
+
+4. Скопируйте и перезаписать любой экран-заставку, или изображения значка.
+
+5. Копирование через любые плагины от `plugins` каталога в новый проект и убедитесь, что они также добавляются в проект VS.
+
+6. Построение и тестирование.
+
+## Обновление до 2.7.0 с 2.6.0
+
+В окне Обозреватель решений Visual Studio:
+
+1. Создайте новый Apache Cordova WP7 или WP8 2.7.0 проекта.
+
+2. Скопируйте содержимое вашего `www` каталога в новый проект и убедитесь, что эти элементы добавляются в проект VS.
+
+3. Обновить ваш HTML, чтобы использовать новый `cordova-2.7.0.js` файл.
+
+4. Скопируйте и перезаписать любой экран-заставку, или изображения значка.
+
+5. Копирование через любые плагины от `plugins` каталога в новый проект и убедитесь, что они также добавляются в проект VS.
+
+6. Построение и тестирование.
+
+## Обновление до 2.6.0 от 2.5.0
+
+В окне Обозреватель решений Visual Studio:
+
+1. Создайте новый Apache Cordova WP7 или WP8 2.6.0 проекта.
+
+2. Скопируйте содержимое вашего `www` каталога в новый проект и убедитесь, что эти элементы добавляются в проект VS.
+
+3. Обновить ваш HTML, чтобы использовать новый `cordova-2.6.0.js` файл.
+
+4. Скопируйте и перезаписать любой экран-заставку, или изображения значка.
+
+5. Копирование через любые плагины от `plugins` каталога в новый проект и убедитесь, что они также добавляются в проект VS.
+
+6. Построение и тестирование.
+
+## Обновление до 2.5.0 с 2.4.0
+
+В окне Обозреватель решений Visual Studio:
+
+1. Создайте новый Apache Cordova WP7 или WP8 2.5.0 проекта.
+
+2. Скопируйте содержимое вашего `www` каталога в новый проект и убедитесь, что эти элементы добавляются в проект VS.
+
+3. Обновить ваш HTML, чтобы использовать новый `cordova-2.5.0.js` файл.
+
+4. Скопируйте и перезаписать любой экран-заставку, или изображения значка.
+
+5. Копирование через любые плагины от `plugins` каталога в новый проект и убедитесь, что они также добавляются в проект VS.
+
+6. Построение и тестирование.
+
+## Обновление до 2.4.0 от 2.3.0
+
+В окне Обозреватель решений Visual Studio:
+
+1. Создайте новый Apache Cordova WP7 или WP8 2.4.0 проекта.
+
+2. Скопируйте содержимое вашего `www` каталога в новый проект и убедитесь, что эти элементы добавляются в проект VS.
+
+3. Обновить ваш HTML, чтобы использовать новый `cordova-2.4.0.js` файл.
+
+4. Скопируйте и перезаписать любой экран-заставку, или изображения значка.
+
+5. Копирование через любые плагины от `plugins` каталога в новый проект и убедитесь, что они также добавляются в проект VS.
+
+6. Построение и тестирование.
+
+## Обновление до 2.3.0 от 2.2.0
+
+В окне Обозреватель решений Visual Studio:
+
+1. Создайте новый проект Apache Cordova 2.3.0 для WP7.
+
+2. Скопируйте содержимое вашего `www` каталога в новый проект и убедитесь, что эти элементы добавляются в проект VS.
+
+3. Обновить ваш HTML, чтобы использовать новый `cordova-2.3.0.js` файл.
+
+4. Скопируйте и перезаписать любой экран-заставку, или изображения значка.
+
+5. Копирование через любые плагины от `plugins` каталога в новый проект и убедитесь, что они также добавляются в проект VS.
+
+6. Построение и тестирование.
+
+## Обновление до 2.2.0 из 2.1.0
+
+В окне Обозреватель решений Visual Studio:
+
+1. Создайте новый проект Apache Cordova 2.2.0 для WP7.
+
+2. Скопируйте содержимое вашего `www` каталога в новый проект и убедитесь, что эти элементы добавляются в проект VS.
+
+3. Обновить ваш HTML, чтобы использовать новый `cordova-2.2.0.js` файл.
+
+4. Скопируйте и перезаписать любой экран-заставку, или изображения значка.
+
+5. Копирование через любые плагины от `plugins` каталога в новый проект и убедитесь, что они также добавляются в проект VS.
+
+6. Построение и тестирование.
+
+## Обновление до 2.1.0 с 2.0.0
+
+В окне Обозреватель решений Visual Studio:
+
+1. Создайте новый проект Apache Cordova 2.1.0 для WP7.
+
+2. Скопируйте содержимое вашего `www` каталога в новый проект и убедитесь, что эти элементы добавляются в проект VS.
+
+3. Обновить ваш HTML, чтобы использовать новый `cordova-2.1.0.js` файл.
+
+4. Скопируйте и перезаписать любой экран-заставку, или изображения значка.
+
+5. Копирование через любые плагины от `plugins` каталога в новый проект и убедитесь, что они также добавляются в проект VS.
+
+6. Построение и тестирование.
+
+## Обновление до 2.0.0 от 1.9.0
+
+Там были значительные изменения в структуре проекта WP7 в Apache Cordova 2.0.0, которые делают это обновления немного сложнее, другие. По существу это не обновления, но создание нового проекта и скопируйте из существующих исходных файлов.
+
+В окне Обозреватель решений Visual Studio:
+
+1. Создайте новый проект Apache Cordova 2.0 для WP7.
+
+2. Скопируйте содержимое вашего `www` каталог в новый проект и будьте уверены, эти элементы добавляются в проект VS.
+
+3. Обновить ваш HTML, чтобы использовать новый `cordova-2.0.0.js` файл.
+
+4. Скопируйте и перезаписать любой экран-заставку, или значок изображения.
+
+5. Скопируйте любые плагины от `plugins` каталог на новый проект и убедитесь, что они также добавляются в проект VS.
+
+6. Построение и тестирование.
+
+## Обновление до 1.9.0 от 1.8.0
+
+В окне Обозреватель решений Visual Studio:
+
+1. Удалить `GapLib/WP7CordovaClassLib.dll` из вашего проекта.
+
+2. Удалите ссылку на `WP7CordovaClassLib` в каталоге **ссылок** .
+
+3. Щелкните правой кнопкой мыши **ссылки** и выберите **Добавить ссылку**.
+
+4. Перейдите к новое распределение и добавить `WP7CordovaClassLib.dll` файл.
+
+ **Примечание**: вы можете просмотреть версию библиотеки DLL, щелкнув правой кнопкой мыши на ссылку и выбрав **свойства**.
+
+5. Скопируйте новый `cordova-1.9.0.js` в ваш проект. (Убедитесь, что он помечен как содержимого.)
+
+6. Обновить ваш HTML, чтобы использовать новый `cordova-1.9.0.js` файл.
+
+## Обновление до 1.8.0 от 1.7.0
+
+В окне Обозреватель решений Visual Studio:
+
+1. Удалить `GapLib/WP7CordovaClassLib.dll` из вашего проекта.
+
+2. Удалите ссылку на `WP7CordovaClassLib` в каталоге **ссылок** .
+
+3. Щелкните правой кнопкой мыши **ссылки** и выберите **Добавить ссылку**.
+
+4. Перейдите к новое распределение и добавить `WP7CordovaClassLib.dll` файл.
+
+ **Примечание**: вы можете просмотреть версию библиотеки DLL, щелкнув правой кнопкой мыши на ссылку и выбрав **свойства**.
+
+5. Скопируйте новый `cordova-1.8.0.js` в ваш проект. (Убедитесь, что он помечен как содержимого.)
+
+6. Обновить ваш HTML, чтобы использовать новый `cordova-1.8.0.js` файл.
+
+## Обновление до версии 1.7.0 от 1.6.0
+
+В окне Обозреватель решений Visual Studio:
+
+1. Удалить `GapLib/WP7CordovaClassLib.dll` из вашего проекта.
+
+2. Удалите ссылку на `WP7CordovaClassLib` в каталоге **ссылок** .
+
+3. Щелкните правой кнопкой мыши **ссылки** и выберите **Добавить ссылку**.
+
+4. Перейдите к новое распределение и добавить `WP7CordovaClassLib.dll` файл.
+
+ **Примечание**: вы можете просмотреть версию библиотеки DLL, щелкнув правой кнопкой мыши на ссылку и выбрав **свойства**.
+
+5. Скопируйте новый `cordova-1.7.0.js` в ваш проект. (Убедитесь, что он помечен как содержимого.)
+
+6. Обновить ваш HTML, чтобы использовать новый `cordova-1.7.0.js` файл.
+
+## Обновление до 1.6.1 от 1.6.0
+
+В окне Обозреватель решений Visual Studio:
+
+1. Удалить `GapLib/WP7CordovaClassLib.dll` из вашего проекта.
+
+2. Удалите ссылку на `WP7CordovaClassLib` в каталоге **ссылок** .
+
+3. Щелкните правой кнопкой мыши **ссылки** и выберите **Добавить ссылку**.
+
+4. Перейдите к новое распределение и добавить `WP7CordovaClassLib.dll` файл.
+
+ **Примечание**: вы можете просмотреть версию библиотеки DLL, щелкнув правой кнопкой мыши на ссылку и выбрав **свойства**.
+
+5. Скопируйте новый `cordova-1.6.1.js` в ваш проект. (Убедитесь, что он помечен как содержимого.)
+
+6. Обновить ваш HTML, чтобы использовать новый `cordova-1.6.1.js` файл.
+
+## Обновление до 1.6.0 от 1.5.0
+
+В окне Обозреватель решений Visual Studio:
+
+1. Удалить `GapLib/WP7CordovaClassLib.dll` из вашего проекта.
+
+2. Удалите ссылку на `WP7CordovaClassLib` в каталоге **ссылок** .
+
+3. Щелкните правой кнопкой мыши **ссылки** и выберите **Добавить ссылку**.
+
+4. Перейдите к новое распределение и добавить `WP7CordovaClassLib.dll` файл.
+
+ **Примечание**: вы можете просмотреть версию библиотеки DLL, щелкнув правой кнопкой мыши на ссылку и выбрав **свойства**.
+
+5. Скопируйте новый `cordova-1.6.0.js` в ваш проект. (Убедитесь, что он помечен как содержимого.)
+
+6. Обновить ваш HTML, чтобы использовать новый `cordova-1.6.0.js` файл.
+
+## Обновление до 1.5.0 от 1.4.0
+
+В окне Обозреватель решений Visual Studio:
+
+1. Удалить `GapLib/WP7CordovaClassLib.dll` из вашего проекта.
+
+2. Удалите ссылку на `WP7CordovaClassLib` в каталоге **ссылок** .
+
+3. Щелкните правой кнопкой мыши **ссылки** и выберите **Добавить ссылку**.
+
+4. Перейдите к новое распределение и добавить `WP7CordovaClassLib.dll` файл.
+
+ **Примечание**: вы можете просмотреть версию библиотеки DLL, щелкнув правой кнопкой мыши на ссылку и выбрав **свойства**.
+
+5. Скопируйте новый `cordova-1.5.0.js` в ваш проект. (Убедитесь, что он помечен как содержимого.)
+
+6. Обновить ваш HTML, чтобы использовать новый `cordova-1.5.0.js` файл.
+
+## Обновление до 1.4.0 от 1.3.0
+
+В окне Обозреватель решений Visual Studio:
+
+1. Удалить `GapLib/WP7CordovaClassLib.dll` из вашего проекта.
+
+2. Удалите ссылку на `WP7CordovaClassLib` в каталоге **ссылок** .
+
+3. Щелкните правой кнопкой мыши **ссылки** и выберите **Добавить ссылку**.
+
+4. Перейдите к новое распределение и добавить `WP7CordovaClassLib.dll` файл.
+
+ **Примечание**: вы можете просмотреть версию библиотеки DLL, щелкнув правой кнопкой мыши на ссылку и выбрав **свойства**.
+
+5. Скопируйте новый `cordova-1.4.0.js` в ваш проект. (Убедитесь, что он помечен как содержимого.)
+
+6. Обновить ваш HTML, чтобы использовать новый `cordova-1.4.0.js` файл.
+
+## Обновление до 1.3.0 от 1.2.0
+
+В окне Обозреватель решений Visual Studio:
+
+1. Удалить `GapLib/WP7CordovaClassLib.dll` из вашего проекта.
+
+2. Удалите ссылку на `WP7CordovaClassLib` в каталоге **ссылок** .
+
+3. Щелкните правой кнопкой мыши **ссылки** и выберите **Добавить ссылку**.
+
+4. Перейдите к новое распределение и добавить `WP7CordovaClassLib.dll` файл.
+
+ **Примечание**: вы можете просмотреть версию библиотеки DLL, щелкнув правой кнопкой мыши на ссылку и выбрав **свойства**.
+
+5. Скопируйте новый `cordova-1.3.0.js` в ваш проект. (Убедитесь, что он помечен как содержимого.)
+
+6. Обновить ваш HTML, чтобы использовать новый `cordova-1.3.0.js` файл.
+
+## Обновление до 1.2.0 от 1.1.0
+
+В окне Обозреватель решений Visual Studio:
+
+1. Удалить `GapLib/WP7CordovaClassLib.dll` из вашего проекта.
+
+2. Удалите ссылку на `WP7CordovaClassLib` в каталоге **ссылок** .
+
+3. Щелкните правой кнопкой мыши **ссылки** и выберите **Добавить ссылку**.
+
+4. Перейдите к новое распределение и добавить `WP7CordovaClassLib.dll` файл.
+
+ **Примечание**: вы можете просмотреть версию библиотеки DLL, щелкнув правой кнопкой мыши на ссылку и выбрав **свойства**.
+
+5. Скопируйте новый `cordova-1.2.0.js` в ваш проект. (Убедитесь, что он помечен как содержимого.)
+
+6. Обновить ваш HTML, чтобы использовать новый `cordova-1.2.0.js` файл.
+
+## Обновление до 1.1.0 с 1.0.0
+
+В окне Обозреватель решений Visual Studio:
+
+1. Удалить `GapLib/WP7CordovaClassLib.dll` из вашего проекта.
+
+2. Удалите ссылку на `WP7CordovaClassLib` в каталоге **ссылок** .
+
+3. Щелкните правой кнопкой мыши **ссылки** и выберите **Добавить ссылку**.
+
+4. Перейдите на новый дистрибутив и добавьте `WP7CordovaClassLib.dll` файл.
+
+ **Примечание**: вы можете просмотреть версию библиотеки DLL, щелкнув правой кнопкой мыши на ссылку и выбрав **свойства**.
+
+5. Скопируйте новый `cordova-1.1.0.js` в ваш проект. (Убедитесь, что он помечен как содержимого.)
+
+6. Обновить ваш HTML, чтобы использовать новый `cordova-1.1.0.js` файл.
\ No newline at end of file
diff --git a/docs/ru/5.0.0/guide/platforms/wp8/vmware.md b/docs/ru/5.0.0/guide/platforms/wp8/vmware.md
new file mode 100644
index 0000000..66338e7
--- /dev/null
+++ b/docs/ru/5.0.0/guide/platforms/wp8/vmware.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.
+---
+
+# Настройка VMWare Fusion
+
+В этом разделе показано, как настроить VMWare Fusion на Mac, так чтобы вы смогли использовать Cordova для создания приложений для Windows Phone.
+
+[Microsoft Developer Network][1] предоставляет общие инструкции для запуска Windows под VMWare Fusion. После установки Windows, выполните следующие действия:
+
+ [1]: http://msdn.microsoft.com/en-US/library/windows/apps/jj945426
+
+1. В VMWare Fusion выберите образ диска Windows 8 который вы подготовили и выберите **Параметры**.
+
+2. Выберите параметры конфигурации **Процессоры и память** . Не забудьте указать *два* процессорных ядра и выберите **Позволить приложения гипервизора в этой виртуальной машины**:
+
+ ![][2]
+
+ Один только эмулятор Windows Phone использует половину гигабайта памяти, поэтому в целом вы должны зарезервировать минимум 2 ГБ для VMWare.
+
+3. Выберите **Дополнительные** параметры. Выберите вариант **Предпочитаемая технология виртуализации : Intel VT-x с EPT**:
+
+ ![][3]
+
+4. Измените файл *.vmx* , чтобы добавить или изменить следующие настройки:
+
+ Hypervisor.CPUID.v0 = «FALSE» mce.enable = «TRUE» vhv.enable = «TRUE»
+
+
+ [2]: img/guide/platforms/wp8/vmware_memory_opts.png
+ [3]: img/guide/platforms/wp8/vmware_advanced_opts.png
+
+После выполнения этих шагов, вы будете готовы к установке Windows Phone SDK. Смотрите Руководство для платформы Windows Phone 8 для подробностей.
\ No newline at end of file
diff --git a/docs/ru/5.0.0/guide/platforms/wp8/webview.md b/docs/ru/5.0.0/guide/platforms/wp8/webview.md
new file mode 100644
index 0000000..b688e31
--- /dev/null
+++ b/docs/ru/5.0.0/guide/platforms/wp8/webview.md
@@ -0,0 +1,42 @@
+---
+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.
+---
+
+# Windows Phone 8.0 WebViews
+
+В этом руководстве показано, как внедрить компонент Cordova с поддержкой WebView в другое, большее, приложение Windows Phone 8.0.
+
+Следовать этим инструкциям, убедитесь, что у вас есть дистрибутив последней версии Cordova. Скачать его с [cordova.apache.org](http://cordova.apache.org) и разархивируйте пакет для Windows Phone 8.0 (cordova-wp8-*.zip).
+
+ 1. Перейдите к директории `wp8/framework` пакета и соберите решение `WPCordovaClassLib.sln` . Это создаст `Bin\Debug[Release]\WPCordovaClassLib.dll`.
+
+ 2. Скопируйте файл `WPCordovaClassLib.dll` в каталог `/libs` проект Windows Phone 8 и подключите `WPCordovaClassLib.dll` к вашему проекту через `Project->References->Add Reference` . Кроме того, можно напрямую ссылаться на файл `wp8/framework/WPCordovaClassLib.csproj`.
+
+ 3. Добавьте компонент `CordovaView` на страницу (например,`MainPage.xaml`).
+
+ xmlns:my="clr-namespace:WPCordovaClassLib;assembly=WPCordovaClassLib">
+ ...
+ <my:CordovaView HorizontalAlignment="Stretch" Margin="0,0,0,0"
+ StartPageUri="html/index.html" x:Name="CordovaView" VerticalAlignment="Stretch" />
+
+
+ 4. Скопируйте `common/www/cordova.js` и разметите его вместе с HTML и JavaScript файлами приложения в каталоге `html` проекта Windows Phone 8 и добавьте новые файлы в ваш проект.
+
+ 5. Скопируйте `wp8/template/config.xml` в корневой каталог проекта и
+
+Инструкции выше подключат только основные компоненты Cordova, см Использование Plugman для управления расширениями для того, чтобы подключить плагины Cordova.
\ No newline at end of file
diff --git a/docs/ru/5.0.0/guide/support/index.md b/docs/ru/5.0.0/guide/support/index.md
new file mode 100644
index 0000000..87cbbd1
--- /dev/null
+++ b/docs/ru/5.0.0/guide/support/index.md
@@ -0,0 +1,861 @@
+---
+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.
+---
+
+# Поддерживаемые Платформы
+
+Ниже приведен набор инструментов разработки и устройства интерфейсы API, доступные для каждой мобильной платформы. Устройство API-интерфейсы, перечисленные здесь предоставляются основные плагины, дополнительные интерфейсы API доступны через [сторонних плагинов][1]. Заголовки столбцов отображаются имена стенографию CLI.
+
+ [1]: http://plugins.cordova.io
+
+<!-- START HTML -->
+
+<table class="compat" width="100%">
+ <tr>
+ <th>
+ </td> <th>
+ <tt>amazon-fireos</tt>
+ </th>
+
+ <th>
+ <tt>android</tt>
+ </th>
+
+ <th>
+ <tt>blackberry10</tt>
+ </th>
+
+ <th>
+ <tt>Firefox OS</tt>
+ </th>
+
+ <th>
+ <tt>iOS</tt>
+ </th>
+
+ <th>
+ <tt>Ubuntu</tt>
+ </th>
+
+ <th>
+ <tt>WP8</tt><br />(Windows Phone 8)
+ </th>
+
+ <th>
+ <tt>Windows</tt><br />(8.0, 8.1,<br />Телефон 8.1)
+ </th>
+
+ <th>
+ <tt>Tizen</tt>
+ </th></tr> </thead>
+
+ <tr>
+ <th>
+ <a href="guide_cli_index.md.html">Cordova <br />CLI</a>
+ </th>
+
+ <td data-col="amazon-fireos" class="y">
+ Mac, Windows, Linux
+ </td>
+
+ <td data-col="android" class="y">
+ Mac, Windows, Linux
+ </td>
+
+ <td data-col="blackberry10" class="y">
+ Mac, Windows
+ </td>
+
+ <td data-col="firefoxos" class="y">
+ Mac, Windows, Linux
+ </td>
+
+ <td data-col="ios" class="y">
+ Mac
+ </td>
+
+ <td data-col="ubuntu" class="y">
+ Ubuntu
+ </td>
+
+ <td data-col="winphone8" class="y">
+ Windows
+ </td>
+
+ <td data-col="win8" class="y">
+ </td>
+
+ <td data-col="tizen" class="n">
+ </td>
+ </tr>
+
+ <tr>
+ <th>
+ <a href="guide_hybrid_webviews_index.md.html">Встроенный<br />WebView</a>
+ </th>
+
+ <td data-col="amazon-fireos" class="y">
+ <a href="guide_platforms_amazonfireos_webview.md.html">(см. подробности)</a>
+ </td>
+
+ <td data-col="android" class="y">
+ <a href="guide_platforms_android_webview.md.html">(см. подробности)</a>
+ </td>
+
+ <td data-col="blackberry10" class="n">
+ </td>
+
+ <td data-col="firefoxos" class="n">
+ </td>
+
+ <td data-col="ios" class="y">
+ <a href="guide_platforms_ios_webview.md.html">(см. подробности)</a>
+ </td>
+
+ <td data-col="ubuntu" class="y">
+ </td>
+
+ <td data-col="winphone8" class="n">
+ </td>
+
+ <td data-col="win8" class="n">
+ </td>
+
+ <td data-col="tizen" class="n">
+ </td>
+ </tr>
+
+ <tr>
+ <th>
+ <a href="guide_hybrid_plugins_index.md.html">Подключаемый модуль<br />Интерфейс</a>
+ </th>
+
+ <td data-col="amazon-fireos" class="y">
+ <a href="guide_platforms_amazonfireos_plugin.md.html">(см. подробности)</a>
+ </td>
+
+ <td data-col="android" class="y">
+ <a href="guide_platforms_android_plugin.md.html">(см. подробности)</a>
+ </td>
+
+ <td data-col="blackberry10" class="y">
+ <a href="guide_platforms_blackberry10_plugin.md.html">(см. подробности)</a>
+ </td>
+
+ <td data-col="firefoxos" class="n">
+ </td>
+
+ <td data-col="ios" class="y">
+ <a href="guide_platforms_ios_plugin.md.html">(см. подробности)</a>
+ </td>
+
+ <td data-col="ubuntu" class="y">
+ </td>
+
+ <td data-col="winphone8" class="y">
+ <a href="guide_platforms_wp8_plugin.md.html">(см. подробности)</a>
+ </td>
+
+ <td data-col="win8" class="y">
+ </td>
+
+ <td data-col="tizen" class="n">
+ </td>
+ </tr>
+
+ <tr>
+ <th>
+ </th>
+
+ <th colspan="20">
+ API платформы
+ </th>
+ </tr>
+
+ <tr>
+ <th>
+ <a href="https://www.npmjs.com/package/cordova-plugin-device-motion">Accelerometer</a>
+ </th>
+
+ <td data-col="amazon-fireos" class="y">
+ </td>
+
+ <td data-col="android" class="y">
+ </td>
+
+ <td data-col="blackberry10" class="y">
+ </td>
+
+ <td data-col="firefoxos" class="y">
+ </td>
+
+ <td data-col="ios" class="y">
+ </td>
+
+ <td data-col="ubuntu" class="y">
+ </td>
+
+ <td data-col="winphone8" class="y">
+ </td>
+
+ <td data-col="win8" class="y">
+ </td>
+
+ <td data-col="tizen" class="y">
+ </td>
+ </tr>
+
+ <tr>
+ <th>
+ <a href="https://www.npmjs.com/package/cordova-plugin-battery-status">BatteryStatus</a>
+ </th>
+
+ <td data-col="amazon-fireos" class="y">
+ </td>
+
+ <td data-col="android" class="y">
+ </td>
+
+ <td data-col="blackberry10" class="y">
+ </td>
+
+ <td data-col="firefoxos" class="y">
+ </td>
+
+ <td data-col="ios" class="y">
+ </td>
+
+ <td data-col="ubuntu" class="n">
+ </td>
+
+ <td data-col="winphone8" class="y">
+ </td>
+
+ <td data-col="win8" class="y">
+ * только Windows Phone 8.1
+ </td>
+
+ <td data-col="tizen" class="y">
+ </td>
+ </tr>
+
+ <tr>
+ <th>
+ <a href="https://www.npmjs.com/package/cordova-plugin-camera">Камера</a>
+ </th>
+
+ <td data-col="amazon-fireos" class="y">
+ </td>
+
+ <td data-col="android" class="y">
+ </td>
+
+ <td data-col="blackberry10" class="y">
+ </td>
+
+ <td data-col="firefoxos" class="y">
+ </td>
+
+ <td data-col="ios" class="y">
+ </td>
+
+ <td data-col="ubuntu" class="y">
+ </td>
+
+ <td data-col="winphone8" class="y">
+ </td>
+
+ <td data-col="win8" class="y">
+ </td>
+
+ <td data-col="tizen" class="y">
+ </td>
+ </tr>
+
+ <tr>
+ <th>
+ <a href="https://www.npmjs.com/package/cordova-plugin-media-capture">Съемка</a>
+ </th>
+
+ <td data-col="amazon-fireos" class="y">
+ </td>
+
+ <td data-col="android" class="y">
+ </td>
+
+ <td data-col="blackberry10" class="y">
+ </td>
+
+ <td data-col="firefoxos" class="n">
+ </td>
+
+ <td data-col="ios" class="y">
+ </td>
+
+ <td data-col="ubuntu" class="y">
+ </td>
+
+ <td data-col="winphone8" class="y">
+ </td>
+
+ <td data-col="win8" class="y">
+ </td>
+
+ <td data-col="tizen" class="n">
+ </td>
+ </tr>
+
+ <tr>
+ <th>
+ <a href="https://www.npmjs.com/package/cordova-plugin-device-orientation">Компас</a>
+ </th>
+
+ <td data-col="amazon-fireos" class="y">
+ </td>
+
+ <td data-col="android" class="y">
+ </td>
+
+ <td data-col="blackberry10" class="y">
+ </td>
+
+ <td data-col="firefoxos" class="n">
+ </td>
+
+ <td data-col="ios" class="y">
+ (3GS+)
+ </td>
+
+ <td data-col="ubuntu" class="y">
+ </td>
+
+ <td data-col="winphone8" class="y">
+ </td>
+
+ <td data-col="win8" class="y">
+ </td>
+
+ <td data-col="tizen" class="y">
+ </td>
+ </tr>
+
+ <tr>
+ <th>
+ <a href="https://www.npmjs.com/package/cordova-plugin-network-information">Подключение</a>
+ </th>
+
+ <td data-col="amazon-fireos" class="y">
+ </td>
+
+ <td data-col="android" class="y">
+ </td>
+
+ <td data-col="blackberry10" class="y">
+ </td>
+
+ <td data-col="firefoxos" class="n">
+ </td>
+
+ <td data-col="ios" class="y">
+ </td>
+
+ <td data-col="ubuntu" class="y">
+ </td>
+
+ <td data-col="winphone8" class="y">
+ </td>
+
+ <td data-col="win8" class="y">
+ </td>
+
+ <td data-col="tizen" class="y">
+ </td>
+ </tr>
+
+ <tr>
+ <th>
+ <a href="https://www.npmjs.com/package/cordova-plugin-contacts">Контакты</a>
+ </th>
+
+ <td data-col="amazon-fireos" class="y">
+ </td>
+
+ <td data-col="android" class="y">
+ </td>
+
+ <td data-col="blackberry10" class="y">
+ </td>
+
+ <td data-col="firefoxos" class="y">
+ </td>
+
+ <td data-col="ios" class="y">
+ </td>
+
+ <td data-col="ubuntu" class="y">
+ </td>
+
+ <td data-col="winphone8" class="y">
+ </td>
+
+ <td data-col="win8" class="p">
+ частично
+ </td>
+
+ <td data-col="tizen" class="n">
+ </td>
+ </tr>
+
+ <tr>
+ <th>
+ <a href="https://www.npmjs.com/package/cordova-plugin-device">Устройство</a>
+ </th>
+
+ <td data-col="amazon-fireos" class="y">
+ </td>
+
+ <td data-col="android" class="y">
+ </td>
+
+ <td data-col="blackberry10" class="y">
+ </td>
+
+ <td data-col="firefoxos" class="y">
+ </td>
+
+ <td data-col="ios" class="y">
+ </td>
+
+ <td data-col="ubuntu" class="y">
+ </td>
+
+ <td data-col="winphone8" class="y">
+ </td>
+
+ <td data-col="win8" class="y">
+ </td>
+
+ <td data-col="tizen" class="y">
+ </td>
+ </tr>
+
+ <tr>
+ <th>
+ <a href="cordova_events_events.md.html">События</a>
+ </th>
+
+ <td data-col="amazon-fireos" class="y">
+ </td>
+
+ <td data-col="android" class="y">
+ </td>
+
+ <td data-col="blackberry10" class="y">
+ </td>
+
+ <td data-col="firefoxos" class="n">
+ </td>
+
+ <td data-col="ios" class="y">
+ </td>
+
+ <td data-col="ubuntu" class="y">
+ </td>
+
+ <td data-col="winphone8" class="y">
+ </td>
+
+ <td data-col="win8" class="y">
+ </td>
+
+ <td data-col="tizen" class="y">
+ </td>
+ </tr>
+
+ <tr>
+ <th>
+ <a href="https://www.npmjs.com/package/cordova-plugin-file">Файл</a>
+ </th>
+
+ <td data-col="amazon-fireos" class="y">
+ </td>
+
+ <td data-col="android" class="y">
+ </td>
+
+ <td data-col="blackberry10" class="y">
+ </td>
+
+ <td data-col="firefoxos" class="n">
+ </td>
+
+ <td data-col="ios" class="y">
+ </td>
+
+ <td data-col="ubuntu" class="y">
+ </td>
+
+ <td data-col="winphone8" class="y">
+ </td>
+
+ <td data-col="win8" class="y">
+ </td>
+
+ <td data-col="tizen" class="n">
+ </td>
+ </tr>
+
+ <tr>
+ <th>
+ <a href="https://www.npmjs.com/package/cordova-plugin-file-transfer">Передача файлов</a>
+ </th>
+
+ <td data-col="amazon-fireos" class="y">
+ </td>
+
+ <td data-col="android" class="y">
+ </td>
+
+ <td data-col="blackberry10" class="y">
+ * Не поддерживает onprogress не прервать
+ </td>
+
+ <td data-col="firefoxos" class="n">
+ </td>
+
+ <td data-col="ios" class="y">
+ </td>
+
+ <td data-col="ubuntu" class="n">
+ </td>
+
+ <td data-col="winphone8" class="y">
+ * Не поддерживает onprogress не прервать
+ </td>
+
+ <td data-col="win8" class="y">
+ * Не поддерживает onprogress не прервать
+ </td>
+
+ <td data-col="tizen" class="n">
+ </td>
+ </tr>
+
+ <tr>
+ <th>
+ <a href="https://www.npmjs.com/package/cordova-plugin-geolocation">Географическое положение</a>
+ </th>
+
+ <td data-col="amazon-fireos" class="y">
+ </td>
+
+ <td data-col="android" class="y">
+ </td>
+
+ <td data-col="blackberry10" class="y">
+ </td>
+
+ <td data-col="firefoxos" class="y">
+ </td>
+
+ <td data-col="ios" class="y">
+ </td>
+
+ <td data-col="ubuntu" class="y">
+ </td>
+
+ <td data-col="winphone8" class="y">
+ </td>
+
+ <td data-col="win8" class="y">
+ </td>
+
+ <td data-col="tizen" class="y">
+ </td>
+ </tr>
+
+ <tr>
+ <th>
+ <a href="https://www.npmjs.com/package/cordova-plugin-globalization">Глобализация</a>
+ </th>
+
+ <td data-col="amazon-fireos" class="y">
+ </td>
+
+ <td data-col="android" class="y">
+ </td>
+
+ <td data-col="blackberry10" class="y">
+ </td>
+
+ <td data-col="firefoxos" class="n">
+ </td>
+
+ <td data-col="ios" class="y">
+ </td>
+
+ <td data-col="ubuntu" class="y">
+ </td>
+
+ <td data-col="winphone8" class="y">
+ </td>
+
+ <td data-col="win8" class="y">
+ </td>
+
+ <td data-col="tizen" class="n">
+ </td>
+ </tr>
+
+ <tr>
+ <th>
+ <a href="https://www.npmjs.com/package/cordova-plugin-inappbrowser">Внутренний браузер</a>
+ </th>
+
+ <td data-col="amazon-fireos" class="y">
+ </td>
+
+ <td data-col="android" class="y">
+ </td>
+
+ <td data-col="blackberry10" class="y">
+ </td>
+
+ <td data-col="firefoxos" class="n">
+ </td>
+
+ <td data-col="ios" class="y">
+ </td>
+
+ <td data-col="ubuntu" class="y">
+ </td>
+
+ <td data-col="winphone8" class="y">
+ </td>
+
+ <td data-col="win8" class="p">
+ использует iframe
+ </td>
+
+ <td data-col="tizen" class="n">
+ </td>
+ </tr>
+
+ <tr>
+ <th>
+ <a href="https://www.npmjs.com/package/cordova-plugin-media">Аудио и видео</a>
+ </th>
+
+ <td data-col="amazon-fireos" class="y">
+ </td>
+
+ <td data-col="android" class="y">
+ </td>
+
+ <td data-col="blackberry10" class="y">
+ </td>
+
+ <td data-col="firefoxos" class="n">
+ </td>
+
+ <td data-col="ios" class="y">
+ </td>
+
+ <td data-col="ubuntu" class="y">
+ </td>
+
+ <td data-col="winphone8" class="y">
+ </td>
+
+ <td data-col="win8" class="y">
+ </td>
+
+ <td data-col="tizen" class="y">
+ </td>
+ </tr>
+
+ <tr>
+ <th>
+ <a href="https://www.npmjs.com/package/cordova-plugin-dialogs">Уведомление</a>
+ </th>
+
+ <td data-col="amazon-fireos" class="y">
+ </td>
+
+ <td data-col="android" class="y">
+ </td>
+
+ <td data-col="blackberry10" class="y">
+ </td>
+
+ <td data-col="firefoxos" class="n">
+ </td>
+
+ <td data-col="ios" class="y">
+ </td>
+
+ <td data-col="ubuntu" class="y">
+ </td>
+
+ <td data-col="winphone8" class="y">
+ </td>
+
+ <td data-col="win8" class="y">
+ </td>
+
+ <td data-col="tizen" class="y">
+ </td>
+ </tr>
+
+ <tr>
+ <th>
+ <a href="https://www.npmjs.com/package/cordova-plugin-splashscreen">Заставка</a>
+ </th>
+
+ <td data-col="amazon-fireos" class="y">
+ </td>
+
+ <td data-col="android" class="y">
+ </td>
+
+ <td data-col="blackberry10" class="y">
+ </td>
+
+ <td data-col="firefoxos" class="n">
+ </td>
+
+ <td data-col="ios" class="y">
+ </td>
+
+ <td data-col="ubuntu" class="y">
+ </td>
+
+ <td data-col="winphone8" class="y">
+ </td>
+
+ <td data-col="win8" class="y">
+ </td>
+
+ <td data-col="tizen" class="n">
+ </td>
+ </tr>
+
+ <tr>
+ <th>
+ <a href="https://www.npmjs.com/package/cordova-plugin-statusbar">Строка состояния</a>
+ </th>
+
+ <td data-col="amazon-fireos" class="n">
+ </td>
+
+ <td data-col="android" class="y">
+ </td>
+
+ <td data-col="blackberry10" class="n">
+ </td>
+
+ <td data-col="firefoxos" class="n">
+ </td>
+
+ <td data-col="ios" class="y">
+ </td>
+
+ <td data-col="ubuntu" class="n">
+ </td>
+
+ <td data-col="winphone8" class="y">
+ </td>
+
+ <td data-col="win8" class="y">
+ только Windows Phone 8.1
+ </td>
+
+ <td data-col="tizen" class="n">
+ </td>
+ </tr>
+
+ <tr>
+ <th>
+ <a href="cordova_storage_storage.md.html">Хранилище</a>
+ </th>
+
+ <td data-col="amazon-fireos" class="y">
+ </td>
+
+ <td data-col="android" class="y">
+ </td>
+
+ <td data-col="blackberry10" class="y">
+ </td>
+
+ <td data-col="firefoxos" class="n">
+ </td>
+
+ <td data-col="ios" class="y">
+ </td>
+
+ <td data-col="ubuntu" class="y">
+ </td>
+
+ <td data-col="winphone8" class="y">
+ localStorage & indexedDB
+ </td>
+
+ <td data-col="win8" class="y">
+ localStorage & indexedDB
+ </td>
+
+ <td data-col="tizen" class="y">
+ </td>
+ </tr>
+
+ <tr>
+ <th>
+ <a href="https://www.npmjs.com/package/cordova-plugin-vibration">Вибрация</a>
+ </th>
+
+ <td data-col="amazon-fireos" class="y">
+ </td>
+
+ <td data-col="android" class="y">
+ </td>
+
+ <td data-col="blackberry10" class="y">
+ </td>
+
+ <td data-col="firefoxos" class="y">
+ </td>
+
+ <td data-col="ios" class="y">
+ </td>
+
+ <td data-col="ubuntu" class="n">
+ </td>
+
+ <td data-col="winphone8" class="y">
+ </td>
+
+ <td data-col="win8" class="y">
+ * только Windows Phone 8.1
+ </td>
+
+ <td data-col="tizen" class="n">
+ </td>
+ </tr></table>
+
+ <!-- END HTML -->
\ No newline at end of file
diff --git a/docs/ru/5.0.0/index.md b/docs/ru/5.0.0/index.md
new file mode 100644
index 0000000..5006cdf
--- /dev/null
+++ b/docs/ru/5.0.0/index.md
@@ -0,0 +1,153 @@
+---
+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.
+---
+
+<div id="home">
+ <h1>
+ Инструкции
+ </h1>
+
+ <ul>
+ <li>
+ <h2>
+ Введение
+ </h2>
+
+ <span>Начните здесь, если вы новичок в Кордове. Включает в себя установку и последующие шаги.</span>
+ </li>
+ <li>
+ <h2>
+ Руководство по поддерживаемым платформам
+ </h2>
+
+ <span>Таблица совместимости для всех основных функций.</span>
+ </li>
+ <li>
+ <h2>
+ Интерфейс командной строки
+ </h2>
+
+ <span>Создание, сборка и развертывание из командной строки.</span>
+ </li>
+ <li>
+ <h2>
+ Руководство по платформам
+ </h2>
+
+ <span>Настройка SDK каждой платформы и обновление проектов.</span>
+ </li>
+ <li>
+ <h2>
+ Использование Plugman для управления расширениями
+ </h2>
+
+ <span>Управление плагинами без CLI при использовании рабочего процесса по центру платформы.</span>
+ </li>
+ <li>
+ <h2>
+ Файл config.xml
+ </h2>
+
+ <span>Настройте функции вашего приложения.</span>
+ </li>
+ <li>
+ <h2>
+ Иконки и заставки
+ </h2>
+
+ <span>Настройка отображения изображений вашего приложения.</span>
+ </li>
+ <li>
+ <h2>
+ Интеграция WebViews
+ </h2>
+
+ <span>Добавление Cordova WebView в ваш проект.</span>
+ </li>
+ <li>
+ <h2>
+ Руководство по разработке расширений
+ </h2>
+
+ <span>Создайте свой первый плагин.</span>
+ </li>
+ <li>
+ <h2>
+ Руководство по конфиденциальности
+ </h2>
+
+ <span>Узнайте о важных проблемах конфиденциальности при работе с мобильными устройствами.</span>
+ </li>
+ <li>
+ <h2>
+ Руководство по безопасности
+ </h2>
+
+ <span>Информация и советы по созданию безопасных приложений.</span>
+ </li>
+ <li>
+ <h2>
+ Инструкция по доступу к внешним ресурсам
+ </h2>
+
+ <span>Разрешите приложению доступ к внешним ресурсам.</span>
+ </li>
+ <li>
+ <h2>
+ Хранилище
+ </h2>
+
+ <span>Обзор возможностей хранения данных, предоставляемых различными платформами.</span>
+ </li>
+ <li>
+ <h2>
+ Последующие шаги
+ </h2>
+
+ <span>Посмотрите на темы, которые интересуют новых разработчиков Cordova.</span>
+ </li>
+ <li>
+ <h2>
+ <a href="_index.html">Алфавитный указатель</a>
+ </h2>
+
+ <span>Полный список документации.</span>
+ </li>
+ </ul>
+
+ <h1>
+ Справочник по API
+ </h1>
+
+ <ul>
+ <li>
+ <h2>
+ События
+ </h2>
+
+ <span>Подключение к событиям платформы с использованием JavaScript.</span>
+ </li>
+ <li>
+ <h2>
+ API плагинов
+ </h2>
+
+ <span>Узнайте, какие плагины Cordova доступны для использования в вашем проекте.</span>
+ </li>
+ </ul>
+</div>
\ No newline at end of file
diff --git a/docs/ru/5.0.0/plugin_ref/plugman.md b/docs/ru/5.0.0/plugin_ref/plugman.md
new file mode 100644
index 0000000..c5df93d
--- /dev/null
+++ b/docs/ru/5.0.0/plugin_ref/plugman.md
@@ -0,0 +1,173 @@
+---
+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.
+---
+
+# Использование Plugman для управления расширениями
+
+Начиная с версии 3.0 Cordova реализует все API устройства как плагины и оставляет их по умолчанию отключенными. Она также поддерживает два различных способа добавления и удаления плагинов, в зависимости от вашего выбора рабочего процесса, как описано в разделе "Обзор":
+
+* Если вы используете кросс платформенный рабочий процесс, используйте утилиту CLI `cordova` для добавления плагинов, как описано в разделе "Интерфейс командной строки". CLI изменяет плагины для всех платформ одновременно.
+
+* Если вы используете платформо-ориентированный процесс разработки, вы используете низкоуровневый инструмент командной строки [Plugman][1], индивидуально для каждой целевой платформы.
+
+ [1]: https://github.com/apache/cordova-plugman/
+
+В этом разделе описывается утилита Plugman. Для более детальной информации об использовании Plugman как node модуля или изменения исходного кода см. [README файл в его репозитории][2].
+
+ [2]: https://github.com/apache/cordova-plugman/blob/master/README.md
+
+## Установка Plugman
+
+Чтобы установить plugman, вам потребуется установить [node.js][3] на свою машину. Затем можно запустить следующую команду в вашем окружении, чтобы установить plugman глобально, так чтобы он был доступен из любого каталога:
+
+ [3]: http://nodejs.org/
+
+ $ npm install -g plugman
+
+
+Вы также должны иметь `git` добавленный в переменную окружения `PATH`, для того чтобы иметь возможность устанавливать плагины непосредственно из удаленных репозитариев Git.
+
+**Подсказка**: Если вы обнаружили что после установки plugman с помощью `npm` вы по прежнему не можете запустить никакую из команд `plugman`,удостоверьтесь что вы добавили каталог `/npm/` в вашу переменную `PATH`.
+
+**Примечание**: этот шаг можно пропустить, если вы не хотите загрязнять глобальное пространство имен `npm`, устанавливая Plugman глобально. Если это ваш случай, то когда вы создаете проект Cordova с использованием командной строки, создастся каталог `node_modules` внутри вашего проекта, которая содержит Plugman. Посколько вы не установили глобально, вам необходимо вызывать `node` для каждой команды Plugman, к примеру `node
+./node_modules/plugman/main.js -version`. Остальная часть этой инструкции предполагает что вы установили Plugman глобально, что означает что вы можете вызывать его с использованием просто `plugman`.
+
+## Создайте проект Cordova
+
+Перед тем как использовать Plugman, вы должны создать проект Cordova. Вы можете сделать это либо с использование Интерфейса командной строки или с использованием низкоуровневых утилит командной строки. Инструкции по использованию утилит командной строки для создания вашего проекта, расположены в различных разделах "Инструменты командной строки" указанных на странице "Руководство по поддерживаемым платформам".
+
+## Добавление плагина
+
+После того как вы установили Plugman и создали проект Cordova, вы можете начать добавлять плагины к платформе с помощью:
+
+ $ plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin <name|url|path> [--plugins_dir <directory>] [--www <directory>] [--variable <name>=<value> [--variable <name>=<value> ...]]
+
+
+Используя минимальные параметры эта команда установит плагин в проект Cordova. Вы должны указать платформу и расположение проекта Cordоva для этой платформы. Также вы должны указать добавляемый плагин, с использованием различных форм параметра `--plugin`:
+
+* `name`: Имя каталога где расположено содержимое плагина. Имя должно соответствовать существующему каталогу расположенному по пути, указанному в параметре `--plugins_dir` (смотрите ниже за подробной информацией) или имени плагина в реестре плагинов Cordova.
+* `url`: URL начинающийся с https:// или git://, и указывающий на существующий репозиторий Git который можно клонировать, и который содержит файл `plugin.xml`. Содержимое этого репозитория будет скопировано в `--plugins_dir`.
+* `path`: Путь к каталогу, содержащему плагин, который включает в себя файл `plugin.xml`. Содержимое расположенное по этому пути будет скопировано в `--plugins_dir`.
+
+Другие параметры:
+
+* `--plugins_dir` по умолчанию, `<project>/cordova/plugins`, но может быть любым каталогом, котобый содержит подкаталог для каждого загруженного плагина.
+* `--www` поумолчанию каталог `www`, но может быть любой директорией которая будет использоваться проектом Cordova как каталог содержащий веб ресурсы приложения.
+* `--variable` позволяет указывать определенные переменные во время установки, для некоторых плагинов необходимо указывать ключи API или другие настраиваемые параметры. Обратитесь к [спецификации плагинов][4] для получения дополнительной информации.
+
+ [4]: plugin_ref_spec.md.html#Plugin%20Specification
+
+## Удаление плагина
+
+Для удаления плагина, вы должны просто указать флаг `--uninstall` и указать код плагина (ID плагина).
+
+ $ plugman --uninstall --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin <id> [--www <directory>] [--plugins_dir <directory>]
+
+
+## Команды справки
+
+Plugman поддерживает общую команду help которая может помочь вам если вы в тупике или испытываете проблемы. Она отобразит список доступных команд Plugman и их синтаксис:
+
+ plugman -help
+ plugman # same as above
+
+
+**Примечание**: `plugman -help` может показывать некоторые дополнительные команды по работе с реестром плагинов. Эти команды предназначены для разработчиков плагинов и могут быть не реализованы в реестрах плагинов третьих сторон.
+
+Вы также можете добавить флаг `--debug|-d` к любой команде Plugman для того чтобы запустить эту команду в диагностическом режиме, который будет отображать внутренние отладочные сообщения, по мере их формирования, что может помочь вам отследить проблемы, как например отсутствующие файлы в плагине.
+
+ # Adding Android battery-status plugin to "myProject":
+ plugman -d --platform android --project myProject --plugin cordova-plugin-battery-status
+
+
+Наконец, вы можете использовать флаг `--version|-v` для того чтобы узнать какую версию Plugman вы используете.
+
+ plugman -v
+
+
+## Действия с реестром плагинов
+
+Существует несколько команд plugman которые могут быть использованы для взаимодействия с [Реестром плагинов][5]. Пожалуйста обратите внимание что эти команды реестра специфичны для реестра плагинов *plugins.cordova.io* и могут не быть реализованы реестрами плагинов от посторонних поставщиков.
+
+ [5]: http://plugins.cordova.io
+
+### Поиск плагина
+
+Вы можете использовать Plugman для поиска в [Реестре плагинов][5] плагинов, которые соответствуют указанному списку ключевых слов, разделенных между собой запятыми.
+
+ plugman search <plugin keywords>
+
+
+### Смена реестра плагинов
+
+Вы можете получить или установить URL текущего реестра плагинов который использует plugman. Большей частью вы должны оставить это значение установленным в http://registry.cordova.io за исключением если вы хотите использовать реестр плагинов постороннего поставщика.
+
+ plugman config set registry <url-to-registry>
+ plugman config get registry
+
+
+### Получение информации о плагине
+
+Вы можете получить информацию о определенном плагине, сохраненном в реестре с помощью:
+
+ plugman info <id>
+
+
+Эта команда свяжется с реестром плагинов и получит информацию, такую как номер версии плагина.
+
+## Установка базовых плагинов
+
+Приведенные ниже примеры показывают, как добавлять плагины по мере необходимости, так чтобы любая часть Cordova API, которую вы используете в вашем проекте, по-прежнему продолжала работать после обновления до версии 3.0. Для каждой команды, необходимо выбрать целевую платформы, и ссылаться на каталог проекта платформы.
+
+* cordova-plugin-battery-status
+
+ plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-battery-status
+
+* cordova-plugin-camera plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-camera
+
+* cordova-plugin-console plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-console
+
+* cordova-plugin-contacts plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-contacts
+
+* cordova-plugin-device plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-device
+
+* cordova-plugin-device-motion (accelerometer) plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-device-motion
+
+* cordova-plugin-device-orientation (compass) plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-device-orientation
+
+* cordova-plugin-dialogs plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-dialogs
+
+* cordova-plugin-file plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-file
+
+* cordova-plugin-file-transfer plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-file-transfer
+
+* cordova-plugin-geolocation plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-geolocation
+
+* cordova-plugin-globalization plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-globalization
+
+* cordova-plugin-inappbrowser plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-inappbrowser
+
+* cordova-plugin-media plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-media
+
+* cordova-plugin-media-capture plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-media-capture
+
+* cordova-plugin-network-information plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-network-information
+
+* cordova-plugin-splashscreen plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-splashscreen
+
+* cordova-plugin-vibration plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-vibration
\ No newline at end of file
diff --git a/docs/ru/5.0.0/plugin_ref/spec.md b/docs/ru/5.0.0/plugin_ref/spec.md
new file mode 100644
index 0000000..10a922c
--- /dev/null
+++ b/docs/ru/5.0.0/plugin_ref/spec.md
@@ -0,0 +1,499 @@
+---
+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.
+---
+
+# Спецификация расширений
+
+Файл `plugin.xml` представляет собой документ XML c пространством имен `plugins`: `http://apache.org/cordova/ns/plugins/1.0`. Он содержит узел верхнего уровня `plugin`, который определяет сам плагин, и дочерние узлы, которые определяют структуру плагина.
+
+Простой пример элемента plugin:
+
+ <?xml version="1.0" encoding="UTF-8"?>
+ <plugin xmlns="http://apache.org/cordova/ns/plugins/1.0"
+ xmlns:android="http://schemas.android.com/apk/res/android"
+ id="com.alunny.foo"
+ version="1.0.2">
+
+
+## Элемент *plugin*
+
+Элементом `plugin` является элементом верхнего уровня в файле манифеста плагина. Он имеет следующие атрибуты:
+
+* `xmlns` (обязательно): пространство имен, `http://apache.org/cordova/ns/plugins/1.0`. Если документ содержит XML из других пространств имен, таких как теги, которые будут добавлены к `AndroidManifest.xml` файл, эти пространства имен также должны быть включены в элемент верхнего уровня.
+
+* `id` (обязательный): уникальный идентификатор плагина, записывается в формате доменных имен, например `com.alunny.foo`
+
+* ` version ` (обязательно): номер версии плагина, который соответствует условиям следующего регулярного выражения:
+
+ ^\d+[.]\d+[.]\d+$
+
+
+## Элементы *engines* и *engine*
+
+Дочерние элементы элемента `< engines >` указывают версии Cordova, которые поддерживает этот плагин. Например:
+
+ <engines>
+ <engine name="cordova" version="1.7.0" />
+ <engine name="cordova" version="1.8.1" />
+ <engine name="worklight" version="1.0.0" platform="android" scriptSrc="worklight_version"/>
+ </engines>
+
+
+Аналогично атрибуту ` version ` элемента `< plugin >` , указанная версия должна соответствовать регулярному выражению:
+
+ ^\d+[.]\d+[.]\d+$
+
+
+Элементы engine также могут указывать нечеткие параметры совпадения версий, чтобы избежать повторений или по упрощению поддержки, во время обновления платформы. Инструментарий проверяющий совместимость должен поддерживать как минимум определения содержащие `>` , `>=` , `<` и `<=` , например:
+
+ <engines>
+ <engine name="cordova" version=">=1.7.0" />
+ <engine name="cordova" version="<1.8.1" />
+ </engines>
+
+
+Теги `<engine>` также поддерживаются на всех платформах, на которых работает Cordova. Указание имени `cordova` для тега engine означает, что все версии Cordova на любой платформе должны соответствовать версии указанной в атрибуте version. Для того, чтобы переопределить включающий в себя все платформы тег engine со значением `cordova`, вы можете указывать индивидуальные платформы и их версии:
+
+ <engines>
+ <engine name="cordova" version=">=1.7.0" />
+ <engine name="cordova-android" version=">=1.8.0" />
+ <engine name="cordova-ios" version=">=1.7.1" />
+ </engines>
+
+
+Вот список платформ, который тег 'engine<engine>' тег поддерживает: * «cordova» * «cordova-plugman» * «cordova Амазонки fireos» * «cordova-android» * «cordova-ios» * «cordova-blackberry10» * «cordova-wp8» * «cordova-windows8»
+* ' android-sdk' / / возвращает наивысший Android api уровня установлен * «яблоко xcode» / / возвращает версии xcode * «apple-ios» / / возвращает самую новую версию iOS установлена * «apple osx» / / Возвращает версию OSX * «blackberry-ndk» / / возвращает родной blackberry версии SDK
+
+Указание пользовательских фреймвёрков на основе Apache Cordova должны быть перечислены с использованием тега engine следующим образом:
+
+ <engines>
+ <engine name="my_custom_framework" version="1.0.0" platform="android" scriptSrc="path_to_my_custom_framework_version"/>
+ <engine name="another_framework" version=">0.2.0" platform="ios|android" scriptSrc="path_to_another_framework_version"/>
+ <engine name="even_more_framework" version=">=2.2.0" platform="*" scriptSrc="path_to_even_more_framework_version"/>
+ </engines>
+
+
+При указании пользовательского фреймвёрка основанного на Apache Cordova обязательно, чтобы элемент engine включал в себя следующие атрибуты: `name` , `version` , `scriptSrc` , и`platform`.
+
+* `name`(обязательно): Отображаемое пользователю имя вашего фреймвёрка.
+
+* `version`(обязательно): минимальная версия вашего фреймвёрка, которая требуется для установки плагина.
+
+* `scriptSrc`(обязательно): файл сценария, который говорит plugman, какая версия пользовательского фреймвёрка установлена. В идеале этот файл должен быть в каталоге верхнего уровня каталога plugin.
+
+* `platform`(обязательно): какие платформы, поддерживает ваш фреймвёрк. Вы можете использовать подстановочный знак `*` для указания того что поддерживаются все платформ, или укажите имена платформ разделенные символом |, например `android|ios|blackberry10` или просто одну платформу, например: `android`.
+
+plugman завершает выполнение с ненулевым кодом ошибки для любого плагина, который будет добавляться в проект, параметры которого не соответствует ограничениям необходимого фреймвёрка для данного плагина.
+
+Если теги `<engine>` не указаны, plugman пытается установить плагин в каталог проекта Cordova без проверки ограничений.
+
+## Элемент *name*
+
+Текст содержащий название плагина, как оно будет отображаться пользователям. Например:
+
+ <name>Foo</name>
+
+
+Этот элемент (пока) не поддерживает локализацию.
+
+## Элемент *description*
+
+Текст содержащий описание плагина, как оно будет отображаться пользователям. Например:
+
+ <description>Foo plugin description</description>
+
+
+Этот элемент (пока) не поддерживает локализацию.
+
+## Элемент *author*
+
+Имя автора плагина. Текстовое содержимое элемента содержит имя автора плагина. Например:
+
+ <author>Foo plugin description</author>
+
+
+## Элемент *keywords*
+
+Ключевые слова для плагина. Текстовое содержимое элемента содержит разделенные запятыми ключевые слова характеризующие плагин. Например:
+
+ <keywords>foo,bar</keywords>
+
+
+## Элемент *license*
+
+Лицензия на использование плагина. Текстовое содержимое элемента содержит лицензию для плагина. Например:
+
+ <license>Apache 2.0 License</license>
+
+
+## Элемент *asset*
+
+Один или несколько элементов указывающие файлы или каталоги, которые будут копироваться в каталог `www` приложения Cordova. Примеры:
+
+ <!-- a single file, to be copied in the root directory -->
+ <asset src="www/foo.js" target="foo.js" />
+ <!-- a directory, also to be copied in the root directory -->
+ <asset src="www/foo" target="foo" />
+
+
+Все теги `<asset>` должны содержать атрибуты `src` и `target`. Веб-плагины состоят в основном из элементов `<asset>`. Любые теги `<asset>`, вложенные в теги `<platform>` определяют ресурсы, которые специфичны для определенной платформы, как описано ниже. Атрибуты включают в себя:
+
+* `src`(обязательно): расположение файла или каталога, в пакете плагина, относительно документа `plugin.xml`. Если файл не существует в указанном в `src` расположении, plugman останавливается и отменяет процесс установки, выдает уведомление о конфликте и выходит с ненулевым кодом.
+
+* `target`(обязательно):
+
+ Месторасположение файла или каталога, в приложении Cordova, где должны располагаться ресурсы указанные в теге src. Месторасположение указывается относительно каталога `www`. Ресурсы могут быть перемещены в подкаталогах, например:
+
+ <asset src="www/new-foo.js" target="js/experimental/foo.js" />
+
+
+ создает каталог `js/experimental` в пределах каталога `www`, если только этот каталогу уже не существует, затем копирует `new-foo.js` файл и переименовывает его в `foo.js` . Если файл уже существует в целевом расположении, plugman останавливается и отменяет процесс установки, выдает уведомление о конфликте и выходит с ненулевым кодом.
+
+## Элемент *js-module*
+
+Большинство плагинов включают один или несколько файлов JavaScript. Каждый элемент `<js-module>` соответствует файлу JavaScript и устраняет необходимость в добавлении тега `<script>` для каждого файла, в файле index.html. В то время как теги `<asset>` просто копируют файл из подкаталога плагина в каталог `www`, теги `<js-module>` являются гораздо более сложными конструкциями. Они выглядят так:
+
+ <js-module src="socket.js" name="Socket">
+ <clobbers target="chrome.socket" />
+ </js-module>
+
+
+При установке плагина в примере указанном выше, `socket.js` копируется в `www/plugins/my.plugin.id/socket.js` и для этого файла добавляется запись в файле `www/cordova_plugins.js` . Во время загрузки, код в `cordova.js` использует XHR для считывания каждого файла, зарегистрированного в www/cordova_plugins.js и добавляет тег `<script>` в HTML, для каждого такого файла. Он добавляет сопоставление, описывающее необходимо добавить содержимое файла в общее пространство имен, или расширить уже существующее описание JS объекта, как описано ниже.
+
+*Не* оборачивайте файл с использованием `cordova.define`, так как это будет осуществляться автоматически. Модуль упаковывается в замыкания(closure), с параметрами `module` , `exports` , и `require` в области видимости, как это принято для AMD модулей.
+
+Подробная информация о теге `<js-module>`:
+
+* `src`: Ссылается на файл в каталоге плагина относительно файла `plugin.xml`.
+
+* `name`: Определяет последнюю часть имени модуля, определенного в данном файле. Как правило, может быть, все, что вам нравится. Это значение важно только в том случае если вы хотите использовать `cordova.require` для импорта других частей вашего плагина в коде JavaScript. Полное имя AMD модуля для `<js-module>` это `id` вашего плагин со следующим значением `name` . Из примера указанного выше, для плагина с `id` - `chrome.socket` , полное имя модуля`chrome.socket.Socket`.
+
+* Три теги разрешены внутри `<js-module>` :
+
+ * `<clobbers target="some.value"/>` Указывает, что значение `module.exports` добавляется в объект `window` таким образом, что становится доступно как `window.some.value` . Вы можете иметь столько `<clobbers>` сколько вам нравится. Любой объект, отсутствующий в объекте `window` будет создан при необходимости.
+
+ * `<merges target="some.value"/>` Указывает, что модуль должны быть объединены с любым уже существующим значением в `window.some.value` . Если какой либо ключ уже существует в объекте window, объект указанный в модуле переопределяет оригинал. Вы можете иметь столько `<merges>` сколько вам нравится. Любой объект, отсутствующий в объекте `window` будет создан при необходимости.
+
+ * `<runs/>`означает, что ваш код должен быть указан с `cordova.require` , но не добавлен к объекту `window`. Это полезно при инициализации модуля, присоединения обработчиков событий или в других случаях. Вы можете иметь не более одного тега `<runs/>`. Обратите внимание, что использование `<runs/>` совместно с `<clobbers/>` или `<merges/>` является излишним, так как эти директивы тоже загружают ваш модуль с помощью `cordova.require`.
+
+ * Пустой `<js-module>` также загружается и может быть доступен в других модулях с помощью `cordova.require`.
+
+Если `src` не указывает на существующий файл, plugman останавливается и отменяет установку, выдает уведомление о проблеме и выходит с ненулевым кодом.
+
+Вложение тега `<js-module>` внутри элемента `<platform>` объявляет JavaScript модуль, специфический для выбранной платформы.
+
+## Элемент *dependency*
+
+Тег `<dependency>` позволяет указать другие плагины, от которых зависит текущий плагин. В то время как будущих версий будет доступ к ним из репозиториев плагинов, в краткосрочной перспективе плагины прямо упоминается по URL в тегах `<dependency>`. Они выглядят следующим образом:
+
+ <dependency id="com.plugin.id" url="https://github.com/myuser/someplugin" commit="428931ada3891801" subdir="some/path/here" />
+
+
+* `id`: определяет идентификатор плагина. Он должен быть глобально уникальным и выраженной в обратном формате доменных имен. Хотя ни одно из этих ограничений в настоящее время не применяется, это может произойти в будущем.
+
+* `url`: URL-адрес для плагина. Этот адрес должен указывать на репозиторий git, который plugman будет пытаться клонировать.
+
+* `commit`: Это любая ссылка git, понятная для `git checkout` : имя ветки или тега (например, `master` , `0.3.1` ), или хеша коммита (например,`975ddb228af811dd8bb37ed1dfd092a3d05295f9`).
+
+* `subdir`: Указывает, что зависимость целевого плагина существует как подкаталог git-репозитория. Это полезно, потому что она позволяет определять репозиторий содержащий несколько связанных плагинов, и указывать каждый из них индивидуально.
+
+В будущем будут введены ограничения версии, и репозиторий плагинов будет существовать для поддержки выбора плагина по имени вместо явного URL-адреса.
+
+### Относительные пути для зависимостей
+
+Если задать `url` для тега`<dependency>` как `"."` и указать `subdir`, зависимый плагин будет установлен из того же локального или удаленного репозитория что и основной плагин, который определил тег `<dependency>`.
+
+Обратите внимание, что `subdir` всегда указывает путь относительно *корня* git-репозитория, а не папки основного плагина. Это верно, даже если вы установили плагин с указанием локального пути к нему. Plugman находит корень репозитория git, а затем находит там же другой плагин.
+
+## Элемент *platform*
+
+`<platform>` Тег определяет платформы, которые имеют связанные исходные файлы или требуют изменения в их конфигурационных файлах. Инструменты, с помощью этой спецификации могут определить поддерживаемые платформы и установить код в проекты Cordova.
+
+Плагины без тегов `<platform>` считаются содержащими только JavaScript и поэтому устанавливаются на любых платформах.
+
+Образец тега platform:
+
+ <platform name="android">
+ <!-- android-specific elements -->
+ </platform>
+ <platform name="ios">
+ <!-- ios-specific elements -->
+ </platform>
+
+
+Обязательный атрибут `name` поддерживаемую платформу, связывая дочерние элементы с этой платформой.
+
+Имена платформ должны быть в нижнем регистре. Перечислены имена платформ, в произвольном порядке:
+
+* amazon-fireos
+* android
+* blackberry10
+* ios
+* wp8
+* Windows8
+
+## Элемент *source-file*
+
+Элемент `<source-file>` определяет исполняемый файл исходного кода, который должен быть установлен в проект. Примеры:
+
+ <!-- android -->
+ <source-file src="src/android/Foo.java"
+ target-dir="src/com/alunny/foo" />
+ <!-- ios -->
+ <source-file src="src/ios/CDVFoo.m" />
+ <source-file src="src/ios/someLib.a" framework="true" />
+ <source-file src="src/ios/someLib.a" compiler-flags="-fno-objc-arc" />
+
+
+Он поддерживает следующие атрибуты:
+
+* `src`(обязательно): расположение файла относительно `plugin.xml` . Если `src` файл не найден, plugman останавливается и отменяет установку, выдает уведомление об этой проблеме и выходит с ненулевым кодом.
+
+* `target-dir`: Каталог, в который должны быть скопированы файлы, относительно корня проекта Cordova. На практике это наиболее важно для платформ на базе Java, где файл в пакете `com.alunny.foo` должен быть расположен в каталоге `com/alunny/foo`. Для платформ, где исходный каталог не имеет значения этот атрибут должен быть опущен.
+
+ Как и в случае с ресурсами, если `target` из `source-file` будет перезаписывать существующий файл, plugman остановится и отменит установку. После чего выдаст уведомление об этой проблеме и выйдет с ненулевым кодом.
+
+* `framework`(только для iOS-устройств): Если значение `true` , также добавляет указанный файл в качестве фреймвёрка в проект.
+
+* `compiler-flags`(только для iOS-устройств): Если установлено, присваивает указанный флаги компилятора для конкретного исходного файла.
+
+## Элемент *config-file*
+
+Идентифицирует XML файл конфигурации который будет изменен, где в этом документе необходимо произвести изменения, и что следует изменить.
+
+Два типа файлов, которые были протестированы на модификацию с использованием этого элемента, `xml` и `plist` файлы.
+
+Элемент `config-file` позволяет только добавить новые дочерние элементы в XML-дерево документа. Дочерние элементы это XML-литералы которые должны быть вставлены в целевой документ.
+
+Пример для XML:
+
+ <config-file target="AndroidManifest.xml" parent="/manifest/application">
+ <activity android:name="com.foo.Foo" android:label="@string/app_name">
+ <intent-filter>
+ </intent-filter>
+ </activity>
+ </config-file>
+
+
+Пример для `plist` :
+
+ <config-file target="*-Info.plist" parent="CFBundleURLTypes">
+ <array>
+ <dict>
+ <key>PackageName</key>
+ <string>$PACKAGE_NAME</string>
+ </dict>
+ </array>
+ </config-file>
+
+
+Элемент поддерживает следующие атрибуты:
+
+* `target`:
+
+ Файл который будет изменен и путь к нему относительно корня проекта Cordova.
+
+ Целевой объект может включать подстановочный знак (`*`) для элементов. В этом случае plugman рекурсивно просматривает структуру каталогов проекта и использует первое совпадение.
+
+ На iOS, расположение файлов конфигурации относительно корневого каталога проекта не известно, поэтому указание приёмника для `config.xml` определяется как `cordova-ios-project/MyAppName/config.xml`.
+
+ Если указанный файл не существует, инструмент игнорирует изменения конфигурации и продолжает установку.
+
+* `parent`: Селектор XPath, ссылающийся на на родительский элемент, для добавляемых в конфигурационный файл элементов. Если вы используете абсолютные селекторы, можно использовать подстановочный знак (`*`) для указания корневого элемента, например,`/*/plugins`.
+
+ Для `plist` файлов, `parent` определяет, в каком родительском ключе следует добавить указанные XML-данные.
+
+ Если селектор не находит элемент в указанном документе, инструмент останавливается и процесс установки отменяется, после чего выдает предупреждение и выходит с ненулевым кодом.
+
+* `after`: Приоритетный список принятых братьев и сестер, после которого нужно добавить XML-фрагмент. Полезно для задания изменения в файлах, которые требуют строгий порядок элементов XML как [http://msdn.microsoft.com/en-us/library/windowsphone/develop/ff769509%28v=vs.105%29.aspx#BKMK _EXTENSIONSelement][1]
+
+ [1]: http://msdn.microsoft.com/en-us/library/windowsphone/develop/ff769509%28v=vs.105%29.aspx#BKMK_EXTENSIONSelement
+
+Платформа Windows поддерживает два дополнительных атрибута (оба необязательных) затрагивающих meta-name `package.appxmanifest`:
+
+Атрибут `device-target` указывает, что следует включить только при построении для указанного типа целевого устройства. Поддерживаемыми значениями являются `win`, `phone`или `all`.
+
+Атрибут `versions` указывает, что манифесты приложений для определенных версий Windows следует изменить только для версий, которые соответствуют указанной строке версии. Значение может быть любое допустимое значение для строки семантической диапазона версий.
+
+Примеры использования этих атрибутов Windows:
+
+ <config-file target="package.appxmanifest" parent="/Package/Capabilities" versions="<8.1.0">
+ <Capability Name="picturesLibrary" />
+ <DeviceCapability Name="webcam" />
+ </config-file>
+ <config-file target="package.appxmanifest" parent="/Package/Capabilities" versions=">=8.1.0" device-target="phone">
+ <DeviceCapability Name="webcam" />
+ </config-file>
+
+
+Приведенный выше пример установит pre-8.1 платформы (Windows 8, в частности) и запросит общие возможности устройства `webcam` и `picturesLibrary`, затем применит возможности устройства `webcam` только для проектов Windows 8.1 которые собираются для Windows Phone. Настольные системы Windows 8.1 остаются неизмененными.
+
+## Элемент *plugins-plist*
+
+Это *устаревший* элемент, как он применяется только к cordova-ios 2.2.0 и ниже. Используйте тег `<config-file>` для новых версий Cordova.
+
+Пример:
+
+ <config-file target="config.xml" parent="/widget/plugins">
+ <feature name="ChildBrowser">
+ <param name="ios-package" value="ChildBrowserCommand"/>
+ </feature>
+ </config-file>
+
+
+Указывает ключ и значение для добавления в корректный файл `AppInfo.plist` в проекте Cordova iOS. Например:
+
+ <plugins-plist key="Foo" string="CDVFoo" />
+
+
+## Элементы *resource-file* и *header-file*
+
+Как и исходные файлы (source-file), но специально для платформ, таких как iOS, которые делают различия между исходными файлами, заголовками и ресурсами. Например:
+
+ <resource-file src="CDVFoo.bundle" />
+ <resource-file src="CDVFooViewController.xib" />
+ <header-file src="CDVFoo.h" />
+
+
+Пример для Android:
+
+ <resource-file src="FooPluginStrings.xml" target="res/values/FooPluginStrings.xml" />
+
+
+## Элемент *lib-file*
+
+Также как исходные файлы, файлы ресурсов и заголовков, но специально для платформ, таких как BlackBerry 10 которые использут созданные пользователем библиотеки. Например:
+
+ <lib-file src="src/BlackBerry10/native/device/libfoo.so" arch="device" />
+ <lib-file src="src/BlackBerry10/native/simulator/libfoo.so" arch="simulator" />
+
+
+Поддерживаемые атрибуты:
+
+* `src`(обязательно): расположение файла относительно `plugin.xml`. Если `src` не удается найти, plugman останавливается и отменяет установку, выдает предупреждение о проблеме и выходит с ненулевым кодом.
+
+* `arch`: Архитектура для которой `.so` файл был построен, либо `device` или`simulator`.
+
+Для платформы Windows элемент `<lib-file>` позволяет включение `<SDKReference>` в создаваемых файлах проекта Windows.
+
+Поддерживаемые атрибуты:
+
+* `src` (обязательно): имя пакета SDK для включения (который будет использоваться как значение атрибута `Include` создаваемого элемента `<SDKReference>` ).
+
+* `arch`: указывает, что `<SDKReference>` следует включить только при построении для заданной архитектуры. Поддерживаются следующие значения `x86`, `x64` или `ARM`.
+
+* `device-target`: указывает, что `<SDKReference>` следует включить только при построении для указанного типа целевого устройства. Поддерживаются следующие значения `win` (или `windows`), `phone` или `all`.
+
+* `versions`: указывает, что `<SDKReference>` следует включить только при построении версий, которые соответствуют заданной строке версии. Значение может быть любое допустимое значение для строки семантической диапазона версий.
+
+Примеры:
+
+ <lib-file src="Microsoft.WinJS.2.0, Version=1.0" arch="x86" />
+ <lib-file src="Microsoft.WinJS.2.0, Version=1.0" versions=">=8.1" />
+ <lib-file src="Microsoft.WinJS.2.0, Version=1.0" target="phone" />
+ <lib-file src="Microsoft.WinJS.2.0, Version=1.0" target="win" versions="8.0" arch="x86" />
+
+
+## Элемент *framework*
+
+Определяет фреймвёрк (обычно часть OS/платформы) от которого зависит плагин.
+
+Примеры:
+
+ <framework src="libsqlite3.dylib" />
+ <framework src="social.framework" weak="true" />
+ <framework src="relative/path/to/my.framework" custom="true" />
+ <framework src="path/to/project/LibProj.csproj" custom="true" type="projectReference"/>
+
+
+`src` Атрибут определяет фреймвёрки, которые plugman пытается добавить в проект Cordova, наиболее подходящим для данной платформы образом.
+
+Необязательный атрибут `weak` – это логическое значение, указывающее, должен ли фреймвёрк быть слабо связан с результирующим исполняемым файлом проекта. Значение по умолчанию`false`.
+
+Необязательный атрибут `custom` – это логическое значение, указывающее, входит ли фреймворк в состав файлов плагина (таким образом это не системный фреймворк). По умолчанию — `false`. ***На Android*** он определяет как обрабатывать **src**. Если `true` **src** это относительный путь из каталога проекта приложения, в противном случае, из каталога Android SDK.
+
+Необязательный атрибут `type` является строкой, указывающая тип фреймворка для добавления. В настоящее время только `projectReference` поддерживается и только для Windows. Использование `custom='true'` и `type='projectReference'` будет добавлять ссылку на проект, который будет добавляться к этапам компиляции + линковки проекта Cordova. По сути, это единственный способ в настоящее время указать что что «custom» фреймворк может ориентироваться на нескольких архитектур, так как как явно они построены как зависимость в ссылающемся cordova-приложении.
+
+Не обязательный `parent` атрибут в настоящее время поддерживается только на Андроиде. Он задает относительный путь к каталогу, содержащему подпроект, на который необходимо добавить ссылку. Значение по умолчанию — `.`, то есть проект приложения. Она позволяет добавлять ссылки между под-проектами как в этом примере:
+
+ <framework src="FeedbackLib" custom="true" />
+ <framework src="extras/android/support/v7/appcompat" custom="false" parent="FeedbackLib" />
+
+
+Платформа Windows поддерживает три дополнительные атрибуты (все необязательные) для уточнения когда фреймворк должны быть включен:
+
+Атрибут `arch` указывает, что фреймворк следует включить только при создании для заданной архитектуры. Поддерживаются следующие значения `x86`, `x64` или `ARM`.
+
+Атрибут `device-target` указывает, что следует включить только при построении для указанного типа целевого устройства. Поддерживаются следующие значения `win` (или `windows`), `phone` или `all`.
+
+Атрибут `versions` указывает, что фреймворк следует включить только при построении для версий, которые соответствуют заданной строке версии. Значение может быть любое допустимое значение для строки семантической диапазона версий.
+
+Примеры использования этих атрибутов Windows:
+
+ <framework src="src/windows/example.dll" arch="x64" />
+ <framework src="src/windows/example.dll" versions=">=8.0" />
+ <framework src="src/windows/example.vcxproj" type="projectReference" target="win" />
+ <framework src="src/windows/example.vcxproj" type="projectReference" target="all" versions="8.1" arch="x86" />
+
+
+## Элемент *info*
+
+Дополнительная информация для пользователей. Это полезно, когда требуется дополнительные шаги, которые не могут быть легко автоматизированы или выходят за рамки работы plugman. Примеры:
+
+ <info>
+ You need to install __Google Play Services__ from the `Android Extras` section using the Android SDK manager (run `android`).
+
+ You need to add the following line to the `local.properties`:
+
+ android.library.reference.1=PATH_TO_ANDROID_SDK/sdk/extras/google/google_play_services/libproject/google-play-services_lib
+ </info>
+
+
+## Переменные
+
+В некоторых случаях плагин может потребоваться внести изменения в конфигурацию в зависимости от целевого приложения. Например, чтобы зарегистрироваться для C2DM на Android, приложение чей идентификатор пакета `com.alunny.message` потребует разрешения, такие как:
+
+ <uses-permission
+ android:name="com.alunny.message.permission.C2D_MESSAGE"/>
+
+
+В таких случаях, когда добавляемое содержание из файл `plugin.xml` не известно заранее, можно указывать переменные с использованием знака доллара, за которым следует серия заглавных букв, цифр или знаками подчеркивания. Для приведенного выше примера файл `plugin.xml` будет включать следующий тег:
+
+ <uses-permission
+ android:name="$PACKAGE_NAME.permission.C2D_MESSAGE"/>
+
+
+plugman заменяет ссылки на переменные указанным значением, или пустая строка, если значение переменной не найдено. Значение переменной могут быть обнаружено (в данном случае, из `AndroidManifest.xml` файла) или указанно пользователем инструмента; точный процесс зависит от конкретного инструмента.
+
+plugman может запросить пользователя указать переменные необходимые плагину. Например можно указать ключи API для C2M и Карт Google как аргумент командной строки:
+
+ plugman --platform android --project /path/to/project --plugin name|git-url|path --variable API_KEY=!@CFATGWE%^WGSFDGSDFW$%^#$%YTHGsdfhsfhyer56734
+
+
+Чтобы сделать переменную обязательной, тег `<platform>` должен содержать тег `<preference>`. Например:
+
+ <preference name="API_KEY" />
+
+
+plugman проверяет, переданы ли ему эти необходимые настройки. Если нет, то он должен предупредить пользователя как указать переменную и выйти с ненулевым кодом.
+
+Некоторые имена переменных должны быть зарезервированы, как указано ниже.
+
+## $PACKAGE_NAME
+
+Уникальный идентификатор в обратном стиле доменных имен, соответствующий пакету `CFBundleIdentifier` на iOS или атрибут `package` корневого элемента `manifest` в файле `AndroidManifest.xml` файл.
\ No newline at end of file
