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.

Anleitung zur Windows Platform

Diese Anleitung zeigt wie der SDK-Entwicklungsumgebung zum Erstellen und Bereitstellen von Cordova apps für Windows 8, Windows 8.1 und Windows Phone 8.1 einzurichten. Es zeigt, wie mithilfe von entweder Shell-Werkzeugen generieren und bauen apps oder die plattformübergreifende Cordova CLI diskutiert in der Command-Line Interface. (Siehe die Übersicht für einen Vergleich dieser Entwicklung-Optionen.) In diesem Abschnitt veranschaulicht auch Cordova apps innerhalb von Visual Studio zu ändern. Unabhängig davon, welchen Ansatz Sie nehmen, müssen Sie das Visual Studio-SDK installieren, wie unten beschrieben.

Informationen zum Aktualisieren von bestehender Windows 8 Cordova-Projekten finden Sie unter Aktualisieren von Windows 8.

Einzelheiten siehe Fenster Telefon 8 (wp8) Aufenthalte als separate Plattform Windows Phone 8 Platform Guide.

Cordova WebViews auf Windows basieren auf Internet Explorer 10 (Windows 8) und Internet Explorer 11 (Windows 8.1 und Windows Phone 8.1) als ihre Rendering-Engine, also als eine praktische Sache Sie IE leistungsstarken Debugger verwenden können, um alle Webinhalte testen, die Cordova-APIs aufrufen nicht. Die Windows Phone Developer Blog enthält hilfreiche Hinweise zum Support IE sowie vergleichbare WebKit-Browser.

Anforderungen und Unterstützung

Sie benötigen eine der folgenden Kombinationen der OS/SDK, entweder von einer Installationsdiskette oder eine ISO -Imagedatei.

Apps nur für Windows 8.0 zu entwickeln:

Entwickeln Sie Anwendungen für alle Plattformen (Windows 8.0, 8.1 für Windows und Windows Phone 8.1):

Apps, die kompiliert unter Windows 8.1 tun nicht laufen unter Windows 8.0. Apps unter Windows 8.0 kompiliert sind aufwärtskompatibel mit 8.1.

Folgen Sie den Anweisungen auf windowsstore.com die app Windows Store einreichen.

Entwicklung von Cordova apps für Windows können einen PC mit Windows, aber Sie können auch auf einem Mac entwickeln, oder mit einer VM-Umgebung mithilfe von Boot Camp eine Windows-8.1 Dual-Boot-Partition. Finden Sie diese Ressourcen die erforderlichen Windows-Entwicklungsumgebung auf einem Mac einrichten:

Mithilfe von Cordova Shell Tools

Wenn Sie Cordova's Windows-zentrierte Shell-Werkzeugen in Verbindung mit dem SDK verwenden möchten, müssen Sie zwei grundlegende Optionen:

  • Greifen sie lokal von Projektcode generiert durch die CLI. Sie stehen in den platforms/windows/cordova Verzeichnis nach dem Hinzufügen der windows Plattform wie unten beschrieben.

  • Aus eine separate Verteilung auf cordova.apache.orgherunterladen. Die Cordova-Distribution enthält separate Archiv für jede Plattform. Achten Sie darauf, um das entsprechende Archiv zu erweitern cordova-windows\windows in diesem Fall in ein leeres Verzeichnis. Die entsprechenden Batch-Dienstprogramme sind in der obersten Ebene bin Verzeichnis. (Konsultieren Sie die README -Datei, ggf. für eine genauere Wegbeschreibung.)

Diese Shell-Tools können Sie erstellen, erstellen und Ausführen von Windows-Anwendungen. Informationen über die zusätzliche Befehlszeilenschnittstelle, die Plugin-Features für alle Plattformen aktiviert, finden Sie unter Using Plugman zu Plugins verwalten.

Das SDK installieren

Installieren Sie die ultimative, Premiumoder Professional 2013 Editionen von Visual Studio.

Erstellen eines neuen Projekts

Zu diesem Zeitpunkt zum Erstellen eines neuen Projekts können Sie zwischen das Cross-Plattform-CLI-Tool in The Command-Line Interface oder den Satz von Windows-spezifischen Shell Tools beschrieben. In einem Quellcode-Verzeichnis dieser CLI-Ansatz generiert aus eine app mit dem Namen HelloWorld innerhalb eines neuen hello Projektverzeichnis:

    > cordova create hello com.example.hello HelloWorld
    > cd hello
    > cordova platform add windows
    > cordova build

