[文章]DevEco Studio项目构建讲解、编写页面、布局介绍、页面跳转

DevEco Studio 项目构建讲解
一、项目目录
1. config.json （配置文件）
2. entry （应用的主模块）
二、编写页面
三、页面跳转
1. 创建Feature Ability
2. 跳转逻辑

一、项目目录 1. config.json （配置文件）

• bundleName 表示应用的包名，用于标识应用的唯一性。采用反域名形式的字符串表示（例如，com.llw.helloworld）。建议第一级为域名后缀“com”，第二级为厂商/个人名，第三级为应用名，也可以采用多级。支持的字符串长度为7~127字节。不可省缺。
• vendor 表示对应用开发厂商的描述。字符串长度不超过255字节。可以省缺，省缺值为空。
• version 这是一个对象，表示应用的版本信息。它里面有两个参数，code和name，code 表示应用的版本号，仅用于HarmonyOS管理该应用，对用户不可见。取值为大于零的整数。name表示应用的版本号，用于向用户呈现。取值可以自定义。两个参数都不可省缺。
• apiVersion 这也是一个对象，表示应用依赖的HarmonyOS的API版本。它里面也有两个参数，compatible 和 target ，compatible 表示应用运行需要的API最小版本。取值为大于零的整数。不可省缺target 表示应用运行需要的API目标版本。取值为大于零的整数。可缺省，缺省值为应用所在设备的当前API版本。
  

• process 表示应用或者Ability的进程名。如果在“deviceConfig”标签下配置了“process”标签，则该应用的所有Ability都运行在这个进程中。 如果在“abilities”标签下也为某个Ability配置了“process”标签，则该Ability就运行在这个进程中。该标签仅适用于智慧屏、智能穿戴、车机。可缺省，缺省为应用的软件包名。
• directLaunch 表示应用是否支持在设备未解锁状态直接启动。如果配置为“true”，则表示应用支持在设备未解锁状态下启动。使用场景举例：应用支持在设备未解锁情况下接听来电。可缺省，缺省为“false”。该标签仅适用于智慧屏、智能穿戴、车机。
• supportBackup 表示应用是否支持备份和恢复。如果配置为“false”，则不支持为该应用执行备份或恢复操作。该标签仅适用于智慧屏、智能穿戴、车机。可缺省，缺省为“false”。
• compressNativeLibs 表示libs库是否以压缩存储的方式打包到HAP包。如果配置为“false”，则libs库以不压缩的方式存储，HAP包在安装时无需解压libs，运行时会直接从HAP内加载libs库。该标签仅适用于智慧屏、智能穿戴、车机。可缺省，缺省为“true”。
• network 表示网络安全性配置。该标签允许应用通过配置文件的安全声明来自定义其网络安全，无需修改应用代码。
  

• usesCleartext 表示是否允许应用使用明文网络流量（例如，明文HTTP）。true：允许应用使用明文流量的请求。false：拒绝应用使用明文流量的请求。可缺省，缺省为“false”。
• securityConfig 表示应用的网络安全配置信息。可缺省，缺省为空。
  然后再展开securityConfig，如下
  
  
  
    domainSettings 表示自定义的网域范围的安全配置，支持多层嵌套，即一个domainSettings对象中允许嵌套更小网域范围的domainSettings对象。可缺省，缺省为空。它里面有cleartextPermitted属性和domains对象。
• cleartextPermitted表示自定义的网域范围内是否允许明文流量传输。当useCleartext和securityConfig同时存在时，自定义网域是否允许明文流量传输以cleartextPermitted的取值为准。true：允许明文流量传输。false：拒绝明文流量传输。不可省缺。
• domains 表示域名配置信息，包含两个参数：subDomains和name。subDomains（布尔类型）：表示是否包含子域名。如果为 “true”，此网域规则将与相应网域及所有子网域（包括子网域的子网域）匹配。否则，该规则仅适用于精确匹配项。
  name（字符串）：表示域名名称。不可省缺。
  说是说deviceConfig里面没有东西，但是这么一顿操作下来，我人都傻了。好了，清醒一点，还有一个module没说呢？
  

• package 表示HAP的包结构名称，在应用内应保证唯一性。采用反向域名格式（建议与HAP的工程目录保持一致）。字符串长度不超过127字节。该标签仅适用于智慧屏、智能穿戴、车机。不可省缺。
• name 表示HAP的类名。采用反向域名方式表示，前缀需要与同级的package标签指定的包名一致，也可采用“.”开头的命名方式。字符串长度不超过255字节。该标签仅适用于智慧屏、智能穿戴、车机。不可省缺。
• reqCapabilities 表示需要的技术支持，这是一个字符串数组，里面可以看到有一个video_support，表示视频支持。
• deviceType 表示允许Ability运行的设备类型。系统预定义的设备类型包括：tv（智慧屏）、car（车机）、wearable（智能穿戴）、liteWearable（轻量级智能穿戴）等。不可省缺。
  

