安装 Visual Studio Tools for Apache Cordova

  • 项目

这篇文章介绍了用于 Apache Cordova 的 Visual Studio 工具，是一个预发布的软件。所述功能呈现在预览版中，并可能会发生更改。你可以从 Microsoft 下载中心下载预览版。

本文叙述了如何安装使用适用于 Apache Cordova 的 Visual Studio 工具创建跨平台 Cordova 应用所需的工具和第三方依赖项：

要求
获取工具
安装工具
手动安装依赖项
安装针对 iOS 的工具
替代系统环境变量

要求

  • 以下操作系统之一：Windows 7、Windows 8、Windows 8.1 或 Windows Server 2012 R2。

    重要

    如果你正在使用 Windows 7，那么你可以为 Android 和 iOS 开发应用，但不能为 Windows 或 Windows Phone 开发应用。

  • 安装了以下功能的 Visual Studio 2013 Update 4（专业版、旗舰版、高级版或社区版）：

    • 用于维护 Windows 8 应用商店应用的工具

    • Windows Phone 8.0 SDK

      你可以将这些功能添加到现已安装的 Visual Studio 2013 Update 4。 在“控制面板”中选择“程序和功能”。 从列表中选择“Visual Studio 2013”，然后选择“更改”。 在 Visual Studio 设置窗口中选择“修改”。 在功能列表中选择两个选项，如插图所示。

      安装 Visual Studio 可选功能

  • 如果使用的是 Visual Studio 2015 预览版，而不是 Visual Studio 2013，请参阅本主题中的安装过程。

若要为特定的设备平台创建应用，还需要满足一些附加要求：

获取工具

要获得适用于 Apache Cordova 扩展的 Visual Studio 工具，请转到Microsoft 下载中心。 执行下节中的步骤来安装扩展。

重要

如果你之前安装了适用于 Apache Cordova 的 Visual Studio 工具（多设备混合应用）的 CTP，在安装 Visual Studio 2013 Update 4 和当前 CTP 之前，你必须先使用控制面板、程序和功能卸载 CTP。

在 Visual Studio 2015 预览版中，适用于 Apache Cordova 的 Visual Studio 工具可以在安装期间作为可选功能安装。 关于安装过程，请参阅Get started with Visual Studio Tools for Apache Cordova（适用于 Apache Cordova 的 Visual Studio 工具入门）。

安装工具

安装程序会先安装一个 Visual Studio 的补丁来支持 Cordova 应用开发。 然后它会让你选择是否要安装以下第三方软件。 这些大部分都是特定平台或 Apache Cordova 所需要的开源软件。

  • Joyent Node.js 让 Visual Studio 能与 Apache Cordova 命令行界面 (CLI) 和 Apache Ripple 仿真器集成在一起。

  • 只有在你需要为特定的 Cordova 插件手动添加 Git URI 时才需要使用 Git CLI。

  • 只有使用 Google Chrome 才能在 iOS 和 Android 上运行 Apache Ripple 仿真器。

  • Android 生成过程需要用到 Apache Ant 1.8.0 或更高版本。

  • Android 生成过程需要用到 Oracle Java JDK 7。

  • Android 生成过程和 Ripple 需要用到 Android SDK。

  • 需要使用 Windows 运行时的 SQLite 才能将 SQL 连接性添加 Windows 应用（用于 WebSQL Polyfill 插件）。

  • 需要使用 Apple iTunes 才能将应用部署到连接到你的 Windows 计算机上的 iOS 设备。

若要安装 Visual Studio 扩展和依赖项

  1. 运行你在获取工具中找到的安装程序。

  2. 按照指示来安装 Visual Studio 扩展。

  3. 出现提示后，请允许安装程序安装第三方软件依赖项，或者可以清空软件选项并手动安装以后要使用的依赖项。

    重要

    如果你的系统中已经有第三方依赖项或者你选择手动安装第三方依赖项，那么你可能需要更新你的系统路径。请参阅手动安装依赖项。

    选择要安装的第三方软件

  4. 重新启动计算机。

    重要

    你必须重启以确保所有软件都得到了正确安装。

  5. 打开 Visual Studio，然后依次选择“工具”、“扩展和更新”和“更新”。 如果存在可用于 Visual Studio Tools for Apache Cordova 的 Visual Studio 更新，请安装。

    备注

    你在安装工具后首次创建应用时，Visual Studio 会下载并安装 Cordova 工具。所以首次创建需要花费更多的时间。检查“输出”窗口来查看进度。

  6. 若要在 iOS 模拟器或 iOS 设备上运行应用，你必须先在一台 Mac 计算机上安装远程代理。 请参阅安装工具以创建针对 iOS 的应用。

