Flutter 分割线与间距控制技术解析

一、项目背景与功能概述

在 UI 设计中,分割线和间距是构建清晰视觉层次、优化内容布局的基础元素。分割线用于在视觉上分隔不同的内容区域,帮助用户理解页面的信息结构;间距则用于控制元素之间的留白,影响页面的呼吸感和可读性。一个设计良好的应用,其分割线和间距系统一定是规范而统一的,这直接影响着应用的专业度和用户体验。

本项目聚焦于 Flutter 中的分割线组件和间距控制组件的封装与实现,提供了一套功能完善、使用便捷的布局辅助工具。分割线组件支持水平分割线和垂直分割线两种方向,支持自定义厚度、颜色、缩进等属性,特别值得一提的是支持虚线分割线效果,填补了 Flutter 原生组件不支持虚线的空白。间距控制组件则提供了统一的间距管理方案,包括预设尺寸的便捷常量、自定义尺寸的间距组件、以及弹性间距等多种使用方式。

从技术实现角度来看,本项目深入探讨了 Flutter 中 CustomPaint 自定义绘制的实际应用,通过 CustomPainter 实现了虚线效果的绘制。同时,项目也展示了如何设计一套统一的间距系统,通过命名构造函数和静态常量提供多样化的使用方式,既保证了灵活性又确保了一致性。此外,项目还涉及 SizedBox、Expanded、CustomPaint 等多个 Flutter 基础组件的高级用法。这些技术对于构建布局规范、视觉统一的 Flutter 应用具有重要的实践价值。

二、整体架构分析

2.1 架构设计思路

本项目采用工具化组件的架构设计,将分割线和间距这两类布局辅助工具分别封装为独立的组件类。每个组件都提供了多种构造方式和配置选项,以适应不同的使用场景。主页组件则作为展示页面,集中演示各种分割线和间距的用法和效果。

2.2 架构图

应用入口 main

根组件 MyApp

主页组件 MyHomePage

分割线组件 DividerWidget

间距组件 SpacingWidget

间距工具类 Spacing

虚线绘制器 _DashedLinePainter

2.3 模块职责说明

  • 入口层:负责应用初始化和主题配置
  • 主页层:展示分割线和间距的各种使用示例,包括基础水平分割线、自定义分割线、虚线分割线、垂直分割线,以及基础间距、垂直间距、预设间距、弹性间距等
  • 分割线组件:提供分割线功能,支持水平/垂直方向、实线/虚线样式、自定义厚度、颜色、缩进等属性。虚线效果通过 CustomPainter 自定义绘制实现
  • 间距组件:提供间距控制功能,支持固定尺寸间距和弹性间距,支持水平和垂直方向
  • 间距工具类:提供一组预定义的间距常量和便捷的静态方法,用于统一管理间距尺寸

三、入口组件与初始化流程

3.1 应用入口与根组件

应用入口函数调用 runApp 启动应用,根组件返回标准的 MaterialApp 配置。主题使用深紫色种子色生成颜色方案,并启用 Material 3 设计规范。

与其他项目类似,根组件配置了应用标题和主题。Material 3 的启用为应用带来了更现代的视觉效果,包括新的组件样式、圆角设计和颜色系统。

3.2 主页组件

主页组件是一个 StatefulWidget,其状态类中没有自定义状态变量,所有展示内容都是静态的。页面主体使用 SingleChildScrollView 包裹,支持垂直滚动。

页面分为两大展示区域:

分割线展示区域:从上到下依次展示:

  1. 基础水平分割线:默认样式的灰色水平分割线
  2. 自定义厚度和颜色的分割线:2 像素粗,深紫色
  3. 带缩进的分割线:左右各缩进 40 像素,蓝色
  4. 虚线分割线:绿色虚线,虚线宽度 8,间隙 4
  5. 垂直分割线:在水平排列的两个文本之间插入垂直分割线

间距控制展示区域:从上到下依次展示:

  1. 基础间距:水平方向的三个色块,使用自定义尺寸的水平间距
  2. 垂直间距:垂直方向的三个色块,使用自定义尺寸的垂直间距
  3. 预设间距:使用 xs、sm、md 等预设间距常量的水平排列
  4. 弹性间距:在 Row 中使用弹性间距自动分配剩余空间

综合示例:一个模拟用户信息卡片的完整示例,综合运用了分割线和间距组件,展示了在实际业务场景中的使用方式。

整体页面内容丰富,通过标题文字、间距和分割线将各个示例清晰地组织起来,便于对比和理解。

四、核心组件逐段深度解析

4.1 分割线组件

分割线组件是一个无状态组件,提供了丰富的配置选项,支持多种分割线样式。

4.1.1 参数设计

组件接收以下可配置参数:

  • thickness:分割线厚度,默认为 1.0 像素
  • color:分割线颜色,默认为灰色
  • indent:起始缩进(水平方向为左侧缩进,垂直方向为顶部缩进),默认为 0
  • endIndent:结束缩进(水平方向为右侧缩进,垂直方向为底部缩进),默认为 0
  • isVertical:是否为垂直方向,默认为 false(水平)
  • height:垂直分割线的高度,默认为无限大
  • isDashed:是否为虚线,默认为 false(实线)
  • dashWidth:虚线每段的宽度,默认为 4.0 像素
  • dashGap:虚线每段之间的间隙,默认为 2.0 像素

参数设计非常全面,覆盖了分割线可能需要的各种配置。

4.1.2 构建逻辑

组件的 build 方法根据 isVertical 参数分为两个分支:水平分割线和垂直分割线。每个分支又根据 isDashed 参数分为实线和虚线两种实现。

垂直分割线:

  • 外层使用 SizedBox 限定宽度和高度
  • 如果是虚线,使用 CustomPaint 绘制虚线
  • 如果是实线,使用 Container 设置宽度和颜色,通过 margin 实现上下缩进

