手把手教你使用HarmonyOS本地模擬器
2021年的華為開發者大會（HDC2021）上，我們隨DevEco Studio 3.0 Beta1版本發布首次推出了本地模擬器（也稱為Local Emulator），支援模擬手機品類。
我們通過下面的動圖，來回顧下手機本地模擬器的使用效果。
本期，我們將為大家介紹HarmonyOS本地模擬器的版本演進，並手把手教大家使用HarmonyOS本地模擬器。
一、本地模擬器的版本演進
2021年12月31日，經過一個版本的迭代優化，隨DevEco Studio 3.0 Beta2版本發布的本地模擬器新增了智慧手錶和智慧屏的模擬器品類。
本地模擬器分別針對智慧手錶和智慧屏的特徵，訂製了其獨有的特性。
智慧手錶：支援心率、步數的模擬數據注入，支援旋轉錶冠按鈕的模擬。
圖1 智慧手錶
智慧屏：支援遙控器的模擬。
圖2 智慧屏
下面，我們通過一段影片來看看智慧手錶和智慧屏品類本地模擬器的使用效果。
通過以上對本地模擬器的介紹，不難看出本地模擬器具有以下優勢：
- 直接運行在用戶本地電腦上，不需要登錄授權，零延遲，也不受使用時長限制，擁有和真機一樣的性能。
- 提供audio、battery、location等多種通用器件模擬，為開發者提供了一個近似真機的運行環境。
- 對華為設備提供產品專屬模擬，如智慧手錶的旋轉按壓功能鍵，以及智慧屏的遙控器模擬等。
- 支援Java、JS、C/C++單語言調試和JS+Java跨語言調試能力，幫助開發者更方便、高效地調試應用。
二、使用前的準備工作
了解了本地模擬器之後，下面我們要重點為大家講解如何使用本地模擬器。在使用本地模擬器之前，我們需要做好以下準備工作：
1. 本地模擬器是創建和運行在本地電腦上的，需確保本地電腦滿足以下資源要求：
- Windows系統：8GB及以上
- macOS系統：8GB及以上
說明：不支援在虛擬機系統上運行本地模擬器，例如不支援在Ubuntu系統上，通過安裝Windows虛擬機，然後使用Windows系統安裝和運行模擬器。
2. 檢查DevEco Studio的版本：
DevEco Studio V3.0 Beta1及更高版本才支援本地模擬器，當前推薦使用DevEco Studio V3.0 Beta2版本。
3. 使用本地模擬器前，需要安裝相應的鏡像包，具體操作如下：
（1）打開DevEco Studio，選擇「Files > Settings」（macOS系統則選擇「DevEco Studio > Preferences」）。
（2）如圖3所示，在「SDK Manager > HarmonyOS Legacy SDK」頁簽，勾選「Platforms」下的鏡像包。不同的的鏡像包對應不同的設備類型，System-image-phone鏡像包對應手機，System-image-tv鏡像包對應智慧屏，System-image-wearable鏡像包對應智慧手錶。
圖3 下載鏡像包
（3）點擊「Apply」進行安裝。
4. 安裝本地模擬器。
在菜單欄選擇「Tools > Device Manager」，進入圖4所示介面，點擊「Install」即可安裝本地模擬器。
圖4 安裝本地模擬器
三、創建和使用本地模擬器
完成了上面的準備工作，接下來就是本文的重點，教大家如何創建和使用本地模擬器。
1.（可選）自定義本地模擬器文件存放路徑。
本地模擬器文件的默認存放路徑為：C:\Users\用戶名\AppData\Local\Huawei\HarmonyOSEmulator\deployed。如果C盤空間緊張，可以通過新增一個系統的環境變數HarmonyOS_HVD_HOME自定義存放路徑，指向空間充裕的目錄。
2. 創建本地模擬器。
（1）打開DevEco Studio，選擇「Tools > Device Manager」。如圖3所示，在Local Emulator頁簽中，點擊右下角的New Emulator按鈕，開始創建本地模擬器。
圖5 創建本地模擬器
（2）選擇一個設備來創建本地模擬器。
如圖4所示，DevEco Studio默認提供Huawei_Phone、Huawei_TV和Huawei_Wearable三個設備，分別對應手機、智慧屏和智慧手錶。針對華為設備的特徵，DevEco Studio對這三個設備預置了尺寸、解析度等參數。
圖6 選擇一個設備
開發者點擊New Hardware或Huawei_Phone後的克隆 圖標，可以創建新的手機設備，自定義設備的名稱、尺寸、解析度、記憶體等參數（如圖7）。
圖7 自定義手機參數
開發者從默認的三個設備或者創建的手機設備中，選擇一個設備來創建本地模擬器。
（3）選擇好設備後，點擊Next，可以看到本地模擬器的鏡像資訊。
（4）再次點擊Next，檢查本地模擬器的配置資訊，如有需要此時還可以修改配置資訊。確認無誤後，點擊Finish完成本地模擬器的創建。
創建成功後，在Local Emulator頁簽可以看到新創建的本地模擬器，如圖8所示。
圖8 本地模擬器創建成功
3. 運行本地模擬器。
（1）在Local Emulator頁簽（如圖8），點擊即可啟動本地模擬器。
（2）點擊DevEco Studio工具欄中的按鈕運行工程，或使用默認快捷鍵Shift+F10（Mac為Control+R）運行工程。
圖9 運行工程
（3）DevEco Studio會啟動應用的編譯構建，完成後應用即可運行在本地模擬器上。以手機設備為例，運行效果如圖10所示。
圖10 運行本地模擬器
圖8所示的手機本地模擬器，除了可以像真機一樣直接在手機螢幕內操作，右側的工具欄提供了操作便捷、豐富和數據注入能力，包括：調整音量、電池模擬、GPS模擬、網路模擬、虛擬感測器模擬等。
本地模擬器目前支援手機、智慧手錶和智慧屏三種設備類型。圖11展示了同一套程式碼同時在智慧手錶、手機和智慧屏三個設備上的運行效果。
圖11 本地模擬器運行效果
四、結束語
本期介紹了本地模擬器的使用，你掌握了嗎？歡迎大家來使用和探索本地模擬器的更多豐富功能~
在使用本地模擬器過程中，如果遇到問題，可先參考FAQ：
//developer.harmonyos.com/cn/docs/documentation/doc-guides/faq-local-emulator-0000001116085454
如果問題仍然沒有解決，可通過華為開發者論壇向我們回饋：
//developer.huawei.com/consumer/cn/forum/block/deveco-studio
我們將在後續版本中支援更多設備的本地模擬器，也將對大家回饋的問題進行優化和改進，提升大家的使用體驗。請繼續關注我們，感謝有你！
掃碼添加開發者小助手微信
獲取更多HarmonyOS開發資源和開發者活動資訊
