Konfigurieren von Visual Studio-Tools für Apache Cordova

  • Artikel

Die Cordova-Tools sind in Visual Studio 2013 als Preview (CTP) Version veröffentlicht. Die Cordova-Tools werden Als Teil von Visual Studio 2015 veröffentlicht und wir empfehlen, zum Entwickeln von Apps Visual Studio 2015 RTM und die Visual Studio-Tools für Apache Cordova zu verwenden. Sie können Visual Studio aus dem Microsoft Download Center herunterladen.

Nachdem Sie die Tools installiert haben, finden Sie in diesem Thema weitere Möglichkeiten zum schnellen Konfigurieren, Aktualisieren oder Anpassen der Tools für Ihre Umgebung.

  • Wenn Sie eine oder mehrere Abhängigkeiten nicht mit Visual Studio-Tools für Apache Cordova installieren, müssen Sie möglicherweise die Abhängigkeiten manuell installieren.

  • Wenn Sie den Pfad für eine Drittanbieter-Abhängigkeit überprüfen müssen oder mehrere Versionen einer Abhängigkeit installiert sind, finden Sie Informationen dazu unter Überschreiben von Umgebungsvariablen des Systems.

  • Wenn Sie Visual Studio hinter einem Proxy ausführen, finden Sie Informationen dazu unter Konfigurieren von Tools zum Arbeiten mit einem Proxy.

  • Im Folgenden finden Sie Informationen zum Installieren, Starten und Konfigurieren des remotebuild-Agents (zuvor als vs-mda-remote bezeichnet) zum Erstellen von iOS-Apps:

  • Falls beim Erstellen der Vorlage der leeren App unerwartete Fehler angezeigt werden, finden Sie Informationen unter Erneutes Installieren von vs-tac.

    Warnung

    Wenn Sie ein Projekt von einer früheren Version von Visual Studio migrieren, lesen Sie diese Migrationsinformationen (GitHub).

  • Andere Probleme, die hier nicht aufgelistet sind, finden Sie unter Bekannte Probleme.

Manuelles Installieren von Abhängigkeiten

Wenn eine oder mehrere Abhängigkeiten zur Erweiterung jetzt nicht installieren möchten, können Sie dies später manuell tun.

Sie können die Abhängigkeiten mit Ausnahme von Java in beliebiger Reihenfolge installieren. Sie müssen vor der Installation des Android SDK Java installieren und konfigurieren.

