【错误记录】Windows 中 DevEco Studio 真机调试无法连接设备 ( 低版本的 HarmonyOS 4.2.0 华为手机无法在 DevEco Studio 5.0.2 上真机调试 )

embedded/2025/3/4 7:06:55/

文章目录

一、错误记录
二、问题排查
三、解决方案

参考文档 :

hdc（HarmonyOS Device Connector）文档
设备连接后，无法识别设备的处理指导
真机调试流程

一、错误记录

手机使用的是 HarmonyOS 4.2.0 系统 ;

在这里插入图片描述

使用 HarmonyOS 的 hdc 工具 , 执行 hdc list targets 命令查看设备 , 显示为空 ;

C:\Users\octop>hdc list targets
start server at tcp:7035
[Empty]

Android 的 adb 可以连接设备 , 执行 adb devices 命令 , 可以看到该设备 ;

C:\Users\octop>adb devices
List of devices attached
PXUYD22628020934        device

在这里插入图片描述

此时在 Android Studio 中是可以进行真机调试的 ,

在这里插入图片描述

但是在 DevEco Studio 中 , 无法进行真机调试 ;

在这里插入图片描述

二、问题排查

参考设备连接后，无法识别设备的处理指导文档 , 进行问题排查 ;

大概率是手机系统与 DevEco Studio版本不配套导致的 ;

参考版本概览 HarmonyOS 5.0.0(12) 版本概览页面 ,

在这里插入图片描述

参考 HarmonyOS版本映射关系对照表 ,

当前的手机版本号是 HarmonyOS 4.0 的版本 , 只兼容 API 9 版本 ;

HarmonyOS 5.0.0 版本是 API 12 版本 ,

开发环境 DevEco Studio 和手机系统都要是 5.0 版本以上的 ;

在这里插入图片描述

低版本的 HarmonyOS 4.2.0 华为手机无法在最新版的 DevEco Studio 5.0.2 上进行真机调试 ;

手机版本必须达到 HarmonyOS 5.0.0 以上才行 ;

三、解决方案

安装了最新的 DevEco Studio 5.0.2 Release 开发环境之后 , 发现无法进行真机调试 , 这里再参考【OpenHarmony】Windows 平台搭建 DevEco Studio 开发环境 ① ( 安装 Node.js / ohpm | 安装配置 SDK | 环境变量配置 | 新建项目示例 ) 博客 , 将 DevEco Studio 4.0 再次安装回来 ;

下载 devecostudio-windows-4.0.0.600.zip 文件后 , 解压安装 , 与博客【OpenHarmony】Windows 平台搭建 DevEco Studio 开发环境 ① ( 安装 Node.js / ohpm | 安装配置 SDK | 环境变量配置 | 新建项目示例 ) 二、HUAWEI DevEco Studio 安装 1、安装 DevEco Studio 环境步骤是一样的 ;

启动后 , 配置之前的 nodejs , ohpm , Sdk 等目录 , 该

在这里插入图片描述

@Entry
@Component
struct Index {@State message: string = 'Hello World';build() {RelativeContainer() {Text(this.message).id('HelloWorld').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%')}
}