Install Visual Studio Tools for Apache Cordova

Visual Studio 2013
 

This article refers to the Visual Studio Tools for Apache Cordova, which is pre-release software. The features described are in preview and are subject to change. You can download the preview from the Microsoft Download Center.

This article describes how to install the tools and third-party dependencies required for creating cross-platform Cordova apps using Visual Studio Tools for Apache Cordova:

Requirements
Getting the tools
Installing the tools
Installing the dependencies manually
Installing tools for iOS
Overriding system environment variables

Requirements

 
  • One of the following operating systems: Windows 7, Windows 8, Windows 8.1, or Windows Server 2012 R2.

    Important

    If you are using Windows 7, you can develop apps for Android and iOS, but not for Windows or Windows Phone.

  • Visual Studio 2013 Update 4 (Professional, Ultimate, Premium, or Community Edition) with the following features installed:

    • Tools for Maintaining Store apps for Windows 8

    • Windows Phone 8.0 SDK

      You can add these features to an existing installation of Visual Studio 2013 Update 4. In Control Panel, choose Programs and Features. Select Visual Studio 2013 from the list, and then choose Change. In the Visual Studio setup window, chooseModify. In the features list, select the two options, as shown in the illustration.

  • If you are using Visual Studio 2015 Preview instead of Visual Studio 2013, see the installation procedure in this topic.

To build apps for specific device platforms, there are a few additional requirements:

Get the tools

 

To get the Visual Studio Tools for Apache Cordova extension, go to the Microsoft Download Center. Follow the steps in the next section to install the extension.

Important

If you previously installed a CTP of the Visual Studio Tools for Apache Cordova (Multi-Device Hybrid Apps), you must first uninstall the CTP using Control Panel, Programs and Features before installing the Visual Studio 2013 Update 4 and the current CTP.

In Visual Studio 2015 Preview, Visual Studio Tools for Apache Cordova can be installed as an optional feature during installation. For the installation procedure, see Get started with Visual Studio Tools for Apache Cordova.

Install the tools

 

The installer first installs a patch to Visual Studio to support Cordova app development. Then it gives you the option to install the following third-party software. Most of these are open-source software required by specific platforms or by Apache Cordova.

  • Joyent Node.js enables Visual Studio to integrate with the Apache Cordova Command Line Interface (CLI) and Apache Ripple Emulator.

  • Git CLI is required only if you need to manually add Git URIs for specific Cordova plug-ins.

  • Google Chrome is required to run the Apache Ripple emulator for iOS and Android.

  • Apache Ant 1.8.0 or later is required for the Android build process.

  • Oracle Java JDK 7 is required for the Android build process.

  • Android SDK is required for the Android build process and Ripple.

  • SQLite for Windows Runtime is required to add SQL connectivity to Windows apps (for the WebSQL Polyfill plugin).

  • Apple iTunes is required for deploying an app to an iOS device connected to your Windows PC.

To install the Visual Studio extension and dependencies

  1. Run the installer that you found in Get the tools.

  2. Follow the instructions to install the Visual Studio extension.

  3. When prompted, allow the installer to install third-party software dependencies, or you can clear the software selections and manually install the dependencies you need later.

    Important

    If the third-party dependencies are already on your system or you choose to install them manually, you might have to update your system path. See Installing dependencies manually.

  4. Reboot your computer.

    Important

    You must reboot to make sure everything is installed correctly.

  5. Open Visual Studio, choose Tools, then Extensions and Updates, and then Updates. If there is a Visual Studio update available for Visual Studio Tools for Apache Cordova, install it.

    Note

    The first time you build an app after installing the tools, Visual Studio will download and install the Cordova tools. As a result, the first build takes extra time to complete. Check the Output window to see progress.

  6. Before you run your app on the iOS Simulator or an iOS device, you must install the remote agent on a Mac computer. See Install Tools to Build for iOS.

Install dependencies manually

 

