一、必备工具清单

1. 核心开发工具

• DevEco Studio（官方 IDE）
• Node.js（uni-app 需要）
• HBuilderX（可选，用于 uni-app 开发）

2. 系统要求

• Windows：Windows 10 64 位或更高
• macOS：macOS 10.14 或更高
• 内存：8GB 以上（推荐 16GB）
• 硬盘：至少 10GB 可用空间

二、详细安装步骤

步骤一：安装 Node.js

1. 下载 Node.js
   • 访问：https://nodejs.org/
   • 下载 LTS 版本（推荐 16.x 或 18.x）
   • 你的项目使用 uni-app，需要 Node.js 环境
2. 安装验证

   # 检查 Node.js 版本
   node -v
   # 应该显示：v16.x.x 或 v18.x.x
   
   # 检查 npm 版本
   npm -v
   

3. 配置 npm（可选，使用国内镜像）

   npm config set registry https://registry.npmmirror.com
   

步骤二：安装 DevEco Studio

1. 下载 DevEco Studio
   • 访问：https://developer.harmonyos.com/
   • 下载最新版本的 DevEco Studio
   • 支持 Windows、macOS、Linux
2. 安装步骤

   1. 运行安装程序
   2. 选择安装路径（建议不要安装在 C 盘根目录）
   3. 选择组件：
      - DevEco Studio
      - HarmonyOS SDK
      - 模拟器（可选，占用空间较大）
   4. 完成安装
   

3. 首次启动配置

   1. 启动 DevEco Studio
   2. 选择 "Do not import settings"（首次安装）
   3. 接受许可协议
   4. 选择主题（Light/Dark）
   5. 配置 SDK 路径（默认即可）
   6. 等待 SDK 下载完成
   

步骤三：配置 HarmonyOS SDK

1. 打开 SDK 管理器

   File -> Settings -> Appearance & Behavior -> System Settings -> HarmonyOS SDK
   

2. 下载必要的 SDK 组件

   必须下载：
   - HarmonyOS SDK（最新版本）
   - JS SDK（用于 uni-app）
   - Toolchains
   - Platform Tools
   
   可选下载：
   - System Images（用于模拟器）
   - Samples（示例代码）
   

3. 配置 SDK 路径

   // 你的项目 manifest.json 中可以看到配置
   
   // SDK 路径通常在：
   
   // Windows: C:\Users\用户名\AppData\Local\Huawei\Sdk
   
   // macOS: ~/Library/Huawei/Sdk
   

步骤四：安装 HBuilderX（uni-app 开发）

1. 下载 HBuilderX
   • 访问：https://www.dcloud.io/hbuilderx.html
   • 下载正式版（推荐）或 Alpha 版
2. 安装步骤

   1. 解压下载的压缩包
   2. 运行 HBuilderX.exe（Windows）或 HBuilderX.app（macOS）
   3. 首次启动会提示安装插件
   

3. 安装 uni-app 插件

   1. 工具 -> 插件安装
   2. 搜索 "uni-app"
   3. 安装 uni-app 编译插件
   4. 安装 uni-app 运行插件
   

步骤五：配置 uni-app 鸿蒙支持

1. 检查 uni-app 版本

   # 在你的项目根目录
   npm list [@dcloudio](/user/dcloudio)/uni-app
   # 确保版本支持鸿蒙（3.0+）
   

2. 安装依赖（你的项目）

   # 在项目根目录执行
   npm install
   # 或
   yarn install
   

3. 配置 manifest.json（你的项目已有）

   {
       "app-harmony": {
           "darkmode": true,
           "themeLocation": "theme.json",
           "safearea": {
               "background": "#F7F8F2",
               "backgroundDark": "#121212"
           },
           "distribute": {
               "bundleName": "com.ysy.coms",
               "signingConfigs": {
                   "default": {
                       "certpath": "...",
                       "keyAlias": "debugKey",
                       "storeFile": "...",
                       "storePassword": "..."
                   }
               }
           }
       }
   }
   

三、开发环境验证

1. 创建测试项目

在 DevEco Studio 中：

1. File -> New -> Create Project
2. 选择 “Empty Ability (JS)”
3. 填写项目信息
4. 点击 Finish

2. 验证 uni-app 项目

在你的项目中：

# 检查项目结构
# 应该包含：
# - manifest.json（已配置鸿蒙）
# - pages.json
# - App.vue
# - main.js

3. 运行测试

# 在 HBuilderX 中
# 运行 -> 运行到手机或模拟器 -> 运行到 HarmonyOS 设备
# 或在命令行
npm run dev:harmony

四、签名证书配置

1. 生成调试证书（开发用）

在 DevEco Studio 中：

1. File -> Project Structure -> Signing Configs
2. 点击 “Create” 创建新证书
3. 填写证书信息：
   • Key Store Path: 选择存储路径
   • Key Store Password: 设置密码
   • Key Alias: debugKey
   • Key Password: 设置密码
4. 点击 OK

2. 配置到项目（你的项目已配置）

// manifest.json
"signingConfigs": {
    "default": {
        "certpath": "证书路径.cer",
        "keyAlias": "debugKey",
        "keyPassword": "密码",
        "profile": "配置文件.p7b",
        "storeFile": "密钥库.p12",
        "storePassword": "密码"
    }
}

五、真机调试配置

1. 开启开发者模式

在鸿蒙设备上：

1. 设置 -> 关于手机
2. 连续点击"版本号" 7 次
3. 输入锁屏密码
4. 开启"开发者选项"

2. 开启 USB 调试

