Visual Studio Tools for Apache Cordova is a workload for Visual Studio that enables developers to create, manage and test application projects for Apache Cordova on Android, iOS, and Windows. The Tools allow developers to deploy, test and debug Cordova applications on devices, emulators, simulators and the chrome browser -- all within Visual Studio.
This guide covers the required steps to install Visual Studio Tools for Apache Cordova. Since the workload interacts with several mobile app development SDKs, and each relies upon a specific set of tools, the installation will download and install a variety of software components and consume a lot of disk space. Additionally, in order for Visual Studio to work with applications for iOS, you'll need access to a fully functional iOS development environment (which means Xcode running on a Macintosh computer).
Start by ensuring your development system meets the minimum system requirements for Visual Studio. Apache Cordova app development adds the following system requirements:
Next, download Visual Studio 2017.
To install the Visual Studio Tools for Apache Cordova along with a clean Visual Studio installation, download and launch the Visual Studio installer. The installer will display the list of installable components shown in the following figure.
Depending on your specific development needs, you may need to install additional, optional components. For example, to support Android application development you'll need to add support for the Android SDK. To test Android apps on emulators, you’ll need to add support for the Google Android Emulator, as shown in the following figure. If your existing Cordova development environment already includes these tools, you can skip installing them again here and modify the Visual Studio Tools for Apache Cordova configuration to point to the existing installation later.
To add Visual Studio Tools for Apache Cordova to an existing Visual Studio installation, you must run the Visual Studio Installer. You can launch the installer manually, or, from within Visual Studio, open the File menu, select New then Project then select Open Visual Studio Installer at the bottom of the list of installed templates as shown in the following figure:
Refer to the previous section for detailed instructions on how to complete the Tools for Apache Cordova installation.
Visual Studio tracks updates to its installed workloads and offers a single interface to view and install updates.
In the Updates tab of the Extensions and Updates dialog box, choose Product Updates.
If an update for Visual Studio Tools for Apache Cordova appears, select it, and then choose the Update button. Visual Studio will launch the Visual Studio Installer to install the Apache Cordova Tools update.
Visual Studio Tools for Apache Cordova can interact with a remote iOS development environment running on an Apple Mac; enabling developers to build, test and debug Cordova applications on the remote system. See Visual Studio Tools for Apache Cordova: iOS Guide.
During installation, the Visual Studio Installer will install a variety of tools that Visual Studio Tools for Apache Cordova uses to manage Apache Cordova projects.
To support the Cordova development life cycle, Visual Studio installs:
When creating or managing Apache Cordova projects, Visual Studio Tools for Apache Cordova will download additional Cordova components (such as platforms, plugins and more).
As an optional component selected during the Visual Studio Tools for Apache Cordova, to support building, testing and debugging Android applications, the Visual Studio Installer can install a complete development toolchain for Android applications, which includes:
Note: Only the Android command-line tools are installed, if you want to use Google Android Studio to code, test, and debug native applications for Android, you will have to install Android Studio separately.
For testing Cordova applications on Android, Visual Studio Installer can optionally install the following components:
The software components needed to support iOS development are installed through a separate process executed on a Apple Mac. See Visual Studio Tools for Apache Cordova: iOS Guide for installation details.
Having trouble with the installation? Search for results based on error messages you received during installation or post questions based on your issue on Stack Overflow.
During installation, and later, as Visual Studio interacts with a Cordova project, multiple software components are downloaded and installed in your development environment. See Third-Party Tools Added During Installation for details. If component downloads fail, check your internet connectivity and your connection proxy settings to ensure Visual Studio can access the online resources it needs.
The installer attempts to isolate the software components it uses from other copies you may have installed on your system, but there could be conflicts based on how your system is configured. Check your system's
PATH environment variable to ensure that other components aren't loading before the ones installed by Visual Studio. For comprehensive guide to configuring Visual Studio Tools for Apache Cordova and all of the third-party dependencies, see Configure the Visual Studio Tools for Apache Cordova.
Did you find this article helpful?
We're sorry to hear that! Feel free to email our team with your question.