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

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


文章目录

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

参考文档 :

  • hdc(HarmonyOS Device Connector)文档
  • 设备连接后,无法识别设备的处理指导
  • 真机调试流程

一、错误记录


手机 使用的是 HarmonyOS 4.2.0 系统 ;

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

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

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

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

C:\\Users\\octop>adb devicesList of devices attachedPXUYD22628020934 device

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

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

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

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

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

二、问题排查


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

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

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

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

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

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

HarmonyOS 5.0.0 版本 是 API 12 版本 ,

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

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

低版本的 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 等目录 , 该

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

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

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

分析下可能存在的问题 :

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

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

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

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

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

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

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

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

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

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


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