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 4.6 è obbligatorio, è consigliabile 5 Xcode. Attualmente, per presentare all'Apple App Store, è necessario utilizzare più recente versione di iOS SDK, che è iOS 7. iOS SDK 7 non è necessario ancora, ma questo può cambiare rapidamente.

All'aggiornamento 3.1.0 proietta alla 3.2.0

Per i progetti non-CLI, eseguire:

    bin/aggiornamento percorso/per/progetto

Per i progetti di CLI:

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

Progetti di aggiornamento 3.0.0 alla 3.1.0

Per i progetti non-CLI, eseguire:

    bin/aggiornamento percorso/per/progetto

Per i progetti di CLI:

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

iOS 7 edizioni:

Rimuovere width=device-width, height=device-height dalla index.html di file viewport meta tag. (Vedere il bug rilevanti.)
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 compilatore per C / C + + / Objective-C impostando, nella scheda Impostazioni di costruire , Costruire opzioni sezione. Scegliere di Default il compilatore (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 per 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 attività nativo dal progetto originale ( Resources , ecc), rendendo sicuri di aggiungere nuovi file per il .xcodeproj progetto. Il progetto iOS costruisce dentro il platforms\ios directory.
Copia il config.xml nel www directory 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, ad esempio~/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 in iOS gli strumenti della riga di comando. 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 in tuo www directory e delete tua www/cordova.js file.
Aggiornare il riferimento allo script di Cordova nel tuo 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, e devi usare il plugman l'utilità della riga di 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, ad esempio~/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 in iOS gli strumenti della riga di comando. 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 in tuo www directory e delete tua www/cordova.js file.
Aggiornare il riferimento allo script di Cordova nel tuo 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, ad esempio~/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 in iOS gli strumenti della riga di comando. 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 in tuo www directory e delete tua www/cordova-2.7.0.js file.
Aggiornare il riferimento allo script di Cordova nel tuo www/index.html file (e qualsiasi altro file che contengono il riferimento allo script) per puntare al nuovo cordova.js file.

Aggiornare qualsiasi <plugin> nel tag il config.xml del file di <feature> tag. Nota esistenti <plugin> tag ancora lavorare, ma sono deprecati. È possibile copiare queste informazioni nel config.xml file per un nuovo progetto. Ad 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 Costruire impostazioni. Sotto Collegamento → altre bandiere del Linker, modificare "- Obj - C" per essere "-ObjC".
Aggiornare la destinazione del progetto Costruire impostazioni. Sotto Collegamento → altre bandiere del Linker, cambiare "-all_load" di 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, ad esempio~/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 in iOS gli strumenti della riga di comando. avete bisogno di beni da questo nuovo progetto.
Copia il www/cordova-2.7.0.js file dal nuovo progetto in tuo www directory ed elimina il www/cordova-2.6.0.js file.
Aggiornare il riferimento allo script di Cordova nel tuo 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) tua AppDelegate.m file secondo quello dal nuovo progetto (vedere questo diff).
Nel tuo config.xml file, 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, ad esempio~/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 in iOS gli strumenti della riga di comando. Avete bisogno di beni da questo nuovo progetto.
Copia del progetto www/cordova-2.6.0.js file in tuo www directory ed elimina il www/cordova-2.5.0.js file.
Aggiornare il riferimento allo script di Cordova nel tuo www/index.html file (insieme agli altri file che fanno riferimento a script) per riferirsi al nuovo cordova-2.6.0.js file.
Aggiornare (o sostituire, se non hai mai cambiato il file) tua AppDelegate.m file secondo quello dal nuovo progetto (vedere questo diff).
Nel vostro config.xml del file, aggiungere questa nuova linea.
Nel vostro config.xml del file, aggiungere questa nuova linea.
Nel tuo config.xml file, UIWebViewBounce è stato cambiato in DisallowOverscroll, e i valori predefiniti sono diversi.
Nel tuo config.xml file, il EnableLocation preferenza è stato deprecato.
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, ad esempio~/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 in iOS gli strumenti della riga di comando. Avete bisogno di beni da questo nuovo progetto.
Copia il www/cordova-2.5.0.js file dal nuovo progetto in tuo www directory e cancella il www/cordova-2.4.0.js file.
Aggiornare il riferimento allo script di Cordova nel tuo www/index.html file (e qualsiasi altro file che contengono il riferimento allo script) per puntare al nuovo cordova-2.5.0.js file.
Aggiornare (o sostituire, se non hai mai cambiato il file) tua AppDelegate.m file secondo quello dal nuovo progetto (vedere questo diff).
Nel vostro config.xml del file, aggiungere queste righe nuove.
Nel tuo config.xml file, modificare l'elemento radice, cambiarlo da cordova a widget.
Nel tuo config.xml file, rimuovere la preferenza OpenAllWhitelistURLsInWebView.
Eliminare il cordova directory e copia il cordova dalla nuovo progetto directory 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, ad esempio~/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 in iOS gli strumenti della riga di comando. Avete bisogno di beni da questo nuovo progetto.
Copia il www/cordova-2.4.0.js file dal nuovo progetto in tuo www directory ed elimina il www/cordova-2.3.0.js file.
Aggiornare il riferimento allo script di Cordova nel tuo www/index.html file (e qualsiasi altro file che contengono il riferimento allo script) per puntare al nuovo cordova-2.4.0.js file.
Aggiornare (o sostituire, se non hai mai cambiato i file) tua MainViewController.m file secondo quello dal nuovo progetto (vedere questo diff).
Aggiornare (o sostituire, se non hai mai cambiato il file) tua AppDelegate.m file secondo quello dal nuovo progetto (vedere questo diff).
Nel vostro config.xml del file, aggiungere questa nuova linea.
Eliminare il cordova directory e copia il cordova dalla nuovo progetto directory 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, ad esempio~/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 in iOS gli strumenti della riga di comando. Avete bisogno di beni da questo nuovo progetto.
Copia il www/cordova-2.3.0.js file dal nuovo progetto in tuo www directory ed elimina il www/cordova-2.2.0.js file.
Aggiornare il riferimento allo script di Cordova nel tuo www/index.html file (e qualsiasi altro file che contengono il riferimento allo script) per puntare al nuovo cordova-2.3.0.js file.
Aggiornare (o sostituire, se non hai mai cambiato il file) tua MainViewController.m secondo quello del nuovo progetto.
Eliminare il cordova directory e copia il cordova dalla nuovo progetto directory 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 Cordova.plist del file di config.xml , eseguendo lo script bin/cordova\_plist\_to\_config\_xml su file di progetto.
Aggiungere il plugin InAppBrowser per tuo config.xml , aggiungendo questo tag sotto <cordova><plugins> :
```
< nome plugin = "InAppBrowser" value = "CDVInAppBrowser" / >
```
Nota che i plugin di Objective-C sono non whitelisted piu '. Alla whitelist le connessioni con la whitelist app, è necessario impostare il User-Agent intestazione del collegamento alla stesso user-agent come principale Cordova WebView. È possibile ottenere ciò accedendo la userAgent Proprietà fuori il view controller principale. Il Vista-Regolatore principale ( CDVViewController ) ha anche un URLisAllowed metodo 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, ad esempio~/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 in iOS gli strumenti della riga di comando. Avete bisogno di beni da questo nuovo progetto.
Copia il www/cordova-2.2.0.js file dal nuovo progetto in tuo www directory ed elimina il www/cordova-2.1.0.js file.
Aggiornare il riferimento allo script di Cordova nel tuo www/index.html file (e qualsiasi altro file che contengono il riferimento allo script) per puntare al nuovo cordova-2.2.0.js file.
Aggiornare (o sostituire, se non hai mai cambiato il file) tua MainViewController.m secondo quello dal nuovo progetto:

