Installieren von Visual Studio-Tools für Apache Cordova

Artikel
09/11/2015

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.

Nutzen Sie den leicht zu verwendenden Installer, um plattformübergreifende Apps mit Visual Studio und Apache Cordova zu erstellen. Beim Installer müssen Sie die erforderlichen SDKs, Tools und Bibliotheken (oder deren Versionen) nicht angeben.

In diesem Abschnitt

Anforderungen
Beschaffung der Tools
Installieren der Tools
Installieren der Tools für iOS
Zusätzliche Aufgaben

Anforderungen

Anforderungen an das Betriebssystem:

Windows 7, Windows 8, Windows 8.1, Windows 10 oder Windows Server 2012 R2.

Wichtig

Wenn Sie Windows 7 verwenden, können Sie Apps für Android und iOS entwickeln, jedoch nicht für Windows- oder für Windows Phone-Apps.

Zum Erstellen von Anwendungen für bestimmte Plattformen bestehen einige zusätzliche Anforderungen:

Für iOS und den iOS-Simulator ist ein Mac-Computer erforderlich, auf dem Xcode 6 (Xcode 6 wird empfohlen) ausgeführt werden kann. Weitere Informationen und Installationsschritte finden Sie unter Installieren der Tools für iOS.

Tipp

Informationen zum Erstellen für iOS über einen Cloud-Dienst anstelle von Mac-Hardware finden Sie unter Erstellen und Simulieren von iOS in der Cloud.
Android-Emulatoren funktionieren am besten auf Computern, auf denen Hyper-V oder der Intel HAXM-Treiber ausgeführt wird. Siehe Ausführen der Apache Cordova-App unter Android.
Windows Phone-Emulatoren benötigen einen Computer, auf dem Hyper-V ausgeführt werden kann.
Für das Erstellen einer universellen Windows 10-Plattform-App müssen die Windows 10-Tools für Visual Studio installiert werden. Beachten Sie, dass Windows 8.1-/Windows Phone-Apps möglicherweise auch auf Windows 10 bereitgestellt werden.

Beschaffung der Tools

Rufen Sie die Visual Studio-Tools für Apache Cordova ab, die als optionale Komponente in Visual Studio 2015 enthalten sind. Folgen Sie den Schritten im nächsten Abschnitt, um die Tools zu installieren.

Wichtig

Visual Studio 2015 wird für die Entwicklung von Apache Cordova-Apps empfohlen.Wenn Sie Visual Studio 2015 Preview, Visual Studio 2015 CTP oder Visual Studio 2015 RC zuvor installiert haben, müssen Sie es zunächst über die Systemsteuerung, die Option „Programme und Funktionen“ deinstallieren, bevor Sie Visual Studio 2015 installieren können.

Installieren der Tools

Bei der Installation der Visual Studio-Tools für Apache Cordova wählt das Installationsprogramm von Visual Studio 2015 für die Installation zusätzliche Software von Drittanbietern aus. Bei den meisten handelt es sich und Open Source-Software, die für bestimmte Plattformen oder Apache Cordova erforderlich ist. Sie können die Standardauswahl überschreiben und die Auswahl von Software aufheben, die Sie nicht installieren möchten.

Falls noch nicht installiert, wird die folgende Software standardmäßig ausgewählt:

Für den Buildprozess in Android und für Ripple ist Android SDK erforderlich.
Für den Buildprozess in Android ist Apache Ant 1.8.0 oder höher erforderlich.
Für den Buildprozess in Android ist Oracle Java JDK 7 (32 Bit) erforderlich.
Mit Joyent Node.js kann Visual Studio die Apache Cordova-Befehlszeilenschnittstelle und den Apache Ripple-Emulator integrieren.

Hinweis

Das Installationsprogramm installiert den zum Ausführen des Apache Ripple-Simulators für iOS und Android erforderlichen Browser Google Chrome nicht. Apple iTunes wird ebenfalls nicht installiert, es ist zum Bereitstellen einer App auf einem mit einem Windows-PC verbundenen iOS-Gerät erforderlich.
Git CLI ist nur dann erforderlich, wenn Sie Git-URIs für bestimmte Cordova-Plug-ins manuell hinzufügen müssen.

Wichtig

