cordova-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ste...@apache.org
Subject [05/12] docs commit: added Russian 5.1.1 docs
Date Thu, 25 Jun 2015 22:13:41 GMT
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/5846f316/docs/ru/5.1.1/guide/platforms/ios/index.md
----------------------------------------------------------------------
diff --git a/docs/ru/5.1.1/guide/platforms/ios/index.md b/docs/ru/5.1.1/guide/platforms/ios/index.md
new file mode 100644
index 0000000..b69c5b7
--- /dev/null
+++ b/docs/ru/5.1.1/guide/platforms/ios/index.md
@@ -0,0 +1,212 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+         or more contributor license agreements.  See the NOTICE file
+         distributed with this work for additional information
+         regarding copyright ownership.  The ASF licenses this file
+         to you under the Apache License, Version 2.0 (the
+         "License"); you may not use this file except in compliance
+         with the License.  You may obtain a copy of the License at
+
+           http://www.apache.org/licenses/LICENSE-2.0
+
+         Unless required by applicable law or agreed to in writing,
+         software distributed under the License is distributed on an
+         "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+         KIND, either express or implied.  See the License for the
+         specific language governing permissions and limitations
+         under the License.
+---
+
+# Руководство для платформы iOS
+
+В этом руководстве показано, как настроить среду
разработки SDK для развертывания приложений Cordova для
iOS-устройств, таких как iPhone и iPad. Смотрите ниже для
более подробной информации конкретной платформы:
+
+*   Конфигурация iOS
+*   Обновление для iOS
+*   WebViews в iOS
+*   Плагины для iOS
+*   Руководство по инструментам командной строки
iOS
+
+Средства командной строки относятся к версии Cordova
до 3.0. Смотрите раздел "Интерфейс командной строки"
для информации о текущем интерфейсе интерфейс командной
строки.
+
+## Требования и поддержка
+
+Инструменты Apple ®, необходимые для создания приложений
iOS, выполняются только в операционной системе OS X на
компьютерах Mac на базе Intel. Xcode ® 6.0 (минимальная требуемая
версия) работает только на OS X версии 10.9 (Mavericks) или
выше и включает в себя iOS 8 SDK (Software Development Kit). Чтобы
отправить приложений в Apple App Store℠ требует последние
версии инструментария Apple.
+
+Вы можете проверить многие из функций Cordova, используя
эмулятор iOS установленный с iOS SDK и Xcode, но вам нужно
реальное устройство чтобы полностью проверить все
функции приложения перед отправкой его в App Store. Устройство
должно иметь установленным по крайней мере iOS 6.x ,
минимальная версия iOS поддерживаемая начиная с Cordova
3.0. Подерживаемые устройства включают все модели
iPad ®, iPhone ® 3GS и выше и iPod ® Touch 3-го поколения или позднее.
Для установки приложений на устройство, необходимо
также быть членом компании Apple [iOS разработчик программы][1],
которая стоит 
 $99 в год. В этом руководстве показано, как развернуть
