一、搭建開發(fā)環(huán)境流程

• DevEco Studio 支持 Windows 系統(tǒng)和 macOS 系統(tǒng)，在開發(fā) HarmonyOS 應(yīng)用前，需要準(zhǔn)備 HarmonyOS 應(yīng)用的開發(fā)環(huán)境。環(huán)境準(zhǔn)備流程如下所示：

• 如上圖所示，搭建 HarmonyOS 應(yīng)用開發(fā)的環(huán)境包括軟件安裝、配置開發(fā)環(huán)境和運(yùn)行 HelloWorld 三個(gè)環(huán)節(jié)。

二、下載與安裝軟件

① Windows 環(huán)境

• 為保證 DevEco Studio 正常運(yùn)行，電腦配置需滿足如下要求：
• • 操作系統(tǒng)：Windows10 64位
• • 內(nèi)存：8GB及以上
• • 硬盤：100GB及以上
• • 分辨率：1280*800像素及以上
• 下載和安裝 DevEco Studio：
• • DevEco Studio 的編譯構(gòu)建依賴 JDK，DevEco Studio 預(yù)置了 Open JDK，版本為1.8，安裝過程中會自動安裝 JDK。
• • 進(jìn)入HUAWEI DevEco Studio產(chǎn)品頁，點(diǎn)擊下載列表后的下載按鈕，下載 DevEco Studio；
• • 下載完成后，雙擊下載的“deveco-studio-xxxx.exe”，進(jìn)入 DevEco Studio 安裝向?qū)?#xff0c;在如下安裝選項(xiàng)界面勾選 64-bit launcher 后，點(diǎn)擊 Next ，直至安裝完成；

• • 安裝完成后，點(diǎn)擊 Finish 完成安裝：

② macOS 環(huán)境

• 為保證 DevEco Studio 正常運(yùn)行，macOS 電腦配置需滿足如下要求：
• • 操作系統(tǒng)：macOS 10.14/10.15/11.2.2
• • 內(nèi)存：8GB及以上
• • 硬盤：100GB及以上
• • 分辨率：1280*800像素及以上
• 下載和安裝 DevEco Studio：
• • DevEco Studio 的編譯構(gòu)建依賴 JDK，DevEco Studio 預(yù)置了 Open JDK，版本為1.8，安裝過程中會自動安裝 JDK。
• • 進(jìn)入 HUAWEI DevEco Studio 產(chǎn)品頁，點(diǎn)擊下載列表后的按鈕，下載 DevEco Studio；
• • 下載完成后，雙擊下載的“deveco-studio-xxxx.dmg”軟件包；
• • 在安裝界面中，將“DevEco-Studio.app”拖拽到“Applications”中，等待安裝完成。

• 安裝完成后，先不要啟動 DevEco Studio，檢查和配置開發(fā)環(huán)境。

三、配置開發(fā)環(huán)境

• DevEco Studio 開發(fā)環(huán)境需要依賴于網(wǎng)絡(luò)環(huán)境，需要連接上網(wǎng)絡(luò)才能確保工具的正常使用。
• 一般來說，如果使用的是個(gè)人或家庭網(wǎng)絡(luò)，是不需要設(shè)置代理信息的；只有部分企業(yè)網(wǎng)絡(luò)受限的情況下，才需要設(shè)置代理信息。可通過如下方式檢查是否需要使用代理。
• 查看是否需要使用代理才能訪問 Internet 的方法，以 Chrome 瀏覽器為例：點(diǎn)擊瀏覽器設(shè)置選項(xiàng)，進(jìn)入設(shè)置 > 高級 > 打開您計(jì)算機(jī)的代理設(shè)置，查看“手動設(shè)置代理”下是否打開了“使用代理服務(wù)器”開關(guān)，打開并設(shè)置了代理服務(wù)器，則表示您需要使用代理服務(wù)器訪問 Internet。
• 因此，可以根據(jù)如下兩種情況來配置開發(fā)環(huán)境：
• • 如果可以直接訪問 Internet，請根據(jù)可直接訪問網(wǎng)絡(luò)場景進(jìn)行操作。
• • 如果不能直接訪問 Internet，需要通過代理服務(wù)器才可以訪問，請根據(jù)需通過代理訪問網(wǎng)絡(luò)場景進(jìn)行操作。

① 可直接訪問網(wǎng)絡(luò)場景

