Hvigor允许开发者实现自己的插件，开发者可以定义自己的构建逻辑，并与他人共享。Hvigor主要提供了两种方式来实现插件：基于hvigorfile脚本开发插件、基于typescript项目开发。下面以基于hvigorfile脚本开发插件进行介绍。 基于hvigorfile脚本开发 基于hvigorfile.ts脚本开发的方式，其优点是可实现快速开发，直接编辑工程或模块下hvigorfile.ts即可编写插件代码，不足之处是在多个项目中，无法方便的进行插件代码的复用和共享分发。 导入模块依赖。 // 导入接口 import { HvigorPlugin, HvigorNode } from...

Hivgor脚本文件 在构建的生命周期中Hvigor使用两个脚本文件来完成插件、任务以及生命周期hook的注册： hvigorconfig.ts：此文件在整个项目中只有根目录下存在一份，不是构建必须的文件并且默认不存在，如有需要可自行创建，此文件被解析执行的时间较早，可用于在Hvigor生命周期刚开始时操作某些数据。 hvigorfile.ts：此文件在每个node下都有一份，是构建的必须文件，在此文件中可以注册插件、任务以及生命周期hook等操作。 任务与任务依赖图 Hvigor是基于任务对您的项目进行自动化构建的，任务（Task）是Hvigor构建过程中的基本工作单元，它定义了构建项目...

编译构建工具DevEco Hvigor（以下简称Hvigor）是一款基于TS实现的构建任务编排工具，主要提供任务管理机制，包括任务注册编排、工程模型管理、配置管理等关键能力，提供专用于构建和测试应用的流程和可配置设置。 DevEco Studio使用构建工具Hvigor来自动执行和管理构建流程，实现应用/服务构建任务流的执行，完成HAP/APP的构建打包。 Hvigor可独立于DevEco Studio运行，这意味着，你可以在DevEco Studio内、命令行工具或是集成服务器上构建应用。无论您从命令行工具或是DevEco Studio上构建项目，构建过程的输出都将相同。 了解任务 任务是H...

HarmonyOS 5.0.1 Beta3，是HarmonyOS开发套件基于API 13正式发布的首个Beta版本。该版本在OS能力上主要增强了C API的相关能力，多个特性补充了C API供开发者使用。 OS平台能力增加 首先是系统能力增加了，这次增加了很多C接口能力，像我们用得比较多的场景有：Ability组件中元能力新增C API，可以从ApplicationContext中获取cache路径、Area以及bundleName的能力；ArkData组件中，Preferences可能在C API中使用了，但是不支持C API与ArkTS API混合使用；AVSession媒体播控模块可以在...

我们在进行页面跳转时，很多情况下都得考虑登录状态问题，比如进入个人信息页面，下单交易页面等等。在这些场景下，通常在页面跳转前，会先判断下用户是否已经登录，若已登录，则跳转到相应的目标页面，若没有登录，则先跳转到登录页面，然后等着获取登录状态，若登录页面关闭时，能获取到已登录，则继续跳转到目标页，若用户取消了登录，则终止后面的行为。这样的处理通常会存在一些问题，例如很多页面都与登录状态相关，这样需要在大量的入口处增加登录逻辑判断。即使封装成一个方法，也需要关心是否登录成功，增加了逻辑的复杂性，而且登录页面先关闭，再打开新页面，页面切换动画也很不协调。 那么我们有没有一种更好的方案来处理登录鉴权问...

Navigation组件适用于模块内和跨模块的路由切换，通过组件级路由能力实现更加自然流畅的转场体验，并提供多种标题栏样式来呈现更好的标题和内容联动效果。一次开发，多端部署场景下，Navigation组件能够自动适配窗口显示大小，在窗口较大的场景下自动切换分栏展示效果。 根页面设置 我们在Entry的入口处Index.ets使用Navigation当作根页面，这里会面临一个问题，怎么从启动页跳转到首页，并关闭启动页，使用首页一直留在页面栈中，不允许销毁，在前面的文章《鸿蒙Navigation处理启动页跳转到首页问题》中有介绍处理方法，在此不展开。在使用Navigation时，由于默认带有Tit...