приложения в эмуляторе iOS, для которого не нужно зарегистрироваться
в программе developer.
+
+ [1]: https://developer.apple.com/programs/ios/
+
+Инструменты [Ios-sim][2] и [ios-deploy][3] позволяют вам запустить
приложение iOS на iOS симуляторе или iOS устройстве из
командной строки.
+
+ [2]: https://www.npmjs.org/package/ios-sim
+ [3]: https://www.npmjs.org/package/ios-deploy
+
+## Установите SDK
+
+Существует два способа для загрузки Xcode:
+
+*   из [App Store][4], доступных путем поиска «Xcode» в приложении
**App Store** .
+
+*   от [Apple Developer Downloads][5], который требует регистрации
в качестве разработчиков Apple.
+
+ [4]: https://itunes.apple.com/us/app/xcode/id497799835?mt=12
+ [5]: https://developer.apple.com/downloads/index.action
+
+После установки Xcode, некоторые инструменты командной
строки должны быть доступны чтобы инструменты Cordova
запускались. В меню **Xcode** выберите **Preferences**, а затем
вкладку **Downloads** . На панели **Components** нажмите кнопку
**Install** рядом с списком **Command Line Tools**.
+
+## Установить средства развертывания
+
+Запустите из терминала командной строки:
+
+        $ npm install -g ios-sim
+        $ npm install -g ios-deploy
+    
+
+## Создание нового проекта
+
+Используйте утилиту `cordova` для настройки нового проекта,
как описано в разделе "Интерфейс командной строки
Cordova". Например выполните в каталоге исходного кода:
+
+        $ cordova create hello com.example.hello "HelloWorld"
+        $ cd hello
+        $ cordova platform add ios
+        $ cordova prepare              # or "cordova build"
+    
+
+## Развертывание приложения
+
+Для развертывания приложения на подключенном iOS
устройстве:
+
+        $ cordova run ios --device
+    
+
+Для развертывания приложения на iOS эмуляторе по умолчанию:
+
+        $ cordova emulate ios
+    
+
+Можно использовать **cordova run android --list** чтобы увидеть
все доступные цели и **cordova run android --target=имя_устройства**
для запуска приложения на конкретном устройстве
или эмуляторе (например, `cordova run android --target="Nexus4_emulator"`).
+
+Чтобы увидеть дополнительные параметры построения
и запуска также можно использовать **cordova run --help**.
+
+## Откройте проект в SDK
+
+Как только платформа ios добавлена в проект, вы можете
открыть его из в Xcode. Дважды щелкните, чтобы открыть
файл `hello/platforms/ios/hello.xcodeproj`. Экран должен выглядеть
следующим образом:
+
+![][6]
+
+ [6]: img/guide/platforms/ios/helloworld_project.png
+
+## Развертывание на эмулятор
+
+Для предварительного просмотра приложения в эмуляторе
iOS:
+
+1.  Убедитесь, что на левой панели выбран файл *.xcodeproj*
.
+
+2.  Выберите приложение **hello** на панели справа.
+
+3.  Выберите предполагаемый устройство из меню **схема**
панели инструментов, таких как iPhone 6.0 симулятор как
подчеркнул здесь:
+    
+    ![][7]
+
+4.  Нажмите кнопку **Run** , который появляется в панели
же для левой части **схемы**. Это строит, развертывает
и запускает приложение в эмуляторе. Отдельный эмулятор
приложение открывает для отображения приложения:
+    
+    ![][8]
+    
+    Только один эмулятор может выполняться одновременно,
так что если вы хотите протестировать приложение
в эмуляторе другой, вам нужно выйти из эмулятора приложения
и запускать различные цели в пределах Xcode.
+
+ [7]: img/guide/platforms/ios/select_xcode_scheme.png
+ [8]: img/guide/platforms/ios/HelloWorldStandard.png
+
+Xcode идет с встроенным эмулятором для последних версий
iPhone и iPad. Более старые версии могут быть доступны
из панели **→ Preferences → Downloads → Components**.
+
+## Развертывание на устройство
+
+Подробные сведения о различных требований для развертывания
на устройстве обратитесь к разделу *Настройка развития
и распределения ресурсов* документа [Рабочий процесс
при использовании инструментов для iOS][9] компании
Apple. Вкратце вам нужно выполнить следующие действия
перед развертыванием:
+
+ [9]: http://developer.apple.com/library/ios/#documentation/Xcode/Conceptual/ios_development_workflow/00-About_the_iOS_Application_Development_Workflow/introduction.html#//apple_ref/doc/uid/TP40007959
+
+1.  Присоединяйтесь к компании Apple iOS разработчик программы.
+
+2.  Создайте *профиль подготовки* в [iOS Provisioning портал][10].
Вы можете использовать его *Развития провизионирования
помощник* для создания и установки профиля и сертификат
Xcode требует.
+
+3.  Убедитесь, что раздел *Подписи кода* *Удостоверения
подписи кода* в параметры проекта для провизионирования
имя профиля.
+
+ [10]: https://developer.apple.com/ios/manage/overview/index.action
+
+Чтобы развернуть на устройстве:
+
+1.  Используйте кабель USB, подключите устройство к
ваш Mac.
+
+2.  Выберите имя проекта в окне Xcode **схема** раскрывающемся
списке.
+
+3.  Выберите устройство из списка **устройств** . Если
он подключен через USB, но по-прежнему не отображается,
нажмите кнопку **Организатор** для устранения любых
ошибок.
+
+4.  Нажмите на кнопку **Run** для построения, развертывания
и запуска приложения на вашем устройстве.
+
+## Общие проблемы
+
+**Предупреждение об устаревании**: когда интерфейс
программирования приложения (API) изменяется или заменяется
другим API, он помечается как *deprecated*. API по-прежнему
работает в ближайшем будущем, но со временем удаляется.
Некоторые из этих устаревших интерфейсов отражаются
в Apache Cordova, и Xcode выдает предупреждения о них, когда
вы собираете и развертываете приложение.
+
+Xcode предупреждение о методе `invokeString`, касается функциональности,
которая запускает приложение по пользовательскому
URL-адресу. В то время как механизм для загрузки из
пользовательских URL-адресов изменился, этот код по-прежнему
присутствует и предоставлять функциональность обратной
совместимости для приложений, созданные с более старыми
версиями Cordova. Пример приложения не использует эту
функциональность, поэтому эти предупреждения можно
игнорировать. Чтобы избежать отображения этих предупреждений,
удалите код, который ссылается на уста
 ревшие invokeString API:
