1.2　搭建HarmonyOS開發環境

隨著華為HarmonyOS的快速發展，為適配基于HarmonyOS應用的快速和高效開發，華為提供了DevEco Studio開發工具。本書將基于DevEco Studio IDE，手把手教你搭建Harmony開發環境。

1.2.1　安裝環境要求

當前DevEco Studio已經支持Windows系統和macOS系統，這里以Windows系統為例，為了保證DevEco Studio正常運行，建議你的計算機配置滿足以下要求：

·　操作系統：Windows 10 64位。

·　內存：8GB及以上。

·　硬盤：100GB及以上。

·　分辨率：1280×800像素及以上。

1.2.2　下載安裝工具

步驟一：安裝開發工具DevEco Studio

首先，需要去華為官網下載最新的開發工具DevEco Studio，下載網址為https://developer.harmonyos.com/cn/develop/deveco-studio。（DevEco Studio的編譯構建依賴JDK, DevEco Studio預置了Open JDK，版本為1.8，安裝過程中會自動安裝JDK。）

下載的安裝包解壓完成后，雙擊deveco-studio-xxxx.exe文件，進入DevEco Studio安裝向導，默認系統選擇的路徑，或選擇自己的安裝路徑，單擊Next按鈕，直至安裝完成。注意在如下安裝選項頁面勾選DevEco Studio launcher，如圖1.7所示。

圖1.7　安裝DevEco Studio

步驟二：安裝Node.js

如果需要使用JavaScript（以下簡稱JS）語言開發HarmonyOS應用，則還需要下載和安裝Node.js。如果使用其他語言開發，則不用安裝Node.js，可跳過步驟二。

如果已安裝Node.js，可打開命令行工具，輸入node-v命令，檢查版本號信息，建議使用v12.0.0及以上版本。

接下來安裝Node.js。登錄Node.js官方網站（網址https://node.js.org/en/download/），下載Node.js軟件包。選擇LTS版本，64位Windows系統對應的軟件包，如圖1.8所示。

圖1.8　Node.js安裝版本

單擊下載后的軟件包node-vxxx-x64.msi進行安裝，根據默認設置單擊Next按鈕，直至單擊Finish按鈕完成安裝，如圖1.9所示。

圖1.9　Node.js安裝完成

Node.js會自動在系統的path環境變量中配置node.exe的目錄路徑。如果安裝Node.js時沒有選擇默認的安裝目錄，則需要在系統變量path中手工添加環境變量信息（筆者的計算機→屬性→高級系統設置→高級→環境變量），增加Node.js的安裝路徑。

1.2.3　搭建開發環境

DevEco Studio的開發環境，需要保證連接Internet網絡。若可以直接訪問Internet，則直接執行步驟二和步驟五即可。若不能直接訪問Internet，則需要逐步完成以下步驟，包括配置代理服務器。

步驟一：配置npm代理

DevEco Studio在使用過程中，需要下載JS SDK第三方依賴。只有在同時滿足以下兩個條件時，才需要配置npm代理，否則，可以跳過本步驟。

（1）需要使用JS語言開發HarmonyOS應用。

（2）網絡不能直接訪問Internet，而是需要通過代理服務器才可以訪問。

打開命令行工具，然后根據如下方式進行npm代理配置。

（1）如果使用的代理服務器需要認證，按照如下方式進行設置（將其中的user、password、proxyserver和port按照實際代理服務器進行修改）。

    npm config set proxy http://user:password@proxyserver:port
    npm config set https-proxy http://user:password@proxyserver:port

（2）如果使用的代理服務器不需要認證（不需要賬號和密碼），則應按照如下方式進行設置。

    npm config set proxy http:proxyserver:port
    npm config set https-proxy http:proxyserver:port

代理設置完成后，可在命令行工具中執行如下命令進行驗證。若執行結果如圖1.10所示，則說明代理設置成功。

圖1.10　npm代理配置成功

    npm info express

步驟二：設置npm倉庫

下載JS SDK時，為提升使用npm安裝JS依賴的速度，建議在命令行工具中執行如下命令，重新設置npm倉庫地址。

    npm config set registry https://mirrors.huaweicloud.com/repository/npm/

步驟三：配置Gradle代理

若網絡不能直接訪問Internet，而是需要通過代理服務器才可以訪問，在這種情況下，需要設置Gradle代理，以便訪問和下載Gradle所需的依賴。否則，可以跳過本步驟。

首先，打開“此計算機”，在文件夾網址欄中輸入%userprofile%，進入個人數據界面，如圖1.11所示。

圖1.11　進入個人數據界面

創建一個文件夾，并命名為.gradle。如果已存在.gradle文件夾，則跳過此操作。