水平分割线:

  • 如果是虚线,使用 Container 限定高度,通过 margin 实现左右缩进,内部使用 CustomPaint 绘制虚线
  • 如果是实线,直接使用 Flutter 原生的 Divider 组件,配置厚度、颜色、缩进等属性

实线水平分割线优先使用原生 Divider 组件,因为它是 Flutter 框架提供的标准组件,性能和兼容性都有保障。而虚线和垂直分割线则需要自己实现,因为 Flutter 没有提供原生支持。

4.2 虚线绘制器

虚线绘制器继承自 CustomPainter,负责绘制虚线效果。这是分割线组件的核心技术亮点。

4.2.1 绘制参数

绘制器接收以下参数:

  • color:虚线颜色
  • dashWidth:每段虚线的宽度
  • dashGap:虚线之间的间隙
  • isVertical:是否垂直方向
4.2.2 绘制逻辑

paint 方法实现了虚线的绘制逻辑:

  1. 创建画笔:设置颜色、线宽和样式。线宽根据方向决定:垂直方向使用 size.width(即分割线厚度),水平方向使用 size.height
  2. 计算总长度:垂直方向取高度,水平方向取宽度
  3. 循环绘制线段:从起点开始,不断绘制一段虚线,然后跳过一段间隙,直到绘制完整个长度

在每次循环中:

  • 计算本段的结束位置(start + dashWidth)
  • 如果结束位置超出总长度,则截断到总长度
  • 根据方向调用 canvas.drawLine 绘制线段
  • 更新起始位置为结束位置加上间隙

这种循环绘制的方式是实现虚线效果的标准方法,逻辑清晰,易于理解和调整。

4.2.3 重绘判断

shouldRepaint 方法返回 false,表示绘制器创建后不需要重新绘制。这是因为虚线的样式完全由构造参数决定,一旦创建就不会变化。如果后续需要支持动画虚线等效果,就需要修改这个方法,在参数变化时返回 true 以触发重绘。

4.3 间距组件

间距组件是一个无状态组件,用于在布局中添加指定大小的间距。它本质上是对 SizedBox 的封装,但提供了更友好的 API 和更多的构造方式。

4.3.1 构造函数

组件提供了多个命名构造函数:

  • 默认构造函数:通用构造,可配置尺寸、方向、是否弹性、弹性值
  • horizontal:水平间距构造,方向设为 Axis.horizontal
  • vertical:垂直间距构造,方向设为 Axis.vertical
  • flex:弹性间距构造,flex 设为 true,用于在 Row/Column 中占据剩余空间

命名构造函数是 Dart 语言的一个重要特性,它可以为同一个类提供多种语义化的构造方式,让代码更具可读性。

4.3.2 构建逻辑

组件的 build 方法根据 flex 参数分为两种情况:

弹性间距:返回一个 Expanded 组件,包裹一个 SizedBox。Expanded 会占据 Row/Column 中剩余的可用空间,flex 值决定了分配比例。这种间距用于需要自动填充剩余空间的场景。

固定间距:返回一个 SizedBox,根据方向设置宽度或高度。如果是水平方向,设置 width 为 size,height 为 0;如果是垂直方向则相反。

通过灵活使用这两种间距模式,可以应对各种复杂的布局需求。

4.4 间距工具类

间距工具类是一个普通的 Dart 类,不是 Widget。它提供了一组预定义的间距常量和便捷的静态方法,用于统一管理项目中的间距尺寸。

4.4.1 预设常量

类定义了六级预设间距:

  • xs:4 像素,最小间距,用于紧密排列的元素之间
  • sm:8 像素,小间距,用于相关元素之间
  • md:16 像素,中等间距,用于普通内容区块之间
  • lg:24 像素,大间距,用于较大的内容区块之间
  • xl:32 像素,超大间距,用于页面主要区域之间
  • xxl:48 像素,特大间距,用于页面顶级区块之间

这些常量同时设置了 width 和 height,因此既可以用作水平间距,也可以用作垂直间距。

4.4.2 静态方法

类还提供了两个静态方法:

  • horizontal:创建指定宽度的水平间距 SizedBox
  • vertical:创建指定高度的垂直间距 SizedBox

这些方法提供了比直接使用 SizedBox 更语义化的使用方式,使代码的意图更加清晰。

4.4.3 设计意义

统一的间距系统是设计规范化的重要组成部分。使用预定义的间距常量,而不是到处写魔法数字,可以确保应用各处的间距保持一致和协调,提升整体设计质量。同时,当需要调整间距规范时,只需要修改一处定义,整个应用都会同步更新,大大提高了维护效率。

五、状态管理机制分析

5.1 无状态设计

本项目中的分割线组件和间距组件都是无状态组件(StatelessWidget),它们不维护任何内部状态。组件的所有行为都由传入的参数决定,相同的参数总是产生相同的输出。

间距工具类更是一个纯静态类,连实例都不需要创建,直接通过类名访问常量和方法。

5.2 纯展示组件模式

这些布局辅助组件都属于"纯展示组件",它们的特点是:

  • 不维护状态
  • 不处理用户交互
  • 只负责根据参数渲染 UI
  • 没有副作用

纯展示组件是 Flutter 中最基础、最常用的组件类型。它们具有以下优势:

  • 性能好:构建逻辑简单,重建开销小
  • 易测试:只需要传入不同参数验证输出即可
  • 易复用:不依赖特定上下文,可以在任何地方使用
  • 可预测:行为完全由参数决定,没有隐藏的内部逻辑

5.3 在布局系统中的角色

分割线和间距组件在 Flutter 的布局系统中扮演着"布局辅助工具"的角色。它们不承载具体的业务内容,而是帮助组织和美化布局结构。