Lesen Sie die folgenden Informationen und verwenden Sie die folgenden Links, um Abhängigkeiten manuell zu installieren.

  • Joyent Node.js

    Wir empfehlen die Installation der x86-Version von "Node.js".

  • Google Chrome

  • Git-Befehlszeilentools

    Wenn Sie Git Befehlszeilentools installieren, wählen Sie die Option aus, mit der Sie Git zum Eingabeaufforderungspfad hinzufügen.

    Warnung

    Git-Befehlszeilentools 1.9.5 sind standardmäßig installiert.Bei Installation einer Version vor 1.9.0 treten möglicherweise unerwartete Fehler auf.

  • Apache Ant

    • Laden Sie Ant-Datei herunter und extrahieren Sie sie an einem Speicherort wie z. B. C:/ant-1.x.x

    • Legen Sie die ANT_HOME-Umgebungsvariable so fest, dass sie auf den vorherigen Speicherort verweist.

    • Fügen Sie dem Systempfad "%ANT_HOME%\bin" hinzu.

      Hinweis

      Wenn Sie diese Umgebungsvariable manuell festlegen müssen, finden Sie weitere Informationen unter Überschreiben von Systemumgebungsvariablen.

  • Oracle Java, 32 Bit

    • Legen Sie die JAVA_HOME-Umgebungsvariable auf C:/Program Files/Java/jdk1.7.0_55 fest.

    • Fügen Sie Folgendes zum Systempfad hinzu: %JAVA_HOME%\bin

    • Legen Sie zum Vermeiden von Arbeitsspeicherproblemen eine „_JAVA_OPTIONS“-Umgebungsvariable mit mindestens „-Xmx512M“ fest.

      Hinweis

      Wenn Sie diese Umgebungsvariable manuell festlegen müssen, finden Sie weitere Informationen unter Überschreiben von Systemumgebungsvariablen.

  • Android-SDK mit den folgenden SDK-Paketen:

    • Android SDK Tools (neueste Version)

    • Android SDK Platform-Tools (neueste Version)

    • Android-SDK-Buildtools (19.1, 19.0.3 und 21)

    • Android 5.0.x (API-Ebene 21) mit den folgenden Paketen:

      • SDK Platform

      • Beim Verwenden des Android-Emulators für Google zum Emulieren eines 5.0.x-Geräts:

        • ARM EABI v7a System Image

        • Intel x86 Atom System Image

        • Google APIs (x86 System Image)

        • Google APIs (ARM System Image)

    • Bei Verwendung von Cordova 5.0.0 oder höher:

      • Android 5.1.x (API-Ebene 22) mit den folgenden Paketen:

        • SDK-Plattform

        • Beim Verwenden des Android-Emulators für Google zum Emulieren eines 5.1.x-Geräts:

          • ARM EABI v7a System Image

          • Intel x86 Atom System Image

          • Google APIs (x86 System Image)

          • Google APIs (ARM System Image)

    Die folgende Abbildung zeigt die mindestens erforderlichen Pakete im Android SDK Manager.

    Cordova_SDK_Android_Packages

    Legen Sie die Umgebungsvariable auf den SDK-Installationspfad ADT_HOME fest.

    Fügen Sie Folgendes zum Systempfad hinzu: %ADT_HOME%\tools;%ADT_HOME%\platform-tools

    Wenn Sie diese Umgebungsvariable manuell festlegen müssen, finden Sie weitere Informationen unter Überschreiben von Systemumgebungsvariablen.

    Tipp

    Wenn Sie das Android-SDK auf dem Standardspeicherort auf Windows installieren, wird es unter "C:\Program Files (x86)\Android\android-sdk" installiert.

  • Apple iTunes (x86, x64)

  • WebSocket4Net (erforderlich, wenn Sie Ihre Anwendung auf Windows 7 entwickeln)

    1. Laden Sie WebSocket4Net(0.9).Binaries.ZIP herunter von CodePlex.

    2. Entzippen Sie die Binärdateien, und heben Sie dann die Blockierung von „net45\Release\WebSocket4Net.dll“ auf.

      Um die Blockierung der DLL-Datei aufzuheben, öffnen Sie die Dateieigenschaften für die DLL-Datei, und wählen Sie Zulassen auf der Registerkarte „Allgemein“ (am unteren Rand des Dialogfelds).

    3. Nachdem Sie die Blockierung der DLL-Datei aufgehoben haben, kopieren Sie „net45\Release\WebSocket4Net.dll“ in den Ordner „%ProgramFiles(x86)%\Microsoft Visual Studio 14.0\Common7\IDE\CommonExtensions\Microsoft\WebClient\Diagnostics\ToolWindows“ auf Ihrem Computer.

Überschreiben von Umgebungsvariablen des Systems

Visual Studio erkennt die Konfigurationen, die Sie für die Drittanbieter-Software installiert haben, und verwaltet die Installationspfade in folgenden Umgebungsvariablen:

  • ADT_HOME verweist auf den Android-Installationspfad.

  • ANT_HOME verweist auf die Ant-Ordner auf Ihrem Computer.

  • GIT_HOME verweist auf den Git-Installationspfad.

  • JAVA_HOME verweist auf den Java-Installationspfad.

Visual Studio verwendet diese Umgebungsvariablen beim Erstellen und Ausführen von Anwendungen. Im Visual Studio-Dialogfeld Optionen können Sie die Umgebungsvariablen anzeigen und ihre Werte überarbeiten. Möglicherweise möchten die aus einem der folgenden Gründe Standardeinstellungen überschreiben:

  • Visual Studio konnte den Pfad nicht überprüfen. In diesem Fall wird eine Warnung neben der Umgebungsvariablen angezeigt.

  • Sie haben mehrere Versionen der Software installiert, und Sie möchten eine bestimmte Version verwenden.

  • Sie möchten, dass sich der Pfad Ihre globalen Umfelds von der lokalen Umgebung von Visual Studio unterscheidet.