• distro 表示HAP发布的具体描述。这是一个对象，该标签仅适用于智慧屏、智能穿戴、车机。不可省缺。它里面还有
  
  • deliveryWithInstall 表示当前HAP是否支持随应用安装。true：支持随应用安装。false：不支持随应用安装。不可省缺。
  • moduleName 表示当前HAP的名称。不可省缺。
  • moduleType 表示当前HAP的类型，包括两种类型：entry和feature。不可省缺。
    
• abilities 表示当前模块内的所有Ability。采用对象数组格式，其中每个元素表示一个Ability对象。可缺省，缺省值为空。下面来看看里面有哪些属性
  
  
  
  可以看到这个里面有一个对象数组skills，其余就是就是一些配置的属性了。skills 里面还有两个字符串数组entities和actiions,下面先从这个skills 来分析。
• skills 打过游戏的都知道，这是技能的意思。不过在这里是表示Ability能够接收的Intent的特征。 这个Intent的用法其实和Android里面是比较像的，比如我们跳转到手机的短信页面就可以通过Intent，还有打电话也可以通过Intent，类似这样的特征。可缺省，缺省值为空。从上图我们知道里面还有两个字符串对象。
  
  • actions 表示能够接收的Intent的action值，可以包含一个或多个action。取值通常为系统预定义的action值，可缺省，缺省值为空。
  • entities 表示能够接收的Intent的Ability的类别（如视频、桌面应用等），可以包含一个或多个entity。取值通常为系统预定义的类别，可缺省，缺省值为空。
    看到这里你会很奇怪，因为你知道Android里面除了有Intent帮我们实现之外还有Uri可以实现，那么上面的截图中也没有这个属性，是为什么？答案就是这个属性属于开发者自行去做配置。这里就补充一下这个属性，它其实一个对象数组。它就是uris
  • uris 表示能够接收的Intent的uri，可以包含一个或者多个uri。可缺省，缺省值为空。它里面的数据如下：
    
  
  

• orientation 表示该Ability的显示模式。该标签仅适用于page类型的Ability。取值范围如下：unspecified：由系统自动判断显示方向。landscape：横屏模式。portrait：竖屏模式。followRecent：跟随栈中最近的应用。可缺省，缺省值为“unspecified”。
• formEnabled 表示FA类型的Ability是否提供卡片（form）能力。该标签仅适用于page类型的Ability。true：提供卡片能力。false：不提供卡片能力。可缺省，缺省值为“false”。
• name 表示Ability名称。取值可采用反向域名方式表示，由包名和类名组成，如“com.llw.helloworld.MainAbility”；也可采用“.”开头的类名方式表示，如“.MainAbility”。该标签仅适用于智慧屏、智能穿戴、车机。不可省缺。
• icon 表示Ability图标资源文件的索引。取值示例：$media:ability_icon。
  如果在该Ability的“skills”属性中，“actions”的取值包含 “action.system.home”，“entities”取值中包含“entity.system.home”，则该Ability的icon将同时作为应用的icon。如果存在多个符合条件的Ability，则取位置靠前的Ability的icon作为应用的icon。可缺省，缺省值为空。
• description 表示对Ability的描述。取值可以是描述性内容，也可以是对描述性内容的资源索引，以支持多语言。可缺省，缺省值为空。
• label 表示Ability对用户显示的名称。取值可以是Ability名称，也可以是对该名称的资源索引，以支持多语言。如果在该Ability的“skills”属性中，“actions”的取值包含 “action.system.home”，“entities”取值中包含“entity.system.home”，则该Ability的label将同时作为应用的label。如果存在多个符合条件的Ability，则取位置靠前的Ability的label作为应用的label。可缺省，缺省值为空。
• type 表示Ability的类型。取值范围如下：page：表示基于Page模板开发的FA，用于提供与用户交互的能力。service：表示基于Service模板开发的PA，用于提供后台运行任务的能力。data：表示基于Data模板开发的PA，用于对外部提供统一的数据访问抽象。不可省缺。
• launchType 表示Ability的启动模式，支持“standard”和“singleton”两种模式：standard：表示该Ability可以有多实例。“standard”模式适用于大多数应用场景。singleton：表示该Ability只可以有一个实例。例如，具有全局唯一性的呼叫来电界面即采用“singleton”模式。该标签仅适用于智慧屏、智能穿戴、车机。可缺省，缺省值为“standard”。
  

2. entry （应用的主模块）

• base和rawfile，首先从单词的字面意思来看是基础和原始文件。官方的意思是 base目录和 限定词目录。按照两级目录形式来组织，目录命名必须符合规范，以便根据设备状态去匹配相应目录下的资源文件。听起来是不是云里雾里，我都不知道你在说啥，下面我说一下我的个人理解，你可以把这个文件夹理解为AS的values文件下，我们之前一些样式、颜色、尺寸、文字都是放在里面的，基本上一个values就够了，但是如果要做国际化或者多语言的话，我们会新建一个values-en的文件夹，这个里面的的资源文件就是切换语言之后使用的。那么你就可以把这个限定词目录理解为values-en。当然我也不知道对不对啊，先这么理解再说吧。限定词目录可以由一个或多个表征应用场景或设备特征的限定词组合而成，包括语言、文字、国家或地区、横竖屏、设备类型和屏幕密度等六个维度，限定词之间通过下划线（_）或者中划线（-）连接。开发者在创建限定词目录时，需要掌握限定词目录的命名要求以及与限定词目录与设备状态的匹配规则。当然这个限定词还是有命名规范的。
  