在实际开发中,合理使用分割线和间距可以:

  • 清晰地划分内容区域,提升信息架构的可读性
  • 建立视觉节奏和层次,引导用户视线流动
  • 增加页面留白,提升视觉舒适度
  • 统一设计规范,确保应用风格一致

六、关键代码片段与技术点详解

6.1 CustomPaint 绘制虚线

虚线绘制是本项目的核心技术亮点。Flutter 没有提供原生的虚线组件,需要通过 CustomPaint 自己绘制。

while (start < length) {
  final end = start + dashWidth;
  if (isVertical) {
    canvas.drawLine(
      Offset(size.width / 2, start),
      Offset(size.width / 2, end > length ? length : end),
      paint,
    );
  } else {
    canvas.drawLine(
      Offset(start, size.height / 2),
      Offset(end > length ? length : end, size.height / 2),
      paint,
    );
  }
  start = end + dashGap;
}

这段代码的核心思想是循环绘制多段短线段,每段之间留有间隙,从而形成虚线效果。具体步骤:

  1. 初始化起始位置 start 为 0
  2. 计算本段的结束位置 end = start + dashWidth
  3. 如果 end 超出了总长度,则截断到总长度(处理最后一段)
  4. 绘制从 start 到 end 的线段
  5. 更新 start = end + dashGap(加上间隙)
  6. 重复以上步骤直到 start >= length

这种方法虽然简单,但非常实用。通过调整 dashWidth 和 dashGap 的比例,可以创造出不同风格的虚线效果:

  • 短虚线:dashWidth 小,dashGap 大,如点线
  • 长虚线:dashWidth 大,dashGap 小,如破折线
  • 等距虚线:dashWidth = dashGap,标准虚线

6.2 命名构造函数

间距组件使用了多个命名构造函数,这是 Dart 语言的一个优雅特性。

const SpacingWidget.horizontal({
  super.key,
  this.size = 16.0,
  this.direction = Axis.horizontal,
  this.flex = false,
  this.flexValue = 1,
});

命名构造函数的优势:

  • 语义清晰:调用方一眼就能看出构造的是什么类型的间距
  • 默认值合理:每个命名构造函数可以设置自己合理的默认值
  • 代码自文档化:好的命名可以替代注释,让代码自己说明用途

虽然多个命名构造函数之间有代码重复(参数列表基本相同),但为了 API 的易用性,这种牺牲是值得的。在更复杂的场景下,可以使用重定向构造函数(redirecting constructor)来减少重复。

6.3 弹性间距与 Expanded

弹性间距模式使用 Expanded 包裹 SizedBox,这是一种巧妙的布局技巧:

if (flex) {
  return Expanded(
    flex: flexValue,
    child: SizedBox(
      width: direction == Axis.horizontal ? size : 0,
      height: direction == Axis.vertical ? size : 0,
    ),
  );
}

Expanded 组件的作用是在 Row、Column 或 Flex 中占据剩余的可用空间。通过将间距包裹在 Expanded 中,间距就不再是固定大小,而是会自动伸缩填充剩余空间。

这种弹性间距在以下场景非常有用:

  • 在 Row 中需要将某些元素推到两端,中间用弹性间距填充
  • 在多个元素之间按比例分配空间
  • 需要自适应不同屏幕尺寸的布局

flex 参数可以控制多个弹性元素之间的空间分配比例。例如,两个 flex 值分别为 1 和 2 的 Expanded,会按照 1:2 的比例分配剩余空间。

6.4 间距系统的设计规范

间距工具类中定义的六级间距(xs、sm、md、lg、xl、xxl)体现了专业的设计系统思想。

class Spacing {
  static const SizedBox xs = SizedBox(height: 4, width: 4);
  static const SizedBox sm = SizedBox(height: 8, width: 8);
  static const SizedBox md = SizedBox(height: 16, width: 16);
  static const SizedBox lg = SizedBox(height: 24, width: 24);
  static const SizedBox xl = SizedBox(height: 32, width: 32);
  static const SizedBox xxl = SizedBox(height: 48, width: 48);
}

统一间距系统的价值:

  • 视觉一致性:所有页面的间距使用同一套规范,整体风格统一
  • 开发效率:开发者不需要每次纠结用多少像素的间距,直接从预设中选择
  • 维护便捷:调整设计规范时只需要修改一处定义
  • 协作顺畅:设计师和开发者使用统一的间距语言,沟通成本更低

间距值的选择通常基于 4 像素或 8 像素的栅格系统,确保所有尺寸都是基准单位的整数倍,从而建立和谐的视觉节奏。

七、技术总结与扩展方向

7.1 技术总结

本项目实现了分割线和间距控制两类布局辅助组件,深入展示了 Flutter 中自定义绘制和布局工具的开发技术。

分割线组件全面支持水平/垂直方向和实线/虚线样式,其中虚线效果通过 CustomPainter 自定义绘制实现,解决了 Flutter 原生不支持虚线的问题。组件参数设计完善,包括厚度、颜色、缩进、虚线参数等多种配置,能够满足各种场景下的分割线需求。

间距控制方面,项目提供了两种使用方式:SpacingWidget 组件和 Spacing 工具类。SpacingWidget 支持固定间距和弹性间距两种模式,通过命名构造函数提供清晰的 API。Spacing 工具类则提供了六级预设间距常量和便捷方法,建立了统一的间距系统,有助于提升应用的设计规范性。

在架构设计上,所有组件都采用无状态设计,职责单一,参数明确,具有良好的可预测性和可复用性。组件之间相互独立,各司其职,体现了良好的关注点分离原则。

7.2 扩展方向

本项目的分割线和间距组件还有很多可以扩展和深化的方向:

功能扩展:

  • 支持更多分割线样式,如点线、点划线、双划线等
  • 添加渐变分割线,支持颜色渐变效果
  • 支持带图标的分割线,在线条中间或两侧添加图标或文字
  • 支持装饰性分割线,如波浪线、折线等
  • 添加间距调试模式,可视化显示页面中的所有间距

