了解HarmonyOS NEXT工程目录结构

简介: 本指南介绍了如何在DevEco Studio中创建第一个HarmonyOS工程,包括项目配置(如项目名称、包名、模块名称等)、设备类型选择以及工程同步。同时展示了基本代码示例,实现“Hello World”功能,并详细解析了工程目录结构。其中,`AppScope`为自动生成目录,`entry`为主模块,包含代码与资源文件;`oh_modules`存放依赖包,`app.json5`和`module.json5`分别用于全局和模块配置。此外,还说明了`ets`目录下的Ability逻辑管理、UI页面代码组织及资源文件存储方式,帮助开发者快速了解HarmonyOS应用开发基础。

创建第一个工程
如果你是首次打开DevEco Studio,那么首先会进入欢迎页。
在欢迎页中单击“Create Project”,进入项目创建页面。
选择‘Application’,然后选择‘Empty Ability’,单击‘Next’进入项目配置页。
配置页中,详细信息如下:

  • Project name是开发者可以自行设置的项目名称,这里根据自己选择修改为自己项目名称。
  • Bundle name是包名称,默认情况下应用ID也会使用该名称,应用发布时对应的ID需要保持一致。
  • Save location为工程保存路径,建议用户自行设置相应位置。
  • Compile SDK是编译的SDK版本。
  • Module name:模块名称。
  • Device type设备类型:Phone手机,Tablet平板,2in1二合一平板电脑,Car车载平板

然后单击“Finish”完成工程创建,等待工程同步完成。

@Entry
@Component
struct Index{
  @State message: string = 'Hello World';

  build() {
    RelativeContainer() {
      Text(this.message)
        .id('PageHelloWorld')
        .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%')
  }
}

了解基本工程目录
参考资料:
https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/application-package-structure-stage-V5

工程的目录结构如下

  • AppScope目录由DevEco Studio自动生成,不可更改。。
  • entry是应用的主模块,存放HarmonyOS应用的代码、资源等。
  • oh_modules是工程的依赖包,存放工程依赖的源文件。
  • oh-package.json5是工程级依赖配置文件,用于记录引入包的配置信息。

app.json5是应用的全局的配置文件,用于存放应用公共的配置信息。

{
  "app": {
    "bundleName": "com.example.helloworld",
    "vendor": "example",
    "versionCode": 1000000,
    "versionName": "1.0.0",
    "icon": "$media:layered_image",
    "label": "$string:app_name"
  }
}
  • bundleName是包名。
  • vendor是应用程序供应商。
  • versionCode是用于区分应用版本。
  • versionName是版本号。
  • icon对应于应用的显示图标。
  • label是应用名。

主模块目录:
--src目录
--main文件夹
--ets文件夹存放模块的ArkTS源码文件(.ets文件)
--resources文件夹存放模块内需要用到的资源文件
--module.json5文件为模块的配置文件,包含当前模块的配置信息。
--ohosTest是单元测试目录。
--oh-package.json5是模块级依赖配置信息文件。

ets目录中

