引入：從想法到運行的第一行代碼

在上一篇中，我們瞭解了HarmonyOS作為分佈式操作系統的獨特價值。現在，讓我們邁出實踐的第一步——搭建開發環境。作為HarmonyOS官方集成開發環境，DevEco Studio為開發者提供了開箱即用的開發體驗，將HarmonyOS SDK、Node.js、OHPM等工具合一打包，大大簡化了安裝配置流程。

本文將用最簡潔明瞭的方式，帶你完成從軟件下載到創建第一個Hello World應用的全過程，讓你在10分鐘內開啓HarmonyOS應用開發之旅。

講解：一步步搭建開發環境

環境準備與下載

在開始安裝前，請確保你的電腦滿足以下基本要求：

操作系統要求：

  • Windows：Windows 10/11 64位
  • macOS：macOS 11/12/13/14（ARM或X86架構）

硬件配置建議：

  • 內存：8GB及以上（推薦16GB）
  • 硬盤：100GB及以上可用空間
  • 分辨率：1280×800像素及以上

下載地址：

訪問HarmonyOS開發者官網（developer.harmonyos.com）的DevEco Studio產品頁下載最新版本。

安裝過程詳解

Windows系統安裝步驟：

  1. 雙擊下載的deveco-studio-xxxx.exe文件啓動安裝嚮導
  2. 選擇安裝路徑（建議使用非中文路徑，避免C盤系統分區）
  3. 勾選創建桌面快捷方式等選項
  4. 點擊Install開始安裝，完成後點擊Finish

macOS系統安裝步驟：

  1. 雙擊下載的deveco-studio-xxxx.dmg文件
  2. 將DevEco-Studio.app拖拽到Applications文件夾中
  3. 等待複製完成即可

首次運行與配置

首次啓動DevEco Studio時，配置嚮導會引導你完成必要的環境設置：

  1. 選擇設置導入：首次使用選擇"Do not import settings"
  2. Node.js安裝：工具會自動檢測並安裝合適版本的Node.js（要求v14.19.1及以上，且低於v17.0.0）
  3. SDK配置：DevEco Studio新版本已內置HarmonyOS SDK，無需額外下載，提供開箱即用的體驗
  4. 代理配置（如需要）：僅在企業網絡受限時才需要配置代理服務器

配置HDC工具環境變量

HDC是HarmonyOS應用的調試工具，需要配置環境變量以便使用：

Windows環境配置：

# 在環境變量中添加：
HDC_SERVER_PORT=7035
# 並在Path中添加HDC工具路徑

macOS環境配置：

# 編輯.bash_profile或.zshrc文件，添加：
export HDC_SERVER_PORT=7035

創建第一個HarmonyOS應用

現在讓我們創建第一個Hello World應用來驗證環境：

  1. 新建項目： 在歡迎界面點擊"Create Project" 選擇"Empty Ability"模板 配置項目名稱、包名和保存路徑
  2. 項目結構解析： entry/src/main/ets/：存放ArkTS代碼 entry/src/main/resources/：資源文件目錄 config.json：應用配置文件
  3. 核心代碼預覽： 打開entry/src/main/ets/MainPage.ets文件，可以看到基本的頁面結構：
@Entry
@Component
struct Index {
  @State message: string = 'Hello HarmonyOS'

  build() {
    Column() {
      Text(this.message)
        .fontSize(30)
      Button('Click Me')
        .onClick(() => {
          this.message = 'Button Clicked!'
        })
    }
    .width('100%')
    .height('100%')
  }
}

運行與預覽

使用預覽器（推薦初學者）：

  • 點擊DevEco Studio右側的預覽器圖標
  • 即可實時查看UI效果，支持熱更新

使用模擬器：

  1. 點擊"Tools" → "Device Manager"
  2. 選擇"Local Emulator"標籤頁
  3. 下載需要的設備鏡像並啓動模擬器

真機調試：

  1. 開啓手機開發者模式（設置→關於手機→連續點擊版本號7次）
  2. 啓用USB調試功能
  3. 連接電腦後選擇真機運行

總結：環境搭建完成，準備啓航

通過本篇指導，你已經成功完成了：

✅ DevEco Studio的下載與安裝

✅ 開發環境的基本配置

✅ 第一個HarmonyOS項目的創建

✅ 應用運行與預覽的掌握

常見問題解決提示：

  • 如遇網絡問題，可配置npm鏡像源加速下載
  • 安裝失敗時可嘗試以管理員身份運行安裝程序
  • 環境問題可使用"Help > Diagnostic Tools"進行診斷

現在你的開發環境已經準備就緒！在下一篇文章中，我們將深入分析HarmonyOS項目的工程結構，理解各個文件和目錄的作用，為後續開發打下堅實基礎。

行動建議：在繼續下一篇之前，建議嘗試修改Hello World應用中的文字內容，體驗實時預覽效果，熟悉基本的開發流程。