增强功能:

  • 支持响应式间距,根据屏幕尺寸自动调整间距大小
  • 支持间距主题,可通过主题配置全局间距规格
  • 添加分割线动画效果,如入场动画、过渡动画
  • 支持可拖拽分割线,用于可调整大小的布局

架构优化:

  • 建立更完整的设计系统规范,包括颜色、字体、间距、圆角等
  • 支持深色模式适配,自动调整分割线颜色
  • 添加完整的组件文档和使用示例
  • 封装为独立的包(package),方便在多个项目间复用

性能优化:

  • 对于虚线绘制,可以考虑使用路径绘制(Path + dashPathEffect)替代循环绘制,提高性能
  • 合理使用 const 构造函数,利用编译时优化
  • 使用 RepaintBoundary 隔离 CustomPaint 的重绘

工具增强:

  • 添加更多布局辅助工具,如 SafeArea 增强、比例布局、定位布局等
  • 开发 VS Code/IDE 插件,快速插入间距和分割线代码
  • 提供间距检查工具,自动检测不规范的间距使用

总之,本项目为 Flutter 布局辅助工具的开发提供了扎实的技术基础和良好的设计范式。通过深入理解 CustomPaint 绘制机制、组件封装思想和设计系统规范,开发者可以构建出更加专业、更加规范的 Flutter 应用,为用户提供一致、优雅、舒适的视觉体验。

请添加图片描述

Flutter for OpenHarmony 实战:分割线与间距控制

前言:跨生态开发的新机遇

在移动开发领域,我们总是面临着选择与适配。今天,你的Flutter应用在Android和iOS上跑得正欢,明天可能就需要考虑一个新的平台:HarmonyOS(鸿蒙)。这不是一道选答题,而是很多团队正在面对的现实。

Flutter的优势很明确——写一套代码,就能在两个主要平台上运行,开发体验流畅。而鸿蒙代表的是下一个时代的互联生态,它不仅仅是手机系统,更着眼于未来全场景的体验。将现有的Flutter应用适配到鸿蒙,听起来像是一个“跨界”任务,但它本质上是一次有价值的技术拓展:让产品触达更多用户,也让技术栈覆盖更广。

不过,这条路走起来并不像听起来那么简单。Flutter和鸿蒙,从底层的架构到上层的工具链,都有着各自的设计逻辑。会遇到一些具体的问题:代码如何组织?原有的功能在鸿蒙上如何实现?那些平台特有的能力该怎么调用?更实际的是,从编译打包到上架部署,整个流程都需要重新摸索。
这篇文章想做的,就是把这些我们趟过的路、踩过的坑,清晰地摊开给你看。我们不会只停留在“怎么做”,还会聊到“为什么得这么做”,以及“如果出了问题该往哪想”。这更像是一份实战笔记,源自真实的项目经验,聚焦于那些真正卡住过我们的环节。

无论你是在为一个成熟产品寻找新的落地平台,还是从一开始就希望构建能面向多端的应用,这里的思路和解决方案都能提供直接的参考。理解了两套体系之间的异同,掌握了关键的衔接技术,不仅能完成这次迁移,更能积累起应对未来技术变化的能力。

混合工程结构深度解析

项目目录架构

当Flutter项目集成鸿蒙支持后,典型的项目结构会发生显著变化。以下是经过ohos_flutter插件初始化后的项目结构:

my_flutter_harmony_app/
├── lib/                          # Flutter业务代码(基本不变)
│   ├── main.dart                 # 应用入口
│   ├── components/               # 组件目录
│   │   ├── divider_widget.dart   # 分割线组件
│   │   └── spacing_widget.dart   # 间距控制组件
│   └── utils/
│       └── platform_utils.dart  # 平台工具类
├── pubspec.yaml                  # Flutter依赖配置
├── ohos/                         # 鸿蒙原生层(核心适配区)
│   ├── entry/                    # 主模块
│   │   └── src/main/
│   │       ├── ets/              # ArkTS代码
│   │       │   ├── MainAbility/
│   │       │   │   ├── MainAbility.ts       # 主Ability
│   │       │   │   └── MainAbilityContext.ts
│   │       │   └── pages/
│   │       │       ├── Index.ets           # 主页面
│   │       │       └── Splash.ets          # 启动页
│   │       ├── resources/        # 鸿蒙资源文件
│   │       │   ├── base/
│   │       │   │   ├── element/  # 字符串等
│   │       │   │   ├── media/    # 图片资源
│   │       │   │   └── profile/  # 配置文件
│   │       │   └── en_US/        # 英文资源
│   │       └── config.json       # 应用核心配置
│   ├── ohos_test/               # 测试模块
│   ├── build-profile.json5      # 构建配置
│   └── oh-package.json5         # 鸿蒙依赖管理
└── README.md

展示效果图片

flutter 实时预览 效果展示

运行到鸿蒙虚拟设备中效果展示

目录

功能代码实现

分割线组件

设计思路

分割线组件是UI布局中常用的元素,用于分隔不同的内容区域,提升界面的层次感和可读性。在本实现中,我们设计了一个功能丰富的分割线组件,支持以下特性:

  • 水平和垂直两种方向
  • 自定义厚度、颜色
  • 支持缩进效果
  • 支持虚线样式

核心代码实现

import 'package:flutter/material.dart';

class DividerWidget extends StatelessWidget {
  final double thickness;
  final Color color;
  final double indent;
  final double endIndent;
  final bool isVertical;
  final double height;
  final bool isDashed;
  final double dashWidth;
  final double dashGap;

