準備HarmonyOS開發環境

引言

在開始 HarmonyOS 開發之前，需要準備好開發環境。本章將詳細指導你如何安裝 HarmonyOS SDK、設定開發環境、建立 HarmonyOS 專案。

確保你的計算機上已經安裝了 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 開發了。

準備HarmonyOS開發環境

引言

目錄

1. 安裝 HarmonyOS SDK

1.1 下載 HarmonyOS SDK

1.2 安裝 HarmonyOS SDK

2. 設定開發環境

2.1 設定 JDK

2.2 設定開發環境

2.3 設定模擬器

2.4 設定 IDE

3. 建立 HarmonyOS 專案

3.1 選擇專案模板

3.2 設定專案

3.3 建立專案

3.4 工程目錄結構

4. 總結