一、系統準備與下載

1. 系統要求

• 操作系統 ：Windows 10/11（64 位）、macOS 11 及以上（X86/ARM）、Linux（需自行編譯）。
• 硬件配置 ：至少 8GB 內存、100GB 硬盤空間，推薦 16GB 內存 + SSD 以提升編譯速度。

2. 下載 DevEco Studio

• 官網下載 ：訪問?[?華為開發者官網?]?，點擊「立即下載」獲取最新穩定版（如 5.0.5.306）。
• 版本選擇 ：
• Release版：適合生產環境，功能成熟。
• Beta1 版 ：適合嘗鮮，包含最新特性但可能不穩定。

二、安裝與初始化

1. 安裝步驟（以 Windows 為例）

1. 解壓安裝包 ：下載完成后，解壓?devecostudio-windows-xxx.zip?? 到指定目錄（如?D:HuaweiDevEco Studio?）。
2. 啟動安裝向導 ：運行?devecostudio.exe?，選擇安裝路徑（建議非系統盤），勾選「添加到環境變量」以方便命令行調用。
3. 安裝依賴 ：安裝過程中會自動下載并安裝 OpenJDK 1.8 （內置）、Gradle等工具。

2. 首次啟動配置

1. 導入設置 ：首次啟動時選擇「Do not import settings」，跳過舊配置遷移。
2. 登錄華為賬號 ：點擊右上角頭像登錄，用于訪問云服務、下載模擬器鏡像等。
3. 安裝 HarmonyOS SDK ：

• 進入 Settings > OpenHarmony SDK ，選擇需要的 SDK 版本（如 API 12 ），點擊「Download」安裝。
• 若網絡受限，可提前在官網下載離線包，通過「Add Local SDK」導入。

三、創建第一個 Hello World 應用

1. 新建項目

1. 選擇模板 ：點擊 Create HarmonyOS Project ，選擇設備類型（如 Phone）和模板（如 Empty Ability ）。
2. 配置項目 ：輸入應用名稱、包名（如?com.example.myapp?），選擇兼容的 SDK 版本（需與模擬器一致）。
3. 等待同步 ：項目創建后，Gradle 會自動下載依賴（首次可能較慢，可通過替換鏡像源加速）。

2. 編寫代碼

• ArkTS 示例 （?entry/src/main/ets/pages/Index.ets?）：

@Entry
@Component
struct Index{
  @State message: string = 'Hello World';

  build() {
    RelativeContainer() {
      Text(this.message)
        .id('ThreeHelloWorld')
        .fontSize($r('app.float.page_text_font_size'))
        .fontWeight(FontWeight.Bold)
        .alignRules({
          center: { anchor: '__container__', align: VerticalAlign.Center },
          middle: { anchor: '__container__', align: HorizontalAlign.Center }
        })
        .onClick(() = > {
          this.message = 'Welcome';
        })
    }
    .height('100%')
    .width('100%')
  }
}

3. 運行與調試

1. 啟動模擬器 ：

• 點擊 Tools > HVD Manager ，選擇設備類型（如 Huawei_Phone ），下載并啟動模擬器。
• 若設備 API 版本與項目不匹配，需在Project Structure中調整?compileSdkVersion?? 和?targetSdkVersion?。

2. 編譯運行 ：點擊工具欄Run按鈕（或按?Shift+F10?），選擇模擬器設備，等待應用安裝并啟動。

四、無網絡環境下的安裝與使用

1. 離線下載依賴

1. SDK 離線包 ：

• 在聯網設備上訪問?[?HarmonyOS SDK 下載頁面?]??，下載所需 SDK 版本的離線包（如?openharmony-sdk-windows-xxx.zip?）1020。
• 將離線包拷貝到離線設備，通過Settings > OpenHarmony SDK > Add Local SDK導入。

2. Gradle 配置 ：

• 提前下載 Gradle 壓縮包（如?gradle-8.6-bin.zip??），解壓到本地目錄（如?D:gradle?）。
• 修改項目?gradle/wrapper/gradle-wrapper.properties??，將?distributionUrl? 指向本地路徑：

distributionUrl=file:///D:/gradle/gradle-8.6-bin.zip

• 同步項目后，Gradle 將使用本地文件。

2. 手動安裝插件

• 中文語言包 ：提前下載?chinese-simplified-intellij-2023.2.zip?，通過Settings > Plugins > Install from Disk安裝。

五、常見問題與優化

1. Gradle 下載失敗

• 解決方案 ：
• 替換為國內鏡像源：在?gradle.properties? 中添加：

org.gradle.daemon=true
org.gradle.jvmargs=-Xmx4g
android.useAndroidX=true
android.enableJetifier=true
# 騰訊云鏡像
distributionUrl=https://mirrors.cloud.tencent.com/gradle/gradle-8.6-bin.zip

• 使用代理工具（如 Charles）加速下載。

2. 模擬器啟動失敗

• 檢查項 ：
• 確保電腦啟用虛擬化技術（BIOS 中開啟 Intel VT-x/AMD-V）。
• 關閉殺毒軟件或添加信任目錄。

·##鴻蒙開發工具##DevEco Studio##商務#

審核編輯 黃宇