核心内容摘要
91视频高清：开启视界新维度，高清流畅尽享视听盛宴
网罗开发小红书、快手、视频号同名大家好我是展菲目前在上市企业从事人工智能项目研发管理工作平时热衷于分享各种编程领域的软硬技能知识以及前沿技术包括iOS、前端、Harmony OS、Java、Python等方向。
在移动端开发、鸿蒙开发、物联网、嵌入式、云原生、开源等领域有深厚造诣。
图书作者《ESP32-C3 物联网工程开发实战》图书作者《SwiftUI 入门进阶与实战》超级个体COC上海社区主理人特约讲师大学讲师谷歌亚马逊分享嘉宾科技博主华为HDE/HDG我的博客内容涵盖广泛主要分享技术教程、Bug解决方案、开发工具使用、前沿科技资讯、产品评测与使用体验。
我特别关注云服务产品评测、AI 产品对比、开发板性能测试以及技术报告同时也会提供产品优缺点分析、横向对比并分享技术沙龙与行业大会的参会体验。
我的目标是为读者提供有深度、有实用价值的技术洞察与分析。
展菲您的前沿技术领航员 大家好我是展菲 全网搜索“展菲”即可纵览我在各大平台的知识足迹。
公众号“Swift社区”每周定时推送干货满满的技术长文从新兴框架的剖析到运维实战的复盘助您技术进阶之路畅通无阻。
微信端添加好友“fzhanfei”与我直接交流不管是项目瓶颈的求助还是行业趋势的探讨随时畅所欲言。
最新动态2025 年 3 月 17 日快来加入技术社区一起挖掘技术的无限潜能携手迈向数字化新征程文章目录前言环境要求与前置准备安装 DevEco StudioSDK 与工具链配置设置 SDK 路径必装 SDK 组件关键配置项说明模拟器与真机调试创建与启动模拟器真机调试要点项目结构与 Gradle 配置关键目录与文件构建配置要点
常见问题与排查思路
总结前言刚开始接触 HarmonyOS 应用开发时很多人会卡在环境搭建这一步SDK 下载慢、模拟器启动失败、真机调试连不上等等。
这些问题其实都有对应的解决方案只是官方文档比较分散新手容易踩坑。
今天我们就来梳理一下 HarmonyOS 应用开发环境的完整搭建流程重点讲 DevEco Studio 的安装、SDK 配置、以及开发中常用的几项设置。
不追求完整可运行的 Demo只把关键步骤和容易出错的地方说清楚。
环境要求与前置准备在安装 DevEco Studio 之前需要先确认本机环境是否满足要求。
HarmonyOS 开发对系统和硬件有一定要求忽略这些往往会导致后续模拟器卡顿或编译失败。
系统要求操作系统Windows 10 及以上、macOS
1
14 及以上内存建议 8GB 以上跑模拟器建议 16GB磁盘至少预留 10GB 空间给 SDK 和模拟器镜像前置软件Node.jsDevEco Studio 内置了部分能力但部分脚手架和工具链会用到 Node建议安装 LTS 版本如
xGit用于版本管理和部分模板拉取Node 和 Git 的安装不在此展开装好后在终端能正常执行node -v和git -v即可。
安装 DevEco StudioDevEco Studio 是华为官方提供的 HarmonyOS 应用开发 IDE基于 IntelliJ IDEA熟悉 JetBrains 系列的同学会很快上手。
下载与安装打开 HarmonyOS 开发者官网进入「开发」→「DevEco Studio」下载页面选择与当前系统匹配的安装包Windows 为 exemacOS 为 dmg安装过程与普通软件一致一路「下一步」即可。
安装路径建议不要放在中文或带空格的路径下避免后续工具链报错首次启动配置首次启动时会提示导入设置有旧版可导入、选择主题等按需选择即可。
接着会进入SDK 下载与配置向导这一步非常关键。
SDK 与工具链配置SDK 是开发 HarmonyOS 应用的核心包含 API、系统镜像、工具链等。
配置不当会导致「找不到 SDK」「模拟器无法创建」等问题。
设置 SDK 路径建议将 SDK 放在单独目录便于管理和备份例如WindowsD:\HarmonyOS\sdkmacOS/Users/你的用户名/HarmonyOS/Sdk在 DevEco Studio 中File → Settings → SDKmacOS 为DevEco Studio → Preferences → SDK在HarmonyOS选项卡下设置SDK Location为上述路径。
注意路径中不要有中文和空格否则部分 NDK 或命令行工具可能异常。
必装 SDK 组件在 SDK 管理界面中建议至少安装以下内容组件说明API选择目标设备对应的 API 版本如 API
API 10与项目compileSdkVersion一致Toolchains构建与调试必需一般随 IDE 自动勾选Emulator用于运行模拟器体积较大按需下载若网络较慢可优先只装当前项目用到的 API 版本和 ToolchainsEmulator 可后续再装或使用真机调试。
关键配置项说明在Settings → SDK里还有几项容易忽略Proxy若公司网络需要代理才能访问外网在此配置 HTTP/HTTPS 代理否则 SDK 和模拟器镜像可能下载失败Auto-download可关闭「自动下载缺失组件」改为在报错时手动选择下载便于控制网络和磁盘占用模拟器与真机调试开发阶段通常用模拟器或真机。
模拟器依赖 SDK 中的系统镜像真机则需要开启开发者模式并连接电脑。
创建与启动模拟器在Tools → Device Manager中可创建 AVD虚拟设备选择Phone或Tablet等设备类型选择系统镜像System Image需与已安装的 API 版本对应分配内存与磁盘建议内存不少于 2GB创建完成后点击运行即可启动模拟器。
若启动失败可检查本机是否开启虚拟化Intel VT-x / AMD-V可在任务管理器或「关于」中查看杀毒软件或防火墙是否拦截了模拟器进程真机调试要点真机调试前需在手机上开启开发者模式设置 → 关于手机 → 连续点击「版本号」若干次开启 USB 调试设置 → 系统和更新 → 开发人员选项 → USB 调试用数据线连接电脑在手机上允许「允许 USB 调试」弹窗DevEco Studio 顶部设备下拉框中应出现该设备选择后即可运行和调试。
若未识别可检查数据线是否支持数据传输、是否安装了对应机型的 USB 驱动Windows 上较常见。
项目结构与 Gradle 配置新建项目时DevEco Studio 会生成标准 HarmonyOS 工程结构。
了解其中几个关键文件有助于后续排错和定制。
关键目录与文件entry/ # 主模块应用入口 src/ main/ ets/ # ArkTS 源码 resources/ # 资源文件 oh-package.json5 # 依赖声明类似 package.json build-profile.json5 # 模块构建配置oh-package.json5中声明应用依赖例如{ name: entry, version:
1.
0, dependencies: { ohos/axios: ^
2.
0, ohos/hypium:
1.
6 } }依赖安装通过ohpm完成在项目根目录执行ohpm install即可或使用 IDE 的同步依赖按钮。
构建配置要点build-profile.json5中会指定compileSdkVersion、targetSdkVersion等需与 SDK 中已安装的 API 版本一致否则会报「找不到 API」类错误。
例如{ apiType: stageMode, buildOption: { arkOptions: { compileSdkVersion: 10, runtimeOS: HarmonyOS } } }修改这里后建议在File → Sync and Refresh Project做一次同步避免缓存导致编译异常。
常见问题与排查思路现象可能原因排查方向模拟器启动黑屏/卡住内存不足、虚拟化未开启增大 AVD 内存、检查 BIOS 虚拟化真机不显示在设备列表驱动、USB 调试未开换线/换口、重装驱动、确认开发者选项编译报 SDK 或 API 找不到路径含中文、API 未安装检查 SDK 路径、在 SDK 管理中安装对应 API依赖下载失败网络或代理配置 SDK Proxy、使用国内镜像若有遇到报错时优先看 DevEco Studio 底部Build或Event Log中的具体信息再根据关键词搜索官方文档或社区。
总结HarmonyOS 应用开发环境以 DevEco Studio HarmonyOS SDK 为核心。
搭建时重点做好三件事正确安装并配置 SDK 路径、按需安装 API 与模拟器镜像、理清模拟器与真机调试的前置条件。
同时注意 SDK 路径无中文、网络受限时配置代理能避免大部分环境类问题。
后续文章会在此基础上讲解 ArkTS 语法、页面开发与网络请求等具体开发内容。