• DevEco Studio 提供 SDK Manager 統(tǒng)一管理 SDK 及工具鏈，下載各種編程語言的 SDK 包時(shí)，SDK Manager 會自動下載該 SDK 包依賴的工具鏈。
• SDK Manager 提供多種編程語言的 SDK 包和工具鏈，具體說明請參考下表：

包名說明默認(rèn)是否下載參考

Native	C/C++語言SDK包	否	《Native API參考》
JS	JS語言SDK包	是	《JS API參考》
Java	Java語言SDK包	是	《Java API參考》
system-image	Phone設(shè)備的X86本地模擬器的SDK包	否	使用本地模擬器，需同時(shí)下載Emulator
Emulator	X86本地模擬器	否	使用本地模擬器，需同時(shí)下載system-image
Toolchains	SDK工具鏈，HarmonyOS應(yīng)用開發(fā)必備工具集，包括編譯、打包、簽名、數(shù)據(jù)庫管理等工具的集合	是	-
Previewer	HarmonyOS應(yīng)用預(yù)覽器，在開發(fā)過程中可以動態(tài)預(yù)覽Phone、TV、Wearable、LiteWearable等設(shè)備的應(yīng)用效果，支持JS和Java應(yīng)用預(yù)覽	是	使用預(yù)覽器查看應(yīng)用效果

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

• 默認(rèn)會下載最新版本的 HarmonyOS Java SDK、JS SDK、Previewer 和 Toolchains，在彈出的 License Agreement 窗口，點(diǎn)擊 Accept 開始下載SDK：

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

• SDK 默認(rèn)會下載 HarmonyOS Java SDK、JS SDK、Previewer 和 Toolchains，點(diǎn)擊上圖歡迎頁中的 Configure（或圖標(biāo)） > Settings，進(jìn)入 HarmonyOS SDK 頁面，可以下載其它組件，只需要勾選對應(yīng)的組件包，然后點(diǎn)擊 Apply 即可。

② 需通過代理訪問網(wǎng)絡(luò)場景

• 設(shè)置 Gradle 代理
• • 如果網(wǎng)絡(luò)不能直接訪問 Internet，而是需要通過代理服務(wù)器才可以訪問，這種情況下，需要設(shè)置 Gradle 代理，來訪問和下載 Gradle 所需的依賴。
• • 打開“此電腦”，在文件夾地址欄中輸入%userprofile%（Mac系統(tǒng)請點(diǎn)擊前往 > 個(gè)人），進(jìn)入個(gè)人用戶界面：
• • 創(chuàng)建一個(gè)文件夾，命名為 .gradle。如果已有 .gradle 文件夾，請?zhí)^此操作（注意：macOS 系統(tǒng)創(chuàng)建 .gradle 文件夾前，請將系統(tǒng)設(shè)置為“顯示隱藏文件”）；
• • 進(jìn)入 .gradle 文件夾，新建一個(gè)文本文檔，命名為 gradle，并修改后綴為 .properties；
• • 打開 gradle.properties 文件中，添加如下腳本，然后保存。其中代理服務(wù)器、端口、用戶名、密碼和不使用代理的域名，請根據(jù)實(shí)際代理情況進(jìn)行修改。其中不使用代理的“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 代理，來訪問和下載外部資源。
• • 運(yùn)行已安裝的 DevEco Studio，首次使用，請選擇 Do not import settings，點(diǎn)擊 OK。
• • DevEco Studio 會啟動設(shè)置向?qū)?#xff0c;進(jìn)入 Set up HTTP Proxy 界面，勾選 Manual proxy configuration，設(shè)置 DevEco Studio 的 HTTP Proxy。

如果非首次設(shè)置向?qū)нM(jìn)入HTTP Proxy，您可以通過如下方式進(jìn)入HTTP Proxy配置界面：在歡迎頁點(diǎn)擊Configure > Settings > Appearance & Behavior > System Settings > HTTP Proxy進(jìn)入HTTP Proxy設(shè)置界面（Mac系統(tǒng)為Configure > Preferences > Appearance & Behavior > System Settings > HTTP Proxy）。在打開了工程的情況下，可以點(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ù)器信息，可以咨詢你們的網(wǎng)絡(luò)管理人員。
• • • Host name：代理服務(wù)器主機(jī)名或IP地址。
• • • Port number：代理服務(wù)器對應(yīng)的端口號。
• • • No proxy for：不需要通過代理服務(wù)器訪問的 URL 或者 IP 地址（地址之間用英文逗號分隔）。
• • Proxy authentication 配置項(xiàng)，如果代理服務(wù)器需要通過認(rèn)證鑒權(quán)才能訪問，則需要設(shè)置。否則，請?zhí)^該配置項(xiàng)。
• • • Login：訪問代理服務(wù)器的用戶名。
• • • Password：訪問代理服務(wù)器的密碼。
• • • Remember：勾選，記住密碼。

