配置OpenHarmony SDK

在設(shè)置OpenHarmony應(yīng)用開(kāi)發(fā)環(huán)境時(shí)，需要開(kāi)發(fā)者在DevEco Studio中配置對(duì)應(yīng)的SDK信息。

說(shuō)明：
請(qǐng)注意，OpenHarmony SDK版本精簡(jiǎn)了部分工具鏈，因此不適用于HarmonyOS應(yīng)用開(kāi)發(fā)。

前提條件

已下載并安裝好DevEco Studio 3.0 Beta1及以上版本。
鴻蒙開(kāi)發(fā)指導(dǎo)文檔：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

配置SDK信息

HarmonyOS與OpenHarmony鴻蒙文檔籽料：mau123789是v直接拿

DevEco Studio通過(guò)SDK Manager統(tǒng)一管理SDK及工具鏈，OpenHarmony包含如下SDK包：

1. 運(yùn)行已安裝的DevEco Studio，首次使用，請(qǐng)選擇 Do not import settings ，點(diǎn)擊OK。

2. 進(jìn)入配置向?qū)ы?yè)面，設(shè)置 npm registry ，DevEco Studio已預(yù)置對(duì)應(yīng)的倉(cāng)，直接點(diǎn)擊 Start using DevEco Studio進(jìn)入下一步。

   說(shuō)明：
   如果配置向?qū)Ы缑娉霈F(xiàn)的是設(shè)置 Set up HTTP Proxy界面，說(shuō)明網(wǎng)絡(luò)受限，請(qǐng)根據(jù)[參考信息]配置DevEco Studio代理、NPM代理和Gradle代理后，再下載OpenHarmony SDK。

   

3. DevEco Studio向?qū)е敢_(kāi)發(fā)者下載SDK，默認(rèn)下載OpenHarmony SDK。SDK下載到user目錄下，也可以指定對(duì)應(yīng)的存儲(chǔ)路徑，SDK存儲(chǔ)路徑不支持中文字符，然后點(diǎn)擊 Next 。

   說(shuō)明：
   如果不是首次安裝DevEco Studio，可能無(wú)法查看進(jìn)入該界面，可通過(guò)歡迎頁(yè)的 Configure （或圖標(biāo)）> Settings > SDK Manager > OpenHarmony SDK界面，點(diǎn)擊 OpenHarmony SDK Location加載SDK。

4. 在彈出的SDK下載信息頁(yè)面，點(diǎn)擊 Next ，并在彈出的 License Agreement窗口，點(diǎn)擊 Accept開(kāi)始下載SDK。

   說(shuō)明：
   下載SDK過(guò)程中，如果出現(xiàn)下載JS SDK失敗，提示“Install js dependencies failed”，請(qǐng)根據(jù)[JS SDK安裝失敗處理指導(dǎo)]進(jìn)行處理。

   

5. 等待OpenHarmony SDK及工具下載完成，點(diǎn)擊 Finish ，界面會(huì)進(jìn)入到DevEco Studio歡迎頁(yè)。

參考信息

DevEco Studio開(kāi)發(fā)環(huán)境需要依賴(lài)于網(wǎng)絡(luò)環(huán)境，需要連接上網(wǎng)絡(luò)才能確保工具的正常使用。

一般來(lái)說(shuō)，如果使用的是個(gè)人或家庭網(wǎng)絡(luò)，是不需要設(shè)置代理信息的；只有部分企業(yè)網(wǎng)絡(luò)受限的情況下，才需要設(shè)置代理信息。

如果是第一次打開(kāi)DevEco Studio，配置向?qū)Ы缑娉霈F(xiàn)設(shè)置 Set up HTTP Proxy界面，說(shuō)明網(wǎng)絡(luò)受限，可以通過(guò)配置代理的方式來(lái)解決，需要配置DevEco Studio代理、NPM代理和Gradle代理。

配置DevEco Studio代理

1. 啟動(dòng)DevEco Studio，配置向?qū)нM(jìn)入 Set up HTTP Proxy界面，勾選 Manual proxy configuration ，設(shè)置DevEco Studio的HTTP Proxy。

   說(shuō)明：
   如果非首次設(shè)置向?qū)нM(jìn)入HTTP Proxy，可以通過(guò)如下方式進(jìn)入HTTP Proxy配置界面：

   • 在歡迎頁(yè)點(diǎn)擊 Configure（或圖標(biāo)） > Settings > Appearance & Behavior > System Settings > HTTP Proxy進(jìn)入HTTP Proxy設(shè)置界面（Mac系統(tǒng)為 Configure > Preferences > Appearance & Behavior > System Settings > HTTP Proxy )。
   • 在打開(kāi)了工程的情況下，可以點(diǎn)擊 File > Settings > Appearance & Behavior > System Settings > HTTP Proxy進(jìn)入HTTP Proxy設(shè)置界面（Mac系統(tǒng)為 DevEco Studio > Preferences > Appearance & Behavior > System Settings > HTTP Proxy ）

   • HTTP配置項(xiàng)，設(shè)置代理服務(wù)器信息。 如果不清楚代理服務(wù)器信息，可以咨詢(xún)你們的網(wǎng)絡(luò)管理人員 。
     • Host name ：代理服務(wù)器主機(jī)名或IP地址。
     • Port number ：代理服務(wù)器對(duì)應(yīng)的端口號(hào)。
     • No proxy for ：不需要通過(guò)代理服務(wù)器訪(fǎng)問(wèn)的URL或者IP地址（地址之間用英文逗號(hào)分隔）。
   • Proxy authentication配置項(xiàng)，如果代理服務(wù)器需要通過(guò)認(rèn)證鑒權(quán)才能訪(fǎng)問(wèn)，則需要設(shè)置。否則，請(qǐng)?zhí)^(guò)該配置項(xiàng)。
     • Login ：訪(fǎng)問(wèn)代理服務(wù)器的用戶(hù)名。
     • Password ：訪(fǎng)問(wèn)代理服務(wù)器的密碼。
     • Remember ：勾選，記住密碼。

