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.

WebViews в iOS

В этом руководстве показано, как внедрить компонент WebView Cordova поддержкой в рамках более крупных приложений iOS. Дополнительные сведения о том, как эти компоненты могут взаимодействовать друг с другом смотрите приложение плагины.

Поддержка WebViews для iOS началась с Cordova версии 1.4, с помощью компонентаCleaver, для которого шаблон Xcode выступает в качестве эталонной реализации.Кордова 2.0 и более поздних версий поддерживают только реализация на основе подпроекта Кливер.

Эти инструкции требуют по крайней мере Cordova 3.x и Xcode 6.0, совместно с файлом config.xml из только что созданного проекта iOS. Вы можете использовать процедуру в разделе “Интерфейс командной строки” можно использовать для создания нового проекта, а затем получить файл config.xml в подкаталоге именованного приложения в platforms/ios.

Следуя этим инструкциям, убедитесь, что у вас есть дистрибутив последней версии Cordova. Скачайте его с cordova.apache.org и распакуйте пакет для iOS.

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

Если оно выполняется, закройте Xcode.
Откройте терминал и перейдите в исходный каталог для iOS Кордова.
Копия config.xml файла, описанного выше в каталог проекта.
Откройте Xcode и использовать Finder для копирования config.xml файл в окно своей Структуры проекта .
Выберите создать группы для любой дополнительной папки и нажмите кнопку Готово.
Используйте Finder для копирования CordovaLib/CordovaLib.xcodeproj файл в Xcode в Диспетчере структуры проекта
Выберите CordovaLib.xcodeproj в рамках проекта навигатор.
Введите сочетание клавиш Option-Command-1 , чтобы показать Файл инспектор.
Выберите относительный группу в Инспектора файлов в раскрывающемся меню для местоположения.
Выберите значок проекта в Диспетчере структуры проекта, выберите Цель, а затем выберите вкладку Параметры построения .
Добавить -force_load и -Obj-C для значения Другие флаги компоновщика .
Нажмите на значок проекта в диспетчере структуры проекта, выберите Цель, а затем выберите вкладку Построение этапов .
Расширять связь двоичные файлы с библиотеками.
Выберите + кнопку и добавьте следующие рамки. При необходимости в Диспетчере структуры проекта, переместите их в группе рамки :
```
AssetsLibrary.framework
CoreLocation.framework
CoreGraphics.framework
MobileCoreServices.framework
```
Разверните узел Целевого объекта зависимостей, приставки с этим ярлыком, если существует более одного окна.
Выберите + кнопку и добавить CordovaLib создания продукта.
Разверните Двоичные файлы связь с библиотеками, приставки с этим ярлыком, если существует более одного окна.
Выберите + кнопку и добавитьlibCordova.a.
Задать 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 используйте Finder.
Выберите пункт создать папку ссылки для любых папок, добавлен.
Установите соответствующие 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"
```