+
+*   Отредактируйте файл *Classes/MainViewController.m* , окружают
следующий блок кода с `/*` и `*/` комментарии, как показано
ниже, затем введите **Command-s** , чтобы сохранить файл:
+    
+        (void)webViewDidFinishLoad:(UIWebView*)theWebView
+        {
+        // only valid if ___PROJECTNAME__-Info.plist specifies a protocol to handle
+        /*
+        if (self.invokeString) {
+          // this is passed before the deviceready event is fired, so you can access it in
js when you receive deviceready
+          NSLog(@"DEPRECATED: window.invokeString - use the window.handleOpenURL(url) function
instead, which is always called when the app is launched through a custom scheme url.");
+          NSString* jsString = [NSString stringWithFormat:@"var invokeString = \"%@\";",
self.invokeString];
+          [theWebView stringByEvaluatingJavaScriptFromString:jsString];
+        }
+        */
+        // Black base color for background matches the native apps
+        theWebView.backgroundColor = [UIColor blackColor];
+        
+        return [super webViewDidFinishLoad:theWebView];
+        }
+        
+*   Отредактируйте файл *Classes/AppViewDelegate.m* , закомментируйте
следующую строку, вставляя двойной косой черты, как
показано ниже, а затем введите **Command-s** , чтобы сохранить
файл:
+    
+        //self.viewController.invokeString = invokeString;
+        
+*   Нажмите **Command-b** , перестройте проект и устранить
эти предупреждения.
+
+<!-- Does this fix only last until the next "cordova prepare"? -->
+
+**Отсутсвующие заголовки**: ошибки компиляции, связанные
с недостающими заголовками в результате проблем
с расположение сборки и может быть исправлено через
настройки Xcode:
+
+1.  Выберите **Xcode → настройки → места**.
+
+2.  В разделе **Данные** нажмите кнопку **Дополнительно**
и выберите **уникальный** как **Расположение сборки**
, как показано здесь:
+    
+    ![][11]
+
+ [11]: img/guide/platforms/ios/xcode_build_location.png
+
+Это параметр по умолчанию для новой установки Xcode,
но он может быть установлен по-другому после обновления
старой версии Xcode.
+
+Для получения дополнительной информации обратитесь
к документации компании Apple:
+
+*   [Начало разработки iOS приложений сегодня][12] предоставляет
быстрый обзор шагов для разработки iOS приложения.
+
+*   [Член центра Домашняя страница][13] содержит ссылки
на несколько iOS технических ресурсов, включая технические
ресурсы, подготовки портала, распространения руководств
и форумы сообщества.
+
+*   [Инструменты рабочего процесса руководства для
iOS][9]
+
+*   [Руководство пользователя Xcode][14]
+
+*   [Видеосессии][15] от Всемирной Конференции Разработчиков
Apple 2012 (WWDC2012)
+
+*   [Команда xcode-select][16], которая помогает указать правильную
версию Xcode, если более чем одна версия установлена.
+
+ [12]: http://developer.apple.com/library/ios/#referencelibrary/GettingStarted/RoadMapiOS/index.html#//apple_ref/doc/uid/TP40011343
+ [13]: https://developer.apple.com/membercenter/index.action
+ [14]: http://developer.apple.com/library/ios/#documentation/ToolsLanguages/Conceptual/Xcode4UserGuide/000-About_Xcode/about.html#//apple_ref/doc/uid/TP40010215
+ [15]: https://developer.apple.com/videos/wwdc/2012/
+ [16]: http://developer.apple.com/library/mac/#documentation/Darwin/Reference/ManPages/man1/xcode-select.1.html
+
+(Mac®, OS X®, Apple®, Xcode®, App Store℠, iPad®, iPhone®, iPod® и Finder® являются
товарными знаками Apple Inc.)
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/5846f316/docs/ru/5.1.1/guide/platforms/ios/plugin.md
----------------------------------------------------------------------
diff --git a/docs/ru/5.1.1/guide/platforms/ios/plugin.md b/docs/ru/5.1.1/guide/platforms/ios/plugin.md
new file mode 100644
index 0000000..c09cac1
--- /dev/null
+++ b/docs/ru/5.1.1/guide/platforms/ios/plugin.md
@@ -0,0 +1,181 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+         or more contributor license agreements.  See the NOTICE file
+         distributed with this work for additional information
+         regarding copyright ownership.  The ASF licenses this file
+         to you under the Apache License, Version 2.0 (the
+         "License"); you may not use this file except in compliance
+         with the License.  You may obtain a copy of the License at
+
+           http://www.apache.org/licenses/LICENSE-2.0
+
+         Unless required by applicable law or agreed to in writing,
+         software distributed under the License is distributed on an
+         "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+         KIND, either express or implied.  See the License for the
+         specific language governing permissions and limitations
+         under the License.
+---
+
+# Плагины для iOS
+
+Этот раздел содержит сведения о том, как реализовать
код родной плагин на платформе iOS. Прежде чем читать
это, увидеть приложения плагины обзор структуры плагина
и его общий интерфейс JavaScript. Этот раздел продолжает
демонстрировать пример *echo* плагина, который соообщается
из WebView Cordova с кодом платформы и в обратную строну.
+
+IOS плагин реализован как Objective-C класс, который расширяет
`CDVPlugin` класс. Для JavaScript `exec` метода `service` параметр для
сопоставления с Objective-C класс, каждый плагин должен
быть зарегистрирован как `<feature>` в каталоге именованного
приложения тег `config.xml` файл.
+
+## Сопоставление классов плагина
+
+Часть JavaScript плагин использует `cordova.exec` метод следующим
образом:
+
+        Exec (< successFunction >, < failFunction >, < служба >,
< действия > [< args >]);
+    
+
+Это маршалирует запрос от `UIWebView` в сторону родной
iOS эффективно вызова `action` метод `service` класса, с аргументами,
переданными в `args` массив.
+
+Укажите плагин как `<feature>` тег в Кордова iOS приложения
проекта `config.xml` файл, используя `plugin.xml` файл, чтобы
придать этой разметки автоматически, как описано
в приложении плагины:
+
+        <feature name="LocalStorage">
+            <param name="ios-package" value="CDVLocalStorage" />
+        </feature>
+    
+
+Функция `name` атрибут должен соответствовать указан
как JavaScript `exec` вызова `service` параметр. `value`Атрибут должен
соответствовать имени плагина Objective-C класса. `<param>`Элемента
`name` всегда должно быть `ios-package` . Если не следовать
этим рекомендациям, может скомпилировать плагин,
но Cordova до сих пор не может быть возможность доступа
к ней.
+
+## Инициализация плагин его жизненный цикл
+
+Для жизни каждого из них создается один экземпляр
объекта плагин `UIWebView` . Плагины создаются обычно при
первом обращении путем вызова из JavaScript. В противном
случае они могут быть созданы путем установки `param`
с именем `onload` для `true` в `config.xml` файл:
+
+        <feature name="Echo">
+            <param name="ios-package" value="Echo" />
+            <param name="onload" value="true" />
+        </feature>
+    
+
+Существует *нет* места для инициализатора для плагинов.
Вместо этого следует использовать плагины `pluginInitialize`
метод для их запуска логики.
+
+Плагины с долго выполняющихся запросов, фон деятельности,
такие как воспроизведение мультимедиа, слушателей
или что поддерживать внутреннее состояние следует
осуществлять `onReset` метод для очистки этих мероприятий.
Метод работает, когда `UIWebView` переходит на новую страницу
или обновления, которая перезагружает JavaScript.
+
+## Написание iOS Cordova плагин
+
+Вызов JavaScript запускает запрос плагин к родной стороне,
и соответствующие iOS плагин Objective-C отображается правильно
в `config.xml` файл, но как окончательный iOS Objective-C модуль
класса взгляд? Все, что отправляется в плагин с JavaScript
в `exec` функция передается в соответствующий класс
плагин `action` метод. Метод плагин имеет подпись:
+
+        - (void)myMethod:(CDVInvokedUrlCommand*)command
+        {
+            CDVPluginResult* pluginResult = nil;
+            NSString* myarg = [command.arguments objectAtIndex:0];
+    
+            if (myarg != nil) {
+                pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];
+            } else {
+                pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:@"Arg
was null"];
+            }
+            [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
+        }
+    
+
+Для более подробной информации, см. `[CDVInvokedUrlCommand.h](https://github.com/apache/cordova-ios/blob/master/CordovaLib/Classes/CDVInvokedUrlCommand.h)`
, `[CDVPluginResult.h](https://github.com/apache/cordova-ios/blob/master/CordovaLib/Classes/CDVPluginResult.h)`
, и`[CDVCommandDelegate.h](https://github.com/apache/cordova-ios/blob/master/CordovaLib/Classes/CDVCommandDelegate.h)`.
+
+## iOS CDVPluginResult типы сообщений
+
+Вы можете использовать `CDVPluginResult` для возвращения
различных результата типа обратно в обратных вызовов
JavaScript, с помощью методов класса, следовать этой схеме:
+
+        + (CDVPluginResult*)resultWithStatus:(CDVCommandStatus)statusOrdinal messageAs...
+    
+
+Вы можете создать `String` , `Int` , `Double` , `Bool` , `Array` , `Dictionary`
, `ArrayBuffer` , и `Multipart` типов. Вы можете также оставить
вне каких-либо аргументов, чтобы отправить статус,
или возвращает ошибку, или даже не решили отправить
любой плагин результат, в этом случае срабатывает
ни обратного вызова.
+
+Обратите внимание на следующие для сложных возвращаемых
значений:
+
+*   `messageAsArrayBuffer`ожидает `NSData*` и преобразует `ArrayBuffer`
в обратного вызова JavaScript. Кроме того, любой `ArrayBuffer`
отправляет плагин JavaScript преобразуются в`NSData*`.
+
+*   `messageAsMultipart`ожидает `NSArray*` содержащие любые другие
поддерживаемые типы и отправляет весь массив как
`arguments` для обратного вызова JavaScript. Таким образом,
все аргументы сериализуются и десериализуются как
необходимости, так что это безопасно вернуться `NSData*`
как составной, а не как `Array` /`Dictionary`.
+
+## Эхо iOS плагин пример
+
+Для сопоставления интерфейса JavaScript функция *echo*,
описанная в разделе "Плагины приложения", используйте
`plugin.xml` для вставки спецификации `feature` в файл `config.xml`
платформы:
+
+        <platform name="ios">
+            <config-file target="config.xml" parent="/*">
+                <feature name="Echo">
+                    <param name="ios-package" value="Echo" />
+                </feature>
+            </config-file>
+        </platform>
+    
+
+Тогда мы хотели бы добавить следующие `Echo.h` и `Echo.m`
файлы в `Plugins` папку в каталоге приложений Cordova-iOS:
+
+        /********* Echo.h Cordova Plugin Header *******/
+    
+        #import <Cordova/CDV.h>
+    
+        @interface Echo : CDVPlugin
+    
+        - (void)echo:(CDVInvokedUrlCommand*)command;
+    
+        @end
+    
+        /********* Echo.m Cordova Plugin Implementation *******/
+    
+        #import "Echo.h"
+        #import <Cordova/CDV.h>
+    
+        @implementation Echo
+    
+        - (void)echo:(CDVInvokedUrlCommand*)command
+        {
+            CDVPluginResult* pluginResult = nil;
+            NSString* echo = [command.arguments objectAtIndex:0];
+    
+            if (echo != nil && [echo length] > 0) {
+                pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:echo];
+            } else {
+                pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR];
+            }
+    
+            [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
+        }
+    
+        @end
+    
+
+Необходимого импорта в верхней части файла расширяет
класс от `CDVPlugin` . В этом случае плагин поддерживает
только один `echo` действий. Он получает эхо строку путем
вызова `objectAtIndex` метод получить первый параметр `arguments`
массив, который соответствует аргументам, принятому
JavaScript в `exec()` функции.
+
+Он проверяет параметр, чтобы убедиться, что это не
`nil` или является пустой строкой, возвращая `PluginResult`
с `ERROR` статус, если это так. Если параметр проходит
проверку, он возвращает `PluginResult` с `OK` статус, проходя
в оригинале `echo` строка. Наконец, он отправляет результат
`self.commandDelegate` , которая выполняет `exec` метода успех
или неудача обратные вызовы на стороне JavaScript. Если
успех обратного вызова вызывается, он проходит в
`echo` параметр.
+
+## iOS интеграции
+
+`CDVPlugin`Класса есть другие методы, которые можно переопределить
ваш плагин. Например, вы можете захватить `pause` , `resume`
, прервать app и `handleOpenURL` события. См [CDVPlugin.h][1] и [CDVPlugin.m][2]
для руководства.
+
+ [1]: https://github.com/apache/cordova-ios/blob/master/CordovaLib/Classes/CDVPlugin.h
+ [2]: https://github.com/apache/cordova-ios/blob/master/CordovaLib/Classes/CDVPlugin.m
+
+## Работа с потоками
+
+Плагин методы обычно выполняются в том же потоке,
что основной интерфейс. Если ваш плагин требует большой
обработки или требует блокирующий вызов, вам следует
использовать фоновый поток. Например:
+
+        - (void)myPluginMethod:(CDVInvokedUrlCommand*)command
+        {
+            // Check command.arguments here.
+            [self.commandDelegate runInBackground:^{
+                NSString* payload = nil;
+                // Some blocking logic...
+                CDVPluginResult* pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK
messageAsString:payload];
+                // The sendPluginResult method is thread-safe.
+                [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
+            }];
+        }
+    
+
+## Отладка iOS плагины
+
+Для отладки на стороне Objective-C, требуется встроенный
отладчик Xcode's. Для JavaScript на iOS 5.0 или позднее можно
использовать [Weinre, проект Apache Cordova][3], или [iWebInspector,
сторонняя утилита][4]. Для iOS 8 вы можете подключиться
через Safari 8.0 к приложению которое работает в симуляторе
iOS 8.
+
+ [3]: https://github.com/apache/cordova-weinre
+ [4]: http://www.iwebinspector.com/
+
+## Наиболее распространенные ошибки
+
+*   Не забудьте добавить ваш плагин сопоставление
`config.xml` . Если вы забыли, ошибка регистрируется в консоли
Xcode.
+
+*   Не забудьте добавить любые узлы, при подключении
к в белый список, как описано в "Инструкция по доступу
к внешним ресурсам". Если вы забыли, ошибка регистрируется
в консоли Xcode.
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/5846f316/docs/ru/5.1.1/guide/platforms/ios/tools.md
----------------------------------------------------------------------
diff --git a/docs/ru/5.1.1/guide/platforms/ios/tools.md b/docs/ru/5.1.1/guide/platforms/ios/tools.md
new file mode 100644
index 0000000..6d3864f
--- /dev/null
+++ b/docs/ru/5.1.1/guide/platforms/ios/tools.md
@@ -0,0 +1,93 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+         or more contributor license agreements.  See the NOTICE file
+         distributed with this work for additional information
+         regarding copyright ownership.  The ASF licenses this file
+         to you under the Apache License, Version 2.0 (the
+         "License"); you may not use this file except in compliance
+         with the License.  You may obtain a copy of the License at
+
+           http://www.apache.org/licenses/LICENSE-2.0
+
+         Unless required by applicable law or agreed to in writing,
+         software distributed under the License is distributed on an
+         "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+         KIND, either express or implied.  See the License for the
+         specific language governing permissions and limitations
+         under the License.
+---
+
+# Руководство по инструментам командной строки iOS
+
+В этом руководстве показано, как использовать Кордова
в набор инструментов по центру платформы shell для разработки
приложений для iOS. Этот путь разработки, описанный
в разделе "Введение", может предложить вам больший
спектр вариантов разработки чем кросс платформенный
инструмент CLI, описанные в разделе "Интерфейс командной
строки". Например вам нужно использовать инструменты
оболочки при развертывании настраиваемого Cordova WebView
наряду с собственными компонентами. Перед тем как
использовать какой то путь разработки, сначала необходимо
наст
 оить среду SDK, как описано в разделе "Руководство
