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

under the License.

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 3.6.0 Projekte 4.0.0

Für nicht-CLI Projekte führen:

    bin/update path/to/project

CLI-Projekte:

  1. Update der cordova CLI-Version. Finden Sie die Befehlszeilenschnittstelle.

  2. cordova platform update android in Ihre bestehenden Projekte ausgeführt.

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:

  1. Update der cordova CLI-Version. Finden Sie die Befehlszeilenschnittstelle.

  2. Ausführencordova platform update android

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 hören = “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:

  1. Update der cordova CLI-Version. Finden Sie die Befehlszeilenschnittstelle.

  2. Ausführencordova platform update android

Für Projekte, die nicht mit der Cordova CLI erstellt ausgeführt:

    bin/update <project_path>

Upgrade auf die CLI (3.0.0) von 2.9.0

  1. Erstellen Sie ein neues Apache Cordova 3.0.0-Projekt mit Cordova CLI, wie in der Command-Line Interface beschrieben.

  2. Fügen Sie Ihrer Plattformen Projektes Cordova, zum Beispiel: cordova platform add android.

  3. Kopieren Sie den Inhalt der www-Verzeichnis des Projekts in das www-Verzeichnis im Stammverzeichnis des Projektes Cordova soeben erstellten.

  4. 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.

  5. 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.

Ein Upgrade auf 3.0.0 von 2.9.0

  1. Erstellen Sie ein neues Apache Cordova Android Projekt.

  2. Kopieren Sie den Inhalt des Verzeichnisses www zum neuen Projekt.

  3. Kopieren Sie nativen Android Vermögen aus dem res-Verzeichnis zum neuen Projekt.

  4. Kopieren Sie über alle Plug-ins, die Sie aus der src-Unterverzeichnissen in das neue Projekt installiert.

  5. Achten Sie darauf, alle aktualisieren veraltet <plugin> Verweise aus der alten Datei "config.xml" auf der neuen <feature> Spezifikation.

  6. 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.

Ein Upgrade auf 2.9.0 von 2.8.0

  1. bin/update <project_path> ausführen.

Ein Upgrade auf 2.8.0 von 2.7.0

  1. Entfernen Sie cordova-2.7.0.jar aus dem Projektverzeichnis libs.

  2. cordova-2.8.0.jar des Projekts libs Verzeichnis hinzufügen.

  3. Wenn Sie Eclipse verwenden, aktualisieren das Eclipse-Projekt und eine saubere zu tun.

  1. Kopieren Sie die neue cordova.js in Ihr Projekt.

  2. Aktualisieren Sie den HTML-Code um die neue cordova.js-Datei verwenden.

  3. Kopieren Sie die Datei res/xml/config.xml, um framework/res/xml/config.xml zu entsprechen.

  4. Update framework/res/xml/config.xml ähnliche Einstellungen haben, wie es früher war.

  5. Kopieren Sie Dateien aus bin/templates/cordova für des Projekts cordova Verzeichnis.

Ein Upgrade auf 2.7.0 von 2.6.0

  1. Entfernen Sie cordova-2.6.0.jar aus dem Projektverzeichnis libs.

  2. cordova-2.7.0.jar des Projekts libs Verzeichnis hinzufügen.

  3. Wenn Sie Eclipse verwenden, aktualisieren das Eclipse-Projekt und eine saubere zu tun.

  4. Kopieren Sie die neue cordova-2.7.0.js in Ihr Projekt.

  5. Aktualisieren Sie den HTML-Code um die neue cordova-2.7.0.js-Datei verwenden.

  6. Kopie der res/xml/config.xml entsprechendframework/res/xml/config.xml.

  7. Update framework/res/xml/config.xml ähnliche Einstellungen haben, wie es früher war.

  8. Kopieren Sie Dateien aus bin/templates/cordova für des Projekts cordova Verzeichnis.

Ein Upgrade auf 2.6.0 von 2.5.0

  1. Entfernen Sie cordova-2.5.0.jar aus dem Projektverzeichnis libs.

  2. cordova-2.6.0.jar des Projekts libs Verzeichnis hinzufügen.

  3. Wenn Sie Eclipse verwenden, aktualisieren das Eclipse-Projekt und eine saubere zu tun.

  4. Kopieren Sie die neue cordova-2.6.0.js in Ihr Projekt.

  5. Aktualisieren Sie den HTML-Code um das neue cordova-2.6.0.js Datei.

  6. Kopie der res/xml/config.xml entsprechendframework/res/xml/config.xml.

  7. Update framework/res/xml/config.xml ähnliche Einstellungen haben, wie es früher war.

  8. 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.

