haihong Os 鸿蒙开源版开发一个pc版软件应用1文档版本v1.0.0适用平台HarmonyOS 6.0.2PC / 2in1 设备包名Bundle Namecom.example.hongmeng_pcdemo1应用版本1.0.0versionCode: 1000000更新时间2026-03-17目录项目简介环境要求目录结构说明构建打包4.1 使用 DevEco Studio 构建4.2 使用命令行构建HAP 包说明安装部署6.1 通过 HDC 工具安装6.2 通过 DevEco Studio 一键部署6.3 通过华为应用市场发布签名配置常见问题版本历史1. 项目简介Hongmeng_PCDemo1是基于haihong Os 鸿蒙开源版开发的 PC 端2in1 设备示例应用程序。支持设备类型手机phone、折叠屏/二合一设备2in1开发框架ArkTS ArkUIStage 模型SDK 版本HarmonyOS SDK 6.0.2(22)编译工具Hvigor 6.22.3主入口EntryAbilityohos.want.action.home2. 环境要求开发环境工具/组件版本要求说明DevEco Studio5.0.x 及以上推荐使用最新稳定版HarmonyOS SDK6.0.2(22) 及以上compatibleSdkVersion 6.0.2(22)Node.jsv18.x内置或 v20.xDevEco Studio 内置 v18.20.1Hvigor6.22.3随 DevEco Studio 安装OHPM随 DevEco Studio包管理器操作系统Windows 10/11、macOS 12、Ubuntu 20.04建议 Windows 或 macOS运行环境设备类型系统版本要求手机phoneHarmonyOS 6.0.2 及以上二合一设备2in1 / PCHarmonyOS 6.0.2 及以上3. 目录结构说明Hongmeng_PCDemo1/ ├── AppScope/ # 应用级资源 │ ├── app.json5 # 应用基础信息包名、版本等 │ └── resources/ # 应用级公共资源图标等 ├── entry/ # 主模块entry module │ ├── src/ │ │ └── main/ │ │ ├── ets/ # ArkTS 源码 │ │ │ ├── entryability/ # EntryAbility主入口 │ │ │ ├── entrybackupability/ # 备份扩展能力 │ │ │ └── pages/ # 页面文件 │ │ │ └── Index.ets # 主页面 │ │ ├── module.json5 # 模块配置设备类型、Ability 声明 │ │ └── resources/ # 模块级资源图片、字符串、颜色等 │ ├── build-profile.json5 # 模块构建配置 │ ├── hvigorfile.ts # 模块 Hvigor 插件配置 │ └── oh-package.json5 # 模块依赖声明 ├── hvigor/ │ └── hvigor-config.json5 # Hvigor 构建系统配置 ├── oh_modules/ # 三方依赖包ohpm 管理 ├── build-profile.json5 # 应用级构建配置产品/签名 ├── hvigorfile.ts # 应用级 Hvigor 入口 ├── oh-package.json5 # 应用级依赖声明 └── local.properties # 本地环境配置不提交 VCS说明oh_modules/目录类似node_modules由 ohpm 自动管理不需手动修改。4. 构建打包4.1 使用 DevEco Studio 构建推荐方式图形化操作自动处理依赖和签名。步骤使用 DevEco Studio 打开项目根目录Hongmeng_PCDemo1/等待 Gradle/Hvigor 同步完成首次可能需要下载依赖Debug 包调试用无需签名菜单Build→Build Hap(s)/APP(s)→Build Hap(s)或直接点击工具栏的 ▶ 运行按钮自动安装到已连接设备Release 包发布用需要签名菜单Build→Build Hap(s)/APP(s)→Build APP(s)需要提前配置签名见第 7 节构建产物路径entry/build/default/outputs/default/entry-default-unsigned.hap # Debug 未签名包 entry/build/default/outputs/default/entry-default-signed.hap # Release 签名包配置签名后4.2 使用命令行构建前置条件确保 DevEco Studio 已安装且已添加相关工具到环境变量。Windows 平台:: 设置 DevEco Studio 工具路径根据实际安装路径修改 set DEVECO_HOMEe:\soft\Huawei\DevEco Studio set NODE_PATH%DEVECO_HOME%\tools\node set PATH%NODE_PATH%;%PATH% :: 进入项目根目录 cd /d e:\HongMengProject\Hongmeng_PCDemo1 :: Debug 构建 call %DEVECO_HOME%\tools\hvigor\bin\hvigorw.bat assembleHap -p productdefault -p buildModedebug :: Release 构建需配置签名 call %DEVECO_HOME%\tools\hvigor\bin\hvigorw.bat assembleHap -p productdefault -p buildModereleasemacOS / Linux 平台# 设置 DevEco Studio 工具路径exportDEVECO_HOME/Applications/DevEco Studio.app/ContentsexportPATH$DEVECO_HOME/tools/node/bin:$PATH# 进入项目根目录cd/path/to/Hongmeng_PCDemo1# Debug 构建./hvigorw assembleHap-pproductdefault-pbuildModedebug# Release 构建./hvigorw assembleHap-pproductdefault-pbuildModerelease构建成功输出示例 hvigor Hvigor Daemon started in 1.74 s hvigor Task :entry:defaultcompileEts hvigor Task :entry:defaultgenerateResources hvigor Task :entry:defaultbuildHap hvigor BUILD SUCCESSFUL in 30 s5. HAP 包说明当前构建产物文件名类型大小说明entry-default-unsigned.hapDebug 未签名包~125 KB仅用于调试无法发布HAP 包内容pack.info{bundleName:com.example.hongmeng_pcdemo1,bundleType:app,version:{code:1000000,name:1.0.0},modules:[{mainAbility:EntryAbility,deviceType:[phone,2in1],moduleType:entry,installationFree:false,deliveryWithInstall:true,apiVersion:{compatible:22,target:22}}]}HAP vs APP类型说明用途.hap单个模块安装包调试安装、单模块更新.app多模块应用包应用市场发布6. 安装部署6.1 通过 HDC 工具安装HDCHarmonyOS Device Connector是华为提供的设备连接调试工具类似 Android 的adb。前置条件设备已开启开发者模式设备通过 USB 连接至电脑DevEco Studio 已安装内含 hdc 工具步骤# 1. 查看已连接设备hdc list targets# 2. 安装 HAP 包hdcinstallentry-default-unsigned.hap# 3. 验证安装查看已安装包列表hdc shell bm dump-a|grepcom.example.hongmeng_pcdemo1# 4. 启动应用hdc shell aa start-bcom.example.hongmeng_pcdemo1-aEntryAbility# 5. 卸载应用hdc uninstall com.example.hongmeng_pcdemo1HDC 工具路径Windowse:\soft\Huawei\SDK\default\openharmony\toolchains\hdc.exe或e:\soft\Huawei\DevEco Studio\tools\node\..\..\..\SDK\...提示将 hdc 路径添加至系统 PATH 环境变量以便全局使用。6.2 通过 DevEco Studio 一键部署步骤连接目标设备USB / WiFi 调试DevEco Studio 工具栏选择目标设备点击运行按钮▶或按ShiftF10DevEco Studio 将自动完成编译 → 打包 → 安装 → 启动6.3 通过华为应用市场发布仅适用于已配置有效签名的Release版本发布流程准备签名证书见第 7 节构建 APP 包DevEco Studio →Build→Build Hap(s)/APP(s)→Build APP(s)登录华为应用市场访问 AppGallery Connect创建应用填写应用名称、包名com.example.hongmeng_pcdemo1、应用类型上传 APP 包并填写版本信息审核发布通常 1-3 个工作日7. 签名配置7.1 获取签名证书登录 AppGallery Connect进入我的项目→HarmonyOS 应用→证书管理申请调试证书调试用或发布证书发布用下载.cer证书文件和.p12密钥文件7.2 配置 build-profile.json5{ app: { signingConfigs: [ { name: default, type: HarmonyOS, material: { certpath: 签名文件.cer 的绝对路径, storePassword: 密钥库密码加密, keyAlias: 密钥别名, keyPassword: 密钥密码加密, profile: 描述文件.p7b 的绝对路径, signAlg: SHA256withECDSA, storeFile: 密钥库文件.p12 的绝对路径 } } ], products: [ { name: default, signingConfig: default, targetSdkVersion: 6.0.2(22), compatibleSdkVersion: 6.0.2(22), runtimeOS: HarmonyOS } ] } }安全提醒签名文件和密码属于敏感信息不要提交到版本控制系统。请将local.properties或专用.gitignore规则配置好。8. 常见问题Q1构建报错Path not found. At file: .../entry原因hvigor 在某些 Windows 路径环境下无法正确解析模块路径通常与路径包含空格或中文字符有关。解决方案推荐使用 DevEco Studio 图形界面执行构建已验证可正常构建命令行构建时确保 DevEco Studio 安装路径中无空格或将项目移至无空格的纯英文路径下如D:\HarmonyProjects\PCDemo1Q2安装时报错sign info inconsistent原因HAP 包签名与设备信任的证书不匹配或使用了未签名包。解决方案调试设备使用 DevEco Studio 运行自动处理调试签名发布设备配置正确的发布证书后重新打包Q3HDC 找不到设备list targets为空解决方案确认设备已开启开发者选项和USB 调试更换 USB 数据线确保非仅充电线重启 HDC 服务hdc kill hdc start检查 USB 驱动是否正确安装WindowsQ4设备类型2in1是什么2in1是 HarmonyOS 对二合一设备如平板键鼠套装、折叠屏 PC的设备类型标识。当前项目同时支持phone和2in1意味着该应用可运行于鸿蒙手机及 PC 形态设备。Q5如何查看应用日志# 实时查看所有日志hdc hilog# 过滤应用相关日志hdc hilog|grepcom.example.hongmeng_pcdemo1# 按标签过滤hdc hilog-TEntryAbility9. 版本历史版本日期说明v1.0.02026-03-17初始版本支持 phone 和 2in1 设备类型基础 Hello World 示例10. 开发步骤1新建一个鸿蒙pc版应用2选择模拟器设备类型选2In1应用创建好项目后结构如下新建一个设备管理器点击运行模拟器点击运行到项目自动部署到模拟器中附录关键配置速查配置项值Bundle Namecom.example.hongmeng_pcdemo1应用版本1.0.0code: 1000000SDK 版本6.0.2(22)目标设备phone, 2in1主 AbilityEntryAbility安装方式deliveryWithInstall: true免安装installationFree: falseHvigor 版本6.22.3有其他需要讨论的可以交流或者关注博主名片后续发布更多的实用教程作者51diysoft haihong Os 鸿蒙开源版开发一个pc版软件应用（1）
haihong Os 鸿蒙开源版开发一个pc版软件应用1文档版本v1.0.0适用平台HarmonyOS 6.0.2PC / 2in1 设备包名Bundle Namecom.example.hongmeng_pcdemo1应用版本1.0.0versionCode: 1000000更新时间2026-03-17目录项目简介环境要求目录结构说明构建打包4.1 使用 DevEco Studio 构建4.2 使用命令行构建HAP 包说明安装部署6.1 通过 HDC 工具安装6.2 通过 DevEco Studio 一键部署6.3 通过华为应用市场发布签名配置常见问题版本历史1. 项目简介Hongmeng_PCDemo1是基于haihong Os 鸿蒙开源版开发的 PC 端2in1 设备示例应用程序。支持设备类型手机phone、折叠屏/二合一设备2in1开发框架ArkTS ArkUIStage 模型SDK 版本HarmonyOS SDK 6.0.2(22)编译工具Hvigor 6.22.3主入口EntryAbilityohos.want.action.home2. 环境要求开发环境工具/组件版本要求说明DevEco Studio5.0.x 及以上推荐使用最新稳定版HarmonyOS SDK6.0.2(22) 及以上compatibleSdkVersion 6.0.2(22)Node.jsv18.x内置或 v20.xDevEco Studio 内置 v18.20.1Hvigor6.22.3随 DevEco Studio 安装OHPM随 DevEco Studio包管理器操作系统Windows 10/11、macOS 12、Ubuntu 20.04建议 Windows 或 macOS运行环境设备类型系统版本要求手机phoneHarmonyOS 6.0.2 及以上二合一设备2in1 / PCHarmonyOS 6.0.2 及以上3. 目录结构说明Hongmeng_PCDemo1/ ├── AppScope/ # 应用级资源 │ ├── app.json5 # 应用基础信息包名、版本等 │ └── resources/ # 应用级公共资源图标等 ├── entry/ # 主模块entry module │ ├── src/ │ │ └── main/ │ │ ├── ets/ # ArkTS 源码 │ │ │ ├── entryability/ # EntryAbility主入口 │ │ │ ├── entrybackupability/ # 备份扩展能力 │ │ │ └── pages/ # 页面文件 │ │ │ └── Index.ets # 主页面 │ │ ├── module.json5 # 模块配置设备类型、Ability 声明 │ │ └── resources/ # 模块级资源图片、字符串、颜色等 │ ├── build-profile.json5 # 模块构建配置 │ ├── hvigorfile.ts # 模块 Hvigor 插件配置 │ └── oh-package.json5 # 模块依赖声明 ├── hvigor/ │ └── hvigor-config.json5 # Hvigor 构建系统配置 ├── oh_modules/ # 三方依赖包ohpm 管理 ├── build-profile.json5 # 应用级构建配置产品/签名 ├── hvigorfile.ts # 应用级 Hvigor 入口 ├── oh-package.json5 # 应用级依赖声明 └── local.properties # 本地环境配置不提交 VCS说明oh_modules/目录类似node_modules由 ohpm 自动管理不需手动修改。4. 构建打包4.1 使用 DevEco Studio 构建推荐方式图形化操作自动处理依赖和签名。步骤使用 DevEco Studio 打开项目根目录Hongmeng_PCDemo1/等待 Gradle/Hvigor 同步完成首次可能需要下载依赖Debug 包调试用无需签名菜单Build→Build Hap(s)/APP(s)→Build Hap(s)或直接点击工具栏的 ▶ 运行按钮自动安装到已连接设备Release 包发布用需要签名菜单Build→Build Hap(s)/APP(s)→Build APP(s)需要提前配置签名见第 7 节构建产物路径entry/build/default/outputs/default/entry-default-unsigned.hap # Debug 未签名包 entry/build/default/outputs/default/entry-default-signed.hap # Release 签名包配置签名后4.2 使用命令行构建前置条件确保 DevEco Studio 已安装且已添加相关工具到环境变量。Windows 平台:: 设置 DevEco Studio 工具路径根据实际安装路径修改 set DEVECO_HOMEe:\soft\Huawei\DevEco Studio set NODE_PATH%DEVECO_HOME%\tools\node set PATH%NODE_PATH%;%PATH% :: 进入项目根目录 cd /d e:\HongMengProject\Hongmeng_PCDemo1 :: Debug 构建 call %DEVECO_HOME%\tools\hvigor\bin\hvigorw.bat assembleHap -p productdefault -p buildModedebug :: Release 构建需配置签名 call %DEVECO_HOME%\tools\hvigor\bin\hvigorw.bat assembleHap -p productdefault -p buildModereleasemacOS / Linux 平台# 设置 DevEco Studio 工具路径exportDEVECO_HOME/Applications/DevEco Studio.app/ContentsexportPATH$DEVECO_HOME/tools/node/bin:$PATH# 进入项目根目录cd/path/to/Hongmeng_PCDemo1# Debug 构建./hvigorw assembleHap-pproductdefault-pbuildModedebug# Release 构建./hvigorw assembleHap-pproductdefault-pbuildModerelease构建成功输出示例 hvigor Hvigor Daemon started in 1.74 s hvigor Task :entry:defaultcompileEts hvigor Task :entry:defaultgenerateResources hvigor Task :entry:defaultbuildHap hvigor BUILD SUCCESSFUL in 30 s5. HAP 包说明当前构建产物文件名类型大小说明entry-default-unsigned.hapDebug 未签名包~125 KB仅用于调试无法发布HAP 包内容pack.info{bundleName:com.example.hongmeng_pcdemo1,bundleType:app,version:{code:1000000,name:1.0.0},modules:[{mainAbility:EntryAbility,deviceType:[phone,2in1],moduleType:entry,installationFree:false,deliveryWithInstall:true,apiVersion:{compatible:22,target:22}}]}HAP vs APP类型说明用途.hap单个模块安装包调试安装、单模块更新.app多模块应用包应用市场发布6. 安装部署6.1 通过 HDC 工具安装HDCHarmonyOS Device Connector是华为提供的设备连接调试工具类似 Android 的adb。前置条件设备已开启开发者模式设备通过 USB 连接至电脑DevEco Studio 已安装内含 hdc 工具步骤# 1. 查看已连接设备hdc list targets# 2. 安装 HAP 包hdcinstallentry-default-unsigned.hap# 3. 验证安装查看已安装包列表hdc shell bm dump-a|grepcom.example.hongmeng_pcdemo1# 4. 启动应用hdc shell aa start-bcom.example.hongmeng_pcdemo1-aEntryAbility# 5. 卸载应用hdc uninstall com.example.hongmeng_pcdemo1HDC 工具路径Windowse:\soft\Huawei\SDK\default\openharmony\toolchains\hdc.exe或e:\soft\Huawei\DevEco Studio\tools\node\..\..\..\SDK\...提示将 hdc 路径添加至系统 PATH 环境变量以便全局使用。6.2 通过 DevEco Studio 一键部署步骤连接目标设备USB / WiFi 调试DevEco Studio 工具栏选择目标设备点击运行按钮▶或按ShiftF10DevEco Studio 将自动完成编译 → 打包 → 安装 → 启动6.3 通过华为应用市场发布仅适用于已配置有效签名的Release版本发布流程准备签名证书见第 7 节构建 APP 包DevEco Studio →Build→Build Hap(s)/APP(s)→Build APP(s)登录华为应用市场访问 AppGallery Connect创建应用填写应用名称、包名com.example.hongmeng_pcdemo1、应用类型上传 APP 包并填写版本信息审核发布通常 1-3 个工作日7. 签名配置7.1 获取签名证书登录 AppGallery Connect进入我的项目→HarmonyOS 应用→证书管理申请调试证书调试用或发布证书发布用下载.cer证书文件和.p12密钥文件7.2 配置 build-profile.json5{ app: { signingConfigs: [ { name: default, type: HarmonyOS, material: { certpath: 签名文件.cer 的绝对路径, storePassword: 密钥库密码加密, keyAlias: 密钥别名, keyPassword: 密钥密码加密, profile: 描述文件.p7b 的绝对路径, signAlg: SHA256withECDSA, storeFile: 密钥库文件.p12 的绝对路径 } } ], products: [ { name: default, signingConfig: default, targetSdkVersion: 6.0.2(22), compatibleSdkVersion: 6.0.2(22), runtimeOS: HarmonyOS } ] } }安全提醒签名文件和密码属于敏感信息不要提交到版本控制系统。请将local.properties或专用.gitignore规则配置好。8. 常见问题Q1构建报错Path not found. At file: .../entry原因hvigor 在某些 Windows 路径环境下无法正确解析模块路径通常与路径包含空格或中文字符有关。解决方案推荐使用 DevEco Studio 图形界面执行构建已验证可正常构建命令行构建时确保 DevEco Studio 安装路径中无空格或将项目移至无空格的纯英文路径下如D:\HarmonyProjects\PCDemo1Q2安装时报错sign info inconsistent原因HAP 包签名与设备信任的证书不匹配或使用了未签名包。解决方案调试设备使用 DevEco Studio 运行自动处理调试签名发布设备配置正确的发布证书后重新打包Q3HDC 找不到设备list targets为空解决方案确认设备已开启开发者选项和USB 调试更换 USB 数据线确保非仅充电线重启 HDC 服务hdc kill hdc start检查 USB 驱动是否正确安装WindowsQ4设备类型2in1是什么2in1是 HarmonyOS 对二合一设备如平板键鼠套装、折叠屏 PC的设备类型标识。当前项目同时支持phone和2in1意味着该应用可运行于鸿蒙手机及 PC 形态设备。Q5如何查看应用日志# 实时查看所有日志hdc hilog# 过滤应用相关日志hdc hilog|grepcom.example.hongmeng_pcdemo1# 按标签过滤hdc hilog-TEntryAbility9. 版本历史版本日期说明v1.0.02026-03-17初始版本支持 phone 和 2in1 设备类型基础 Hello World 示例10. 开发步骤1新建一个鸿蒙pc版应用2选择模拟器设备类型选2In1应用创建好项目后结构如下新建一个设备管理器点击运行模拟器点击运行到项目自动部署到模拟器中附录关键配置速查配置项值Bundle Namecom.example.hongmeng_pcdemo1应用版本1.0.0code: 1000000SDK 版本6.0.2(22)目标设备phone, 2in1主 AbilityEntryAbility安装方式deliveryWithInstall: true免安装installationFree: falseHvigor 版本6.22.3有其他需要讨论的可以交流或者关注博主名片后续发布更多的实用教程作者51diysoft