Genymotion 用户手册Genymotion 是一个能提供虚拟Android 环境的完整的工具包，对于软件开发和测试人员、销售人员设置是游戏玩家都非常有用。

Genymotion 用户手册

目录

1.概述 .................................................................................................................................................................. 1

2.特点 .................................................................................................................................................................. 1

2.1 最擅长于虚拟 Android ......................................................................................................................... 1

2.2 高可控性 ............................................................................................................................................... 1

2.3 管理你的设备 ....................................................................................................................................... 1

2.4 从 Eclipse 中开启虚拟设备 .................................................................................................................. 2

3.要求 .................................................................................................................................................................. 2

3.1 操作系统要求 ....................................................................................................................................... 2

3.2 系统硬件要求 ....................................................................................................................................... 2

3.3 安装要求 ............................................................................................................................................... 2

4.安装 .................................................................................................................................................................. 2

4.1 注册 ....................................................................................................................................................... 2

4.2 下载和安装 Oracle VirtualBox ............................................................................................................. 3

4.3 下载 Genymotion .................................................................................................................................. 3

4.4 安装 Genymotion .................................................................................................................................. 3

5.快速开始 .......................................................................................................................................................... 4

6.Genymotion 应用 ............................................................................................................................................. 8

6.1 管理窗口 ............................................................................................................................................... 8

6.2 虚拟设备创建窗口 ............................................................................................................................... 9

6.3 云连接窗口 ........................................................................................................................................... 9

6.4 管理员设置窗口 ................................................................................................................................. 10

6.5 虚拟设备设置 ...................................................................................................................................... 11

6.6 开启虚拟设备 ...................................................................................................................................... 11

6.7 运行虚拟设备 ..................................................................................................................................... 12

6.8 电池小工具 ......................................................................................................................................... 13

6.9GPS 小工具 .......................................................................................................................................... 14

7.Eclipse 插件 ................................................................................................................................................... 14

7.1Eclipse 插件安装 .................................................................................................................................. 15

7.2Eclipse 插件使用 .................................................................................................................................. 15

7.3 操作 ..................................................................................................................................................... 16

7.4 虚拟设备状态 ..................................................................................................................................... 17

7.5 使用 Genymotion 测试应用程序 ....................................................................................................... 17

7.6 错误处理 ............................................................................................................................................. 17

8.IntelliJ 插件 .................................................................................................................................................... 17

8.1 插件安装 ............................................................................................................................................. 17

8.2 插件的使用 ......................................................................................................................................... 18

8.3 操作 ..................................................................................................................................................... 20

8.4 虚拟设备状态 ..................................................................................................................................... 20

8.5 使用 Genymotion 测试应用程序 ....................................................................................................... 21


1

8.6 错误处理 ............................................................................................................................................. 21

9.Genymotion Shell ........................................................................................................................................... 21

9.1 命令行参数 ......................................................................................................................................... 21

9.2 可用命令 ............................................................................................................................................. 21

10.安装 ADB ..................................................................................................................................................... 23

译者注： ................................................................................................................................................................... 23

1.概述

Genymotion 是一个能提供虚拟 Android 环境的完整的工具包，对于软件开发和测试人员、销售人员设置是

游戏玩家都非常有用。

Genymotion 在大多数的操作系统下都可以使用：Windows，Linux 和 MacOS X，安装简单，功能很强大。

按照以下的简单步骤，选择一个虚拟设备，开始享受你的虚拟 Android 吧！

2.特点

2.1 最擅长于虚拟 Android

OpenGL 加速器实现最好的 3D 性能

可以从 Google Play 中安装应用

支持全屏、改善用户体验

2.2 高可控性

支持同时开启多个虚拟设备

支持管理多种传感器

电池水平/状态

GPS

加速计

支持使用 Genymotion Shell 直接操控虚拟设备上的传感器

与 ADB 完全兼容，可以从主机直接控制虚拟设备

2.3 管理你的设备

易于安装

兼容 32/64 位的 Windows、MacOS X 10.5+、Linux 32/64

可配置虚拟设备

屏幕分辨率

内存大小


2