So überschreiben Sie die Variablen

  1. Wählen Sie in der Menüleiste von Visual Studio Extras, Optionen aus.

  2. Wählen Sie im Dialogfeld Optionen die Optionen Tools für Apache Cordova und Umgebungsvariablen-Überschreibungen aus.

  3. Nehmen Sie die Änderungen vor:

    • Um einen Wert zu überschreiben, aktivieren Sie das entsprechende Kontrollkästchen, und überarbeiten Sie dann den Wert.

      Bei ungültigen oder fehlenden Pfadinformationen zeigt Visual Studio eine Warnung neben dieser Variablen an.

    • Um eine Umgebungsvariable auf ihren Standardwert zurückzusetzen, deaktivieren Sie das Kontrollkästchen, oder wählen Sie Auf Standard zurücksetzen aus.

  4. Wählen Sie OK, um Ihre Änderungen zu speichern und das Dialogfeld zu schließen.

Umgebungsvariablen, Warnmeldung

Generieren einer neuen Sicherheits-PIN (iOS-Remote-Agent)

Wenn Sie den Agent erstmals starten, ist die generierte PIN für einen begrenzten Zeitraum (standardmäßig 10 Minuten) gültig. Wenn Sie keine Verbindung zum Agent herstellen, bevor die Zeit abläuft, oder Sie einen zweiten Client mit dem Agent verbinden möchten, müssen Sie eine neue PIN generieren.

So generieren Sie eine neue Sicherheits-PIN

  1. Halten Sie den Agent an (oder öffnen Sie ein zweites Terminal-App-Fenster auf Ihrem Mac, und verwenden Sie dieses, um den Befehl einzugeben).

  2. Geben Sie über die Terminal-Anwendung auf Ihrem Mac Folgendes ein:

    remotebuild generateClientCert

  3. Befolgen Sie die Anweisungen zum Starten des Agents auf Ihrem Mac, und konfigurieren Sie den Agent in Visual Studio.

Generieren eines neuen Serverzertifikats (iOS-Remote-Agent)

Aus Sicherheitsgründen sind die Serverzertifikate, die Visual Studio mit dem Remoteagent koppeln, an die IP oder den Hostnamen Ihres Macs gebunden. Wenn sich diese Werte geändert haben, müssen Sie ein neues Serverzertifikat generieren und anschließend Visual Studio mit den neuen Werte erneut generieren.

So generieren Sie ein neues Serverzertifikat

  1. Beenden Sie den Agent.

  2. Geben Sie über die Terminal-Anwendung auf Ihrem Mac Folgendes ein:

    remotebuild resetServerCert --hostname=my.hostname.com

  3. Geben Sie "Y" ein, und drücken Sie die EINGABETASTE, wenn Sie dazu aufgefordert werden.

  4. Geben Sie über die Terminal-Anwendung auf Ihrem Mac Folgendes ein:

    remotebuild generateClientCert --hostname=my.hostname.com

    „--hostname“ ist optional. Wenn die Angabe nicht erfolgt, versucht der Agent, den Hostnamen automatisch zu ermitteln.

  5. Befolgen Sie die Anweisungen zum Starten des Agents auf Ihrem Mac, und konfigurieren Sie den Agent in Visual Studio.

Konfigurieren des iOS-Remote-Agenten

Sie können den Remoteagent mit verschiedenen Befehlszeilenoptionen konfigurieren. Beispielsweise können Sie den Port zum Überwachen der Build-Anforderungen und die maximale Anzahl an Builds angeben, die auf dem Dateisystem verwaltet werden sollen. (Die Standardgrenze ist 10. Der Agent entfernt beim Herunterfahren die überzähligen Builds.)

Warnung

Viele Optionen wurden zwischen vs-mda-remote und remotebuild geändert.

