鸿蒙应用开发入门(四):进一步了解第一个例子里的细节 原创 精华

钟洪发老师
发布于 2020-12-21 17:58
浏览
0收藏

4.1 开发完第一个鸿蒙应用后,下面在了解一下完整的鸿蒙应用打包发布后应该是什么样子:
   一个完整的打包后应用结构如下图所示,这里我们先了解结构,具体怎么打包很简单只要前提是要签名!

鸿蒙应用开发入门(四):进一步了解第一个例子里的细节-鸿蒙开发者社区

   1. HAP的分类
   HAP又可分为entry和feature两种模块类型:
   1)entry:应用的主模块。一个APP中,对于同一设备类型必须有且只有一个entry类型的HAP,可独立安装运行。
   2) feature:应用的动态特性模块。一个APP可以包含一个或多个feature类型的HAP,也可以不含。


   2. HAP的组成
   HAP是由代码(Ability)、第三方库、资源以及应用配置文件构成,只有包含Ability的HAP才能够独立运行。
   1)Ability
   Ability是应用所具备的能力的抽象,一个应用可以包含一个或多个Ability。Ability分为两种类型:FA(Feature Ability)和PA(Particle Ability)。FA/PA是应用的基本组成单元,能够实现特定的业务功能。FA有UI界面,而PA无UI界面。
   2)库文件
   库文件是应用依赖的第三方代码形式,存放在libs目录。
   3)资源文件
   应用的资源文件(字符串、图片、音频等)存放于resources目录下
   4)配置文件
   配置文件 (config.json) 是应用的Ability信息,用于声明应用的Ability,以及应用所需权限等信息


   3. pack.info文件
   描述应用软件包中每个HAP的属性,由IDE编译生成,应用市场根据该文件进行拆包和HAP的分类存储。 
   HAP的具体属性包括:
   1)delivery-with-install: 表示该HAP是否支持随应用安装。
   2)name:HAP文件名。
   3)module-type:模块类型,entry或feature。
   4)device-type:表示支持该HAP运行的设备类型。


4.2 config.json详细细节
   1. 应用的每个HAP的根目录下都存在一个“config.json”配置文件,主要涵盖以下三个方面:
   1)应用的全局配置信息,包含应用的包名、生产厂商、版本号等基本信息。
   2)应用在具体设备上的配置信息。
   3)HAP包的配置信息,包含每个Ability必须定义的基本属性(如包名、类名、类型以及Ability提供的能力),以及应用访问系统或其他应用受保护部分所需的权限等。


   2. config.json配置文件的内部结构
应用的配置文件“config.json”中由“app”、“deviceConfig”和“module”三个部分组成,缺一不可。


   3. “config.json”文件约定
   配置文件“config.json”采用JSON文件格式,由属性和值两部分构成:
   1)属性:属性出现顺序不分先后,且每个属性最多只允许出现一次。
   2)值:每个属性的值为JSON的基本数据类型(数值、字符串、布尔值、数组、对象或者null类型)。


   学习建议:根据官方文档自己做一个思维导图,做的过程中熟悉,用的时候查询,我学习的时候做的,附件在后面,需要一个叫MindMaster的思维导图工具打开。做完思维导图系统地熟悉一遍这个配置项后,再在下面的练习中,把每个配置项目的意思备注后面,加深印象。

 

    练习1:认一遍app部分,把说明注释在第一个例子的app配置后面:

"app": { //表示应用的全局配置信息,就像这样,后面的自己做......
  "bundleName": "com.example.myapplication",
  "vendor": "example", 
  "version": {
    "code": 1, 
    "name": "1.0"  
  },
  "apiVersion": { 
    "compatible": 3,  
    "target": 3 
  }
},

练习2:认一遍deviceConfig部分,把说明注释在后面:

"deviceConfig": {//表示应用在具体设备上的配置信息。
  "default": { 
    "process": "com.huawei.hiworld.example",
    "directLaunch": false,
    "supportBackup": false,
    "network": {
      "usesCleartext": true,
      "securityConfig": {
        "domainSettings": { 
          "cleartextPermitted": true, 
          "domains": [
            {
              "subDomains": true,
              "name": "example.ohos.com"
            }
          ]
        }
      }
    }
  }
}

练习3:认一遍认一下module部分,把说明注释在后面:

