前言本文带你从零搭建 HarmonyOS 原生应用开发环境覆盖DevEco Studio 安装、SDK 配置、模拟器创建、真机调试全流程新手也能一次成功。一、开发环境要求1.1硬件要求CPU64 位处理器推荐 Intel Core i5 及以上或同级别 AMD内存8 GB 及以上推荐 16 GB硬盘固态硬盘预留≥30 GB可用空间显示器分辨率1920×1080 及以上1.2操作系统要求系统版本要求WindowsWindows 10 / 11 64 位二、DevEco Studio 下载DevEco Studio 是华为官方推出的鸿蒙生态专用开发工具基于 IntelliJ IDEA 内核支持 ArkTS、ArkUI 开发、预览、调试、打包全流程。1.打开DevEco Studio官网点击立即下载2.下载后得到DevEco Studio的压缩包然后解压缩3.点击DevEco Studio应用程序三、DevEco Studio 安装详细步骤1.弹出用户账户控制提示点击「允许」进入安装向导。2.阅读用户许可协议勾选同意点击 Next 继续。3.选择安装位置建议安装到 D 盘或 E 盘不要放在 C 盘路径全英文。4.组件选择界面选择桌面创建快捷方式即可5.点击下一步开始安装等待进度条走完此过程根据电脑配置需要 3–10 分钟。6.安装完成后勾选 Run DevEco Studio点击 Finish 启动工具。四、首次启动与 SDK 自动配置第一次打开 DevEco Studio 会进行初始化配置这是环境搭建最关键的一步。1.启动后弹出「Import Settings」选择「Do not import settings」点击 OK。2.进入欢迎界面点击「Configure」进入设置面板。3.找到「HarmonyOS SDK」选项进入 SDK 管理界面。4.设置 SDK 存储路径必须英文、无中文、无空格建议单独建一个HarmonyOS_SDK文件夹。5.选择需要的 SDK 版本优先选择最新稳定版同时勾选对应的工具包。6.同意相关许可协议点击 Apply开始自动下载 SDK、模拟器镜像、构建工具等依赖。7.等待下载完成进度条走完后重启 IDE 使配置生效五、创建项目5.1新建工程1.打开Deveco Studio点击新建项目2.会进入此页面点击下一步3.配置项目项目名称Start包名com.example.start保存路径保存在英文路径下最好和我一样放在项目里自己能看懂就可以Compile SDK选择API 20或以上模块名称选择entry推荐4..点击Finish完成创建。创建成功如下图所示5.2查看项目结构5.3编写简单页面打开entry/src/main/ets/pages/Index.ets将Index.ets里面的代码替换为Entry Component struct Index { State message: string Hello HarmonyOS; build() { Row() { Column() { Text(this.message) .fontSize(50) .fontWeight(FontWeight.Bold) Button(Click Me) .margin({ top: 20 }) .onClick(() { this.message Hello ArkTS!; }) } .width(100%) } .height(100%) } }六、创建本地模拟器并运行搭建完环境后可直接使用模拟器预览效果不用准备真实设备。1.在欢迎页或主界面点击「Device Manager」设备管理器。2.选择设备类型手机、平板、手表、智慧屏等以手机为例。3.点击「Create Device」开始创建模拟器。4.选择设备型号与系统镜像选择推荐版本即可。5.设置模拟器名称、分辨率、内存大小默认即可。6.完成创建在设备列表点击「启动按钮」。7.等待模拟器开机出现鸿蒙桌面即启动成功。七、真机调试配置若你有鸿蒙系统手机可配置真机调试效果比模拟器更真实。1.打开手机「设置」进入「关于手机」。2.连续点击「版本号」7 次开启「开发者模式」。3.返回设置进入「系统和更新 - 开发者选项」。4.开启「USB 调试」「允许安装未知应用」「USB 安装」。5.用原装数据线连接手机与电脑手机弹窗选择「传输文件 / 调试模式」。6.打开 DevEco Studio顶部设备列表会显示你的手机名称。7.点击运行即可直接在真机上安装并启动应用。八、常见问题与解决方案8.1.SDK 下载失败1.检查网络是否稳定切换手机热点重试。2.确认路径无中文、无空格、无特殊字符。8.2.模拟器启动失败1.电脑进入 BIOS 开启 Intel VT-x / AMD-V 虚拟化。2.关闭电脑中的虚拟机、VPN、杀毒软件冲突。8.3.真机连接不上1.开启所有调试权限使用原装数据线。2.在开发者选项中开启「USB 安装」「USB 调试安全模式」。8.4.项目编译报错1.重新同步 Gradle / 构建配置。2.清理项目缓存重启 DevEco Studio。九、总结到这里你已经完成了鸿蒙原生应用开发环境的全部搭建包括 DevEco Studio 安装、SDK 配置、模拟器创建、真机调试、第一个 ArkUI 项目运行。接下来就可以正式进入 ArkUI 组件、页面、交互的学习与开发一步步做出属于自己的鸿蒙应用。
鸿蒙原生应用开发（ArkUI）— 001 Windows平台从零搭建 HarmonyOS 开发环境完整教程
前言本文带你从零搭建 HarmonyOS 原生应用开发环境覆盖DevEco Studio 安装、SDK 配置、模拟器创建、真机调试全流程新手也能一次成功。一、开发环境要求1.1硬件要求CPU64 位处理器推荐 Intel Core i5 及以上或同级别 AMD内存8 GB 及以上推荐 16 GB硬盘固态硬盘预留≥30 GB可用空间显示器分辨率1920×1080 及以上1.2操作系统要求系统版本要求WindowsWindows 10 / 11 64 位二、DevEco Studio 下载DevEco Studio 是华为官方推出的鸿蒙生态专用开发工具基于 IntelliJ IDEA 内核支持 ArkTS、ArkUI 开发、预览、调试、打包全流程。1.打开DevEco Studio官网点击立即下载2.下载后得到DevEco Studio的压缩包然后解压缩3.点击DevEco Studio应用程序三、DevEco Studio 安装详细步骤1.弹出用户账户控制提示点击「允许」进入安装向导。2.阅读用户许可协议勾选同意点击 Next 继续。3.选择安装位置建议安装到 D 盘或 E 盘不要放在 C 盘路径全英文。4.组件选择界面选择桌面创建快捷方式即可5.点击下一步开始安装等待进度条走完此过程根据电脑配置需要 3–10 分钟。6.安装完成后勾选 Run DevEco Studio点击 Finish 启动工具。四、首次启动与 SDK 自动配置第一次打开 DevEco Studio 会进行初始化配置这是环境搭建最关键的一步。1.启动后弹出「Import Settings」选择「Do not import settings」点击 OK。2.进入欢迎界面点击「Configure」进入设置面板。3.找到「HarmonyOS SDK」选项进入 SDK 管理界面。4.设置 SDK 存储路径必须英文、无中文、无空格建议单独建一个HarmonyOS_SDK文件夹。5.选择需要的 SDK 版本优先选择最新稳定版同时勾选对应的工具包。6.同意相关许可协议点击 Apply开始自动下载 SDK、模拟器镜像、构建工具等依赖。7.等待下载完成进度条走完后重启 IDE 使配置生效五、创建项目5.1新建工程1.打开Deveco Studio点击新建项目2.会进入此页面点击下一步3.配置项目项目名称Start包名com.example.start保存路径保存在英文路径下最好和我一样放在项目里自己能看懂就可以Compile SDK选择API 20或以上模块名称选择entry推荐4..点击Finish完成创建。创建成功如下图所示5.2查看项目结构5.3编写简单页面打开entry/src/main/ets/pages/Index.ets将Index.ets里面的代码替换为Entry Component struct Index { State message: string Hello HarmonyOS; build() { Row() { Column() { Text(this.message) .fontSize(50) .fontWeight(FontWeight.Bold) Button(Click Me) .margin({ top: 20 }) .onClick(() { this.message Hello ArkTS!; }) } .width(100%) } .height(100%) } }六、创建本地模拟器并运行搭建完环境后可直接使用模拟器预览效果不用准备真实设备。1.在欢迎页或主界面点击「Device Manager」设备管理器。2.选择设备类型手机、平板、手表、智慧屏等以手机为例。3.点击「Create Device」开始创建模拟器。4.选择设备型号与系统镜像选择推荐版本即可。5.设置模拟器名称、分辨率、内存大小默认即可。6.完成创建在设备列表点击「启动按钮」。7.等待模拟器开机出现鸿蒙桌面即启动成功。七、真机调试配置若你有鸿蒙系统手机可配置真机调试效果比模拟器更真实。1.打开手机「设置」进入「关于手机」。2.连续点击「版本号」7 次开启「开发者模式」。3.返回设置进入「系统和更新 - 开发者选项」。4.开启「USB 调试」「允许安装未知应用」「USB 安装」。5.用原装数据线连接手机与电脑手机弹窗选择「传输文件 / 调试模式」。6.打开 DevEco Studio顶部设备列表会显示你的手机名称。7.点击运行即可直接在真机上安装并启动应用。八、常见问题与解决方案8.1.SDK 下载失败1.检查网络是否稳定切换手机热点重试。2.确认路径无中文、无空格、无特殊字符。8.2.模拟器启动失败1.电脑进入 BIOS 开启 Intel VT-x / AMD-V 虚拟化。2.关闭电脑中的虚拟机、VPN、杀毒软件冲突。8.3.真机连接不上1.开启所有调试权限使用原装数据线。2.在开发者选项中开启「USB 安装」「USB 调试安全模式」。8.4.项目编译报错1.重新同步 Gradle / 构建配置。2.清理项目缓存重启 DevEco Studio。九、总结到这里你已经完成了鸿蒙原生应用开发环境的全部搭建包括 DevEco Studio 安装、SDK 配置、模拟器创建、真机调试、第一个 ArkUI 项目运行。接下来就可以正式进入 ArkUI 组件、页面、交互的学习与开发一步步做出属于自己的鸿蒙应用。