So konfigurieren Sie den Remote-Agenten

  • Geben Sie Folgendes ein, um eine vollständige Liste der Agentbefehle anzuzeigen:

    remotebuild --help

  • Geben Sie zum Deaktivieren des sicheren Modus und zum Aktivieren von einfachen HTTP-basierten Verbindungen Folgendes ein:

    remotebuild –-secure=false

    Wenn Sie diese Option verwenden, lassen Sie beim Konfigurieren des Agents in Visual Studio das PIN-Feld leer und setzen Sie die Option Sicherer Modus auf False

  • Geben Sie zum Angeben eines Speicherorts für Remoteagentdateien Folgendes ein:

    remotebuild --serverDir <directory>

    <directory> ist hierbei ein Speicherort auf Ihrem Mac, in welchem Protokolldateien, Builds und Serverzertifikate platziert werden. Der Speicherort könnte beispielsweise "/Users/username/builds" lauten. (Builds werden an diesem Speicherort nach Build-Nummer organisiert.)

  • Um mithilfe eines Hintergrundprozesses stdout und stderr in einer Datei (server.log) zu erfassen, geben Sie Folgendes ein:

    remotebuild > server.log 2>&1 &

    Die Datei server.log kann bei der Problembehandlung von Builds hilfreich sein.

  • Um den Agenten mit einer Konfigurationsdatei anstelle von Befehlszeilenparametern auszuführen, geben Sie Folgendes ein:

    remotebuild --config <path-to-config-file>

    Die Konfigurationsdatei muss im JSON-Format vorliegen. Die Startoptionen und deren Werte dürfen keine Bindestriche enthalten. Sehen Sie sich eine dokumentierte Konfigurationsdatei im Ordner „remotebuild/examples/exampleConfig.json“ im Installationsverzeichnis für den Remoteagent an. Für Ihre Konfiguration verwendete Kommentare müssen dabei aus der Datei entfernt werden. Ein Beispiel eines Pfads, den Sie beim Ausführen dieses Befehls verwenden können, lautet /Users/<username>/myConfig.json. Der Standardpfad, in dem der Agent nach einer Konfigurationsdatei sucht, lautet „~/.taco_home/RemoteBuild.config“.

Überprüfen der Konfiguration des iOS-Remote-Agenten

Nachdem Sie den Agenten installiert haben, können Sie die Konfiguration des Remote-Agenten überprüfen.

So überprüfen Sie die Konfiguration des Remote-Agenten

  • Öffnen Sie bei laufendem Remote-Agenten ein zweites Fenster für die Terminal-App (wählen Sie Shell > Neues Fenster).

  • Geben Sie im zweiten Fenster der Terminal-Anwendung auf Ihrem Mac Folgendes ein:

    remotebuild test <same-options-as-first-agent>

    Wichtig

    Dieser Befehl verursacht einen Fehler, wenn der Agent nicht in einem zweiten Fenster ausgeführt wird oder die beiden Instanzen nicht die gleichen Konfigurationsoptionen verwenden.

    Dieser Befehl startet einen Test-Build. In der Ausgabe des Befehls sollten die Build-Nummer und andere Informationen zum Build (z. B. der Fortschritt) angezeigt werden.

    Überprüfen Sie den Build, nachdem Sie einen Testbuild gestartet haben.

  • Wenn der Server auf einen anderen Port als 3000 gestartet wird, verwenden Sie zum Starten eines Test-Build stattdessen folgenden Befehl:

    remotebuild test –-server https://localhost:<portNumber>

  • Um sicherzustellen, dass Ihre Entwickler-Signaturidentität für Geräte-Builds korrekt (mithilfe der Debug- und Releasekonfigurationen in Visual Studio) eingerichtet wurde, geben Sie Folgendes ein:

    remotebuild test --device

  • Um zu überprüfen, ob die Signaturidentität zur Verteilung für Geräte-Builds korrekt (mithilfe der Verteilungskonfiguration in Visual Studio) eingerichtet wurde, geben Sie Folgendes ein:

    remotebuild test --device

    Weitere Informationen zu Signaturidentitäten für Anwendungsbereitstellungen und Zertifikate finden Sie unter Verpacken der mit Visual Studio-Tools für Apache Cordova erstellten App.

Erneutes Installieren von vs-tac

Wenn beim Erstellen der Vorlage der leeren App nach der Installation von Visual Studio-Tools für Apache Cordova unerwartete Fehler angezeigt werden, können Sie den Cache löschen und den Cordova-CLI-Präprozessor (vs-tac) auf Ihrem PC erneut installieren. Dies ist in der Regel nur erforderlich, wenn Sie versuchen, eine Cordova-App zu erstellen, und der Fehler Cannot find module [modulename] angezeigt wird.

So löschen Sie den Cache

  1. Wählen Sie Extras, Optionen, Tools für Apache Cordova und dann Cordova-Tools aus.

  2. Wählen Sie Cordova-Cache löschen aus.

  3. Schließen Sie das Projekt, und öffnen Sie es erneut.

  4. Wählen Sie Erstellen, Projektmappe bereinigen aus, und erstellen Sie das Projekt dann erneut.

    Tipp

    Wenn keine Fehler auftreten, müssen Sie vs-tac nicht erneut installieren.Wenn wieder der gleiche Fehler auftritt, installieren Sie vs-tac erneut.

