Aktualisierung von Android
Diese Anleitung zeigt, wie Android Projekte Upgrade von älteren Versionen von Cordova ändern. Die meisten diese Anweisungen gelten für Projekte, die mit einer älteren Befehlszeilentools, die vorangehen erstellt die cordova
CLI-Hilfsprogramm. Informationen finden Sie unter The Command-Line Interface die CLI-Version zu aktualisieren.
Upgrade auf 4.0.0
Gibt es bestimmte Schritte benötigt, um wichtige Änderungen in 4.0.0 nutzen. Zunächst werden die gemeinsamen Schritte wie unten beschrieben.
Für nicht-CLI-Projekte führen:
bin/update path/to/project
CLI-Projekte:
Update der
cordova
CLI-Version. Finden Sie die Befehlszeilenschnittstelle.cordova platform update android
in Ihre bestehenden Projekte ausgeführt.
Aktualisierung der weißen Liste
Alle Whitelist-Funktionalität ist jetzt via Plugin implementiert. Ohne Plugin ist Ihre Anwendung nicht mehr durch eine Whitelist geschützt, nach dem Upgrade auf 4.0.0. Cordova hat zwei Whitelist-Plugins, die verschiedene Ebenen des Schutzes zur Verfügung zu stellen.
-
Cordova-Plugin-Whitelist
Plugin (empfohlen)
* Dieses Plugin wird dringend empfohlen, da es sicherer und konfigurierbar als die Whitelist in früheren Versionen ist,
* Siehe [Cordova-Plugin-Whitelist][1] für Details auf die Konfigurationsänderungen erforderlich
* Ausführung: `cordova plugin add cordova-plugin-crosswalk-webview`
-
Cordova-Plugin-Legacy-Whitelist
plugin
* Dieses Plugin bietet das Whitelist-Verhalten wie in früheren Versionen. Siehe [Cordova-Plugin-Legacy-whitelist][2]
* Keine Konfigurationsänderungen sind erforderlich, aber es bietet weniger Schutz als die empfohlenen plugin
* Ausführung: `cordova plugin add cordova-plugin-legacy-whitelist`
Mithilfe der Zebrastreifen WebView
Standardmäßig wird Ihre Anwendung weiterhin das System verwenden WebView vom Gerät zur Verfügung gestellt. Wenn Sie den Zebrastreifen WebView stattdessen verwenden möchten, fügen Sie einfach das Zebrastreifen-Plugin:
cordova plugin add cordova-plugin-crosswalk-webview
Das Plugin hinzufügen, erhalten Ihre app den Zebrastreifen WebView ordnungsgemäß installiert und konfiguriert.
Upgrade auf das Splashscreen-Plugin
Wenn Ihre app macht Verwendung von einen Splash-Screen Funktionalität zu einem Plugin verschoben wurde. Die Konfigurationsoptionen für Begrüßungsbildschirme sind unverändert. Der einzige Upgrade Schritt benötigt, ist das Plugin hinzufügen:
cordova plugin add cordova-plugin-splashscreen
Upgrade von 3.6.0 auf 3.7.1
Für nicht-CLI-Projekte führen:
bin/update path/to/project
CLI-Projekte:
Update der
cordova
CLI-Version. Finden Sie die Befehlszeilenschnittstelle.Führen Sie
cordova platform update android
in Ihre bestehenden Projekte.
Upgrade von 3.2.0 auf 3.3.0
Folgen Sie die Anweisungen wie für 3.2.0
.
Beginnend mit 3.3.0, wird Cordova-Runtime jetzt als Android-Bibliothek anstelle von einem Glas kompiliert. Dies sollte keine Auswirkungen für Command-Line Usage, aber IDE-Benutzer müssen das neu hinzugefügte MyProject-CordovaLib
-Projekt in ihren Arbeitsbereich zu importieren.
Upgrade von 3.1.0 auf 3.2.0
Für Projekte, die mit Cordova CLI erstellt wurden:
Update der
cordova
CLI-Version. Finden Sie die Befehlszeilenschnittstelle.cordova plattform update android
ausführen
Für Projekte, die nicht mit der Cordova CLI erstellt ausgeführt:
bin/update <project_path>
WARNUNG: Auf Android 4.4 - Android 4.4.3, Erstellen einer Datei input-Element mit type="file" wird nicht im Dialog Datei Picker. Dies ist eine Regression mit Chrom auf Android und das Problem reproduzierbar in der Standalone-Chrome-Browser auf Android (siehe http://code.google.com/p/android/issues/detail?id=62220) die empfohlene Problemumgehung besteht darin die FileTransfer und Datei-Plugins für Android 4.4 verwenden. Sie können für ein OnClick-Ereignis aus der Eingabetyp type="file" und dann pop-up eine Dateiauswahl UI. Um die Formulardaten mit dem Upload zu binden, können Sie JavaScript Formularwerte FileTransfer macht die mehrteilige POST-Anforderung an.
Upgrade von 3.0.0 auf 3.1.0
Für Projekte, die mit Cordova CLI erstellt wurden:
Update der
cordova
CLI-Version. Finden Sie die Befehlszeilenschnittstelle.cordova plattform update android
ausführen
Für Projekte, die nicht mit der Cordova CLI erstellt ausgeführt:
bin/update <project_path>
Upgrade auf die CLI (3.0.0) aus 2.9.0
Erstellen Sie ein neues Apache Cordova 3.0.0-Projekt mit Cordova CLI, wie in der Command-Line Interface beschrieben.
Fügen Sie Ihrer Plattformen Projektes Cordova, zum Beispiel:
cordova platform add android
.Kopieren Sie den Inhalt der
Www
-Verzeichnis des Projekts in dasWww
-Verzeichnis im Stammverzeichnis des Projektes Cordova soeben erstellten.Nativen Vermögen aus dem alten Projekt kopieren, in die entsprechenden Verzeichnisse unter
platforms/android
: in diesem Verzeichnis werden in dem systemeigene Cordova-Android Projekt vorhanden ist.Verwenden Sie das Cordova CLI Tool irgendwelche Plugins installieren, die Sie brauchen. Beachten Sie, dass die CLI behandelt alle Kern-APIs wie Plugins, so müssen sie möglicherweise hinzugefügt werden. Nur 3.0.0 Plugins sind kompatibel mit CLI.
Ein Upgrade auf 3.0.0 von 2.9.0
Erstellen Sie ein neues Apache Cordova Android Projekt.
Kopieren Sie den Inhalt des Verzeichnisses
www
zum neuen Projekt.Kopieren Sie nativen Android Vermögen aus dem
res
-Verzeichnis zum neuen Projekt.Kopieren Sie über alle Plugins, die Sie aus der
src
-Unterverzeichnissen in das neue Projekt installiert.Achten Sie darauf, alle aktualisieren veraltet
<plugin>
Verweise aus der alten Datei"config.xml"
auf der neuen<feature>
Spezifikation.Alle Verweise auf das
org.apache.cordova.api
-Paketorg.apache.cordova
zu aktualisieren.Hinweis: alle Core APIs wurden entfernt und als Plugins installiert sein. Einzelheiten finden Sie unter der Verwendung von Plugman zum Verwalten von Plugins-Anleitung.
Ein Upgrade auf 2.9.0 von 2.8.0
- Run
bin/update <project_path>
.
Ein Upgrade auf 2.8.0 von 2.7.0
Entfernen Sie
Cordova-2.7.0.jar
aus dem ProjektverzeichnisLibs
.Cordova-2.8.0.jar
des ProjektsLibs
Verzeichnis hinzufügen.Wenn Sie Eclipse verwenden, aktualisieren das Eclipse-Projekt und eine saubere zu tun.
Kopieren Sie die neue
cordova.js
in Ihr Projekt.Aktualisieren Sie den HTML-Code um die neue
cordova.js
-Datei verwenden.Kopieren Sie die Datei
res/xml/config.xml
, umframework/res/xml/config.xml
zu entsprechen.Update
framework/res/xml/config.xml
ähnliche Einstellungen haben, wie es früher war.Kopieren Sie Dateien aus
bin/templates/cordova
dem Projektcordova
Verzeichnis.
Ein Upgrade auf 2.7.0 von 2.6.0
Entfernen Sie
Cordova-2.6.0.jar
aus dem ProjektverzeichnisLibs
.Cordova-2.7.0.jar
des ProjektsLibs
Verzeichnis hinzufügen.Wenn Sie Eclipse verwenden, aktualisieren das Eclipse-Projekt und eine saubere zu tun.
Kopieren Sie die neue
cordova-2.7.0.js
in Ihr Projekt.Aktualisieren Sie den HTML-Code um die neue
cordova-2.7.0.js
-Datei verwenden.Kopie der
res/xml/config.xml
entsprechendframework/res/xml/config.xml
.Update
framework/res/xml/config.xml
ähnliche Einstellungen haben, wie es früher war.Kopieren Sie Dateien aus
bin/templates/cordova
für des Projektscordova
Verzeichnis.
Ein Upgrade auf 2.6.0 von 2.5.0
Entfernen Sie
Cordova-2.5.0.jar
aus dem ProjektverzeichnisLibs
.Cordova-2.6.0.jar
des ProjektsLibs
Verzeichnis hinzufügen.Wenn Sie Eclipse verwenden, aktualisieren das Eclipse-Projekt und eine saubere zu tun.
Kopieren Sie die neue
cordova-2.6.0.js
in Ihr Projekt.Aktualisieren Sie Ihre HTML-um das neue
cordova-2.6.0.js
Datei.Kopie der
res/xml/config.xml
entsprechendframework/res/xml/config.xml
.Update
framework/res/xml/config.xml
ähnliche Einstellungen haben, wie es früher war.Kopieren Sie Dateien aus
bin/templates/cordova
dem Projektcordova
Verzeichnis.
Führen Sie bin/update <project>
mit den Projektpfad im Cordova Quellverzeichnis aufgeführt.
Ein Upgrade auf 2.5.0 von 2.4.0
Entfernen Sie
Cordova-2.4.0.jar
aus dem ProjektverzeichnisLibs
.Cordova-2.5.0.jar
des ProjektsLibs
Verzeichnis hinzufügen.Wenn Sie Eclipse verwenden, aktualisieren das Eclipse-Projekt und eine saubere zu tun.
Kopieren Sie die neue
cordova-2.5.0.js
in Ihr Projekt.Aktualisieren Sie Ihre HTML-um das neue
cordova-2.5.0.js
Datei.Kopie der
res/xml/config.xml
entsprechendframework/res/xml/config.xml
.Update
framework/res/xml/config.xml
ähnliche Einstellungen haben, wie es früher war.Kopieren Sie Dateien aus
bin/templates/cordova
dem Projektcordova
Verzeichnis.
Ein Upgrade auf 2.4.0 von 2.3.0
Entfernen Sie
Cordova-2.3.0.jar
aus dem ProjektverzeichnisLibs
.Cordova-2.4.0.jar
des ProjektsLibs
Verzeichnis hinzufügen.Wenn Sie Eclipse verwenden, aktualisieren das Eclipse-Projekt und eine saubere zu tun.
Kopieren Sie die neue
cordova-2.4.0.js
in Ihr Projekt.Aktualisieren Sie Ihre HTML-um das neue
cordova-2.4.0.js
Datei.Kopie der
res/xml/config.xml
entsprechendframework/res/xml/config.xml
.Kopieren Sie Dateien aus
bin/templates/cordova
für des Projektscordova
Verzeichnis.
Ein Upgrade auf 2.3.0 von 2.2.0
Entfernen Sie
Cordova-2.2.0.jar
aus dem ProjektverzeichnisLibs
.Cordova-2.3.0.jar
des ProjektsLibs
Verzeichnis hinzufügen.Wenn Sie Eclipse verwenden, aktualisieren das Eclipse-Projekt und eine saubere zu tun.
Kopieren Sie die neue
cordova-2.3.0.js
in Ihr Projekt.Aktualisieren Sie Ihre HTML-um das neue
cordova-2.3.0.js
Datei.Kopie der
res/xml/config.xml
entsprechendframework/res/xml/config.xml
.Kopieren Sie Dateien aus
bin/templates/cordova
für des Projektscordova
Verzeichnis.
Ein Upgrade auf 2.2.0 von 2.1.0
Entfernen Sie
Cordova-2.1.0.jar
aus dem ProjektverzeichnisLibs
.Cordova-2.2.0.jar
des ProjektsLibs
Verzeichnis hinzufügen.Wenn Sie Eclipse verwenden, aktualisieren das Eclipse-Projekt und eine saubere zu tun.
Kopieren Sie die neue
cordova-2.2.0.js
in Ihr Projekt.Aktualisieren Sie Ihre HTML-um das neue
cordova-2.2.0.js
Datei.Kopie der
res/xml/config.xml
entsprechendframework/res/xml/config.xml
.Kopieren Sie Dateien aus
bin/templates/cordova
dem Projektcordova
Verzeichnis.
Upgrade auf 2.1.0 von 2.0.0
Entfernen Sie
Cordova-2.0.0.jar
aus dem ProjektverzeichnisLibs
.Cordova-2.1.0.jar
des ProjektsLibs
Verzeichnis hinzufügen.Wenn Sie Eclipse verwenden, aktualisieren das Eclipse-Projekt und eine saubere zu tun.
Kopieren Sie die neue
cordova-2.1.0.js
in Ihr Projekt.Aktualisieren Sie Ihre HTML-um das neue
cordova-2.1.0.js
Datei.Kopie der
res/xml/config.xml
entsprechenframework/res/xml/config.xml
.Kopieren Sie Dateien aus
bin/templates/cordova
dem Projektcordova
Verzeichnis.
Ein Upgrade auf 2.0.0 von 1.9.0
Entfernen Sie
Cordova-1.9.0.jar
aus dem ProjektverzeichnisLibs
.Cordova-2.0.0.jar
des ProjektsLibs
Verzeichnis hinzufügen.Wenn Sie Eclipse verwenden, aktualisieren das Eclipse-Projekt und eine saubere zu tun.
Kopieren Sie die neue
cordova-2.0.0.js
in Ihr Projekt.Aktualisieren Sie Ihre HTML-um das neue
cordova-2.0.0.js
Datei.Kopie der
res/xml/config.xml
entsprechenframework/res/xml/config.xml
.
In der 2.0.0 Release, die Datei config.xml
kombiniert und ersetzt cordova.xml
und plugins.xml
. Die alten Dateien sind veraltet, und während sie noch in 2.0.0, arbeiten funktioniert nicht mehr in einer zukünftigen Version.
Ein Upgrade auf 1.9.0 von 1.8.1
Entfernen Sie
Cordova-1.8.0.jar
aus dem ProjektverzeichnisLibs
.Cordova-1.9.0.jar
des ProjektsLibs
Verzeichnis hinzufügen.Wenn Sie Eclipse verwenden, aktualisieren das Eclipse-Projekt und eine saubere zu tun.
Kopieren Sie die neue
Cordova-1.9.0.js
in Ihr Projekt.Aktualisieren Sie den HTML-Code um die neue
Cordova-1.9.0.js
-Datei verwenden.Update
res/xml/plugins.xml
entsprechendframework/res/xml/plugins.xml
.
Aufgrund der Einführung des CordovaWebView
in die 1.9.0 release, Drittanbieter Plugins funktionieren nicht. Diese Plugins müssen einen Kontext aus dem CordovaInterface
mit getContext()
oder getActivity()
. Wenn Sie kein erfahrener Android-Entwickler sind, bitte kontaktieren Sie den Plugin-Betreuer und fügen Sie diese Aufgabe auf ihre Bug-Tracker.
Ein Upgrade auf 1.8.0 von 1.8.0
Entfernen Sie
Cordova-1.8.0.jar
aus dem ProjektverzeichnisLibs
.Cordova-1.8.1.jar
des ProjektsLibs
Verzeichnis hinzufügen.Wenn Sie Eclipse verwenden, aktualisieren das Eclipse-Projekt und eine saubere zu tun.
Kopieren Sie die neue
Cordova-1.8.1.js
in Ihr Projekt.Aktualisieren Sie den HTML-Code um die neue
Cordova-1.8.1.js
-Datei verwenden.Update
res/xml/plugins.xml
entsprechendframework/res/xml/plugins.xml
.
Ein Upgrade auf 1.8.0 von 1.7.0
Entfernen Sie
Cordova-1.7.0.jar
aus dem ProjektverzeichnisLibs
.Cordova-1.8.0.jar
des ProjektsLibs
Verzeichnis hinzufügen.Wenn Sie Eclipse verwenden, aktualisieren das Eclipse-Projekt und eine saubere zu tun.
Kopieren Sie die neue
cordova-1.8.0.js
in Ihr Projekt.Aktualisieren Sie Ihre HTML-um das neue
cordova-1.8.0.js
Datei.Update
res/xml/plugins.xml
übereinstimmenframework/res/xml/plugins.xml
.
Ein Upgrade auf 1.8.0 von 1.7.0
Entfernen Sie
Cordova-1.7.0.jar
aus dem ProjektverzeichnisLibs
.Cordova-1.8.0.jar
des ProjektsLibs
Verzeichnis hinzufügen.Wenn Sie Eclipse verwenden, aktualisieren das Eclipse-Projekt und eine saubere zu tun.
Kopieren Sie die neue
cordova-1.8.0.js
in Ihr Projekt.Aktualisieren Sie Ihre HTML-um das neue
cordova-1.8.0.js
Datei.Update
res/xml/plugins.xml
übereinstimmenframework/res/xml/plugins.xml
.
Ein Upgrade auf 1.7.0 von 1.6.1
Entfernen Sie
Cordova-1.6.1.jar
aus dem ProjektverzeichnisLibs
.Cordova-1.7.0.jar
des ProjektsLibs
Verzeichnis hinzufügen.Wenn Sie Eclipse verwenden, aktualisieren das Eclipse-Projekt und eine saubere zu tun.
Kopieren Sie die neue
Cordova-1.7.0.js
in Ihr Projekt.Update
res/xml/plugins.xml
übereinstimmenframework/res/xml/plugins.xml
.
Ein Upgrade auf 1.6.1 von 1.6.0
Entfernen Sie
Cordova-1.6.0.jar
aus dem ProjektverzeichnisLibs
.Cordova-1.6.1.jar
des ProjektsLibs
Verzeichnis hinzufügen.Wenn Sie Eclipse verwenden, aktualisieren das Eclipse-Projekt und eine saubere zu tun.
Kopieren Sie die neue
Cordova-1.6.1.js
in Ihr Projekt.Update
res/xml/plugins.xml
übereinstimmenframework/res/xml/plugins.xml
.
Ein Upgrade auf 1.6.0 von 1.5.0
Entfernen Sie
Cordova-1.5.0.jar
aus dem ProjektverzeichnisLibs
.Cordova-1.6.0.jar
des ProjektsLibs
Verzeichnis hinzufügen.Wenn Sie Eclipse verwenden, aktualisieren das Eclipse-Projekt und eine saubere zu tun.
Kopieren Sie die neue
Cordova-1.6.0.js
in Ihr Projekt.Aktualisieren Sie den HTML-Code um die neue
Cordova-1.6.0.js
-Datei verwenden.Update
res/xml/plugins.xml
entsprechendframework/res/xml/plugins.xml
.Ersetzen Sie
res/xml/phonegap.xml
durchres/xml/cordova.xml
entsprechendframework/res/xml/cordova.xml
.
Ein Upgrade auf 1.5.0 von 1.4.0
Entfernen Sie
Phonegap-1.4.0.jar
aus dem ProjektverzeichnisLibs
.Cordova-1.5.0.jar
des ProjektsLibs
Verzeichnis hinzufügen.Wenn Sie Eclipse verwenden, aktualisieren das Eclipse-Projekt und eine saubere zu tun.
Kopieren Sie die neue
Cordova-1.5.0.js
in Ihr Projekt.Aktualisieren Sie den HTML-Code um die neue
Cordova-1.5.0.js
-Datei verwenden.Update
res/xml/plugins.xml
entsprechendframework/res/xml/plugins.xml
.Ersetzen Sie
res/xml/phonegap.xml
durchres/xml/cordova.xml
entsprechendframework/res/xml/cordova.xml
.
Ein Upgrade auf 1.4.0 von 1.3.0
Entfernen Sie
Phonegap-1.3.0.jar
aus dem ProjektverzeichnisLibs
.Das Verzeichnis des Projekts
Libs
Phonegap-1.4.0.jar
hinzufügen.Wenn Sie Eclipse verwenden, aktualisieren das Eclipse-Projekt und eine saubere zu tun.
Kopieren Sie die neue
Phonegap-1.4.0.js
in Ihr Projekt.Aktualisieren Sie den HTML-Code um die neue
Phonegap-1.4.0.js
-Datei verwenden.Update
res/xml/plugins.xml
entsprechendframework/res/xml/plugins.xml
.Update
res/xml/phonegap.xml
entsprechendframework/res/xml/phonegap.xml
.
Ein Upgrade auf 1.3.0 von 1.2.0
Entfernen Sie
Phonegap-1.2.0.jar
aus dem ProjektverzeichnisLibs
.Das Verzeichnis des Projekts
Libs
Phonegap-1.3.0.jar
hinzufügen.Wenn Sie Eclipse verwenden, aktualisieren das Eclipse-Projekt und eine saubere zu tun.
Kopieren Sie die neue
Phonegap-1.3.0.js
in Ihr Projekt.Aktualisieren Sie den HTML-Code um die neue
Phonegap-1.2.0.js
-Datei verwenden.Update
res/xml/plugins.xml
entsprechendframework/res/xml/plugins.xml
.Update
res/xml/phonegap.xml
übereinstimmenframework/res/xml/phonegap.xml
.
Ein Upgrade auf 1.2.0 von 1.1.0
Entfernen Sie
Phonegap-1.1.0.jar
aus dem ProjektverzeichnisLibs
.Das Verzeichnis des Projekts
Libs
Phonegap-1.2.0.jar
hinzufügen.Wenn Sie Eclipse verwenden, aktualisieren das Eclipse-Projekt und eine saubere zu tun.
Kopieren Sie die neue
Phonegap-1.2.0.js
in Ihr Projekt.Aktualisieren Sie den HTML-Code um die neue
Phonegap-1.2.0.js
-Datei verwenden.Update
res/xml/plugins.xml
übereinstimmenframework/res/xml/plugins.xml
.Update
res/xml/phonegap.xml
übereinstimmenframework/res/xml/phonegap.xml
.
Von 1.0.0 auf 1.1.0 aktualisieren
Entfernen Sie
Phonegap-1.0.0.jar
aus dem ProjektverzeichnisLibs
.Das Verzeichnis des Projekts
Libs
Phonegap-1.1.0.jar
hinzufügen.Wenn Sie Eclipse verwenden, aktualisieren das Eclipse-Projekt und eine saubere zu tun.
Kopieren Sie die neue
Phonegap-1.1.0.js
in Ihr Projekt.Aktualisieren Sie den HTML-Code um die neue
Phonegap-1.1.0.js
-Datei verwenden.Update
res/xml/plugins.xml
übereinstimmenframework/res/xml/plugins.xml
.
Ein Upgrade auf 1.0.0 von 0.9.6
Entfernen Sie
Phonegap-0.9.6.jar
aus dem ProjektverzeichnisLibs
.Das Verzeichnis des Projekts
Libs
Phonegap-1.0.0.jar
hinzufügen.Wenn Sie Eclipse verwenden, aktualisieren das Eclipse-Projekt und eine saubere zu tun.
Kopieren Sie die neue
Phonegap-1.0.0.js
in Ihr Projekt.Aktualisieren Sie den HTML-Code um die neue
Phonegap-1.0.0.js
-Datei verwenden.Fügen Sie die
res/xml/plugins.xml
entsprechendframework/res/xml/plugins.xml
.