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 unter Windows sind auf Internet Explorer 10 (Windows 8.0) 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

Entwickeln von Anwendungen für Windows-Plattform, die Sie brauchen:

Eine Windows-8.1, 32 oder 64-Bit-Maschine (Home, Prooder Enterprise -Editionen) mit mindestens 4 GB RAM.
Für die Windows Phone-Emulatoren, Professional Edition Windows 8.1 (X 64) oder höher, und ein Prozessor unterstützt Client Hyper-V und Second Level Address Translation (Stab). Eine Evaluierungsversion von Windows 8.1 Enterprise gibt es aus dem Microsoft Developer Network.
Visual Studio-2013 für Windows (Express oder höher).

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:

Das SDK installieren

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

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/ Verzeichnis, nachdem Sie die Windows -Plattform hinzufügen, 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, Cordova-Windows in diesem Fall in ein leeres Verzeichnis zu erweitern. Die entsprechenden Batch-Dienstprogramme sind im Paket/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.

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. Der CLI-Ansatz unten wird eine app mit dem Namen “HelloWorld” eines neue hello -Projekt-Verzeichnis:

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

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

    C:\path\to\cordova-windows\package\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
    > cordova build windows   --debug    # generates debugging information
    > cordova build windows   --release  # signs the apps for release

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

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

Ziel-Windows-Version zu konfigurieren

Von Standard build Befehl erzeugt zwei Pakete: Windows 8.0 und Windows Phone 8.1. Aktualisieren von Windows-Paket auf Version 8.1 folgende Konfigurationseinstellung in Konfigurationsdatei ("config.xml" hinzugefügt werden).

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

Sobald Sie hinzufügen startet diese Einstellung-Befehl Erstellen , produzieren Windows 8.1 und Windows Phone 8.1 Pakete.

Die app bereitstellen

Windows-Paket bereitstellen:

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

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

Können Sie cordova run windows --list finden alle verfügbaren Ziele und cordova run windows --target=target_name -- -|-phone Anwendung auf ein bestimmtes Gerät oder einen Emulator ausführen (z. B. ordova run windows --target="Emulator 8.1 720P 4.7 inch" -- --phone).

Sie können auch cordova run --help finden Sie unter zusätzliche Build und Ausführungsoptionen.

Ö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 Source-Code, einschließlich der 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.