配置OpenHarmony SDK

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

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

前提條件

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

配置SDK信息

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

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

1. 運行已安裝的DevEco Studio，首次使用，請選擇 Do not import settings ，點擊OK。

2. 進入配置向?qū)ы撁妫O(shè)置 npm registry ，DevEco Studio已預(yù)置對應(yīng)的倉，直接點擊 Start using DevEco Studio進入下一步。

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

   

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

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

4. 在彈出的SDK下載信息頁面，點擊 Next ，并在彈出的 License Agreement窗口，點擊 Accept開始下載SDK。

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

   

5. 等待OpenHarmony SDK及工具下載完成，點擊 Finish ，界面會進入到DevEco Studio歡迎頁。

參考信息

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

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

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

配置DevEco Studio代理

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

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

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

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

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

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

配置NPM代理

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

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

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

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

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

1. 進入用戶的users目錄，打開 .npmrc文件。

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

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

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

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

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

   npm info express
   

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

   

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

設(shè)置Gradle代理

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

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

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

審核編輯 黃宇