DevEco Studio 開發(fā)環(huán)境需要依賴于網(wǎng)絡(luò)環(huán)境,需要連接上網(wǎng)絡(luò)才能確保工具的正常使用,可以根據(jù)如下兩種情況來配置開發(fā)環(huán)境:
- 如果可以直接訪問 Internet,只需進行[設(shè)置npm倉庫]和[下載HarmonyOS SDK] 操作。
- 如果網(wǎng)絡(luò)不能直接訪問 Internet,需要通過代理服務(wù)器才可以訪問,請根據(jù)本章節(jié)內(nèi)容逐條設(shè)置開發(fā)環(huán)境。
npm 設(shè)置
設(shè)置 npm 代理
只有在同時滿足以下兩個條件時,需要配置 npm 代理,否則,請?zhí)^本章節(jié)。
- 需要使用 JS 語言開發(fā) HarmonyOS 應(yīng)用。
- 網(wǎng)絡(luò)不能直接訪問 Internet,而是需要通過代理服務(wù)器才可以訪問。這種情況下,配置 npm 代理,便于從 npm 服務(wù)器下載 JS 依賴。
打開命令行工具,按照如下方式進行 npm 代理設(shè)置和驗證。
- 執(zhí)行如下命令設(shè)置 npm 代理。
- 如果使用的代理服務(wù)器需要認證,請按照如下方式進行設(shè)置(請將 user、password、proxyserver 和 port 按照實際代理服務(wù)器進行修改)。
npm config set proxy http://user:password@proxyserver:portnpm config set https-proxy http://user:password@proxyserver:port
- 如果使用的代理服務(wù)器不需要認證(不需要帳號和密碼),請按照如下方式進行設(shè)置。
npm config set proxy http:proxyserver:portnpm config set https-proxy http:proxyserver:port
- 代理設(shè)置完成后,執(zhí)行如下命令進行驗證。
npm info express
執(zhí)行結(jié)果如下圖所示,則說明代理設(shè)置成功。

設(shè)置 npm 倉庫
為了提升[下載 JS SDK]時,使用 npm 安裝 JS 依賴的速度,建議在命令行工具中執(zhí)行如下命令,重新設(shè)置 npm 倉庫地址。
npm config set registry https://mirrors.huaweicloud.com/repository/npm/
設(shè)置Gradle代理
如果網(wǎng)絡(luò)不能直接訪問 Internet,而是需要通過代理服務(wù)器才可以訪問,這種情況下,需要設(shè)置 Gradle 代理,來訪問和下載 Gradle 所需的依賴。否則,請?zhí)^本章節(jié)。
- 打開“此電腦”,在文件夾地址欄中輸入 %userprofile%,進入個人數(shù)據(jù)界面。

- 創(chuàng)建一個文件夾,命名為 .gradle.。如果已有 .gradle 文件夾,請?zhí)^此操作。
- 進入.gradle文件夾,新建一個文本文檔,命名為 gradle,并修改后綴為 .properties。
- 打開gradle.properties文件中,添加如下腳本,然后保存。
其中代理服務(wù)器、端口、用戶名、密碼和不使用代理的域名,請根據(jù)實際代理情況進行修改。其中不使用代理的 “nonProxyHosts”的配置間隔符是 “|”。
systemProp.http.proxyHost=proxy.server.comsystemProp.http.proxyPort=8080systemProp.http.nonProxyHosts=*.company.com|10.*|100.*systemProp.http.proxyUser=userIdsystemProp.http.proxyPassword=passwordsystemProp.https.proxyHost=proxy.server.comsystemProp.https.proxyPort=8080systemProp.https.nonProxyHosts=*.company.com|10.*|100.*systemProp.https.proxyUser=userIdsystemProp.https.proxyPassword=password
設(shè)置 DevEco Studio 代理
如果網(wǎng)絡(luò)不能直接訪問 Internet,而需要通過代理服務(wù)器才可以訪問,這種情況下,需要設(shè)置 DevEco Studio 代理,來訪問和下載外部資源。否則,請?zhí)^本章節(jié)。
- 運行已安裝的 DevEco Studio,首次使用,請選擇 Do not import settings,點擊 OK。
- 根據(jù) DevEco Studio 歡迎界面的提示,點擊 Setup Proxy,或者在歡迎頁點擊Configure > Settings > Appearance&Behavior > System Settings > HTTP Proxy進入 HTTP Proxy 設(shè)置界面。

