You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by db...@apache.org on 2015/08/08 05:04:58 UTC
docs commit: Making docs ToC scroll,
and trying out some docs content fixes.
Repository: cordova-docs
Updated Branches:
refs/heads/cordova-website 17d4f54c2 -> f60c681b3
Making docs ToC scroll, and trying out some docs content fixes.
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/f60c681b
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/f60c681b
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/f60c681b
Branch: refs/heads/cordova-website
Commit: f60c681b3d21bd594ba5400ef7bbc6d1479eaee2
Parents: 17d4f54
Author: Dmitry Blotsky <dm...@gmail.com>
Authored: Fri Aug 7 20:04:52 2015 -0700
Committer: Dmitry Blotsky <dm...@gmail.com>
Committed: Fri Aug 7 20:04:52 2015 -0700
----------------------------------------------------------------------
www/docs/ru/5.0.0/guide/cli/index.md | 159 +++++++++++++++---------------
www/static/css-src/docs.scss | 2 +
2 files changed, 79 insertions(+), 82 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/f60c681b/www/docs/ru/5.0.0/guide/cli/index.md
----------------------------------------------------------------------
diff --git a/www/docs/ru/5.0.0/guide/cli/index.md b/www/docs/ru/5.0.0/guide/cli/index.md
index eb00714..75fda97 100644
--- a/www/docs/ru/5.0.0/guide/cli/index.md
+++ b/www/docs/ru/5.0.0/guide/cli/index.md
@@ -57,23 +57,22 @@ license: Licensed to the Apache Software Foundation (ASF) under one
[2]: http://git-scm.com/
* В OS X и Linux:
-
+
$ sudo npm install -g cordova
-
-
+
+
В OS X и Linux, может быть необходимым предварять команду `npm` командой `sudo` чтобы установить этот инструмент разработки, в защищенные каталоги, такие как `usr/local/share`. Если вы используете инструмент nvm/nave и имеете доступ на запись к каталогу установки, префикс `sudo` можно опустить. Есть [больше подсказок][3] по использованию `npm` без `sudo`, если вы имеете желание сделать это.
* В Windows:
-
+
C:\>npm install -g cordova
-
-
+
Упомянутый выше флаг `-g` указывает `npm` установить `cordova` глобально. В противном случае он будет установлен в подкаталоге `node_modules` текущего рабочего каталога.
-
+
Вам может понадобиться добавить каталог `npm` в переменную `PATH` вашего окружения, для того чтобы вызывать глобально установленные `npm` модули. В Windows `npm` обычно можно найти в каталоге `C:\Users\username\AppData\Roaming\npm`. На OS X и Linux его обычно можно найти в каталоге `/usr/local/share/npm`.
-
+
Журнал установки может приводить к ошибкам, для любого не установленного SDK платформы.
-
+
После установки вы должны иметь возможность запускать `cordova` в командной строке без аргументов, и это должно напечатать текст справки.
[3]: http://justjs.com/posts/npm-link-developing-your-own-npm-modules-without-tears
@@ -82,8 +81,7 @@ license: Licensed to the Apache Software Foundation (ASF) under one
Перейдите в каталог, где вы сохранили ваш исходный код и выполнить команду следующего вида:
- $ cordova create hello com.example.hello HelloWorld
-
+ $ cordova create hello com.example.hello HelloWorld
Завершение команды может длиться дольше нескольких секунд, поэтому будьте терпеливы. Запуск команды с опцией `-d` будет показывать информацию о прогрессе операции.
@@ -97,36 +95,36 @@ license: Licensed to the Apache Software Foundation (ASF) under one
Все последующие команды должны быть выполняться в каталоге проекта или любых подкаталогах в его пределах:
- $ cd hello
-
+ $ cd hello
Перед тем, как можно построить проект, необходимо указать набор целевых платформ. Ваши возможности по запуску этих команд зависят от того поддерживает ваш компьютер каждое SDK, и установили ли вы соответствующее SDK. Запустите любую из этих команд на Mac:
- $ cordova platform add ios
- $ cordova platform add amazon-fireos
- $ cordova platform add android
- $ cordova platform add blackberry10
- $ cordova platform add firefoxos
-
+ $ cordova platform add ios
+ $ cordova platform add amazon-fireos
+ $ cordova platform add android
+ $ cordova platform add blackberry10
+ $ cordova platform add firefoxos
Запустите любую из этих команд на Windows компьютере, где *wp* ссылается на различные версии операционной системы Windows Phone:
- $ cordova платформа добавить wp8 $ cordova платформа добавить добавить $ cordova платформы windows Амазонки fireos $ cordova платформа добавить android $ cordova платформа добавить blackberry10 $ cordova платформа добавить firefoxos
-
+ $ cordova platform add wp8
+ $ cordova platform add windows
+ $ cordova platform add fireos
+ $ cordova platform add android
+ $ cordova platform add blackberry10
+ $ cordova platform add firefoxos
Выполните это, чтобы проверить ваш текущий набор платформ:
- $ cordova platforms ls
-
+ $ cordova platforms ls
(Обратите внимание, что команды `platform` и `platforms` являются синонимами.)
Выполните одну из следующих команд, которые являются синонимами, чтобы удалить платформу:
- $ cordova platform remove blackberry10
- $ cordova platform rm amazon-fireos
- $ cordova platform rm android
-
+ $ cordova platform remove blackberry10
+ $ cordova platform rm amazon-fireos
+ $ cordova platform rm android
Выполнение команд для добавления или удаления платформ затрагивает содержимое каталога *platforms* проекта, где каждая указанная платформа представлена как подкаталог. Исходный каталог *www* повторяется в подкаталоге каждой платформы, например вы можете увидеть его в `platforms/ios/www` или `platforms/android/assets/www`. Потому что CLI постоянно копирует файлы из исходной папки *www*, следует изменять только эти файлы, а не файлы, расположенные в подкаталогах *platforms*. При использовании системы управления версиями, следует добавить папку с исходным кодом *www*, наряду с пап
кой *merges* в вашу систему управления версиями. (Дополнительные сведения о папке *merges* можно найти в разделе "Настройка каждой платформы" ниже.)
@@ -142,19 +140,16 @@ license: Licensed to the Apache Software Foundation (ASF) under one
Выполните следующую команду для итеративного построения проекта:
- $ cordova build
-
+ $ cordova build
Это создает код платформы в подкаталоге проекта `platforms`. При необходимости можно ограничить применения каждой сборки для выбранных платформ:
- $ cordova build ios
-
+ $ cordova build ios
Команда `cordova build` это сокращение для следующих команд, которые в этом примере нацелены на одну платформу:
- $ cordova prepare ios
- $ cordova compile ios
-
+ $ cordova prepare ios
+ $ cordova compile ios
В этом случае, как только вы запустили `prepare`, вы можете использовать Xcode SDK компании Apple как альтернативу для изменения и компиляции платформо-зависимого кода, который кордова создала в каталоге `platforms/ios`. Вы можете использовать тот же подход для SDK других платформ.
@@ -163,7 +158,7 @@ license: Licensed to the Apache Software Foundation (ASF) under one
SDK для мобильных платформ часто поставляются с эмуляторами которые выполняют образ устройства, таким образом что вы можете запустить ваше приложение из главного экрана и посмотреть как оно взаимодействует с различными функциями платформы. Выполните команду как указано ниже для перепостроения приложения запуска его в эмуляторе указанной платформы:
$ cordova emulate android
-
+
Некоторые мобильные платформы эмулируют определенное устройство по умолчанию, как например iPhone для проектов iOS. Для других платформы, вам может понадобиться сперва ассоциировать устройство с эмулятором.
@@ -184,7 +179,7 @@ SDK для мобильных платформ часто поставляютс
Поочередно можно подключить телефон к компьютеру и тестирование приложения непосредственно на нем:
$ cordova run android
-
+
Перед выполнением этой команды, необходимо настроить устройство для тестирования, следуя процедурам, которые различаются для каждой платформы. В устройствах Android и Amazon Fire ОС вам придется включить функцию **Отладка USB** на устройстве и возможно добавить драйвер, USB в зависимости от вашего окружения разработки. Смотрите раздел "Руководство по поддерживаемым платформам" за подробностями о требованиях каждой платформы.
@@ -203,78 +198,78 @@ SDK для мобильных платформ часто поставляютс
[7]: http://plugins.cordova.io/
$ cordova plugin search bar code
-
+
com.phonegap.plugins.barcodescanner - Scans Barcodes
-
+
Поиск только по слову `bar` возвращает дополнительный результат:
cordova-plugin-statusbar - Cordova StatusBar Plugin
-
+
Команда `cordova plugin add` требует чтобы вы указали репозиторий для кода плагина. Вот пример как вы можете использовать CLI для добавления функций в приложение:
* Базовая информация устройства (Device API):
-
+
$ cordova plugin add cordova-plugin-device
-
+
* Сетевое подключение и События батареи:
-
+
$ cordova plugin add cordova-plugin-network-information
$ cordova plugin add cordova-plugin-battery-status
-
+
* Акселерометр, компас и информация о расположении:
-
+
$ cordova plugin add cordova-plugin-device-motion
$ cordova plugin add cordova-plugin-device-orientation
$ cordova plugin add cordova-plugin-geolocation
-
+
* Камера, воспроизведение мультимедиа и съемка:
-
+
$ cordova plugin add cordova-plugin-camera
$ cordova plugin add cordova-plugin-media-capture
$ cordova plugin add cordova-plugin-media
-
+
* Доступ к файлам на устройстве или по сети (File API):
-
+
$ cordova plugin add cordova-plugin-file
$ cordova plugin add cordova-plugin-file-transfer
-
+
* Уведомление с помощью диалогового окна или вибрации:
-
+
$ cordova plugin add cordova-plugin-dialogs
$ cordova plugin add cordova-plugin-vibration
-
+
* Контакты:
-
+
$ cordova plugin add cordova-plugin-contacts
-
+
* Глобализация:
-
+
$ cordova plugin add cordova-plugin-globalization
-
+
* Заставка:
-
+
$ cordova plugin add cordova-plugin-splashscreen
-
+
* Открытие новых окон браузера (InAppBrowser):
-
+
$ cordova plugin add cordova-plugin-inappbrowser
-
+
* Консоль отладки:
-
+
$ cordova plugin add cordova-plugin-console
-
+
**Примечание**: CLI добавляет код плагина соответствующим образом для каждой платформы. Если вы хотите разработать с использованием инструментов низкого уровня или SDK платформы, как описано в разделе "Обзор", необходимо запустить утилиту Plugman которая добавит плагины отдельно для каждой платформы. (Для получения дополнительной информации, см. раздел "Использование Plugman для управления плагинами".)
@@ -282,56 +277,56 @@ SDK для мобильных платформ часто поставляютс
$ cordova plugin ls # or 'plugin list'
[ 'cordova-plugin-console' ]
-
+
Чтобы удалить плагин, сошлитесь к нему по тому же идентификатору, который появляется в списке. Например таким образом вы бы удалили поддержку для консоли отладки из версии релиза:
$ cordova plugin rm cordova-plugin-console
$ cordova plugin remove cordova-plugin-console # same
-
+
Вы можете удалять или добавлять плагины пакетно указывая более чем один аргумент для соответствующей команды:
$ cordova plugin add cordova-plugin-console cordova-plugin-device
-
+
## Расширенные параметры плагина
При добавлении плагина, некоторые параметры позволяют указать откуда взять плагин. Приведенные выше примеры использования общепринятого реестра `registry.cordova.io`, и плагин определяется по его `id`:
$ cordova plugin add cordova-plugin-console
-
+
`Id` также может включать номер версии плагина, добавленный после символа `@`. Версия `latest` — это псевдоним для самой последней версии. Например:
$ cordova plugin add cordova-plugin-console@latest
$ cordova plugin add cordova-plugin-console@0.2.1
-
+
Если плагин не зарегистрирована в `registry.cordova.io`, но расположен в другом репозитории git, вы можете указать альтернативный URL-адрес:
$ cordova plugin add https://github.com/apache/cordova-plugin-console.git
-
+
Приведенный выше пример git получает плагин из последней версии ветки master, но альтернативная git ссылка например тег или другая ветка могут быть добавлены после символа `#`:
$ cordova plugin add https://github.com/apache/cordova-plugin-console.git#r0.2.0
-
+
Если плагин (и его файл `plugin.xml`) находится в подкаталоге репозитария git, вы можете указать его после символа `:`. Обратите внимание, что символ `#` все еще необходим:
$ cordova plugin add https://github.com/someone/aplugin.git#:/my/sub/dir
-
+
Вы также можете объединить как ссылку git так и подкаталоги:
$ cordova plugin add https://github.com/someone/aplugin.git#r0.0.1:/my/sub/dir
-
+
Как вариант укажите локальный путь к папке плагина, который содержит файл `plugin.xml`:
$ cordova plugin add ../my_plugin_dir
-
+
## Использование каталога *merges* для настройки каждой платформы
@@ -340,16 +335,16 @@ SDK для мобильных платформ часто поставляютс
Вместо этого в каталог верхнего уровня `merges` предоставляет место для указания ресурсов для развертывания на определенных платформах. Каждый платформо-зависимый подкаталог `merges` отражает повторяет структуру директории `www`, и позволяет переопределить или добавить файлы, как это необходимо. Например вот как вы, возможно, использует `merges` чтобы увеличить размер шрифта по умолчанию для устройств Android и Amazon Fire ОС:
* Измените файл `www/index.html`, добавив ссылку на дополнительный CSS-файл, `overrides.css` в данном случае:
-
+
<link rel="stylesheet" type="text/css" href="css/overrides.css" />
-
+
* При необходимости создайте пустой `www/css/overrides.css` файл, который будет применяться для всех построений отличных от Android, предотвращая ошибку недостающего файла.
* Создайте `css` подкаталог внутри `merges/android` , затем добавьте соответствующий файл `overrides.css`. Укажите CSS, который переопределяет 12 пунктовый размер шрифта по умолчанию, указанный в `www/css/index.css` , например:
-
+
body { font-size:14px; }
-
+
При повторном построении проекта, Android версия будет содержать измененный размер шрифта, в то время как другие платформы остаются неизменными.
@@ -361,17 +356,17 @@ Cordova имеет несколько глобальных команд, кот
$ cordova help
$ cordova # same
-
+
Кроме того вы можете получить более подробную справку по определенной команде. Например:
$ cordova run --help
-
+
Команда `info` формирует список потенциально полезных сведений, например установленных платформ и плагинов, версии SDK для каждой платформы и версии CLI и `node.js`:
$ cordova info
-
+
Она представляет информацию на экран и перенаправляет выходные данные в локальный файл `info.txt`.
@@ -382,17 +377,17 @@ Cordova имеет несколько глобальных команд, кот
После установки утилиты `cordova`, вы можете всегда обновить ее до последней версии, выполнив следующую команду:
$ sudo npm update -g cordova
-
+
Используйте этот синтаксис для установки определенной версии:
$ sudo npm install -g cordova@3.1.0-0.2.0
-
+
Запустите `cordova - v`, чтобы увидеть, какая версия в настоящее время установлена. Выполните команду `npm info` для более длинного списка, который включает в себя текущую версию и другие доступные номера версий:
$ npm info cordova
-
+
Кордова 3.0 является первая версия поддерживающая интерфейс командной строки, описанные в этом разделе. Если вы обновляете проект с версии ранее чем 3.0, необходимо создать новый проект, как описано выше, а затем скопировать старые ресурсы приложения в каталог верхнего уровня `www`. Там, где это применимо, далее сведения об обновлении до 3.0 доступны в разделе "Руководство по поддерживаемым платформам". После обновления к интерфейсу командной строки `cordova` используйте `npm update` чтобы оставаться актуальным, более длительные процедуры, описанные там
более не актуальны.
@@ -400,4 +395,4 @@ Cordova 3.0 + по-прежнему может требовать различн
$ cordova platform update android
$ cordova platform update ios
- ...etc.
\ No newline at end of file
+ ...etc.
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/f60c681b/www/static/css-src/docs.scss
----------------------------------------------------------------------
diff --git a/www/static/css-src/docs.scss b/www/static/css-src/docs.scss
index c1e97cd..7781119 100644
--- a/www/static/css-src/docs.scss
+++ b/www/static/css-src/docs.scss
@@ -2,6 +2,8 @@
.site-toc-container {
position: fixed;
+ overflow-y: scroll;
+ height: 80%;
}
.site-toc-title {
font-weight: 300;
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org