应用基本信息
我们先来看下harmony的工程结构中的文件
主要涉及以下几个目录
- AppScope > app.json5:应用的全局配置信息,详见app.json5配置文件。
- entry:HarmonyOS工程模块,编译构建生成一个HAP包。
- src > main > ets:用于存放ArkTS源码。
- src > main > ets > entryability:应用/服务的入口。
- src > main > ets > entrybackupability:应用提供扩展的备份恢复能力。
- src > main > ets > pages:应用/服务包含的页面。
- src > main > resources:用于存放应用/服务所用到的资源文件,如图形、多媒体、字符串、布局文件等。关于资源文件,详见资源分类与访问。
- src > main > module.json5:模块配置文件。主要包含HAP包的配置信息、应用/服务在具体设备上的配置信息以及应用/服务的全局配置信息。具体的配置文件说明,详见module.json5配置文件。
- build-profile.json5:当前的模块信息 、编译信息配置项,包括buildOption、targets配置等。
- hvigorfile.ts:模块级编译构建任务脚本。
- obfuscation-rules.txt:混淆规则文件。混淆开启后,在使用Release模式进行编译时,会对代码进行编译、混淆及压缩处理,保护代码资产。详见开启代码混淆。
- oh-package.json5:用来描述包名、版本、入口文件(类型声明文件)和依赖项等信息。
- oh_modules:用于存放三方库依赖信息。
- build-profile.json5:工程级配置信息,包括签名signingConfigs、产品配置products等。其中products中可配置当前运行环境,默认为HarmonyOS。
- hvigorfile.ts:工程级编译构建任务脚本。
- oh-package.json5:主要用来描述全局配置,如:依赖覆盖(overrides)、依赖关系重写(overrideDependencyMap)和参数化配置(parameterFile)等。
我们可以看到资源文件主要放在resource目录下,配置信息主要是app.json5和module.json5,程序代码主要在ets中。
应用配置
应用配置是全局配置,配置信息在app.json5中,涉及程序包名、版本号、版本名称、应用图标、应用名称。
注意,这里配置的应用图标和名称并不一定是应用桌面启动的图标和名称,如果创建了Ability则在对应的module下的module.json5配置的图标和名称则是应用启动的图标和名称
Module配置
Module分为Ability、Static Library、Shared Library。我们应用入口在Ability的module.json5中配置,在这里可以配置当前Moduel的页面路由,页面信息,路由映射,快捷操作等。
更多配置参考官网module.json5配置
依赖配置
如果项目需要引用三方依赖,可以在oh-package.json5中手动添加或者通过ohpm命令添加(ohpm install)
OpenHarmony官仓
编译配置
项目编译可通过build-profile.json5进行配置,该文件中可以配置包括buildOption、targets等。
编译配置文件分module和工程两种,工程的配置文件可以配置应用的签名、产品配置等