2026/2/9 17:02:56
网站建设
项目流程
附近网站建设服务公司,站长工具推荐网站,免费的png素材网,桂林软件开发网罗开发#xff08;小红书、快手、视频号同名#xff09;大家好#xff0c;我是 展菲#xff0c;目前在上市企业从事人工智能项目研发管理工作#xff0c;平时热衷于分享各种编程领域的软硬技能知识以及前沿技术#xff0c;包括iOS、前端、Harmony OS、Java、Python等方…网罗开发小红书、快手、视频号同名大家好我是展菲目前在上市企业从事人工智能项目研发管理工作平时热衷于分享各种编程领域的软硬技能知识以及前沿技术包括iOS、前端、Harmony OS、Java、Python等方向。在移动端开发、鸿蒙开发、物联网、嵌入式、云原生、开源等领域有深厚造诣。图书作者《ESP32-C3 物联网工程开发实战》图书作者《SwiftUI 入门进阶与实战》超级个体COC上海社区主理人特约讲师大学讲师谷歌亚马逊分享嘉宾科技博主华为HDE/HDG我的博客内容涵盖广泛主要分享技术教程、Bug解决方案、开发工具使用、前沿科技资讯、产品评测与使用体验。我特别关注云服务产品评测、AI 产品对比、开发板性能测试以及技术报告同时也会提供产品优缺点分析、横向对比并分享技术沙龙与行业大会的参会体验。我的目标是为读者提供有深度、有实用价值的技术洞察与分析。展菲您的前沿技术领航员 大家好我是展菲 全网搜索“展菲”即可纵览我在各大平台的知识足迹。 公众号“Swift社区”每周定时推送干货满满的技术长文从新兴框架的剖析到运维实战的复盘助您技术进阶之路畅通无阻。 微信端添加好友“fzhanfei”与我直接交流不管是项目瓶颈的求助还是行业趋势的探讨随时畅所欲言。 最新动态2025 年 3 月 17 日快来加入技术社区一起挖掘技术的无限潜能携手迈向数字化新征程文章目录前言问题背景模拟器启动黑屏无响应最简单的解决方案重启和清理缓存检查模拟器版本和 API 版本匹配检查设备类型匹配检查硬件加速设置检查电脑配置重新安装模拟器组件真机调试提示设备未授权开启开发者模式和 USB 调试连接电脑并授权检查 ADB 连接状态重置 USB 调试授权检查 USB 驱动检查端口占用使用无线调试可选实际应用场景场景一新项目首次调试场景二团队协作中的环境问题场景三持续集成中的调试问题调试技巧和最佳实践使用日志调试使用断点调试检查网络连接清理构建缓存检查依赖版本总结前言最近在开发鸿蒙应用的时候遇到了两个让人头疼的问题一个是模拟器启动后黑屏怎么点都没反应另一个是真机调试时提示设备未授权连不上设备。刚开始以为是代码问题后来才发现是开发环境配置的问题。相信很多鸿蒙开发者都遇到过类似的问题模拟器启动不了或者真机调试连不上。这些问题虽然看起来简单但如果不熟悉可能会折腾很久。今天我们就来聊聊这些常见问题的解决方案以及如何在实际开发中避免这些问题。问题背景在开发鸿蒙应用时我们通常需要用到两种调试方式模拟器调试和真机调试。模拟器调试适合快速开发和测试真机调试适合验证实际设备上的表现。但不管是哪种方式都可能遇到各种问题。最常见的问题有两个模拟器启动后黑屏无响应模拟器能启动但屏幕是黑的点击没反应应用也跑不起来真机调试提示设备未授权手机连上电脑后DevEco Studio 提示设备未授权无法调试这些问题虽然不影响代码编写但会严重影响开发效率。让我们一个个来看这些问题和解决方案。模拟器启动黑屏无响应模拟器启动后黑屏是一个很常见的问题可能的原因有很多。让我们从最简单的开始排查。最简单的解决方案重启和清理缓存很多时候模拟器黑屏只是因为临时卡住了或者 DevEco Studio 的缓存出了问题。这时候最简单的解决方法就是第一步关闭模拟器和 DevEco Studio先把模拟器完全关闭然后退出 DevEco Studio。不要只是最小化窗口要完全退出程序。第二步重新打开 DevEco Studio重新打开 DevEco Studio等待它完全加载完成。第三步清理缓存并重启在 DevEco Studio 中点击菜单栏的File→Invalidate Caches / Restart选择Invalidate and Restart。这会清理所有的缓存文件并重启 IDE。这个过程可能需要几分钟但很多时候能解决配置乱掉导致的问题。重启后再试试启动模拟器看看是否正常。检查模拟器版本和 API 版本匹配如果重启后还是黑屏那可能是版本不匹配的问题。这是最常见的原因之一。问题原因DevEco Studio 中的模拟器版本必须和你的项目使用的 API 版本一致。比如你的项目使用的是 API 10那模拟器也必须是 API 10 的版本。如果版本不匹配模拟器可能能启动但会出现黑屏或者无法正常运行应用。检查方法检查项目 API 版本打开项目的build-profile.json5文件查看apiCompatibility字段比如apiCompatibility: 10检查模拟器 API 版本在 DevEco Studio 中点击Tools→Device Manager查看已安装的模拟器列表每个模拟器都会显示对应的 API 版本解决方法如果版本不匹配有两种解决方案安装匹配的模拟器在Device Manager中点击New Emulator选择与项目 API 版本匹配的模拟器镜像下载并安装修改项目 API 版本不推荐修改build-profile.json5中的apiCompatibility字段但这样可能会导致代码不兼容所以不推荐检查设备类型匹配除了 API 版本设备类型也要匹配。问题原因如果你的项目配置的是手机应用但启动的是平板模拟器可能会导致黑屏或者布局错乱。虽然不一定黑屏但可能会出现其他问题。检查方法检查项目设备类型打开module.json5文件查看deviceTypes字段比如deviceTypes: [phone]检查模拟器设备类型在Device Manager中查看模拟器的设备类型Phone、Tablet、TV 等解决方法确保模拟器的设备类型和项目配置的设备类型一致。如果项目是手机应用就启动手机模拟器如果是平板应用就启动平板模拟器。检查硬件加速设置模拟器需要硬件加速才能正常运行如果硬件加速没开启模拟器可能会启动失败或者黑屏。检查 BIOS 设置重启电脑进入 BIOS不同品牌的电脑进入 BIOS 的方式不同通常是开机时按F2、F10、Del等键具体按键可以在电脑启动时看到提示开启虚拟化技术Intel 处理器找到Intel Virtualization Technology或VT-x设置为EnabledAMD 处理器找到AMD-V或SVM Mode设置为Enabled保存并退出 BIOS检查 Windows 功能在 Windows 系统中还需要确保 Hyper-V 或 Windows Hypervisor Platform 已启用打开控制面板 → “程序” → “启用或关闭 Windows 功能”找到Hyper-V或Windows Hypervisor Platform勾选并确定重启电脑调整模拟器内存设置模拟器的内存设置也很重要如果内存太小可能会导致黑屏在Device Manager中选择你的模拟器点击Edit按钮调整RAM设置建议至少 2GB如果电脑配置好可以设置更大保存设置检查电脑配置如果电脑配置太低可能无法正常运行模拟器。最低配置要求CPU支持虚拟化的多核处理器内存至少 8GB推荐 16GB硬盘至少 20GB 可用空间显卡支持硬件加速优化建议关闭不必要的程序运行模拟器时关闭其他占用资源的程序只启动一个模拟器不要同时启动多个模拟器降低模拟器分辨率如果电脑配置较低可以降低模拟器的分辨率使用真机调试如果电脑配置实在不够可以考虑使用真机调试重新安装模拟器组件如果以上方法都试过了还是黑屏那可能是模拟器组件损坏了。解决方法删除模拟器组件在 DevEco Studio 中点击File→SettingsWindows或PreferencesMac找到HarmonyOS SDK设置找到模拟器相关的组件点击删除重新下载安装在Device Manager中点击New Emulator选择需要的模拟器镜像重新下载并安装这个过程可能需要一些时间但通常能解决组件损坏导致的问题。真机调试提示设备未授权真机调试时提示设备未授权也是一个很常见的问题。这个问题的核心是让手机认识你的电脑允许电脑通过 ADB 连接手机。开启开发者模式和 USB 调试这是最基础也是最重要的一步。第一步开启开发者模式打开手机的设置找到关于手机可能在系统或系统与更新下找到版本号或HarmonyOS 版本连续点击版本号 5-7 次直到提示您已处于开发者模式第二步开启 USB 调试返回设置主界面找到系统和更新 → “开发人员选项”开启开发者模式后会出现找到USB 调试选项打开它找到仅充电模式下允许 ADB 调试选项也打开它这两个选项都很重要USB 调试允许电脑通过 ADB 连接手机仅充电模式下允许 ADB 调试即使手机只充电不传数据也允许 ADB 连接连接电脑并授权开启 USB 调试后就可以连接电脑了。第一步连接电脑用数据线连接手机和电脑手机可能会弹出 USB 连接方式选择选择传输文件或仅充电都可以因为我们已经开启了仅充电模式下允许 ADB 调试第二步授权电脑连接后手机会弹出一个授权对话框询问是否允许 USB 调试勾选始终允许这台计算机进行调试这个很重要下次连接就不需要再授权了点击确定如果授权成功DevEco Studio 应该就能识别到设备了。检查 ADB 连接状态如果授权后还是提示未授权可以检查一下 ADB 的连接状态。使用 DevEco Studio 终端检查在 DevEco Studio 中打开底部的Terminal标签输入命令adb devices查看输出结果正常的输出应该是List of devices attached ABC123456789 device其中ABC123456789是设备的序列号device表示设备已授权并可以调试。如果显示unauthorizedList of devices attached ABC123456789 unauthorized这表示设备未授权需要重新授权。解决方法重启 ADB 服务adb kill-server adb start-server重新连接设备拔掉数据线等待几秒重新插入数据线手机上重新授权再次检查adb devices如果还是unauthorized继续看下面的解决方案。重置 USB 调试授权如果重启 ADB 后还是不行可以尝试重置授权。在手机上重置授权打开设置 → “系统和更新” → “开发人员选项”找到撤销 USB 调试授权选项点击撤销所有授权重新连接并授权拔掉数据线重新插入数据线手机上会再次弹出授权对话框勾选始终允许这台计算机进行调试点击确定这样应该就能解决问题了。检查 USB 驱动如果手机连接电脑后电脑无法识别设备可能是 USB 驱动的问题。Windows 系统检查设备管理器右键此电脑 → “管理” → “设备管理器”查看是否有未知设备或带黄色感叹号的设备安装驱动去华为/荣耀官网下载对应手机的 USB 驱动或者使用华为手机助手它会自动安装驱动Mac 系统Mac 系统通常不需要额外安装驱动但如果连接不上可以尝试使用原装数据线尝试不同的 USB 接口重启电脑检查端口占用ADB 默认使用 5037 端口如果这个端口被占用可能会导致连接问题。检查端口占用Windowsnetstat-ano|findstr :5037如果端口被占用会显示占用该端口的进程 ID。解决方法关闭占用端口的程序任务管理器中找到对应的进程结束进程检查杀毒软件有些杀毒软件可能会占用 5037 端口临时关闭杀毒软件试试重启 ADBadb kill-server adb start-server使用无线调试可选如果 USB 连接一直有问题可以尝试使用无线调试。前提条件手机和电脑在同一个 Wi-Fi 网络下手机已开启 USB 调试至少第一次需要通过 USB 连接步骤通过 USB 连接并授权第一次必须开启无线调试adb tcpip5555查看手机 IP 地址设置 → WLAN → 点击当前连接的 Wi-Fi查看 IP 地址通过 Wi-Fi 连接adb connect 手机IP:5555断开 USB 连接现在可以通过 Wi-Fi 调试了实际应用场景让我们看看几个实际应用场景了解如何在实际开发中应用这些解决方案。场景一新项目首次调试当你创建一个新的鸿蒙项目第一次调试时可能遇到的问题模拟器版本不匹配模拟器黑屏真机未授权解决流程检查项目配置查看build-profile.json5中的 API 版本查看module.json5中的设备类型准备调试环境如果使用模拟器确保安装了匹配版本的模拟器如果使用真机开启开发者模式和 USB 调试启动调试选择正确的设备点击运行按钮排查问题如果模拟器黑屏按照上面的步骤排查如果真机未授权按照授权流程操作场景二团队协作中的环境问题在团队协作中不同成员的开发环境可能不一样可能遇到的问题有些成员能正常调试有些不能同样的代码在不同电脑上表现不同解决方案统一开发环境统一 DevEco Studio 版本统一 HarmonyOS SDK 版本统一模拟器版本文档化配置在项目 README 中记录开发环境要求记录常见问题和解决方案提供检查脚本提供脚本检查开发环境是否正确配置自动检查 API 版本、设备类型等场景三持续集成中的调试问题在 CI/CD 流程中可能需要自动化测试可能遇到的问题CI 环境中无法启动模拟器真机连接不稳定解决方案使用云测试平台使用华为云测试服务或者第三方云测试平台配置 CI 环境确保 CI 环境支持虚拟化配置好 ADB 和驱动添加重试机制如果连接失败自动重试记录详细的错误日志调试技巧和最佳实践除了解决这些问题还有一些调试技巧和最佳实践使用日志调试在代码中添加日志可以帮助定位问题// 在代码中添加日志hilog.info(0x0000,MyTag,应用启动成功);hilog.error(0x0000,MyTag,发生错误: %{public}s,errorMessage);在 DevEco Studio 的Log窗口中可以查看日志输出。使用断点调试设置断点可以逐步执行代码查看变量值在代码行号左侧点击设置断点以 Debug 模式运行应用应用会在断点处暂停可以查看变量值、调用栈等检查网络连接如果应用需要网络连接确保模拟器可以访问网络检查网络设置真机可以访问网络检查 Wi-Fi 或移动数据防火墙没有阻止连接清理构建缓存如果遇到奇怪的构建问题可以尝试清理缓存点击Build→Clean Project点击Build→Rebuild Project检查依赖版本确保所有依赖的版本都是兼容的检查oh-package.json5中的依赖版本确保依赖版本与 HarmonyOS SDK 版本兼容总结调试鸿蒙应用时遇到的问题大多数都是环境配置的问题。总结一下模拟器黑屏问题先尝试重启和清理缓存检查模拟器版本和 API 版本是否匹配检查设备类型是否匹配确保硬件加速已开启检查电脑配置是否足够如果都不行重新安装模拟器组件真机未授权问题开启开发者模式和 USB 调试连接电脑并授权检查 ADB 连接状态如果不行重置授权检查 USB 驱动和端口占用关键点总结版本匹配很重要模拟器版本、API 版本、设备类型都要匹配硬件加速必须开启模拟器需要硬件加速才能正常运行授权流程要完整真机调试需要完整的授权流程按顺序排查从简单到复杂按顺序排查问题文档化问题记录遇到的问题和解决方案方便以后参考