CPU 单元数量

轻松下载和部署最新的 Genymotion 虚拟设备

2.4 从 Eclipse 中开启虚拟设备

在 Genymotion 中测试你的应用程序

3.要求

3.1 操作系统要求

你需要如下操作系统运行 Genymotion：

Microsoft Windows XP SP3 (32 or 64 bits)

Microsoft Windows Vista (32 or 64 bits)

Microsoft Windows 7 (32 or 64 bits)

Linux Ubuntu 12.04

Linux Ubuntu 12.10

Mac OS X 10.X

3.2 系统硬件要求

支持 OpenGL 2.0 的显卡，并配有最新的驱动程序

支持 VT-x 或者 AMD-V 的 CPU，并在 BIOS 中开启相应功能

至少 512M 的 RAM

只少 100M 的硬盘空间来安装 Genymotion；Genymotion 中的虚拟设备需要至少 2GB 的剩余空间，也可

能需要多于 8GB 的空间，这取决于虚拟设备的使用率和其安装的应用

Internet 访问（安装和更新）

高于 1024*768 的屏幕分辨率

3.3 安装要求

需要 Oracle VirtualBox 4.1 及以上（高版本更好）

4.安装

4.1 注册

1. 访问 Genymotion register page

2. 填写个人注册信息

https://cloud.genymotion.com/page/customer/login/


3

3. 点击“注册”按钮

4. 收到一封“确认”邮件，点击链接进行确认

5. 收到另一封邮件，表示注册已经完成

4.2 下载和安装 Oracle VirtualBox

如果你的电脑上未安装 Oracle VirtualBox，请阅读以下内容。

Windows

安装 Oracle VirtualBox 的最简单方法是下载包含有 VirtualBox 的 Genymotion 安装包，请点击这里。

Mac OS X

访问 VirtualBox download page 下载页得到 MacOS X dmg 文件，运行文件并按照安装向导进行安装，安

装后重启。

Linux

检查你的软件仓库：VirtualBox 对几乎所有的 GNU/Linux 都会有相应的安装包。如果没有，你需要安装一

个特殊的版本，请访问 VirtualBox download 网站。

4.3 下载 Genymotion

1. 访问 Genymotion 官方下载

2. 根据您的操作系统选择相应的安装包并下载它

4.4 安装 Genymotion

根据您的操作系统，遵循如下安装过程。

Windows

双击下载的 msi 安装包

选择安装语言（Genymotion 语言取决于操作系统的语言），点击“下一步”

再一次点击“下一步”

按需更改安装路径(the default path is C:\Program Files\Genymobile\Genymotion) ，点击“下一步”

再一次点击“下一步”

是否创建桌面图标，点击“下一步”

点击“安装”

点击“完成”

Mac OS X

打开 dmg 安装包

将 Genymotion 和 Genymotion shell 移动到应用目录

Linux

在终端中使用如下命令。

chmod +x [INSTALLER_PATH]/genymotion-[VERSION]_[ARCH].bin

cd [INSTALLER_PATH]

./genymotion-[VERSION]_[ARCH].bin

https://cloud.genymotion.com/page/launchpad/download

https://www.virtualbox.org/wiki/Downloads

https://www.virtualbox.org/wiki/Downloads

https://cloud.genymotion.com/page/launchpad/download/


4

5.快速开始

1.运行 Genymotion

Windows

点击桌面图标

Mac OS X

点击应用目录下的图标

Linux

用 [InstallationPath]/genymotion 启动

2.主窗口如下：

3.点击“增加”，出现如下窗口：


5

4.点击“连接”，输入你的用户名和密码后点击“连接”按钮

5.在底部列表中选择一种设备后点击“增加”按钮


6

6. 点击“下一步”

7. 为你的虚拟设备输入名称，然后点击“完成”


7

8.点击“关闭”返回到主窗口

9.点击“Play”


8

6.Genymotion 应用

6.1 管理窗口

Genymotion 的主窗口可以管理所有的虚拟设备

在菜单栏中你可以：

打开已启动的虚拟设备的窗口

增加一个新的虚拟设备

打开/关闭主菜单