• 限定词的组合顺序：语言_文字_国家或地区-横竖屏-设备类型-屏幕密度。开发者可以根据应用的使用场景和设备特征，选择其中的一类或几类限定词组成目录名称。
• 限定词的连接方式：语言、文字、国家或地区之间采用下划线（_）连接，除此之外的其他限定词之间均采用中划线（-）连接。例如：zh_Hant_CN、zh_CN-car-ldpi。
• 限定词的取值范围：每类限定词的取值必须符合表2中的条件，否则，将无法匹配目录中的资源文件。                       
  表2 限定词取值要求  
  

  限定词类型	含义与取值说明
  语言	表示设备使用的语言类型，由2个小写字母组成。例如：zh表示中文，en表示英语。 详细取值范围，参见ISO 639-1（ISO制定的语言编码标准）。
  文字	表示设备使用的文字类型，由1个大写字母（首字母）和3个小写字母组成。例如：Hans表示简体中文，Hant表示繁体中文。 详细取值范围，参见ISO 15924（ISO制定的文字编码标准）。
  国家或地区	表示用户所在的国家或地区，由2~3个大写字母或者3个数字组成。例如：CN表示中国，GB表示英国。 详细取值范围，参见ISO 3166-1（ISO制定的国家和地区编码标准）。
  横竖屏	表示设备的屏幕方向，取值如下： vertical：竖屏 horizontal：横屏
  设备类型	表示设备的类型，取值如下：           car：车机 tv：智慧屏 wearable：智能穿戴
  屏幕密度	表示设备的屏幕密度（单位为dpi），取值如下：           sdpi：表示小规模的屏幕密度（Small-scale Dots Per Inch），适用于120dpi及以下的设备。 mdpi：表示中规模的屏幕密度（Medium-scale Dots Per Inch），适用于120dpi~160dpi的设备。 ldpi：表示大规模的屏幕密度（Large-scale Dots Per Inch），适用于160dpi~240dpi的设备。 xldpi：表示特大规模的屏幕密度（Extra Large-scale Dots Per Inch），适用于240dpi~320dpi的设备。 xxldpi：表示超大规模的屏幕密度（Extra Extra Large-scale Dots Per Inch），适用于320dpi~480dpi的设备。 xxxldpi：表示超特大规模的屏幕密度（Extra Extra Extra Large-scale Dots Per Inch），适用于480dpi~640dpi的设备。

  
     
  

        表3      资源组目录     说明    [td]

资源组目录	目录说明	资源文件
element	表示元素资源，以下每一类数据都采用相应的JSON文件来表征。        boolean，布尔型 color，颜色 float，浮点型 intarray，整型数组 integer，整型 pattern，样式 plural，复数形式 strarray，字符串数组 string，字符串	element目录中的文件名称建议与下面的文件名保持一致。每个文件中只能包含同一类型的数据。        boolean.json color.json float.json intarray.json integer.json pattern.json plural.json strarray.json string.json
media	表示媒体资源，包括图片、音频、视频等非文本格式的文件。	文件名可自定义，例如：icon.png。
animation	表示动画资源，采用XML文件格式。	文件名可自定义，例如：zoom_in.xml。
layout	表示布局资源，采用XML文件格式。	文件名可自定义，例如：home_layout.xml。
graphic	表示可绘制资源，采用XML文件格式。	文件名可自定义，例如：notifications_dark.xml。
profile	表示其他类型文件，以原始文件形式保存。	文件名可自定义。

• rawfile 这个文件是干嘛的呢？支持创建多层子目录，目录名称可以自定义，文件夹内可以自由放置各类资源文件。rawfile目录的文件不会根据设备状态去匹配不同的资源。这个里面就是一个综合体，相当于包含了AS的drawable和mipmap以及其他的一些文件，只不过它没有做尺寸上的细分，需要开发者自行细分做不同设备的适配，不过既然是华为里面的东西，我相信到时候会有一个系统的关于这方面的讲解的。
  系统资源文件
                     系统资源文件说明      

  系统资源名称	含义	类型
  ic_app	表示HarmonyOS应用的默认图标。	媒体
  request_location_reminder_title	表示“请求使用设备定位功能”的提示标题。	字符串
  request_location_reminder_content	表示“请求使用设备定位功能”的提示内容，即：请在下拉快捷栏打开"位置信息"开关。	字符串

  
  

二、编写页面








三、页面跳转 1. 创建Feature Ability

2. 跳转逻辑