Konfigurationsreferenz

Konfigurationsreferenz

Viele Aspekte des Verhaltens einer Anwendung können mit einer plattformunabhängig Konfigurationsdatei, config.xml, gesteuert werden, welche auf der Grundlage von Packaged Web Apps (Widgets) der W3C spezifiziert ist.

Für Projekte, die mit dem Cordova-CLI (beschrieben in Die Kommandozeilen-Schnittstelle) erstellt wurden, finden Sie diese Datei im www Verzeichnis der obersten Ebene. Mit dem CLI erstellte Projekte, regeneriert Versionen dieser Datei in verschiedenen Unterverzeichnissen innerhalb platforms. Für nicht-CLI Projekte dient jede plattformspezifischen Datei als Quelle.

Während der Speicherort der config.xml Datei je nach Plattform ändern kann, ändert sich deren Inhalt im Allgemeinen nicht. Einige plattformspezifischen Funktionen sind auch in der gleichen Konfigurationsdatei angegeben. Einzelheiten sind unten aufgeführt:

config.xml Elemente

Das Apache-Cordova Projekt strebt danach, die abstrakten Einzelheiten der nativen Platform mit webinspirierten und webbasierte Abstraktionen zu ersetzten, die stark von Standards gesteuert und in der Web-Gemeinschaft angenommen sind. Bitte nehmen Sie sich ein paar Minuten Zeit, um sich mit der config.xml Spezifikation vertraut zu machen, zu verstehen auf welcher Art das Apache-Cordova-Projekt die Anwendungsmetadaten versucht zu abstrahieren und die einfachen Einstiegspunkte anzusehen.

Ein Beispiel:

    <widget>
        <preference name="MySetting" value="true" />
        <feature name="MyPlugin" value="MyPluginClass" />
        <access origin="*" />
        <content src="index.html" />
    </widget>

Eine Liste der unterstützten Elemente der gängigen Plattformen, die in Apache Cordova unterstützt werden.

<feature>

Diese Elemente verweisen auf systemeigene APIs, auf welche die Anwendung zugreift. Während der Laufzeit verweist das Apache Cordova Framework <feature> Elemente auf nativen Code, um Ihrer Cordova Anwendungen den Zugriff auf Geräte APIs zu ermöglichen, was für typisch webbasierte Anwendungen sonst nicht möglich ist.

<access>

Diese Elemente definieren die Funktionsweise Ihrer Whitelist. Bitte lesen Sie den Domain Whitelist Guide für weitere Informationen.

<content>

Dieses Element definiert die Startseite Ihrer Anwendung relativ zum Standard Web Root Verzeichnis des Projekts. Dieses Element ist optional, der Standardwert ist index.html.