Introduction
- Overview
Create apps
- Create your first app
- Platform support
- Develop for platforms
  - Android
  - Blackberry 10
  - iOS
  - Ubuntu
  - Windows
  - WP8
- Manage versions and platforms
- Customize icons
- Store data
- Manage privacy
- Manage security
- Whitelisting
Create plugins
- Create a plugin
- Develop for platforms
  - Android
  - Blackberry 10
  - iOS
  - Windows
  - WP8
- Use Plugman
Advanced Topics
- Embed Cordova in native apps
- Next Steps
Reference
- Config.xml
- Events
- Hooks
- Plugin.xml
- Plugin APIs

Questa non è la versione più recente della documentazione! Click here for the latest released version.

L'aggiornamento iOS

Questa guida Mostra come modificare progetti iOS per l'aggiornamento da versioni precedenti di Cordova. La maggior parte di queste istruzioni si applicano ai progetti creati con un vecchio set di strumenti da riga di comando che precedono la cordova utilità CLI. L'interfaccia della riga di comando per informazioni, vedere come aggiornare la versione di CLI.

Nota: Xcode 6 è richiesto. Attualmente, per presentare all'Apple App Store, è necessario utilizzare l'ultima versione del iOS SDK, che è iOS 8 e questo è incluso solo con Xcode 6.

All'aggiornamento 3.6.0 proietta al 4.0.0

Per i progetti non-CLI, eseguire:

    bin/update percorso/per/progetto

Per i progetti di CLI:

Aggiornamento del cordova versione CLI. Vedere l'interfaccia della riga di comando.
Eseguire cordova platform update android nei progetti esistenti.

3.3.0 all'aggiornamento di progetti a 3.4.0

Per i progetti non-CLI, eseguire:

    bin/update percorso/per/progetto

Per i progetti di CLI:

Aggiornamento del cordova versione CLI. Vedere l'interfaccia della riga di comando.
Eseguire cordova platform update ios

3.2.0 all'aggiornamento di progetti a 3.3.0

Per i progetti non-CLI, eseguire:

    bin/update percorso/per/progetto

Per i progetti di CLI:

Aggiornamento del cordova versione CLI. Vedere l'interfaccia della riga di comando.
Eseguire cordova platform update ios

All'aggiornamento 3.1.0 proietta alla 3.2.0

Per i progetti non-CLI, eseguire:

    bin/update percorso/per/progetto

Per i progetti di CLI:

Aggiornamento del cordova versione CLI. Vedere l'interfaccia della riga di comando.
Eseguire cordova platform update ios

Progetti di aggiornamento 3.0.0 alla 3.1.0

Per i progetti non-CLI, eseguire:

    bin/update percorso/per/progetto

Per i progetti di CLI:

Aggiornamento del cordova versione CLI. Vedere l'interfaccia della riga di comando.
Eseguire cordova platform update ios

iOS 7 edizioni:

Rimuovere width=device-width, height=device-height da meta-tag del file index. html viewport. (Vedere il bug rilevante.)
Aggiornare il tuo plugin core media, media-cattura e splashscreen per iOS 7 supporto.

Xcode 5 temi:

Aggiornare le impostazioni del progetto se Xcode 5 vi chiederà di farlo (nel navigatore questioni).
Aggiornamento tuo Compiler for C/C++/Objective-C impostando, nella scheda Build Settings, Build Options sezione. Scegliere di Default compiler (Apple LLVM 5.0).

Aggiornamento per il CLI (3.0.0) da 2.9.0

Creare un nuovo progetto di Apache Cordova 3.0.0 utilizzando la CLI, cordova, come descritto in l'interfaccia della riga di comando.
Aggiungere le piattaforme il progetto di cordova, per esempio: cordova platform add ios.
Copiare il contenuto del progetto www nella directory del www cartella alla radice del progetto cordova appena creato.
Copiare o sovrascrivere qualsiasi nativi beni dal progetto originale (Resources, ecc.), avendo cura di aggiungere nuovi file al progetto .xcodeproj. Il progetto di iOS si costruisce all'interno della directory platforms\ios.
Copiare il file config. xml nella directory di www e rimuovere eventuali definizioni di plugin. Modificare le impostazioni qui invece di directory della piattaforma.
Utilizzare lo strumento CLI di cordova per installare il plugin che è necessario. Si noti che il CLI gestisce tutti i core API come plugin, così che può essere necessario aggiungere. Solo 3.0.0 plugin sono compatibili con il CLI.
Costruire e testare.

2.9.0 all'aggiornamento di progetti alla 3.0.0