"module": {//表示HAP包的配置信息。该标签下的配置只对当前HAP包生效。
  "package": "com.example.myapplication", 
  "name": ".MyApplication",
  "reqCapabilities": [
    "video_support"  
  ],
  "deviceType": [
    "tv"
  ],
  "distro": {
    "deliveryWithInstall": true,
    "moduleName": "entry",
    "moduleType": "entry"
  },
  "abilities": [
    {
      "skills": [
        {
          "entities": [
            "entity.system.home"
          ],
          "actions": [
            "action.system.home"
          ]
        }
      ],
      "orientation": "landscape", 
      "formEnabled": false,
      "name": "com.example.myapplication.MainAbility",
      "icon": "$media:icon",
      "description": "$string:mainability_description",
      "label": "MyApplication",
      "type": "page",
      "launchType": "standard"
    },
    {
      "orientation": "landscape",
      "formEnabled": false,
      "name": "com.example.myapplication.Secondbility",
      "icon": "$media:icon",
      "description": "$string:secondbility_description",
      "label": "entry",
      "type": "page",
      "launchType": "standard"
    }
  ]
}

 

4.3 进一步了解资源目录的细节
   1. 资源文件的知识点
   应用的资源文件都在resources目录下,resources子目录分两大类目录:具体的知识点,同样我们做成思维导图,见后面附件。

 

   2. 资源文件的使用
   base目录与限定词目录中的资源文件:通过指定资源类型(type)和资源名称(name)来引用。
   1)Java文件引用资源文件的格式:
   (1)普通资源:ResourceTable.type_name。
   (2)系统资源,则采用:ohos.global.systemres.ResourceTable.type_name。
   (3)目前支持的系统资源文件:
      ① ic_app:表示HarmonyOS应用的默认图标,类型为媒体。
      ② request_location_reminder_title:表示“请求使用设备定位功能”的提示标题,类型为字符串。
      ③ request_location_reminder_content:表示“请求使用设备定位功能”的提示内容,类型为字符串。


   示例一:在Java文件中,引用系统资源。

ResourceManager rsManager = this.getResourceManager();
try {
    String str = rsManager
            .getElement(ohos.global.systemres.ResourceTable.
                    String_request_location_reminder_title).getString();
    Text text = (Text) findComponentById(ResourceTable.Id_text);
    text.setText(str);
} catch (Exception e) {
    terminateAbility();
}

    示例二:在Java文件中,引用string.json文件中类型为“String”、名称为“app_name”的资源。
    string.json的例子:

{
    "color":[
        {
            "name":"red",
            "value":"#ff0000"
        },
        {
            "name":"red_ref",
            "value":"$color:red"
        }
    ]
}

ohos.global.resource.ResourceManager resManager = getResourceManager();
int color = resManager.getElement(ResourceTable.Color_red).getColor();

    示例四:在Java文件中,获取profile中的文件内容。

Resource resource = null;
try {
    Text text = (Text) findComponentById(ResourceTable.Id_text);
    resource = getResourceManager().getResource(ResourceTable.Profile_test1);
    InputStreamReader inputStreamReader = new InputStreamReader(resource, "utf-8");
    BufferedReader bufferedReader = new BufferedReader(inputStreamReader);
    String lineTxt = "";
    while((lineTxt = bufferedReader.readLine()) != null){
        text.append(","+lineText);
    }
} catch (Exception e) {
    
}

 

   2)XML文件引用资源文件的格式:
   (1)普通资源,$type:name
   (2)系统资源,则采用:$ohos:type:name。

   在XML文件中,引用 string.json文件中类型为“String”、名称为“app_name”的资源,示例如下:

<?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>

    9. rawfile目录中的资源文件
    通过指定文件路径和文件名称来引用。
    在Java文件中,引用一个路径为“resources/rawfile/”、名称为“ttt.txt”的资源文件,示例如下:

Resource resource = null;
try {
    Text text = (Text) findComponentById(ResourceTable.Id_text);
    resource = getResourceManager().getRawFileEntry("resources/rawfile/ttt.txt").openRawFile();
    InputStreamReader inputStreamReader = new InputStreamReader(resource, "utf-8");
    BufferedReader bufferedReader = new BufferedReader(inputStreamReader);
    String lineTxt = "";
    while((lineTxt = bufferedReader.readLine()) != null){
        text.append(","+lineTxt );
    }
} catch (Exception e) {

}

 

    文章配套视频课程《鸿蒙手机应用开发入门》https://edu.51cto.com/course/26133.html

©著作权归作者所有,如需转载,请注明出处,否则将追究法律责任
思维导图.zip 35.76K 115次下载
已于2020-12-22 13:09:32修改
1
收藏
回复
举报
1条回复
按时间正序
/
按时间倒序
鸿蒙张荣超
鸿蒙张荣超

钟老师总结得很棒,666~~

回复
2020-12-21 20:25:20
回复
    相关推荐