If you choose not to install one or more dependencies with the extension, you can install them later manually.

Caution

You can install the dependencies in any order, except for Java. You must install and configure Java before you install the Android SDK.

Read the following information and use these links to install dependencies manually.

  • Joyent Node.js

    We recommend installing the x86 version of Node.js.

  • Google Chrome

  • Git Command Line Tools

    When you install Git command line tools, select the option that adds Git to your command prompt path.

    Caution

    Git command line tools 1.9.3 are installed by default. Unexpected failures may occur if you install a version prior to 1.9.0.

  • Apache Ant

    • Download and extract Ant to a location like C:/ant-1.x.x

    • Set the ANT_HOME environment variable to point to the preceding location.

    • Add %ANT_HOME%\bin to the system path.

      Note

      If you need to set this environment variable manually, see Override system environment variables.

  • Oracle Java 7

    • Set the JAVA_HOME environment variable to C:/Program Files/Java/jdk1.7.0_55

    • Add this to the system path: %JAVA_HOME%\bin

      Note

      If you need to set this environment variable manually, see Override system environment variables.

  • Android SDK with the following SDK packages:

    • Android SDK Tools (latest version)

    • Android SDK Platform-tools (latest version)

    • Android SDK Build-tools (latest version)

    • Android 4.4.x (API level 19) with the following packages:

      • SDK Platform

      • ARM EABI v7a System Image

      • Intel x86 Atom System Image

      • Google APIs (x86 System Image)

      • Google APIs (ARM System Image)

    The following illustration shows the required packages in the Android SDK Manager.

    Set the ADT_HOME environment variable to the SDK installation location.

    Add this to the system path: %ADT_HOME%\tools;%ADT_HOME%\platform-tools

    If you need to set this environment variable manually, see Override system environment variables.

    Tip

    If you install the Android SDK to its default location on Windows, it gets installed to C:\Program Files (x86)\Android\android-sdk.

  • Apple iTunes (x86x64)

  • SQLite

  • WebSocket4Net (required if you’re developing your app on Windows 7)

    1. Download WebSocket4Net(0.9).Binaries.zip from CodePlex.

    2. From the downloaded zip file, copy net45\Release\WebSocket4Net.dll into the %ProgramFiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE\CommonExtensions\Microsoft\WebClient\Diagnostics\ToolWindows folder on your computer.

Install tools for iOS

 

A few extra steps are required to build and run apps for iOS from Visual Studio. See Install Tools to Build for iOS.

Override system environment variables

 

Visual Studio detects the configurations for the third-party software you’ve installed, and maintains the installation paths in the following environment variables:

  • ADT_HOME points to the Android installation path.

  • ANT_HOME points to the Ant folder on your computer.

  • GIT_HOME points to the Git installation path.

  • JAVA_HOME points to the Java installation path.

Visual Studio uses these environment variables when building and running your app. You can view the environment variables and revise their values through the Visual Studio Options dialog box. You might want to override the default settings for one of the following reasons:

  • Visual Studio was unable to verify the path. In this case, a warning is displayed next to the environment variable.

  • You have multiple versions of the software installed, and you’d like to use a specific version.

  • You want your global environment path to be different from the local Visual Studio environment.

To override the variables

  1. On the Visual Studio menu bar, choose Tools, Options.

  2. In the Options dialog box, choose Tools for Apache Cordova, and then choose Environment Variable Overrides.

  3. Make your changes:

    • To override a value, select its check box, and then revise the value.

      If the path information is invalid or missing, Visual Studio displays a warning next to that variable.

    • To reset an environment variable to its default value, clear its check box or choose Reset to Default.

  4. Choose OK to save your changes and close the dialog box.

Manually updating the Cordova version

 

Visual Studio has been test against a specific version of Apache Cordova. We intend to support selecting a Cordova version at a per-project level, but even now it is possible to apply a patch to use a different version of Cordova across all projects on your system.

Caution

