- 博客(748)
- 收藏
- 关注
RSS订阅原创 鸿蒙中 cachedCount的工作原理
本文同步发表于我的，微信搜索 程语新视界即可关注，每个工作日都有文章更新鸿蒙（HarmonyOS）开发中，是 LazyForEach 的关键优化属性，用于控制懒加载组件的缓冲机制。
2026-03-05 18:00:00
309
原创 鸿蒙ArkTS卡片生命周期管理
摘要：ArkTS卡片是鸿蒙应用开发中的轻量级服务交互形态，通过FormExtensionAbility实现生命周期管理。核心生命周期方法包括：onAddForm（添加卡片）、onUpdateForm（更新卡片）、onRemoveForm（移除卡片）等。开发时需注意进程生命周期限制（回调执行后进程仅存续10秒），长时间任务应通过拉起主应用处理。卡片支持数据持久化、事件处理和配置更新响应，开发者需合理管理卡片状态和数据资源。完整实现需导入FormKit、AbilityKit等核心模块，并遵循鸿蒙卡片开发规范。
2026-03-05 06:45:00
336
原创 鸿蒙中 LazyForEach销毁回收组件流程
鸿蒙系统LazyForEach组件销毁回收流程包含三个关键环节：1.销毁触发（滑出可视区域或数据变更）；2.回收过程（调用onDestroy、解除节点绑定、GC回收内存）；3.特殊复用场景（@Reusable装饰器实现缓存复用）。开发需注意：避免内存泄漏、确保容器约束、使用稳定键值生成规则。该机制通过按需渲染和智能回收实现高效内存管理，适用于List/Grid等滚动容器场景。
2026-03-04 18:00:00
321
原创 鸿蒙ArkTS卡片配置文件
必做事项使用稳定的字符串定义name，避免使用资源文件确保五元组在应用升级后不变合理设置刷新周期，避免过度消耗电量为不同设备类型配置合适的supportDimensions提供预览图（previewImages）增强用户体验注意事项检查卡片数量不超过16个确认默认卡片（isDefault）全局唯一验证定时刷新和定点刷新的优先级测试五元组变化时的卡片行为版本检查新特性字段（如API 22+）确认目标设备版本支持废弃字段（如colorMode）及时移除。
2026-03-04 06:45:00
339
原创 鸿蒙中 数据更新IDataSource的通知机制（二）
文章摘要： 本文深入分析了HarmonyOS中数据源通知机制的调用时机与实现原理。通过代码示例展示了初始化加载时通知方法被调用但无监听器接收的特殊情况，解释了LazyForEach通过主动调用totalCount()和getData()显示数据的机制。详细剖析了滚动加载场景下的分页实现逻辑，包括阈值判断、异步加载和变更通知。最后总结了通知机制的核心原则：初始化场景依赖主动读取，数据变化场景必须通过通知机制触发UI更新。文章通过数据库和新闻社的比喻形象说明了被动查询与主动推送的关系，并解答了常见面试问题。
2026-03-03 18:00:00
460
原创 鸿蒙 属性更新器（AttributeUpdater）
鸿蒙应用开发中，AttributeUpdater作为高效的属性更新方案，解决了传统AttributeModifier的性能瓶颈问题。它支持直接获取和更新组件属性，无需状态变量即可实现即时UI更新，特别适合动画、拖拽等高频更新场景。相比普通AttributeModifier，AttributeUpdater新增了直接操作属性对象、更新构造参数等能力，同时保持了跨文件复用特性。使用时需注意一个实例仅能绑定单个组件，且必须调用super保持功能完整性。该方案在需要频繁更新属性或修改构造参数时优势明显，但需避免与状
2026-03-03 06:45:00
789
原创 鸿蒙中 数据更新IDataSource的通知机制（一）
摘要：本文通过对比错误和正确的数据源实现，阐述了在ArkUI开发中使用LazyForEach时必须通知监听器的原因。错误实现中数据更新后未通知监听器，导致UI不更新；正确实现通过观察者模式，在数据变更后主动调用监听器方法。这种设计相比自动检测变化具有性能优势，避免了轮询检查或深度比较的开销，特别适合大数据量场景。文章还分析了框架底层调用链和设计哲学，强调显式通知机制在保证性能的同时，让开发者对UI更新有完全控制权。
2026-03-02 18:00:00
243
原创 鸿蒙中 属性修改器（AttributeModifier）-样式复用
本文介绍了HarmonyOS中AttributeModifier装饰器的核心功能和使用方法。与@Styles和@Extend相比，AttributeModifier支持跨文件复用、参数传递、业务逻辑和多态样式，解决了现有样式复用方案的局限性。文章详细阐述了接口定义、基础使用、属性覆盖原则、多Modifier组合、多态样式设置等核心功能，并提供了最佳实践建议。通过状态变量触发UI刷新，AttributeModifier实现了动态样式控制，同时支持按压态、焦点态等多种交互状态。最后还列出了属性支持情况和版本差异
2026-03-02 06:45:00
1014
原创 鸿蒙中 数据源接口IDataSource
本文介绍了鸿蒙应用开发中IDataSource接口的使用方法。IDataSource是ArkUI框架提供的数据源接口，与LazyForEach配合可实现列表数据的懒加载，解决传统ForEach渲染大量数据时的性能问题。文章详细解析了IDataSource接口定义，包括totalCount()、getData()等方法，以及数据变化监听器的实现方式。通过BasicDataSource示例代码演示了如何创建数据源，并在List组件中使用LazyForEach实现高效渲染。同时指出了常见问题，如数据刷新不及时和索
2026-03-01 18:00:00
484
原创 鸿蒙中 @BuilderParam装饰器
摘要：ArkUI的@BuilderParam装饰器解决了HarmonyOS自定义组件功能固化问题，支持通过父组件动态注入@Builder方法实现灵活定制。该装饰器支持本地初始化、父组件初始化两种方式，并可通过尾随闭包简化传参。使用时需注意this指向问题（箭头函数可保持父组件上下文）和参数类型匹配，且必须用@Builder方法初始化。典型应用场景包括参数化组件、尾随闭包初始化和V2组件模型集成，能有效提高组件复用性和解耦功能逻辑。限制条件包括不能使用普通变量初始化、与@Require联用需外部初始化等。
2026-03-01 06:45:00
1055
原创 鸿蒙中 @Builder装饰器：自定义构建函数
定义在自定义组件内部的@Builder函数，是该组件的私有成员函数。@Entry@Component// 无参数的私有@Builder函数@Builder// 带参数的私有@Builder函数@Builderbuild() {Column() {// 调用无参数@Builder// 调用带参数@Builder调用方式在自定义组件内、build函数中调用在其他自定义构建函数中调用使用this关键字访问定义在组件外部的@Builder函数，可以在任何组件中使用。
2026-02-28 18:00:00
1296
原创 鸿蒙中的 引用传递 和 值传递
本文详细介绍了HarmonyOS开发中的数据传递机制，重点对比了值传递和引用传递的特性与应用场景。值传递通过复制数据副本实现静态展示，而引用传递通过共享内存地址支持UI动态刷新。文章还介绍了API 20+新增的回调传递方式，既能刷新UI又可修改参数。针对不同开发场景，作者提供了明确的传递方式选择建议：静态数据用值传递，动态数据用引用传递，需要修改参数的则使用回调传递。同时指出了常见的开发误区，为开发者优化UI性能和状态管理提供了实用指导。
2026-02-28 06:45:00
1099
原创 鸿蒙中 @Extend装饰器：专属样式扩展
HarmonyOS中的@Extend装饰器是一种组件样式扩展机制，相比通用的@Styles装饰器，它提供了更细粒度的样式复用能力。@Extend支持为指定组件封装私有属性、事件和方法，允许参数传递和状态变量使用，实现特定组件的样式复用。关键特性包括：支持组件私有属性、方法嵌套调用、参数传递、事件句柄和状态变量。但与@Styles不同，@Extend仅支持全局定义且不能混用@Styles方法。通过将公共样式提取为参数化方法，@Extend能有效减少代码重复，提升开发效率，特别适用于需要为特定组件创建可复用样式
2026-02-27 18:00:00
847
原创 鸿蒙中 @Prop、@Link、@ObjectLink的区别
摘要： ArkUI框架中，@Prop、@Link和@ObjectLink是父子组件通信的关键装饰器，区别显著： 数据流：@Prop单向（父→子，子修改不反向同步）；@Link和@ObjectLink双向（父子实时同步）。 数据类型：@Prop仅支持基本类型；@Link支持基本类型、对象和数组；@ObjectLink专用于@Observed装饰的嵌套对象或数组。 初始化：@Prop可设默认值；@Link和@ObjectLink必须由父组件传递引用。 适用场景： @Prop：只读展示、配置传递。 @Link：表
2026-02-27 06:45:00
1493
原创 鸿蒙中 @Styles装饰器：样式复用
摘要：HarmonyOS的@Styles装饰器是提升应用开发效率的样式复用工具，支持API version 9+。它允许将通用属性和事件封装为方法，通过组件内定义（优先级高）或全局定义实现样式复用。主要特点包括：支持访问组件状态变量、组合多个样式、封装事件处理，但不支持参数传递、逻辑语句和跨文件导出。与AttributeModifier相比，@Styles更适合单文件内的简单样式复用。开发时应注意样式优先级、避免在@Styles中使用逻辑代码，合理选择复用方案以平衡开发效率和代码可维护性。
2026-02-26 18:00:00
986
原创 TaskPool与Worker区别, 如何选择？
摘要：ArkTS中的TaskPool和Worker是两种多线程方案，核心区别在于TaskPool采用任务驱动、自动管理线程池，适合短时独立任务；Worker采用线程驱动、需手动管理，适合长期驻留任务。TaskPool支持线程复用和丰富调度功能，但任务时长受限；Worker可长期运行并维护状态，支持双向通信。选择依据取决于任务性质：短时计算选TaskPool，长期服务选Worker。多数场景推荐TaskPool，仅在需要持久化线程或超长任务时使用Worker。
2026-02-26 06:45:00
730
原创 HAP、HAR、HSP的区别及适用场景?
摘要：HarmonyOS应用开发包含HAP、HAR和HSP三种核心模块。HAP是应用安装运行的基本单元，支持独立安装和Ability声明；HAR是静态共享包，适用于稳定公共代码；HSP是动态共享包，可实现运行时按需加载。三者区别在于：HAP可独立运行，HAR适合启动速度敏感场景，HSP则能优化包体积。选择原则依据是否需要独立运行、声明Ability、独立发布及代码复用频率等需求，HAR侧重加载速度，HSP侧重包体优化，HAR支持独立发布。
2026-02-25 18:00:00
920
原创 鸿蒙 Web组件白屏问题
本文摘要：文章详细介绍了Web组件白屏问题的排查方法，包括基础权限配置（网络权限、DOM存储等）、网络状态检查、UserAgent优化等。重点分析了跨域资源访问的两种解决方案：资源拦截映射和设置跨域访问路径。同时讲解了DevTools调试技巧、错误回调接口使用、渲染模式选择、布局问题处理以及内存监控要点。针对多进程设备的白屏问题，建议强制单进程模式加载。文章提供了完整的代码示例和解决方案，帮助开发者系统性地解决Web组件白屏问题。
2026-02-25 06:45:00
1629
原创 鸿蒙 ArkTS卡片创建（三）
摘要：ArkTS卡片开发提供两种创建方式：1)共包方式（卡片与应用在同一模块），适合紧密耦合场景；2)独立包方式（卡片与应用分离模块，API20+支持），适合解耦管理。卡片类型分为动态卡片（支持数据更新和交互）和静态卡片（仅展示内容），通过form_config.json的isDynamic参数配置。开发过程包括配置FormExtensionAbility、页面布局设计等核心模块，并支持实时预览功能。建议根据项目需求选择创建方式，注意独立包方式需保持应用包和卡片包的版本一致性。（149字）
2026-02-24 18:00:00
880
原创 鸿蒙 Web组件崩溃信息收集：Crashpad
Crashpad是Chromium提供的进程崩溃处理工具，能在Web渲染进程崩溃时自动生成.dmp格式的minidump文件，记录崩溃原因、线程信息和寄存器状态等关键数据。这些文件存储在应用沙箱目录/data/storage/el2/log/crashpad下，可通过C++代码访问获取。使用minidump_stackwalk工具解析dmp文件，配合llvm-addr2line工具可将SO偏移地址转换为源码位置，帮助精准定位崩溃原因。完整处理流程包括获取dmp文件、导出解析、定位源码等步骤，支持分析SIGS
2026-02-24 06:45:00
882
原创 鸿蒙中 DevTools调试前端页面
本文介绍了在HarmonyOS系统中调试Web组件的两种方法：无线调试和USB连接调试。无线调试通过setWebDebuggingAccess()接口启用，需配置TCPSocket端口并确保设备与调试电脑处于同一局域网；USB调试需要开启开发者模式，使用hdc命令进行端口转发。两种方式都需在Chrome浏览器中配置DevTools工具，通过chrome://inspect/#devices页面连接调试。文章详细说明了配置步骤、权限要求及注意事项，并提供了Windows和Linux/Mac平台的自动化调试脚本
2026-02-23 18:00:00
1625
原创 鸿蒙 卡片开发服务-ArkTS卡片（二）
ArkTS卡片是鸿蒙系统服务卡片的重要演进方向，通过统一开发范式、增强卡片能力，为开发者提供了更强大的卡片开发体验。维度要点开发语言ArkTS声明式范式卡片类型静态卡片、动态卡片、互动卡片核心能力动效、自定义绘制、逻辑代码交互方式postCardAction（动态）、FormLink（静态）运行环境卡片渲染服务 + 虚拟机隔离适用设备手机、平板、PC/2in1、智慧屏、智能手表。
2026-02-23 06:45:00
1153
原创 鸿蒙中 卡片开发服务（一）
FormKit是鸿蒙系统提供的卡片开发框架，支持在桌面、锁屏等系统应用中嵌入显示应用信息。它支持多种设备类型（手机、平板、PC等）和应用场景，通过卡片实现信息展示和服务直达功能。开发时可选择Stage或FA模型，支持ArkTS和JS两种开发范式。FormKit与AbilityKit和ArkUI有紧密关联，前者提供基础能力，后者支持UI组件开发。该框架为开发者提供了灵活的选择，满足不同复杂度的卡片开发需求。
2026-02-22 18:00:00
1427
原创 鸿蒙中 问答模型申请
鸿蒙系统提供端侧问答模型能力，支持PC/2in1设备通过chat()接口实现本地化AI问答。该能力基于Qwen25-7B-Instruct模型，具有数据不上云、低延迟等优势。开发者需在线申请接口权限，配置网络后通过init()初始化模型，下载完成后即可使用流式/非流式问答功能。整个流程包括权限申请、模型初始化、问答交互三个关键步骤，为应用提供安全高效的本地AI服务。
2026-02-22 06:45:00
991
原创 鸿蒙中 状态变量修饰符的目的
鸿蒙ArkUI框架的状态变量修饰符通过数据驱动视图机制实现UI自动更新，核心功能包括：1.响应式更新（@State严格比较触发渲染）；2.状态监听（@Watch回调、@Monitor深度监听）；3.性能优化（减少冗余状态、精准更新）；4.状态共享方案（父子组件@Prop/@Link、跨层级@Provide+@Consume、全局状态管理）。使用原则强调仅修饰实际驱动UI的变量，优先选择高效共享方式，复杂对象推荐@Link/@Monitor以降低性能损耗。
2026-02-21 18:00:00
877
原创 鸿蒙 Web组件预加载、复用
鸿蒙系统的Web组件支持离线预加载功能，通过NodeContainer和NodeController实现动态挂载机制。开发者可预先创建Web组件但不立即挂载，在需要时快速显示。该技术包含预启动渲染进程和预渲染页面两种优化场景：前者通过加载空白页提前启动渲染进程；后者后台完成渲染后暂停以避免功耗问题。系统提供组件复用机制，支持加载空白页后重新利用，并可通过回收接口释放资源。注意事项包括内存占用（每个组件约200MB）、适用场景（单进程模式效果显著）以及避免创建过多离线组件。
2026-02-21 06:45:00
1812
原创 鸿蒙中 同层组件
摘要：鸿蒙系统通过同层渲染技术，让Web页面中的UI元素使用原生ArkUI组件渲染，提升性能和体验。该技术支持地图、输入框等组件在Web场景下的原生渲染，也适用于Flutter等三方框架。开发时需通过Web组件开启同层渲染模式，创建NodeController管理组件生命周期，并处理触摸/鼠标事件。技术限制包括同层标签数量≤5个、不支持同步渲染等。通过arkwebnativestyle属性可控制同层标签层级。
2026-02-20 18:00:00
891
原创 鸿蒙中 知识库的生成
本文同步发表于我的，微信搜索程语新视界即可关注，每个工作日都有文章更新构建智能问答系统时，将原始的业务数据转化为可供检索的知识库，是决定系统效果的关键一环。HarmonyOS Next 提供的 Data Augmentation Kit 中的知识加工能力，提供了一套完整的数据处理 pipeline，能够将结构化或非结构化的数据，通过智能处理转化为倒排索引库和向量知识库，为后续的 RAG 检索增强生成奠定基础。
2026-02-20 06:45:00
911
原创 鸿蒙适配flutter为什么要引用git仓库
鸿蒙适配Flutter需引用Git仓库，主要因为：1)鸿蒙版Flutter SDK由开源社区维护，托管在GitCode/Gitee而非Pub.dev；2)常用Flutter插件需通过git引入社区适配版本。开发者需克隆指定仓库并配置环境，在pubspec.yaml中使用git地址而非版本号引用插件，确保鸿蒙应用的兼容性。这种模式体现了鸿蒙Flutter生态与官方生态的独立发展路径。
2026-02-19 18:00:00
361
原创 鸿蒙 Web组件的智能分词
HarmonyOSNext的ArkWeb组件从API20版本开始引入智能分词功能，使H5页面具备文本实体识别能力。该功能可自动识别电话号码、网址、邮箱等特殊信息，并提供高亮显示和快捷操作。开发者通过enableDataDetector属性开启功能，并可配置识别类型和长按预览菜单。API22+版本进一步扩展了文本选择菜单的AI功能。智能分词支持点击交互和长按预览，但会过滤输入框内容、超链接标签等特定场景。该功能显著提升了H5页面的信息交互效率，让用户能直接操作识别出的实体内容。
2026-02-19 06:45:00
1103
原创 鸿蒙 依赖管理中 overrides 字段
摘要： ohpm的overrides字段是HarmonyOS应用开发中管理依赖冲突的关键工具，支持强制锁定版本或使用本地HAR文件。其核心作用包括：1) 统一传递依赖版本，解决模块间的版本冲突；2) 离线开发支持，通过本地路径替代远程依赖；3) 安全修复，快速覆盖存在漏洞的间接依赖。配置时需注意包名精确匹配，且会全局生效。优先级上，overrides>直接依赖>间接依赖。典型场景如团队内部库版本锁定、离线环境适配等，但需谨慎使用以避免影响协作开发。通过ohpm list可验证最终生效版本。
2026-02-18 18:00:00
532
原创 鸿蒙中 RAG知识问答能力
RAG（检索增强生成）是一种结合检索技术和生成式AI的解决方案，通过问题解析、知识检索和答案生成三个步骤，为用户提供可解释、准确且可定制的回答。其核心优势包括答案可追溯、知识库可定制、减少幻觉以及支持实时更新。开发流程需完成知识加工、配置检索参数、创建RAG会话，并通过流式接口实现问答交互。注意事项包括线程限制、提问长度、历史记录范围和安全风控等。该技术适用于知识问答、智能客服、教育辅导等场景，要求LLM支持30kTokens以上上下文长度。
2026-02-18 06:45:00
917
原创 鸿蒙 Web组件的Menu菜单
本文介绍了Web组件中的三种菜单类型：文本选中菜单、上下文菜单和自定义菜单。文本选中菜单在文本选择时触发，可通过editMenuOptions接口自定义菜单项和点击行为；上下文菜单通过特定操作触发，需完全自定义实现，提供更丰富的交互功能；自定义菜单支持长按图片等特定元素触发，具有预览窗等高级特性。开发者可根据不同业务场景选择合适的菜单类型：纯文本编辑推荐使用文本选中菜单，复杂交互使用上下文菜单，图片操作则推荐自定义菜单。
2026-02-17 18:00:00
625
原创 flutter工程 module和项目的区别
Flutter开发中，Module和Project(App)的主要区别在于：Module用于将Flutter功能集成到现有原生应用中，输出AAR/Framework文件，由宿主应用管理生命周期；而Project是独立完整的Flutter应用，直接构建APK/IPA文件，由Flutter框架管理生命周期。Module适合混合开发场景，Project适合全新Flutter应用开发。简言之，Module是"插件"，Project是"完整应用"。
2026-02-17 06:45:00
575
原创 鸿蒙中 feature动态特性模块
摘要：鸿蒙系统的Feature模块是一种动态特性分包机制，支持功能按需加载和跨设备适配。通过配置deliveryWithInstall:false，可实现功能动态扩展（如电商直播）、设备差异化适配（手机/车机不同功能）和低频功能分离。模块需在module.json5中声明为feature类型，与Entry模块相比具有动态加载、减小初始包体积的优势。开发时需注意依赖管理（推荐使用HAR/HSP）、错误处理和跨模块页面跳转（通过命名路由）。该机制是鸿蒙实现轻量化、动态化和跨设备适配的核心方案，能有效优化资源加载
2026-02-16 18:00:00
615
原创 Flutter App 与 Module 的 Android 目录区别
本文对比了Flutter项目中两种Android目录的区别：App类型的android/是完整Android工程，可独立打包APK，允许自由修改配置；Module类型的.android/是自动生成的集成模板，带点号表示不应手动修改，主要用于提供原生项目集成接口。核心差异在于android/用于构建独立应用，需提交版本控制；而.android/是临时脚手架，仅包含集成脚本，不应提交Git。实际使用时，App项目直接修改android/目录配置，Module项目则通过.android/include_flutt
2026-02-16 06:45:00
1037
原创 鸿蒙 dependencies 里的 key 字段
摘要：在OpenHarmony中，依赖包的key值必须与oh-package.json5中的name字段完全一致，因为ohpm通过name识别依赖包。若使用flutter.har文件，需确保dependencies中写入正确的包名（如@ohos/flutter_ohos），而非随意命名。可通过解压har文件或安装后查看oh-package.json5确认真实包名。包名由作者定义，与文件名无关，建议直接向提供者获取或通过安装报错信息确认正确包名。
2026-02-15 18:00:00
614
原创 Flutter Module 集成到 Android 项目
本文介绍了将FlutterModule集成到Android项目的两种官方方式：源码集成和AAR集成。源码集成适合开发阶段，通过Gradle直接引入Module源码，支持热重载但构建速度较慢；AAR集成适合发布阶段，将FlutterModule编译为AAR包引入，构建速度快但需重新编译。文章详细说明了两种方式的前置环境要求、项目结构准备、具体配置步骤及代码示例，包括Flutter页面打开方式和原生通信实现。最后对比了两种方式的优缺点，并提供了常见问题解决方案，如预加载引擎优化启动速度、ABI过滤减小包体积等。
2026-02-15 06:45:00
2085
原创 鸿蒙中 文件持久化授权
鸿蒙系统中的持久化授权机制允许应用在用户授权后长期访问特定文件或目录，无需重复授权。该机制通过Picker获取临时授权后，调用persistPermission()申请持久化权限并存储URI，重启后需activatePermission()激活权限。当不再需要访问时，应通过revokePermission()取消授权。持久化授权提升了用户体验，避免了重复选择文件的操作，适用于常用文件访问、历史记录管理等场景。开发者需注意权限激活、错误处理和适时取消授权等关键环节。
2026-02-14 18:00:00
388
原创 Flutter Module的三种运行与调试方发
Flutter模块开发调试方案对比 摘要：Flutter模块开发有三种调试方案：1)使用Example项目（官方推荐），适合模块开发阶段快速预览UI；2)集成到原生宿主应用调试，适合测试原生交互和真实环境验证；3)使用Flutter工具的Module调试模式，适合快速验证纯Dart代码。三种方案在配置复杂度、真实度和适用场景上各有特点：Example项目配置简单但无法测试原生交互，宿主应用调试最真实但配置复杂，Module调试模式启动快但环境非真实。开发者可根据实际需求选择合适方案，如日常开发推荐Examp
2026-02-14 06:45:00
1569
空空如也
空空如也
TA创建的收藏夹 TA关注的收藏夹
TA关注的人