Genymotion中文手冊

目錄
1.概述 2
2.特點 2
2.1最擅長於虛擬Android 2
2.2高可控性 2
2.3管理你的設備 2
2.4從Eclipse中開啟虛擬設備 3
3.要求 3
3.1操作系統要求 3
3.2系統硬件要求 3
3.3安裝要求 3
4.安裝 3
4.1注冊 3
4.2下載和安裝Oracle VirtualBox 4
4.3下載Genymotion 4
4.4安裝Genymotion 4
5.快速開始 5
6.Genymotion應用 9
6.1管理窗口 9
6.2虛擬設備創建窗口 10
6.3雲連接窗口 10
6.4管理員設置窗口 11
6.5虛擬設備設置 12
6.6開啟虛擬設備 12
6.7運行虛擬設備 13
6.8電池小工具 14
6.9GPS小工具 15
7.Eclipse插件 15
7.1Eclipse插件安裝 16
7.2Eclipse插件使用 16
7.3操作 17
7.4虛擬設備狀態 18
7.5使用Genymotion測試應用程序 18
7.6錯誤處理 18
8.IntelliJ插件 18
8.1插件安裝 18
8.2插件的使用 19
8.3操作 21
8.4虛擬設備狀態 21
8.5使用Genymotion測試應用程序 22
8.6錯誤處理 22
9.Genymotion Shell 22
9.1命令行參數 22
9.2可用命令 22
10.安裝ADB 24
譯者注： 24

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
• 可配置虛擬設備
  • 屏幕分辨率
  • 內存大小
  • 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. 填寫個人注冊信息
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

5.快速開始

1.運行Genymotion

• Windows

  點擊桌面圖標

• Mac OS X

  點擊應用目錄下的圖標

• Linux

用 [InstallationPath]/genymotion啟動

2.主窗口如下：

3.點擊"增加"，出現如下窗口：

4.點擊"連接"，輸入你的用戶名和密碼后點擊"連接"按鈕

5.在底部列表中選擇一種設備后點擊"增加"按鈕

1. 點擊"下一步"

1. 為你的虛擬設備輸入名稱，然后點擊"完成"

8.點擊"關閉"返回到主窗口

9.點擊"Play"

6.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+ESC

6.8電池小工具

該工具可以修改Genymotion虛擬機的電池電量、電源狀態和供電模式。

首先，在右側的面板按鈕中打開電池小工具

• 激活模擬電池模式

默認時，Genymotion模擬了一個和你當前電腦使用的相同的電池。這個開關激活自定義值的模擬電池，以便你可以調整測試你的應用程序。

當你的電腦沒有電池時（台式機或類似的），自定義值模擬將會自動開啟。

• 修改電池電量

當模擬電池啟用后，可以使用滑塊修改虛擬設備的當前電量，或者在相應區域中手動輸入想要的值。

• 修改狀態

當模擬電池啟用后，可以修改電池的當前狀態：

• 充電：插入交流電，電池處於充電狀態
• 放電：為插入交流電，電池處於放電狀態

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連接運行中的虛擬設備，然后將你的軟件安裝到虛擬設備中。

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
• Linux: /home/[user]/genymotion

1. 先點擊"Apply"，然后點擊"OK"
2. 然后重新點擊圖標開啟插件的主窗口，如下圖所示

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 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庫方法

• 啟動你的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

1. 點擊"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 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

  返回選定虛擬設備的電池狀態，其可以是：

  • 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 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
  設置當前的精度（如過沒激活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/；
• 由崔尼瑪翻譯，水平有限，難免有不正確之處，請多多包含；
• 歡迎訪問崔尼瑪的博客；

本文由word發布，格式難免有些錯亂。本文的pdf版請到百度網盤下載：http://pan.baidu.com/share/link?shareid=695312842&uk=1983143279