This version of the documentation is under development! Click here for the latest released version.

iOS WebViews

Ten poradnik pokazuje jak wobec sprzeniewierzyć Cordova włączony Widok sieci Web składnika w większych aplikacji na iOS. Szczegółowe informacje na temat jak te składniki mogą komunikować się ze sobą, zobacz wtyczki aplikacji.

Wsparcie dla WebViews dla iOS rozpoczął z Cordova wersja 1.4, za pomocą Cleaver element, dla którego szablon Xcode służy jako odniesienie realizacji. Cordova 2.0 i nowsze wersje obsługują tylko realizacji podprojektu w oparciu tasak.

Instrukcje te wymagają co najmniej Cordova 3.x i Xcode 6.0, wraz z pliku config.xml z nowo utworzonego iOS projektu. Można użyć procedury na interfejs wiersza polecenia do tworzenia nowego projektu, a następnie uzyskać config.xml plik w aplikacji o nazwie podkatalogu wplatforms/ios.

Aby wykonać te instrukcje, upewnij się, że masz najnowsze dystrybucji Cordova. Pobierz go z cordova.apache.org i rozpakuj jego pakiet iOS.

Dodawanie tasak do projekt Xcode (CordovaLib podprojektu)

Zamknąć Xcode, jeśli jest uruchomiony.
Otwórz terminal i przejdź do katalogu źródłowego dla Cordova iOS.
Kopia config.xml plik opisany w katalogu projektu.
Otwórz Xcode i skopiować za pomocą programu Finder config.xml pliku w oknie Nawigator projektu .
Wybierz polecenie Utwórz grupy o wszelkie dodane foldery i naciśnij przycisk Zakończ.
Aby skopiować za pomocą programu Finder CordovaLib/CordovaLib.xcodeproj plik w Xcode w Nawigatorze projektu
Wybierz CordovaLib.xcodeproj w nawigatorze projektu.
Typ opcji-polecenia-1 kombinację klawiszy, aby pokazać Plik inspektor.
Wybierz w stosunku do grupy w Pliku inspektor spadać-w dół menu dla lokalizacji.
Wybierz ikonę projektu w Nawigatorze projektu, wybierz miejsce docelowe, a następnie wybierz kartę Ustawienia budować .
Dodać -force_load i -Obj-C na Inne Linker flagi wartość.
Kliknij na ikonę projektu w Nawigatorze projektu, wybierz miejsce docelowe, a następnie wybierz kartę Faz budowy .
Rozwinąć Link binarki z biblioteki.
Wybierz + przycisk, a następnie dodaj następujące ramy. Opcjonalnie w Nawigatorze projektu, przenosić je w grupie RAM :
```
AssetsLibrary.framework
CoreLocation.framework
CoreGraphics.framework
MobileCoreServices.framework
```
Rozwiń węzeł Miejsce docelowe zależności, z tego oznakowania, jeśli istnieje więcej niż jedno pole, w polu u góry.
Wybierz + przycisk, a następnie Dodaj CordovaLib budować produktu.
Rozwinąć Link binarki z biblioteki, z tego oznakowania, jeśli istnieje więcej niż jedno pole, w polu u góry.
Wybierz + przycisk, a następnie DodajlibCordova.a.
Zestaw Xcode preferencje → lokalizacje → uzyskanych danych → zaawansowane... unikatowe.
Wybierz ikonę projektu w Nawigatorze projektu, wybierz miejsce docelowe, a następnie wybierz kartę Ustawienia budować .
Szukaj dla nagłówka ścieżki wyszukiwania. Dla tego ustawienia, należy dodać te trzy wartości poniżej, wraz z cudzysłowami:
```
"$(TARGET_BUILD_DIR)/usr/local/lib/include"        
"$(OBJROOT)/UninstalledProducts/include"
"$(BUILT_PRODUCTS_DIR)"
```
Od Cordova 2.1.0 CordovaLib ma był ulepszony wobec używać Automatycznego liczenia odniesienia (ARC). Nie trzeba uaktualnić do ŁUKU , aby używać CordovaLib , ale jeśli chcesz uaktualnić twój projekt za pomocą ŁUKU, należy użyć Kreatora migracji Xcode z Edycja → refaktoringu → konwersji na cel-C ARC... menu, Usuń zaznaczenie pola wyboru libCordova.a, a następnie uruchomić kreatora do zakończenia.

Za pomocą CDVViewController

Dodaj następujący nagłówek:
```
#import <Cordova/CDVViewController.h>
```
Wystąpienia nowego CDVViewController i zachować go gdzieś, np. do właściwości klasy:
```
CDVViewController* viewController = [CDVViewController new];
```
Opcjonalnie zestaw wwwFolderName Właściwość, która domyślnie www :
```
viewController.wwwFolderName = @"myfolder";
```
Opcjonalnie można ustawić stronę startową config.xml pliku <content> tag, albo lokalny plik:
```
<content src="index.html" />
```
.. .albo witryny zdalnej:
```
<content src="http://apache.org" />
```
Opcjonalnie zestaw useSplashScreen Właściwość, która domyślnie NO :
```
viewController.useSplashScreen = YES;
```
Zestaw ramki widoku. Zawsze ustawić jako ostatni Właściwość:
```
viewController.view.frame = CGRectMake(0, 0, 320, 480);
```

Dodać tasak do widoku:

[myView addSubview:viewController.view];

Dodawanie HTML, CSS i JavaScript aktywów

Utwórz nowy katalog w ramach projektu, www np.
HTML, CSS i JavaScript aktywów umieścić ten katalog.
Aby skopiować katalogu w Xcode w Nawigatorze projektu okno za pomocą programu Finder.
Wybierz Tworzenie folderu odniesienia dla wszelkich dodanych folderów.

Ustaw odpowiednie wwwFolderName i startPage Właściwości katalogu początkowo utworzono, lub użyj ustawień domyślnych (określonego w poprzedniej sekcji) przy uruchamianiuCDVViewController.

/*
 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"