引言
在開始 HarmonyOS 開發之前，需要準備好開發環境。本章將詳細指導你如何安裝 HarmonyOS SDK、配置開發環境、創建 HarmonyOS 項目。
目錄
- 安裝 HarmonyOS SDK
- 配置開發環境
- 創建 HarmonyOS 項目
- 總結
1. 安裝 HarmonyOS SDK
HarmonyOS SDK 是開發 HarmonyOS 應用的軟件開發工具包。它包括了編譯器、模擬器、調試器等工具。
1.1 下載 HarmonyOS SDK
- 打開華為 HarmonyOS 官方網站。
- 跳轉到開發者社區。
- 在開發者社區，找到 HarmonyOS SDK 的下載頁面。
- 選擇適合你的操作系統的版本。
- 點擊“下載”按鈕，下載 HarmonyOS SDK。
1.2 安裝 HarmonyOS SDK
- 打開下載的 HarmonyOS SDK 安裝包。
- 雙擊安裝文件，啟動安裝程序。
- 按照安裝程序的指南，選擇安裝路徑，接受許可協議。
- 點擊“安裝”按鈕，開始安裝 HarmonyOS SDK。
- 安裝完成后，點擊“完成”按鈕。
2. 配置開發環境
配置開發環境是一個重要的步驟，它會影響到你的開發效率。
2.1 配置 JDK
- 確保你的計算機上已經安裝了 JDK。如果沒有安裝，請先安裝 JDK。
- 配置 JAVA_HOME 環境變量。
- 打開“控制面板”。
- 點擊“系統”。
- 點擊“高級系統設置”。
- 點擊“環境變量”。
- 在“系統變量”中，點擊“新建”。
- 輸入“變量名”為 JAVA_HOME。
- 輸入“變量值”為 JDK 的安裝路徑。
- 點擊“確定”按鈕。
2.2 配置開發環境
- 運行已安裝的DevEco Studio，首次使用，請選擇Do not import settings，單擊OK。
- 進入DevEco Studio操作向導頁面，修改npm registry，DevEco Studio已預置對應的倉（默認的npm倉，可能出現部分開發者無法訪問或訪問速度緩慢的情況），直接單擊Start using DevEco Studio進入下一步。
- 設置Node.js信息，可以指定本地已安裝的Node.js（Node.js版本要求為v14.19.1及以上，且低于v15.0.0；對應的npm版本要求為6.14.16及以上，且低于7.0.0版本）；如果本地沒有合適的版本，可以選擇Download按鈕，在線下載Node.js。本示例以下載Node.js為例，選擇下載源和存儲路徑后，單擊Next進入下一步。等待Node.js安裝完成，然后單擊Finish進入下一步。
- 在SDK Components Setup界面，設置OpenHarmony SDK和HarmonyOS SDK存儲路徑，單擊Next進入下一步。
- 在彈出的SDK下載信息頁面，單擊Next，并在彈出的License Agreement窗口，閱讀License協議，需同意License協議后（需同時接受OpenHarmony SDK和HarmonyOS SDK的License協議），單擊Next開始下載SDK。
- 等待SDK下載完成后，單擊Finish，完成SDK的下載，界面會進入到DevEco Studio歡迎頁。
- 配置HDC工具環境變量（Windows添加環境變量，添加HDC端口變量名為：HDC_SERVER_PORT，變量值可設置為任意未被占用的端口，如7035）
2.3 配置模擬器
- 打開 HarmonyOS SDK。
- 在 SDK 中，找到模擬器的配置頁面。
- 按照配置頁面的指南，配置模擬器。
2.4 配置 IDE
- 打開 HarmonyOS SDK。
- 在 SDK 中，找到 IDE 的配置頁面。
- 按照配置頁面的指南，配置 IDE。
3. 創建 HarmonyOS 項目
創建 HarmonyOS 項目是開始開發的第一步。
3.1 選擇項目模板
- 打開 HarmonyOS SDK。
- 在 SDK 中，找到“創建項目”頁面。
- 在“創建項目”頁面中，選擇一個項目模板。
3.2 配置項目
- 輸入項目的名稱。
- 輸入項目的包名。
- 選擇項目的目標平臺。
3.3 創建項目
- 點擊“創建”按鈕。
- HarmonyOS SDK 會自動創建項目。
3.4 工程目錄結構
- entry：HarmonyOS工程模塊，編譯構建生成一個HAP包。
- src > main > ets：用于存放ArkTS源碼。
- src > main > ets > MainAbility：應用/服務的入口。
- src > main > ets > pages：應用/服務包含的頁面。
- src > main > resources：用于存放應用/服務所用到的資源文件，如圖形、多媒體、字符串、布局文件等。關于資源文件的詳細說明請參考資源文件的分類。
- src > main > config.json：模塊配置文件。主要包含HAP包的配置信息、應用/服務在具體設備上的配置信息以及應用/服務的全局配置信息。具體的配置文件說明，詳見配置文件說明（JS/ArkTS）。
- build-profile.json5：當前的模塊信息 、編譯信息配置項，包括buildOption、targets配置等。
- hvigorfile.ts：模塊級編譯構建任務腳本，開發者可以自定義相關任務和代碼實現。
- build-profile.json5：應用級配置信息，包括簽名、產品配置等。
- hvigorfile.ts：應用級編譯構建任務腳本。
- 構建頁面：點擊“entry > src > main > ets > pages”，打開“index.ets”文件
@Entry
@Component
struct Index {
@State message: string = 'Hello World'
build() {
Row() {
Column() {
Text(this.message)
.fontSize(50)
.fontWeight(FontWeight.Bold)
Button() {
Text('Next').fontSize(30).fontWeight(FontWeight.Bold)
}.type(ButtonType.Capsule).margin({top:20}).backgroundColor('#0D9FFB').width('40%').height('5%')
}
.width('100%')
}
.height('100%')
}
}
4. 總結
本章詳細指導了你如何安裝 HarmonyOS SDK、配置開發環境、創建 HarmonyOS 項目。現在，你已經準備好開始 HarmonyOS 開發了。
