cordova-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ste...@apache.org
Subject [11/13] docs commit: Added 5.0.0 for russion docs
Date Wed, 13 May 2015 19:53:14 GMT
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/af16a486/docs/ru/5.0.0/guide/hybrid/plugins/index.md
----------------------------------------------------------------------
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

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/af16a486/docs/ru/5.0.0/guide/hybrid/webviews/index.md
----------------------------------------------------------------------
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

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/af16a486/docs/ru/5.0.0/guide/next/index.md
----------------------------------------------------------------------
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

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/af16a486/docs/ru/5.0.0/guide/overview/index.md
----------------------------------------------------------------------
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

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/af16a486/docs/ru/5.0.0/guide/platforms/amazonfireos/config.md
----------------------------------------------------------------------
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


---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org


Mime
View raw message