You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by st...@apache.org on 2015/05/13 00:53:01 UTC
[06/15] docs commit: Add Russian translation
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/3c9fa2f6/docs/ru/edge/guide/overview/index.md
----------------------------------------------------------------------
diff --git a/docs/ru/edge/guide/overview/index.md b/docs/ru/edge/guide/overview/index.md
index 8a4333c..54e56c8 100644
--- a/docs/ru/edge/guide/overview/index.md
+++ b/docs/ru/edge/guide/overview/index.md
@@ -41,9 +41,9 @@ Apache Cordova закончил инкубационный период в ок
Само приложение реализована как веб-страницы, по умолчанию локальный файл под названием *index.html*, который ссылается на любой CSS, JavaScript, изображения, файлы мультимедиа или другие ресурсы необходимы для его запуска. Приложение выполняет как *WebView* в пределах оболочки приложения, которую вы распространяете в магазины приложений.
-WebView с поддержкой Cordova может представлять приложения и полностью его пользовательский интерфейс. На некоторых платформах она также может быть компонентом в больших, гибридные приложения, который объединяют WebView с другими компонентами приложения. (Подробную информацию см. в разделе "Встраивание WebViews".)
+WebView с поддержкой Cordova может представлять приложения и полностью его пользовательский интерфейс. На некоторых платформах она также может быть компонентом в больших, гибридные приложения, который объединяют WebView с другими компонентами приложения. (Подробную информацию см. в разделе "Интеграция WebViews".)
-Интерфейс *плагина* доступен для Cordova и других компоненты, для взаимодействия друг с другом. Это позволяет вызывать код на языке платформы из JavaScript. В идеале на нескольких платформах устройств согласуются JavaScript API, чтобы этот машинный код. Начиная с версии 3.0 плагины предоставляют привязки к стандартным API интерфейсам устройства. Сторонние плагины предоставляют дополнительные привязки для функции не обязательно доступных на всех платформах. Можно найти эти сторонние плагины в [реестре плагинов][3] и использовать их в своем приложении. Вы м�
�жете также разработать свои собственные плагины, как описано в "Руководстве по разработке плагинов". Плагины могут оказаться необходимыми, например, для связи между Cordova и собственными компонентами.
+Интерфейс *плагина* доступен для Cordova и других компоненты, для взаимодействия друг с другом. Это позволяет вызывать код на языке платформы из JavaScript. В идеале на нескольких платформах устройств согласуются JavaScript API, чтобы этот машинный код. Начиная с версии 3.0 плагины предоставляют привязки к стандартным API интерфейсам устройства. Сторонние плагины предоставляют дополнительные привязки для функции не обязательно доступных на всех платформах. Можно найти эти сторонние плагины в [реестре плагинов][3] и использовать их в своем приложении. Вы м�
�жете также разработать свои собственные плагины, как описано в разделе "Руководство по разработке плагинов". Плагины могут оказаться необходимыми, например, для связи между Cordova и собственными компонентами.
[3]: http://plugins.cordova.io
@@ -55,7 +55,7 @@ WebView с поддержкой Cordova может представлять пр
Начиная с версии 3.0 можно использовать два основных рабочих процесса для создания мобильных приложений. Хотя вы можете использовать любой рабочий процесс для выполнения одной и той же задачи, каждый из этих путей имеет свои преимущества:
-* **Кросс платформенный (CLI) рабочий процесс**: использование Этот рабочий процесс если вы хотите, чтобы ваше приложение для запуска на столько разных мобильных операционных систем как можно скорее, с немного нужно для развития платформы. Этот рабочий процесс формируется возле утилиты `cordova`, также известном как Cordova *CLI*, который был введен начиная с Cordova 3.0. CLI это высоко уровневый инструмент который позволяет построить проекты для как можно большего количества платформа одновременно, абстрагируя как можно больше функциональности низко-уро�
�невых скриптов. CLI копирует общий набор web ресурсво в подкаталоги для каждой мобильной платформы, делает любые необходимые изменения в конфигурацию для каждой платформы, запускает сценарии сборки для создания исполняемых файлов приложения. CLI также предоставляет общий интерфейс для применения плагинов для вашего приложения. Для более подробной информации о CLI увидеть интерфейс командной строки. Если у вас есть необходимость по центру платформы рабочего процесса, Рабочий процесс кросс платформенный рекомендуется.
+* **Кросс платформенный рабочий процесс**: Используйте этот рабочий процесс если вы хотите, чтобы ваше приложение запускалось на максимально возможном количестве мобильных платформ, с минимальными нуждами для платформо-специфической разработки. Этот рабочий процесс формируется возле утилиты `cordova`, также известном как Cordova *CLI*, который был введен начиная с Cordova 3.0. CLI это высоко уровневый инструмент который позволяет построить проекты для как можно большего количества платформа одновременно, абстрагируя как можно больше функциональности
низко-уровневых скриптов. CLI копирует общий набор web ресурсво в подкаталоги для каждой мобильной платформы, делает любые необходимые изменения в конфигурацию для каждой платформы, запускает сценарии сборки для создания исполняемых файлов приложения. CLI также предоставляет общий интерфейс для применения плагинов для вашего приложения. Для более подробной информации о CLI увидеть интерфейс командной строки. Если у вас есть необходимость по центру платформы рабочего процесса, Рабочий процесс кросс платформенный рекомендуется.
* **Платформо-ориентированный процесс разработки**: Используйте этот процесс если вы хотите сфокусироваться на построении приложения для одной платформы и вам будет необходимо вносить модификации на низком уровне. Вы должны использовать этот подход, к примеру, если вы хотите чтобы ваше приложение совмещало собственные компоненты с веб-ориентированными компонентами Cordova, как описано в разделе "Встраивание WebView". Как правило этот рабочий процесс используется, если необходимо изменить проект с помощью SDK. Этот рабочий процесс опирается на �
�абор скриптов более низкого уровня, которые приспособлены для каждой поддерживаемой платформы и отдельную утилита Plugman, которая позволяет применять плагины индивидуально к выбранной платформе. Хотя вы можете использовать этот рабочий процесс для создания кросс платформенных приложений, это как правило сложнее, потому что отсутствие утилит более высокого уровня означает, отдельные циклов сборки и модификации плагинов для каждой платформы. Тем не менее этот рабочий процесс позволяет вам более широкий доступ к вариантам разработки, пр�
�доставляемые каждым SDK и важно для сложных гибридных приложений. Различные руководства платформы для подробной информации смотрите на утилиты доступны оболочки каждой платформы.
@@ -67,8 +67,8 @@ WebView с поддержкой Cordova может представлять пр
Установка Cordova будет отличаться в зависимости от рабочего процесса выше, вы выбираете:
-* Кросс платформенный рабочий процесс: увидеть интерфейс командной строки.
+* Кросс платформенный рабочий процесс: смотрите раздел "Интерфейс командной строки".
-* По центру платформы рабочего процесса: увидеть гидов платформы.
+* По центру платформы рабочего процесса: смотрите раздел "Руководство по поддерживаемым платформам".
-После установки Cordova, рекомендуется, что вы обзор руководства платформы для мобильных платформ, которые вам будет разрабатывать для. Мы также рекомендуем также просмотреть руководство конфиденциальности, безопасности и последующие шаги. Для настройки Cordova, смотрите файл config.xml. Для доступа к собственной функции на устройстве с JavaScript, сослаться на плагин API. И ссылаться на другие включены руководства при необходимости.
\ No newline at end of file
+После установки Cordova, рекомендуется, что вы прочитали раздел "Руководство по поддерживаемым платформам" для мобильных платформ, для которых вы будете разрабатывать. Мы также рекомендуем также просмотреть разделы "Руководство по конфиденциальности", "Руководство по безопасности" и "Последующие шаги". Для настройки Cordova, смотрите раздел "Файл config.xml". Для доступа к функциям платформы на устройстве из JavaScript, обращайтесь к "API плагинов". И обращайтесь к другим включеным руководствам при необходимости.
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/3c9fa2f6/docs/ru/edge/guide/platforms/amazonfireos/config.md
----------------------------------------------------------------------
diff --git a/docs/ru/edge/guide/platforms/amazonfireos/config.md b/docs/ru/edge/guide/platforms/amazonfireos/config.md
index c3b0502..14a68c4 100644
--- a/docs/ru/edge/guide/platforms/amazonfireos/config.md
+++ b/docs/ru/edge/guide/platforms/amazonfireos/config.md
@@ -19,7 +19,9 @@ license: Licensed to the Apache Software Foundation (ASF) under one
# Настройка Amazon Fire OS
-Файл `config.xml` управляет основные параметрами приложения, которые применяются к каждому приложению и экземпляру CordovaWebView. Этот раздел детализирует параметры, которые применяются только к продуктам построенным на платформе Amazon Fire ОС. Смотрите раздел "Файл config.xml" для получения информации о глобальных параметрах конфигурации.
+Файл `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 в то время пока приложение находится в фоновом режиме.
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/3c9fa2f6/docs/ru/edge/guide/platforms/android/config.md
----------------------------------------------------------------------
diff --git a/docs/ru/edge/guide/platforms/android/config.md b/docs/ru/edge/guide/platforms/android/config.md
index 7bbe81a..ec87514 100644
--- a/docs/ru/edge/guide/platforms/android/config.md
+++ b/docs/ru/edge/guide/platforms/android/config.md
@@ -19,7 +19,9 @@ license: Licensed to the Apache Software Foundation (ASF) under one
# Конфигурация Android
-Файл `config.xml` управляет основные параметрами приложения, которые применяются к каждому приложению и экземпляру CordovaWebView. Этот раздел описывает настройки, которые применяются только к построениям для Android. Смотрите раздел "Файл config.xml" для получения информации о глобальных параметрах конфигурации.
+Файл `config.xml` управляет основные параметрами приложения, которые применяются к каждому приложению и экземпляру CordovaWebView. Этот раздел описывает настройки, которые применяются только к построениям для Android. Смотрите [Файл config.xml][1] для получения информации о глобальных параметрах конфигурации.
+
+ [1]: config_ref_index.md.html#The%20config.xml%20File
* `KeepRunning` (логическое значение, по умолчанию `true` ): определяет, остается ли приложение работает в фоновом режиме после вызова события `pause`. Установка значения в `false` не завершает приложение после события `pause`, но просто останавливает выполнение кода в Cordova WebView в то время пока приложение находится в фоновом режиме.
@@ -75,4 +77,7 @@ license: Licensed to the Apache Software Foundation (ASF) under one
* `AndroidLaunchMode`(строки, по умолчанию `singleTop` ): задает действие `android:launchMode` атрибут. Это меняет то, что происходит, когда приложение запускается из приложения значок или намерения и уже работает. Допустимыми значениями являются `standard` , `singleTop` , `singleTask` ,`singleInstance`.
- <preference name="AndroidLaunchMode" value="singleTop"/>
\ No newline at end of file
+ <preference name="AndroidLaunchMode" value="singleTop"/>
+
+
+* `DefaultVolumeStream`(строки, по умолчанию `default` , добавил в Кордова android 3.7.0): устанавливает объем которых объем аппаратные кнопки ссылка на. По умолчанию это «вызов» для «СМИ» для планшетов и телефонов. Установите это для «медиа», чтобы иметь всегда изменить громкость медиа кнопки громкости вашего приложения. Обратите внимание, что при использовании плагина Кордова в СМИ, кнопки громкости будет динамически изменить для контроля объема средств массовой информации, когда любые мультимедийные объекты являются активными.
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/3c9fa2f6/docs/ru/edge/guide/platforms/android/index.md
----------------------------------------------------------------------
diff --git a/docs/ru/edge/guide/platforms/android/index.md b/docs/ru/edge/guide/platforms/android/index.md
index 1b6e1c3..5bad2f8 100644
--- a/docs/ru/edge/guide/platforms/android/index.md
+++ b/docs/ru/edge/guide/platforms/android/index.md
@@ -23,11 +23,11 @@ license: Licensed to the Apache Software Foundation (ASF) under one
## Требования и поддержка
-Cordova для Android требует Android SDK. Посмотреть [системные требования][1] Android SDK.
+Cordova для Android необходим Android SDK, который может быть установлен на операционных системах OS X, Linux или Windows. Смотрите [системные требования][1] Android SDK.
- [1]: http://developer.android.com/sdk/index.html
+ [1]: http://developer.android.com/sdk/index.html#Requirements
-Кордова поддерживает Android 2.3.x (пряник, начиная с 10 уровня Android API) и 4.x. Как правило версии Android становятся поддерживается Cordova как они опустится ниже 5% на Google в [панель распределения][2]. Android версий раньше, чем API уровня 10, и версии 3.x (соты, API уровни 11-13) значительно ниже 5% порог.
+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
@@ -41,17 +41,29 @@ Cordova для Android требует Android SDK. Посмотреть [сис
Эти инструменты командной строки позволят вам создавать, собирать и запускать приложения для Android. За информаций о дополнительных интерфейсах командной строки которые позволяют встраивать возможности плагинов среди разных платформ, смотрите раздел "Использование Plugman для управления плагинами". Смотрите раздел "Плагины приложения" для детальной информации о том как разрабатывать плагины.
-Установите Android SDK с сайта [developer.android.com/sdk][4]. Android SDK распространяется как файл 'adt-bundle-<os>-<arch>-<ver>'. На Windows, adt-bundle упакован совместно с установщиком. На OSX и Linux, просто распакуйте 'adt-bundle' в место где вы храните инструменты разработки. [Более подробную информацию по установке Android SDK можно найти здесь][5]
+## Установите Java Development Kit (JDK)
- [4]: http://developer.android.com/sdk/
- [5]: http://developer.android.com/sdk/installing/bundle.html
+Установить [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/adt-bundle/sdk/platform-tools:/Development/adt-bundle/sdk/tools
+ export PATH=${PATH}:/Development/android-sdk/platform-tools:/Development/android-sdk/tools
-Добавьте пути к `java` и `ant` если требуется. Эта строка в `~/.bash_profile` добавляет эти инструменты во вновь открытых окнах терминала. Если ваше окно терминала уже открыт в OSX, или чтобы избежать процедуры выхода/входа на Linux, выполните ниже указанную команду, чтобы сделать эти инструменты доступными в текущем окне терминала:
+Эта строка в `~/.bash_profile` добавляет эти инструменты во вновь открытых окнах терминала. Если ваше окно терминала уже открыт в OSX, или чтобы избежать процедуры выхода/входа на Linux, выполните ниже указанную команду, чтобы сделать эти инструменты доступными в текущем окне терминала:
$ источника ~/.bash_profile
@@ -68,218 +80,193 @@ Cordova для Android требует Android SDK. Посмотреть [сис
5. Добавьте следующее в `PATH`, в зависимости от того куда был установлен пакет SDK, например:
- ;C:\Development\adt-bundle\sdk\platform-tools;C:\Development\adt-bundle\sdk\tools
+ ;C:\Development\android-sdk\platform-tools;C:\Development\android-sdk\tools
6. Сохраните значение и закройте оба диалоговые окна.
-Вам возможно будет необходимо добавить Java и Ant. Откройте командную строку и напишите `java`, а также `ant`. Добавте к `PATH` ту из команды, которая не сможет запуститься:
+## Установить пакеты SDK
- ;%JAVA_HOME%\bin;%ANT_HOME%\bin
-
+Откройте Android SDK Manager (например, через терминал: `android`) и установить:
-## Откройте новый проект в SDK
+1. Android 5.1.1 (API 22) platform SDK
+2. Android SDK Build-tools version 19.1.0 или выше
+3. Android Support Repository (Extras)
-На данный момент для создания нового проекта можно выбрать между кросс-платформенным инструментом CLI, описанным в разделе "Интерфейс командной строки", или набор Android-ориентированных инструментов. Из каталога с исходным кодом, вот подход CLI:
+Смотрите [Установка пакетов SDK][7] для получения более подробной информации.
- $ cordova create hello com.example.hello HelloWorld
- $ cd hello
- $ cordova platform add android
- $ cordova build
-
+ [7]: http://developer.android.com/sdk/installing/adding-packages.html
-Вот соотвествующий низкоуровневый подход для 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
-
+По умолчанию Android sdk не предоставляет никаких эмуляторов. Вы можете создать новый, запустив `android` в командной строке. Выбрать **Tools → Manage AVDs** (Android Virtual Devices), затем выберите любой элемент из **Device Definitions** в появившемся диалоговом окне:
-Вот как использовать пакет SDK для изменения проекта:
+![][8]
-1. Запустите приложение **Eclipse** .
+ [8]: img/guide/platforms/android/asdk_device.png
-2. Выберите пункт меню **Создать проект** .
+Нажмите **Create AVD**, при необходимости изменяя имя, затем нажмите **ОК**, чтобы принять изменения:
-3. Выберите **Android Project from Existing Code** из появляющегося диалогового окна, и нажмите **Next**:
-
- ![][6]
+![][9]
-4. Если вы используете CLI, перейдите в каталог `hello`, созданный вами для проекта, а затем в подкаталог `platforms/android`. Альтернативно, если вы используете инструмент командной строки `create`, просто перейдите в каталог `hello`.
+ [9]: img/guide/platforms/android/asdk_newAVD.png
-5. Нажмите кнопку **Готово**.
+После этого AVD появляется в списке **Android Virtual Devices**:
- [6]: img/guide/platforms/android/eclipse_new_project.png
+![][10]
-После того, как откроется окно Eclipse, красный **X** может показаться, указывая на нерешенные проблемы. Если это так, выполните следующие дополнительные действия:
+ [10]: img/guide/platforms/android/asdk_avds.png
-1. Щелкните правой кнопкой мыши на папке проекта.
+Чтобы открыть эмулятор как отдельное приложение, выберите AVD и нажать кнопку **Start**. Android запускается, также как он запускается на устройстве, с дополнительные элементы управления, доступными для аппаратных кнопок:
-2. В результате диалоговом окне **Свойства** выберите **Android** из области переходов.
+![][11]
-3. Для проекта цели, выбирать самый высокий уровень Android API, среди тех которые вы установили.
+ [11]: img/guide/platforms/android/asdk_emulator.png
-4. Нажмите **кнопку ОК**.
+Для более быстрый восприятия можно использовать `Ускорение виртуальной машины` для повышения скорости выполнения. Многие современные процессоры предоставляют расширения для выполнения виртуальных машин более эффективно. Прежде чем пытаться использовать этот тип ускорения, необходимо определить, поддерживает ли процессор вашей текущей системы развития, одну из следующих технологий виртуализации:
-5. Выберите **Очистить** из меню **Проект** . Это должно исправить все ошибки в проекте.
+* **Технология Виртуализации 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
-Если вы используете CLI для разработки, каталога `www` проекта содержит исходные файлы. Запустите любой из нижеследующего в каталоге проекта для перепостроения приложения:
+Еще один способ узнать, если ваш процессор поддерживает технологию VT-x, это путем выполнения `Утилита идентификации процессора Intel`, для `Windows` вы можете скачать ее с сайта [Центр загрузки Intel ][13], или можно использовать [утилиту booteable][14], который является `ОС-независимой`.
- $ cordova build
- $ cordova build android # do not rebuild other platforms
-
+ [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
-Если вы используете Android-ориентированные инструментыв разработке, используйте другой подход. После того как вы создали проект, исходный код приложения по умолчанию доступен в подкаталоге `assets/www`. Последующие команды доступны в подкаталоге `cordova` проекта.
+После установки и выполнения `Утилита идентификации процессора Intel` в Windows, вы получите следующее окно, чтобы проверить, поддерживает ли ваш процессор технологии виртуализации:
-Команда `build` очищает файлы проекта и перестраивает приложение. Вот синтаксис для Mac и Windows. Первая пара примеров создает отладочную информацию, и второй подписывает приложения для релиза:
+![][15]
- $ /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
-
+ [15]: img/guide/platforms/android/intel_pid_util_620px.png
-## Настройка эмулятора
+Для того, чтобы ускорить эмулятор, вам нужно скачать и установить один или несколько образов системы `Intel x86 Atom`, а также `Менеджер выполнения аппаратного ускорения Intel (HAXM)`.
-Для запуска приложения в эмуляторе можно использовать утилиту CLI `cordova` или Android-ориентированные инструменты командной строки Cordova. В любом случае, SDK сначала должен быть настроен для отображения по крайней мере одного устройства. Чтобы сделать это, используйте Менеджер Android SDK, Java-приложение, которое запускается отдельно от Eclipse. Существует два способа, чтобы открыть его:
+Откройте ваш Android SDK Manager и выберите образ системы `Intel x86 Atom`, для той версии, которую вы хотите проверить. Затем перейдите в раздел `Extras` и выберите `Intel x86 Emulator Accelerator (HAXM)` и установить эти пакеты:
-1. В командной строке запустите `android`.
+![][16]
-2. В Eclipse, нажмите этот значок панели инструментов:
-
- ![][7]
+ [16]: img/guide/platforms/android/asdk_man_intel_image_haxm.png
- [7]: img/guide/platforms/android/eclipse_android_sdk_button.png
+После загрузки, запустите инсталлятор Intel, который доступен в вашем Android SDK в каталоге `extras/intel/Hardware_Accelerated_Execution_Manager`. **Примечание**: `Если у вас есть проблемы с установкой пакета, вы можете найти более подробную информацию и пошаговое руководство в этой` [статье Intel][17].
-После открытия, Android SDK Manager отображает различные библиотеки времени выполнения:
+ [17]: http://software.intel.com/en-us/android/articles/speeding-up-the-android-emulator-on-intel-architecture
-![][8]
+1. Установить одно или несколько образов системы `Intel x86 Atom`, а также `Intel Hardware Accelerated Execution Manager`, доступных в разделе **Extras**.
- [8]: img/guide/platforms/android/asdk_window.png
+2. Запустите инсталлятор Intel, который доступен в вашем Android SDK в каталоге `extras/intel/Hardware_Accelerated_Execution_Manager`.
-Выбрать **Tools → Manage AVDs** (Android Virtual Devices), затем выберите любой элемент из **Device Definitions** в появившемся диалоговом окне:
+3. Создайте новый AVD с выбрав в качестве цели образ Intel.
-![][9]
+4. При запуске эмулятора, удостоверьтесь что нет сообщений об ошибке, указывающих на сбой загрузки модулей HAX.
- [9]: img/guide/platforms/android/asdk_device.png
+## Создание нового проекта
-Нажмите **Create AVD**, при необходимости изменяя имя, затем нажмите **ОК**, чтобы принять изменения:
+На данный момент для создания нового проекта можно выбрать между кросс-платформенным инструментом CLI, описанным в разделе "Интерфейс командной строки", или набор Android-ориентированных инструментов. Из каталога с исходным кодом, вот подход CLI:
-![][10]
+ $ cordova create hello com.example.hello HelloWorld
+ $ cd hello
+ $ cordova platform add android
+ $ ccordova prepare # or "cordova build"
+
- [10]: img/guide/platforms/android/asdk_newAVD.png
+Вот соотвествующий низкоуровневый подход для Unix и Windows:
-После этого AVD появляется в списке **Android Virtual Devices**:
+ $ /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
+
-![][11]
+## Построение проекта
+
+Если вы используете CLI для разработки, каталога `www` проекта содержит исходные файлы. Запустите любой из нижеследующего в каталоге проекта для перепостроения приложения:
- [11]: img/guide/platforms/android/asdk_avds.png
+ $ 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
+
-Чтобы открыть эмулятор как отдельное приложение, выберите AVD и нажать кнопку **Start**. Android запускается, также как он запускается на устройстве, с дополнительные элементы управления, доступными для аппаратных кнопок:
+Если вы используете Android-ориентированные инструментыв разработке, используйте другой подход. После того как вы создали проект, исходный код приложения по умолчанию доступен в подкаталоге `assets/www`. Последующие команды доступны в подкаталоге `cordova` проекта.
-![][12]
+Команда `build` очищает файлы проекта и перестраивает приложение. Вот синтаксис для Mac и Windows. Первая пара примеров создает отладочную информацию, и второй подписывает приложения для релиза:
- [12]: img/guide/platforms/android/asdk_emulator.png
+ $ /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` для развертывания приложения на эмулятор из командной строки:
+Чтобы развернуть приложение на эмуляторе или устройстве из командной строки можно использовать утилиту CLI `cordova` :
- $ cordova emulate android
+ $ 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
-Вместо того чтобы полагаться на то какой эмулятор в настоящее время выбран в SDK, вы можете обратиться к каждому из них по именам, которые вы указывали:
+Можно использовать **cordova run android --list** чтобы увидеть все доступные цели и **cordova run android --target=имя_устройства** для запуска приложения на конкретном устройстве или эмуляторе (например, `cordova run android --target="Nexus4_emulator"`).
- $ /path/to/project/cordova/run --target=NAME
-
+Чтобы увидеть дополнительные параметры построения и запуска также можно использовать **cordova run --help**.
Эта команда установаливает приложение на главной странице и запускает его:
-![][13]
+![][18]
- [13]: img/guide/platforms/android/emulator2x.png
+ [18]: img/guide/platforms/android/emulator2x.png
Когда вы запускаете приложение с помощью `run`, вы также собираете его с помощью `build` автоматически. Вы можете добавить дополнительные флаги `--debug`, `--release`, и `--nobuild` для управления как приложение будет построен, или даже когда перепостроение необходимо:
$ /path/to/project/cordova/run --emulator --nobuild
-Если вместо этого вы работаете в среде Eclipse, щелкните правой кнопкой мыши проект и выберите **Run As → Android Applications**. Вас могут попросить указать AVD, если еще ни один не открыт.
-
-Для более быстрый восприятия можно использовать `Ускорение виртуальной машины` для повышения скорости выполнения. Многие современные процессоры предоставляют расширения для выполнения виртуальных машин более эффективно. Прежде чем пытаться использовать этот тип ускорения, необходимо определить, поддерживает ли процессор вашей текущей системы развития, одну из следующих технологий виртуализации:
-
-* **Технология Виртуализации Intel** (VT-x, vmx) → [Список процессоров поддерживающих Intel VT-x][14]
-* **Виртуализация AMD** (AMD-V, SVM), поддерживается только Linux (начиная с May 2006, все процессоры AMD включают AMD-V, за исключением Sempron).
-
- [14]: http://ark.intel.com/products/virtualizationtechnology
-
-Еще один способ узнать, если ваш процессор поддерживает технологию VT-x, это путем выполнения `Утилита идентификации процессора Intel`, для `Windows` вы можете скачать ее с сайта [Центр загрузки Intel ][15], или можно использовать [утилиту booteable][16], который является `ОС-независимой`.
-
- [15]: https://downloadcenter.intel.com/Detail_Desc.aspx?ProductID=1881&DwnldID=7838
- [16]: https://downloadcenter.intel.com/Detail_Desc.aspx?ProductID=1881&DwnldID=7840&lang=eng
-
-После установки и выполнения `Утилита идентификации процессора Intel` в Windows, вы получите следующее окно, чтобы проверить, поддерживает ли ваш процессор технологии виртуализации:
-
-![][17]
-
- [17]: 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)` и установить эти пакеты:
-
-![][18]
-
- [18]: img/guide/platforms/android/asdk_man_intel_image_haxm.png
-
-После загрузки, запустите инсталлятор Intel, который доступен в вашем Android SDK в каталоге `extras/intel/Hardware_Accelerated_Execution_Manager`. **Примечание**: `Если у вас есть проблемы с установкой пакета, вы можете найти более подробную информацию и пошаговое руководство в этой` [статье Intel][19].
-
- [19]: 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.
+ $ /path/to/project/cordova/log
+ C:\path\to\project\cordova\log.bat
+
-4. При запуске эмулятора, удостоверьтесь что нет сообщений об ошибке, указывающих на сбой загрузки модулей HAX.
+Следующие команды очищают файлы проекта:
-## Развертывание на устройство
+ $ /path/to/project/cordova/clean
+ C:\path\to\project\cordova\clean.bat
+
-Для публикации приложение непосредственно на устройство, убедитесь, что включена отладка USB на вашем устройстве, как описано на [сайте разработчика Android][20] и используя кабель мини-USB, подключите устройство к вашей системе.
+## Откройте новый проект в SDK
- [20]: http://developer.android.com/tools/device.html
+После того, как платформа android добавлена в ваш проект, вы можете открыть проект в [Android Studio][6]:
-Можно использовать эту команду CLI чтобы установить приложение на устройство:
+1. Запустите приложение **Android Studio** .
- $ cordova run android
+2. Выберите пункт **Import Project (Eclipse ADT, Gradle, etc)**.
+ ![][19]
-.. или использовать этот Android-ориентированный интерфейс командной строки:
-
- $ /path/to/project/cordova/run --device
+3. Выберите местоположение, где платформа android сохраняется (`ваш/каталог/проекта/platforms/android`).
+ ![][20]
-Если флаги не указаны команда `run` обнаруживает подключенное устройство, или в настоящее время работающий эмулятор, если устройство не найдено, в противном случае она попросит указать эмулятор.
+4. Для вопроса `Gradle Sync` можно просто ответить **Yes**.
-Чтобы запустить приложение в Eclipse, щелкните правой кнопкой мыши на проект и выберите **Run As → Android Application**.
+ [19]: img/guide/platforms/android/asdk_import_project.png
+ [20]: img/guide/platforms/android/asdk_import_select_location.png
-## Другие команды
+Все готово теперь и можно построить и запустить приложение непосредственно из `Android студии`.
-Следующие команды задают детальное протоколирование приложения, во время его работы:
+![][21]
- $ /path/to/project/cordova/log
- C:\path\to\project\cordova\log.bat
-
+ [21]: img/guide/platforms/android/asdk_import_done.png
-Следующие команды очищают файлы проекта:
+Увидеть [обзор Android студии][22] и и [Построение и запуск из Android студии][23] для более подробной информации.
- $ /path/to/project/cordova/clean
- C:\path\to\project\cordova\clean.bat
\ No newline at end of file
+ [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
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/3c9fa2f6/docs/ru/edge/guide/platforms/android/tools.md
----------------------------------------------------------------------
diff --git a/docs/ru/edge/guide/platforms/android/tools.md b/docs/ru/edge/guide/platforms/android/tools.md
index 9f966d2..70b2bfa 100644
--- a/docs/ru/edge/guide/platforms/android/tools.md
+++ b/docs/ru/edge/guide/platforms/android/tools.md
@@ -69,6 +69,38 @@ license: Licensed to the Apache Software Foundation (ASF) under one
Убедитесь, что вы создали по крайней мере одно виртуальное устройство 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
@@ -83,13 +115,76 @@ license: Licensed to the Apache Software Foundation (ASF) under one
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'
+ }
+
-Если вы хотите позвонить муравей непосредственно из командной строки, такие как `ant debug install` , вам нужно указать дополнительные параметры в команду ant:
+Обратите внимание, что плагины могут также включать файлы `build-extras.gradle` через:
- ant debug install -Dout.dir=ant-build -Dgen.absolute.dir=ant-gen
+ <framework src="some.gradle" custom="true" type="gradleReference" />
-Это потому что каталоги, используемые в Cordova муравей скрипты отличается от по умолчанию. Это делается чтобы избежать конфликтов при запуске из командной строки против муравьев внутри Eclipse/ADT.
+### Пример сборки
-Эти дополнительные параметры добавляются автоматически для вас при использовании `cordova/build` и `cordova/run` сценариев, описанных выше. По этой причине рекомендуется использовать `cordova/build` и `cordova/run` сценарии вместо вызова муравей непосредственно из командной строки.
\ No newline at end of file
+ export ORG_GRADLE_PROJECT_cdvMinSdkVersion=14
+ cordova build android -- --gradleArg=-PcdvBuildMultipleApks=true
\ 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