Genymotion中文手册官方用户手册翻译.docx

目录1.概述 22.特点 22.1最擅长于虚拟Android 22.2高可控性 22.3管理你的设备 22.4从Eclipse中开启虚拟设备 33.要求 33.1操作系统要求 33.2系统硬件要求 33.3安装要求 34.安装 34.1注册 34.2下载和安装Oracle VirtualBox 44.3下载Genymotion 44.4安装Genymotion 45.快速开始 56.Genymotion应用 96.1管理窗口 96.2虚拟设备创建窗口 106.3云连接窗口 106.4管理员设置窗口 116.5虚拟设备设置 126.6开启虚拟设备 126.7运行虚拟设备 136.8电池小工具 146.9GPS小工具 157.Eclipse插件 157.1Eclipse插件安装 167.2Eclipse插件使用 167.3操作 177.4虚拟设备状态 187.5使用Genymotion测试应用程序 187.6错误处理 188.IntelliJ插件 188.1插件安装 188.2插件的使用 198.3操作 218.4虚拟设备状态 218.5使用Genymotion测试应用程序 228.6错误处理 229.Genymotion Shell 229.1命令行参数 229.2可用命令 2210.安装ADB 24译者注： 24本文由word发布，格式难免有些错乱。 本文的pdf版请到百度网盘下载：/share/link?shareid=695312842&uk=19831432791.概述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 可配置虚拟设备 屏幕分辨率 内存大小 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.X3.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 page2. 填写个人注册信息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下载Genymotion1. 访问Genymotion官方下载2. 根据您的操作系统选择相应的安装包并下载它4.4安装Genymotion根据您的操作系统，遵循如下安装过程。 Windows 双击下载的msi安装包 选择安装语言（Genymotion语言取决于操作系统的语言），点击下一步 再一次点击下一步 按需更改安装路径(the default path is C:Program FilesGenymobileGenymotion) ，点击下一步 再一次点击下一步 是否创建桌面图标，点击下一步 点击安装 点击完成 Mac OS X 打开dmg安装包 将Genymotion 和Genymotion shell移动到应用目录 Linux 在终端中使用如下命令。chmod +x INSTALLER_PATH/genymotion-VERSION_ARCH.bincd INSTALLER_PATH./genymotion-VERSION_ARCH.bin5.快速开始1.运行Genymotion Windows点击桌面图标 Mac OS X点击应用目录下的图标 Linux用 InstallationPath/genymotion启动2.主窗口如下：3.点击增加，出现如下窗口：4.点击连接，输入你的用户名和密码后点击连接按钮5.在底部列表中选择一种设备后点击增加按钮1. 点击下一步1. 为你的虚拟设备输入名称，然后点击完成8.点击关闭返回到主窗口9.点击Play6.Genymotion应用6.1管理窗口Genymotion的主窗口可以管理所有的虚拟设备 在菜单栏中你可以： 打开已启动的虚拟设备的窗口 增加一个新的虚拟设备 打开/关闭主菜单 点击菜单按钮你可以： 打开设置窗口 打开帮助窗口 打开关于窗口 推出应用程序 你可以使用专用按钮或上下文菜单来： 配置虚拟机的设置（分辨率、DPI、导航键等） 删除虚拟设备6.2虚拟设备创建窗口当点击主窗口上的增加按钮，将会打开虚拟设备创建窗口在这个窗口中，你可以从在线设备列表或本地设备列表中选择和创建设备： 上边的列表包含已下载的虚拟设备 下边的列表包含你的账户中可用的设备6.3云连接窗口当第一次打开虚拟设备创建窗口时，将会提示你进行登录6.4管理员设置窗口 设置ADB路径：在此设置Android SDK的安装路径，将会在该目录中自动搜索ADB可执行文件。 设置HTTP代理：如果你使用HTTP代理，在此设置FQDN或IP地址。 设置HTTP代理的用户名和密码：如果你的代理需要基本的认证，在此使用用户名和密码进行验证。警告：目前只支持基本认证，不支持NTLM或Kerberos。6.5虚拟设备设置在这个窗口中可以配置虚拟设备，例如更改其分辨率、密度等 预定义屏幕尺寸：从预定义列表中设置分辨率和密度 自定义屏幕尺寸：手动设置分辨率和密度。警告：在自定义设置分辨率和密度中可能会遇到错误。 全屏模式运行虚拟机：可以在全屏模式中开始虚拟机，并会根据你显示器的分辨率调整自己的分辨率。 显示安卓导航栏：启动虚拟设备与启用安卓导航栏（三个安卓导航键：Back，Home，Recent Application）6.6开启虚拟设备当从主窗口开启一个虚拟设备时，按照以下三个步骤： 设置网络参数和渲染器参数 检查是否开启CPU虚拟化（Intel CPU的虚拟化技术是VT-X，AMD CPU的是AMD-V）。如果不开启CPU虚拟化，你的虚拟设备将不支持多处理器管理。这种情况下，虚拟设备的处理器个数将会被自动设置为1 。 检查虚拟机上的Genymotion版本是否和你的Genymotion软件相兼容。如果上述三个步骤都成功，那你的虚拟设备就可以正常使用了。6.7运行虚拟设备虚拟机运行的窗口，你可以在此窗口中与虚拟设备进行交互。 Genymotion小工具快捷键 电池小工具 CTRL+1 GPS小工具CTRL+2 控制快捷键 旋转虚拟设备 CTRL+F11 增加声音 CTRL+ 减小声音 CTRL+- 最近使用的应用 CTRL+SPACE 后退 CTRL+BACKSPACE Home CTRL+HOME 电源 CTRL+ESC6.8电池小工具该工具可以修改Genymotion虚拟机的电池电量、电源状态和供电模式。首先，在右侧的面板按钮中打开电池小工具 激活模拟电池模式默认时，Genymotion模拟了一个和你当前电脑使用的相同的电池。这个开关激活自定义值的模拟电池，以便你可以调整测试你的应用程序。当你的电脑没有电池时（台式机或类似的），自定义值模拟将会自动开启。 修改电池电量当模拟电池启用后，可以使用滑块修改虚拟设备的当前电量，或者在相应区域中手动输入想要的值。 修改状态当模拟电池启用后，可以修改电池的当前状态： 充电：插入交流电，电池处于充电状态 放电：为插入交流电，电池处于放电状态6.9GPS小工具GPS小工具可以实时的激活和修改位置坐标、精度和朝向。 激活GPS当你打开GPS后，就可以在虚拟设备中接收GPS帧。当GPS关闭时，不能刷新位置和提供最后一次所使用的位置。 修改位置使用经纬度可以指定你当前想要模拟的位置信息。必须是用度进行指定，例如维度范围：-90.090.0，经度范围：-180.0180.0 修改高度可以自定义设置高度值从-10000m到10000m 修改精度可以使用滑块或者输入想要的精度值，范围是0200m 修改朝向可以使用相应的转盘或输入想要的值来修改方向，范围是0359.99注意许多应用并不使用GPS定位，但是使用加速计或者陀螺仪来检测设备的朝向信息，但目前还不支持该功能。7.Eclipse插件一个有趣的特点就是你可以用Genymotion来测试你用Eclipse开发的软件，Genymotion使用ADB连接运行中的虚拟设备，然后将你的软件安装到虚拟设备中。7.1Eclipse插件安装有两种安装插件的方法1.使用更新网站自动安装 启动Eclipse 依次点击菜单栏中的Help-Install New Software 在新打开的窗口中点击Add（在新打开的窗口的右上方） 填入相应的信息然后进行验证Name: GenymobileLocation:/eclipse 然后会出现一个名为Genymobile的树形图 检查你刚才输入的内容，并点击Next 阅读并接受相应条款 Eclipse会警告说该插件没有被签名，尽管这样还是要接受它 完成安装后重启Eclipse 重启Eclipse后在工具栏中会发现新的按钮 最后，通过点击菜单栏的Help-About-Installation Details中的Plug-In列中将会看到Genymotion，这说明你成功安装了它2.手动安装 确保Eclipse关闭 通过Genymotion官方下载下载插件 按照你的操作系统，参照以下步骤： Windows 如果你有管理员权限，将jar文件放入你Eclipse安装目录中的plugins文件夹下 如果没有管理员权限，将jar文件放入你的Local SettingsEclipseplugins中 Mac OS X 使用管理员权限，将jar文件放入你Eclipse安装目录中的plugins文件夹下 Linux 如果你有管理员权限，将jar文件放入你Eclipse安装目录中的plugins文件夹下 如果没有管理员权限，将jar文件放入/home/user/Eclipse/plugins下7.2Eclipse插件使用点击工具栏中的图标打开插件第一次使用插件1. 需要设置Genymotion的安装目录（默认路径只会对标准安装时有效） Windows: C:Program FilesGenymobileGenymotion MacOS X: /Applications/Genymotion.app Linux: /home/user/genymotion1. 先点击Apply，然后点击OK2. 然后重新点击图标开启插件的主窗口，如下图所示7.3操作在插件的主窗口中你可以进行如下操作：1. 启动一个虚拟设备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 Application4.出现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库方法 启动你的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 FilesGenymobileGenymotion MacOS X: /Applications/Genymotion.app Linux: /home/user/genymotion1. 点击OK按钮2. 再次点击按钮打开插件主窗口8.3操作在插件主窗口中，你可以做以下操作：1. 启动Genymotion虚拟设备2. 创建一个新的虚拟设备3. 刷新Genymotion虚拟设备列表创建操作，将自动启动创建Genymotion虚拟设备向导。8.4虚拟设备状态插件主窗口的状态列可以是如下状态 Off：虚拟设备关闭 Paused：虚拟设备已经启动，然后暂停；重启之后也会处于相同状态 On：虚拟设备开启，但并未与ADB连接。这意味着你不能在ADT插件中的Android Device Chooser选择该虚拟设备 Connected：虚拟设备已启动并与ADB连接。这意味着你可以在ADT插件中的Android Device Chooser选择该虚拟设备8.5使用Genymotion测试应用程序1.点击启动或创建一个你想使用的虚拟设备2.关闭Genymotion主窗口3.右键你的工程文件，选择Run as Android Application4.出现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 ShellGenymotion提供了shell，可以让你通过脚本修改传感器状态。9.1命令行参数 -h Print help显示帮助 -r ip_address 连接指定IP地址的虚拟设备 -c command 在shell中执行命令并返回 -f file 执行文件内容每条命令必须在一行中！9.2可用命令 battery getmode返回选定虚拟设备的电池状态，其可以是： host: 虚拟设备的电池反应物理机（主机）的电池状态（如果存在） manual: 该状态下可以手动设置电池的电压和状态 battery setmode设置选定虚拟设备的电池状态，其可以是： host: 虚拟设备的电池反应物理机（主机）的电池状态（如果存在） manual: 该状态下可以手动设置电池的电压和状态 battery getlevel返回当前电池剩余的电量，取值范围是0%100%。如果电池模式为host，则返回主机的电池的电量。 battery setlevel设置当前电池的电量，取值范围是0%100%。设置电压为Manual模式，如果之前模式为Host，则会设置成Manual模式 battery getstatus返回当前的电池状态。有4个可能的状态： 放电：断开电源和电池放电。 充电方式：电源连接和电池充电。 充满：电池充满。 未知：有时不能确定电池状态，可能在主机没有电池时出现。 battery setstatus设置当前的电池状态。有4个可能的状态： 放电：断开电源和电池放电。 充电方式：电源连接和电池充电。 充满：电池充满。 未知：有时不能确定电池状态，可能在主机没有电池时出现。 devices list列出的可用Genymotion虚拟设备，并提供当前的详细状态信息，如IP地址。 devices ping发送一个ping命令以检测虚拟设备是否响应。 devices refresh刷新Genymotion虚拟设备列表，使列表保持最新。 devices select选择你想进行交互的虚拟设备。 devices show列出的可用Genymotion虚拟设备，并提供当前的详细状态信息，如IP地址。 gps activate激活GPS（如果还没激活）。 gps desactivate关闭GPS传感器（如果激活）。 gps getlati