点击菜单按钮你可以：

打开设置窗口

打开帮助窗口

打开关于窗口

推出应用程序

你可以使用专用按钮或上下文菜单来：

配置虚拟机的设置（分辨率、DPI、导航键等）

删除虚拟设备


9

6.2 虚拟设备创建窗口

当点击主窗口上的“增加”按钮，将会打开虚拟设备创建窗口

在这个窗口中，你可以从在线设备列表或本地设备列表中选择和创建设备：

上边的列表包含已下载的虚拟设备

下边的列表包含你的账户中可用的设备

6.3 云连接窗口

当第一次打开虚拟设备创建窗口时，将会提示你进行登录


10

6.4 管理员设置窗口

设置 ADB 路径：

在此设置 Android SDK 的安装路径，将会在该目录中自动搜索 ADB 可执行文件。

设置 HTTP 代理：

如果你使用 HTTP 代理，在此设置 FQDN 或 IP 地址。

设置 HTTP 代理的用户名和密码：

如果你的代理需要基本的认证，在此使用用户名和密码进行验证。警告：目前只支持基本认证，不支持 NTLM


11

或 Kerberos。

6.5 虚拟设备设置

在这个窗口中可以配置虚拟设备，例如更改其分辨率、密度等……

预定义屏幕尺寸：

从预定义列表中设置分辨率和密度

自定义屏幕尺寸：

手动设置分辨率和密度。警告：在自定义设置分辨率和密度中可能会遇到错误。

全屏模式运行虚拟机：

可以在全屏模式中开始虚拟机，并会根据你显示器的分辨率调整自己的分辨率。

显示安卓导航栏：

启动虚拟设备与启用安卓导航栏（三个安卓导航键：Back，Home，Recent Application）

6.6 开启虚拟设备

当从主窗口开启一个虚拟设备时，按照以下三个步骤：

1. 设置网络参数和渲染器参数

2. 检查是否开启 CPU 虚拟化（Intel CPU 的虚拟化技术是 VT-X，AMD CPU 的是 AMD-V）。如果不开启 CPU

虚拟化，你的虚拟设备将不支持多处理器管理。这种情况下，虚拟设备的处理器个数将会被自动设置


12

为 1 。

3. 检查虚拟机上的 Genymotion 版本是否和你的 Genymotion软件相兼容。

如果上述三个步骤都成功，那你的虚拟设备就可以正常使用了。

6.7 运行虚拟设备

虚拟机运行的窗口，你可以在此窗口中与虚拟设备进行交互。

Genymotion 小工具快捷键

电池小工具 CTRL+1

GPS 小工具 CTRL+2

控制快捷键

旋转虚拟设备 CTRL+F11

增加声音 CTRL++

减小声音 CTRL+-

最近使用的应用 CTRL+SPACE

后退 CTRL+BACKSPACE

Home CTRL+HOME

电源 CTRL+ESC


13

6.8 电池小工具

该工具可以修改 Genymotion虚拟机的电池电量、电源状态和供电模式。

首先，在右侧的面板按钮中打开电池小工具

激活模拟电池模式

默认时，Genymotion 模拟了一个和你当前电脑使用的相同的电池。这个开关激活自定义值的模拟电池，以

便你可以调整测试你的应用程序。

当你的电脑没有电池时（台式机或类似的），自定义值模拟将会自动开启。

修改电池电量

当模拟电池启用后，可以使用滑块修改虚拟设备的当前电量，或者在相应区域中手动输入想要的值。

修改状态

当模拟电池启用后，可以修改电池的当前状态：

充电：插入交流电，电池处于充电状态

放电：为插入交流电，电池处于放电状态


14

6.9GPS 小工具

GPS 小工具可以实时的激活和修改位置坐标、精度和朝向。

激活 GPS

当你打开 GPS 后，就可以在虚拟设备中接收 GPS 帧。当 GPS 关闭时，不能刷新位置和提供最后一次所使

用的位置。

修改位置

使用经纬度可以指定你当前想要模拟的位置信息。必须是用“度”进行指定，例如维度范围：-90.0○

~90.0○，

