HarmonyOS开发详解（三）——鸿蒙程序结构详解以及真机运行调试_鸿蒙如何配置string文件

本文链接：https://blog.youkuaiyun.com/2401_89317520/article/details/145324475

1、鸿蒙应用程序结构组成

1.1、HarmonyOS应用程序逻辑组成

HarmonyOS的用户应用程序（安装app）由一个或者多个HAP（HarmonyOS Ability Package）构成；HAP是Ability的部署包；一个HAP由代码、资源文件、第三方库及配置文件构成的模块包，模块包又分为两类：entry模块和feature模块。

1）entry：应用程序主模块，一个APP中，对于同一设备可以有一个或者多个entry类型的HAP，来支持不同规格设备（如不同屏幕，不同API版本）；

2）feature：应用动态模块；一个APP可以包含零个或者多个feature。

只有包含Ability的HAP才能独立运行。

上图黄色内容部分，可以说是一个最简单app（只有一个hap）的结构组成，包括：abilities、libs（类库）、resources（字符串、图片、音频）、config.json（配置包名、ability、权限等）。此外编译器还会自动生成一个pack.info、hap包文件等。

1.2、HarmonyOS应用程序物理结构

上图除了资源（resources）、config.json以外核心的内容已经粗略的讲了。

1.3、资源目录解析

1.3.1 resources资源目录结构

应用资源目录分为三类默认的base目录、rawfile目录、限定词目录。（官方把资源目录分为两类的，base和限定词目录归为一类，这样也合理，base可以说是限定词目录的默认形式；但是为了表述清晰吧还是分开）

使用规则如下：

1）base目录和限定词目录只能两级；rawfile目录可以多级

2）应用读取资源时会先去限定词目录资源，找不到再去base目录匹配；rawfile目录资源不会被匹配，按相对路径读取；

3）不同的读取方式

A、Java文件引用资源文件的格式：**ResourceTable.type_**name。特别地，如果引用的是系统资源，则采用：ohos.global.systemres.ResourceTable.type_name。

B、XML文件引用资源文件的格式： $* t y p e * * : * * nam e * * * 。特别地，如果引用的是系统资源，则采用： * *$ ohos:type:name。

C、Java中读取rawfile：通过指定文件路径和文件名称来引用。

//A、Java中读取base和限定目录读取方式
ohos.global.resource.ResourceManager resManager = this.getResourceManager();
String result = resManager.getElement(ResourceTable.String_app_name).getString();

//B、xml中读取base和限定目录读取方式
<?xml version="1.0" encoding="utf-8"?>
<DirectionalLayout xmlns:ohos="http://schemas.huawei.com/res/ohos"
    ohos:width="match_parent"
    ohos:height="match_parent"
    ohos:orientation="vertical">
    <Text ohos:text="$string:app_name"/>
</DirectionalLayout>

//C、rawfile目录读取
ohos.global.resource.ResourceManager resManager = this.getResourceManager();
ohos.global.resource.RawFileEntry rawFileEntry = resManager.getRawFileEntry("resources/rawfile/example.js");

4）base目录与限定词目录下面可以创建资源组目录（包括element、media、animation、layout、graphic、profile），用于存放特定类型的资源文件。

不同资源文件也有限制，如何定义太详细了，自己看API吧，不赘述了。

1.3.2 限定词目录

通过限定词目录可以匹配多种应用场景和设备特征。（初期学习因为比较基础，此部分内容作了解即可，不必深入探讨，后期随着了解和需求自然容易懂）。

限定词使用规则：

1）组合顺序：移动动国家码_移动网络码-语言_文字_国家或地区-横竖屏-设备类型-颜色模式-屏幕密度；可以选择其中一类或者几类；

2）限定词链接规则：参考上文汉字组合规则，移动动国家码_移动网络码之间用“下划线”，语言_文字_国家或地区中间用“下划线”，其他之间用“横线”（-）；

3）限定词有固定的取值范围，比如国家：zh（中国），us(美国）等，语言：cn(中文）、en(英文）等，设备类型：phone（手机）、tablet（平板）、car（撤车）等；开发者可以根据实际情况定义来适应多种语言、多种设备、多种场景等，具体详细参考官方API说明即可。

4）匹配优先级：移动国家码和移动网络码 > 区域（可选组合：语言、语言_文字、语言_国家或地区、语言_文字_国家或地区）> 横竖屏 > 设备类型 > 颜色模式 > 屏幕密度。

1.4 config.json配置文件

config.json文件是最重要的配置文件，内容非常细、非常多，上文截图红色文字已经说明了一些重要内容，这里再挑选一些要点做一些说明，更详细的组织结构参考官方API说明：HarmonyOS官方config.json详细配置说明

1、支持两种编辑模式：json和可视化界面编辑，根据个人喜好选择

2、 config.json最顶级三个对象app(配置全局变量，同一个app内的多个HAP必须一致）、deviceConf(不同设备配置信息，默认设备时default）、module（内容只对当前HAP有效，是当前HAP最核心、最复杂的配置对象）。

3、module对象中的重要内部属性

mainAbility 指定程序入口，它的值是"module>abilities"中Page的ability名称，可省略；
package 定义包名称
name HAP的名字，以".“开头，即”.XXX"
deviceType 取phone、tablet、tv（智慧屏）、car、wearable（穿戴设备）等
ablities 用数组方式表示当前HAP里面的ability
defPermission 定义权限，应用调用者必须申请这些权限才能使用
reqPersissions 运行时向系统申请权限
distroFilter 细分设备的分发策略，来匹配不同版本API、不同尺寸、不同分辨率的设备
其他不重要属性，省略…

"module": {
    "mainAbility": "MainAbility",
    "package": "com.example.myapplication.entry", 
    "name": ".MyOHOSAbilityPackage", 
    "description": "$string:description_application", 
    "supportedModes": [
        "drive"
    ], 
    "deviceType": [
        "car"
    ], 
    "abilities": [
        ...
    ],  
    "reqPermissions": [
        ...
    ], 
    "defPermissions": [
        ...
    ],
    "colorMode": "light"
}

4、abilities对象内部结构