Ein Upgrade auf 2.5.0 von 2.4.0

  1. Entfernen Sie cordova-2.4.0.jar aus dem Projektverzeichnis libs.

  2. cordova-2.5.0.jar des Projekts libs Verzeichnis hinzufügen.

  3. Wenn Sie Eclipse verwenden, aktualisieren das Eclipse-Projekt und eine saubere zu tun.

  4. Kopieren Sie die neue cordova-2.5.0.js in Ihr Projekt.

  5. Aktualisieren Sie den HTML-Code um das neue cordova-2.5.0.js Datei.

  6. Kopie der res/xml/config.xml entsprechendframework/res/xml/config.xml.

  7. Update framework/res/xml/config.xml ähnliche Einstellungen haben, wie es früher war.

  8. Kopieren Sie Dateien aus bin/templates/cordova für des Projekts cordova Verzeichnis.

Ein Upgrade auf 2.4.0 von 2.3.0

  1. Entfernen Sie cordova-2.3.0.jar aus dem Projektverzeichnis libs.

  2. cordova-2.4.0.jar des Projekts libs Verzeichnis hinzufügen.

  3. Wenn Sie Eclipse verwenden, aktualisieren das Eclipse-Projekt und eine saubere zu tun.

  4. Kopieren Sie die neue cordova-2.4.0.js in Ihr Projekt.

  5. Aktualisieren Sie den HTML-Code um das neue cordova-2.4.0.js Datei.

  6. Kopie der res/xml/config.xml entsprechendframework/res/xml/config.xml.

  7. Kopieren Sie Dateien aus bin/templates/cordova für des Projekts cordova Verzeichnis.

Ein Upgrade auf 2.3.0 von 2.2.0

  1. Entfernen Sie cordova-2.2.0.jar aus dem Projektverzeichnis libs.

  2. cordova-2.3.0.jar des Projekts libs Verzeichnis hinzufügen.

  3. Wenn Sie Eclipse verwenden, aktualisieren das Eclipse-Projekt und eine saubere zu tun.

  4. Kopieren Sie die neue cordova-2.3.0.js in Ihr Projekt.

  5. Aktualisieren Sie den HTML-Code um das neue cordova-2.3.0.js Datei.

  6. Kopie der res/xml/config.xml entsprechendframework/res/xml/config.xml.

  7. Kopieren Sie Dateien aus bin/templates/cordova für des Projekts cordova Verzeichnis.

Ein Upgrade auf 2.2.0 von 2.1.0

  1. Entfernen Sie cordova-2.1.0.jar aus dem Projektverzeichnis libs.

  2. cordova-2.2.0.jar des Projekts libs Verzeichnis hinzufügen.

  3. Wenn Sie Eclipse verwenden, aktualisieren das Eclipse-Projekt und eine saubere zu tun.

  4. Kopieren Sie die neue cordova-2.2.0.js in Ihr Projekt.

  5. Aktualisieren Sie den HTML-Code um das neue cordova-2.2.0.js Datei.

  6. Kopie der res/xml/config.xml entsprechendframework/res/xml/config.xml.

  7. Kopieren Sie Dateien aus bin/templates/cordova für des Projekts cordova Verzeichnis.

Upgrade auf 2.1.0 von 2.0.0

  1. Entfernen Sie cordova-2.0.0.jar aus dem Projektverzeichnis libs.

  2. cordova-2.1.0.jar des Projekts libs Verzeichnis hinzufügen.

  3. Wenn Sie Eclipse verwenden, aktualisieren das Eclipse-Projekt und eine saubere zu tun.

  4. Kopieren Sie die neue cordova-2.1.0.js in Ihr Projekt.

  5. Aktualisieren Sie den HTML-Code um das neue cordova-2.1.0.js Datei.

  6. Kopie der res/xml/config.xml entsprechendframework/res/xml/config.xml.

  7. Kopieren Sie Dateien aus bin/templates/cordova für des Projekts cordova Verzeichnis.

Ein Upgrade auf 2.0.0 von 1.9.0

  1. Entfernen Sie cordova-1.9.0.jar aus dem Projektverzeichnis libs.

  2. cordova-2.0.0.jar des Projekts libs Verzeichnis hinzufügen.

  3. Wenn Sie Eclipse verwenden, aktualisieren das Eclipse-Projekt und eine saubere zu tun.

  4. Kopieren Sie die neue cordova-2.0.0.js in Ihr Projekt.

  5. Aktualisieren Sie den HTML-Code um das neue cordova-2.0.0.js Datei.

  6. 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.