经度范围：--180.0○

~180.0○

修改高度

可以自定义设置高度值从-10000m 到 10000m

修改精度

可以使用滑块或者输入想要的精度值，范围是 0~200m

修改朝向

可以使用相应的转盘或输入想要的值来修改方向，范围是 0~359.99○

注意许多应用并不使用 GPS 定位，但是使用加速计或者陀螺仪来检测设备的朝向信息，但目前还不支持该

功能。

7.Eclipse 插件

一个有趣的特点就是你可以用 Genymotion 来测试你用 Eclipse 开发的软件，Genymotion 使用 ADB 连接运行


15

中的虚拟设备，然后将你的软件安装到虚拟设备中。

7.1Eclipse 插件安装

有两种安装插件的方法

1.使用更新网站自动安装

启动 Eclipse

依次点击菜单栏中的“Help-Install New Software…”

在新打开的窗口中点击“Add”（在新打开的窗口的右上方）

填入相应的信息然后进行验证

Name: Genymobile

Location: http://plugins.genymotion.com/eclipse

然后会出现一个名为 Genymobile 的树形图

检查你刚才输入的内容，并点击“Next”

阅读并接受相应条款

Eclipse会警告说该插件没有被签名，尽管这样还是要接受它

完成安装后重启 Eclipse

重启 Eclipse 后在工具栏中会发现新的按钮

最后，通过点击菜单栏的“Help-About-Installation Details”中的“Plug-In”列中将

会看到 Genymotion，这说明你成功安装了它

2.手动安装

确保 Eclipse关闭

通过 Genymotion 官方下载下载插件

按照你的操作系统，参照以下步骤：

Windows

如果你有管理员权限，将 jar 文件放入你 Eclipse 安装目录中的 plugins 文件夹

下

如果没有管理员权限，将 jar文件放入你的 Local Settings\Eclipse\plugins中

Mac OS X

使用管理员权限，将 jar文件放入你 Eclipse 安装目录中的 plugins 文件夹下

Linux

如果你有管理员权限，将 jar 文件放入你 Eclipse 安装目录中的 plugins 文件夹

下

如果没有管理员权限，将 jar文件放入 /home/[user]/Eclipse/plugins下

7.2Eclipse 插件使用

点击工具栏中的图标打开插件

第一次使用插件

1. 需要设置 Genymotion 的安装目录（默认路径只会对标准安装时有效）

Windows: C:\Program Files\Genymobile\Genymotion

MacOS X: /Applications/Genymotion.app

http://plugins.genymotion.com/eclipse



16

Linux: /home/[user]/genymotion

2. 先点击“Apply”，然后点击“OK”

3. 然后重新点击图标开启插件的主窗口，如下图所示

7.3 操作

在插件的主窗口中你可以进行如下操作：

1. 启动一个虚拟设备


17

2. 创建一个新的虚拟设备

3. 刷新虚拟设备列表

“创建”操作将会自动出现 Genymotion 创建向导

7.4 虚拟设备状态

插件主窗口的状态列可以是如下状态

Off：虚拟设备关闭

Paused：虚拟设备已经启动，然后暂停；重启之后也会处于相同状态

On：虚拟设备开启，但并未与 ADB 连接。这意味着你不能在 ADT 插件中的“Android Device Chooser”

选择该虚拟设备

Connected：虚拟设备已启动并与 ADB 连接。这意味着你可以在 ADT 插件中的“Android Device Chooser”


7.5 使用 Genymotion 测试应用程序

1.点击启动或创建一个你想使用的虚拟设备

2.关闭 Genymotion 主窗口

3.右键你的工程文件，选择“Run as Android Application”

4.出现“Android Devices Chooser”窗口

5.点击你启动/创建的虚拟设备

Genymotion-VMNAME-@IP:PORT

其中：VMNAME 是 Genymotion 中虚拟设备名称，@IP:PORT 是 ip 地址和端口（由 ADB 分配）

当重启或意外暂停虚拟设备时，Android Device Chooser 窗口中的显示名称是无关联的。关闭并重新打开

Genymotion 插件会解决这个问题。

7.6 错误处理

