跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像AI 生图工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
TypeScript大前端

HarmonyOS Next 之旅:DevEco Studio 工程创建与模板指南

HarmonyOS Next 开发环境配置指南。介绍 DevEco Studio 支持的工程模板(如 Empty Ability、Native C++ 等)及语言选项(ArkTS、JS、C/C++)。详细说明创建 HarmonyOS 和 OpenHarmony 工程的步骤,包括项目配置、包名规范、API Version 设置及 build-profile.json5 文件修改方法。适用于移动端及嵌入式设备应用开发入门。

Stephaine Walsh发布于 2026/3/15更新于 2026/7/2751 浏览
HarmonyOS Next 之旅:DevEco Studio 工程创建与模板指南

1 工程模板介绍

DevEco Studio 支持多种品类的应用/元服务开发,预置丰富的工程模板,可以根据工程向导轻松创建适应于各类设备的工程,并自动生成对应的代码和资源模板。同时,DevEco Studio 还提供了多种编程语言供开发者进行应用/元服务开发,包括 ArkTS、JS 和 C/C++。

工程模板支持的开发语言及模板说明如下表所示:

模板名称说明
Empty Ability用于 Phone、Tablet、2in1、Car 设备的模板,展示基础的 Hello World 功能。
Native C++用于 Phone、Tablet、2in1、Car 设备的模板,作为应用调用 C++ 代码的示例工程,界面显示'Hello World'。
[CloudDev]Empty Ability端云一体化开发通用模板。
[Lite]Empty Ability用于 Lite Wearable 设备的模板,展示了基础的 Hello World 功能。可基于此模板,修改设备类型及 RuntimeOS,进行小型嵌入式设备开发。
Flexible Layout Ability用于创建跨设备应用开发的三层工程结构模板。三层工程结构包含 common(公共能力层)、features(基础特性层)、products(产品定制层)。
Embeddable Ability用于开发支持被其他应用嵌入式运行的元服务的工程模板。

2 创建一个新的工程

当开始开发一个应用/元服务时,首先需要根据工程创建向导,创建一个新的工程,工具会自动生成对应的代码和资源模板。

注意 在运行 DevEco Studio 工程时,建议每一个运行窗口有 2GB 以上的可用内存空间。

2.1 创建和配置新工程

DevEco Studio 提供了基础的工程模板资源,不同模板支持的设备类型、API Version 可能不同,在创建新工程前,提前了解各模板的相关信息。

2.1.1 创建 HarmonyOS 工程
  1. 通过如下两种方式,打开工程创建向导界面。

    • 如果当前未打开任何工程,可以在 DevEco Studio 的欢迎页,选择 Create Project 开始创建一个新工程。
    • 如果已经打开了工程,可以在菜单栏选择 File > New > Create Project 来创建一个新工程。
  2. 根据工程创建向导,选择创建 Application 或 Atomic Service。再选择需要的 Ability 工程模板,然后单击 Next。

注意 从 API 11 版本开始支持 Atomic Service 元服务工程开发。 Atomic Service 元服务工程暂不支持 Native 开发。

  1. 在工程配置页面,需要根据向导配置工程的基本信息。
    • Project name:工程的名称,可以自定义,由大小写字母、数字和下划线组成。
    • Bundle name:标识应用的包名,用于标识应用的唯一性。

注意

  • 应用包名要求:
    • 必须为以点号(.)分隔的字符串,且至少包含三段,每段中仅允许使用英文字母、数字、下划线(_),如'com.example.myapplication'。
    • 首段以英文字母开头,非首段以数字或英文字母开头,每一段以数字或者英文字母结尾,如'com.01example.myapplication'。
    • 不允许多个点号(.)连续出现,如'com.example..myapplication'。
    • 长度为 7~128 个字符。
  • Save location:工程文件本地存储路径,由大小写字母、数字和下划线等组成,不能包含中文字符。
  • Compatible SDK:兼容的最低 API Version。
  • Module name:模块的名称。
  • Device type:该工程模板支持的设备类型。
  1. 单击 Finish,工具会自动生成示例代码和相关资源,等待工程创建完成。
2.2 创建 OpenHarmony 工程
  1. 在完成创建 HarmonyOS 工程后,根据如下操作修改工程级 build-profile.json5 文件中相关字段:
    1. 在工程级 build-profile.json5 文件添加 compileSdkVersion 字段。
    2. 将 compatibleSdkVersion 和 compileSdkVersion 字段赋值为整数类型。
    3. 将 runtimeOS 从"HarmonyOS"修改为"OpenHarmony"。
"products": [ { "name": "default", "signingConfig": "default", "compileSdkVersion": 11, //指定 OpenHarmony 应用编译时的版本,当前以 API 11 为例 "compatibleSdkVersion": 11, //指定 OpenHarmony 应用兼容的最低版本,当前以 API 11 为例 "runtimeOS": "OpenHarmony", } ],
  1. 单击 Sync Now 进行同步。在 Sync Check 弹窗中点击 Yes,同意将 module.json5/config.json 文件中的 phone 切换为 OpenHarmony 支持的 default 类型,并删除在 OpenHarmony 不适用的其他设备类型,同步成功无其他报错则工程创建完成。

注意 若选择 Native C++ 模板创建 OpenHarmony 应用,且应用需要在 RK 开发板上运行,则需在对应 Native 模块的 build-profile.json5 文件 buildOption/externalNativeOptions 字段下,新增 abiFilters 字段并赋值为"armeabi-v7a"。

目录

  1. 1 工程模板介绍
  2. 2 创建一个新的工程
  3. 2.1 创建和配置新工程
  4. 2.1.1 创建 HarmonyOS 工程
  5. 2.2 创建 OpenHarmony 工程
  • 免费图片AI生成工具免费生成了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 免费图片视频在线生成30秒,将你的创意变成现实开始设计
  • X/Twitter免费视频下载器免登陆无限额度免费视频解析下载了解详情
  • 100+免费在线小游戏爽一把
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • 机器人具身智能:核心定义、指标与标准体系
  • 基于 PX4 与 Mid360 激光雷达的无人机 FAST-LIO 定点悬停
  • MySQL 迁移金仓数据库:高兼容与自动化低成本落地方案
  • HTML 核心语法与常用标签入门指南
  • OpenClaw 系统架构分析
  • ComfyUI_smZNodes 安装指南:实现跨平台 AI 绘画效果一致
  • Copilot Cowork 核心逻辑与 Kotlin AI Agent 实现
  • AI 写作软件推荐:多场景实用工具整理
  • 国产 AI 智能体平台对比:腾讯、字节、阿里、百度等主流方案汇总
  • Python 文本转语音:Edge TTS 库使用指南
  • 开源开发工具精选与 AI 大模型学习路径解析
  • 网络安全入门:成为白帽黑客的学习路线指南
  • OpenClaw 多飞书机器人与多 Agent 协作落地记录
  • 前端精确数字运算:使用 BigNumber.js 解决 JavaScript 精度问题
  • 企业微信外部群 Webhook 配置与消息推送指南
  • 智能空气检测机器人的系统设计
  • Ubuntu 系统分区详解与最佳分配策略
  • 基于 Docker 部署 Web-Check 结合内网穿透实现远程网站检测
  • JavaSE 基础语法与面向对象编程复习
  • C++ 继承机制详解:概念、规则与菱形继承

相关免费在线工具

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online

  • HTML转Markdown

    将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online

  • JSON 压缩

    通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online

  • JSON美化和格式化

    将JSON字符串修饰为友好的可读格式。 在线工具,JSON美化和格式化在线工具,online