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();
intcolor = 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”的资源,示例如下:
ohos:width="match_parent"
ohos:height="match_parent"
ohos:orientation="vertical">
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
©著作权归作者和HarmonyOS技术社区共同所有,如需转载,请注明出处,否则将追究法律责任
【编辑推荐】
【责任编辑:jianghua TEL:(010)68476606】
点赞 0