手动安装依赖项

如果你选择不安装一个或多个带扩展的依赖项，你可以在以后手动安装。

警告

你可以按照任何顺序安装依赖项（不包括 Java）。必须先安装并配置 Java 才能安装 Android SDK。

阅读以下信息并使用这些链接来手动安装依赖项。

  • Joyent Node.js

    推荐安装 x86 版本的 Node.js。

  • Google Chrome

  • Git 命令行工具

    在安装 Git 命令行工具时选择将 Git 添加到你的命令提示符路径这一选项。

    警告

    默认安装 Git 命令行工具 1.9.3。如果你安装 1.9.0 之前的版本，则可能发生意外失败。

  • Apache Ant

    • 下载 Ant 并将其解压到 C:/ant-1.x.x 之类的位置

    • 将 ANT_HOME 环境变量设置为指向之前的位置。

    • 将 %ANT_HOME%\bin 添加到系统路径。

      备注

      如果需要手动设置此环境变量，请参阅重写系统环境变量。

  • Oracle Java 7

    • 将 JAVA_HOME 环境变量设置为 C:/Program Files/Java/jdk1.7.0_55

    • 将此项添加到系统路径：%JAVA_HOME%\bin

      备注

      如果需要手动设置此环境变量，请参阅重写系统环境变量。

  • 带 SDK 程序包的 Android SDK：

    • Android SDK 工具（最新版本）

    • Android SDK 平台工具（最新版本）

    • Android SDK 构建工具（最新版本）

    • 带以下程序包的 Android 4.4.x（API 级别 19）：

      • SDK 平台

      • ARM EABI v7a 系统映像

      • Intel x86 Atom 系统映像

      • Google API（x86 系统映像）

      • Google API（ARM 系统映像）

    下面的插图显示了 Android SDK 管理器中所需的程序包。

    Android SDK 的所需包

    将 ADT_HOME 环境变量设置为 SDK 安装位置。

    将此项添加到系统路径：%ADT_HOME%\tools;%ADT_HOME%\platform-tools

    如果需要手动设置此环境变量，请参阅重写系统环境变量。

    提示

    如果你将 Android SDK 安装到 Windows 上的默认位置，则会安装到 C:\Program Files (x86)\Android\android-sdk。

  • Apple iTunes (x86、x64)

  • SQLite

  • WebSocket4Net（在 Windows 7 上开发应用时需要使用）

    1. 从 CodePlex 上下载 WebSocket4Net(0.9).Binaries.zip。

    2. 从下载的 zip 文件中将 net45\Release\WebSocket4Net.dll 复制到你计算机上的 %ProgramFiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE\CommonExtensions\Microsoft\WebClient\Diagnostics\ToolWindows 文件夹中。

安装针对 iOS 的工具

还需要执行额外的几个步骤才能在 Visual Studio 中创建并运行针对 iOS 的应用。 请参阅安装工具以创建针对 iOS 的应用。

替代系统环境变量

Visual Studio 会检测你安装的第三方软件的配置，并且会维护下列环境变量中的安装路径：

  • ADT_HOME 指向 Android 安装路径。

  • ANT_HOME 指向你计算机上的 Ant 文件夹。

  • GIT_HOME 指向 Git 安装路径。

  • JAVA_HOME 指向 Java 安装路径。

Visual Studio 在创建并运行你的应用时会使用这些环境变量。 你可以通过 Visual Studio“选项”对话框来查看环境变量并修改它们的值。 出于以下某个原因，你可能会想要替代默认设置：

  • Visual Studio 无法验证路径。 此时环境变量的旁边会显示一个警告。

  • 你已经安装了该软件的多个版本，而你只想用一个版本。

  • 你想让你的全局环境路径与本地 Visual Studio 环境的路径不同。

