Ca n'est past la dernière version de la documentation. Cliquez ici pour voire la dernière version de la documentation.

iOS WebViews

Commençant par Cordova 1.4, vous pouvez utiliser Cordova en tant que composant dans vos applications iOS. Ce composant est le nom de code « Couperet ».

Nouvelles applications basées sur Cordova créées à l'aide du modèle de Xcode fourni dans Cordova 1.4 ou une plus grande utilisation Cleaver. (Le modèle est l'implémentation de référence de Cleaver.)

Cordova 2.0.0 et les versions ultérieures ne prennent en charge la mise en œuvre de Cleaver sous-projet basé.

Conditions préalables

Cordova 2.3.0 ou supérieur
Xcode 4.5 ou supérieur
config.xmlfichier (depuis un projet nouvellement créé iOS)

Ajout de Cleaver à votre projet Xcode (sous-projet CordovaLib)

Téléchargez et extrayez la source Cordova à un emplacement de répertoire permanent sur votre disque dur, par exemple à~/Documents/Cordova.
Quittez Xcode s'exécute.
Terminal.app, accédez au répertoire où vous avez mis la source téléchargé ci-dessus.
Copie le config.xml fichier dans votre répertoire de projet sur le disque (voir celles décrites ci-dessus).
Faites glisser et déposez le config.xml fichier dans le navigateur de projet de Xcode.
Cliquez sur le bouton radio de créer des groupes pour tous les dossiers ajoutés , puis appuyez sur Terminer.
Faites glisser et déposez le CordovaLib.xcodeproj fichier dans le navigateur de projet de Xcode (à partir du répertoire permanent emplacement ci-dessus et il devrait être dans le CordovaLib sous-répertoire).
Select CordovaLib.xcodeproj in the Project Navigator.
Tapez la combinaison de touches Commande-Option-1 pour afficher Fichier inspecteur.
Choisissez Relative au groupe dans Fichier inspecteur pour le menu déroulant ci-bas pour emplacement.
Sélectionnez l' icône du projet dans le projet de navigation, sélectionnez votre cible, puis sélectionnez l'onglet Paramètres de génération .
Ajouter -all_load et -Obj-C pour la valeur d'Autres indicateurs de Linker .
Cliquez sur l' icône du projet dans le projet de navigation, sélectionnez votre cible, puis sélectionnez l'onglet Générer des Phases .
Développez les binaires de lien avec les bibliothèques.

Sélectionnez le + bouton et ajoutez le suivant les cadres. Éventuellement dans le projet de navigation, déplacez-les dans le groupe de cadres ) :

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

Développez les Dépendances de la cible, la top box étiquetée comme ça si vous avez plusieurs cases !
Sélectionnez le + bouton et ajoutez le CordovaLib construire le produit.
Développez Les binaires de lien avec les bibliothèques, la top box étiquetée comme ça si vous avez plusieurs cases !
Sélectionnez le + bouton et ajoutezlibCordova.a.
Définir les préférences de Xcode Xcode préférences → lieux → données dérivées → avancé... sur Unique.
Sélectionnez l' icône du projet dans le projet de navigation, sélectionnez votre cible, puis sélectionnez l'onglet Paramètres de génération .
Recherche de chemins de recherche de Header. Pour ce paramètre, ajoutez ces trois valeurs ci-dessous (avec les guillemets) :
```
"$(TARGET_BUILD_DIR)/usr/local/lib/include"        
"$(OBJROOT)/UninstalledProducts/include"
"$(BUILT_PRODUCTS_DIR)"
```
Avec Cordova 2.1.0, CordovaLib a été mis à niveau pour utiliser le Comptage de référence automatique (ARC). Vous ne devez de passer à l' ARC à utiliser CordovaLib, mais si vous voulez mettre à niveau votre projet pour utiliser un ARC, veuillez utiliser l'Assistant de migration de Xcode depuis le menu : édition → Refactoriser → convertir en Objective-C ARC..., désélectionnez libCordova.a, puis exécutez l'Assistant jusqu'à la fin.

Dans votre code à l'aide de CDVViewController

Ajouter cet en-tête :
```
#import <Cordova/CDVViewController.h>
```
Instanciez une nouvelle CDVViewController et d'exercer quelque part (par exemple, d'une propriété dans votre classe) :
```
CDVViewController* viewController = [CDVViewController new];
```
(En option) Définir la wwwFolderName propriété (la valeur par défaut www ) :
```
viewController.wwwFolderName = @"myfolder";
```
(En option) Définir la page de démarrage dans votre fichier config.xml, le <content> tag.
```
< src="index.html de contenu" / >
```
OR
```
<content src="http://apache.org" />
```
(En option) Définir la useSplashScreen propriété (la valeur par défaut NO ) :
```
viewController.useSplashScreen = YES;
```
Définir le cadre de l'avis (toujours définir cela comme la dernière propriété) :
```
viewController.view.frame = CGRectMake(0, 0, 320, 480);
```

Ajouter Cleaver à votre vue :

[myView addSubview:viewController.view];

Ajouter vos actifs HTML, CSS et JavaScript

Créez un nouveau répertoire dans votre projet sur disque, www par exemple.
Mettez vos actifs HTML, CSS et JavaScript dans ce répertoire.
Glissez et déposez le répertoire dans le navigateur de projet de Xcode.
Cliquez sur le bouton radio de créer des références de dossier pour tous les dossiers ajoutés .
Le cas échéant la valeur wwwFolderName et startPage Propriétés pour le dossier que vous avez initialement créé, ou utiliser les valeurs par défaut (voir section précédente) lorsque vous instanciez leCDVViewController.
```
/*
 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"
```