Patching Visual Studio is not officially supported. You may run into unexpected behaviors and we recommend that only advanced users take these steps. The patch makes system-wide changes to your machine.

To update Visual Studio to use a different version of Cordova

  1. After you install Visual Studio Tools for Cordova, create and build a blank project to install Cordova.

  2. Open a command line and type this command:

     
     
    cd %appdata%\npm\node_modules\vs-mda\
    

    If you installed Node.js yourself, vs-mda may be installed in a different location. The preceding command shows the default installation location.

  3. On the command line, type this command:

     
     
    npm install cordova@version --save
    

    where version is the version of the Cordova CLI that you want to use. For example, you might use 4.1.0.

    If you've installed Cordova somewhere else, you can type cordova --version to find out the Cordova version.

    Important

    Be sure to omit the -g global switch when you run the preceding install command.

  4. Run a "clean" operation such as Clean Solution on the project you are editing in Visual Studio to make the version change take effect.

To revert to the supported version of Cordova

  • Open a command prompt and type:

     
     
    npm uninstall -g vs-mda
    

    Visual Studio will automatically reinstall vs-mda the next time you build.

    Alternatively, you can search for the vs-mda file under C:\Program Files (x86)\Microsoft Visual Studio 12.0\Common7\IDE\Extensions and modify package.json to refer to the version you would like to use. When you are finished modifying package.json, run the following command from same folder:

     
     
    npm install -g vs-mda
    

For iOS build support on your Mac, the version of Cordova that vs-mda-remote uses must match the version that you installed for Visual Studio. The following steps describe how to update vs-mda-remote to use a specific version of Cordova. For complete information on installing iOS build tools, see Install Tools to Build for iOS.

To update vs-mda-remote on your Mac to a different version of Cordova

  1. Open the Terminal app on your Mac and type the following command:

     
     
    cd /usr/local/lib/node_modules/vs-mda-remote
    

    If you did not install vs-mda-remote globally (-g) the location of vs-mda-remote may be different on your Mac.

  2. Type this command:

     
     
    sudo npm install cordova@version --save
    

    where version is the same version of the Cordova CLI you installed previously. For example, this might be 4.1.0.

    Important

    Be sure to omit the -g global switch when you run the preceding install command.

    If you installed Cordova somewhere else, you can type cordova --version to find out the Cordova version.

    Run a "clean" operation such as Clean Solution on the project you are editing in Visual Studio to make the version change take effect.

To revert vs-mda-remote on your Mac to the supported version

  1. Open the Terminal app on your Mac and type:

     
     
    sudo npm uninstall -g vs-mda-remote
    
  2. Type the following command:

     
     
    sudo npm install -g vs-mda-remote --save
    