- 設(shè)置 DevEco Studio 的 HTTP Proxy 信息。
配置項,設(shè)置代理服務(wù)器信息。
- Host name:代理服務(wù)器主機名或IP地址。
- Port number:代理服務(wù)器對應(yīng)的端口號。
- No proxy for:不需要通過代理服務(wù)器訪問的 URL 或者 IP 地址(地址之間用英文逗號分隔)。
配置項,如果代理服務(wù)器需要通過認證鑒權(quán)才能訪問,則需要設(shè)置。否則,請?zhí)^該配置項。
- Login:訪問代理服務(wù)器的用戶名。
- Password:訪問代理服務(wù)器的密碼。
- Remember:勾選,記住密碼。

- 配置完成后,點擊 Check connection,輸入網(wǎng)絡(luò)地址(如:https://developer.harmonyos.com),檢查網(wǎng)絡(luò)連通性。提示“Connection successful”表示代理設(shè)置成功。
- 點擊 OK 按鈕完成 DevEco Studio 代理配置。
- DevEco Studio 代理設(shè)置完成后,會提示安裝 HarmonyOS SDK,可以點擊 Next 下載到默認目錄中;如果想更改 SDK 的存儲目錄,請點擊 Cancel,并根據(jù) [ 下載HarmonyOS SDK ] 進行操作。

下載 HarmonyOS SDK
Devco Studio 提供 SDK Manager 統(tǒng)一管理 SDK 及工具鏈,下載各種編程語言的 SDK 包時,SDK Manager 會自動下載該 SDK 包依賴的工具鏈。
SDK Manager 提供多種編程語言的 SDK 包,各 SDK 包的說明請參考:
- Native:C/C++ 語言 SDK 包,默認不自動下載,需手動勾選下載。對應(yīng)的接口文檔請參考《Native API參考》。
- JS:JS 語言 SDK 包,默認不自動下載,需手動勾選下載。對應(yīng)的接口文檔請參考《JS API參考》。
- Java:Java語言SDK包,首次下載SDK時默認下載。對應(yīng)的接口文檔請參考《Java API參考》。
同時還提供 SDK 對應(yīng)的工具鏈(SDK Tools):
- Toolchains:SDK 工具鏈,HarmonyOS 應(yīng)用開發(fā)必備工具集,包括編譯、打包、簽名、數(shù)據(jù)庫管理等工具的集合,首次下載 SDK 時默認下載。
- Previewer:Lite Wearable 預(yù)覽器,在開發(fā)過程中可以動態(tài)預(yù)覽 Lite Wearable 應(yīng)用的界面呈現(xiàn)效果,默認不自動下載,需手動勾選下載。
首次下載 HarmonyOS SDK 時,只會 默認下載 **Java SDK 和 Toolchains**。因此,如果還需要使用 JS 或 C/C++ 語言開發(fā)應(yīng)用時,需手動下載對應(yīng)的SDK包。
- 在菜單欄點擊 Configure > Settings 或者默認快捷鍵 Ctrl+Alt+S,打開 Settings 配置界面。
- 進入 Appearance&Behavior > System Settings > HarmonyOS SDK菜單界面,點擊 Edit 按鈕,設(shè)置 HarmonyOS SDK 存儲路徑。

- 選擇 HarmonyOS SDK 存儲路徑(不能包含中文),然后點擊 Next。在彈出的 License Agreement 窗口,點擊 Accept 開始下載 SDK。
說明
如果本地已有 SDK 包,請選擇本地已有 SDK 包的存儲路徑,DevEco Studio 會增量更新 SDK 及工具鏈。
- 等待 HarmonyOS SDK 及工具下載完成,點擊 Finish,可以看到默認的 SDK Platforms > Java SDK及SDK Tools > Toolchains 已完成下載。

- 如果工程還會用到 JS 或者 C/C++ 語言,請在 SDK Platform 中,勾選對應(yīng)的 SDK 包,點擊 Apply,SDK Manager 會自動將 SDK 包和工具鏈,下載到3中設(shè)置的 SDK 存儲路徑中。(JS SDK 下載失敗或者緩慢?)

開發(fā)環(huán)境配置完成后,可以通過運行HelloWorld工程來驗證環(huán)境設(shè)置是否正確。
更多建議: