Genymotion中文手冊(官方使用者手冊翻譯)

 

 

 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註冊4.2下載和安裝Oracle VirtualBox

如果你的電腦上未安裝Oracle VirtualBox，請閱讀以下內容。

• Windows

安裝Oracle VirtualBox的最簡單方法是下載包含有VirtualBox的

• Mac OS X

訪問下載頁 得到

檢查你的軟體倉庫：VirtualBox對幾乎所有的GNU/Linux都會有相應的安裝包。如果沒有，你需要安裝一個特殊的版本，請訪問。

4.3下載Genymotion4.4安裝Genymotion

根據您的作業系統，遵循如下安裝過程。

• Windows
  • 雙擊下載的msi安裝包
  • 選擇安裝語言（Genymotion語言取決於作業系統的語言），點擊"下一步"
  • 再一次點擊"下一步"
  • 按需更改安裝路徑點擊"下一步"
  • 再一次點擊"下一步"
  • 是否建立案頭表徵圖，點擊"下一步"
  • 點擊"安裝"
  • 點擊"完成"
• Mac OS X
  • 開啟dmg安裝包
  • 將
• Linux
  • 在終端中使用如下命令。

5.快速開始

1.運行Genymotion

• Windows

  點擊案頭表徵圖

• Mac OS X

  點擊應用目錄下的表徵圖

• Linux

用 啟動

2.主視窗如下：

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

4.點擊"串連"，輸入你的使用者名稱和密碼後點擊"串連"按鈕

5.在底部列表中選擇一種裝置後點擊"增加"按鈕

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虛擬設備設定

在這個視窗中可以配置虛擬設備，例如更改其解析度、密度等……

• 預定義螢幕尺寸：

從預定義列表中設定解析度和密度

• 自訂螢幕尺寸：

手動設定解析度和密度。警告：在自訂設定解析度和密度中可能會遇到錯誤。

• 全螢幕模式運行虛擬機器：

可以在全螢幕模式中開始虛擬機器，並會根據你顯示器的解析度調整自己的解析度。

• 顯示安卓導覽列：

6.6開啟虛擬設備

6.7運行虛擬設備

6.8電池小工具

6.9GPS小工具

GPS小工具可以即時的啟用和修改位置座標、精度和朝向。

• 啟用GPS

當你開啟GPS後，就可以在虛擬設備中接收GPS幀。當GPS關閉時，不能重新整理位置和提供最後一次所使用的位置。

• 修改位置

使用經緯度可以指定你當前想要類比的位置資訊。必須是用"度"進行指定，例如維度範圍：-90.0~90.0--180.0~180.0

7.Eclipse外掛程式

一個有趣的特點就是你可以用Genymotion來測試你用Eclipse開發的軟體，Genymotion使用ADB串連運行中的虛擬設備，然後將你的軟體安裝到虛擬設備中。

7.1Eclipse外掛程式安裝

有兩種安裝外掛程式的方法

1.使用更新網站自動安裝

• 啟動Eclipse
• 依次點擊功能表列中的"Help-Install New Software…"
• 在新開啟的視窗中點擊"Add"（在新開啟的視窗的右上方）
• 填入相應的資訊然後進行驗證

• • • 中
  • • 下

7.2Eclipse外掛程式使用

第一次使用外掛程式

7.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.點擊你啟動/建立的虛擬設備

    其中：VMNAME是Genymotion中虛擬設備名稱，@IP:PORT是ip地址和連接埠（由ADB分配）

當重啟或意外暫停虛擬設備時，Android Device Chooser視窗中的顯示名稱是無關聯的。關閉並重新開啟Genymotion外掛程式會解決這個問題。

7.6錯誤處理

當Genymotion外掛程式視窗處於開啟狀態時，將會在Eclipse的console中列印出相關錯誤資訊。

8.IntelliJ外掛程式

像Eclipse一樣， 我們也為IntelliJ（類似）提供了一個外掛程式，有了這個外掛程式，你可以很容易地測試您的應用程式。它採用ADB串連到任何啟動並執行Genymotion虛擬設備，然後裝載你的應用程式。

8.1外掛程式安裝

安裝外掛程式的方式有兩種：

1.JetBrains庫方法

• 啟動你的IDE
• 進入""菜單
• 在新開啟的視窗中，選擇""，然後點擊"..." 按鈕（右下方）
• 在列表中，單擊Genymotion，點擊""按鈕（在左上方）
• 點擊""按鈕開始
• 點擊""按鈕離開瀏覽庫視窗
• 點擊""按鈕離開設定視窗
• IntelliJ要求重新啟動，通過點擊""按鈕重啟

2.手動方法

• 訪問下載外掛程式
• 啟動你的IDE
• 進入""菜單
• 在新開啟的視窗中，選擇""，然後點擊"..." 按鈕（右下方）
• 選擇檔案
• 點擊""按鈕
• IDE請求重啟，""按鈕重新啟動

8.2外掛程式的使用

第一次使用

8.3操作

在外掛程式主視窗中，你可以做以下操作：

"建立"操作，將自動啟動建立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.點擊你啟動/建立的虛擬設備

    

    其中：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和配置Genymotion：

• 在您所選擇的路徑，解壓縮/解壓存檔。
• 啟動Genymotion，開啟設定面板。
• 設定ADB路徑，例如
  該欄位將保持紅色，直到提供的路徑是有效
  • 不是一個有效值
• 點擊"OK"

所有Genymotion裝置在啟動時都將自動連接到ADB服務端上。

譯者註：

• 本文翻譯自官網網站：https://cloud.genymotion.com/page/doc/；
• 由崔尼瑪翻譯，水平有限，難免有不正確之處，請多多包含；
• 歡迎訪問崔尼瑪的部落格；