第2課：開發環境搭建與工具鏈

📚 課程目標

• 掌握DevEco Studio的下載、安裝和配置
• 熟悉HMS Core（華為移動服務）的使用
• 了解鴻蒙模擬器與真機調試環境
• 掌握必備開發工具的使用

🛠? DevEco Studio環境搭建

2.1 下載與安裝

系統要求

• Windows: Windows 10 64位及以上版本
• macOS: macOS 10.15及以上版本
• Linux: Ubuntu 18.04及以上版本
• 內存: 8GB以上（推薦16GB）
• 存儲: 10GB以上可用空間

下載步驟

1. 訪問HarmonyOS開發者官網
2. 點擊"開發工具" → “DevEco Studio”
3. 選擇對應操作系統版本下載
4. 下載完成后運行安裝程序

安裝配置

# 安裝完成后，首次啟動配置
1. 選擇UI主題（推薦深色主題）
2. 配置SDK路徑
3. 安裝必要的SDK組件
4. 配置模擬器路徑

2.2 基礎配置

SDK配置

• API版本: 選擇最新的API 9或API 10
• 構建工具: 配置Gradle和構建工具
• 模擬器: 下載并配置模擬器鏡像

項目配置

// project.json 基礎配置
{"name": "MyHarmonyApp","type": "application","srcEntry": "./ets/entryability/EntryAbility.ets","srcEntry": "./ets/pages/Index.ets"
}

🔧 HMS Core（華為移動服務）

2.3 HMS Core簡介

HMS Core是華為移動服務生態的核心，為鴻蒙應用提供豐富的系統能力。

核心服務

• 賬號服務：用戶身份認證
• 推送服務：消息推送
• 地圖服務：位置服務
• 支付服務：移動支付
• 云存儲：數據存儲

2.4 集成配置

添加依賴

// module.json5
{"dependencies": ["@ohos/hms-core": "^6.0.0"]
}

權限申請

// module.json5
{"requestPermissions": [{"name": "ohos.permission.INTERNET","reason": "用于網絡請求","usedScene": {"abilities": ["EntryAbility"],"when": "always"}}]
}

📱 鴻蒙模擬器與真機調試

2.5 模擬器配置

創建模擬器

1. 打開DevEco Studio
2. 點擊"Tools" → “Device Manager”
3. 選擇"Create Device"
4. 選擇設備類型和系統版本
5. 配置模擬器參數

模擬器類型

• 手機模擬器：測試手機應用
• 平板模擬器：測試平板應用
• 智慧屏模擬器：測試大屏應用
• 穿戴設備模擬器：測試穿戴應用

2.6 真機調試

設備準備

1. 開啟開發者選項
2. 啟用USB調試
3. 連接電腦并授權調試

調試配置

# 查看連接設備
hdc list targets# 安裝應用
hdc install -r app-debug.hap# 查看日志
hdc shell hilog

🛠? 必備開發工具

2.7 命令行工具

HDC（HarmonyOS Device Connector）

# 基礎命令
hdc list targets          # 列出設備
hdc shell                 # 進入設備shell
hdc file send             # 傳輸文件
hdc file recv             # 接收文件
hdc install               # 安裝應用
hdc uninstall             # 卸載應用

常用調試命令

# 查看應用日志
hdc shell hilog | grep "MyApp"# 查看系統信息
hdc shell cat /proc/version# 查看應用進程
hdc shell ps | grep "MyApp"

2.8 Git版本控制

初始化項目

# 創建Git倉庫
git init# 添加遠程倉庫
git remote add origin <repository-url># 首次提交
git add .
git commit -m "Initial commit"
git push -u origin main

分支管理

# 創建功能分支
git checkout -b feature/new-feature# 合并分支
git checkout main
git merge feature/new-feature# 刪除分支
git branch -d feature/new-feature

2.9 包管理工具

npm/yarn配置

// package.json
{"name": "my-harmony-app","version": "1.0.0","dependencies": {"@ohos/hypium": "^1.0.0"},"devDependencies": {"@ohos/hvigor": "^1.0.0"}
}

安裝依賴

# 使用npm
npm install# 使用yarn
yarn install# 安裝特定版本
npm install @ohos/hypium@1.0.0

🎯 實踐練習

2.10 環境搭建練習

任務1：安裝DevEco Studio

1. 下載并安裝DevEco Studio
2. 配置開發環境
3. 創建第一個Hello World項目

任務2：配置模擬器

1. 創建手機模擬器
2. 運行Hello World應用
3. 熟悉模擬器操作

任務3：命令行工具使用

1. 安裝HDC工具
2. 連接模擬器
3. 執行基礎命令

🚨 常見問題與解決方案

2.11 安裝問題

• 問題：安裝過程中卡住

• 解決：檢查網絡連接，使用VPN或鏡像源

• 問題：SDK下載失敗

• 解決：更換下載源，檢查防火墻設置

2.12 運行問題

• 問題：模擬器啟動失敗

• 解決：檢查虛擬化設置，更新顯卡驅動

• 問題：應用安裝失敗

• 解決：檢查簽名配置，清理緩存

📚 擴展資源

2.13 官方文檔

• DevEco Studio使用指南
• HMS Core集成指南
• 真機調試指南

2.14 社區資源

• 華為開發者社區
• 鴻蒙開發者論壇
• GitHub開源項目

---

下一課預告：第3課 - 鴻蒙架構與編程模型