• • 配置完成后，點(diǎn)擊 Check connection，輸入網(wǎng)絡(luò)地址（如：https://developer.harmonyos.com），檢查網(wǎng)絡(luò)連通性。提示“Connection successful”表示代理設(shè)置成功。
• • 點(diǎn)擊 Next: Configure npm 繼續(xù)設(shè)置 NPM 代理信息。
• • DevEco Studio 代理設(shè)置完成后，會提示安裝 HarmonyOS SDK，繼續(xù)安裝相應(yīng)的 SDK 即可。

• 設(shè)置 npm 代理
• • 通過 DevEco Studio 的設(shè)置向?qū)гO(shè)置 NPM 代理信息，代理信息將寫入用戶 users 目錄下的 .npmrc 文件。
• • npm registry：設(shè)置 npm 倉的地址信息，建議勾選。
• • Http Proxy：代理服務(wù)器信息，默認(rèn)會與 DevEco Studio 的 HTTP Proxy 設(shè)置項(xiàng)保持一致。
• • Enable Https Proxy：同步設(shè)置 HTTPS Proxy 配置信息，建議勾選。

• • 然后點(diǎn)擊 Start using DevEco Studio 繼續(xù)下一步操作，如果您的代理服務(wù)器需要認(rèn)證（需要用戶名和密碼），請?jiān)?DevEco Studio 向?qū)Ы缑鏁簳r(shí)不要操作下一步，先根據(jù)如下指導(dǎo)配置代理服務(wù)器的用戶名和密碼信息。
• • 進(jìn)入用戶的 users 目錄，打開 .npmrc 文件，修改 npm 代理信息，在 proxy 和 https-proxy 中，增加 user 和 password 字段，具體取值請以實(shí)際代理信息為準(zhǔn)。示例如下所示：

proxy=http://user:password@proxy.server.com:80https-proxy=http://user:password@proxy.server.com:80 如果password中存在特殊字符，如@、#、*等符號，可能導(dǎo)致配置不生效，建議將特殊字符替換為ASCII碼，并在ASCII碼前加百分號%。常用符號替換為ASCII碼對照表如下：!：%21@：%40#：%23￥：%24&：%26*：%2A+：%2B

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

npm info express

四、下載 HarmonyOS SDK

① SDK 下載和安裝

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

• 默認(rèn)會下載最新版本的 HarmonyOS Java SDK、JS SDK、Previewer 和 Toolchains，在彈出的 License Agreement 窗口，點(diǎn)擊 Accept 開始下載 SDK。
• 等待 HarmonyOS SDK 及工具下載完成，點(diǎn)擊 Finish，界面會進(jìn)入到 DevEco Studio 歡迎頁。

• SDK 默認(rèn)會下載 HarmonyOS Java SDK、JS SDK、Previewer 和 Toolchains，點(diǎn)擊上圖歡迎頁中的 Configure > Settings，進(jìn)入 HarmonyOS SDK 頁面，可以下載其它組件，只需要勾選對應(yīng)的組件包，然后點(diǎn)擊 Apply 即可。

② JS SDK 安裝失敗處理

• 下載 JS SDK 時(shí)，下載失敗，提示“Install Js dependencies failed”。
• JS SDK 下載失敗，一般情況下，主要是由于 npm 代理配置問題，或未清理 npm 緩存信息導(dǎo)致，可按照如下方法進(jìn)行處理：
• • 檢查網(wǎng)絡(luò)是否受限，如果需要通過代理才能訪問網(wǎng)絡(luò)，可根據(jù) NPM 代理配置指導(dǎo)，配置代理服務(wù)器信息。如果網(wǎng)絡(luò)不受限，可跳過該步驟。
• • 如果已安裝 Node.js 或者設(shè)置了 npm 環(huán)境變量，則打開命令行工具，執(zhí)行如下命令，清理 npm 緩存