  const DividerWidget({
    super.key,
    this.thickness = 1.0,
    this.color = Colors.grey,
    this.indent = 0.0,
    this.endIndent = 0.0,
    this.isVertical = false,
    this.height = double.infinity,
    this.isDashed = false,
    this.dashWidth = 4.0,
    this.dashGap = 2.0,
  });

  
  Widget build(BuildContext context) {
    if (isVertical) {
      return SizedBox(
        width: thickness,
        height: height,
        child: isDashed
            ? CustomPaint(
                painter: _DashedLinePainter(
                  color: color,
                  dashWidth: dashWidth,
                  dashGap: dashGap,
                  isVertical: true,
                ),
              )
            : Container(
                margin: EdgeInsets.symmetric(
                  vertical: indent,
                ),
                width: thickness,
                color: color,
              ),
      );
    } else {
      return isDashed
          ? Container(
              height: thickness,
              margin: EdgeInsets.only(
                left: indent,
                right: endIndent,
              ),
              child: CustomPaint(
                painter: _DashedLinePainter(
                  color: color,
                  dashWidth: dashWidth,
                  dashGap: dashGap,
                  isVertical: false,
                ),
              ),
            )
          : Divider(
              thickness: thickness,
              color: color,
              indent: indent,
              endIndent: endIndent,
            );
    }
  }
}

class _DashedLinePainter extends CustomPainter {
  final Color color;
  final double dashWidth;
  final double dashGap;
  final bool isVertical;

  _DashedLinePainter({
    required this.color,
    required this.dashWidth,
    required this.dashGap,
    required this.isVertical,
  });

  
  void paint(Canvas canvas, Size size) {
    final paint = Paint()
      ..color = color
      ..strokeWidth = isVertical ? size.width : size.height
      ..style = PaintingStyle.stroke;

    final length = isVertical ? size.height : size.width;
    double start = 0.0;

    while (start < length) {
      final end = start + dashWidth;
      if (isVertical) {
        canvas.drawLine(
          Offset(size.width / 2, start),
          Offset(size.width / 2, end > length ? length : end),
          paint,
        );
      } else {
        canvas.drawLine(
          Offset(start, size.height / 2),
          Offset(end > length ? length : end, size.height / 2),
          paint,
        );
      }
      start = end + dashGap;
    }
  }

  
  bool shouldRepaint(covariant CustomPainter oldDelegate) {
    return false;
  }
}

代码解析

  1. 组件参数设计:

    • thickness:分割线厚度,默认为1.0
    • color:分割线颜色,默认为灰色
    • indent:分割线缩进,水平分割线为左侧缩进,垂直分割线为顶部缩进
    • endIndent:分割线结束缩进,仅对水平分割线有效
    • isVertical:是否为垂直分割线,默认为false(水平分割线)
    • height:垂直分割线的高度,默认为无限大
    • isDashed:是否为虚线,默认为false
    • dashWidth:虚线线段宽度,默认为4.0
    • dashGap:虚线线段间距,默认为2.0
  2. 实现逻辑:

    • 根据isVertical参数判断是水平还是垂直分割线
    • 根据isDashed参数判断是实线还是虚线
    • 对于虚线,使用CustomPaint和_DashedLinePainter自定义绘制
    • 对于实线,水平分割线使用Flutter内置的Divider组件,垂直分割线使用Container实现
  3. 虚线绘制:

    • 自定义_DashedLinePainter类继承自CustomPainter
    • 根据isVertical参数决定绘制方向
    • 使用循环绘制多个线段,实现虚线效果

使用方法

// 基础水平分割线
DividerWidget()

// 自定义厚度和颜色的分割线
DividerWidget(
  thickness: 2,
  color: Colors.deepPurple,
)

// 带缩进的分割线
DividerWidget(
  indent: 40,
  endIndent: 40,
  color: Colors.blue,
)

// 虚线分割线
DividerWidget(
  isDashed: true,
  dashWidth: 8,
  dashGap: 4,
  color: Colors.green,
)

// 垂直分割线
DividerWidget(
  isVertical: true,
  height: 80,
)

开发注意事项

  1. 性能优化:

    • 对于频繁使用的分割线,建议使用常量构造函数创建
    • 虚线分割线使用了CustomPaint,在列表中使用时要注意性能
  2. 布局适配:

    • 垂直分割线需要指定合适的height值
    • 在Row中使用垂直分割线时,要注意Row的对齐方式
  3. 颜色一致性:

    • 建议在主题中定义分割线颜色,保持应用内颜色一致

间距控制组件

设计思路

间距控制是UI布局中的重要部分,合理的间距可以提升界面的美观度和可读性。在本实现中,我们设计了一个灵活的间距控制组件,支持以下特性:

  • 水平和垂直两种方向
  • 固定间距和弹性间距
  • 预设常用间距值

核心代码实现

import 'package:flutter/material.dart';

class SpacingWidget extends StatelessWidget {
  final double size;
  final Axis direction;
  final bool flex;
  final int flexValue;

  const SpacingWidget({
    super.key,
    this.size = 16.0,
    this.direction = Axis.vertical,
    this.flex = false,
    this.flexValue = 1,
  });

  const SpacingWidget.horizontal({
    super.key,
    this.size = 16.0,
    this.direction = Axis.horizontal,
    this.flex = false,
    this.flexValue = 1,
  });

  const SpacingWidget.vertical({
    super.key,
    this.size = 16.0,
    this.direction = Axis.vertical,
    this.flex = false,
    this.flexValue = 1,
  });

  const SpacingWidget.flex({
    super.key,
    this.size = 0.0,
    this.direction = Axis.vertical,
    this.flex = true,
    this.flexValue = 1,
  });

  
  Widget build(BuildContext context) {
    if (flex) {
      return Expanded(
        flex: flexValue,
        child: SizedBox(
          width: direction == Axis.horizontal ? size : 0,
          height: direction == Axis.vertical ? size : 0,
        ),
      );
    }
    return SizedBox(
      width: direction == Axis.horizontal ? size : 0,
      height: direction == Axis.vertical ? size : 0,
    );
  }
}

