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:10 UTC
[18/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/guide/appdev/whitelist/index.md
----------------------------------------------------------------------
diff --git a/docs/ru/edge/guide/appdev/whitelist/index.md b/docs/ru/edge/guide/appdev/whitelist/index.md
index 12fb14e..aad9fea 100644
--- a/docs/ru/edge/guide/appdev/whitelist/index.md
+++ b/docs/ru/edge/guide/appdev/whitelist/index.md
@@ -14,189 +14,122 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
under the License.
---
-# Whitelist Путеводитель
+# Контроль доступа к внешним ресурсам (Whitelist)
-## Обзор
+Список разрешенных доменов это модель безопасности, которая контролирует доступ во внешние домены, к которому ваше приложение не имеет доступа. Политика безопасности по умолчанию для Cordova позволяет получить доступ к любому сайту. Прежде чем переносить приложение для рабочую среду, следует сформулировать список разрешений и разрешить доступ к определенным сетевым доменам и поддоменам.
-Белый список ресурсов является модель безопасности, которая контролирует доступ к внешним сетевым ресурсам, таким как `http://google.com` . Политика безопасности по умолчанию Apache Cordova позволяет получить доступ к любому ресурсу на любой сайт в Интернете. Прежде чем переносить приложение к производству, следует пересмотреть свою whitelist и объявить доступ к определенным сетевым домены и поддомены.
-
-## Спецификация
-
-Домен whitelisting закладывает основу для спецификации [W3C виджет доступа][1] . В спецификации доступа виджет `<access>` элемент используется для объявления доступа к определенным сетевым ресурсам. Apache Cordova расширяет это понятие, чтобы позволить whitelisting отдельных сетевых ресурсов (URL). В будущем Apache Cordova будет аннотация белый список реализаций платформы. Однако в настоящее время каждая платформа реализует свой ресурс или домена whitelisting. Далее в этом документе описаны различия между реализациями платформы.
+Cordova следует спецификации [W3C Доступ виджета][1], которая опирается на элемент `<access>` в файле `config.xml` приложения, чтобы включить сетевой доступ к отдельным доменам. Для проектов которые погалаются на процесс с использованием командной строки, описанный в разделе "Интерфейс командной строки", этот файл расположен в корневой папке проекта. В противном случае при использовании пути разработки с использованием платформо-ориентированного кода, места расположения указаны в разделах ниже. (См. различные руководства платформ для получения дополни�
�ельной информации на каждой платформе.)
[1]: http://www.w3.org/TR/widgets-access/
-Общий формат для записи whitelist соответствует спецификации «[шаблону][2]» для Google Chrome упакованных приложений. Ресурсы указываются в URL, но звездочка (*) персонаж может использоваться как «шаблон» в нескольких местах для обозначения «любое значение может пойти здесь». Ниже приводятся конкретные примеры.
-
- [2]: http://developer.chrome.com/apps/match_patterns.html
-
-## Синтаксис
+В следующих примерах демонстрируется синтаксис белый список:
-Доступ ко всем ресурсам на [google.com][3]:
-
- [3]: http://google.com
-
- http://google.com/*
+* Доступ к [google.com][2]:
+ <access origin="http://google.com" />
+
-Доступ ко всем ресурсам в безопасной [google.com][4] ( `https://` ):
-
- [4]: https://google.com
-
- HTTPS://Google.com/ *
-
-
-Доступ к конкретным поддомен [maps.google.com][5]:
-
- [5]: http://maps.google.com
-
- http://maps.google.com/*
+* Доступ по защищенному протоколу к [google.com][3] (`https://`):
+ <access origin="https://google.com" />
+
-Доступ ко всем дочерним доменам на [google.com][3] (например, [mail.google.com][6] и [адресу docs.google.com][7]):
-
- [6]: http://mail.google.com
- [7]: http://docs.google.com
-
- http://*.google.com/*
+* Доступ к поддомену [maps.google.com][4]:
+ <access origin="http://maps.google.com" />
+
-Доступ ко всем ресурсам на [www.google.com][8] по пути «/ мобильный»:
-
- [8]: http://www.google.com
-
- http://www.google.com/mobile/*
+* Доступ для всех поддоменов для домена [google.com][2], например, [mail.google.com][5] и [docs.google.com][6]:
+ <access origin="http://*.google.com" />
+
-Доступ к [google.com][3] на любой протокол (например, HTTP, HTTPS, FTP и т.д):
-
- *://google.com/*
+* Доступ ко *всем* доменам, например, [google.com][2] и [developer.mozilla.org][7]:
-
-Доступ для всех ресурсов в Интернете (например, [google.com][3] и [developer.mozilla.org][9]):
-
- [9]: http://developer.mozilla.org
-
- *
+ <access origin="*" />
+
+ Это значение по умолчанию для вновь созданных проектов CLI.
-## Андроид
+ [2]: http://google.com
+ [3]: https://google.com
+ [4]: http://maps.google.com
+ [5]: http://mail.google.com
+ [6]: http://docs.google.com
+ [7]: http://developer.mozilla.org
-### Подробная информация
+## Список разрешений Amazon Fire OS
-Whitelisting правила находятся в `res/xml/config.xml` и объявил с элементом`<access origin="..." />`.
+Список разрешений расположен в`res/xml/config.xml`.
-Android полностью поддерживает синтаксис "белый список".
+## Список разрешений Android
-### Синтаксис
+Платформа специфического whitelisting правила находятся в`res/xml/config.xml`.
-Доступ к [google.com][3]:
+**Замечание**: Для Android 2.3 или ранее, список разрешения работает только для ссылок `href`, а не для добавленных ресурсов, таких как изображения и скрипты. Принимайте шаги, чтобы исключить добавление скриптов в приложение.
- <access origin="http://google.com/*" />
-
-
-## Ежевика 10
+Переход с помощью ссылки `href` к домену не указанному в списке разрешений приводит к тому что страница открывается в браузере а не в приложении. (Сравните это с поведением iOS указанном ниже.)
-### Подробная информация
+## Список разрешений iOS
-Whitelisting правила находятся в `www/config.xml` и объявил с элементом`<access origin="..." />`.
+Список разрешения для платформы может быть найден в файле `config.xml` расположенном в каталоге с именем приложения.
-Ежевика 10 обрабатывает символы по-разному чем другие платформы двумя способами:
+Ресурсы указанные без протокола, как например `www.apache.org` в отличие от `http://www.apache.org`, по умолчанию разрешают доступ ко схемам `http`, `https`, `ftp`, и `ftps`.
-1) Доступ к XMLHttpRequest содержимому должны быть объявлены явным образом. происхождения = «*» не будут соблюдаться для этот случай использования. Кроме того все веб-безопасности может быть отключена с помощью предпочтение.
+Шаблоны на платформе iOS более гибкие, чем в спецификации [W3C Доступ виджета][1]. К примеру, следующая конструкция разрешает доступ к всем поддоменам и доменам верхнего уровня, как например `.com` и `.net`:
-2) поддомены = "true" может быть использован вместо «* .domain»
+ <access origin="*.google.*" />
+
-### Синтаксис
+В отличие от платформы Android упомянутой выше, попытка перехода к домену не указанному в списке разрешений через ссылку `href`, на iOS предотвращает открытие страницы полностью.
-Доступ к [google.com][3]:
+## Список разрешений BlackBerry 10
- <access origin="http://google.com" subdomains="false" />
-
+Разрешающие правила могут быть найдены в `www/config.xml`.
-Доступ к [maps.google.com][5]:
+Использование шаблонов в BlackBerry 10 отличается от остальных платформы двумя способами:
- <access origin="http://maps.google.com" subdomains="false" />
+* Любой контент, к которому получается доступ с использованием `XMLHttpRequest` должн быть объявлен явным образом. Установка `origin="*"` в этом случае не работает. Как вариант, веб-безопасность можно отключить с помощью параметра `WebSecurity`, описанном в разделе Настройка BlackBerry:
+ <preference name="websecurity" value="disable" />
+
-Доступ ко всем дочерним доменам на [google.com][3]:
-
- <access origin="http://google.com" subdomains="true" />
+* Как альтернатива параметру `*.domain` , установите дополнительный атрибут `subdomains` со значением `true` . Он установлен в `false` по умолчанию. Например, следующее описание позволяет получить доступ к `google.com` , `maps.google.com` , и `docs.google.com` :
-
-Доступ ко всем доменам, в том числе `file://` протокол:
-
- <access origin="*" subdomains="true" />
+ <access origin="http://google.com" subdomains="true" />
+
-
-Отключите все веб-безопасности:
-
- <preference name="websecurity" value="disable" />
+ А следующее описание ограничивает доступ до `google.com` :
-
-## iOS
-
-### Подробная информация
-
-Whitelisting правила находятся в `AppName/config.xml` и объявил с элементом`<access origin="..." />`.
-
-iOS полностью поддерживает синтаксис "белый список".
-
-### Изменена 3.1.0:
-
-До версии 3.1.0 Кордова iOS включены некоторые нестандартные расширения схемы whilelisting домена, поддерживаемой другими платформами Cordova. По состоянию на 3.1.0 белый iOS теперь соответствует ресурсов whitelist синтаксис, описанный в верхней части этого документа. Если вы модернизируете от pre-3.1.0, и вы использовали эти расширения, может потребоваться изменить ваш `config.xml` файл для того чтобы продолжать whitelisting тот же набор ресурсов, как раньше.
-
-В частности эти модели должны быть обновлены:
-
-* « `apache.org` » (не протокол): это будет соответствовать ранее `http` , `https` , `ftp` , и `ftps` протоколы. Изменить на « `*://apache.org/*` » включить все протоколы, или включать строку для каждого протокола, необходимо поддерживать.
-
-* « `http://apache.*` » (подстановочный знак в конце домена): это будет соответствовать ранее все верхнего-уровня-домены, включая все возможные двухбуквенные ДВУ (но не полезно домены как. co.uk). Включить строку для каждого TLD, который вы фактически контролировать и нуждаются в белый список.
-
-* « `h*t*://ap*he.o*g` » (подстановочные знаки для случайных недостающие буквы): они больше не поддерживаются; изменения будет включать строку для каждого домена и протоколу что вы на самом деле нужно whitelist.
-
-### Синтаксис
-
-Доступ к [google.com][3]:
-
- <access origin="http://google.com/*" />
+ <access origin="http://google.com" subdomains="false" />
+
-
-## Windows Phone (7 и 8)
-
-Whitelisting правила находятся в `config.xml` и объявил с элементом`<access origin="..." />`.
-
-### Синтаксис
-
-Доступ к [google.com][3]:
-
- <access origin="http://google.com" />
+ Укажите доступ ко всем доменам, в том числе для протокола локальной файловой системы `file://`:
+ <access origin="*" subdomains="true" />
-## Tizen
+(За более подробной информацией о поддерживаемых функциях, смотрите документации BlackBerry по [тегу access][8].)
-### Подробная информация
+ [8]: https://developer.blackberry.com/html5/documentation/ww_developing/Access_element_834677_11.html
-Корневой каталог приложения `config.xml` файл определяет правила белый список доменов, используя `<access origin="..." />` элемент. Полный справочник смотрите в [документации Tizen доступ к внешним сетевым ресурсам][10].
+## Изменения для iOS в версии 3.1.0
- [10]: https://developer.tizen.org/help/topic/org.tizen.help.gs/Creating%20a%20Project.html?path=0_1_1_4#8814682_CreatingaProject-AccessingExternalNetworkResources
+До версии 3.1.0, Cordova-iOS включала некоторые нестандартные расширений к списку разрешенных доменов поддерживаемым остальными платформами Cordova. Начиная с 3.1.0, список разрешенных доменов для iOS соотвествует синтаксису списка разрешенных доменов описанному в начале этого документа. Если вы обновляетесь с версии до 3.1.0, и вы использовали эти разширения, вам возможно понадобиться изменить ваш `config.xml` файл для того чтобы продолжить разрешать доступ к тому же набору ресурсов что и ранее.
-### Синтаксис
+Точнее, эти шаблоны должны быть обновлены:
-Доступ к [google.com][3]:
+* `apache.org`(без протокола): это значение ранее указывало на возможность использования протоколов `http` , `https` , `ftp` , и `ftps`. Измените на « `*://apache.org/*` » чтобы включить все протоколы, или включите строку для каждого протокола, который необходимо поддерживать.
- <access origin="http://google.com" subdomains="false" />
-
+* `http://apache.*`(подстановочный знак в конце домена): это ранее обеспечивало совпадение с любыми доменами верхнего уровня, включая все возможные комбинации ДВУ из двух букв (но не полезные домены как .co.uk). Включить строку для каждого TLD, который вы фактически контролируете и к которому необходимо предоставить доступ.
-Доступ к безопасной [google.com][4] ( `https://` ):
+* `h*t*://ap*he.o*g`(подстановочные знаки для случайных недостающие буквы): они больше не поддерживаются; измените файл и включить строку для каждого домена и протокола, что вам действительно необходим в списке разрешений.
- <access origin="https://google.com" subdomains="false" />
-
+## Список разрешений Windows Phone
-Доступ ко всем дочерним доменам на [google.com][3]:
+Списки разрешающий правил для Windows Phone 7 и 8 находятся в файле `config.xml` приложения.
- <access origin="http://google.com" subdomains="true" />
-
+## Список разрешений Tizen
-Доступ ко всем доменам, в том числе `file://` протокол:
+Списки разрешающий правил находятся в файле приложения `config.xml`. Платформа рассчитывает на тот же атрибут `subdomains` что и платформа BlackBerry. (За более детальной информацией о поддерживаемых функциях, смотрите документацию Tizen по [тегу access][9].)
- <access origin="*" subdomains="true" />
\ No newline at end of file
+ [9]: https://developer.tizen.org/help/index.jsp?topic=%2Forg.tizen.web.appprogramming%2Fhtml%2Fide_sdk_tools%2Fconfig_editor_w3celements.htm
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/b87ed7c8/docs/ru/edge/guide/cli/index.md
----------------------------------------------------------------------
diff --git a/docs/ru/edge/guide/cli/index.md b/docs/ru/edge/guide/cli/index.md
index 20710f0..de122c6 100644
--- a/docs/ru/edge/guide/cli/index.md
+++ b/docs/ru/edge/guide/cli/index.md
@@ -16,7 +16,7 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
# Интерфейс командной строки
-Это руководство показывает, как создавать приложения и развернуть их в различных родной мобильных платформ с использованием `cordova` интерфейс командной строки (CLI). Этот инструмент позволяет создавать новые проекты, строить их на разных платформах и запускать их в эмуляторе. CLI можно также использовать для инициализации кода проекта, после чего вы можете использовать различные платформы SDK для их дальнейшего развития.
+Это руководство показывает, как создавать приложения и развернуть их в различных родной мобильных платформ с использованием `cordova` интерфейс командной строки (CLI). Эта программа позволяет вам создавать новые проекты, собирать их на различных платформах, и запускать ваше приложение на устройствах или в эмуляторах. CLI это основной инструмент для кросс-платформенной процесса разработки (Смотрите "Обзор" для описания различных процессов разработки.) Однако, вы также можете использовать CLI для инициализации кода проекта, после чего вы можете и�
�пользовать SDK различных платформ и инструменты командной строки для дальнейшей разработки.
## Необходимые условия
@@ -25,63 +25,70 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
Чтобы добавить поддержку или перестроить проект для любой платформы, вы должны запустить интерфейс командной строки из той же машине, который поддерживает платформы SDK. CLI поддерживает следующие комбинации:
* iOS (Mac)
+* Amazon Fire OS (Mac, Linux, Windows)
* Android (Mac, Linux)
-* Ежевика 10 (Mac, Linux, Windows)
+* BlackBerry 10 (Mac, Linux, Windows)
* Windows Phone 7 (Windows)
* Windows Phone 8 (Windows)
* Windows 8 (Windows)
* Firefox OS (Mac, Linux, Windows)
-На Mac доступны через *терминал* приложения командной строки. На ПК он доступен как *командной строки* под *Аксессуары*.
+На Mac командная строка доступна с помощью приложения *Терминал*. На ПК он доступен как приложение *Командная строка* в разделе *Аксессуары*.
-Скорее, это запустить CLI из различных машин, тем больше это имеет смысл поддерживать удаленный репозиторий, активы которых вы тянуть местные рабочие каталоги.
+Скорее всего, вы будете запускать CLI с различных компьютеров, тем больше имеет смысл поддерживать удаленный репозиторий, откуда вы будете забирать рабочие материалы в локальные каталоги.
-Чтобы установить `cordova` командной строки средство, выполните следующие действия:
+Чтобы установить инструмент командной строки `cordova`, выполните следующие действия:
-1. Скачать и установить [Node.js][1]. После установки, вы должны иметь возможность ссылаться на `node` или `npm` в командной строке.
+1. Скачайте и установите [Node.js][1]. После установки, вы должны иметь возможность вызвать `node` или `npm` в вашей командной строке.
-2. Установить `cordova` утилита. В Unix, предваряя дополнительные `sudo` команда может быть необходимым для установки утилиты разработки в противном случае ограничено каталоги:
+2. Установить утилиту `cordova`. В Unix, возможно будет необходимо предварить команды установки дополнительной командой `sudo`, для установки утилиты разработки в закрытые в противном случае каталоги:
$ sudo npm install -g cordova
- Журнал установки может приводить к ошибкам для любой удаленной платформы SDK. После установки, вы должны иметь возможность запускать `cordova` в командной строке.
+ Журнал установки может отображать ошибки для любого удаленного SDK платформы. После установки, вы должны иметь возможность запускать `cordova` в командной строке.
+
+ **ПРИМЕЧАНИЕ**: Флаг `-g` указывает npm установить cordova глобально. Возможно вам понадобиться добавить каталог npm в переменную PATH для того чтобы вызывать глобально установленные модули npm. На Windows, npm обычно может быть найдена в каталоге `C:\Users\username\AppData\Roaming\npm` и в Unix в каталоге `/usr/local/share/npm`.
[1]: http://nodejs.org/
## Создание приложения
-Перейдите в каталог, где вы сохранить ваш исходный код и выполнить команду следующего вида:
+Перейдите в каталог, где вы сохранили ваш исходный код и выполнить команду следующего вида:
$ cordova create hello com.example.hello HelloWorld
-Это может занять некоторое время для выполнения команды, так что будьте терпеливы. Запустите `cordova -d` для просмотра сведений о прогрессе.
+Завершение команды может длиться дольше нескольких секунд, поэтому будьте терпеливы. Запуск команды с опцией `-d` будет показывать информацию о прогрессе операции.
+
+Первый аргемент - *hello* указывает каталог в котором будет сформирован ваш проект. Этот каталог не должен существовать, Cordova создаст его для вас. Подкаталог `www` созданной директории будет содержать домашнюю страницу вашего приложения, совместно с ресурсами в каталогах `css`, `js`, и `img`, что соответствует общепринятым соглашениям по наименованию файлов и каталогов принятых в веб-разработке. Файл `config.xml` содержит важные метаданные необходимые для формирования и распространения приложения.
-Первый аргумент указывает *Привет* каталог создан для вашего проекта. Ее `www` подкаталог домов Главная страница вашего приложения, наряду с различными ресурсами под `css` , `js` , и `img` , которые следуют общей веб развития именах файлов. `config.xml`Файл содержит важные метаданные, необходимые для создания и распространения приложения.
+Второй аргумент `com.example.hello` указывает идентификатор вашего проекта в обратном формате доменных имен. Этот аргумент является обязательным, но только если вы также опущен третий аргумент, поскольку позиционные аргументы. Можно изменить это значение позднее в `config.xml` файла, но следует учитывать, что, возможно, код, созданный вне `config.xml` с помощью этого значения, например имена пакетов Java. Значением по умолчанию является `io.cordova.hellocordova` , но это рекомендуется, что вы выберите соответствующее значение.
-Другие два аргументы являются необязательными: `com.example.hello` аргумент предоставляет ваш проект с идентификатором обратного домена стиля и `HelloWorld` обеспечивает приложения отображаемый текст. Вы можете редактировать оба этих значения позже в `config.xml` файл.
+Третий аргумент `HelloWorld` содержит название приложения отображения. Этот аргумент является необязательным. Можно изменить это значение позднее в `config.xml` файла, но следует учитывать, что, возможно, код, созданный вне `config.xml` с помощью этого значения, такие как имена классов Java. Значением по умолчанию является `HelloCordova` , но это рекомендуется, что вы выберите соответствующее значение.
## Добавить платформы
-Все последующие команды должны быть запущены в каталоге проекта, или подкаталоги в пределах своей области:
+Все последующие команды должны быть запущены в каталог проекта или подкаталоги в пределах своей области:
$ cd hello
-Перед тем, как можно построить проект, необходимо указать набор целевых платформ. Ваша способность выполнить эти команды зависит от того, поддерживает ли ваш компьютер каждого пакета SDK, и есть ли у вас уже установлен каждого пакета SDK. Запуск любого из них от Mac:
+Перед тем, как можно построить проект, необходимо указать набор целевых платформ. Ваши способности для запуска этих команд зависит от того, поддерживает ли ваша машина каждого пакета SDK, и есть ли у вас уже установлен каждого пакета SDK. Запустите любой из них от Mac:
$ cordova platform add ios
+ $ cordova platform add amazon-fireos
$ cordova platform add android
$ cordova platform add blackberry10
$ cordova platform add firefoxos
-Выполните любую из этих из окна машины, где *wp* относится к различных версий операционной системы Windows Phone:
+Запустите любой из них из окна машины, где *wp* относится к различных версий операционной системы Windows Phone:
$ cordova platform add wp7
$ cordova platform add wp8
$ cordova platform add windows8
+ $ cordova platform add amazon-fireos
$ cordova platform add android
$ cordova platform add blackberry10
$ cordova platform add firefoxos
@@ -97,70 +104,91 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
Выполните одну из следующих команд синонимом чтобы удалить платформу:
$ cordova platform remove blackberry10
+ $ cordova platform rm amazon-fireos
$ cordova platform rm android
-Выполнение команд для добавления или удаления платформ влияет на содержимое каталога *платформы* проекта, где каждый указанной платформе появляется как подкаталог. Исходный каталог *www* воспроизводится в подкаталоге каждой платформы, например появляясь в `platforms/ios/www` или `platforms/android/assets/www` . По умолчанию чтобы иметь возможность получить доступ ко всем API, Кордова настроен файл конфигурации каждой платформы.
+Выполнение команд для добавления или удаления платформ влияет содержимое каталога *платформы* проекта, где каждый указанной платформе появляется как подкаталог. Исходный каталог *www* воспроизводится в подкаталоге каждой платформы, например появление в `platforms/ios/www` или `platforms/android/assets/www` . Потому что CLI постоянно копирует файлы из исходной папки *www* , следует только изменять эти файлы, а не те, расположенные в подкаталогах *платформ* . При использовании управления версиями программного обеспечения, следует добавить этот источник папку *www* , нар�
�ду с папке *сливается* для системы управления версиями. (Дополнительные сведения о папке *сливается* можно найти в разделе Настройка каждой платформы ниже.)
+
+**Предупреждение**: при использовании командной строки для построения приложения, вам настоятельно не рекомендуется изменять любые файлы в `/platforms/` папке если вы не знаете, что вы делаете, или специально сказал в противном случае в документации. Это потому, что файлы в `/platforms/` каталоге будут перезаписаны на готовить или переустановки плагина.
+
+Если вы хотите на данный момент, можно использовать пакет SDK, например Eclipse или Xcode чтобы открыть проект, созданный вами. Вам нужно будет открыть набор производных активов из `/platforms/` каталог для разработки с пакетом SDK. Это потому, что файлы SDK конкретных метаданных хранятся в соответствующей `/platform/` подкаталога. (См. руководства платформы для получения информации о том, как разрабатывать приложения в каждой интегрированной среде разработки.) Этот подход следует используйте, если вы просто хотите, чтобы инициализировать проект, с помощью ком�
�ндной строки и затем переключиться на SDK для родной работы.
-Если вы хотите, можно использовать пакет SDK в этот момент чтобы открыть проект, созданный вами. Однако любые изменения, внесенные в проект в рамках SDK влияет производная набор активов, не кросс платформенный исходных файлов. Этот подход следует используйте, если вы просто хотите инициализировать проект. (См. платформа руководства для получения информации о том, как разрабатывать приложения в пределах каждого пакета SDK.) Читайте дальше, если вы хотите использовать инструменты командной строки для весь цикл разработки.
+Читайте дальше, если вы хотите использовать кросс платформенный рабочего подхода (CLI) для весь цикл разработки.
## Построение приложения
-По умолчанию `cordova create` скрипт генерирует скелетных веб-приложение, Домашняя страница которого находится проекта `www/index.html` файл. Изменить это приложение, вы хотите, но любой инициализации должен быть указан как часть `deviceready` обработчика событий по умолчанию из ссылки на `www/js/index.js` . <!-- XREF
-(See the Application Development Guide for details.)
-XREF -->
+По умолчанию `cordova create` скрипт генерирует скелетных веб-приложение, чья Главная страница — проект `www/index.html` файл. Изменить это приложение, вы хотите, но любой инициализации должен быть указан как часть `deviceready` обработчика событий, ссылки по умолчанию`www/js/index.js`.
Выполните следующую команду для последовательного построения проекта:
$ cordova build
-Это создает платформенно зависимый код в рамках проекта `platforms` подкаталог. При необходимости можно ограничить сферу охвата каждой сборки для конкретных платформ:
+Это создает код платформы в рамках проекта `platforms` подкаталога. При необходимости можно ограничить сферу применения каждой сборки для конкретных платформ:
$ cordova build ios
-`cordova build`Команда является краткой формой для следующее, что в этом примере также ориентирована на единую платформу:
+`cordova build`Команда это сокращение для следующее, что в этом примере также ориентирована на единой платформе:
$ cordova prepare ios
$ cordova compile ios
-В этом случае, после запуска `prepare` , можно использовать Apple в Xcode SDK в качестве альтернативы изменить и скомпилировать платформенно зависимый код, генерирующий Кордова в пределах `platforms/ios` . Можно использовать тот же подход с других платформ SDK.
+В этом случае, после запуска `prepare` , Xcode SDK от Apple можно использовать в качестве альтернативы изменить и скомпилировать платформенно зависимый код, генерирующий Кордова в `platforms/ios` . Можно использовать тот же подход с другой платформы SDK.
## Тестирование приложения на эмуляторе или устройстве
-SDK для мобильных платформ, которые часто поставляются в комплекте с эмуляторами, выполняемых изображения устройства, так что вы можете запустить приложение на главном экране и посмотреть, как он взаимодействует со многими функциями платформы. Выполните команду следующего вида восстановить приложение и просмотреть его в пределах определенной платформы эмулятора:
+SDK для мобильных платформ, которые часто поставляются в комплекте с эмуляторов, которые выполняются изображения устройства, так что вы можете запустить приложение на главном экране и посмотреть, как он взаимодействует с многими функциями платформы. Выполните команду, например восстановить приложение и просмотреть его в пределах определенной платформы эмулятора:
$ cordova emulate android
-Некоторые мобильные платформы эмулировать конкретного устройства по умолчанию, такие как iPhone iOS проектов. Для других платформ необходимо сначала связать устройство с эмулятором. (См. платформа направляющие для деталей.) Например, вы можете сначала запустить `android` команда для запуска Android SDK, а затем запустить изображение конкретного устройства, которое запускает согласно его поведение по умолчанию:
+Некоторые мобильные платформы эмулировать конкретного устройства по умолчанию, такие как iPhone на iOS проектов. Для других платформ необходимо сначала связать устройство с эмулятором.
+
+Примечание: Эмулятор поддержка недоступна в настоящее время Amazon Fire ОС
+
+(См. руководства платформы для подробной информации). Например, вы можете сначала запустить `android` команду для запуска Android SDK, а затем запустить образ конкретного устройства, который запускает его согласно его поведение по умолчанию:
![][2]
[2]: img/guide/cli/android_emulate_init.png
-Следующие вверх с `cordova emulate` команда обновляет образ эмулятора для отображения последние приложения, который теперь доступен для запуска на начальном экране:
+Следующие вверх с `cordova emulate` команда обновляет образ эмулятора для отображения последние приложения, который теперь доступен для запуска на главном экране:
![][3]
[3]: img/guide/cli/android_emulate_install.png
-Поочередно Подключите телефон к компьютеру и тестирование приложения непосредственно можно:
+Поочередно можно подключить телефон к компьютеру и тестирование приложения непосредственно:
$ cordova run android
-Перед выполнением этой команды, необходимо настроить устройство для тестирования, следуя процедурам, которые различаются для каждой платформы. В случае Android вам придется включить опцию **USB отладки** в устройстве и возможно добавить драйвер USB в зависимости от развития далее. Смотрите подробную информацию о потребностях каждой платформы платформы руководства.
+Перед выполнением этой команды, необходимо настроить устройство для тестирования, следуя процедурам, которые различаются для каждой платформы. В Android и Amazon Fire ОС устройства вам придется включить **отладку USB** вариант на устройстве и возможно добавить драйвер USB в зависимости от вашего развития далее. Смотрите подробную информацию о потребностях каждой платформы платформы руководства.
+
+## Добавить плагин функции
+
+При построении и посмотреть новый проект приложения по умолчанию, которое появляется не очень много. Вы можете изменить приложение во многих отношениях, чтобы воспользоваться преимуществами стандартных веб-технологий, но для app тесно общаться с различными функциями устройства уровень, вам нужно добавить плагины, которые обеспечивают доступ к основные API Cordova.
+
+*Плагин* -это немного дополнения кода, который предоставляет интерфейс для родной компонентов. Вы можете создать свой собственный плагин интерфейс, например, при разработке приложения гибрид, который смешивает Cordova WebView с собственными компонентами. (См. Встраивание WebViews и плагин развития руководство для деталей.) Чаще всего можно добавить плагин, чтобы включить один из Кордова в основных функций устройства уровня подробно описаны в справочнике по API. Список этих плагинов, включая дополнительные плагины, сообщества, можно найти на [plugins.cordova
.io][4]. CLI можно использовать для поиска плагинов из этого реестра. Например, поиск для `bar` и `code` производит один результат, соответствующий оба термина как подстроки без учета регистра:
+
+ [4]: http://plugins.cordova.io/
+
+ $ cordova plugin search bar code
+
+ com.phonegap.plugins.barcodescanner - Scans Barcodes
+
-## Добавление компонентов
+Поиск только `bar` урожайность и дополнительный результат:
-При построении и просмотреть новый проект приложения по умолчанию, которое появляется не очень много. Вы можете изменить app в много способов, чтобы воспользоваться преимуществами стандартных веб-технологий, но для app тесно общаться с различными функциями на уровне устройства, вам нужно добавить плагины, которые обеспечивают доступ к основные API Cordova.
+ org.apache.cordova.statusbar - Cordova StatusBar Plugin
+
-*Плагин* является немного дополнение кода, который предоставляет интерфейс для родной компонентов. Вы можете создать свой собственный плагин интерфейс, например, при разработке приложения гибрид, который смешивает Cordova WebView с собственными компонентами. (См. Встраивание WebViews и руководство по разработке плагинов для деталей.) Чаще всего, хотел бы добавить плагин, чтобы включить один из Кордова в основных функций устройства уровня <!--XREF обсуждаются в руководство По Разработке Приложений и внешних ССЫЛОК--> подробно описаны в Справочник по API.
+`cordova plugin add`Команды необходимо указать хранилище для код плагина. Пожалуйста, обратите внимание, что когда вы следовать веб Dev проекта рабочего процесса и использовать CLI, CLI будет заботиться о добавлении плагин код в соответствующее место для каждой платформы. (Если вы после родной Dev рабочего проекта, вам придется добавить плагины, с помощью Plugman (руководство ссылку здесь), несколько раз для каждой платформы).
-`cordova plugin add`Команды необходимо указать хранилище для код плагина. Ниже приведены примеры функций, которые можно добавить:
+Ниже приведены примеры использования командной строки для добавления функций в приложение:
* Информация основные устройства (устройства API):
@@ -185,7 +213,7 @@ SDK для мобильных платформ, которые часто пос
$ cordova plugin add org.apache.cordova.camera
$ cordova plugin add org.apache.cordova.media-capture
$ cordova plugin add org.apache.cordova.media
-
+
* Доступ к файлам на устройстве или сети (файл API):
@@ -224,25 +252,66 @@ SDK для мобильных платформ, которые часто пос
$ cordova plugin add org.apache.cordova.console
-Использование `plugin ls` (или `plugin list` , или `plugin` сама по себе) для просмотра в настоящее время установленные плагины. Каждый отображает по его идентификатору:
+Использование `plugin ls` (или `plugin list` , или `plugin` сама по себе) в настоящее время Просмотр установленных плагинов. Каждый отображает по его идентификатору:
$ cordova plugin ls # or 'plugin list'
[ 'org.apache.cordova.console' ]
-Чтобы удалить плагин, относятся к нему, тот же идентификатор, который отображается в списке. Например вот как бы удалить поддержка консоли отладки версии:
+Чтобы удалить плагин, относятся к нему с тем же идентификатором, который появляется в списке. Например вот как бы удалить поддержку для консоли отладки версии:
- $ cordova plugin rm org.apache.cordova.console
+ $ cordova plugin rm org.apache.cordova.console
$ cordova plugin remove org.apache.cordova.console # same
-Можно удалить пакет или добавлять плагины, указав более одного аргумента, для каждой команды.
+Можно пакет удалить или добавить плагины, указав более одного аргумента, для каждой команды:
+
+ $ cordova plugin add org.apache.cordova.console org.apache.cordova.device
+
-## Настройка каждой платформы
+## Расширенный модуль параметры
-Хотя Cordova позволяет легко развертывать приложение для многих различных платформ, иногда необходимо добавить настройки. В этом случае, вы не хотите изменить исходные файлы в различных `www` каталогов в пределах верхнего уровня `platforms` каталог, потому что они регулярно вы заменили с верхнего уровня `www` кросс платформенной исходного каталога.
+При добавлении плагин, несколько вариантов позволяют указать где взять плагин. Приведенные выше примеры использования известного `registry.cordova.io` реестра и плагин определяется `id` :
+
+ $ cordova plugin add org.apache.cordova.console
+
+
+`id`Также могут включать номер версии плагина, добавленным после `@` характер. `latest`Версия — это псевдоним для самой последней версии. Например:
+
+ $ cordova plugin add org.apache.cordova.console@latest
+ $ cordova plugin add org.apache.cordova.console@0.2.1
+
+
+Если плагин не зарегистрированы на `registry.cordova.io` , но расположен в другой репозиторий git, можно задать альтернативный URL-адрес:
+
+ $ cordova plugin add https://github.com/apache/cordova-plugin-console.git
+
-Вместо этого верхнего уровня `merges` Каталог предлагает место для указания активов для развертывания на определенных платформах. Каждая платформа специфического подкаталога в пределах `merges` отражает структуру каталогов `www` дерево исходных текстов, позволяет переопределять или добавлять файлы при необходимости. Например, вот как вы, возможно, использует `merges` чтобы увеличить размер шрифта по умолчанию для устройств Android:
+Приведенный выше пример git выбирает плагин с конца ветки master, но git ссылка на альтернативный например тег или ветви могут быть добавлены после `#` характер:
+
+ $ cordova plugin add https://github.com/apache/cordova-plugin-console.git#r0.2.0
+
+
+Если плагин (и его `plugin.xml` файл) находится в подкаталоге в git репо, вы можете определить его с `:` характер. Обратите внимание, что `#` персонаж по-прежнему необходимо:
+
+ $ cordova plugin add https://github.com/someone/aplugin.git#:/my/sub/dir
+
+
+Вы также можете объединить git-ref и подкаталога:
+
+ $ cordova plugin add https://github.com/someone/aplugin.git#r0.0.1:/my/sub/dir
+
+
+Кроме того, укажите локальный путь к папке плагина, который содержит `plugin.xml` файл:
+
+ $ cordova plugin add ../my_plugin_dir
+
+
+## Использование *слияния* для настройки каждой платформы
+
+Хотя Cordova позволяет легко развертывать приложение на разных платформах, иногда необходимо добавить настройки. В этом случае, вы не хотите изменить исходные файлы в различных `www` каталогов в пределах верхнего уровня `platforms` каталог, потому что они регулярно вы заменили с верхнего уровня `www` кросс платформенной исходного каталога.
+
+Вместо этого верхнего уровня `merges` Каталог предлагает место для указания активов для развертывания на определенных платформах. Каждый подкаталог платформа специфического в пределах `merges` отражает структуру каталогов `www` дерево исходных текстов, позволяет переопределить или добавить файлы, при необходимости. Например, вот как вы, возможно, использует `merges` чтобы увеличить размер шрифта по умолчанию для устройств Android и Amazon Fire ОС:
* Редактировать `www/index.html` файл, добавив ссылку на дополнительные CSS-файл, `overrides.css` в этом случае:
@@ -258,9 +327,26 @@ SDK для мобильных платформ, которые часто пос
При повторном построении проекта, Android версия имеет размер пользовательского шрифта, в то время как другие остаются неизменными.
-Вы можете также использовать `merges` для добавления файлов не представляют в оригинале `www` каталог. Например, приложение может включать *обратно кнопку* графического в интерфейс iOS, хранящиеся в `merges/ios/img/back_button.png` , в то время как Android версии вместо этого может захватить `backbutton` события из соответствующих аппаратной кнопки.
+Вы можете также использовать `merges` для добавления файлов нет в оригинале `www` каталог. Например, приложение может включать *обратно кнопку* рисунок в интерфейс iOS, хранятся в `merges/ios/img/back_button.png` , в то время как Android версии вместо может захватить `backbutton` события из соответствующей аппаратной кнопки.
+
+## Команды помощи
+
+Cordova имеет несколько глобальных команд, которые могут помочь вам, если вы застряли или возникли проблемы. `help`Команда отображает все доступные команды Кордова и их синтаксис:
+
+ $ cordova help
+ $ cordova # same
+
+
+`info`Команда создает список потенциально полезных деталей, например, установленных платформ и плагины, SDK версии для каждой платформы и версии CLI и `node.js` :
-## Обновление Кордова
+ $ cordova info
+
+
+Он представляет информацию на экран и перенаправляет выходные данные в локальной `info.txt` файла.
+
+**Примечание**: в настоящее время, доступны только сведения о платформ iOS и Android.
+
+## Обновление вашего проекта и Кордова
После установки `cordova` утилиты, вы можете всегда обновить его до последней версии, выполнив следующую команду:
@@ -269,13 +355,19 @@ SDK для мобильных платформ, которые часто пос
Используйте этот синтаксис для установки определенной версии:
- $ sudo npm установить -g cordova@3.1.0
+ $ sudo npm install -g cordova@3.1.0
-Запуск `cordova -v` чтобы увидеть текущие версии. Запустите `npm
-info` команды длиннее список, включающий текущей версии, а также другие номера версии:
+Запуск `cordova -v` чтобы посмотреть, какая версия в настоящее время работает. Запуск `npm
+info` команда больше список, который включает в себя текущую версию и другие доступные версии номера:
$ npm info cordova
-Кордова 3.0 это первая версия для поддержки интерфейса командной строки, описанные в этом разделе. Если вы обновляете с версии 3.0, необходимо создать новый проект, как описано выше, а затем скопируйте старые приложения активы в верхнего уровня `www` каталог. Там, где это применимо, дальнейшие сведения об обновлении до 3.0 доступны в платформе гидов. После обновления до `cordova` интерфейс командной строки и использование `npm update` в курсе, более длительных процедур, описанные там более не являются актуальными.
\ No newline at end of file
+Кордова 3.0 является первая версия для поддержки интерфейса командной строки, описанные в этом разделе. Если вы обновляете с версии 3.0, необходимо создать новый проект, как описано выше, а затем скопируйте старые приложения верхнего уровня `www` каталог. Там, где это применимо, далее сведения об обновлении до 3.0 доступны в платформе гидов. После обновления до `cordova` интерфейс командной строки и использование `npm update` в курсе, более длительных процедур, описанные там больше не актуальны.
+
+Кордова 3.0 + могут по-прежнему требуют различных изменений структуры каталогов уровня проекта и другие зависимости. После запуска `npm` команда выше для обновления Cordova, сама, вам может понадобиться обеспечить вашего проекта ресурсы соответствовали требованиям последней версии. Выполните команды ниже для каждой платформы, вы создаете:
+
+ $ cordova platform update android
+ $ cordova platform update ios
+ ...etc.
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/b87ed7c8/docs/ru/edge/guide/hybrid/plugins/index.md
----------------------------------------------------------------------
diff --git a/docs/ru/edge/guide/hybrid/plugins/index.md b/docs/ru/edge/guide/hybrid/plugins/index.md
index ce37e1d..37979b6 100644
--- a/docs/ru/edge/guide/hybrid/plugins/index.md
+++ b/docs/ru/edge/guide/hybrid/plugins/index.md
@@ -16,36 +16,94 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
# Руководство по разработке расширений
-Мосты плагин Cordova a bit of функциональность между WebView питания Cordova-приложение и родной платформе Cordova-приложение работает на. Плагины состоят из единого интерфейса JavaScript, используемых на всех платформах и встроенных реализаций после платформа специфического плагин интерфейсы, которые вызывает JavaScript. Все основные Cordova API реализованы с помощью этой архитектуры.
+*Плагин* представляет собой пакет из введенного кода, который позволяет webview Кордова, в течение которого ваше приложение предоставляет для взаимодействия с родной платформой, на которой он работает. Плагины предоставляют доступ к функциям устройства и платформы, которые обычно недоступны для веб-приложений. Все основные функции Cordova API реализованы в виде плагинов, и многие другие доступны, что включение функций, таких как сканеры штрих-кодов, NFC-коммуникации, или адаптировать календарь интерфейсов.
-Этом руководстве шаги процесса написания простой плагин эхо передает строку из JavaScript и отправляет его в родной среде для поддерживаемых платформ. Машинный код затем возвращает ту же строку обратно на обратные вызовы внутри плагина JavaScript.
+Плагины составляют единый интерфейс JavaScript наряду с соответствующей библиотеки машинного кода для каждой поддерживаемой платформы. Этот раздел шаги через простой *эхо* плагин, который передает строку из JavaScript на родной платформе и обратно, один, который можно использовать в качестве модели для создания гораздо более сложные функции. В этом разделе обсуждаются основные плагинная структура и интерфейс JavaScript с видом на улицу. Для каждого соответствующего родной интерфейс см. список в конце этого раздела.
-Это руководство предоставляет достаточно обзор, на котором можно построить писать более сложные плагины.
+В дополнение к этим инструкциям, при подготовке к написать плагин, то лучше посмотреть на [Существующие плагины][1] для руководства.
-## JavaScript
+ [1]: https://github.com/apache/cordova-android/tree/master/framework/src/org/apache/cordova
-Точка входа для любого плагина является JavaScript. Причина разработчиков использовать Cordova, поэтому они могут использовать и писать JavaScript, не Objective-C, не Java, C#. Интерфейс JavaScript для вашего плагина является передней и возможно наиболее важной частью Cordova плагин.
+## Создание плагина
-Можно структурировать ваш плагин JavaScript, как вам нравится. Одна вещь, вы *должны* использовать для связи между Cordova JavaScript и родной среды `cordova.exec` функции. Вот пример:
+Разработчики приложений используют CLI `plugin add` команда (обсуждается в интерфейс командной строки) чтобы применить плагин к проекту. Аргумент для этой команды является URL-адрес для *git* -репозиторий, содержащий код плагина. Этот пример реализует API устройств в Кордова:
- cordova.exec(function(winParam) {}, function(error) {}, "service",
- "action", ["firstArgument", "secondArgument", 42,
- false]);
+ $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-device.git
-Параметры описаны ниже:
+Плагин хранилище должен описываться верхнего уровня `plugin.xml` файл манифеста. Есть много способов для настройки этого файла, подробности о которых доступны в описании плагина. Это сокращенная версия `Device` плагин обеспечивает простой пример, чтобы использовать в качестве модели:
+
+ <?xml version="1.0" encoding="UTF-8"?>
+ <plugin xmlns="http://apache.org/cordova/ns/plugins/1.0"
+ id="org.apache.cordova.device" version="0.2.3">
+ <name>Device</name>
+ <description>Cordova Device Plugin</description>
+ <license>Apache 2.0</license>
+ <keywords>cordova,device</keywords>
+ <js-module src="www/device.js" name="device">
+ <clobbers target="device" />
+ </js-module>
+ <platform name="ios">
+ <config-file target="config.xml" parent="/*">
+ <feature name="Device">
+ <param name="ios-package" value="CDVDevice"/>
+ </feature>
+ </config-file>
+ <header-file src="src/ios/CDVDevice.h" />
+ <source-file src="src/ios/CDVDevice.m" />
+ </platform>
+ </plugin>
+
+
+Верхнего уровня `plugin` тега `id` атрибут использует тот же формат реверс домена для идентификации плагин пакет как приложений, чтобы они добавили. `js-module`Тег указывает путь к общим интерфейсом JavaScript. `platform`Тег указывает соответствующий набор машинного кода, для `ios` платформа в данном случае. `config-file`Тег инкапсулирует `feature` тег, который вводится в платформа специфического `config.xml` файл, чтобы сделать платформу знает дополнительного кода библиотеки. `header-file`И `source-file` теги указывать путь к файлам библиотеки компонентов.
+
+## Проверка плагина
+
+Вы можете использовать `plugman` утилита для проверки, является ли плагин устанавливает правильно для каждой платформы. Установка `plugman` с помощью следующей команды [узла][2] :
+
+ [2]: http://nodejs.org/
+
+ $ npm install -g plugman
+
+
+Вам нужно действительный app исходного каталога, например верхнего уровня `www` каталог, включенных в проект, созданный CLI по умолчанию, как описано в интерфейс командной строки. Убедитесь, что приложение `index.html` Главная страница ссылаются на имя плагина интерфейс JavaScript, как будто это в той же директории источника:
+
+ <script src="myplugin.js"></script>
+
-* `function(winParam) {}`: Успех функции обратного вызова. Если ваш `exec` вызов завершается успешно, эта функция вызывается (при необходимости с любыми параметрами, вы проходите к нему).
+Затем выполните команду следующих для тестирования iOS зависимости нагрузки должным образом:
-* `function(error) {}`: Ошибка функции обратного вызова. Если операция не завершена успешно, эта функция вызывается (при необходимости с параметром ошибка).
+ $ plugman -platform ios /path/to/my/project/www /path/to/my/plugin
+
-* `"service"`: Имя службы, для вызова на родной стороне. Это сопоставляется собственный класс, о котором более подробная информация доступна в родной гидов, перечисленных ниже.
+Для подробной информации о `plugman` Параметры, см. Использование Plugman для управления плагинами. Для получения информации о том, как на самом деле *отладки* плагины увидеть родной интерфейс каждой из платформ, перечисленных в нижней части этой страницы.
-* `"action"`: Имя действия для вызова. Это взял на получение собственного класса `exec` вызов и, в зависимости от платформы, по существу карты к методу класса. Перечисленные ниже родной руководствах детали.
+## Интерфейс JavaScript
-* `[/* arguments */]`: Аргументы для передачи в родной среде.
+JavaScript предоставляет интерфейс передней, что делает его может быть самой важной частью плагин. Ваш плагин JavaScript можно структурировать, однако вам нравится, но вам нужно вызвать `cordova.exec` для взаимодействия с родной платформой, используя следующий синтаксис:
-### Пример JavaScript плагин эхо
+ cordova.exec(function(winParam) {},
+ function(error) {},
+ "service",
+ "action",
+ ["firstArgument", "secondArgument", 42, false]);
+
+
+Вот как работает каждого параметра:
+
+* `function(winParam) {}`: Функция обратного вызова успех. Предполагая ваш `exec` вызов завершается успешно, эта функция выполняет наряду с каких-либо параметров, вы проходите к нему.
+
+* `function(error) {}`: Функция обратного вызова ошибки. Если операция не завершена успешно, эта функция выполняется с параметром необязательные ошибки.
+
+* `"service"`: Имя службы, для вызова на родной стороне. Это соответствует в родной класс, для которого более подробная информация доступна в родной гидов, перечисленных ниже.
+
+* `"action"`: Имя действия вызова на родной стороне. Это обычно соответствует методу собственного класса. Смотрите собственного руководства, перечисленных ниже.
+
+* `[/* arguments */]`: Массив аргументов для передачи в родной среде.
+
+## Пример JavaScript
+
+В этом примере показан один из способов реализовать интерфейс JavaScript плагин:
window.echo = function(str, callback) {
cordova.exec(callback, function(err) {
@@ -54,42 +112,36 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
};
-Обсудим это. Плагин прикрепляется к `window` , специально для `echo` функции. Плагин пользователей будет затем использовать его следующим образом:
+В этом примере плагин прикрепляется к `window` объект как `echo` функция, которая плагин пользователей назвал бы следующим образом:
window.echo("echome", function(echoValue) {
alert(echoValue == "echome"); // should alert true.
});
-Во-первых Давайте рассмотрим три последние аргументы для `exec` функции. Мы будет вызывать `Echo` «услуг», с просьбой `echo` «action» и пройдя массив аргументов, содержащих строку эхо, который является первым параметром в `window.echo` функции.
-
-Успех обратного вызова передается в `exec` это просто ссылка на обратный вызов функцию, `window.echo` принимает. Мы делаем немного больше для обратного вызова ошибки: Если родной стороне запускает обратный вызов для ошибки, мы просто успех обратного вызова и передайте в него строку «по умолчанию».
-
-## Модуль Спецификация
-
-Cordova имеет плагин спецификации доступны для включения автоматической установки плагина для Android, iOS, платформы BlackBerry 10 и Windows Phone. Структурирование ваш плагин определенным образом и добавив `plugin.xml` файл манифеста, можно разрешить пользователям устанавливать ваш плагин через командной строки инструмента.
+Посмотрите на три последние аргументы для `cordova.exec` функции. Первые звонки `Echo` *службы*, имя класса. Второй просит `echo` *действий*, метода в этом классе. В-третьих, массив аргументов, содержащих строку эхо, которая является `window.echo` функция в первый параметр.
-* Модуль Спецификация
+Успех обратного вызова передается в `exec` это просто ссылка на функцию обратного вызова `window.echo` принимает. Если родной платформе инициирует обратный вызов для ошибки, он просто вызывает успех обратного вызова и передает ему строку по умолчанию.
-## Родной
+## Интерфейсы
-После того, как вы определяете JavaScript для вашего плагина, вы должны дополнить его по крайней мере один собственной реализации. Ниже перечислены детали, чтобы сделать это для каждой платформы. Эти руководства по-прежнему опираться на простой пример эхо плагин, рассмотренных выше.
+После того, как вы определяете JavaScript для вашего плагина, необходимо дополнить его по крайней мере один собственной реализации. Детали для каждой платформы перечислены ниже, и каждый основывается на простой пример эхо плагин выше:
-* Андроид плагины
-* Ежевика плагины
-* Ежевика 10 плагинов
-* iOS, плагины
+* Amazon Fire OS плагины
+* Android плагины
+* iOS плагины
+* BlackBerry 10 плагинов
* Windows Phone плагины
-В настоящее время Tizen платформа не поддерживает плагины.
+Платформа Tizen не поддерживает плагины.
## Публикации плагины
-После того как вы разработали ваш плагин, вы можете опубликовать его и поделиться им с сообществом. Вы можете опубликовать ваш плагин в cordova реестр (на [npmjs][1]) или для любых других npmjs на основе реестра. Пользователи смогут установить его автоматически с помощью plugman или Кордова cli.
+После того как вы развивать ваш плагин, вы можете опубликовать и поделиться им с сообществом. Вы можете опубликовать ваш плагин в реестре Кордова (на основе [ `npmjs` ][3]) или в любой другой `npmjs` -на основе реестра. Другие разработчики могут установить его автоматически с помощью `plugman` или Кордова CLI. (Подробную информацию о каждом пути развития, см. Использование Plugman для управления плагины и интерфейс командной строки.)
- [1]: https://github.com/isaacs/npmjs.org
+ [3]: https://github.com/isaacs/npmjs.org
-Чтобы опубликовать плагин необходимо использовать средство plugman и пройти через следующие шаги:
+Чтобы опубликовать плагин, вам нужно использовать `plugman` инструмент и пройти через следующие шаги:
$ plugman adduser # that is if you don't have an account yet
$ plugman publish /path/to/your/plugin
@@ -97,4 +149,4 @@ Cordova имеет плагин спецификации доступны для
Вот оно что!
-Другие на основе реестра команды доступны и `plugman --help` даст вам список какие команды доступны и как их использовать.
\ No newline at end of file
+Запуск `plugman --help` перечислены другие доступные команды на основе реестра.
\ No newline at end of file