license: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations
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.
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.
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)
cordova plugin add cordova-plugin-crosswalk-webview
Cordova-Plugin-Legacy-Whitelist
plugin
cordova plugin add cordova-plugin-legacy-whitelist
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.
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
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.
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.
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.
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>
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 das Www
-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 Cordova-CLI-Tool, um alle Plugins zu installieren, die Sie brauchen. Beachten Sie, dass die CLI behandelt alle Kern-APIs als Plugins, so müssen sie möglicherweise hinzugefügt werden. Nur 3.0.0 Plugins sind kompatibel mit CLI.
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 Plug-ins, 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
-Paket org.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.
bin/update <project_path>
.Entfernen Sie Cordova-2.7.0.jar
aus dem Projektverzeichnis Libs
.
Cordova-2.8.0.jar
des Projekts Libs
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
, um framework/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
für des Projekts cordova
Verzeichnis.
Entfernen Sie Cordova-2.6.0.jar
aus dem Projektverzeichnis Libs
.
Cordova-2.7.0.jar
des Projekts Libs
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 Projekts cordova
Verzeichnis.
Entfernen Sie Cordova-2.5.0.jar
aus dem Projektverzeichnis Libs
.
Cordova-2.6.0.jar
des Projekts Libs
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 den HTML-Code 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
für des Projekts cordova
Verzeichnis.
Führen Sie bin/update <project>
mit den Projektpfad im Cordova Quellverzeichnis aufgeführt.
Entfernen Sie Cordova-2.4.0.jar
aus dem Projektverzeichnis Libs
.
Cordova-2.5.0.jar
des Projekts Libs
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 den HTML-Code 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
für des Projekts cordova
Verzeichnis.
Entfernen Sie Cordova-2.3.0.jar
aus dem Projektverzeichnis Libs
.
Cordova-2.4.0.jar
des Projekts Libs
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 den HTML-Code 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 Projekts cordova
Verzeichnis.
Entfernen Sie Cordova-2.2.0.jar
aus dem Projektverzeichnis Libs
.
Cordova-2.3.0.jar
des Projekts Libs
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 den HTML-Code 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 Projekts cordova
Verzeichnis.
Entfernen Sie Cordova-2.1.0.jar
aus dem Projektverzeichnis Libs
.
Cordova-2.2.0.jar
des Projekts Libs
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 den HTML-Code 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
für des Projekts cordova
Verzeichnis.
Entfernen Sie Cordova-2.0.0.jar
aus dem Projektverzeichnis Libs
.
Cordova-2.1.0.jar
des Projekts Libs
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 den HTML-Code um das neue cordova-2.1.0.js
Datei.
Kopie der res/xml/config.xml
entsprechendframework/res/xml/config.xml
.
Kopieren Sie Dateien aus bin/templates/cordova
für des Projekts cordova
Verzeichnis.
Entfernen Sie Cordova-1.9.0.jar
aus dem Projektverzeichnis Libs
.
Cordova-2.0.0.jar
des Projekts Libs
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 den HTML-Code um das neue cordova-2.0.0.js
Datei.
Kopie der res/xml/config.xml
entsprechendframework/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.
Entfernen Sie Cordova-1.8.0.jar
aus dem Projektverzeichnis Libs
.
Cordova-1.9.0.jar
des Projekts Libs
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 Plug-ins 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.
Entfernen Sie Cordova-1.8.0.jar
aus dem Projektverzeichnis Libs
.
Cordova-1.8.1.jar
des Projekts Libs
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
.
Entfernen Sie Cordova-1.7.0.jar
aus dem Projektverzeichnis Libs
.
Cordova-1.8.0.jar
des Projekts Libs
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 den HTML-Code um das neue cordova-1.8.0.js
Datei.
Update res/xml/plugins.xml
entsprechendframework/res/xml/plugins.xml
.
Entfernen Sie Cordova-1.7.0.jar
aus dem Projektverzeichnis Libs
.
Cordova-1.8.0.jar
des Projekts Libs
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 den HTML-Code um das neue cordova-1.8.0.js
Datei.
Update res/xml/plugins.xml
entsprechendframework/res/xml/plugins.xml
.
Entfernen Sie Cordova-1.6.1.jar
aus dem Projektverzeichnis Libs
.
Cordova-1.7.0.jar
des Projekts Libs
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
entsprechendframework/res/xml/plugins.xml
.
Entfernen Sie Cordova-1.6.0.jar
aus dem Projektverzeichnis Libs
.
Cordova-1.6.1.jar
des Projekts Libs
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
entsprechendframework/res/xml/plugins.xml
.
Entfernen Sie Cordova-1.5.0.jar
aus dem Projektverzeichnis Libs
.
Cordova-1.6.0.jar
des Projekts Libs
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
durch res/xml/cordova.xml
entsprechend framework/res/xml/cordova.xml
.
Entfernen Sie Phonegap-1.4.0.jar
aus dem Projektverzeichnis Libs
.
Cordova-1.5.0.jar
des Projekts Libs
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
durch res/xml/cordova.xml
entsprechend framework/res/xml/cordova.xml
.
Entfernen Sie Phonegap-1.3.0.jar
aus dem Projektverzeichnis Libs
.
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
.
Entfernen Sie Phonegap-1.2.0.jar
aus dem Projektverzeichnis Libs
.
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
entsprechendframework/res/xml/phonegap.xml
.
Entfernen Sie Phonegap-1.1.0.jar
aus dem Projektverzeichnis Libs
.
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
entsprechendframework/res/xml/plugins.xml
.
Update res/xml/phonegap.xml
entsprechendframework/res/xml/phonegap.xml
.
Entfernen Sie Phonegap-1.0.0.jar
aus dem Projektverzeichnis Libs
.
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
entsprechendframework/res/xml/plugins.xml
.
Entfernen Sie Phonegap-0.9.6.jar
aus dem Projektverzeichnis Libs
.
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
entsprechend framework/res/xml/plugins.xml
.