Эта версия документации устарела! Нажмите здесь для последней выпущенной версии.

iOS WebViews

Начиная с Cordova 1.4, можно использовать Cordova как компонент в iOS приложений. Этот компонент является кодовым названием «Колун».

Новые Cordova-приложения, созданные с помощью Xcode шаблона, доступного в Cordova 1.4 или более широкому использованию Кливер. (Шаблон — Кливер в эталонной реализации).

Колун осуществления подпроектов на основе поддерживают только Cordova 2.0.0 и последующих версиях.

Необходимые условия

Кордова 2.3.0 или больше
Xcode 4.5 или больше
config.xmlфайл (из вновь созданного iOS проекта)

Добавление Кливер в Xcode проект (подпроект CordovaLib)

Скачайте и распакуйте Cordova источник постоянного каталог на жестком диске, например~/Documents/Cordova.
Закройте Xcode, если она запущена.
С помощью Terminal.app, перейдите в каталог, где вы положили загруженных исходных выше.
Копия config.xml файл в каталог проекта на диске (см выше).
Перетащите и падение config.xml файлов в навигатор проекта Xcode.
Выберите переключатель создать группы для любой дополнительной папки и нажмите кнопку Готово.
Перетащите и падение CordovaLib.xcodeproj файлов в навигатор проекта Xcode (от постоянного каталога расположение выше и она должна быть в CordovaLib подкаталог).
Select CordovaLib.xcodeproj in the Project Navigator.
Введите сочетание клавиш Option-Command-1 , чтобы показать Инспектора файлов.
Выберите относительный группу в Инспектора файлов для раскрывающегося меню для местоположения.
Выберите значок проекта в диспетчере структуры проекта, выберите ваши цели, а затем выберите вкладку Параметры построения .
Добавить -all_load и -Obj-C для Других компоновщика Flags значения.
Нажмите на значок проекта в диспетчере структуры проекта, выберите целевой, а затем выберите вкладку Build фаз .
Разверните двоичных файлов связь с библиотеками.

Выберите + кнопку и добавьте следующие рамки. При необходимости в диспетчере структуры проекта, переместите их под рамки группы):

AddressBook.framework
AddressBookUI.framework
AudioToolbox.framework
AVFoundation.framework
CoreLocation.framework
MediaPlayer.framework
QuartzCore.framework
SystemConfiguration.framework
MobileCoreServices.framework
CoreMedia.framework

Разверните узел Целевого объекта зависимостей, приставки, помечены как это, если у вас есть несколько коробки!
Выберите + кнопку и добавьте CordovaLib создания продукта.
Разверните Двоичных файлов связь с библиотеками, приставки, помечены как это, если у вас есть несколько коробки!
Выберите + кнопку и добавитьlibCordova.a.
Присвоить уникальный Xcode предпочтения предпочтения Xcode → места → полученных данных → передовые....
Выберите значок проекта в диспетчере структуры проекта, выберите ваши цели, а затем выберите вкладку Параметры построения .
Поиск путей поиска заголовка. Для этого параметра, добавьте эти три значения ниже (в кавычках):
```
"$(TARGET_BUILD_DIR)/usr/local/lib/include"        
"$(OBJROOT)/UninstalledProducts/include"
"$(BUILT_PRODUCTS_DIR)"
```
С Cordova 2.1.0 CordovaLib был обновлен для использования Автоматического подсчета ссылок (ARC). Вам не нужно для обновления до дуги для использования CordovaLib, но если вы хотите обновить проект для использования дуги, пожалуйста, используйте мастер миграции Xcode из меню: Правка → рефакторинг → преобразовать в Objective-C ARC..., снимите флажок libCordova.a, затем запустите мастер до завершения.

Использование CDVViewController в коде

Добавьте этот заголовок:
```
#import <Cordova/CDVViewController.h>
```
Создайте экземпляр нового CDVViewController и сохранить его где-нибудь (например, к свойству в классе):
```
CDVViewController* viewController = [CDVViewController new];
```
(ФАКУЛЬТАТИВНЫЙ) Установите wwwFolderName Свойства (по умолчанию www ):
```
viewController.wwwFolderName = @"myfolder";
```
(ФАКУЛЬТАТИВНЫЙ) Задайте начальную страницу в config.xml, <content> тег.
```
<content src="index.html" />
```
ИЛИ
```
<content src="http://apache.org" />
```
(ФАКУЛЬТАТИВНЫЙ) Установите useSplashScreen Свойства (по умолчанию NO ):
```
viewController.useSplashScreen = YES;
```
Задать кадр представления (всегда установить это как последнего свойства):
```
viewController.view.frame = CGRectMake(0, 0, 320, 480);
```
Добавьте Кливер в представление:
```
[myView addSubview:viewController.view];
```

Добавление HTML, CSS и JavaScript активов

Создайте новый каталог проекта на диске, www например.
Положите ваши активы HTML, CSS и JavaScript в этот каталог.
Перетащите и поместите каталог в навигатор проекта Xcode.
Выберите переключатель создать папку ссылок для любых папок, добавил .
Установите соответствующий wwwFolderName и startPage свойства для папки, вы первоначально создали, или использовать значения по умолчанию (см. предыдущий раздел) при создании экземпляраCDVViewController.
```
/*
 if you created a folder called 'myfolder' and
 you want the file 'mypage.html' in it to be
 the startPage
*/
viewController.wwwFolderName = @"myfolder";
viewController.startPage = @"mypage.html"
```