Bei der Verwendung von Cordova 5.0.0+ müssen Sie möglicherweise eine _JAVA_OPTIONS-Umgebungsvariable hinzufügen, die mindestens -Xmx512M enthält, um beim Erstellen von Android-Apps Fehler über unzureichenden Arbeitsspeicher zu vermeiden.Weitere Informationen finden Sie hier zu den bekannten Problemen.

So installieren Sie Visual Studio-Tools für Apache Cordova

Führen Sie den Installer aus, den Sie unter Beschaffung der Tools gefunden haben.
Befolgen Sie die Installationsanweisungen für Visual Studio 2015 und vergewissern Sie sich, dass Sie folgende optionale Features installieren:
- HTML/JavaScript (Apache Cordova), unter plattformübergreifende mobile Entwicklung
  
  Hinweis
  
  Wenn Sie Visual Studio 2013 anstatt Visual Studio 2015 installieren (Visual Studio 2015 wird empfohlen), werden die Cordova-Tools als separate Erweiterung installiert.
- Windows 8.1- und Windows Phone 8.0/8.1-Tools
- Microsoft Visual Studio-Emulator für Android, wenn der Entwicklungscomputer Hyper-V unterstützt.
  
  …
  
  Hinweis
  
  Sie können diese Features zu einer vorhandenen Visual Studio 2015-Installation hinzufügen.Wählen Sie in der Systemsteuerung Programme und Funktionen.Wählen Sie in der Liste "Visual Studio 2015" und dann Ändern aus.Wählen Sie im Visual Studio-Einrichtungsfenster Ändern aus.Wählen Sie in der Featureliste die optionalen Features wie in der Abbildung gezeigt aus.
  
  Wenn Sie d ie standardmäßige Auswahl unter den häufigen Tools und Software Development Kits nicht treffen wollen, können Sie die Auswahl der Software aufheben und die erforderlichen Abhängigkeiten später manuell installieren.
  
  Wichtig
  
  Wenn die Drittanbieter-Abhängigkeiten bereits im System vorhanden sind oder Sie sie manuell installieren möchten, müssen Sie möglicherweise den Systempfad aktualisieren.Siehe Manuelles Installieren von Abhängigkeiten.
Starten Sie den Computer neu, um sicherzustellen, dass alles korrekt installiert ist.
Öffnen Sie Visual Studio, wählen Sie Tools, Erweiterungen und Updates und dann Updates aus. Wenn ein Visual Studio-Update für Visual Studio-Tools für Apache Cordova verfügbar ist, dann installieren Sie es.

Hinweis

Wenn Sie nach der Installation der Tools zum ersten Mal eine Anwendung erstellen, werden die Cordova-Tools von Visual Studio heruntergeladen und installiert.Daher nimmt der erste Build zusätzliche Zeit in Anspruch.Überprüfen Sie das Ausgabefenster, um den Fortschritt anzuzeigen.Wenn ein Fehler wie Cannot find module [modulename] angezeigt wird, müssen Sie die Projektmappe möglicherweise bereinigen und neu erstellen.Weitere Informationen finden Sie unter Erneutes Installieren von vs-tac.

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

Installieren der Tools für iOS

Zum Erstellen und Ausführen von iOS-Apps im iOS-Simulator oder auf einem iOS-Gerät mit Visual Studio müssen Sie den Remote-Agent remotebuild, auf einem Macintosh-Computer installieren und konfigurieren, der die unten angegebenen Voraussetzungen erfüllt. (iOS-Anwendungen können derzeit nicht unter Windows erstellt werden). In Visual Studio auf Ihrem PC müssen Sie ebenfalls den Remote-Agenten wie in diesem Thema beschrieben konfigurieren.

Hinweis

Informationen zur Verwendung von in der Cloud gehosteten Mac-Diensten anstelle eines Macs finden Sie unter Erstellen und Simulieren von iOS in der Cloud.Wenn Sie Windows auf einem Mac mithilfe von Virtualisierungstechnologie ausführen, können Sie iOS lokal erstellen und ausführen.Weitere Informationen finden Sie unter Erstellen Sie einer Cordova-App für iOS mit Parallels.

Stellen Sie vor dem Installieren des Remote-Agenten sicher, dass Sie Visual Studio-Tools für Apache Cordova installiert haben.

Sie können den Agenten so konfigurieren, dass dieser Build-Anforderungen bearbeitet und die Anwendung auf einem iOS-Gerät oder dem iOS-Simulator ausführt. Um den Agenten zu hosten, muss auf dem Mac-Computer Folgendes installiert sein:

