在 Android 上运行你的 Apache Cordova 应用

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

在 Android 上有很多选项来运行你使用适用于 Apache Cordova 的 Visual Studio 工具创建的应用程序。 在 Visual Studio 中,你可以在以下仿真器和设备上运行和调试 Android 应用:

配置一个高性能仿真器

如果你有一台带 Intel 处理器的计算机,你可以提升 Android 和 Genymotion 仿真器的性能。 若要配置一个高性能仿真器:

  1. 禁用 Hyper-V。 你可以按照以下过程所述来从“控制面板”或命令行中禁用 Hyper-V。

    警告

    禁用 Hyper-V 后,你将无法使用 Windows Phone 仿真器。但你仍可以部署到 Windows Phone 设备。

  2. (仅针对 Android 仿真器)如果尚未安装高性能 Intel 硬件加速执行管理器 (HAXM) 驱动程序,请安装。 (有关 HAXM 驱动程序的详细信息)

  3. 配置 Android 仿真器以使用硬件加速。

若要在“控制面板”中禁用 Hyper-V

  1. 在“控制面板”中依次选择“程序和功能”和“打开或关闭 Windows 功能”。

  2. 取消选中 Hyper-V 的复选框。

    禁用 Hyper-V

  3. 重启你的计算机。

    现在可以安装 HAXM 驱动程序了。

或者你可以使用命令行来配置 Windows 在启动时自动启用或禁用 Hyper-V。

若要使用命令行来禁用 Hyper-V

  1. 打开提升的命令提示符(带有管理凭据),然后输入:

    bcdedit /set hypervisorlaunchtype off
    

    警告

    错误执行 bcdedit 命令会让你的系统无法启动;在使用这些命令时要小心。

    如果你正在将此命令添加到外壳脚本,请使用以下作为代替:

    bcdedit /set hypervisorlaunchtype off
    shutdown /r
    
  2. 重启你的计算机。

    如果你想在以后重新启用 Hyper-V,请使用以下命令,然后重启你的计算机:

    bcdedit /set hypervisorlaunchtype auto
    

如果你正在使用 Genymotion 仿真器,则可跳过此过程。 有关更多信息,请参见 Genymotion 仿真器。

若要安装高性能 HAXM 驱动程序(仅限 Android 仿真器)

  1. 禁用 Hyper-V 并重启后,请打开 Android SDK 管理器。 要从命令行执行该操作, 请转到 SDK 的位置并输入 android。

    在 Windows 中,Android SDK Manager.exe 安装在以下位置:C:\Program Files (x86)\Android\android-sdk。

  2. 在 Android SDK 管理器中的“附加程序”下找到 Intel x86 仿真器加速器(HAXM 安装程序)。 如果状态栏显示尚未安装此加速器,请选中其复选框,然后选择“安装程序包”。

    安装 HAXM 驱动程序

  3. 进入 sdk-path\extras\intel\Hardware_Accelerated_Execution_Manager 并运行 intelhaxm.exe 以安装驱动程序。

    提示

    如果该路径中没有“intel”这一部分,则驱动程序没有安装。

    现在你可以配置一个仿真器来使用驱动程序。 在创建或编辑仿真器时必须使用 Intel CPU 并选择“使用主机 GPU”选项。 有关更多信息,请参见下一节。

Android 仿真器

若要在 Visual Studio 中的 Android 仿真器上运行应用,请先使用 Android 虚拟设备 (AVD) 管理器来创建一个仿真器配置,然后从 AVD 管理器中启动仿真器。 下列步骤演示如何执行此操作。 有关详细信息,请参阅 AVD 管理器文档

若要创建仿真器的一个实例

  1. 打开 AVD 管理器。 要从命令行执行该操作, 请转到 SDK 的位置并输入 android avd。

    在 Windows 中,AVD Manager.exe 安装在以下位置:C:\Program Files (x86)\Android\android-sdk。

  2. 在 AVD 管理器中选择“新”。

  3. 配置新仿真器的属性。

    需要的属性是“AVD 名称”、“设备”、“目标”、“CPU/ABI”和“皮肤”。 “目标”表示已安装的 Android SDK 版本(API 集)。 将此属性设为“API Level 19”。

    创建 Android 仿真程序

  4. 如果你安装了上一节中的高性能 HAXM 驱动程序并选择了 Intel CPU,请在仿真器选项中选中使用主机 GPU复选框。

    重要

    若要使用高性能仿真器,你还必须从 AVD 对话框的“CPU/ABI”部分中选择一个 Intel 处理器。

  5. 选择“确定”以关闭配置对话框,然后在显示所有仿真器设置的对话框中再次选择“确定”。

  6. 在 AVD 管理器中选择新仿真器,然后选择“启动”。