当 Genymotion 插件窗口处于打开状态时，将会在 Eclipse 的 console 中打印出相关错误信息。

8.IntelliJ 插件

像 Eclipse 一样，我们也为 IntelliJ（类似 android studio 或 IDEA）提供了一个插件，有了这个插件，你可

以很容易地测试您的应用程序。它采用 ADB 连接到任何运行的 Genymotion 虚拟设备，然后装载你的应用

程序。

8.1 插件安装

安装插件的方式有两种：

1.JetBrains 库方法


18

启动你的 IDE

进入“File/Settings”菜单

在新打开的窗口中，选择“Plugins”，然后点击“Browse repositories...” 按钮（右下方）

在列表中，单击 Genymotion，点击“download and install”按钮（在左上角）

点击“Yes”按钮开始

点击“Close”按钮离开浏览库窗口

点击“OK”按钮离开设置窗口

IntelliJ 要求重新启动，通过点击“Restart”按钮重启

2.手动方法

访问 Genymotion 官方下载下载插件

启动你的 IDE

进入“File/Settings”菜单

在新打开的窗口中，选择“Plugins”，然后点击“install plugin from disk...” 按钮（右下方）

选择 genymotion-IDEA-plugin.jar文件

点击“OK”按钮

IDE 请求重启，“Restart”按钮重新启动

8.2 插件的使用

点击工具栏中的图标打开插件

第一次使用

1. 需要设置 Genymotion 的安装目录（默认路径仅适用于标准安装）：

Windows: C:\Program Files\Genymobile\Genymotion

MacOS X: /Applications/Genymotion.app

Linux: /home/[user]/genymotion



19

2. 点击“OK”按钮

3. 再次点击按钮打开插件主窗口


20

8.3 操作

在插件主窗口中，你可以做以下操作：

1. 启动 Genymotion 虚拟设备

2. 创建一个新的虚拟设备

3. 刷新 Genymotion 虚拟设备列表

“创建”操作，将自动启动创建 Genymotion 虚拟设备向导。

8.4 虚拟设备状态

插件主窗口的状态列可以是如下状态

Off：虚拟设备关闭

Paused：虚拟设备已经启动，然后暂停；重启之后也会处于相同状态

On：虚拟设备开启，但并未与 ADB 连接。这意味着你不能在 ADT 插件中的“Android Device Chooser”


Connected：虚拟设备已启动并与 ADB 连接。这意味着你可以在 ADT 插件中的“Android Device Chooser”



21

8.5 使用 Genymotion 测试应用程序

1.点击启动或创建一个你想使用的虚拟设备

2.关闭 Genymotion 主窗口

3.右键你的工程文件，选择“Run as Android Application”

4.出现“Android Devices Chooser”窗口

5.点击你启动/创建的虚拟设备

Genymotion-VMNAME-@IP:PORT

其中：VMNAME 是 Genymotion 中虚拟设备名称，@IP:PORT 是 ip 地址和端口（由 ADB 分配）

当重启或意外暂停虚拟设备时，Android Device Chooser 窗口中的显示名称是无关联的。关闭并重新打开

Genymotion 插件会解决这个问题。

8.6 错误处理

当 Genymotion 插件窗口处于打开状态时，将会在 Eclipse 的 console 中打印出相关错误信息。

9.Genymotion Shell

Genymotion 提供了 shell，可以让你通过脚本修改传感器状态。

9.1 命令行参数

-h Print help 显示帮助

-r ip_address 连接指定 IP 地址的虚拟设备

-c "command" 在 shell 中执行命令并返回

-f file 执行文件内容

每条命令必须在一行中！

9.2 可用命令

battery getmode

返回选定虚拟设备的电池状态，其可以是：

o host: 虚拟设备的电池反应物理机（主机）的电池状态（如果存在）

o manual: 该状态下可以手动设置电池的电压和状态

battery setmode

设置选定虚拟设备的电池状态，其可以是：

o host: 虚拟设备的电池反应物理机（主机）的电池状态（如果存在）

o manual: 该状态下可以手动设置电池的电压和状态

battery getlevel