Navigation是路由导航的根视图容器，一般作为页面（@Entry）的根容器，包括单栏（Stack）、分栏（Split）和自适应（Auto）三种显示模式。Navigation组件适用于模块内和跨模块的路由切换，通过组件级路由能力实现更加自然流畅的转场体验，并提供多种标题栏样式来呈现更好的标题和内容联动效果。一次开发，多端部署场景下，Navigation组件能够自动适配窗口显示大小，在窗口较大的场景下自动切换分栏展示效果。 Navigation组件主要包含​导航页（NavBar）和子页（NavDestination）。导航页由标题栏（Titlebar，包含菜单栏menu）、内容区（Navig...

@cross-device-app-dev/font-size 字体大小要求至少为8fp以便于阅读 @cross-device-app-dev/grid-columns-span 不推荐开发者将栅格中所有的GridCol子组件只设置span属性，且值与父组件的columns属性相等 @cross-device-app-dev/grid-span-value 在栅格布局组件GridCol中，span和offset不建议使用小数 @cross-device-app-dev/size-unit 组件通用属性width、height和size，应当使用vp作为单位 @c...

@performance/hp-arkts-no-use-any-export-current 避免使用export * 导出当前module中定义的类型和数据 @performance/hp-arkts-no-use-any-export-other 避免使用export * 导出其他module中定义的类型和数据 @performance/hp-arkui-avoid-empty-callback 避免设置空的系统回调监听 @performance/hp-arkui-avoid-update-auto-state-var-in-aboutToReuse 避免在a...

@typescript-eslint/no-unnecessary-type-arguments 当类型参数和默认值相同时，不允许显式使用 @typescript-eslint/no-unnecessary-type-assertion 禁止不必要的类型断言 @typescript-eslint/no-unnecessary-type-constraint 不允许在泛型中使用不必要的约束条件 @typescript-eslint/no-unused-expressions 代码中禁止包含未使用的表达式 @typescript-eslint/no-unused-v...

@typescript-eslint/adjacent-overload-signatures 建议函数重载的签名保持连续 @typescript-eslint/await-thenable 不允许对不是“Thenable”对象的值使用await关键字，相反对“Thenable”对象必须使用await，例如对Promise对象。 @typescript-eslint/array-type 定义数组时，使用统一的样式，如都使用T[]或都使用Array。 "@typescript-eslint/array-type": [ "error&qu...

在开始之前，我们先明确自定义组件和页面的关系： 自定义组件：@Component装饰的UI单元，可以组合多个系统组件实现UI的复用，可以调用组件的生命周期。 页面：即应用的UI页面。可以由一个或者多个自定义组件组成，@Entry装饰的自定义组件为页面的入口组件，即页面的根节点，一个页面有且仅能有一个@Entry。只有被@Entry装饰的组件才可以调用页面的生命周期。 页面生命周期，即被@Entry装饰的组件生命周期，提供以下生命周期接口： onPageShow：页面每次显示时触发一次，包括路由过程、应用进入前台等场景。 onPageHide：页面每次隐藏时触发一次，包括路由过程、应用进入...

Navigation作为路由容器，其生命周期承载在NavDestination组件上，以组件事件的形式开放。其生命周期大致可分为三类，自定义组件生命周期、通用组件生命周期和自有生命周期。其中，aboutToAppear和aboutToDisappear是自定义组件的生命周期(NavDestination外层包含的自定义组件)，OnAppear和OnDisappear是组件的通用生命周期。剩下的六个生命周期为NavDestination独有。生命周期时序如下图所示 aboutToAppear：在创建自定义组件后，执行其build()函数之前执行（NavDestination创建之前），允许在...

当用户打开、切换和返回到对应应用时，应用中的UIAbility实例会在其生命周期的不同状态之间转换。UIAbility类提供了一系列回调，通过这些回调可以知道当前UIAbility实例的某个状态发生改变，会经过UIAbility实例的创建和销毁，或者UIAbility实例发生了前后台的状态切换。 UIAbility的生命周期包括Create、Foreground、Background、Destroy四个状态，如下图所示 Create状态 Create状态为在应用加载过程中，UIAbility实例创建完成时触发，系统会调用onCreate()回调。可以在该回调中进行页面初始化操作，例如变量定义...