一、任务说明

构建一个简单的具有页面跳转功能的应用，以此来熟悉HarmonyOS应用开发流程！HarmonyOS提供了两种FA（Feature Ability）的UI开发框架：Java UI框架和JS UI框架。本文会通过Java和JS两种方式的Demo来入门HarmonyOS，此外也会介绍HarmonyOS的DevEco Studio编码工具的相关使用，工程的配置文件介绍，资源文件介绍等内容，文章大部分理论部分来自官网。 https://developer.harmonyos.com/cn/home

二、配置文件介绍

配置文件的目录在entry -> src -> main -> config.json应用的每个HAP的根目录下都存在一个“config.json”配置文件，格式采用JSON格式，每个配置项由属性和值两部分组成： 属性：出现顺序不分先后，不允许重复出现 值：JSON的基本数据类型（数值、字符串、布尔值、数组、对象或者null类型），属性值可以引用资源文件

文件内容主要涵盖以下三个方面：

应用的全局配置信息，包含应用的包名、生产厂商、版本号等基本信息。

应用在具体设备上的配置信息，包含应用的备份恢复、网络安全等能力。

HAP包的配置信息，包含每个Ability必须定义的基本属性（如包名、类名、类型以及Ability提供的能力），以及应用访问系统或其他应用受保护部分所需的权限等。

三、资源文件介绍

资源文件路径entry -> src -> main -> resource下的全部文件，用于统一存放字符串、图片、音频等资源。

资源目录结构主要包括:

base 目录是默认存在的目录。当应用的resources资源目录中没有与设备状态匹配的限定词目录时，会自动引用该目录中的资源文件。

限定词目录，开发中自行创建

rawfile默认存在的目录支持创建多层子目录，目录名称可以自定义，文件夹内可以*放置各类资源文件。rawfile目录的文件不会根据设备状态去匹配不同的资源。

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

限定词目录： 限定词目录可以由一个或多个表征应用场景或设备特征的限定词组合而成，包括移动国家码和移动网络码、语言、文字、国家或地区、横竖屏、设备类型、颜色模式和屏幕密度等维度，限定词之间通过下划线（_）或者中划线（-）连接。开发者在创建限定词目录时，需要掌握限定词目录的命名要求以及与限定词目录与设备状态的匹配规则。 限定词目录的命名要求

限定词的组合顺序：移动国家码_移动网络码-语言_文字_国家或地区-横竖屏-设备类型-深色模式-屏幕密度。开发者可以根据应用的使用场景和设备特征，选择其中的一类或几类限定词组成目录名称。

限定词的连接方式：语言、文字、国家或地区之间采用下划线（）连接，移动国家码和移动网络码之间也采用下划线（）连接，除此之外的其他限定词之间均采用中划线（-）连接。例如：zh_Hant_CN、zh_CN-car-ldpi。

限定词的取值范围：每类限定词的取值必须符合表2中的条件，否则，将无法匹配目录中的资源文件。

限定词目录与设备状态的匹配规则

在为设备匹配对应的资源文件时，限定词目录匹配的优先级从高到低依次为：移动国家码和移动网络码 > 区域（可选组合：语言、语言_文字、语言_国家或地区、语言_文字_国家或地区）> 横竖屏 > 设备类型 > 颜色模式 > 屏幕密度。

如果限定词目录中包含移动国家码和移动网络码、语言、文字、横竖屏、设备类型、颜色模式限定词，则对应限定词的取值必须与当前的设备状态完全一致，该目录才能够参与设备的资源匹配。例如，限定词目录“zh_CN-car-ldpi”不能参与“en_US”设备的资源匹配。

三、使用Java语言开发

打开编辑器DevEco Studio创建一个工程，选择File -> New -> New Project

在Project窗口中，点击entry -> src -> main -> resources -> base -> layout -> ability_main.xml文件，可以看到如下代码

页面中的内容包括一个文本和一个按钮，使用DependentLayout方式进行布局，通过Text和Button组件实现其中vp代表虚拟像素，fp代表字体像素，其中Button中的内容引用自string.json资源，这是HarmonyOS官方推荐的方式。注意如下内容修改的是ability_main.xml文件。

加载xml布局，打开entry -> src -> main -> java -> com -> liziba -> demo -> slice -> MainAbilitySlice,java文件，通过类的继承关系MainAbilitySlice **extends **AbilitySlice，可以看出MainAbilitySlice 是一个AbilitySlice的子类，而AbilitySlice主要用于承载单个页面的具体逻辑实现和界面UI，是应用显示、运行和跳转的最小单元。

package com.liziba.demo.slice;
 
import ohos.aafwk.ability.AbilitySlice;
import ohos.aafwk.content.Intent;
import ohos.agp.colors.RgbColor;
import ohos.agp.components.DependentLayout;
import ohos.agp.components.Text;
import ohos.agp.components.element.ShapeElement;
import ohos.agp.utils.Color;
 
/**
 * 第二个页面
 */
public class SecondAbilitySlice extends AbilitySlice {
 
 
    @Override
    protected void onStart(Intent intent) {
        super.onStart(intent);
 
        // 声明布局
        DependentLayout myLayout = new DependentLayout(this);
 
        // 设置布局宽高
        myLayout.setWidth(DependentLayout.LayoutConfig.MATCH_PARENT);
        myLayout.setHeight(DependentLayout.LayoutConfig.MATCH_PARENT);
 
        // 设置布局背景为白色
        ShapeElement background = new ShapeElement();
        background.setRgbColor(new RgbColor(255, 255, 255));
        myLayout.setBackground(background);
 
        // 创建一个文本
        Text text = new Text(this);
        text.setText("你好李子捌！");
        text.setWidth(DependentLayout.LayoutConfig.MATCH_PARENT);
        text.setTextSize(100);
        text.setTextColor(Color.BLACK);
 
        // 设置文本的布局
        DependentLayout.LayoutConfig textConfig = new DependentLayout.LayoutConfig(DependentLayout.LayoutConfig.MATCH_CONTENT, DependentLayout.LayoutConfig.MATCH_CONTENT);
        textConfig.addRule(DependentLayout.LayoutConfig.CENTER_IN_PARENT);
        text.setLayoutConfig(textConfig);
        myLayout.addComponent(text);
        super.setUIContent(myLayout);
    }
}