返回当前电池剩余的电量，取值范围是 0%~100%。如果电池模式为“host”，则返回主机的电池的

电量。


22

battery setlevel

设置当前电池的电量，取值范围是 0%~100%。

设置电压为“Manual”模式，如果之前模式为“Host”，则会设置成“Manual”模式

battery getstatus

返回当前的电池状态。有 4 个可能的状态：

o 放电：断开电源和电池放电。

o 充电方式：电源连接和电池充电。

o 充满：电池充满。

o 未知：有时不能确定电池状态，可能在主机没有电池时出现。

battery setstatus

设置当前的电池状态。有 4 个可能的状态：

o 放电：断开电源和电池放电。

o 充电方式：电源连接和电池充电。

o 充满：电池充满。

o 未知：有时不能确定电池状态，可能在主机没有电池时出现。

devices list

列出的可用 Genymotion 虚拟设备，并提供当前的详细状态信息，如 IP 地址。

devices ping

发送一个 ping 命令以检测虚拟设备是否响应。

devices refresh

刷新 Genymotion 虚拟设备列表，使列表保持最新。

devices select

选择你想进行交互的虚拟设备。

devices show

列出的可用 Genymotion 虚拟设备，并提供当前的详细状态信息，如 IP 地址。

gps activate

激活 GPS（如果还没激活）。

gps desactivate

关闭 GPS 传感器（如果激活）。

gps getlatitude

返回当前的纬度（如果 GPS 被激活，并且已经有一个纬度）或 0 。

gps setlatitude

设置当前的纬度（如过没激活 GPS，则激活 GPS）。

gps getlongitude

返回当前的经度（如果 GPS 被激活，并且已经有一个纬度）或 0 。

gps setlongitude

设置当前的经度（如过没激活 GPS，则激活 GPS）。

gps getaltitude

返回当前高度（如果 GPS 已激活并得到了高度）或 0 。

gps setaltitude

设置当前的高度（如过没激活 GPS，则激活 GPS）。

gps getaccuracy

以米为单位返回精度 (如果 GPS 已激活并得到了精度) 或 0 。

gps setaccuracy


23

设置当前的精度（如过没激活 GPS，则激活 GPS）。

gps getorientation

以米为单位返回当前方位(如果 GPS 已激活并得到了方位)或 0 。

gps setorientation

设置当前的方位（如过没激活 GPS，则激活 GPS）。

rotation setangle

设置虚拟设备的旋转角度。

android version

返回虚拟设备的 Android 版本信息。

build number

返回 genymotion shell 版本号。

help

显示帮助。

pause

暂停执行（以秒为单位）。

version

返回 Genymotion Shell 版本。

exit or quit

关闭 Genymotion Shell。

10.安装 ADB

Android Debug Bridge (ADB) 是一个多功能命令行工具，可以让你与模拟器或安卓设备通信。ADB 是 C/S

模式，包括三个组件：客户端、服务端和服务。

如何安装 ADB 和配置 Genymotion：

下载 Android Developer tools (ADT)。

在您所选择的路径，解压缩/解压存档。

启动 Genymotion，打开设置面板。

设置 ADB 路径，例如

adt-bundle\sdk

注意：

该字段将保持红色，直到提供的路径是有效的

"adt-bundle\sdk\platform-tools"不是一个有效值

点击“OK”

所有 Genymotion 设备在启动时都将自动连接到 ADB 服务端上。

译者注：

本文翻译自官网网站：https://cloud.genymotion.com/page/doc/；

由崔尼玛翻译，水平有限，难免有不正确之处，请多多包含；

欢迎访问崔尼玛的博客；

http://developer.android.com/sdk/index.html

https://cloud.genymotion.com/page/doc/

http://cnblogs.com/cuiwencheng

Documents

Genymotion 用户手册Genymotion 是一个能提供虚拟Android 环境的完整的工具包，对于软件开发和测试人员、销售人员设置是 游戏玩家都非常有用。

Genymotion 用户手册Genymotion 是一个能提供虚拟Android 环境的完整的工具包，对于软件开发和测试人员、销售人员设置是游戏玩家都非常有用。