So installieren Sie vs-tac erneut

  1. Schließen Sie Visual Studio.

  2. Öffnen Sie eine Befehlszeile, und geben Sie den folgenden Befehl ein:

    npm install -g <path-to-vs-tac>

    Der Standardpfad für vs-tac lautet „C:\Program Files (x86)\Microsoft Visual Studio 14.0\Common7\IDE\Extensions\ApacheCordovaTools\packages\vs-tac“.

  3. Öffnen Sie Visual Studio erneut.

  4. Öffnen Sie das Projekt, wählen Sie Erstellen, Projektmappe bereinigen aus, und erstellen Sie das Projekt dann erneut.

    Wenn das Problem dadurch nicht behoben wird, lesen Sie die Informationen unter Bekannte Probleme.

Konfigurieren von Tools zum Arbeiten mit einem Proxy

Wenn Sie Visual Studio hinter einem Proxy verwenden, z. B. einer Unternehmens-Firewall, müssen Sie möglicherweise Proxyeinstellungen für den npm-Paket-Manager und für Git konfigurieren, bevor Sie Visual Studio-Tools für Apache Cordova verwenden können.

Wichtig

Das Verwenden von NPM-Proxyeinstellungen mit neueren Versionen von „Node.js“ kann dazu führen, dass Cordova Plug-Ins weder über die Befehlszeile noch im Konfigurations-Designer noch beim Hinzufügen von für den Build erforderlichen Plattformen abrufen kann.Wenn unerwartete Probleme auftreten (insbesondere der Fehler „TypeError: Request path contains unescaped characters“ (Typfehler: Anforderungspfad weist nicht durch Escapezeichen formatierte Zeichen auf)), sollten Sie versuchen, „Node.js“ auf „0.10.29“ herabzustufen.

So konfigurieren Sie Proxyeinstellungen für den npm-Paket-Manager

  1. Schließen Sie Visual Studio.

  2. Öffnen Sie ein Visual Studio Developer-Befehlsfenster (Strg+Alt+A), und geben Sie den folgenden Befehl ein.

    npm -g uninstall vs-tac

  3. Öffnen Sie "%AppData%\npm\node_modules", und stellen Sie sicher, dass der Ordner "vs-tac" entfernt wurde.

  4. Geben Sie im Visual Studio Developer-Befehlsfenster den folgenden Befehl ein.

    npm config set proxy <proxy-port>

    Dabei ist proxy-port die Adresse und Portnummer des Proxys, z. B. "http://proxy.mycompany.com:80/".

  5. Dann geben Sie den folgenden Befehl ein:

    npm config set https-proxy <proxy-port>

    Dabei kann proxy-port ein Wert wie z. B. "http://proxy.mycompany.com:80/" sein.

  6. Öffnen Sie Visual Studio.

  7. Öffnen Sie die Apache Cordova-Projektmappe, und erstellen Sie das Projekt erneut.

So konfigurieren Sie Proxyeinstellungen für Git

  1. Schließen Sie Visual Studio.

  2. Öffnen Sie ein Visual Studio Developer-Befehlsfenster (Strg+Alt+A), und geben Sie den folgenden Befehl ein.

    git config --global http.proxy http://<username>:<password>@<proxy-port>

    Hierbei sind username und password Ihr Benutzername und Ihr Kennwort für den Proxy. proxy-port ist ein Wert wie z  B. proxy.mycompany.com:80.

  3. Geben Sie den folgenden Befehl ein:

    git config --global https.proxy http://<username>:<password>@<proxy-port>

    Hierbei sind username und password Ihr Benutzername und Ihr Kennwort für den Proxy. proxy-port ist ein Wert wie z  B. proxy.mycompany.com:80.

  4. Öffnen Sie Visual Studio.

  5. Öffnen Sie die Apache Cordova-Projektmappe, und erstellen Sie das Projekt erneut.

Die Tools herunterladen Herunterladen der Visual Studio-Tools für Apache Cordova oder weitere Informationen

Siehe auch

Konzepte

Installieren von Visual Studio-Tools für Apache Cordova

Ausführen der Apache Cordova-App unter iOS