  • entryability存放ability文件,用于当前ability应用逻辑和生命周期管理。
  • entrybackupability:提供扩展的备份恢复能力
  • pages存放UI界面相关代码文件,初始会生成一个Index页面。

resources目录下存放模块公共的多媒体、字符串及布局文件等资源,分别存放在element、media文件夹中。

main_pages.json文件保存的是页面page的路径配置信息,所有需要进行路由跳转的page页面都要在这里进行配置。

目录
相关文章
|
3天前
|
编解码 Java 开发工具
【HarmonyOS Next之旅】DevEco Studio的安装与环境配置
本教程详细介绍了使用DevEco Studio进行OpenHarmony开发的全流程,包括下载与安装、环境配置、项目准备及实用技巧。首先,以Windows环境为例,说明了DevEco Studio的运行要求、下载和安装步骤;接着,通过设置环境变量和配置SDK完成开发环境搭建;然后,讲解了项目创建、预览器和虚拟机的使用方法;最后,分享了中文插件安装和简化工程目录栏等小技巧,帮助开发者高效上手OpenHarmony开发。
63 0
|
3天前
|
存储 安全 JavaScript
【HarmonyOS Next之旅】HarmonyOS概述(二)
HarmonyOS是面向万物互联时代的分布式操作系统,支持多种终端设备,提供全场景业务能力。其三大特征包括超级终端融合、一次开发多端部署及统一OS弹性部署。技术架构分为内核层、系统服务层、框架层和应用层,确保系统灵活性与高效性。同时,HarmonyOS通过分布式多端协同身份认证、可信运行环境和数据全生命周期保护,保障系统安全,实现“正确的人、正确的设备、正确地使用数据”。
32 0
|
7天前
|
人工智能 自然语言处理 安全
HarmonyOS NEXT+AI打造智能助手APP(适配DeepSeek)
华为仓颉编程语言与HarmonyOS NEXT结合AI大模型,开创智能助手APP开发新纪元。仓颉语言以自然化编程降低门槛,HarmonyOS NEXT提供流畅安全的系统支持,AI大模型赋予助手强大交互能力。实战课程覆盖智能对话、写作、画图等6大核心业务,模块化开发助你掌握全流程技能。参考资料及开源教程助力学习,开启智能应用开发新篇章。
55 10
HarmonyOS NEXT+AI打造智能助手APP(适配DeepSeek)
|
4天前
|
前端开发 开发工具 Android开发
小红书APP的全新鸿蒙NEXT端性能优化技术实践
从 2023 年开始,鸿蒙的优势愈发明显,已经成为可与 iOS、安卓媲美的第三大移动操作系统。从一些抖音视频中也可以看出,鸿蒙在流畅性方面甚至在某些层面上超过了 iOS。本次分享的主题是小红书在鸿蒙平台上的工程实践,主要聚焦于性能优化和探索。
38 10
|
2天前
|
存储 JavaScript 安全
【HarmonyOS Next之旅】HarmonyOS开发基础知识(二)
本文主要介绍了HarmonyOS应用的配置文件说明、应用数据管理和应用安全管理三大核心内容。在配置文件说明部分,详细解析了“config.json”中app、deviceConfig和module三个关键组成部分的结构与功能,涵盖版本管理、设备配置及模块定义等细节。应用数据管理部分阐述了本地数据存储、分布式数据服务、文件共享及搜索服务等功能,确保跨设备数据一致性。应用安全管理则从开发准备、编码安全、权限使用到发布分发全流程,提供了保障应用安全的最佳实践。内容全面覆盖了HarmonyOS应用开发的核心环节,为开发者提供了详尽指导。
20 1
|
8天前
|
网络协议 Java 网络安全
全平台开源即时通讯IM聊天框架MobileIMSDK的服务端开发指南,支持鸿蒙NEXT
全平台开源即时通讯IM聊天框架MobileIMSDK的服务端开发指南,支持鸿蒙NEXT
53 4
|
10天前
|
JSON 缓存 程序员
玩转HarmonyOS NEXT网络请求:从新手到高手的实战秘籍
本文以通俗易懂的方式讲解了HarmonyOS网络请求的核心知识,从基础概念到实战技巧,再到进阶优化,帮助开发者快速上手。通过“点外卖”的类比,形象解释了HTTP请求方法(如GET、POST)和JSON数据格式的作用。同时,提供了封装工具类的示例代码,简化重复操作,并分享了常见问题的解决方法(如权限配置、参数格式、内存泄漏等)。最后,还探讨了如何通过拦截器、缓存机制和重试机制提升请求功能。无论你是新手还是进阶开发者,都能从中受益,快动手实现一个新闻App试试吧!
35 5
|
1天前
|
移动开发 Java 测试技术
HarmonyOS NEXT~鸿蒙系统与mPaaS三方框架集成指南
本文详细介绍了鸿蒙系统(HarmonyOS)与mPaaS框架的集成方法。鸿蒙系统作为华为开发的分布式操作系统,具备分布式架构、微内核设计等特性;mPaaS是蚂蚁金服推出的移动开发平台,提供金融级组件和全生命周期管理能力。文章从环境准备、核心功能集成(如初始化、用户认证、支付功能)、适配问题解决到调试测试及最佳实践,全方位指导开发者高效集成两者。通过遵循指南,可充分利用鸿蒙的特性和mPaaS的金融能力,构建高性能、高安全性的应用,同时避免常见兼容性问题,缩短开发周期。
15 0
|
1天前
|
开发框架 API 开发工具
HarmonyOS NEXT~鸿蒙系统与Uniapp跨平台开发实践指南
本书《HarmonyOS NEXT~鸿蒙系统与Uniapp跨平台开发实践指南》深入探讨了华为鸿蒙系统(HarmonyOS)与Uniapp框架的融合应用。书中首先介绍了鸿蒙系统的分布式架构特点及其原子化服务理念,随后详细讲解了Uniapp在鸿蒙环境下的适配方案,包括开发环境配置、特有配置项设置以及条件编译调用鸿蒙原生能力的方法。此外,还提供了界面适配策略、性能优化建议及调试发布流程,帮助开发者高效构建多端协同应用。最后展望了鸿蒙生态未来的发展方向,如ArkUI-X的深度集成和全新API能力的应用前景。
17 0
|
2天前
|
自然语言处理 JavaScript API
【HarmonyOS Next之旅】HarmonyOS开发基础知识(一)
本文主要介绍了HarmonyOS应用开发中的基础知识、配置文件结构及其说明。内容涵盖用户应用程序的基本概念,包括应用形态(安装型与元服务)、包结构(APP Pack与HAP)、核心组件(Ability)以及相关文件(库文件、资源文件、配置文件等)。重点解析了`config.json`配置文件的组成与内部结构,如`app`(全局配置)、`deviceConfig`(设备配置)、`module`(模块配置)三大核心部分,详细说明了各属性的功能与约束。此外,还提供了具体示例,帮助开发者更好地理解和使用HarmonyOS的配置体系。适用于JS/ArkTS开发环境。
17 0