для платформы iOS". Эти инструменты полагаются на командной
строки средства Xcode таких как `xcode-select` и`xcodebuild`.
+
+Чтобы включить инструменты оболочки для iOS, скачайте
Cordova с [cordova.apache.org][1]. Загружаемый файл содержит отдельные
архивы для каждой платформы. Разверните каждый вы
хотите настроить таргетинг, `ios` в данном случае. Соответствующие
инструменты обычно доступны в профиле верхнего уровня
`bin` каталог, в противном случае консультироваться
файл **README** для получения более подробной направлениях.
+
+ [1]: http://cordova.apache.org
+
+Эти инструменты позволяют создавать, строить и запускать
приложения для iOS. За информаций о дополнительных
интерфейсах командной строки которые позволяют встраивать
возможности плагинов среди разных платформ, смотрите
раздел "Использование Plugman для управления расширениями".
Смотрите раздел "Плагины приложения" для детальной
информации о том как разрабатывать плагины.
+
+## Создание проекта
+
+Запустите команду `create`, указав существующий путь
к проекту, идентификатор пакета в стиле обратного
формата доменных имен и отображаемое имя приложения.
+
+        $ ./path/to/cordova-ios/bin/create /path/to/my_new_project com.example.project_name
ProjectName
+    
+
+## Построение проекта
+
+        $ /path/to/my_new_project/cordova/build
+    
+
+## Запустить приложение на эмуляторе
+
+        $ /path/to/my_new_project/cordova/run --emulator
+    
+
+## Запуск приложения на устройстве
+
+        $ /path/to/my_new_project/cordova/run --device
+    
+
+## Подпись приложения
+
+Вы можете узнать больше о подписании, распространение
приложений для iOS, создание сертификата и подготовке
профиля на сайте [Библиотека разработчика iOS][2].
+
+ [2]: https://developer.apple.com/library/ios/documentation/IDEs/Conceptual/AppDistributionGuide/ConfiguringYourApp/ConfiguringYourApp.html
+
+Чтобы подписать приложение в Cordova, вам необходимо
следующее: 
+
+*   Подпись кода (`--codeSignIdentity`): [С помощью XCode](https://developer.apple.com/library/ios/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingCertificates/MaintainingCertificates.html#//apple_ref/doc/uid/TP40012582-CH31-SW6)
можно создать новую подпись iOS, и добавить ее в Вашу
связку ключей. Тип подписи кода - как правило распространение
или разработка, должны быть определены здесь.
+
+*   Профиль подготовки (`--provisioningProfile`): [Используя Apple
Member Center][4] вы можете создать профиль подготовки. Скачать
профиль подготовки на компьютер и запустить его в
XCode чтобы его зарегистрировать. Он копируется в это
расположение на вашем Mac: ~/Library/MobileDevice/Provisioning\ Profiles/.
При его открытии в текстовом редакторе, вы можете
найти идентификатор UUID, который должен быть указан
здесь.
+
+*   Правила ресурсов для подписывания кода (`--codeSignResourceRules`)
(необязательно): позволяет указать пользовательские
правила подписания ресурсов.
+
+ [4]: https://developer.apple.com/library/ios/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingProfiles/MaintainingProfiles.html#//apple_ref/doc/uid/TP40012582-CH30-SW61
+
+Эти параметры могут быть заданы с помощью аргументов
командной строки указанных выше для `построения`
или `запуска` скриптов:
+
+        $ /path/to/my_new_project/cordova/build --codeSignIdentitiy="iPhone Distribtion"
--provisioningProfile="926c2bd6-8de9-4c2f-8407-1016d2d12954" 
+    
+
+Кроме того их можно указать в файле конфигурации
сборки (build.json) с помощью аргумента (`--buildConfig`). Ниже
приведен пример файла конфигурации построения:
+
+    {
+         "ios": {
+             "debug": {
+                 "codeSignIdentitiy": "iPhone Development",
+                 "provisioningProfile": "926c2bd6-8de9-4c2f-8407-1016d2d12954",
+             },
+             "release": {
+                 "codeSignIdentitiy": "iPhone Distribution"
+                 "provisioningProfile": "70f699ad-faf1-4adE-8fea-9d84738fb306",
+             }
+         }
+     }
+    
+
+Существует также поддержка смешивания и комбинирования
аргументов командной строки и параметров в файле
build.json. Значения из аргументов командной строки будет
получить приоритет.
+
+## Ведение журнала
+
+        $ /path/to/my_new_project/cordova/log
\ No newline at end of file


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


Mime
View raw message