推荐|HarmonyOS Next开发学习手册——UI开发 (兼容JS的类Web开发范式)

兼容JS的类Web开发范式的方舟开发框架，采用经典的HML、CSS、JavaScript三段式开发方式。使用HML标签文件进行布局搭建，使用CSS文件进行样式描述，使用JavaScript文件进行逻辑处理。UI组件与数据之间通过单向数据绑定的方式建立关联，当数据发生变化时，UI界面自动触发更新。此种开发方式，更接近Web前端开发者的使用习惯，快速将已有的Web应用改造成方舟开发框架应用。主要适用于界面较为简单的中小型应用开发。

请参考兼容JS的类Web开发范式API 文档，全面地了解组件，更好地开发应用。

整体架构

兼容JS的类Web开发范式的方舟开发框架，包括应用层（Application）、前端框架层（Framework）、引擎层（Engine）和平台适配层（Porting Layer）。

Application

应用层表示开发者开发的FA应用，这里的FA应用特指JS FA应用。
Framework

前端框架层主要完成前端页面解析，并提供MVVM（Model-View-ViewModel）开发模式、页面路由机制和自定义组件等能力。
Engine

引擎层主要提供动画解析、DOM（Document Object Model）树构建、布局计算、渲染命令构建与绘制、事件管理等能力。
Porting Layer

适配层主要对平台层进行抽象，提供抽象接口，可以对接到系统平台。比如：事件对接、渲染管线对接和系统生命周期对接等。

框架说明

文件组织

目录结构

JS FA应用的JS模块（entry/src/main/js/module）的典型开发目录结构如下：

图1 目录结构

图2 多实例资源共享目录结构

目录结构中文件分类如下：

.hml结尾的HML模板文件，描述当前页面的文件布局结构。
.css结尾的CSS样式文件，描述页面样式。
.js结尾的JS文件，处理页面间的交互。

各个文件夹的作用：

app.js文件用于全局JavaScript逻辑和应用生命周期管理，详见 app.js 。
pages目录用于存放所有组件页面。
common目录用于存放公共资源文件，比如：媒体资源，自定义组件和JS文件。
resources目录用于存放资源配置文件，比如：多分辨率加载等配置文件，详见资源限定与访问章节。
share目录用于配置多个实例共享的资源内容，比如：share中的图片和JSON文件可被default1和default2实例共享。

说明

i18n和resources文件夹不可重命名。
如果share目录中的资源和实例(default)中的资源文件同名且目录一致时，实例中资源的优先级高于share中资源的优先级。
share目录当前不支持i18n。
在使用DevEco Studio进行应用开发时，目录结构中的可选文件夹需要开发者根据实际情况自行创建。

文件访问规则

应用资源可通过绝对路径或相对路径的方式进行访问，绝对路径以"/“开头，相对路径以”./“或”…/"。具体访问规则如下：

引用代码文件，推荐使用相对路径，比如：…/common/utils.js。
引用资源文件，推荐使用绝对路径。比如：/common/xxx.png。
公共代码文件和资源文件推荐放在common下，通过以上两条规则进行访问。
CSS样式文件中通过url()函数创建数据类型，如：url(/common/xxx.png)。

说明
当代码文件A需要引用代码文件B时：

如果代码文件A和文件B位于同一目录，则代码文件B引用资源文件时可使用相对路径，也可使用绝对路径。
如果代码文件A和文件B位于不同目录，则代码文件B引用资源文件时必须使用绝对路径。因为Webpack打包时，代码文件B的目录会发生变化。
在js文件中通过数据绑定的方式指定资源文件路径时，必须使用绝对路径。

媒体文件格式

表1 支持的图片格式

格式	支持的文件类型
BMP	.bmp
GIF	.gif
JPEG	.jpg
PNG	.png
WebP	.webp

表2 支持的视频格式

格式	支持的文件类型
H.264 AVC Baseline Profile (BP)	.3gp .mp4

鸿蒙全栈开发全新学习指南

有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以要有一份实用的鸿蒙（HarmonyOS NEXT）学习路线与学习文档用来跟着学习是非常有必要的。

针对一些列因素，整理了一套纯血版鸿蒙（HarmonyOS Next）全栈开发技术的学习路线，包含了鸿蒙开发必掌握的核心知识要点，内容有（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、WebGL、元服务、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、OpenHarmony驱动开发、系统定制移植等等）鸿蒙（HarmonyOS NEXT）技术知识点。