Install Visual Studio Tools for Apache Cordova的更多相关文章

  1. 配置 Visual Studio Tools for Apache Cordova

    原文:配置 Visual Studio Tools for Apache Cordova 1.连接地址 https://msdn.microsoft.com/zh-cn/library/vs/alm/ ...

  2. Visual Studio 2015 和 Apache Cordova 跨平台开发入门(一)

    基于 Windows 10 的 Visual Studio 2015 跨平台的应用开发主要分为基于Visual Studio 安装 Xamarin 扩展的跨Android.iOS 和 Windows的 ...

  3. Visual Studio 2015 和 Apache Cordova 跨平台开发入门

    原文:Visual Studio 2015 和 Apache Cordova 跨平台开发入门(一) 基于 Windows 10 的 Visual Studio 2015 跨平台的应用开发主要分为基于V ...

  4. Visual Studio 2017 and Apache Cordova mobile apps | Andrés Zsögön

    原文:Visual Studio 2017 and Apache Cordova mobile apps | Andrés Zsögön 以下是使用Microsoft Visual Studio 20 ...

  5. Visual Studio 2015 和 Apache Cordova

    英文原版:http://www.codeproject.com/Articles/860150/Visual-Studio-and-Apache-Cordova 在开始前,问一下自己下面这些问题: 熟 ...

  6. 在 Visual Studio中 使用Apache Cordova 开发安卓、iOS程序(自定义图标和闪屏)

    方法1 1台安装有linux的电脑,虚拟机也行,并安装imagemagick软件包.我用的是linux mint,直接在软件管理器中安装即可 把https://github.com/shamork/c ...

  7. 跟我从零基础学习Unity3D开发--Unity3D开发必备神器(Visual Studio Tools for Unity)

    开发Unity3D程序你用的什么IDE呢? 1.MonoDevelop 2.VS 可能你的回答是这样的,我用的vs写代码MonoDevelop来做调试.这时有同学就会反驳了傻X不知道用unityVS吗 ...

  8. 【转】UnityVS(Visual Studio Tools For Unity)的安装与使用

    Unity 的开发者们,尤其是微软系的Unity开发者们,用Mono是不是烦死了?你是不是跟我一样,用vs来写代码,用Mono来跟踪调试?好麻烦啊好麻烦. 也许你会说,傻逼你不会用UnityVS插件么 ...

  9. UnityVS(Visual Studio Tools For Unity)的安装与使用

    首选微软的官方博客地址:http://blogs.msdn.com/b/visualstudio/archive/2014/07/29/visual-studio-tools-for-unity-1- ...

随机推荐

  1. Django 和 html

    下面是对应的形式,自定义的forms

  2. Docker应用系列(二)| 构建Zookeeper集群

    本示例基于Centos 7,在阿里云的三台机器上部署zookeeper集群,假设目前使用的账号为release,拥有sudo权限. 由于Docker官方镜像下载较慢,可以开启阿里云的Docker镜像下 ...

  3. 【JAVAWEB学习笔记】19_事务概述、操作、特性和隔离级别

    事务 学习目标 案例-完成转账 一.事务概述 1.什么是事务 一件事情有n个组成单元 要不这n个组成单元同时成功 要不n个单元就同时失败 就是将n个组成单元放到一个事务中 2.mysql的事务 默认的 ...

  4. Linux中磁盘还有空间,但创建文件时提示空间不足

    首先需要知道创建文件时,需要满足两个条件:1.磁盘上还有空间:2.inode号还有剩余. 这两个条件可以分别使用"df -h"以及"df -i"查看使用情况 [ ...

  5. Am335x u-boot 启动过程中的系统频率配置

    Am335x的时钟结构分为:ADPLLS和ADPLLLJ 1.ADPLLS用来配置Core_CLK,Dispaly_clk,ARM系统CLK(mpu_clk),DDR PLLs_clk 2.ADPLL ...

  6. Unity 游戏开发技巧集锦之材质的应用的创建反射材质

    Unity 游戏开发技巧集锦之材质的应用的创建反射材质 Unity中材质的应用 游戏中,大多数材质的应用都离不开纹理,而纹理本身是图片.所以,在学习本章时,最好在电脑上安装一个可以编辑图片的功能强大的 ...

  7. POJ1226 Substrings

    后缀数组. 求多个字符串翻转与否中最长公共子串长. 二分答案,反过来多建一倍的字符串,二分时特判一下即可. By:大奕哥 #include<cstring> #include<cst ...

  8. MySql - GROUP BY 和 HAVING关键字

    本文主要针对GROUP BY 和 HAVING两个关键字进行分析 使用测试表如下: 测试前,只知道GROUP BY 这个关键字的作用是根据一个字段进行分组,去重.HAVING对分组设置条件. 具体分组 ...

  9. Jquery实战——横纵向的菜单

    横纵向的菜单效果,点击纵向菜单显示其子菜单.鼠标指向横菜单的时候.显示其子菜单,鼠标离开,子菜单隐藏. HTML代码: <span style="font-size:18px;&quo ...

  10. 简化delegate写法

    标准的写法 空 简化后的宏 /**************************************************************/ // delegate 托付 /* #de ...