Scaricare ed estrarre la sorgente di Cordova 3.0.0 a una posizione permanente directory sul disco rigido, per esempio a ~/Documents/Cordova-3.0.0.
Se è in esecuzione, chiudere Xcode.
Utilizzando Terminal. app, spostarsi nella directory dove avete messo la sorgente scaricata sopra.
Creare un nuovo progetto, come descritto nella guida strumento Shell di iOS. Avete bisogno di beni da questo nuovo progetto.
Copia il www/cordova.js (si noti che non è più un suffisso di versione, la versione è nel file stesso nell'intestazione) file dal nuovo progetto nella www directory e cancellare il www/cordova.js file.
Aggiornare il riferimento allo script di Cordova nella www/index.html file (e qualsiasi altro file che contengono il riferimento allo script) per puntare al nuovo cordova.js file.
Eliminare il CordovaLib directory e copia il CordovaLib dalla nuovo progetto directory nella directory radice del progetto.

Nota: a partire da Cordova 3.0.0, plugin non sono pre-installati, ed è necessario utilizzare l'utilità della riga di comando plugman per installarli manualmente. Vedere Utilizzo di Plugman per gestire i plugin.

2.8.0 all'aggiornamento di progetti a 2.9.0

Scaricare ed estrarre la sorgente di Cordova 2.9.0 in un percorso di directory permanente sul disco rigido, per esempio a ~/Documents/Cordova-2.9.0.
Se è in esecuzione, chiudere Xcode.
Utilizzando Terminal. app, spostarsi nella directory dove avete messo la sorgente scaricata sopra.
Creare un nuovo progetto, come descritto nella guida strumento Shell di iOS. Avete bisogno di beni da questo nuovo progetto.
Copia il www/cordova.js (si noti che non è più un suffisso di versione, la versione è nel file stesso nell'intestazione) file dal nuovo progetto nella www directory e cancellare il www/cordova.js file.
Aggiornare il riferimento allo script di Cordova nella www/index.html file (e qualsiasi altro file che contengono il riferimento allo script) per puntare al nuovo cordova.js file.
Eliminare il CordovaLib directory e copia il CordovaLib dalla nuovo progetto directory nella directory radice del progetto.

All'aggiornamento 2.7.0 progetti per 2.8.0

Scaricare ed estrarre la sorgente di Cordova 2.8.0 a una posizione permanente directory sul disco rigido, per esempio a ~/Documents/Cordova-2.8.0.
Se è in esecuzione, chiudere Xcode.
Utilizzando Terminal. app, spostarsi nella directory dove avete messo la sorgente scaricata sopra.
Creare un nuovo progetto, come descritto nella guida strumento Shell di iOS. Avete bisogno di beni da questo nuovo progetto.
Copiare il www/cordova.js (si noti che non è più un suffisso di versione, la versione è nel file stesso nell'intestazione) dal nuovo progetto del file nella directory www ed eliminare il file www/cordova-2.7.0.js.
Aggiornare il riferimento allo script di Cordova nella www/index.html file (e qualsiasi altro file che contengono il riferimento allo script) per puntare al nuovo cordova.js file.

Aggiornare qualsiasi tag <plugin> nel file config.xml il tag <feature>. Si noti che tag <plugin> esistenti ancora lavorare, ma sono deprecati. È possibile copiare queste informazioni nel file config. xml per un nuovo progetto. Per esempio:

<plugins>
    <plugin name="LocalStorage" value="CDVLocalStorage" />
    <!-- other plugins -->
</plugins>

<!-- change to: (note that a <feature> tag is on the same level as <plugins> -->
<feature name="LocalStorage">
    <param name="ios-package" value="CDVLocalStorage" />
</feature>
<!-- other <feature> tags -->

Eliminare il CordovaLib directory e copia il CordovaLib dalla nuovo progetto directory nella directory radice del progetto.
Aggiungere questi due quadri al progetto:
```
OpenAL
ImageIO
```
Aggiornare la destinazione del progetto Build Settings. Sotto link → altre bandiere Linker, edit "- Obj - C" per essere "-ObjC".
Aggiornare la destinazione del progetto Build Settings. Sotto link → altre bandiere Linker, cambiare "-tutti _ caricare" essere -force\_load ${BUILT\_PRODUCTS\_DIR}/libCordova.a. Devi solo fare questo se avete il problema definito questo problema..

2.6.0 all'aggiornamento di progetti a 2.7.0

Scaricare ed estrarre la sorgente di Cordova 2.7.0 in un percorso di directory permanente sul disco rigido, per esempio a ~/Documents/Cordova-2.7.0.
Se è in esecuzione, chiudere Xcode.
Utilizzando Terminal. app, spostarsi nella directory dove avete messo la sorgente scaricata sopra.
Creare un nuovo progetto, come descritto nella guida strumento Shell di iOS. avete bisogno di beni da questo nuovo progetto.
Copia il www/cordova-2.7.0.js file del nuovo progetto nella www directory e cancellare il www/cordova-2.6.0.js file.
Aggiornare il riferimento allo script di Cordova nella www/index.html file (e qualsiasi altro file che contengono il riferimento allo script) per puntare al nuovo cordova-2.7.0.js file.
Aggiornare (o sostituire, se non hai mai cambiato il file) il file AppDelegate.m secondo quello dal nuovo progetto (vedere questo diff).
Nel file config. xml, rimuovere questa riga.
Eliminare il CordovaLib directory e copia il CordovaLib dalla nuovo progetto directory nella directory radice del progetto.

2.5.0 aggiornamento progetti a 2.6.0

Scaricare ed estrarre la sorgente di Cordova 2.6.0 in un percorso di directory permanente sul disco rigido, per esempio a ~/Documents/Cordova-2.6.0.
Se è in esecuzione, chiudere Xcode.
Utilizzando Terminal. app, spostarsi nella directory dove avete messo la sorgente scaricata sopra.
Creare un nuovo progetto, come descritto nella guida strumento Shell di iOS. Avete bisogno di beni da questo nuovo progetto.
Copiare il file del progetto www/cordova-2.6.0.js nella directory www ed eliminare il file www/cordova-2.5.0.js.
Aggiornare il riferimento allo script di Cordova nel file www/index.html (insieme agli altri file che fanno riferimento a script) per riferirsi al nuovo file cordova-2.6.0.js.
Aggiornare (o sostituire, se non hai mai cambiato il file) il file AppDelegate.m secondo quello dal nuovo progetto (vedere questo diff).
Nel file config. xml, aggiungere questa nuova linea.
Nel file config. xml, aggiungere questa nuova linea.
Nel file config. xml, UIWebViewBounce è stato cambiato in DisallowOverscroll, e i valori predefiniti sono diversi.
Nel file config. xml, la preferenza di EnableLocation è stata deprecata.
Eliminare il CordovaLib directory e copia il CordovaLib dalla nuovo progetto directory nella directory radice del progetto.

Progetti di aggiornamento 2.4.0 per 2.5.0

Scaricare ed estrarre la sorgente di Cordova 2.5.0 a una posizione permanente directory sul disco rigido, per esempio a ~/Documents/Cordova-2.5.0.
Se è in esecuzione, chiudere Xcode.
Utilizzando Terminal. app, spostarsi nella directory dove avete messo la sorgente scaricata sopra.
Creare un nuovo progetto, come descritto nella guida strumento Shell di iOS. Avete bisogno di beni da questo nuovo progetto.
Copiare il file www/cordova-2.5.0.js dal nuovo progetto nella directory www ed eliminare il file www/cordova-2.4.0.js.
Aggiornare il riferimento allo script di Cordova nel file www/index.html (e qualsiasi altro file che contengono il riferimento allo script) che punti al nuovo file cordova-2.5.0.js.
Aggiornare (o sostituire, se non hai mai cambiato il file) il file AppDelegate.m secondo quello dal nuovo progetto (vedere questo diff).
Nel file config. xml, aggiungere queste righe nuove.
Nel file config. xml, modificare l'elemento radice, cambiarlo da cordova a widget.
Nel file config. xml, rimuovere la preferenza OpenAllWhitelistURLsInWebView.
Eliminare la directory di cordova e copiare la directory di cordova dal nuovo progetto nella directory radice del progetto. In 2.5.0, questo ha aggiornato gli script.
Eliminare il CordovaLib directory e copia il CordovaLib dalla nuovo progetto directory nella directory radice del progetto.

2.3.0 aggiornamento progetti alla 2.4.0

Scaricare ed estrarre la sorgente di Cordova 2.4.0 in un percorso di directory permanente sul disco rigido, per esempio a ~/Documents/Cordova-2.4.0.
Se è in esecuzione, chiudere Xcode.
Utilizzando Terminal. app, spostarsi nella directory dove avete messo la sorgente scaricata sopra.
Creare un nuovo progetto, come descritto nella guida strumento Shell di iOS. Avete bisogno di beni da questo nuovo progetto.
Copiare il file www/cordova-2.4.0.js dal nuovo progetto nella directory www ed eliminare il file www/cordova-2.3.0.js.
Aggiornare il riferimento allo script di Cordova nel file www/index.html (e qualsiasi altro file che contengono il riferimento allo script) che punti al nuovo file cordova-2.4.0.js.
Aggiornare (o sostituire, se non hai mai cambiato i file) il file MainViewController.m secondo quello dal nuovo progetto (vedere questo diff).
Aggiornare (o sostituire, se non hai mai cambiato il file) il file AppDelegate.m secondo quello dal nuovo progetto (vedere questo diff).
Nel file config. xml, aggiungere questa nuova linea.
Eliminare la directory di cordova e copiare la directory di cordova dal nuovo progetto nella directory radice del progetto. In 2.4.0, questo ha fissato gli script.
Eliminare il CordovaLib directory e copia il CordovaLib dalla nuovo progetto directory nella directory radice del progetto.
Aggiungi AssetsLibrary.framework come una risorsa al progetto. (Vedere la documentazione di Apple per le istruzioni su come farlo.).

Progetti di ammodernamento 2.2.0 a 2.3.0

Scaricare ed estrarre la sorgente di Cordova 2.3.0 in un percorso di directory permanente sul disco rigido, per esempio a ~/Documents/Cordova-2.3.0.
Se è in esecuzione, chiudere Xcode.
Utilizzando Terminal. app, spostarsi nella directory dove avete messo la sorgente scaricata sopra.
Creare un nuovo progetto, come descritto nella guida strumento Shell di iOS. Avete bisogno di beni da questo nuovo progetto.
Copiare il file www/cordova-2.3.0.js dal nuovo progetto nella directory www ed eliminare il file www/cordova-2.2.0.js.
Aggiornare il riferimento allo script di Cordova nel file www/index.html (e qualsiasi altro file che contengono il riferimento allo script) che punti al nuovo file cordova-2.3.0.js.
Aggiornare (o sostituire, se non hai mai cambiato il file) la MainViewController.m secondo quello del nuovo progetto.
Eliminare la directory di cordova e copiare la directory di cordova dal nuovo progetto nella directory radice del progetto. In 2.3.0, questo ha nuovi script.
Eliminare il CordovaLib directory e copia il CordovaLib dalla nuovo progetto directory nella directory radice del progetto.
Convertire il file Cordova.plist in config. xml, eseguendo lo script bin/cordova\_plist\_to\_config\_xml su file di progetto.
Aggiungere il plugin InAppBrowser per il file config. xml, aggiungendo questo tag sotto < cordova >< plugins >:
```
<plugin name="InAppBrowser" value="CDVInAppBrowser" />
```
Nota che i plugin di Objective-C sono non whitelisted piu '. Alla whitelist le connessioni con la whitelist app, è necessario impostare l'intestazione dell User-Agent della connessione per lo stesso user-agent come principale Cordova WebView. È possibile ottenere ciò accedendo alla proprietà userAgent spegne la vista-controllore principale. Il controller principale-vista (CDVViewController) ha anche un metodo URLisAllowed per verificare se un URL passa la whitelist.
Modifiche del dispositivo API:

*   Per iOS, il device utilizzato per restituire `iPhone`, `iPad` o `iPod Touch`; ora restituisce (correttamente) `iOS`.
*   Per iOS, device.name (ormai obsoleto per tutte le piattaforme) utilizzato per restituire il nome del dispositivo dell'utente (ad esempio ' iPhone 5 ′ su Shazron '); ora restituisce quale device utilizzato per restituire: `iPhone`, `iPad` o `iPod Touch`.
*   Per tutte le piattaforme, c'è una nuova proprietà denominata device.model; Questo metodo restituisce il modello di dispositivo specifico, ad esempio `iPad2, 5` (per altre piattaforme, questo restituisce ciò che device.name per restituire).

All'aggiornamento 2.1.0 proietta alla 2.2.0

Scaricare ed estrarre la sorgente di Cordova 2.2.0 per un percorso di directory permanente sul disco rigido, per esempio a ~/Documents/Cordova-2.2.0.
Se è in esecuzione, chiudere Xcode.
Utilizzando Terminal. app, spostarsi nella directory dove avete messo la sorgente scaricata sopra.
Creare un nuovo progetto, come descritto nella guida strumento Shell di iOS. Avete bisogno di beni da questo nuovo progetto.
Copiare il file www/cordova-2.2.0.js dal nuovo progetto nella directory www ed eliminare il file www/cordova-2.1.0.js.
Aggiornare il riferimento allo script di Cordova nel file www/index.html (e qualsiasi altro file che contengono il riferimento allo script) che punti al nuovo file cordova-2.2.0.js.
Aggiornare (o sostituire, se non hai mai cambiato il file) la MainViewController.m secondo quello dal nuovo progetto:

*   Aggiornato → viewWillAppear

Copiare la directory di cordova dal nuovo progetto nella directory radice del progetto. In 2.2.0, questo ha un aggiornato script 'emulare'.
Successivamente, aggiornare il riferimento al sotto-progetto CordovaLib. A partire da Cordova 2.1.0, non stiamo utilizzando la variabile CORDOVALIB Xcode piu ' quando fa riferimento a dove risiede il CordovaLib, il riferimento è un riferimento di file assoluto ora.
1. Lanciare Terminal. app
2. Vai al percorso dove avete installato Cordova (vedi punto 1), nella sottodirectory bin
3. Eseguire lo script sotto dove il primo parametro è il percorso per il file del progetto .xcodeproj:
  
  update_cordova_subproject path/to/your/project/xcodeproj

Nota: In 2.2.0, bin/creare script copia del progetto sub-CordovaLib nel vostro progetto. Per avere lo stesso tipo di installazione, basta copiare nella destra CordovaLib nella directory del progetto e aggiornare la posizione del sotto-progetto CordovaLib (relativo al progetto) in Ispettore File Xcode.

All'aggiornamento 2.0.0 proietta alla 2.1.0

Con Cordova 2.1.0, CordovaLib è stato aggiornato per utilizzare il Automatic Reference Counting (ARC). Si non serve aggiornare a ARC utilizzare CordovaLib, ma se volete aggiornare il vostro progetto per utilizzare ARC, utilizzare la migrazione guidata di Xcode dal menu: Modifica → Refactor → Convert to Objective-C ARC..., de-selezionare libCordova.a, quindi eseguire la procedura guidata fino al completamento.

Scaricare ed estrarre la sorgente di Cordova 2.1.0 a una posizione permanente directory sul disco rigido, per esempio a ~/Documents/Cordova-2.1.0.
Se è in esecuzione, chiudere Xcode.
Utilizzando Terminal. app, spostarsi nella directory dove avete messo la sorgente scaricata sopra.
Creare un nuovo progetto, come descritto nella guida strumento Shell di iOS. Avete bisogno di beni da questo nuovo progetto.
Copiare il file www/cordova-2.1.0.js dal nuovo progetto nella directory www ed eliminare il file www/cordova-2.0.0.js.
Aggiornare il riferimento allo script di Cordova nel file www/index.html (e qualsiasi altro file che contengono il riferimento allo script) che punti al nuovo file cordova-2.1.0.js.
Aggiornare (o sostituire, se non hai mai cambiato il file) la AppDelegate.m secondo quello dal nuovo progetto:

*   Edited → application:didFinishLaunchingWithOptions:
*   Added → application:supportedInterfaceOrientationsForWindow:

Aggiornare (o sostituire, se non hai mai cambiato il file) la MainViewController.m secondo quello dal nuovo progetto:

*   Added → viewWillAppear

Copiare la directory di cordova dal nuovo progetto nella directory radice del progetto. In 2.1.0, questo ha gli script aggiornati per supportare i percorsi con spazi.
Rimuovere il riferimento al file VERSION dal progetto (non quello in CordovaLib).
Successivamente, aggiornare il riferimento al sotto-progetto CordovaLib. A partire da Cordova 2.1.0, non stiamo utilizzando la variabile CORDOVALIB Xcode piu ' quando fa riferimento a dove risiede il CordovaLib, il riferimento è un riferimento di file assoluto ora.
1. Lanciare Terminal. app
2. Vai al percorso dove avete installato Cordova (vedi punto 1), nella sottodirectory bin
3. Eseguire lo script sotto dove il primo parametro è il percorso per il file del progetto .xcodeproj:
  
  update_cordova_subproject path/to/your/project/xcodeproj

All'aggiornamento 1.9.0 progetti a 2.0.0

Installare Cordova 2.0.0.
Creare un nuovo progetto, come descritto nella guida strumento Shell di iOS. Avete bisogno di beni da questo nuovo progetto.
Copiare il file www/cordova-2.0.0.js dal nuovo progetto nella directory www ed eliminare il file www/cordova-1.9.0.js.
Aggiornare il riferimento allo script di Cordova nel file www/index.html (e qualsiasi altro file che contengono il riferimento allo script) che punti al nuovo file cordova-2.0.0.js.
Copiare la directory di cordova dal nuovo progetto nella directory radice del progetto (se si desidera che gli strumenti della riga di comando di progetto).
Aggiungere una nuova voce sotto Plugins nel file Cordova.plist, sotto il gruppo di Supporting Files. La chiave è il device e il valore è CDVDevice.
Rimuovere Cordova.framework.
Rimuovere verify.sh dal gruppo di Supporting Files.
Selezionare l'icona del progetto nel Navigatore progetto, selezionare il Target del progetto, quindi selezionare la scheda Building Settings.
Ricerca per Preprocessor Macros, quindi rimuovere tutti i CORDOVA_FRAMEWORK=1 valori.
Individuare la directory CordovaLib che è stata installata nel disco rigido sotto sottodirectory documenti su cartella home.
Individuare il file CordovaLib.xcodeproj nella directory CordovaLib, quindi trascinare e rilasciare i file nel progetto. Dovrebbe apparire come un sotto-progetto.
Compilare il progetto, si dovrebbero ottenere alcuni errori relativi alle direttive #import.
Per gli errori di #import, modificare eventuali importazioni basata sulla citazione in questo stile:
```
#import "CDV.h"
```
a questo stile basato su staffe:
```
#import <Cordova/CDV.h>
```
e rimuovere eventuali #ifdef wrapper intorno a qualsiasi importazione di Cordova, non sono piu ' necessari (le importazioni sono ora unificate)
Compilare nuovamente il progetto, e non dovrebbe avere alcun errori #import.
Selezionare l' project icon nel Navigatore progetto, selezionare il Target del progetto, quindi selezionare la scheda Build Phases.
Espandere la fase Target Dependencies, quindi selezionare il + pulsante.
Selezionare il target di CordovaLib, quindi scegliere il pulsante Add.
Espandere la prima fase di Link Binary with Libraries (già dovrebbe contenere un mucchio di quadri), quindi selezionare il + pulsante.
Selezionare la libreria statica libCordova.a, quindi scegliere il pulsante Aggiungi.
Eliminare la fase di Run Script.
Selezionare l' project icon nel Navigatore progetto, selezionare il Target del progetto, quindi selezionare la scheda Build Settings.
Ricerca per Other Linker Flags e aggiungere i valori -force_load e -Obj-C.
Espandere il sub-progetto CordovaLib.
Individuare il file di VERSION, trascinarlo nel progetto principale (vogliamo creare un link ad esso, non una copia).
Selezionare il pulsante di opzione Create groups for any added folders, quindi scegliere il pulsante Finish.
Selezionare il file VERSION appena trascinata in un passaggio precedente.
Digitare la combinazione di tasti Option-Command-1 per visualizzare il File Inspector (o menuitem View → Utilities → Show file Inspector).
Scegliere relativa a CORDOVALIB nel File Inspector per il menu a discesa per Location.
Impostare la preferenza di Xcode Xcode Preferences → Locations → Derived Data → Advanced... a Unique, così che si possono trovare le intestazioni unificate.
Selezionare l' project icon nel Navigatore progetto, selezionare il Target del progetto, quindi selezionare la scheda Build Settings.

Ricerca di Header Search Paths. Per tale impostazione, aggiungere questi tre valori, incluse le virgolette:

"$(TARGET_BUILD_DIR)/usr/local/lib/include"

"$(OBJROOT)/UninstalledProducts/include"

"$(BUILT_PRODUCTS_DIR)"

Ricerca per Other Linker Flags. Per tale impostazione, aggiungere questo valore:
```
-weak_framework CoreFoundation
```
Compilare il progetto, deve compilare e collegare senza problemi.
Selezionare progetto Schema di elenco a discesa e quindi selezionare iPhone 5.1 Simulator.
Selezionare il pulsante Run.

Nota: se il progetto non funziona come previsto nel simulatore, si prega di prendere nota di eventuali errori nel registro di console in Xcode per indizi.

Aggiornamento di progetti 1.8.x a 1.9.0

Installare Cordova 1.9.0.
Creare un nuovo progetto. Alcuni dei beni da questo nuovo progetto sarà necessario.
Copiare il file www/cordova-1.9.0.js dal nuovo progetto nella directory www ed eliminare il file www/cordova-1.8.x.js.
Aggiornare il riferimento allo script di Cordova nel file www/index.html (e qualsiasi altro file che contengono il riferimento allo script) che punti al nuovo file cordova-1.9.0.js.

Nota: 1.9.0 supporta la nuova impostazione booleana BackupWebStorage Cordova.plist. Si è attivata per impostazione predefinita, quindi impostarlo su false per disattivarlo, soprattutto su iOS 6. Vedere Release Notes: Safari and UIKit Section

1.7.0 all'aggiornamento di progetti a 1.8.x

Installare Cordova 1.8.0.
Creare un nuovo progetto. Alcuni dei beni da questo nuovo progetto sarà necessario.
Copiare il file www/cordova-1.8.0.js dal nuovo progetto nella directory www ed eliminare il file www/cordova-1.7.x.js.
Aggiornare il riferimento allo script di Cordova nel file www/index.html (e qualsiasi altro file che contengono il riferimento allo script) che punti al nuovo file cordova-1.8.0.js.

Se si intende usare l'API di cattura, è necessario i nuovo iPad retina-display beni:

Copiare la voce Resources/Capture.bundle dal nuovo progetto nella directory del progetto, sovrascrivere il vostro elemento esistente Resources/Capture.bundle.
Nel progetto, selezionare la voce Capture.bundle nel vostro navigatore di progetto in Xcode, digitare il tasto Delete, quindi selezionare Remove Reference dalla finestra di dialogo.
Trascinare il nuovo Capture.bundle dal punto 1 sopra nel vostro navigatore di progetto in Xcode, quindi selezionare il pulsante di opzione Create groups for any added folders.

L'aggiornamento 1.6. x progetti a 1.7.0

Installare Cordova 1.7.0.
Creare un nuovo progetto. Alcuni dei beni da questo nuovo progetto sarà necessario.
Copiare il file www/cordova-1.7.0.js dal nuovo progetto nella directory www ed eliminare il file www/cordova-1.6.0.js.
Aggiornare il riferimento allo script di Cordova nel file www/index.html (e qualsiasi altro file che contengono il riferimento allo script) che punti al nuovo file cordova-1.7.0.js.

Progetti di aggiornamento 1.5.0 a 1.6. x

Installare Cordova 1.6.1.
Fare un backup di AppDelegate.m, AppDelegate.h, MainViewController.m, MainViewController.h e Cordova.plist nel vostro progetto.
Creare un nuovo progetto. Alcuni dei beni da questo nuovo progetto sarà necessario.
Copiare questi file dal nuovo progetto nella directory 1.5.0-based del progetto su disco, sostituendo qualsiasi vecchi file (backup i file prima dal passo 2 sopra):
```
AppDelegate.h
AppDelegate.m
MainViewController.h
MainViewController.m
Cordova.plist
```
Aggiungere tutti i nuovi file di MainViewController e AppDelegate nel vostro progetto in Xcode.
Copiare il file www/cordova-1.6.1.js dal nuovo progetto nella directory www ed eliminare il file www/cordova-1.5.0.js.
Aggiornare il riferimento allo script di Cordova nel file www/index.html (e qualsiasi altro file che contengono il riferimento allo script) che punti al nuovo file cordova-1.6.1.js.
Aggiungere il nuovo file Cordova.plist nel vostro progetto. Ciò è necessario perché i nomi di servizio core plugin devono cambiare per abbinare quelli da Android e BlackBerry, per un file unificato di Cordova JavaScript (cordova-js).
Integrare eventuali impostazioni, Plugins ed ExternalHosts le voci che hai avuto nel tuo backup Cordova.plist nella nuova Cordova.plist.
Integrare qualsiasi codice specifico del progetto che avete nel vostro backup, AppDelegate.h e AppDelegate.m in nuovi file di AppDelegate. Qualsiasi codice UIWebViewDelegate o CDVCommandDelegate in AppDelegate.m deve andare in MainViewController.m ora (vedi sezioni fuori-ha commentato quel file).
Integrare qualsiasi codice specifico del progetto che avete nel vostro backup, MainViewController.h e MainViewController.m in nuovi file di MainViewController.
Fare clic sull'icona progetto in Navigatore progetto, selezionare il Project, quindi selezionare la scheda Build Settings.
Inserisci Compiler for C/C++/Objective-C nel campo di ricerca.
Selezionare il valore di Apple LLVM Compiler 3.1.

Aggiornamento di progetti 1.4.x a 1.5.0

Installare Cordova 1.5.0.
Creare un nuovo progetto ed eseguito una volta. Alcuni dei beni da questo nuovo progetto sarà necessario.
Copiare il file www/cordova-1.5.0.js dal nuovo progetto nella directory www ed eliminare il file www/phonegap-1.4.x.js.
Aggiornare il riferimento allo script di Cordova nel file www/index.html (e qualsiasi altro file che contengono il riferimento allo script) per puntare al nuovo file cordova-1.5.0.js di Cordova.
Trovare PhoneGap.framework nel vostro navigatore di progetto, selezionarla.
Digitare il tasto Delete ed eliminare il riferimento PhoneGap.framework nel Navigatore progetto.
Digitare la combinazione di tasti Option-Comand-A, che dovrebbe cadere giù un foglio per aggiungere file al progetto (il foglio Aggiungi file...). Assicurarsi che sia selezionato il pulsante Created groups for any added folders.
Digitare la combinazione di tasti Shift-Command-G, che dovrebbe cadere giù un altro foglio per voi di andare in una cartella (il andare nella cartella: foglio).
Inserisci /Users/Shared/Cordova/Frameworks/Cordova.framework nel andare nella cartella: foglio e quindi premere il pulsante Goi.
Premere il pulsante Add nella finestra Add Files....
Selezionare Cordova.framework nel Navigatore progetto.
Digitare la combinazione di tasti Option-Command-1 per visualizzare il File Inspector.
Scegliere il Absolute Path nel File Inspector per il menu a discesa per Location.
Digitare la combinazione di tasti Option-Comand-A, che dovrebbe cadere giù un foglio per aggiungere file al progetto (il foglio Aggiungi file...). Assicurarsi che sia selezionato il pulsante Created groups for any added folders.
Digitare la combinazione di tasti Shift-Command-G, che dovrebbe cadere giù un altro foglio per voi di andare in una cartella (il andare nella cartella: foglio).
Inserisci ~/Documents/CordovaLib/Classes/deprecated nel andare nella cartella: foglio e quindi premere il pulsante Go.
Premere il pulsante Add nella finestra Add Files....
In AppDelegate.h, AppDelegate.m e MainViewController.h file, sostituire il blocco intero #ifdef PHONEGAP_FRAMEWORK con:
```
#import "CDVDeprecated.h"
```
Selezionare l' project icon nel Navigatore progetto, selezionare il Target del progetto, quindi selezionare la scheda Build Settings.
Ricerca di Framework Search Paths.
Sostituire il valore esistente con /Users/Shared/Cordova/Frameworks.
Ricerca per Preprocessor Macros.
Per il primo valore (combinato), sostituire il valore con CORDOVA_FRAMEWORK=YES.
Selezionare la scheda Build Phases.
Espandere Run Script.
Sostituire eventuali occorrenze di PhoneGap con Cordova.
Trovare il file PhoneGap.plist nel Navigatore progetto e fare clic sul nome del file una volta per entrare in modalità di modifica nome.
Rinominare PhoneGap.plist in Cordova.plist.
Tasto destro del mouse su Cordova.plist e scegliere Open As → Source Code.
Premi Option-Command-F, scegliere di Replace il menu a discesa in alto a sinistra della finestra di origine.
Immettere com.phonegap per trovare stringa e org.apache.cordova per la stringa di sostituzione, quindi premere il pulsante Replace All.
Immettere PG per trovare stringa e CDV per la stringa di sostituzione, quindi premere il pulsante Replace All.
Premere Command-B per costruire. Avete ancora deprecati che si possono sbarazzarsi di in futuro (vedere CDVDeprecated.h. Ad esempio, sostituire le classi nel codice che utilizzano PG* a CDV*).

Progetti di aggiornamento 1.4.0 per 1.4.1

Installare Cordova 1.4.1.
Fare un backup dei MainViewController.m.
Creare un nuovo progetto. Alcuni dei beni da questo nuovo progetto sarà necessario.
Copiare il file MainViewController.m dal nuovo progetto nella directory 1.4.0-based del progetto su disco, sostituendo il vecchio file (backup i file prima dal passo 2 sopra).
Aggiungere il file MainViewController.m nel vostro progetto in Xcode.
Integrare il codice specifico del progetto che hai nel tuo backup MainViewController.m nel nuovo file.
Aggiornamento del file di phonegap-1.4.0.js è facoltativo, non è cambiato nulla in JavaScript tra 1.4.0 e 1.4.1.

1.3.0 all'aggiornamento di progetti a 1.4.0

Installare Cordova 1.4.0.
Fare un backup di AppDelegate.m e AppDelegate.h nel vostro progetto.
Creare un nuovo progetto. Alcuni dei beni da questo nuovo progetto sarà necessario.
Copiare questi file dal nuovo progetto nella directory 1.3.0-based del progetto su disco, sostituendo qualsiasi vecchi file (backup i file prima dal passo 2 sopra):
```
AppDelegate.h
AppDelegate.m
MainViewController.h
MainViewController.m
MainViewController.xib
```
Aggiungere tutti i MainViewController i file nel progetto Xcode.
Copiare il file www/phonegap-1.4.0.js dal nuovo progetto nella directory www ed eliminare il file www/phonegap-1.3.0.js.
Aggiornare il riferimento allo script di Cordova nel file www/index.html (e qualsiasi altro file che contengono il riferimento allo script) che punti al nuovo file phonegap-1.4.0.js.
Aggiungere una nuova voce sotto Plugins nella PhoneGap.plist file. La chiave è com.phonegap.battery e il valore èPGBattery.
Integrare il codice specifico del progetto che hai nel tuo backup AppDelegate.h e AppDelegate.m in nuovi file di AppDelegate.

Progetti di aggiornamento 1.2.0 alla 1.3.0

Installare Cordova 1.3.0.
Fare un backup di AppDelegate.m e AppDelegate.h nel vostro progetto.
Creare un nuovo progetto. Alcuni dei beni da questo nuovo progetto sarà necessario.
Copiare questi file dal nuovo progetto nella directory 1.2.0-based del progetto su disco, sostituendo qualsiasi vecchi file (backup i file prima dal passo 2 sopra):
```
AppDelegate.h
AppDelegate.m
MainViewController.h
MainViewController.m
MainViewController.xib
```
Aggiungere tutti i MainViewController i file nel progetto Xcode.
Copiare il file www/phonegap-1.3.0.js dal nuovo progetto nella directory www ed eliminare il file www/phonegap-1.2.0.js.
Aggiornare il riferimento allo script di Cordova nel file www/index.html (e qualsiasi altro file che contengono il riferimento allo script) che punti al nuovo file phonegap-1.3.0.js.
Aggiungere una nuova voce sotto Plugins nella PhoneGap.plist file. La chiave è com.phonegap.battery e il valore èPGBattery.
Integrare il codice specifico del progetto che hai nel tuo backup AppDelegate.h e AppDelegate.m in nuovi file di AppDelegate.

L'aggiornamento 1.1.0 progetti per 1.2.0

Installare Cordova 1.2.0.
Fare un backup di AppDelegate.m e AppDelegate.h nel vostro progetto.
Creare un nuovo progetto. Alcuni dei beni da questo nuovo progetto sarà necessario.
Copiare questi file dal nuovo progetto nella directory 1.1.0-based del progetto su disco, sostituendo qualsiasi vecchi file (backup i file prima dal passo 2 sopra):
```
AppDelegate.h
AppDelegate.m
MainViewController.h
MainViewController.m
MainViewController.xib
```
Aggiungere tutti i MainViewController i file nel progetto Xcode.
Copiare il file www/phonegap-1.2.0.js dal nuovo progetto nella directory www ed eliminare il file www/phonegap-1.1.0.js.
Aggiornare il riferimento allo script di Cordova nel file www/index.html (e qualsiasi altro file che contengono il riferimento allo script) che punti al nuovo file phonegap-1.2.0.js.
Aggiungere una nuova voce sotto Plugins nella PhoneGap.plist file. La chiave è com.phonegap.battery e il valore èPGBattery.
Integrare il codice specifico del progetto che hai nel tuo backup AppDelegate.h e AppDelegate.m in nuovi file di AppDelegate.

All'aggiornamento 1.0.0 proietta alla 1.1.0

Installare Cordova 1.1.0.
Fare un backup di AppDelegate.m e AppDelegate.h nel vostro progetto.
Creare un nuovo progetto. Alcuni dei beni da questo nuovo progetto sarà necessario.
Copiare questi file dal nuovo progetto nella directory 1.0.0-based del progetto su disco, sostituendo qualsiasi vecchi file (backup i file prima dal passo 2 sopra):
```
AppDelegate.h
AppDelegate.m
MainViewController.h
MainViewController.m
MainViewController.xib
```
Aggiungere tutti i MainViewController i file nel progetto Xcode.
Copiare il file www/phonegap-1.1.0.js dal nuovo progetto nella directory www ed eliminare il file www/phonegap-1.0.0.js.
Aggiornare il riferimento allo script di Cordova nel file www/index.html (e qualsiasi altro file che contengono il riferimento allo script) che punti al nuovo file phonegap-1.1.0.js.
Aggiungere una nuova voce sotto Plugins nella PhoneGap.plist file. La chiave è com.phonegap.battery e il valore èPGBattery.
Integrare il codice specifico del progetto che hai nel tuo backup AppDelegate.h e AppDelegate.m in nuovi file di AppDelegate.

All'aggiornamento 0.9.6 progetti per 1.0.0

Installare Cordova 1.0.0.
Fare un backup di AppDelegate.m e AppDelegate.h nel vostro progetto.
Creare un nuovo progetto. Alcuni dei beni da questo nuovo progetto sarà necessario.
Copiare questi file dal nuovo progetto nella directory 0.9.6-based del progetto su disco, sostituendo qualsiasi vecchi file (backup i file prima dal passo 2 sopra):
```
AppDelegate.h
AppDelegate.m
MainViewController.h
MainViewController.m
MainViewController.xib
```
Aggiungere tutti i MainViewController i file nel progetto Xcode.
Copiare il file www/phonegap-1.0.0.js dal nuovo progetto nella directory www ed eliminare il file www/phonegap-0.9.6.js.
Aggiornare il riferimento allo script di Cordova nel file www/index.html (e qualsiasi altro file che contengono il riferimento allo script) che punti al nuovo file phonegap-1.0.0.js.
Aggiungere una nuova voce sotto Plugins nella PhoneGap.plist file. La chiave è com.phonegap.battery e il valore èPGBattery.
Integrare il codice specifico del progetto che hai nel tuo backup AppDelegate.h e AppDelegate.m in nuovi file di AppDelegate.