class Spacing {
  static const SizedBox xs = SizedBox(height: 4, width: 4);
  static const SizedBox sm = SizedBox(height: 8, width: 8);
  static const SizedBox md = SizedBox(height: 16, width: 16);
  static const SizedBox lg = SizedBox(height: 24, width: 24);
  static const SizedBox xl = SizedBox(height: 32, width: 32);
  static const SizedBox xxl = SizedBox(height: 48, width: 48);

  static SizedBox horizontal(double size) => SizedBox(width: size);
  static SizedBox vertical(double size) => SizedBox(height: size);
}

代码解析

  1. 组件参数设计:

    • size:间距大小,默认为16.0
    • direction:间距方向,默认为垂直方向
    • flex:是否为弹性间距,默认为false
    • flexValue:弹性间距的权重,默认为1
  2. 构造函数:

    • 默认构造函数:创建指定大小和方向的间距
    • horizontal:创建水平间距的便捷构造函数
    • vertical:创建垂直间距的便捷构造函数
    • flex:创建弹性间距的便捷构造函数
  3. Spacing工具类:

    • 提供了常用间距的静态常量:xs(4), sm(8), md(16), lg(24), xl(32), xxl(48)
    • 提供了创建水平和垂直间距的静态方法

使用方法

// 使用SpacingWidget
SpacingWidget(size: 20)
SpacingWidget.horizontal(size: 16)
SpacingWidget.vertical(size: 12)
SpacingWidget.flex(flexValue: 2)

// 使用Spacing工具类
Spacing.md
Spacing.horizontal(24)
Spacing.vertical(16)

开发注意事项

  1. 间距规范:

    • 建议在项目中统一使用预设的间距值,保持布局一致性
    • 可以根据设计系统的要求,调整Spacing工具类中的预设值
  2. 弹性布局:

    • 在Row或Column中使用弹性间距时,要注意其他子组件的布局
    • 弹性间距会占据剩余空间,可能影响其他组件的显示
  3. 性能优化:

    • 对于固定间距,建议使用Spacing工具类中的静态常量
    • 避免在build方法中频繁创建新的间距组件

组件集成

首页集成

在首页中,我们集成了分割线和间距控制组件,展示了不同样式的分割线和间距效果。

import 'package:flutter/material.dart';
import 'components/divider_widget.dart';
import 'components/spacing_widget.dart';

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key, required this.title});

  final String title;

  
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        backgroundColor: Theme.of(context).colorScheme.inversePrimary,
        title: Text(widget.title),
      ),
      body: SingleChildScrollView(
        padding: const EdgeInsets.all(20),
        child: Column(
          crossAxisAlignment: CrossAxisAlignment.start,
          children: <Widget>[
            // 分割线展示
            const Text(
              '分割线组件展示',
              style: TextStyle(fontSize: 20, fontWeight: FontWeight.bold),
            ),
            Spacing.md,
            
            // 基础水平分割线
            const Text('基础水平分割线'),
            Spacing.sm,
            Container(
              padding: const EdgeInsets.symmetric(vertical: 10),
              child: const DividerWidget(),
            ),
            
            // 自定义厚度和颜色的分割线
            const Text('自定义厚度和颜色的分割线'),
            Spacing.sm,
            Container(
              padding: const EdgeInsets.symmetric(vertical: 10),
              child: const DividerWidget(
                thickness: 2,
                color: Colors.deepPurple,
              ),
            ),
            
            // 带缩进的分割线
            const Text('带缩进的分割线'),
            Spacing.sm,
            Container(
              padding: const EdgeInsets.symmetric(vertical: 10),
              child: const DividerWidget(
                indent: 40,
                endIndent: 40,
                color: Colors.blue,
              ),
            ),
            
            // 虚线分割线
            const Text('虚线分割线'),
            Spacing.sm,
            Container(
              padding: const EdgeInsets.symmetric(vertical: 10),
              child: const DividerWidget(
                isDashed: true,
                dashWidth: 8,
                dashGap: 4,
                color: Colors.green,
              ),
            ),
            
            // 垂直分割线
            const Text('垂直分割线'),
            Spacing.sm,
            Container(
              height: 100,
              child: Row(
                mainAxisAlignment: MainAxisAlignment.center,
                children: const [
                  Text('左侧内容'),
                  DividerWidget(isVertical: true, height: 80),
                  Text('右侧内容'),
                ],
              ),
            ),
            
            Spacing.lg,
            const DividerWidget(thickness: 1, color: Colors.grey),
            Spacing.lg,
            
            // 间距控制展示
            const Text(
              '间距控制组件展示',
              style: TextStyle(fontSize: 20, fontWeight: FontWeight.bold),
            ),
            Spacing.md,
            
            // 基础间距
            const Text('基础间距'),
            Spacing.sm,
            Row(
              children: [
                Container(width: 50, height: 50, color: Colors.red),
                Spacing.horizontal(16),
                Container(width: 50, height: 50, color: Colors.green),
                Spacing.horizontal(24),
                Container(width: 50, height: 50, color: Colors.blue),
              ],
            ),
            
            Spacing.md,
            
            // 垂直间距
            const Text('垂直间距'),
            Spacing.sm,
            Column(
              children: [
                Container(width: 100, height: 30, color: Colors.red),
                Spacing.vertical(12),
                Container(width: 100, height: 30, color: Colors.green),
                Spacing.vertical(16),
                Container(width: 100, height: 30, color: Colors.blue),
              ],
            ),
            
            Spacing.md,
            
            // 预设间距
            const Text('预设间距'),
            Spacing.sm,
            Row(
              children: [
                Container(width: 30, height: 30, color: Colors.red),
                Spacing.xs,
                Container(width: 30, height: 30, color: Colors.green),
                Spacing.sm,
                Container(width: 30, height: 30, color: Colors.blue),
                Spacing.md,
                Container(width: 30, height: 30, color: Colors.yellow),
              ],
            ),
            
            Spacing.md,
            
            // 弹性间距
            const Text('弹性间距'),
            Spacing.sm,
            Row(
              children: [
                Container(width: 50, height: 50, color: Colors.red),
                const SpacingWidget.flex(),
                Container(width: 50, height: 50, color: Colors.green),
                const SpacingWidget.flex(flexValue: 2),
                Container(width: 50, height: 50, color: Colors.blue),
              ],
            ),
            
            Spacing.xl,
            
            // 综合示例
            const Text(
              '综合示例',
              style: TextStyle(fontSize: 18, fontWeight: FontWeight.bold),
            ),
            Spacing.md,
            Container(
              padding: const EdgeInsets.all(16),
              decoration: BoxDecoration(
                border: Border.all(color: Colors.grey),
                borderRadius: BorderRadius.circular(8),
              ),
              child: Column(
                crossAxisAlignment: CrossAxisAlignment.start,
                children: [
                  const Text('用户信息', style: TextStyle(fontSize: 16, fontWeight: FontWeight.bold)),
                  Spacing.sm,
                  DividerWidget(thickness: 1, color: Colors.grey.shade300),
                  Spacing.md,
                  Row(
                    children: [
                      Container(width: 60, height: 60, color: Colors.purple),
                      Spacing.horizontal(16),
                      Column(
                        crossAxisAlignment: CrossAxisAlignment.start,
                        children: [
                          const Text('用户名', style: TextStyle(fontSize: 16)),
                          Spacing.xs,
                          const Text('用户邮箱', style: TextStyle(fontSize: 14, color: Colors.grey)),
                        ],
                      ),
                    ],
                  ),
                  Spacing.md,
                  DividerWidget(thickness: 1, color: Colors.grey.shade300),
                  Spacing.md,
                  Row(
                    mainAxisAlignment: MainAxisAlignment.spaceBetween,
                    children: [
                      TextButton(onPressed: () {}, child: const Text('编辑')),
                      TextButton(onPressed: () {}, child: const Text('删除')),
                    ],
                  ),
                ],
              ),
            ),
          ],
        ),
      ),
    );
  }
}

