You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by sh...@apache.org on 2014/01/30 22:21:02 UTC
[10/57] [abbrv] CB-5931 1/28 push latest of edge for Russian Cordova
3.4
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/b87ed7c8/docs/ru/edge/plugin_ref/plugman.md
----------------------------------------------------------------------
diff --git a/docs/ru/edge/plugin_ref/plugman.md b/docs/ru/edge/plugin_ref/plugman.md
index a534b2e..2a8c94b 100644
--- a/docs/ru/edge/plugin_ref/plugman.md
+++ b/docs/ru/edge/plugin_ref/plugman.md
@@ -16,69 +16,150 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
# Использование Plugman для управления расширениями
-Начиная с версии 3.0 Cordova реализует все API устройства как плагины и оставляет их не подключенными по умолчанию. Также поддерживается два различных способа добавления и удаления плагинов. Во-первых, с помощью `cordova CLI` через интерфейс командной строки. Во-вторых, с помощью интерфейса командной строки нижнего уровня [plugman][1]. Это руководство основано на втором подходе, который может быть полезен для разработчиков, желающих обновить свою версию Cordova, но которые еще не применяли Cordova CLI на практике.
+Начиная с версии 3.0 Cordova реализует все API устройства как плагины и оставляет их по умолчанию отключенными. Также поддерживается два различных способа добавления и удаления плагинов. Первый способ, с использованием команды `cordova` описан в разделе "Интерфейс командной строки CLI". Второй, это использовать низкоуровневый интерфейс командной строки [Plugman][1] (процесс "Платформо-ориентированная разработка"). Основные различия между этими двумя путями разработки это то, что Plugman может добавлять плагины только к одной платформе за раз, в то время как CL
I может добавлять плагины ко всем платформам которые с которыми вы работаете. Из-за этого, более практично использовать Plugman когда вы плотно работаете с возможностями платформы, отсюда и название процесса - "Платформо-ориентированная разработка".
[1]: https://github.com/apache/cordova-plugman/
-Для дополнительной информации о plugman смотрите [файл README в репозитории][2].
+Для получения дополнительной информации о Plugman, в особенности если вы заинтересованы в использовании Plugman как модуля для Node или хакинга с кодом Plugman, смотрите [файл README репозитарии проекта][2].
[2]: https://github.com/apache/cordova-plugman/blob/master/README.md
-## Основные команды
+## Установка Plugman
-Чтобы установить plugman, вам потребуется установить [node.js][3] на свою машину:
+Чтобы установить plugman, вам потребуется установить [node.js][3] на свою машину. Вы можете запустить следующую команду, из любого места в вашем окружении командной строки для того чтобы установить plugman глобально, так что он будет доступен из любой директории на вашем компьютере:
[3]: http://nodejs.org/
- npm install -g plugman
+ $ npm install -g plugman
-Вот синтаксис добавления плагина вне зависимости от выбранной платформы:
+Вы также должны иметь `git` добавленный в переменную окружения `PATH`, для того чтобы иметь возможность устанавливать плагины непосредственно из удаленных репозитариев Git.
- plugman --platform <ios|android|blackberry10|wp7|wp8> --project <directory> --plugin <name|url|path> [--plugins_dir <directory>] [--www <directory>] [--variable <name>=<value> [--variable <name>=<value> ...]]
+**Совет:** если после установки plugman с помощью npm, вы обнаружили что вы по прежнему не можете запустить ни одну из команд `plugman`, убедитесь что вы добавили каталог `/npm/` в переменную окружения `PATH`.
+
+**Замечание:** Вы можете пропустить этот шаг, если не хотите захламлять ваше глобальное пространство имен npm устанавливая Plugman. Если это ваш случай, то когда вы создаете проект Cordova с использованием командной строки, создастся каталог `node_modules` внутри вашего проекта, которая содержит Plugman. Так как вы не установили его глобально, вам придётся вызывать node для каждой команды Plugman, к примеру `node ./node_modules/plugman/main.js -version`. Остальная часть этой инструкции предполагает что вы установили Plugman глобально, что означает что вы можете вызывать его с использовани
ем просто `plugman`.
+
+## Создайте проект Cordova
+
+Перед тем как использовать Plugman, вы должны создать проект Cordova. Вы можете сделать это либо с использование Интерфейса командной строки или с использованием низкоуровневых утилит командной строки. Инструкции по использованию утилит командной строки для создания вашего проекта, расположены в различных разделах "Инструменты командной строки" указанных на странице "Руководство по поддерживаемым платформам".
+
+## Добавление плагина
+
+После того как вы установили Plugman и создали проект Cordova, вы можете начать добавлять плагины к платформе с помощью:
+
+ $ plugman --platform <ios|amazon-fireos|android|blackberry10|wp7|wp8> --project <directory> --plugin <name|url|path> [--plugins_dir <directory>] [--www <directory>] [--variable <name>=<value> [--variable <name>=<value> ...]]
+
+
+Используя минимальные параметры эта команда установит плагин в проект Cordova. Вы должны указать платформу и расположение проекта Cordоva для этой платформы. Также вы должны указать добавляемый плагин, с использованием различных форм параметра `--plugin`:
+
+* `name`: Имя каталога где расположено содержимое плагина. Имя должно соответствовать существующему каталогу расположенному по пути, указанному в параметре `--plugins_dir` (смотрите ниже за подробной информацией) или имени плагина в реестре плагинов Cordova.
+* `url`: URL начинающийся с https:// или git://, и указывающий на существующий репозиторий Git который можно клонировать, и который содержит файл `plugin.xml`. Содержимое этого репозитория будет скопировано в `--plugins_dir`.
+* `path`: Путь к каталогу, содержащему плагин, который включает в себя файл `plugin.xml`. Содержимое расположенное по этому пути будет скопировано в `--plugins_dir`.
+
+Другие параметры:
+
+* `--plugins_dir` по умолчанию, `<project>/cordova/plugins`, но может быть любым каталогом, котобый содержит подкаталог для каждого загруженного плагина.
+* `--www` поумолчанию каталог `www`, но может быть любой директорией которая будет использоваться проектом Cordova как каталог содержащий веб ресурсы приложения.
+* `--variable` позволяет указывать определенные переменные во время установки, для некоторых плагинов необходимо указывать ключи API или другие настраиваемые параметры. Пожалуйста посмотрите [спецификацию плагинов][4] для детальной информации.
+
+ [4]: plugin_spec.md
+
+## Удаление плагина
+
+Для удаления плагина, вы должны просто указать флаг `--uninstall` и указать код плагина (ID плагина).
+
+ $ plugman --uninstall --platform <ios|amazon-fireos|android|blackberry10|wp7|wp8> --project <directory> --plugin <id> [--www <directory>] [--plugins_dir <directory>]
+
+
+## Команды справки
+
+Plugman поддерживает общую команду help которая может помочь вам если вы в тупике или испытываете проблемы. Она отобразит список доступных команд Plugman и их синтаксис:
+
+ plugman -help
+ plugman # same as above
+
+
+**Примечание**: `plugman -help` может показывать некоторые дополнительные команды по работе с реестром плагинов. Эти команды предназначены для разработчиков плагинов и могут быть не реализованы в реестрах плагинов третьих сторон.
+
+Вы также можете добавить флаг `--debug|-d` к любой команде Plugman для того чтобы запустить эту команду в диагностическом режиме, который будет отображать внутренние отладочные сообщения, по мере их формирования, что может помочь вам отследить проблемы, как например отсутствующие файлы в плагине.
+
+ # Adding Android battery-status plugin to "myProject":
+ plugman -d --platform android --project myProject --plugin org.apache.cordova.battery-status
+
+
+Наконец, вы можете использовать флаг `--version|-v` для того чтобы узнать какую версию Plugman вы используете.
+
+ plugman -v
+
+
+## Действия с реестром плагинов
+
+Существует несколько команд plugman которые могут быть использованы для взаимодействия с [Реестром плагинов][5]. Пожалуйста обратите внимание что эти команды реестра специфичны для реестра плагинов *plugins.cordova.io* и могут не быть реализованы реестрами плагинов от посторонних поставщиков.
+
+ [5]: http://plugins.cordova.io
+
+### Поиск плагина
+
+Вы можете использовать Plugman для поиска в [Реестре плагинов][5] плагинов, которые соответствуют указанному списку ключевых слов, разделенных между собой запятыми.
+
+ plugman search <plugin keywords>
+
+
+### Смена реестра плагинов
+
+Вы можете получить или установить URL текущего реестра плагинов который использует plugman. Большей частью вы должны оставить это значение установленным в http://registry.cordova.io за исключением если вы хотите использовать реестр плагинов постороннего поставщика.
+
+ plugman config set registry <url-to-registry>
+ plugman config get registry
-Для удаления плагина:
+### Получение информации о плагине
+
+Вы можете получить информацию о определенном плагине, сохраненном в реестре с помощью:
- plugman --uninstall --platform <ios|android|blackberry10|wp7|wp8> --project <directory> --plugin <id> [--www <directory>] [--plugins_dir <directory>]
+ plugman info <id>
-## Установка модулей ядра
+Эта команда свяжется с реестром плагинов и получит информацию, такую как номер версии плагина.
-Приведенные ниже примеры показывают, как добавлять плагины по мере необходимости, так чтобы любой Cordova API, который вы используете в вашем проекте, по-прежнему продолжил работать после обновления до версии 3.0. Для каждой команды, необходимо выбрать целевую платформы, и ссылаться на каталог проекта платформы.
+## Установка базовых плагинов
-* cordova-plugin-battery-status plugman --platform <ios|android|blackberry10|wp7|wp8> --project <directory> --plugin org.apache.cordova.battery-status
+Приведенные ниже примеры показывают, как добавлять плагины по мере необходимости, так чтобы любая часть Cordova API, которую вы используете в вашем проекте, по-прежнему продолжала работать после обновления до версии 3.0. Для каждой команды, необходимо выбрать целевую платформы, и ссылаться на каталог проекта платформы.
+
+* cordova-plugin-battery-status
+
+ plugman --platform <ios|amazon-fireos|android|blackberry10|wp7|wp8> --project <directory> --plugin org.apache.cordova.battery-status
-* cordova-plugin-camera plugman --platform <ios|android|blackberry10|wp7|wp8> --project <directory> --plugin org.apache.cordova.camera
+* cordova-plugin-camera plugman --platform <ios|amazon-fireos|android|blackberry10|wp7|wp8> --project <directory> --plugin org.apache.cordova.camera
-* cordova-plugin-console plugman --platform <ios|android|blackberry10|wp7|wp8> --project <directory> --plugin org.apache.cordova.console
+* cordova-plugin-console plugman --platform <ios|amazon-fireos|android|blackberry10|wp7|wp8> --project <directory> --plugin org.apache.cordova.console
-* cordova-plugin-contacts plugman --platform <ios|android|blackberry10|wp7|wp8> --project <directory> --plugin org.apache.cordova.contacts
+* cordova-plugin-contacts plugman --platform <ios|amazon-fireos|android|blackberry10|wp7|wp8> --project <directory> --plugin org.apache.cordova.contacts
-* cordova-plugin-device plugman --platform <ios|android|blackberry10|wp7|wp8> --project <directory> --plugin org.apache.cordova.device
+* cordova-plugin-device plugman --platform <ios|amazon-fireos|android|blackberry10|wp7|wp8> --project <directory> --plugin org.apache.cordova.device
-* cordova-plugin-device-motion (accelerometer) plugman --platform <ios|android|blackberry10|wp7|wp8> --project <directory> --plugin org.apache.cordova.device-motion
+* cordova-plugin-device-motion (accelerometer) plugman --platform <ios|amazon-fireos|android|blackberry10|wp7|wp8> --project <directory> --plugin org.apache.cordova.device-motion
-* cordova-plugin-device-orientation (compass) plugman --platform <ios|android|blackberry10|wp7|wp8> --project <directory> --plugin org.apache.cordova.device-orientation
+* cordova-plugin-device-orientation (compass) plugman --platform <ios|amazon-fireos|android|blackberry10|wp7|wp8> --project <directory> --plugin org.apache.cordova.device-orientation
-* cordova-plugin-dialogs plugman --platform <ios|android|blackberry10|wp7|wp8> --project <directory> --plugin org.apache.cordova.dialogs
+* cordova-plugin-dialogs plugman --platform <ios|amazon-fireos|android|blackberry10|wp7|wp8> --project <directory> --plugin org.apache.cordova.dialogs
-* cordova-plugin-file plugman --platform <ios|android|blackberry10|wp7|wp8> --project <directory> --plugin org.apache.cordova.file
+* cordova-plugin-file plugman --platform <ios|amazon-fireos|android|blackberry10|wp7|wp8> --project <directory> --plugin org.apache.cordova.file
-* cordova-plugin-file-transfer plugman --platform <ios|android|blackberry10|wp7|wp8> --project <directory> --plugin org.apache.cordova.file-transfer
+* cordova-plugin-file-transfer plugman --platform <ios|amazon-fireos|android|blackberry10|wp7|wp8> --project <directory> --plugin org.apache.cordova.file-transfer
-* cordova-plugin-geolocation plugman --platform <ios|android|blackberry10|wp7|wp8> --project <directory> --plugin org.apache.cordova.geolocation
+* cordova-plugin-geolocation plugman --platform <ios|amazon-fireos|android|blackberry10|wp7|wp8> --project <directory> --plugin org.apache.cordova.geolocation
-* cordova-plugin-globalization plugman --platform <ios|android|blackberry10|wp7|wp8> --project <directory> --plugin org.apache.cordova.globalization
+* cordova-plugin-globalization plugman --platform <ios|amazon-fireos|android|blackberry10|wp7|wp8> --project <directory> --plugin org.apache.cordova.globalization
-* cordova-plugin-inappbrowser plugman --platform <ios|android|blackberry10|wp7|wp8> --project <directory> --plugin org.apache.cordova.inappbrowser
+* cordova-plugin-inappbrowser plugman --platform <ios|amazon-fireos|android|blackberry10|wp7|wp8> --project <directory> --plugin org.apache.cordova.inappbrowser
-* cordova-plugin-media plugman --platform <ios|android|blackberry10|wp7|wp8> --project <directory> --plugin org.apache.cordova.media
+* cordova-plugin-media plugman --platform <ios|amazon-fireos|android|blackberry10|wp7|wp8> --project <directory> --plugin org.apache.cordova.media
-* cordova-plugin-media-capture plugman --platform <ios|android|blackberry10|wp7|wp8> --project <directory> --plugin org.apache.cordova.media-capture
+* cordova-plugin-media-capture plugman --platform <ios|amazon-fireos|android|blackberry10|wp7|wp8> --project <directory> --plugin org.apache.cordova.media-capture
-* cordova-plugin-network-information plugman --platform <ios|android|blackberry10|wp7|wp8> --project <directory> --plugin org.apache.cordova.network-information
+* cordova-plugin-network-information plugman --platform <ios|amazon-fireos|android|blackberry10|wp7|wp8> --project <directory> --plugin org.apache.cordova.network-information
-* cordova-plugin-splashscreen plugman --platform <ios|android|blackberry10|wp7|wp8> --project <directory> --plugin org.apache.cordova.splashscreen
+* cordova-plugin-splashscreen plugman --platform <ios|amazon-fireos|android|blackberry10|wp7|wp8> --project <directory> --plugin org.apache.cordova.splashscreen
-* cordova-plugin-vibration plugman --platform <ios|android|blackberry10|wp7|wp8> --project <directory> --plugin org.apache.cordova.vibration
\ No newline at end of file
+* cordova-plugin-vibration plugman --platform <ios|amazon-fireos|android|blackberry10|wp7|wp8> --project <directory> --plugin org.apache.cordova.vibration
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/b87ed7c8/docs/ru/edge/plugin_ref/spec.md
----------------------------------------------------------------------
diff --git a/docs/ru/edge/plugin_ref/spec.md b/docs/ru/edge/plugin_ref/spec.md
index 3078286..978a4d7 100644
--- a/docs/ru/edge/plugin_ref/spec.md
+++ b/docs/ru/edge/plugin_ref/spec.md
@@ -27,22 +27,22 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
version="1.0.2">
-## элемент `< plugin >`
+## Элемент *plugin*
-Элементом `plugin` является элементом верхнего уровня. Он имеет следующие атрибуты:
+Элементом `plugin` является элементом верхнего уровня в файле манифеста плагина. Он имеет следующие атрибуты:
-* `xmlns`(обязательно): пространство имен плагин, `http://apache.org/cordova/ns/plugins/1.0` . Если документ содержит XML из другого пространства имен, такие как теги для добавления `AndroidManifest.xml` файл, эти пространства имен также должны быть включены в элемент верхнего уровня.
+* `xmlns`(обязательно): пространство имен plugin, `http://apache.org/cordova/ns/plugins/1.0` . Если документ содержит XML из другого пространства имен, такие как теги для добавления `AndroidManifest.xml` файл, эти пространства имен также должны быть включены в элемент верхнего уровня.
-* `id`(обязательно): реверс домена стиль идентификатор для плагина, такие как`com.alunny.foo`
+* `id` (обязательный): уникальный идентификатор плагина, записывается в обратном формате доменных имен, например `com.alunny.foo`
-* `version`(обязательно): номер версии для плагина, который соответствует следующее регулярное выражение майор минор патч стиль:
+* ` version ` (обязательный): номер версии плагина, который соответствует условиям следующего регулярного выражения:
^\d+[.]\d+[.]\d+$
-## элементы `< engines >` и `< engine >`
+## Элементы *engines* и *engine*
-Дочерние элементы `<engines>` элемент указать версии на основе Apache Cordova рамок, которые поддерживает этот плагин. Пример:
+Дочерние элементы для элемента `<engines>` определяют основанный на Apache Cordova фреймоворк, который поддерживается данным плагином. Пример:
<engines>
<engine name="cordova" version="1.7.0" />
@@ -51,12 +51,12 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
</engines>
-Похож на `<plugin>` элемента `version` атрибут, указанной версии строка должна соответствовать строка майор минор патч, соответствует регулярное выражение:
+Аналогично атрибуту ` version ` элемента `<plugin>` , указанная версия должна соответствовать регулярному выражению:
^\d+[.]\d+[.]\d+$
-Элементы двигателя также могут указать нечетких матчей, чтобы избежать повторения и по сокращению обслуживания, когда обновляется базовой платформы. Инструменты следует поддерживать как минимум `>` , `>=` , `<` и `<=` , например:
+Элементы engine также могут указывать нечеткие параметры совпадения версий, чтобы избежать повторений или по упрощению поддержки, во время обновления платформы. Инструментарий проверяющий совместимость должен поддерживать как минимум определения содержащие `>` , `>=` , `<` и `<=` , например:
<engines>
<engine name="cordova" version=">=1.7.0" />
@@ -64,7 +64,7 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
</engines>
-'<engine>' теги также имеет поддержку по умолчанию для всех основных платформ, Кордова существует на. Указав тег двигателя «cordova» означает, что все версии Cordova на любой платформе должны удовлетворить атрибут версии двигателя. Для того, чтобы переопределить обработчик catch-all 'cordova', может перечислить конкретные платформы и их версии:
+Теги `<engine>` также поддерживаются на всех платформах, на которых работает Cordova. Указание имени `cordova` для тега engine означает, что все версии Cordova на любой платформе должны соответствовать версии указанной в атрибуте version. Для того, чтобы переопределить включающий в себя все платформы тег engine со значением `cordova`, вы можете указывать индивидуальные платформы и их версии:
<engines>
<engine name="cordova" version=">=1.7.0" />
@@ -73,9 +73,10 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
</engines>
-Вот список по умолчанию двигателей, '<engine>' тег поддерживает: * «cordova» * «cordova-plugman» * «cordova андроид» * «cordova-ios» * «cordova-blackberry10» * «cordova-wp7» * «cordova-wp8» * «cordova-windows8»
+Вот список платформ, который тег 'engine<engine>' поддерживает: * 'cordova' * 'cordova-plugman' * 'cordova-amazon-fireos' * 'cordova-android' * 'cordova-ios' * 'cordova-blackberry10' * 'cordova-wp7' * 'cordova-wp8' * 'cordova-windows8'
+* 'android-sdk' // возвращает наивысший установленный уровень Android API * 'apple-xcode' // возвращает версию xcode * 'apple-ios' // возвращает наивысшую, установленную версию iOS * 'apple-osx' // возвращает версию OSX * 'blackberry-ndk' // возвращает версию нативную BlackBerry SDK
-Указание пользовательских рамок на основе Apache Cordova должны быть перечислены под двигатель тег следующим образом:
+Указание пользовательских фреймвёрков на основе Apache Cordova должны быть перечислены с использованием тега engine следующим образом:
<engines>
<engine name="my_custom_framework" version="1.0.0" platform="android" scriptSrc="path_to_my_custom_framework_version"/>
@@ -84,62 +85,62 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
</engines>
-Пользовательские на основе Apache Cordova framework требует, что элемент двигателя включает в себя следующие атрибуты: «имя», «версия», «scriptSrc» и «платформа».
+При указании пользовательского фреймвёрка основанного на Apache Cordova обязательно, чтобы элемент engine включал в себя следующие атрибуты: `name` , `version` , `scriptSrc` , и`platform`.
-* `name`(обязательно): понятное имя для вашей пользовательской основы.
+* `name`(обязательно): Отображаемое пользователю имя вашего фреймвёрка.
-* `version`(обязательно): версия, чтобы установить должны иметь ваши рамки.
+* `version`(обязательно): минимальная версия вашего фреймвёрка, которая требуется для установки плагина.
-* `scriptSrc`(обязательно): файл сценария, который говорит plugman, какая версия пользовательской базы. В идеале этот файл должен быть в каталоге верхнего уровня плагин каталога.
+* `scriptSrc`(обязательно): файл сценария, который говорит plugman, какая версия пользовательского фреймвёрка установлена. В идеале этот файл должен быть в каталоге верхнего уровня каталога plugin.
-* `platform`(обязательно): какие платформы, которые поддерживает ваш рамки. Вы можете использовать подстановочный знак ' *' сказать поддерживается для всех платформ, укажите несколько с символом как «android|ios|blackberry10» или просто одной платформы, как «андроид».
+* `platform`(обязательно): какие платформы, поддерживает ваш фреймвёрк. Вы можете использовать подстановочный знак `*` для указания того что поддерживаются все платформ, или укажите имена платформ разделенные символом |, например `android|ios|blackberry10` или просто одну платформу, например: `android`.
-plugman прерывает с ненулевой код для любой плагин, чьи целевой проект не соответствует двигателя ограничений.
+plugman завершает выполнение с ненулевым кодом ошибки для любого плагина, который будет добавляться в проект, параметры которого не соответствует ограничениям необходимого фреймвёрка для данного плагина.
-Если не `<engine>` указаны теги, plugman пытается установить в каталог проекта указанного cordova слепо.
+Если теги `<engine>` не указаны, plugman пытается установить плагин в каталог проекта Cordova без проверки ограничений.
-## `<name>`элемент
+## Элемент *name*
-Понятное имя для плагина, содержание которых текст содержит имя плагина. Например:
+Текст содержащий название плагина, как оно будет отображаться пользователям. Например:
<name>Foo</name>
-Этот элемент не (пока) обрабатывать локализации.
+Этот элемент (пока) не поддерживает локализацию.
-## `<description>`элемент
+## Элемент *description*
-Немашинное описание для плагина. Текстовое содержимое элемента содержит описание плагина. Пример:
+Текст содержащий описание плагина, как оно будет отображаться пользователям. Например:
<description>Foo plugin description</description>
-Этот элемент не (пока) обрабатывать локализации.
+Этот элемент (пока) не поддерживает локализацию.
-## `<author>`элемент
+## Элемент *author*
-Имя автора плагина. Текстовое содержимое элемента содержит имя автора плагина. Пример:
+Имя автора плагина. Текстовое содержимое элемента содержит имя автора плагина. Например:
<author>Foo plugin description</author>
-## `<keywords>`элемент
+## Элемент *keywords*
-Плагин ключевые слова. Текстовое содержимое элемента содержит запятую ключевые слова для описания плагина. Пример:
+Ключевые слова для плагина. Текстовое содержимое элемента содержит разделенные запятыми ключевые слова характеризующие плагин. Например:
<keywords>foo,bar</keywords>
-## `<license>`элемент
+## Элемент *Лицензия*
-Плагин лицензия. Текстовое содержимое элемента содержит плагин лицензию. Пример:
+Лицензия на использование плагина. Текстовое содержимое элемента содержит лицензию для плагина. Например:
<license>Apache 2.0 License</license>
-## `<asset>`элемент
+## Элемент *asset*
-Один или несколько элементов перечисления файлов или каталогов копируется в приложение Cordova `www` каталог. Примеры:
+Один или несколько элементов указывающие файлы или каталоги, которые будут копироваться в каталог `www` приложения Cordova. Примеры:
<!-- a single file, to be copied in the root directory -->
<asset src="www/foo.js" target="foo.js" />
@@ -147,81 +148,81 @@ plugman прерывает с ненулевой код для любой пла
<asset src="www/foo" target="foo" />
-Все `<asset>` теги требуют оба `src` и `target` атрибуты. Веб только плагины содержит в основном `<asset>` элементов. Любые `<asset>` элементы, вложенные в `<platform>` элементы определяют web платформа специфического активов, как описано ниже. Атрибуты включают в себя:
+Все теги `<asset>` должны содержать атрибуты `src` и `target`. Веб-плагины состоят в основном из элементов `<asset>`. Любые теги `<asset>`, вложенные в теги `<platform>` определяют ресурсы, которые специфичны для определенной платформы, как описано ниже. Атрибуты включают в себя:
-* `src`(обязательно): файл или каталог, где расположен в плагина пакет, относительно `plugin.xml` документ. Если файл не существует в указанном `src` расположение, plugman останавливается и отменяет процесс установки, выдает уведомление о конфликте и выходит с ненулевой код.
+* `src`(обязательно): расположение файла или каталога, в пакете плагина, относительно документа `plugin.xml`. Если файл не существует в указанном в `src` расположении, plugman останавливается и отменяет процесс установки, выдает уведомление о конфликте и выходит с ненулевым кодом.
* `target`(обязательно):
- Файл или каталог, должны располагаться в Cordova app, относительно `www` каталог. Активы могут быть направлены в подкаталоги, например:
+ Месторасположение файла или каталога, в приложении Cordova, где должны располагаться ресурсы указанные в теге src. Месторасположение указывается относительно каталога `www`. Ресурсы могут быть перемещены в подкаталогах, например:
<asset src="www/new-foo.js" target="js/experimental/foo.js" />
- создает `js/experimental` каталогов в пределах `www` каталог, если только уже присутствует, то копии `new-foo.js` файл и переименовывает его `foo.js` . Если файл уже существует в целевом расположении, plugman останавливается и отменяет процесс установки, выдает уведомление о конфликте и выходит с ненулевой код.
+ создает каталог `js/experimental` в пределах каталога `www`, если только этот каталогу уже не существует, затем копирует `new-foo.js` файл и переименовывает его в `foo.js` . Если файл уже существует в целевом расположении, plugman останавливается и отменяет процесс установки, выдает уведомление о конфликте и выходит с ненулевым кодом.
-## `<js-module>`элемент
+## Элемент *js-module*
-Большинство плагинов включают один или несколько файлов JavaScript. Каждый `<js-module>` тег соответствует файл JavaScript и предотвращает пользователей плагина для добавления `<script>` тег для каждого файла. В то время как `<asset>` теги просто скопировать файл из подкаталога плагин в `www` , `<js-module>` теги являются гораздо более сложными. Они выглядят так:
+Большинство плагинов включают один или несколько файлов JavaScript. Каждый элемент `<js-module>` соответствует файлу JavaScript и устраняет необходимость в добавлении тега `<script>` для каждого файла, в файле index.html. В то время как теги `<asset>` просто копируют файл из подкаталога плагина в каталог `www`, теги `<js-module>` являются гораздо более сложными конструкциями. Они выглядят так:
<js-module src="socket.js" name="Socket">
<clobbers target="chrome.socket" />
</js-module>
-При установке плагина с в примере выше, `socket.js` копируется в `www/plugins/my.plugin.id/socket.js` и добавлены в качестве записи для `www/cordova_plugins.js` . Во время загрузки, код в `cordova.js` использует XHR для считывания каждого файла и придать `<script>` тег в HTML. Он добавляет сопоставление избить или объединить в соответствующих случаях, как описано ниже.
+При установке плагина в примере указанном выше, `socket.js` копируется в `www/plugins/my.plugin.id/socket.js` и для этого файла добавляется запись в файле `www/cordova_plugins.js` . Во время загрузки, код в `cordova.js` использует XHR для считывания каждого файла, зарегистрированного в www/cordova_plugins.js и добавляет тег `<script>` в HTML, для каждого такого файла. Он добавляет сопоставление, описывающее необходимо добавить содержимое файла в общее пространство имен, или расширить уже существующее описание JS объекта, как описано ниже.
-*Не* обернуть файл с `cordova.define` , так как он добавляется автоматически. Модуль упаковывается в закрытия, с `module` , `exports` , и `require` в области, как это нормально для AMD модулей.
+*Не* оборачивайте файл с использованием `cordova.define`, так как это будет осуществляться автоматически. Модуль упаковывается в замыкания(closure), с параметрами `module` , `exports` , и `require` в области видимости, как это принято для AMD модулей.
-Подробная информация для `<js-module>` тега:
+Подробная информация о теге `<js-module>`:
-* `src`Ссылается на файл в директорию плагинов относительно `plugin.xml` файл.
+* `src`: Ссылается на файл в каталоге плагина относительно файла `plugin.xml`.
-* `name`Предоставляет последнюю часть имя модуля. Как правило, может быть, все, что вам нравится, и это только важно, если вы хотите использовать `cordova.require` для импорта других частей ваших плагинов в коде JavaScript. Имя модуля для `<js-module>` это ваш плагин `id` следуют значение `name` . Для примера выше с `id` из `chrome.socket` , это имя модуля`chrome.socket.Socket`.
+* `name`: Определяет последнюю часть имени модуля, определенного в данном файле. Как правило, может быть, все, что вам нравится. Это значение важно только в том случае если вы хотите использовать `cordova.require` для импорта других частей вашего плагина в коде JavaScript. Полное имя AMD модуля для `<js-module>` это `id` вашего плагин со следующим значением `name` . Из примера указанного выше, для плагина с `id` - `chrome.socket` , полное имя модуля`chrome.socket.Socket`.
-* Три теги разрешены в `<js-module>` :
+* Три теги разрешены внутри `<js-module>` :
- * `<clobbers target="some.value"/>`Указывает, что `module.exports` вставляется в `window` объект как `window.some.value` . Вы можете иметь столько `<clobbers>` как вам нравится. Любой объект, не доступны на `window` создан.
+ * `<clobbers target="some.value"/>` Указывает, что значение `module.exports` добавляется в объект `window` таким образом, что становится доступно как `window.some.value` . Вы можете иметь столько `<clobbers>` сколько вам нравится. Любой объект, отсутствующий в объекте `window` будет создан при необходимости.
- * `<merges target="some.value"/>`Указывает, что модуль должны быть объединены с любое существующее значение в `window.some.value` . Если любой ключ уже существует, версия модуля переопределяет оригинала. Вы можете иметь столько `<merges>` как вам нравится. Любой объект, не доступны на `window` создан.
+ * `<merges target="some.value"/>` Указывает, что модуль должны быть объединены с любым уже существующим значением в `window.some.value` . Если какой либо ключ уже существует в объекте window, объект указанный в модуле переопределяет оригинал. Вы можете иметь столько `<merges>` сколько вам нравится. Любой объект, отсутствующий в объекте `window` будет создан при необходимости.
- * `<runs/>`означает, что ваш код должен быть указан с `cordova.require` , но не установлен на `window` объект. Это полезно при инициализации модуля, присоединения обработчиков событий или иным образом. Вы можете иметь только до одного `<runs/>` тег. Обратите внимание, что в том числе `<runs/>` с `<clobbers/>` или `<merges/>` также является излишним, так как они `cordova.require` свой модуль.
+ * `<runs/>`означает, что ваш код должен быть указан с `cordova.require` , но не добавлен к объекту `window`. Это полезно при инициализации модуля, присоединения обработчиков событий или в других случаях. Вы можете иметь не более одного тега `<runs/>`. Обратите внимание, что использование `<runs/>` совместно с `<clobbers/>` или `<merges/>` является излишним, так как эти директивы тоже загружают ваш модуль с помощью `cordova.require`.
- * Пустой `<js-module>` еще загружает и может быть acccessed в других модулях через`cordova.require`.
+ * Пустой `<js-module>` также загружается и может быть доступен в других модулях с помощью `cordova.require`.
-Если `src` не разрешить существующий файл, plugman останавливается и отменяет установку, выдает уведомление о проблеме и выходит с ненулевой код.
+Если `src` не указывает на существующий файл, plugman останавливается и отменяет установку, выдает уведомление о проблеме и выходит с ненулевым кодом.
-Вложение `<js-module>` элементы внутри `<platform>` объявляет платформы JavaScript модуль привязки.
+Вложение тега `<js-module>` внутри элемента `<platform>` объявляет JavaScript модуль, специфический для выбранной платформы.
-## `<dependency>`
+## Элемент *зависимость*
-`<dependency>`Позволяет вам указать другие плагины, от которых зависит текущий плагин. В то время как будущих версий будет доступ к ним из репозиториев плагин, в краткосрочной перспективе плагины прямо упоминается как URL по `<dependency>` теги. Они отформатированы следующим образом:
+Тег `<dependency>` позволяет указать другие плагины, от которых зависит текущий плагин. В то время как будущих версий будет доступ к ним из репозиториев плагинов, в краткосрочной перспективе плагины прямо упоминается по URL в тегах `<dependency>`. Они выглядят следующим образом:
<dependency id="com.plugin.id" url="https://github.com/myuser/someplugin" commit="428931ada3891801" subdir="some/path/here" />
-* `id`: предоставляет идентификатор плагина. Он должен быть глобально уникальным и выраженной в стиле реверс домена. Хотя ни один из этих ограничений в настоящее время применяются, они могут быть в будущем.
+* `id`: определяет идентификатор плагина. Он должен быть глобально уникальным и выраженной в обратном формате доменных имен. Хотя ни одно из этих ограничений в настоящее время не применяется, это может произойти в будущем.
-* `url`: URL-адрес для плагина. Это должно указывать репозиторий git, который plugman пытается клонировать.
+* `url`: URL-адрес для плагина. Этот адрес должен указывать на репозиторий git, который plugman будет пытаться клонировать.
-* `commit`: Это любая ссылка git, понятны `git checkout` : ответвления или метки имя (например, `master` , `0.3.1` ), или фиксации хэш (например,`975ddb228af811dd8bb37ed1dfd092a3d05295f9`).
+* `commit`: Это любая ссылка git, понятная для `git checkout` : имя ветки или тега (например, `master` , `0.3.1` ), или хеша коммита (например,`975ddb228af811dd8bb37ed1dfd092a3d05295f9`).
-* `subdir`: Указывает, что целевой плагин зависимостей существует как подкаталог git-репозиторий. Это полезно, потому что она позволяет репозиторий содержит несколько связанных плагинов, указан каждый индивидуально.
+* `subdir`: Указывает, что зависимость целевого плагина существует как подкаталог git-репозитория. Это полезно, потому что она позволяет определять репозиторий содержащий несколько связанных плагинов, и указывать каждый из них индивидуально.
-В будущем будут введены ограничения версии, и плагин хранилище будет существовать для поддержки выборки по имени вместо явного URL-адресов.
+В будущем будут введены ограничения версии, и репозиторий плагинов будет существовать для поддержки выбора плагина по имени вместо явного URL-адреса.
-### Зависимости в относительные пути
+### Относительные пути для зависимостей
-Если задать `url` из `<dependency>` тег для `"."` и `subdir` , зависимыми плагин установлен из того же местного или удаленного репозитория как родитель плагин, указывающее `<dependency>` тег.
+Если задать `url` для тега`<dependency>` как `"."` и указать `subdir`, зависимый плагин будет установлен из того же локального или удаленного репозитория что и основной плагин, который определил тег `<dependency>`.
-Обратите внимание, что `subdir` всегда указывает путь относительно *корня* git-репозиторий, не родитель плагин. Это верно, даже если вы установили плагин с локальный путь непосредственно к нему. Plugman находит корень репозитория git, а затем находит другой плагин от там.
+Обратите внимание, что `subdir` всегда указывает путь относительно *корня* git-репозитория, а не папки основного плагина. Это верно, даже если вы установили плагин с указанием локального пути к нему. Plugman находит корень репозитория git, а затем находит там же другой плагин.
-## `<platform>`
+## Элемент *platform*
-`<platform>`Тег определяет платформ, которые имеют связанные машинный код или требуют изменения их конфигурации файлов. Инструменты, с помощью этой спецификации можно определить поддерживаемые платформы и установить код в Cordova проекты.
+`<platform>` Тег определяет платформы, которые имеют связанные исходные файлы или требуют изменения в их конфигурационных файлах. Инструменты, с помощью этой спецификации могут определить поддерживаемые платформы и установить код в проекты Cordova.
-Плагины без `<platform>` предполагается, что теги являются только JavaScript и поэтому устанавливаемый на любых платформах.
+Плагины без тегов `<platform>` считаются содержащими только JavaScript и поэтому устанавливаются на любых платформах.
-Образец платформы тег:
+Образец тега platform:
<platform name="android">
<!-- android-specific elements -->
@@ -231,19 +232,20 @@ plugman прерывает с ненулевой код для любой пла
</platform>
-Необходимые `name` атрибут определяет платформу как поддерживается, связав элемент детей с этой платформы.
+Обязательный атрибут `name` поддерживаемую платформу, связывая дочерние элементы с этой платформой.
-Имена платформ должны быть в нижнем регистре. Перечислены имена платформ, как произвольно выбрали:
+Имена платформ должны быть в нижнем регистре. Перечислены имена платформ, в произвольном порядке:
-* андроид
-* bb10
+* amazon-fireos
+* android
+* blackberry10
* iOS
-* WP7
-* РГ.8
+* wp7
+* wp8
-## `<source-file>`
+## Элемент *source-file*
-`<source-file>`Элемент определяет исполняемый файл исходного кода, который должен быть установлен в проект. Примеры:
+Элемент `<source-file>` определяет исполняемый файл исходного кода, который должен быть установлен в проект. Примеры:
<!-- android -->
<source-file src="src/android/Foo.java"
@@ -256,23 +258,23 @@ plugman прерывает с ненулевой код для любой пла
Он поддерживает следующие атрибуты:
-* `src`(обязательно): расположение файла относительно `plugin.xml` . Если `src` не удается найти файл, plugman останавливается и отменяет установку, выдает уведомление об этой проблеме и выходит с ненулевой код.
+* `src`(обязательно): расположение файла относительно `plugin.xml` . Если `src` файл не найден, plugman останавливается и отменяет установку, выдает уведомление об этой проблеме и выходит с ненулевым кодом.
-* `target-dir`: Каталог, в который должны быть скопированы файлы, относительно корня проекта Cordova. На практике, это наиболее важно для платформ на базе Java, где файл в `com.alunny.foo` пакет должен находиться в `com/alunny/foo` каталог. Для платформ, где исходный каталог не имеет значения этот атрибут должен быть опущен.
+* `target-dir`: Каталог, в который должны быть скопированы файлы, относительно корня проекта Cordova. На практике это наиболее важно для платформ на базе Java, где файл в пакете `com.alunny.foo` должен быть расположен в каталоге `com/alunny/foo`. Для платформ, где исходный каталог не имеет значения этот атрибут должен быть опущен.
- Как и в случае с активами, если `target` из `source-file` будет перезаписать существующий файл, plugman останавливается и отменяет установку, выдает уведомление об этой проблеме и выходит с ненулевой код.
+ Как и в случае с ресурсами, если `target` из `source-file` будет перезаписывать существующий файл, plugman остановится и отменит установку. После чего выдаст уведомление об этой проблеме и выйдет с ненулевым кодом.
-* `framework`(только для iOS-устройств): Если значение `true` , также добавляет указанный файл в качестве основы в проект.
+* `framework`(только для iOS-устройств): Если значение `true` , также добавляет указанный файл в качестве фреймвёрка в проект.
-* `compiler-flags`(только для iOS-устройств): Если установлено, присваивает указанный компилятор флаги для конкретного исходного файла.
+* `compiler-flags`(только для iOS-устройств): Если установлено, присваивает указанный флаги компилятора для конкретного исходного файла.
-## `<config-file>`
+## Элемент *config-file*
-Идентифицирует XML файл конфигурации будет изменен, где в этом документе модификация должна происходить, и что следует изменить.
+Идентифицирует XML файл конфигурации который будет изменен, где в этом документе необходимо произвести изменения, и что следует изменить.
-Два типы файлов, которые были протестированы для модификации с этим элементом, `xml` и `plist` файлов.
+Два типа файлов, которые были протестированы на модификацию с использованием этого элемента, `xml` и `plist` файлы.
-`config-file`Элемент позволяет добавить новых детей в XML-дерево документа. Дети, XML-литералы должны быть вставлены в целевом документе.
+Элемент `config-file` позволяет только добавить новые дочерние элементы в XML-дерево документа. Дочерние элементы это XML-литералы которые должны быть вставлены в целевой документ.
Пример для XML:
@@ -296,27 +298,27 @@ plugman прерывает с ненулевой код для любой пла
</config-file>
-Он поддерживает следующие атрибуты:
+Элемент поддерживает следующие атрибуты:
* `target`:
- Файл будет изменен и путь относительно корня проекта Cordova.
+ Файл который будет изменен и путь к нему относительно корня проекта Cordova.
- Целевой объект может включать подстановочный знак ( `*` ) элементов. В этом случае plugman рекурсивно просматривает структуру каталогов проекта и использует первый матч.
+ Целевой объект может включать подстановочный знак (`*`) для элементов. В этом случае plugman рекурсивно просматривает структуру каталогов проекта и использует первое совпадение.
- На iOS, расположение файлов конфигурации относительно корневого каталога проекта не известна, поэтому Указание приёмника из `config.xml` разрешается в`cordova-ios-project/MyAppName/config.xml`.
+ На iOS, расположение файлов конфигурации относительно корневого каталога проекта не известно, поэтому указание приёмника для `config.xml` определяется как `cordova-ios-project/MyAppName/config.xml`.
Если указанный файл не существует, инструмент игнорирует изменения конфигурации и продолжает установку.
-* `parent`: Селектор XPath, ссылки на родительских элементов для добавления в файл config. Если вы используете абсолютные селекторов, можно использовать подстановочный знак ( `*` ) для указания корневого элемента, например,`/*/plugins`.
+* `parent`: Селектор XPath, ссылающийся на на родительский элемент, для добавляемых в конфигурационный файл элементов. Если вы используете абсолютные селекторы, можно использовать подстановочный знак (`*`) для указания корневого элемента, например,`/*/plugins`.
- Для `plist` файлов, `parent` определяет, под какие родительского ключа следует включить указанные XML-данные.
+ Для `plist` файлов, `parent` определяет, в каком родительском ключе следует добавить указанные XML-данные.
- Если селектор не разрешить ребенку указанного документа, остановки инструмента и обратный процесс установки выдает предупреждение и выходит с ненулевой код.
+ Если селектор не находит элемент в указанном документе, инструмент останавливается и процесс установки отменяется, после чего выдает предупреждение и выходит с ненулевым кодом.
-## `<plugins-plist>`
+## Элемент *plugins-plist*
-Это *устаревший* , как он применяется только к cordova-ios 2.2.0 и ниже. Использование `<config-file>` тег для новых версий Cordova.
+Это *устаревший* элемент, как он применяется только к cordova-ios 2.2.0 и ниже. Используйте тег `<config-file>` для новых версий Cordova.
Пример:
@@ -327,23 +329,28 @@ plugman прерывает с ненулевой код для любой пла
</config-file>
-Указывает ключ и значение для добавления к правильной `AppInfo.plist` файл в проекте Cordova iOS. Например:
+Указывает ключ и значение для добавления в корректный файл `AppInfo.plist` в проекте Cordova iOS. Например:
<plugins-plist key="Foo" string="CDVFoo" />
-## `<resource-file>`и`<header-file>`
+## Элементы *resource-file* и *header-file*
-Как исходные файлы, но специально для платформ, таких как iOS, которые отличают между исходные файлы, заголовками и ресурсами. Примеры:
+Как и исходные файлы (source-file), но специально для платформ, таких как iOS, которые делают различия между исходными файлами, заголовками и ресурсами. Например:
<resource-file src="CDVFoo.bundle" />
<resource-file src="CDVFooViewController.xib" />
<header-file src="CDVFoo.h" />
-## `<lib-file>`
+Пример для Android:
+
+ <resource-file src="FooPluginStrings.xml" target="res/values/FooPluginStrings.xml" />
+
+
+## Элемент *lib-file*
-Как источник, ресурсов и файлы заголовка, но специально для платформ, таких как BlackBerry 10, использующих пользователями библиотеки. Примеры:
+Также как исходные файлы, файлы ресурсов и заголовков, но специально для платформ, таких как BlackBerry 10 которые использут созданные пользователем библиотеки. Например:
<lib-file src="src/BlackBerry10/native/device/libfoo.so" arch="device" />
<lib-file src="src/BlackBerry10/native/simulator/libfoo.so" arch="simulator" />
@@ -351,13 +358,13 @@ plugman прерывает с ненулевой код для любой пла
Поддерживаемые атрибуты:
-* `src`(обязательно): расположение файла относительно `plugin.xml` . Если `src` не может быть найдено, plugman останавливается и отменяет установку, выдает предупреждение о проблеме и выходит с ненулевой код.
+* `src`(обязательно): расположение файла относительно `plugin.xml`. Если `src` не удается найти, plugman останавливается и отменяет установку, выдает предупреждение о проблеме и выходит с ненулевым кодом.
-* `arch`: Архитектура для которого `.so` файл был построен, либо `device` или`simulator`.
+* `arch`: Архитектура для которой `.so` файл был построен, либо `device` или`simulator`.
-## `<framework>`
+## Элемент *framework*
-Определяет рамки (обычно часть платформы OS) на которых зависит плагин.
+Определяет фреймвёрк (обычно часть OS/платформы) от которого зависит плагин.
Примеры:
@@ -365,13 +372,13 @@ plugman прерывает с ненулевой код для любой пла
<framework src="social.framework" weak="true" />
-`src`Атрибут определяет рамки, в которых plugman пытается добавить в Кордове проект в правильную моды для данной платформы.
+`src` Атрибут определяет фреймвёрки, которые plugman пытается добавить в проект Cordova, наиболее подходящим для данной платформы образом.
-Необязательный `weak` атрибут – это логическое значение, указывающее, ли рамок должна быть слабо связаны. Значение по умолчанию`false`.
+Необязательный атрибут `weak` – это логическое значение, указывающее, должен ли фреймвёрк быть слабо связан с результирующим исполняемым файлом проекта. Значение по умолчанию`false`.
-## `<info>`
+## Элемент *info*
-Дополнительная информация для пользователей. Это полезно, когда требуется дополнительные шаги, которые не могут быть автоматизированы легко или plugman в рамки. Примеры:
+Дополнительная информация для пользователей. Это полезно, когда требуется дополнительные шаги, которые не могут быть легко автоматизированы или выходят за рамки работы plugman. Примеры:
<info>
You need to install __Google Play Services__ from the `Android Extras` section using the Android SDK manager (run `android`).
@@ -382,36 +389,36 @@ plugman прерывает с ненулевой код для любой пла
</info>
-# Переменные
+## Переменные
-В некоторых случаях плагин может потребоваться внести изменения в конфигурацию зависит от целевого приложения. Например, чтобы зарегистрироваться для C2DM на Android, app, чей идентификатор пакета `com.alunny.message` потребует разрешения, такие как:
+В некоторых случаях плагину может потребоваться внести изменения в конфигурацию в зависимости от целевого приложения. Например, чтобы зарегистрироваться для C2DM на Android, приложение чей идентификатор пакета `com.alunny.message` потребует разрешения, такие как:
<uses-permission
android:name="com.alunny.message.permission.C2D_MESSAGE"/>
-В таких случаях, когда содержание вставлены из `plugin.xml` файл не известно заранее, переменные можно указать знак доллара, последовала серия заглавными буквами, цифрами или знаками подчеркивания. Для приведенного выше примера `plugin.xml` файл будет включать этот тег:
+В таких случаях, когда добавляемое содержание из файл `plugin.xml` не известно заранее, можно указывать переменные с использованием знака доллара, за которым следует серия заглавных букв, цифр или знаками подчеркивания. Для приведенного выше примера, файл `plugin.xml` будет включать следующий тег:
<uses-permission
android:name="$PACKAGE_NAME.permission.C2D_MESSAGE"/>
-plugman заменяет ссылки на переменные с указанным значением, или пустая строка, если не найден. Значение переменной ссылки могут быть обнаружены (в данном случае, от `AndroidManifest.xml` файл) или указанного пользователем инструмент; точный процесс зависит от конкретного инструмента.
+plugman заменяет ссылки на переменные, указанным значением, или пустой строкой, если значение переменной не найдено. Значение переменной могут быть обнаружено (в данном случае, из `AndroidManifest.xml` файла) или указанно пользователем инструмента; точный процесс зависит от конкретного инструмента.
-plugman может запросить пользователям указывать необходимые переменные плагин. Например можно указать ключи API для C2M и карты Google как аргумент командной строки:
+plugman может запросить пользователя указать переменные необходимые плагину. Например можно указать ключи API для C2M и Карт Google как аргумент командной строки:
plugman --platform android --project /path/to/project --plugin name|git-url|path --variable API_KEY=!@CFATGWE%^WGSFDGSDFW$%^#$%YTHGsdfhsfhyer56734
-Чтобы сделать переменную обязательным, `<platform>` тег должен содержать `<preference>` тег. Например:
+Чтобы сделать переменную обязательной, тег `<platform>` должен содержать тег `<preference>`. Например:
<preference name="API_KEY" />
-plugman проверяет, что эти необходимые настройки передаются в. Если нет, то он должен предупредить пользователя как пройти на переменную в и выход с ненулевой код.
+plugman проверяет, переданы ли ему эти необходимые настройки. Если нет, то он должен предупредить пользователя как указать переменную и выйти с ненулевым кодом.
Некоторые имена переменных должны быть зарезервированы, как указано ниже.
## $PACKAGE_NAME
-Реверс домена стиль уникальный идентификатор, соответствующий пакет `CFBundleIdentifier` на iOS или `package` атрибут верхнего уровня `manifest` элемент в `AndroidManifest.xml` файл.
\ No newline at end of file
+Уникальный идентификатор в обратном стиле доменных имен, соответствующий пакету `CFBundleIdentifier` на iOS или атрибут `package` корневого элемента `manifest` в файле `AndroidManifest.xml` файл.
\ No newline at end of file