進入.gradle文件夾，新建一個文本文檔，命名為gradle，并修改后綴為.properties。打開gradle.properties文件，添加如下腳本，然后保存，如圖1.12所示。其中代理服務器、端口、用戶名、密碼和不使用代理的域名，需要根據實際代理情況進行修改。其中不使用代理的nonProxyHosts的配置間隔符是“|”。腳本代碼如下：

    systemProp.http.proxyHost = proxy.server.com
    systemProp.http.proxyPort = 8080
    systemProp.http.nonProxyHosts = *.company.com|10.*|100.*
    systemProp.http.proxyUser = userId
    systemProp.http.proxyPassword = password
    systemProp.https.proxyHost = proxy.server.com
    systemProp.https.proxyPort = 8080
    systemProp.https.nonProxyHosts = *.company.com|10.*|100.*
    systemProp.https.proxyUser = userId
    systemProp.https.proxyPassword = password

圖1.12　配置Gradle代理

步驟四：配置DevEco Studio代理

若網絡不能直接訪問Internet，而需要通過代理服務器才可以訪問，在這種情況下，需要設置DevEco Studio代理，以便訪問和下載外部資源，如圖1.13所示。否則，可以跳過本步驟。

圖1.13　配置DevEco Studio代理

首先，運行已安裝的DevEco Studio，首次打開，選擇Do not import settings，單擊OK按鈕。

進入DevEco Studio歡迎界面后，單擊Configure→Settings→Appearance & Behavior→System Settings→HTTP Proxy，進入HTTP Proxy的設置界面，設置代理信息。其中包括HTTP配置項和Proxy authentication配置項。

（1）HTTP配置項：設置代理服務器信息。

·　Host name：代理服務器主機名或IP地址。

·　Port number：代理服務器對應的端口號。

·　No proxy for：不需要通過代理服務器訪問的URL或者IP地址（地址之間用英文逗號分隔）。

（2）Proxy authentication配置項：如果代理服務器需要通過認證鑒權才能訪問，則需要設置。否則，可以跳過該配置項。

·　Login：訪問代理服務器的用戶名。

·　Password：訪問代理服務器的密碼。

·　Remember：勾選，記住密碼。

配置完成后，單擊Check connection按鈕，輸入網絡地址（如https://developer.harmonyos.com），檢查網絡連通性。提示Connection successful表示代理設置成功。單擊OK按鈕完成DevEco Studio的代理配置。

DevEco Studio代理配置完成后，會提示安裝HarmonyOS SDK，若同意安裝至默認路徑，則可以單擊Next按鈕進行下載安裝。若想更改SDK的存儲目錄，則單擊Cancel按鈕，并根據下方步驟五進行HarmonyOS SDK下載操作，如圖1.14所示。

圖1.14　HarmonyOS SDK默認安裝

步驟五：下載HarmonyOS SDK

DevEco Studio提供SDK Manager統一管理SDK及工具鏈，當下載各種編程語言的SDK包時，SDK Manager會自動下載該SDK包所依賴的工具鏈，因此只需下載所需編程語言對應的SDK包。

SDK Manager提供多種編程語言的SDK包，包括Native（C/C++語言SDK包）、JS（JS語言SDK包）和Java（Java語言SDK包）。其中，Java SDK在首次下載Harmony SDK時會默認下載，Native SDK和JS SDK默認不自動下載，需要進行手動勾選下載，因此，如果需要使用JS或C/C++語言開發應用，則需手動下載對應的SDK包。

下載Harmony SDK的步驟如下。

（1）在菜單欄選擇Configure→Settings或者按快捷鍵Ctrl+Alt+S，打開Settings配置界面，如圖1.15所示。

圖1.15　進入HarmonyOS SDK存儲設置

（2）進入Appearance & Behavior→System Settings→HarmonyOS SDK菜單界面，單擊Edit按鈕，設置HarmonyOS SDK的存儲路徑，如圖1.16所示。

圖1.16　設置HarmonyOS SDK存儲路徑

（3）選擇HarmonyOS SDK的存儲路徑（不能含有中文）后，單擊Next按鈕，在彈出的License Agreement窗口中，單擊Accept按鈕開始下載SDK。如果本地已有SDK包，則選擇本地已有SDK包的存儲路徑，DevEco Studio會更新SDK及工具鏈，如圖1.17所示。

圖1.17　下載HarmonyOS SDK

（4）待HarmonyOS SDK及工具下載完成后，單擊Finish按鈕，可以看到默認的SDK Platforms→Java SDK及SDK Tools→Toolchains已完成下載，如圖1.18所示。

圖1.18　完成HarmonyOS SDK下載

（5）如果需要使用C/C++或者JS語言，則應在SDK Platform中勾選對應的SDK包，單擊Apply按鈕，SDK Manager會自動將SDK包和工具鏈下載到所設置的SDK存儲路徑中，如圖1.19所示。

圖1.19　下載C/C++/JS SDK

至此，開發環境已配置完成，隨后我們會帶領大家熟悉DevEco Studio IDE開發環境，并創建一個HarmonyOS項目，通過運行Hello World工程來驗證環境配置。