2. 配置完成后，點(diǎn)擊 Check connection ，輸入網(wǎng)絡(luò)地址（如：[[https://developer.harmonyos.com），檢查網(wǎng)絡(luò)連通性。提示Connection] successful表示代理設(shè)置成功。]

3. 點(diǎn)擊 Next: Configure npm繼續(xù)設(shè)置NPM代理信息，請(qǐng)參考[配置NPM代理]。

配置NPM代理

通過(guò)DevEco Studio的設(shè)置向?qū)гO(shè)置NPM代理信息，代理信息將寫(xiě)入用戶(hù)“users/用戶(hù)名/”目錄下的 .npmrc文件。

說(shuō)明：
該向?qū)е挥械谝淮伟惭bDevEco Studio才會(huì)出現(xiàn)。如果未出現(xiàn)該向?qū)?，可以直接在“users/用戶(hù)名/”目錄下的 .npmrc文件中，添加代理配置信息。

• npm registry：設(shè)置npm倉(cāng)的地址信息，建議勾選。
• HTTP proxy：代理服務(wù)器信息，默認(rèn)會(huì)與DevEco Studio的HTTP proxy設(shè)置項(xiàng)保持一致。
• Enable Https Proxy：同步設(shè)置HTTPS Proxy配置信息，建議勾選。

然后點(diǎn)擊 Start using DevEco Studio繼續(xù)下一步操作。

如果代理服務(wù)器需要認(rèn)證（需要用戶(hù)名和密碼），請(qǐng)先根據(jù)如下指導(dǎo)配置代理服務(wù)器的用戶(hù)名和密碼信息，然后再下載OpenHarmony SDK；否則，請(qǐng)?zhí)^(guò)該操作，參考[配置SDK信息]進(jìn)行操作即可。

1. 進(jìn)入用戶(hù)的users目錄，打開(kāi) .npmrc文件。

2. 修改npm代理信息，在proxy和https-proxy中，增加user和password字段，具體取值請(qǐng)以實(shí)際代理信息為準(zhǔn)。示例如下所示：

   proxy=http://user:password@proxy.server.com:80
   https-proxy=http://user:password@proxy.server.com:80
   

   說(shuō)明：
   如果password中存在特殊字符，如@、#、*等符號(hào)，可能導(dǎo)致配置不生效，建議將特殊字符替換為ASCII碼，并在ASCII碼前加百分號(hào)%。常用符號(hào)替換為ASCII碼對(duì)照表如下：

   • !：%21
   • @：%40
   • #：%23
   • ￥：%24
   • &：%26
   • *：%2A

3. 代理設(shè)置完成后，打開(kāi)命令行工具，執(zhí)行如下命令進(jìn)行驗(yàn)證網(wǎng)絡(luò)是否正常。

   npm info express
   

   執(zhí)行結(jié)果如下圖所示，則說(shuō)明代理設(shè)置成功。

   

4. 網(wǎng)絡(luò)設(shè)置完成后，然后再[配置SDK信息]。

設(shè)置Gradle代理

1. 打開(kāi)“此電腦”，在文件夾地址欄中輸入 %userprofile% （Mac系統(tǒng)請(qǐng)點(diǎn)擊 前往 > 個(gè)人 ），進(jìn)入個(gè)人用戶(hù)文件夾。
2. 創(chuàng)建一個(gè)文件夾，命名為 .gradle 。如果已有.gradle文件夾，請(qǐng)?zhí)^(guò)此操作。

   說(shuō)明：
   macOS系統(tǒng)創(chuàng)建.gradle文件夾前，請(qǐng)將系統(tǒng)設(shè)置為“顯示隱藏文件”。

3. 進(jìn)入.gradle文件夾，新建一個(gè)文本文檔，命名為 gradle ，并修改后綴為 .properties 。
4. 打開(kāi) gradle.properties文件中，添加如下腳本，然后保存。 其中代理服務(wù)器、端口、用戶(hù)名、密碼和不使用代理的域名，請(qǐng)根據(jù)實(shí)際代理情況進(jìn)行修改。其中不使用代理的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
   

審核編輯 黃宇