若要替代该变量

  1. 在 Visual Studio 菜单栏上依次选择“工具”和“选项”。

  2. 在选项对话框中，选择 适用于 Apache Cordova 的工具，然后选择环境变量替代。

  3. 进行更改：

    • 若要替代某个值，请选中其复选框，然后修改该值。

      如果路径信息无效或丢失，则 Visual Studio 会在相应的变量旁显示警告。

    • 若要将环境变量重置为默认值，请取消选中其复选框或选择“重置为默认”。

  4. 选择“确定”以保存你的更改并关闭对话框。

环境变量，警告消息

手动更新 Cordova 版本

Visual Studio 已经测试了 Apache Cordova 的特定版本。 我们打算在每个项目层支持选择 Cordova 版本，但即使现在也可以应用补丁以在你的系统的所有项目中使用不同版本的 Cordova。

警告

官方不支持修补 Visual Studio。你可能会遇到意想不到的行为，我们只建议高级用户采取这些步骤。补丁使你的机器发生全系统的变化。

要更新 Visual Studio 以使用不同版本的 Cordova

  1. 在你安装了适用于 Cordova 的 Visual Studio 工具后，创建和构建一个空白项目来安装 Cordova。

  2. 打开一个命令行并键入此命令：

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

    如果你自己安装了 Node.js，vs-mda 可以安装在不同的位置。 前面的命令显示了默认的安装位置。

  3. 在命令行中键入此命令：

    npm install cordova@version --save

    其中版本是你想使用的 Cordova CLI 版本。 例如，可以使用 4.1.0.

    如果你在其它地方安装了 Cordova，你可以输入cordova --version查看 Cordova 版本。

    重要

    当你运行前面的安装命令时一定要忽略 -g全局开关。

  4. 在你正在 Visual Studio 中编辑的项目中运行“清理”操作，如清理解决方案，使版本变更生效。

要恢复为支持的 Cordova 版本

  • 打开一个命令提示符窗口，并键入：

    npm uninstall -g vs-mda

    在下次你构建时 Visual Studio 会自动重新安装 vs-mda。

    或者，你可以在 C:\Program Files (x86)\Microsoft Visual Studio 12.0\Common7\IDE\Extensions 路径下搜索 vs-mda 文件并修改 package.json 以参考你想要使用的版本。 当你修改 package.json 完成后，从相同的文件夹中运行以下命令：

    npm install -g vs-mda

对于你的 Mac 上的 iOS 构建支持，vs-mda-remote 使用的 Cordova 版本必须匹配你为 Visual Studio 安装的版本。 下面的步骤描述了如何更新 vs-mda-remote 以使用特定版本的 Cordova。 有关安装 iOS 构建工具的完整信息，请参阅 安装工具以创建针对 iOS 的应用。

要把你的 Mac 上的 vs-mda-remote 更新为不同版本的 Cordova

  1. 打开你的 Mac 上的终端应用程序，键入以下命令：

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

    如果尚未安装全局 vs-mda-remote (-g)，则 Mac 上的 vs-mda-remote 的位置可能不同。

  2. 输入此命令：

    sudo npm install cordova@version --save

    其中的版本与你之前安装的 Cordova CLI 版本相同。 例如，这可能是 4.1.0。

    重要

    当你运行前面的安装命令时一定要忽略 -g全局开关。

    如果你在其它地方安装了 Cordova，你可以输入cordova --version查看 Cordova 版本。

    在你正在 Visual Studio 中编辑的项目中运行“清理”操作，如清理解决方案，使版本变更生效。

要把你的 Mac 上的 vs-mda-remote 恢复为支持的版本

  1. 打开你的 Mac 上的终端应用并输入：

    sudo npm uninstall -g vs-mda-remote

  2. 键入以下命令：

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

    

请参见

概念

安装工具以创建针对 iOS 的应用

其他资源

下载工具

FAQ

已知问题