npm cache clean -f

• • 如果未安裝 Node.js，請進(jìn)入到 DevEco Studio 安裝目錄下的 tools\nodejs 目錄下打開命令行工具，執(zhí)行如下命令：

.\npm cache clean -f

• • 在歡迎頁點(diǎn)擊 Configure > Settings > HarmonyOS SDK，勾選 Js SDK，點(diǎn)擊 Apply 重新進(jìn)行下載：

五、創(chuàng)建和運(yùn)行 Hello World

① 創(chuàng)建和配置新工程

• 打開 DevEco Studio，在歡迎頁點(diǎn)擊 Create HarmonyOS Project，創(chuàng)建一個(gè)新工程。根據(jù)工程創(chuàng)建向?qū)?#xff0c;選擇需要的 Ability 工程模板，然后點(diǎn)擊 Next。
• 如果已經(jīng)打開了工程，可以在菜單欄選擇 File > New > New Project 來創(chuàng)建一個(gè)新工程。

• 點(diǎn)擊 Next，進(jìn)入到工程配置階段，需要根據(jù)向?qū)渲霉こ痰幕拘畔ⅰ?/li>
• • Project Name：工程的名稱，可以自定義。
• • Project Type：工程的類型，標(biāo)識該工程是一個(gè)原子化服務(wù)（Atomic Service）或傳統(tǒng)方式的需要安裝的應(yīng)用。
• • Package Name：軟件包名稱，默認(rèn)情況下，應(yīng)用ID也會使用該名稱，應(yīng)用發(fā)布時(shí)，應(yīng)用ID需要唯一。
• • Save Location：工程文件本地存儲路徑。
• • Compatible API Version：兼容的SDK最低版本。
• • Device Type：該工程模板支持的設(shè)備類型，支持多選。如果勾選多個(gè)設(shè)備，表示該原子化服務(wù)或傳統(tǒng)方式的需要安裝的應(yīng)用支持部署在多個(gè)設(shè)備上。
• • Show in Service Center：是否在服務(wù)中心露出。如果 Project Type 為 Service，則會同步創(chuàng)建一個(gè)2 * 2的服務(wù)卡片模板，同時(shí)還會創(chuàng)建入口卡片；如果 Project Type為Application，則只會創(chuàng)建一個(gè)2 * 2的服務(wù)卡片模板。

如果是創(chuàng)建的原子化服務(wù)，則：原子化服務(wù)是免安裝的，config.json 中自動添加 installationFree 字段，取值為“true”。如果 entry 模塊的 installationFree 字段為 true，則其相關(guān)的所有 hap模塊的 installationFree 字段都默認(rèn)為 true；如果 entry 模塊的 installationFree 字段為 false，則其相關(guān)的所有 hap 模塊可以配置為 true 或 false。編譯構(gòu)建 App 時(shí)，每個(gè) hap 包大小不能超過 10MB。

• 點(diǎn)擊 Finish，工具會自動生成示例代碼和相關(guān)資源，等待工程創(chuàng)建完成。

② 使用模擬器運(yùn)行 Hello World

• 在 DevEco Studio 菜單欄，點(diǎn)擊 Tools > Device Manager。
• 在瀏覽器中彈出華為開發(fā)者聯(lián)盟帳號登錄界面，請輸入已實(shí)名認(rèn)證的華為開發(fā)者聯(lián)盟帳號的用戶名和密碼進(jìn)行登錄。

• 登錄后，請點(diǎn)擊界面的允許按鈕進(jìn)行授權(quán)。

• 授權(quán)成功：

• 同意協(xié)議：

• 在設(shè)備列表中，選擇 Phone 設(shè)備，并點(diǎn)擊運(yùn)行按鈕，運(yùn)行模擬器。

• 點(diǎn)擊 DevEco Studio 工具欄中的運(yùn)行按鈕運(yùn)行工程，或使用默認(rèn)快捷鍵Shift+F10（Mac為Control+R）運(yùn)行工程。

• DevEco Studio會啟動應(yīng)用的編譯構(gòu)建，完成后應(yīng)用即可運(yùn)行在模擬器上。

總結(jié)

以上是生活随笔為你收集整理的HarmonyOS之搭建和配置开发环境的流程的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔推薦給好友。