Ein Upgrade auf 1.9.0 von 1.8.1

  1. Entfernen von cordova-1.8.0.jar aus des Projekts libs Verzeichnis.

  2. cordova-1.9.0.jar des Projekts libs Verzeichnis hinzufügen.

  3. Wenn Sie Eclipse verwenden, aktualisieren das Eclipse-Projekt und eine saubere zu tun.

  4. Kopieren Sie die neue cordova-1.9.0.js in Ihr Projekt.

  5. Aktualisieren Sie den HTML-Code um die neue cordova-1.9.0.js-Datei verwenden.

  6. 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.

Ein Upgrade auf 1.8.0 von 1.8.0

  1. Entfernen von cordova-1.8.0.jar aus des Projekts libs Verzeichnis.

  2. cordova-1.8.1.jar des Projekts libs Verzeichnis hinzufügen.

  3. Wenn Sie Eclipse verwenden, aktualisieren das Eclipse-Projekt und eine saubere zu tun.

  4. Kopieren Sie die neue cordova-1.8.1.js in Ihr Projekt.

  5. Aktualisieren Sie den HTML-Code um die neue cordova-1.8.1.js-Datei verwenden.

  6. Update res/xml/plugins.xml entsprechendframework/res/xml/plugins.xml.

Ein Upgrade auf 1.8.0 von 1.7.0

  1. Entfernen von cordova-1.7.0.jar aus des Projekts libs Verzeichnis.

  2. Hinzufügen von cordova-1.8.0.jar für des Projekts libs Verzeichnis.

  3. Wenn Sie Eclipse verwenden, aktualisieren das Eclipse-Projekt und eine saubere zu tun.

  4. Kopieren Sie die neue cordova-1.8.0.js in Ihr Projekt.

  5. Aktualisieren Sie den HTML-Code um das neue cordova-1.8.0.js Datei.

  6. Update res/xml/plugins.xml entsprechendframework/res/xml/plugins.xml.

Ein Upgrade auf 1.8.0 von 1.7.0

  1. Entfernen von cordova-1.7.0.jar aus des Projekts libs Verzeichnis.

  2. Hinzufügen von cordova-1.8.0.jar für des Projekts libs Verzeichnis.

  3. Wenn Sie Eclipse verwenden, aktualisieren das Eclipse-Projekt und eine saubere zu tun.

  4. Kopieren Sie die neue cordova-1.8.0.js in Ihr Projekt.

  5. Aktualisieren Sie den HTML-Code um das neue cordova-1.8.0.js Datei.

  6. Update res/xml/plugins.xml entsprechendframework/res/xml/plugins.xml.

Ein Upgrade auf 1.7.0 von 1.6.1

  1. Entfernen Sie cordova-1.6.1.jar aus dem Projektverzeichnis libs.

  2. cordova-1.7.0.jar des Projekts libs Verzeichnis hinzufügen.

  3. Wenn Sie Eclipse verwenden, aktualisieren das Eclipse-Projekt und eine saubere zu tun.

  4. Kopieren Sie die neue cordova-1.7.0.js in Ihr Projekt.

  5. Update res/xml/plugins.xml entsprechendframework/res/xml/plugins.xml.

Ein Upgrade auf 1.6.1 von 1.6.0

  1. Entfernen Sie cordova-1.6.0.jar aus dem Projektverzeichnis libs.

  2. cordova-1.6.1.jar des Projekts libs Verzeichnis hinzufügen.

  3. Wenn Sie Eclipse verwenden, aktualisieren das Eclipse-Projekt und eine saubere zu tun.

  4. Kopieren Sie die neue cordova-1.6.1.js in Ihr Projekt.

  5. Update res/xml/plugins.xml entsprechendframework/res/xml/plugins.xml.

Ein Upgrade auf 1.6.0 von 1.5.0

  1. Entfernen Sie cordova-1.5.0.jar aus dem Projektverzeichnis libs.

  2. cordova-1.6.0.jar des Projekts libs Verzeichnis hinzufügen.

  3. Wenn Sie Eclipse verwenden, aktualisieren das Eclipse-Projekt und eine saubere zu tun.

  4. Kopieren Sie die neue cordova-1.6.0.js in Ihr Projekt.

  5. Aktualisieren Sie den HTML-Code um die neue cordova-1.6.0.js-Datei verwenden.

  6. Update res/xml/plugins.xml entsprechendframework/res/xml/plugins.xml.

  7. Ersetzen Sie res/xml/phonegap.xml mit res/xml/cordova.xml übereinstimmenframework/res/xml/cordova.xml.