*   Aggiornato → viewWillAppear

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

Nota: In 2.2.0, il bin/create lo script copia nella CordovaLib Sub-progetto nel progetto. Per avere lo stesso tipo di installazione, basta copiare il diritto CordovaLib nella directory del progetto e aggiornamento il CordovaLib sottoprogetto percorso (relativo al progetto) in Xcode File ispettore.

All'aggiornamento 2.0.0 proietta alla 2.1.0

Con Cordova 2.1.0, CordovaLib è stato aggiornato per utilizzare il Conteggio di riferimento automatico (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 → refactoring → Converti in Objective-C ARC..., de-selezionare libCordova.a, quindi esegue la procedura guidata fino al completamento.

Scaricare ed estrarre la sorgente di Cordova 2.1.0 a una posizione permanente directory sul disco rigido, ad esempio~/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 in iOS gli strumenti della riga di comando. Avete bisogno di beni da questo nuovo progetto.
Copia il www/cordova-2.1.0.js file dal nuovo progetto in tuo www directory ed elimina il www/cordova-2.0.0.js file.
Aggiornare il riferimento allo script di Cordova nel tuo www/index.html file (e qualsiasi altro file che contengono il riferimento allo script) per puntare al nuovo cordova-2.1.0.js file.
Aggiornare (o sostituire, se non hai mai cambiato il file) tua AppDelegate.m secondo quello dal nuovo progetto:

*   Modificato → applicazione: didFinishLaunchingWithOptions:
*   Aggiunto → applicazione: supportedInterfaceOrientationsForWindow:

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

*   Aggiunto → viewWillAppear

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

All'aggiornamento 1.9.0 progetti a 2.0.0

Installare Cordova 2.0.0.
Creare un nuovo progetto, come descritto in iOS gli strumenti della riga di comando. Avete bisogno di beni da questo nuovo progetto.
Copia il www/cordova-2.0.0.js file dal nuovo progetto in tuo www directory ed elimina il www/cordova-1.9.0.js file.
Aggiornare il riferimento allo script di Cordova nel tuo www/index.html file (e qualsiasi altro file che contengono il riferimento allo script) per puntare al nuovo cordova-2.0.0.js file.
Copia il cordova dalla nuovo progetto directory nella directory di root del vostro progetto (se si desidera che gli strumenti della riga di comando di progetto).
Aggiungere una nuova voce sotto Plugins nel tuo Cordova.plist file, sotto il gruppo di File di supporto . La chiave è Device e il valore èCDVDevice.
RimuovereCordova.framework.
Rimuovere verify.sh dal gruppo di File di supporto .
Selezionare l'icona del progetto nel Navigatore progetto, selezionare il Targetdel progetto, quindi selezionare la scheda Impostazioni di compilazione .
Ricerca per Macro del preprocessore, quindi rimuovere tutti i CORDOVA_FRAMEWORK = 1 valori.
Individuare il CordovaLib directory in cui è stato installato nel disco rigido sotto della cartella Documents sottodirectory.
Individuare il CordovaLib.xcodeproj del file nella CordovaLib directory, quindi trascinare e rilasciare i file nel progetto. Dovrebbe apparire come un sotto-progetto.
Compilare il progetto, si dovrebbero ottenere alcuni errori relativi alla #import direttive.
Per la #import Errori, cambiare eventuali importazioni basata sulla citazione in questo stile:
```
#import "CDV.h"
```
a questo stile basato su staffe:
```
#import <Cordova/CDV.h>
```
e rimuovere qualsiasi #ifdef wrapper intorno a qualsiasi Cordova importazioni, non sono piu ' necessari (le importazioni sono ora unificate)
Compilare il progetto, ancora una volta, e non dovrebbe avere alcuna #import Errori.
Selezionare l' icona del progetto nel Navigatore progetto, selezionare il Targetdel progetto, quindi selezionare la scheda Fasi costruire .
Espandere la fase Target dipendenze , quindi selezionare il + pulsante.
Selezionare il CordovaLib di destinazione, quindi scegliere il pulsante Aggiungi .
Espandere la prima fase di Collegamento binario con librerie (già dovrebbe contenere un mucchio di quadri), quindi selezionare il + pulsante.
Selezionare il libCordova.a libreria statica, quindi selezionare il pulsante Aggiungi .
Eliminare la fase di Esecuzione di Script .
Selezionare l' icona del progetto nel Navigatore progetto, selezionare il Targetdel progetto, quindi selezionare la scheda Impostazioni di compilazione .
Ricerca per Altre bandiere di Linkere aggiungere i valori -force_load e - Obj-C.
Espandere il CordovaLib sotto-progetto.
Individuare il VERSION file, trascinarlo nel progetto principale (vogliamo creare un link ad esso, non una copia).
Selezionare il pulsante di opzione crea gruppi per eventuali cartelle aggiunte , quindi scegliere il pulsante fine .
Selezionare il VERSION file appena trascinata in un passaggio precedente.
Digitare la combinazione di tasti opzione-comando-1 per visualizzare il File Inspector (o menuitem Mostra Utilities → → Visualizza File ispettore).
Scegliere relativa a CORDOVALIB nel File ispettore per il menu a discesa per posizione.
Impostare la preferenza di Xcode Xcode preferenze → posizioni → dati derivati → avanzate... a Unique, così che si possono trovare le intestazioni unificate.
Selezionare l' icona del progetto nel Navigatore progetto, selezionare la destinazione, quindi scegliere la scheda Impostazioni di compilazione .
Ricerca di percorsi di ricerca di intestazione. 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 altre bandiere del Linker. 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 simulatore.
Selezionare il pulsante Esegui .

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.
Copia il www/cordova-1.9.0.js file dal nuovo progetto in tuo www directory ed elimina il www/cordova-1.8.x.js file.
Aggiornare il riferimento allo script di Cordova nel tuo www/index.html file (e qualsiasi altro file che contengono il riferimento allo script) per puntare al nuovo cordova-1.9.0.js file.

Nota: 1.9.0 supporta il nuovo BackupWebStorage booleano Cordova.plist impostazione. Si è attivata per impostazione predefinita, quindi impostarlo su false per disabilitarlo, soprattutto su iOS 6. Vedere Note di rilascio: Safari e UIKit sezione

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.
Copia il www/cordova-1.8.0.js file dal nuovo progetto in tuo www directory ed elimina il www/cordova-1.7.x.js file.
Aggiornare il riferimento allo script di Cordova nel tuo www/index.html file (e qualsiasi altro file che contengono il riferimento allo script) per puntare al nuovo cordova-1.8.0.js file.

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

Copia il Resources/Capture.bundle elemento dal nuovo progetto nella directory del progetto, un eccesso di scrittura esistente Resources/Capture.bundle elemento.
Nel progetto, selezionare il Capture.bundle elemento nel vostro navigatore di progetto in Xcode, digitare il tasto Elimina , quindi selezionare il Riferimento rimuovere 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 crea gruppi per eventuali cartelle aggiunte .

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.
Copia il www/cordova-1.7.0.js file dal nuovo progetto in tuo www directory ed elimina il www/cordova-1.6.0.js file.
Aggiornare il riferimento allo script di Cordova nel tuo www/index.html file (e qualsiasi altro file che contengono il riferimento allo script) per puntare al nuovo cordova-1.7.0.js file.

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 MainViewController e AppDelegate i file nel progetto Xcode.
Copia il www/cordova-1.6.1.js file dal nuovo progetto in tuo www directory ed elimina il www/cordova-1.5.0.js file.
Aggiornare il riferimento allo script di Cordova nel tuo www/index.html file (e qualsiasi altro file che contengono il riferimento allo script) per puntare al nuovo cordova-1.6.1.js file.
Aggiungere il nuovo Cordova.plist file nel progetto. Ciò è necessario perché i nomi di servizio core plugin devono cambiare per abbinare quelli da Android e BlackBerry, per un unificato (file di Cordova JavaScriptcordova-js).
Integrare eventuali impostazioni, Plugins ed ExternalHosts le voci che hai avuto nel tuo backup Cordova.plist nel nuovoCordova.plist.
Integrare il codice specifico del progetto che hai nel tuo backup AppDelegate.h e AppDelegate.m nella nuova AppDelegate file. Qualsiasi UIWebViewDelegate o CDVCommandDelegate codice AppDelegate.m deve andare in MainViewController.m ora (vedi sezioni fuori-ha commentato quel file).
Integrare il codice specifico del progetto che hai nel tuo backup MainViewController.h e MainViewController.m in nuovi file di MainViewController.
Fare clic sull'icona progetto in Navigatore progetto, selezionare il progetto, quindi selezionare la scheda Impostazioni di compilazione .
Inserisci compilatore per 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.
Copia il www/cordova-1.5.0.js file dal nuovo progetto in tuo www directory ed elimina il www/phonegap-1.4.x.js file.
Aggiornare il riferimento allo script di Cordova nel tuo www/index.html file (e qualsiasi altro file che contengono il riferimento allo script) per scegliere il nuovo Cordova cordova-1.5.0.js file.
Trovare PhoneGap.framework nel vostro navigatore di progetto, selezionarla.
Digitare il tasto cancellare ed eliminare il PhoneGap.framework riferimento nel Navigatore progetto.
Digitare la combinazione di tasti Comando-opzione-A , che dovrebbe cadere giù un foglio per aggiungere file al progetto (il foglio Aggiungi file... ). Assicurarsi che sia selezionato il pulsante creato gruppi per eventuali cartelle aggiunte .
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 nella andare nella cartella: foglio e quindi premere il pulsante Vai .
Premere il pulsante Aggiungi nella finestra Aggiungi file... .
Selezionare Cordova.framework nel Navigatore progetto.
Digitare la combinazione di tasti opzione-comando-1 per visualizzare il File Inspector.
Scegliere il Percorso assoluto nel File ispettore per il menu a discesa per posizione.
Digitare la combinazione di tasti Comando-opzione-A , che dovrebbe cadere giù un foglio per aggiungere file al progetto (il foglio Aggiungi file... ). Assicurarsi che sia selezionato il pulsante creato gruppi per eventuali cartelle aggiunte .
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 nella andare nella cartella: foglio e quindi premere il pulsante Vai .
Premere il pulsante Aggiungi nella finestra Aggiungi file... .
Nel vostro AppDelegate.h , AppDelegate.m , e MainViewController.h i file, sostituire l'intero #ifdef PHONEGAP_FRAMEWORK bloccare con:
```
#import "CDVDeprecated.h"
```
Fare clic sull' icona progetto in Navigatore progetto, selezionare la destinazione, quindi selezionare la scheda Impostazioni di compilazione .
Ricerca di percorsi di ricerca Framework.
Sostituire il valore esistente con/Users/Shared/Cordova/Frameworks.
Ricerca per macro del preprocessore.
Per il primo valore (combinato), sostituire il valore con CORDOVA_FRAMEWORK = YES.
Selezionare la scheda Fasi costruire .
Espandere Eseguire Script.
Sostituire eventuali occorrenze di PhoneGap con Cordova.
Trovare il PhoneGap.plist del file nel Navigatore progetto e fare clic sul nome del file una volta per entrare in modalità di modifica nome.
Rinominare PhoneGap.plist aCordova.plist.
Tasto destro del mouse su Cordova.plist e scegliere come → codice Open Source.
Premi Comando-opzione-F, scegliere di sostituire il menu a discesa in alto a sinistra della finestra di origine.
Digitare com.phonegap per trovare la stringa, e org.apache.cordova per la stringa di sostituzione, quindi premere il pulsante Sostituisci tutto .
Immettere PG per trovare stringa e CDV per la stringa di sostituzione, quindi premere il pulsante Sostituisci tutto .
Premere Comando-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 diMainViewController.m.
Creare un nuovo progetto. Alcuni dei beni da questo nuovo progetto sarà necessario.
Copia il MainViewController.m file 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 MainViewController.m file nel progetto Xcode.
Integrare il codice specifico del progetto che hai nel tuo backup MainViewController.m nel nuovo file.
Aggiornamento del phonegap-1.4.0.js file è opzionale, nulla è cambiato 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.
Copia il www/phonegap-1.4.0.js file dal nuovo progetto in tuo www directory ed elimina il www/phonegap-1.3.0.js file.
Aggiornare il riferimento allo script di Cordova nel tuo www/index.html file (e qualsiasi altro file che contengono il riferimento allo script) per puntare al nuovo phonegap-1.4.0.js file.
Aggiungere una nuova voce sotto Plugins nel tuo 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.
Copia il www/phonegap-1.3.0.js file dal nuovo progetto in tuo www directory ed elimina il www/phonegap-1.2.0.js file.
Aggiornare il riferimento allo script di Cordova nel tuo www/index.html file (e qualsiasi altro file che contengono il riferimento allo script) per puntare al nuovo phonegap-1.3.0.js file.
Aggiungere una nuova voce sotto Plugins nel tuo 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.
Copia il www/phonegap-1.2.0.js file dal nuovo progetto in tuo www directory ed elimina il www/phonegap-1.1.0.js file.
Aggiornare il riferimento allo script di Cordova nel tuo www/index.html file (e qualsiasi altro file che contengono il riferimento allo script) per puntare al nuovo phonegap-1.2.0.js file.
Aggiungere una nuova voce sotto Plugins nel tuo 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.
Copia il www/phonegap-1.1.0.js file dal nuovo progetto in tuo www directory ed elimina il www/phonegap-1.0.0.js file.
Aggiornare il riferimento allo script di Cordova nel tuo www/index.html file (e qualsiasi altro file che contengono il riferimento allo script) per puntare al nuovo phonegap-1.1.0.js file.
Aggiungere una nuova voce sotto Plugins nel tuo 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.
Copia il www/phonegap-1.0.0.js file dal nuovo progetto in tuo www directory ed elimina il www/phonegap-0.9.6.js file.
Aggiornare il riferimento allo script di Cordova nel tuo www/index.html file (e qualsiasi altro file che contengono il riferimento allo script) per puntare al nuovo phonegap-1.0.0.js file.
Aggiungere una nuova voce sotto Plugins nel tuo 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.