Mac OS X Mavericks
Xcode 6
Xcode-Befehlszeilentools (verwenden Sie in der Terminal-App xcode-select --install)
Node.js
Git-Befehlszeilentools, wenn Sie eine CLI aus einem Git-Repository verwenden.

Wenn die CLI-Version auf einen Git-Speicherort verweist, ist Git zum Erstellen der App für iOS erforderlich.

Darüber hinaus müssen Sie über Folgendes verfügen:

Ein aktives iOS-Entwicklerprogramm-Konto bei Apple
Ein in Xcode konfiguriertes iOS-Bereitstellungsprofil (laden Sie das Bereitstellungsprofil herunter, und führen Sie die heruntergeladene *.mobileprovision-Datei aus)

Hinweis

Ausführliche Informationen finden Sie unter Verwalten von Signaturidentitäten und Zertifikaten in der iOS-Entwicklerbibliothek.
Eine in Xcode konfigurierte Signaturidentität (wählen Sie XCode > Einstellungen aus)

Hinweis

Visual Studio 2015 verfügt über einen aktualisierten Remoteagent mit dem Namen remotebuild.Der vorherige Agent „vs-mda-remote“ ist für die Verwendung mit Visual Studio 2015 RC und früher vorgesehen.

Herunterladen und Installieren des Remote-Agenten

Geben Sie über die Terminal-Anwendung auf Ihrem Mac Folgendes ein:
```
sudo npm install –g npm
sudo npm install -g remotebuild
sudo npm install –g ios-sim@3.1.1
```
Mit dem ersten Befehl wird NPM aktualisiert, mit dem zweiten Befehl wird der Remoteagent installiert. Der dritte Befehl ist jedoch nur erforderlich, wenn Sie den iOS-Simulator von Visual Studio verwenden.
Wenn Sie über eine ältere Version von „Node.js“ und NPM verfügen, müssen Sie möglicherweise die folgenden Befehle eingeben, bevor Sie den Remoteagent starten, ansonsten tritt ein Berechtigungsfehler beim Erstellen auf. Geben Sie über die Terminal-Anwendung auf Ihrem Mac Folgendes ein:
```
sudo npm cache clear
sudo chown -R `whoami` ~/.npm
```
Dieser Befehl sorgt dafür, dass die Berechtigungen des npm-Paketcaches in Ihrem Basisverzeichnis korrekt konfiguriert sind (neuere Versionen von Node.js und npm erledigen dies automatisch).

Beim ersten Starten des Remote-Agents (remotebuild) wird der Entwicklermodus auf Ihrem Macintosh-Computer aktiviert. Homebrew wird ebenfalls zusammen mit ideviceinstaller und ios-webkit-debug-proxy installiert, damit Apps auf Geräten automatisch ausgeführt werden und das Debuggen von Apps auf Geräten und im Simulator möglich ist.

Warnung

Zum Installieren von Homebrew benötigen Sie sudo-Zugriff (Administrator).Wenn Sie remotebuild ohne sudo installieren müssen, können Sie Homebrew manuell im Verzeichnis „usr/local“ installieren und den Ordner „Bin“ zu Ihrem Pfad hinzufügen.Weitere Informationen finden Sie in der Homebrew-Dokumentation.Wenn Sie den Entwicklermodus manuell aktivieren müssen, geben Sie Folgendes in der Terminal-App ein: DevToolsSecurity –enable

Wenn Sie Ihren Computer auf eine neue Version von Visual Studio aktualisiert haben, müssen Sie diese Aktualisierung auch auf dem Remote-Agenten vornehmen.

So aktualisieren Sie den Remote-Agenten

Wiederholen Sie den Installationsschritt aus dem vorherigen Abschnitt.

So starten Sie den Remote-Agenten

Geben Sie über die Terminal-Anwendung auf Ihrem Mac Folgendes ein:
```
remotebuild
```
Hinweis

In Visual Studio 2013 lautet der vorherige Befehl vs-mda-remote.

Dadurch wird der Agent mit einem standardmäßigen Buildverzeichnis „~/.taco_home/remote-builds/taco-remote/builds“ gestartet. Zusätzliche Konfigurationsoptionen für den Agenten werden unter Konfigurieren des Remote-Agenten beschrieben.