若要在仿真器上运行应用

  1. 当你的应用在 Visual Studio 中打开时,请从“解决方案平台”列表中选择“Android”。 如果你没有看见此选项,请从“添加/删除按钮”列表中选择“解决方案平台”。

  2. 在设备列表中选择“Android 仿真器”。

    部署到 Android 仿真程序

  3. 按下 F5 启动应用,或按下 Shift+F5 来在不进行调试的情况下启动应用。

    需要使用 Android 4.4 才能附加调试器。 否则应用会在不进行调试的情况下运行。

    提示

    • 如果发生错误并且该错误告诉你需要安装新版本的 Android SDK,请使用 Android SDK Manager 来进行安装。对于 Windows,SDK Manager.exe 安装在 C:\Program Files (x86)\Android\android-sdk 中。

    • Visual Studio 将应用部署在正在运行的 Android 仿真器上。如果当前没有正在运行的仿真器,则 Visual Studio 会启动使用 AVD 管理器创建的上一个仿真器,然后再部署应用。

    • 如果你想针对 Android 4.1.2-4.3 版本来调试你的应用,请参阅《调试你使用适用于 Apache Cordova 的 Visual Studio 工具创建的应用》一文中有关 jsHybugger 插件的信息。

Genymotion 仿真器

Genymotion 仿真器经常用来替代 Android 仿真器,Genymotion 仿真器中包含 Android SDK。 以下是针对使用该仿真器的一些提示:

  • 如果你无法从远程连接设备上启动仿真器,请尝试从本地启动,然后在必要时重新进行远程连接。 仿真器需要使用 OpenGL 以进行呈现,而这可能会在启动仿真器时导致冲突。

  • 你需要安装支持 OpenGL 的视频卡和视频卡驱动程序。 你可能会收到指明此情况的消息。 (如果你远程连接到你的计算机,你也可能会看见此消息。 在进行本地连接后重试。)

  • 你在尝试启动仿真器时可能会收到要你检查 VirtualBox 网络配置的消息。 跟随链接并遵守指示以从 VirtualBox 中修改或删除“仅用于主机的网络适配器”。 (VirtualBox 中安装了仿真器。)

  • 对于使用 Genymotion 的高性能仿真器,要按照之前配置高性能仿真器中所述在启动仿真器之前禁用 Hyper-V。

Android 开发者工具将 Genymotion 视为物理设备。 在使用 Visual Studio 运行应用时指示 Visual Studio 将该应用部署到 Android 设备中。

若要在 Genymotion 仿真器上运行应用

  1. 启动 Genymotion 仿真器。

  2. 当你的应用在 Visual Studio 中打开时,请从“解决方案平台”列表中选择“Android”。 如果你没有看见此选项,请从“添加/删除按钮”列表中选择“解决方案平台”。

  3. 在设备列表中选择“设备”。

    部署到 Android 设备

  4. 按下 F5 启动应用,或按下 Shift+F5 来在不进行调试的情况下启动应用。

Android 设备

若要使用 Visual Studio 在连接的 Android 设备上运行应用,你必须先安装所需的驱动程序:

你还必须确保设备处于开发者模式中。 请参阅 Android 网站上的使用硬件设备页面中的“启用设备上的开发者选项”和“设置用于开发的设备”来获取指示。

若要部署你的应用的发行或分发配置,你必须先对你的应用进行签名。 有关详细信息,请参阅将用 Visual Studio Tools for Apache Cordova 生成的应用打包

若要在 Android 设备上运行你的应用

  1. 确保你已经安装了所需的 OEM 或 Google USB 驱动程序。

  2. 确保你的 Android 设备处于开发者模式(请参阅 Android 网站上的使用硬件设备)。

  3. 当你的应用在 Visual Studio 中打开时,请从“解决方案平台”列表中选择“Android”。 如果你没有看见此选项,请从“添加/删除按钮”列表中选择“解决方案平台”。

  4. 在设备列表中选择“设备”。

    部署到 Android 设备

  5. 按下 F5 启动应用,或按下 Shift+F5 来在不进行调试的情况下启动应用。

  6. 在出现提示时选择“允许 USB 调试”。

请参见

概念

安装 Visual Studio Tools for Apache Cordova

调试用 Visual Studio Tools for Apache Cordova 生成的应用

将用 Visual Studio Tools for Apache Cordova 生成的应用打包

其他资源

FAQ