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

参考文档 :

• 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 等目录 , 该

评论区有兄弟回复 , 发现安装回 DevEco Studio 4.0 版本时 时 , 原来可以真机调试 , 现在也无法识别真机了 ,

分析下可能存在的问题 :

• ① 使用 HarmonyOS 的 API , 不要使用 OpenHarmony API ;
• ② 使用 API 9 及以下的 API ;
• ③ 不要使用 DevEco Studio 4.0 版本 打开 DevEco Studio 5.0 创建的应用 ;

打开 DevEco Studio 发现 可以识别 HarmonyOS 4.2 的真机 ;

真机调试 只能使用 HarmonyOS 的 API 9 版本 , 暂时 不要使用 OpenHarmony 版本的 API ;

在 build-profile.json5 配置文件中 , 查看 SDK 版本号 , 一定要小于等于 9 , 大于 API 9 就是 纯血鸿蒙了 ;

{
  "app": {
    "signingConfigs": [],
    "compileSdkVersion": 9,
    "compatibleSdkVersion": 9,
    "products": [
      {
        "name": "default",
        "signingConfig": "default",
      }
    ],
    "buildModeSet": [
      {
        "name": "debug",
      },
      {
        "name": "release"
      }
    ]
  },

同时打开 DevEco Studio 4.0 和 5.0 版本 , 4.0 可以真机调试 , 5.0 无法真机调试 ;

---

@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%')
  }
}