DevEco Studio 工程管理全指南
一、工程概述(Project Overview)
1. 工程基本概念
工程(Project):开发应用的基本组织单位
模块(Module):工程的功能组成部分
Ability:应用的功能单元(UIAbility 或 ServiceAbility)
HAP(Harmony Ability Package):应用的部署包
2. 工程生命周期

二、工程结构(Project Structure)
1. 典型工程结构
2、工程目录结构:Stage 与 FA 模型对比
1. Stage 模型(ArkTS 开发,推荐)
2. FA 模型(JS 开发,兼容旧项目)
三、工程模板(Templates)
1. 选择工程类型与模板
入口路径:
欢迎页点击 Create Project,或菜单 File > New > Create Project。
模板分类:
关键配置项:
Bundle Name:应用唯一标识(格式:
com.example.项目名
,需符合三段式规则,如com.harmony.demo
)。Device Type:根据目标设备选择(如 Phone、Tablet、Car),可多选。
Compile SDK:编译目标 API 版本(建议选最新稳定版,如 API 11+)。
2. 创建 HarmonyOS 与 OpenHarmony 工程
HarmonyOS 工程:
直接选择模板并完成配置,默认生成 Stage 模型工程(推荐)。
OpenHarmony 工程(可选):
创建 HarmonyOS 工程后,修改工程级
build-profile.json5
:
同步工程,删除不支持的设备类型(如 Phone),保留
default
或tablet
。
四、工程管理技巧
1. 多模块开发(Stage 模型)
创建 Feature 模块:
菜单 File > New > Module,选择 Feature Ability,用于扩展功能(如插件化模块)。
模块间通信:
通过 EventBus 或全局状态管理(如
@AppStorage
)实现跨模块数据传递。在
app.json5
中配置模块依赖关系。
2. 资源管理最佳实践
结构化资源:
将颜色、字符串等放入
base/element
目录,通过$r('app.element.xxx')
引用,便于多语言 / 主题切换。原始资源(rawfile):
直接通过路径引用(如
FileUtil.getRawFileContent('rawfile/test.txt')
),适用于不参与编译的文件。
3. 编译与构建配置
签名配置:
菜单 File > Project Structure > Signing Configs,勾选 Automatically generate signature,使用华为账号自动签名(调试阶段)。
构建产物:
HAP 包:主模块编译生成
entry/build/outputs/hap/debug/entry.hap
。APP Pack:多模块工程生成
app/dist/xxx.app
(包含所有 HAP 与pack.info
)。
4. 切换开发语言
ArkTS 与 JS 混用:
创建新模块时选择不同语言(如主模块用 ArkTS,插件模块用 JS),通过 JS-TS 互调实现协同。
C++ 集成:
使用 Native C++ 模板,在 ArkTS 中通过
@Native
装饰器调用 C++ 接口。
##鸿蒙开发工具 ##DevEco Studio##商务 #
版权声明: 本文为 InfoQ 作者【小赵学鸿蒙】的原创文章。
原文链接:【http://xie.infoq.cn/article/d5b687ea1feb8f3dc540caaeb】。文章转载请联系作者。
评论