1. 设置 -> 系统和更新 -> 开发者选项
2. 开启"USB 调试"
3. 开启"仅充电模式下允许 ADB 调试"（可选）

3. 连接设备

# 检查设备连接
adb devices
# 应该显示设备列表
# 如果未识别，安装驱动：
# Windows: 安装华为手机助手
# macOS: 通常自动识别

六、模拟器配置（可选）

1. 下载系统镜像

在 DevEco Studio 中：

1. Tools -> Device Manager
2. 点击 “New Device”
3. 选择设备类型（手机/平板）
4. 选择系统版本
5. 点击 “Download” 下载镜像

2. 创建模拟器

1. 下载完成后，点击 “Finish”
2. 在设备列表中选择模拟器
3. 点击 “Start” 启动

七、常见问题解决

1. SDK 下载失败

解决方案：

# 使用代理或镜像
# 在 DevEco Studio 中：
# File -> Settings -> Appearance & Behavior -> System Settings -> HTTP Proxy
# 配置代理服务器

2. 编译错误

检查清单：

1. Node.js 版本是否正确（16.x 或 18.x）
2. npm 依赖是否完整安装
3. manifest.json 配置是否正确
4. SDK 路径是否正确

3. 真机无法连接

解决方案：

# 1. 检查 USB 驱动
# 2. 重启 adb 服务
adb kill-server
adb start-server
# 3. 检查 USB 连接模式
# 设置为"文件传输"或"MTP"模式

4. 签名证书错误

解决方案：

1. 检查证书路径是否正确
2. 检查证书密码是否正确
3. 重新生成证书
4. 确保证书文件存在

八、项目配置检查清单

1. 检查 manifest.json

你的项目配置：

{
    "name": "养生源",
    "appid": "__UNI__92D0C35",
    "app-harmony": {
        "darkmode": true,
        "themeLocation": "theme.json",
        "distribute": {
            "bundleName": "com.ysy.coms",
            "signingConfigs": { ... }
        }
    }
}

2. 检查 pages.json

确保包含：

{
    "pages": [
        {
            "path": "pages/home/index",
            "style": {
                "navigationBarTitleText": "首页"
            }
        }
    ],
    "tabBar": { ... }
}

3. 检查 App.vue

你的项目已包含：

// 系统信息初始化
initSystemInfo() {
    const systemInfo = uni.getSystemInfoSync()
    // ...
}
// 主题系统初始化
initTheme() {
    // ...
}

九、开发工具推荐

1. 代码编辑器

• DevEco Studio（主要）
• HBuilderX（uni-app 开发）
• VS Code（可选，用于代码编辑）

2. 调试工具

• DevEco Studio 调试器
• Chrome DevTools（H5 调试）
• adb 命令行工具

3. 辅助工具

• Git（版本控制）
• Postman（API 测试）
• Charles/Fiddler（网络抓包）

十、环境变量配置（可选）

Windows

# 添加到系统环境变量
HARMONY_HOME=C:\Users\用户名\AppData\Local\Huawei\Sdk
PATH=%PATH%;%HARMONY_HOME%\toolchains

macOS/Linux

# 添加到 ~/.bash_profile 或 ~/.zshrc
export HARMONY_HOME=~/Library/Huawei/Sdk
export PATH=$PATH:$HARMONY_HOME/toolchains

十一、快速验证脚本

创建 check-env.js：

// 检查开发环境
const fs = require('fs')
const { execSync } = require('child_process')
console.log('=== 鸿蒙开发环境检查 ===\n')

// 检查 Node.js
try {
    const nodeVersion = execSync('node -v', { encoding: 'utf-8' })
    console.log('✓ Node.js:', nodeVersion.trim())
} catch (e) {
    console.log('✗ Node.js 未安装')
}

// 检查 npm
try {
    const npmVersion = execSync('npm -v', { encoding: 'utf-8' })
    console.log('✓ npm:', npmVersion.trim())
} catch (e) {
    console.log('✗ npm 未安装')
}

// 检查项目文件
const files = ['manifest.json', 'pages.json', 'App.vue', 'main.js']
files.forEach(file => {
    if (fs.existsSync(file)) {
        console.log('✓', file, '存在')
    } else {
        console.log('✗', file, '不存在')
    }
})

// 检查 manifest.json 中的鸿蒙配置
try {
    const manifest = JSON.parse(fs.readFileSync('manifest.json', 'utf-8'))
    if (manifest['app-harmony']) {
        console.log('✓ 鸿蒙配置已存在')
    } else {
        console.log('✗ 鸿蒙配置不存在')
    }
} catch (e) {
    console.log('✗ manifest.json 解析失败')
}

console.log('\n=== 检查完成 ===')

运行：
node check-env.js

十二、总结

必备工具

1. Node.js（16.x 或 18.x）
2. DevEco Studio（最新版）
3. HBuilderX（uni-app 开发）
4. HarmonyOS SDK（通过 DevEco Studio 安装）

配置要点

1. manifest.json 中配置 app-harmony
2. 签名证书配置
3. 系统信息获取适配
4. 主题系统配置

验证步骤

1. 创建测试项目
2. 运行到模拟器/真机
3. 检查日志输出
4. 验证功能正常

常见问题

• SDK 下载：使用代理或镜像
• 证书错误：检查路径和密码
• 真机连接：检查 USB 驱动和调试模式
• 编译错误：检查依赖和配置

你的项目已配置好鸿蒙环境，可直接参考 manifest.json 和 App.vue 中的配置。如遇问题，优先检查 SDK 路径、证书配置和依赖安装。