Ein Upgrade auf 1.5.0 von 1.4.0

  1. Entfernen Sie phonegap-1.4.0.jar aus dem Projektverzeichnis libs.

  2. cordova-1.5.0.jar des Projekts libs Verzeichnis hinzufügen.

  3. Wenn Sie Eclipse verwenden, aktualisieren das Eclipse-Projekt und eine saubere zu tun.

  4. Kopieren Sie die neue cordova-1.5.0.js in Ihr Projekt.

  5. Aktualisieren Sie den HTML-Code um die neue cordova-1.5.0.js-Datei verwenden.

  6. Update res/xml/plugins.xml entsprechendframework/res/xml/plugins.xml.

  7. Ersetzen Sie res/xml/phonegap.xml mit res/xml/cordova.xml übereinstimmenframework/res/xml/cordova.xml.

Ein Upgrade auf 1.4.0 von 1.3.0

  1. Entfernen Sie phonegap-1.3.0.jar aus dem Projektverzeichnis libs.

  2. Das Verzeichnis des Projekts libs phonegap-1.4.0.jar hinzufügen.

  3. Wenn Sie Eclipse verwenden, aktualisieren das Eclipse-Projekt und eine saubere zu tun.

  4. Kopieren Sie die neue phonegap-1.4.0.js in Ihr Projekt.

  5. Aktualisieren Sie den HTML-Code um die neue phonegap-1.4.0.js-Datei verwenden.

  6. Update res/xml/plugins.xml entsprechendframework/res/xml/plugins.xml.

  7. Update res/xml/phonegap.xml entsprechendframework/res/xml/phonegap.xml.

Ein Upgrade auf 1.3.0 von 1.2.0

  1. Entfernen Sie phonegap-1.2.0.jar aus dem Projektverzeichnis libs.

  2. Das Verzeichnis des Projekts libs phonegap-1.3.0.jar hinzufügen.

  3. Wenn Sie Eclipse verwenden, aktualisieren das Eclipse-Projekt und eine saubere zu tun.

  4. Kopieren Sie die neue phonegap-1.3.0.js in Ihr Projekt.

  5. Aktualisieren Sie den HTML-Code um das neue phonegap-1.2.0.js Datei.

  6. Update res/xml/plugins.xml entsprechendframework/res/xml/plugins.xml.

  7. Update res/xml/phonegap.xml entsprechendframework/res/xml/phonegap.xml.

Ein Upgrade auf 1.2.0 von 1.1.0

  1. Entfernen Sie phonegap-1.1.0.jar aus dem Projektverzeichnis libs.

  2. Das Verzeichnis des Projekts libs phonegap-1.2.0.jar hinzufügen.

  3. Wenn Sie Eclipse verwenden, aktualisieren das Eclipse-Projekt und eine saubere zu tun.

  4. Kopieren Sie die neue phonegap-1.2.0.js in Ihr Projekt.

  5. Aktualisieren Sie den HTML-Code um das neue phonegap-1.2.0.js Datei.

  6. Update res/xml/plugins.xml entsprechendframework/res/xml/plugins.xml.

  7. Update res/xml/phonegap.xml entsprechendframework/res/xml/phonegap.xml.

Von 1.0.0 auf 1.1.0 aktualisieren

  1. Entfernen Sie phonegap-1.0.0.jar aus dem Projektverzeichnis libs.

  2. Das Verzeichnis des Projekts libs phonegap-1.1.0.jar hinzufügen.

  3. Wenn Sie Eclipse verwenden, aktualisieren das Eclipse-Projekt und eine saubere zu tun.

  4. Kopieren Sie die neue phonegap-1.1.0.js in Ihr Projekt.

  5. Aktualisieren Sie den HTML-Code um die neue phonegap-1.1.0.js-Datei verwenden.

  6. Update res/xml/plugins.xml entsprechendframework/res/xml/plugins.xml.

Ein Upgrade auf 1.0.0 von 0.9.6

  1. Entfernen Sie phonegap-0.9.6.jar aus dem Projektverzeichnis libs.

  2. Das Verzeichnis des Projekts libs phonegap-1.0.0.jar hinzufügen.

  3. Wenn Sie Eclipse verwenden, aktualisieren das Eclipse-Projekt und eine saubere zu tun.

  4. Kopieren Sie die neue phonegap-1.0.0.js in Ihr Projekt.

  5. Aktualisieren Sie den HTML-Code um die neue phonegap-1.0.0.js-Datei verwenden.

  6. Fügen Sie die res/xml/plugins.xml entsprechend framework/res/xml/plugins.xml.