Hier ist der entsprechende Low-Level-Shell-Tool-Ansatz:

    C:\path\to\cordova-win\bin\create.bat C:\path\to\new\hello com.example.hello HelloWorld

Erstellen Sie das Projekt

Bei Verwendung von CLI in der Entwicklung ist das Projektverzeichnis der obersten Ebene www Verzeichnis enthält die Quellcode-Dateien. Führen Sie einen dieser dem Projektverzeichnis, die app neu zu erstellen:

    > cordova build
    > cordova build windows   # do not rebuild other platforms

Sobald Sie das Projekt generieren, die Standard-app-Quelle steht in den projects\windows\www Unterverzeichnis. Nachfolgende Befehle stehen in der cordova Unterverzeichnis auf dem gleichen Niveau.

Der build Befehl reinigt Projektdateien und Umbauten, die app. Das erste Beispiel generiert Debuginformationen und das zweite Zeichen der apps für Release:

    C:\path\to\project\cordova\build.bat --debug        
    C:\path\to\project\cordova\build.bat --release

Der clean Befehl können Sie die Verzeichnisse in der Vorbereitung für die nächste auszuschwemmen build :

    C:\path\to\project\cordova\clean.bat

Ziel-Windows-Version zu konfigurieren

In der Standardeinstellung build Befehl erzeugt zwei Pakete: Windows 8.0 und Windows Phone 8.1. Zum Aktualisieren von Windows-Paket auf Version 8.1 muss folgende Konfigurationseinstellung hinzugefügt werden, um Konfigurations-Datei)config.xml).

    <preference name='windows-target-version' value='8.1' />

Wenn Sie diese Einstellung hinzugefügt build Befehl startet Produktion von Windows 8.1 und Windows Phone 8.1 Pakete.

Die app bereitstellen

Windows Phone-Paket bereitstellen:

    > cordova run windows -- --phone  # deploy app to Windows Phone 8.1 emulator
    > cordova run windows --device -- --phone  # deploy app to connected device

Windows-Paket bereitstellen:

    > cordova run windows -- --win  # explicitly specify Windows as deployment target
    > cordova run windows # `run` uses Windows package by default

Öffnen Sie das Projekt im SDK und Bereitstellen der Anwendung

Sobald Sie eine Cordova-Anwendung zu erstellen, wie oben beschrieben, können Sie es mit Visual Studio öffnen. Die verschiedenen build Befehle Generieren einer Visual Studio-Projektmappendatei (.sln). Öffnen Sie die Datei im Datei-Explorer ändern Sie das Projekt in Visual Studio:

Die CordovaApp -Komponente zeigt innerhalb der Lösung und ihrer www Verzeichnis enthält den Web-basierte Quellcode, einschließlich die index.html Homepage:

Mit den Steuerelementen unter Visual Studio im Hauptmenü können Sie testen oder Bereitstellen der app:

Lokalen Computer ausgewählt drücken Sie den grünen Pfeil um die app auf dem gleichen Computer ausführen von Visual Studio installieren. Einmal tun Sie dies, die app erscheint in Windows 8 app angeboten:

Jedes Mal, wenn Sie die Anwendung neu erstellen, wird die Version in der Schnittstelle aktualisiert.

Sobald Sie in der app-Angebote verfügbar, ermöglicht halten Sie die STRG -Taste beim Markieren der app um zum Hauptbildschirm zu fixieren:

Beachten Sie, dass wenn Sie die app in einer virtuellen Umgebung öffnen, müssen Sie möglicherweise klicken Sie auf in den Ecken oder an den Seiten des Windows apps zu wechseln oder auf zusätzliche Funktionen zugreifen:

Wählen Sie alternativ die Simulator -Bereitstellungsoption die app anzeigen, als ob es auf einem Tablettgerät ausgeführt wurden:

Im Gegensatz zu desktop-Bereitstellung mit dieser Option können Sie simulieren die Tablette Orientierung, Lage, und variieren ihre Netzwerkeinstellungen.

Hinweis: Rufen Sie die Übersicht für Ratschläge, wie mithilfe von Cordovas Kommandozeilen-Tools oder das SDK in Ihrem Workflow. Cordova CLI stützt sich auf Cross-Plattform-Quellcode, der routinemäßig die plattformspezifischen Dateien vom SDK verwendet überschreibt. Möchten Sie das SDK zu verwenden, ändern Sie das Projekt, verwenden Sie die Low-Level-Shell-Werkzeugen als Alternative zu den CLI.