集成注意事项

  1. 导入路径:

    • 确保正确导入组件文件,路径根据项目结构调整
  2. 布局结构:

    • 使用SingleChildScrollView确保内容超出屏幕时可以滚动
    • 使用Column和Row组织布局,结合间距组件控制元素间距
  3. 性能优化:

    • 对于固定的文本和组件,使用const关键字
    • 避免在build方法中频繁创建新的Widget
  4. 适配性:

    • 测试不同屏幕尺寸下的显示效果
    • 确保在OpenHarmony设备上的显示效果与Flutter预览一致

本次开发中容易遇到的问题

1. 组件导入路径问题

问题描述

在集成组件时,可能会遇到导入路径错误的问题,导致编译失败。

解决方案

  • 检查项目结构,确保组件文件路径正确
  • 使用相对路径导入组件,如import 'components/divider_widget.dart';
  • 避免使用包名导入,除非组件已经发布为包

注意事项

  • 导入路径的大小写要与实际文件路径一致
  • 确保组件文件存在于指定路径中

2. 虚线分割线绘制问题

问题描述

在某些设备或Flutter版本上,虚线分割线可能显示不正确,或者性能较差。

解决方案

  • 使用CustomPaint时,确保shouldRepaint方法返回false,避免不必要的重绘
  • 对于长列表中的虚线分割线,考虑使用缓存或其他优化方式
  • 测试不同设备上的显示效果,确保兼容性

注意事项

  • 虚线的dashWidth和dashGap值不宜过小,否则可能导致显示模糊
  • 在低性能设备上,大量使用自定义绘制可能会影响性能

3. 间距控制一致性问题

问题描述

在不同的布局中,间距控制不一致,导致界面美观度下降。

解决方案

  • 统一使用Spacing工具类中的预设值
  • 在项目中建立间距规范,明确不同场景下使用的间距值
  • 使用主题或常量类管理间距值,方便统一调整

注意事项

  • 遵循设计系统的间距规范
  • 考虑不同屏幕尺寸下的间距适配

4. 弹性布局计算问题

问题描述

在使用弹性间距时,可能会遇到布局计算错误,导致组件显示异常。

解决方案

  • 确保在Row或Column中使用弹性间距时,其他子组件的布局是合理的
  • 避免在同一个Row或Column中混合使用过多的弹性组件
  • 测试不同内容长度下的布局效果

注意事项

  • 弹性间距会影响其他组件的布局,使用时要谨慎
  • 在复杂布局中,考虑使用Expanded或Flexible组件直接控制

5. 平台适配问题

问题描述

在OpenHarmony设备上,分割线和间距的显示效果可能与Flutter预览不一致。

解决方案

  • 测试不同OpenHarmony版本上的显示效果
  • 考虑平台差异,必要时进行平台特定的调整
  • 使用Flutter的平台检测功能,针对不同平台提供不同的实现

注意事项

  • OpenHarmony的渲染引擎可能与Android/iOS有所不同
  • 测试是确保跨平台兼容性的关键

总结本次开发中用到的技术点

1. 组件化开发

技术要点

  • 将分割线和间距控制逻辑抽离为独立组件
  • 使用构造函数参数实现组件的灵活性
  • 提供便捷构造函数和工具类,简化使用方式

应用场景

  • 分割线组件:用于分隔不同内容区域,如列表项、卡片等
  • 间距控制组件:用于控制UI元素之间的间距,提升布局美观度

2. 自定义绘制

技术要点

  • 使用CustomPaint和CustomPainter实现虚线分割线
  • 掌握Canvas绘图API,实现自定义图形
  • 优化绘制性能,避免不必要的重绘