Beim ersten Start des Agenten erhalten Sie die Informationen, die zum Konfigurieren des Agenten in Visual Studio erforderlich sind, einschließlich des Hosts, des Ports und der Sicherheits-PIN.

Wichtig

Der Remote-Agent dient zum sicheren Übertragen von Build-Nutzlasten an und von Visual Studio mithilfe von SSL-Zertifikaten
Wenn Sie vorhaben, den Remote-Agenten in Visual Studio unter Verwendung des Hostnamens zu konfigurieren, pingen Sie den Mac mithilfe des Hostnamens, um sicherzustellen, dass er erreichbar ist. Ansonsten müssen Sie möglicherweise die IP-Adresse dafür verwenden.
Wenn der Macintosh-Computer extern unter einem Hostnamen sichtbar ist, sich jedoch intern selbst in einen anderen Hostnamen zuweist, müssen Sie möglicherweise den Hostnamen mithilfe des folgenden Befehls in der Terminal-App angeben:
```
remotebuild resetServerCerts --hostname=my.external.hostname.com
remotebuild generateClientCert --hostname=my.external.hostname.com
```
um die Zertifikate erneut zu generieren, die mit dem angegebenen Hostnamen verwendet werden können. Wenn Sie vorhaben, den Remote-Agenten in Visual Studio unter Verwendung des Hostnamens zu konfigurieren, pingen Sie den Mac mithilfe des Hostnamens, um sicherzustellen, dass er erreichbar ist. Ansonsten müssen Sie möglicherweise die IP-Adresse dafür verwenden.

Vor der Verwendung des Remote-Agenten müssen Sie die Remote-Konfiguration in Visual Studio angeben.

So konfigurieren Sie den Remote-Agenten für die Nutzung in Visual Studio

Wenn der Agent nicht bereits auf Ihrem Mac ausgeführt wird, starten Sie den Remote-Agenten.
Rufen Sie den Hostnamen auf Ihrem Mac oder Ihres IP-Adresse Ihres Macs ab.

Mit dem ifconfig-Befehl kann die IP-Adresse abgerufen werden.
Wählen Sie in der Menüleiste von Visual Studio Extras, Optionen aus.
Wählen Sie im Dialogfeld Optionen die Optionen Tools für Apache Cordova und dann Remote-Agent-Konfiguration aus.
Stellen Sie Remote-iOS-Verarbeitung auf True ein.
Setzen Sie den Sicheren Modus auf True.
Geben Sie in den Feldern Host, Port und Sicherheits-PIN die durch den Remote-Agenten angegebenen Werte ein, als Sie ihn erstmals gestartet hatten. Der Host kann der Name oder die IP-Adresse Ihres Macs sein. Der Standardport ist 3000.

Hinweis

Wenn Sie den Mac nicht mithilfe des Hostnamens pingen können, müssen Sie möglicherweise die IP-Adresse verwenden.

Wenn Sie auf OK klicken, stellt Visual Studio eine Verbindung zum Remote-Agenten her (der Agent muss ausgeführt werden, um eine Verbindung herstellen zu können).

Wenn Sie den sicheren Modus deaktivieren und einfache HTTP-basierte Verbindungen aktivieren möchten, wählen Sie False als Einstellung für Sicherer Modus aus.
```
remotebuild --secure false
```
Wenn der sichere Modus deaktiviert ist, können Sie das Feld Sicherheits-PIN leer lassen, wenn Sie den Agenten in Visual Studio konfigurieren.

Die Sicherheits-PIN dient zur einmaligen Verwendung. Weitere Informationen zum Verbinden eines neuen Clients mit dem remotebuild-Server finden Sie unter Generieren einer neuen Sicherheits-PIN.

So halten Sie den Agenten an

Drücken Sie auf der Terminal-Anwendung auf Ihrem Mac auf STRG+C.

Zusätzliche Aufgaben

In einigen Fällen sind möglicherweise zusätzliche Schritte zum Aktualisieren und Konfigurieren der Tools erforderlich.

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.
Informationen zum Verwenden und Konfigurieren des remotebuild-Agenten zum Erstellen von iOS-Apps finden Sie unter folgenden Themen:
Falls beim Erstellen der Vorlage der leeren App unerwartete Fehler angezeigt werden, finden Sie Informationen unter Erneutes Installieren von vs-tac.