应用场景

  • 虚线分割线:适用于需要特殊样式分割线的场景
  • 自定义图形:适用于需要绘制复杂图形的场景

3. 布局控制

技术要点

  • 使用Row和Column组织布局
  • 使用SingleChildScrollView实现滚动布局
  • 使用弹性布局实现灵活的空间分配

应用场景

  • 页面布局:组织页面中的各个元素
  • 列表布局:实现垂直或水平的列表
  • 复杂布局:处理包含多种元素的复杂界面

4. 工具类设计

技术要点

  • 设计静态工具类,提供常用的间距常量和方法
  • 使用常量构造函数,提升性能
  • 统一管理间距值,保持布局一致性

应用场景

  • 间距管理:统一控制UI元素之间的间距
  • 样式管理:统一管理应用中的样式元素
  • 工具方法:提供常用的工具方法,简化代码

5. 性能优化

技术要点

  • 使用const关键字创建不可变Widget
  • 优化自定义绘制性能,避免不必要的重绘
  • 合理使用弹性布局,避免布局计算错误

应用场景

  • 列表渲染:提升长列表的滚动性能
  • 复杂界面:优化包含多个组件的复杂界面
  • 动画效果:确保动画流畅运行

6. 跨平台适配

技术要点

  • 确保组件在不同平台上的显示效果一致
  • 测试OpenHarmony设备上的显示效果
  • 考虑平台差异,进行必要的调整

应用场景

  • Flutter for OpenHarmony项目:确保在OpenHarmony设备上的兼容性
  • 多平台项目:确保在Android、iOS和OpenHarmony上的一致性

7. 代码规范

技术要点

  • 遵循Dart代码规范,保持代码风格一致
  • 使用有意义的变量和方法命名
  • 添加适当的注释,提高代码可读性

应用场景

  • 团队开发:确保团队成员之间的代码风格一致
  • 代码维护:提高代码的可维护性和可读性
  • 开源项目:符合开源社区的代码规范要求

8. 测试与调试

技术要点

  • 测试不同场景下的组件显示效果
  • 使用Flutter DevTools进行性能分析
  • 调试布局问题,确保组件正确显示

应用场景

  • 开发阶段:及时发现和解决问题
  • 发布前:确保组件在各种场景下的稳定性
  • 维护阶段:定位和修复问题

通过本次开发,我们成功实现了Flutter for OpenHarmony的分割线和间距控制组件,掌握了组件化开发、自定义绘制、布局控制等关键技术点。这些技术不仅适用于分割线和间距控制的开发,也是Flutter开发中的通用技术,对于构建高质量的Flutter应用具有重要意义。

在开发过程中,我们遇到了一些问题,如组件导入路径问题、虚线分割线绘制问题、间距控制一致性问题等,但通过分析问题原因,采取相应的解决方案,成功解决了这些问题。

同时,我们也总结了一些开发经验和最佳实践,如统一使用间距工具类、优化自定义绘制性能、确保跨平台兼容性等,这些经验对于后续的Flutter for OpenHarmony开发工作具有参考价值。

请添加图片描述

flutter_openHarmony(简称 Flutter‑OH)

注意:不是Google官方产物,是OpenHarmony社区TPC组织维护的Flutter引擎移植版本。把Flutter的Dart/Skia引擎做底层改造,让Flutter应用可以直接编译输出 HAP包,跑在OpenHarmony/纯血鸿蒙设备上,不需要依赖Android兼容层。

简单讲:一套Dart/Flutter业务代码,可以同时编译 Android、iOS、OpenHarmony(HAP)。

核心原理

对Flutter Engine做Embedder嵌入适配,对接OpenHarmony Rosen图形管线、UIAbility生命周期,通过MethodChannel实现 Dart ↔ ArkTS双向通信,Flutter自绘UI渲染到鸿蒙Surface,复用方舟编译器、系统权限、分布式能力。

  • Dart业务代码几乎不变
  • 底层引擎适配鸿蒙图形、线程、生命周期
  • 输出产物是标准HAP应用包,可上架鸿蒙应用市场

主要优势

  1. 存量Flutter项目低成本接入鸿蒙生态
    纯Dart业务、纯Widget界面几乎不用改代码即可编译出鸿蒙HAP;只有带Android/iOS原生桥接的插件,才需要做鸿蒙适配替换。已经有成熟Flutter App,想快速覆盖鸿蒙设备,不用全部重写ArkTS。

  2. 多端UI高度一致性
    Flutter自绘渲染,不受各平台控件差异影响,手机、平板、车机界面表现统一;滚动、动画、首页各类动效(轮播、吸顶、骨架屏、入场动画)跨平台表现一致,和你前面问的App首页各种效果可以一套代码全部实现。

  3. 继承Flutter完整开发体验
    保留热重载、DevTools调试、完整Widget组件库;pub.dev海量纯Dart三方库直接复用,是鸿蒙跨端方案里三方库最丰富的方案。提供定制CLI,一条命令完成编译、真机调试、打包HAP。

  4. 可调用OpenHarmony原生系统能力
    支持调用分布式软总线、分布式数据KV、原子化服务、鸿蒙权限体系、硬件能力;Flutter页面和ArkTS原生页面可以混合开发、互相跳转,复杂原生逻辑继续写ArkTS,UI业务交给Flutter实现。

  5. 全场景设备覆盖
    支持OpenHarmony手机、平板、智慧屏、车机等设备,适合需要多终端统一UI的业务。引擎做了懒加载,跟随UIAbility生命周期启停,控制内存占用,减少后台资源消耗。

Logo

开源鸿蒙跨平台开发社区汇聚开发者与厂商,共建“一次开发,多端部署”的开源生态,致力于降低跨端开发门槛,推动万物智联创新。

更多推荐