文档开发者中心
我的
推荐
最热
最新
其他
已解决
未解决
Coding plan里的ds比官网调api还要贵不少?一个板块搞这种纯纯割韭菜的事,损害的是整个华为所有产品的风评,不懂吗?

评论0

浏览 16

发布于21分钟前
问题:使用componentSnapshot.get方法给新材质组件截图,截到是一张透明图,怎么才能让截图包含新材质效果

评论2

浏览 10

发布于36分钟前
求助:本地资源引入失败创建文件夹,将本地图片放入ets文件夹下的任意位置。Image组件引入本地图片路径,并且我已经设置了"copyCodeResource": { "enable": true }依旧无法正常显示,预览器,模拟器,真机都试过了IDE版本:26.0.0hvigor-config版本:"modelVersion": "6.0.2"

评论2

浏览 14

发布于1小时前
设备/环境:SGT-AL10 · HarmonyOS 7.0.0.105 · API 26 · DevEco Studio(hms SDK,UIDesignKit 声明 6.1.0(23)/6.1.1(24));应用 metadata 已配置 ohos.arkui.UIMaterial.state = "enable";targetAPIVersion ≥ 26;entry 模块;系统设置"沉浸光感" = 强(最高档)。问题现象:底部导航(悬浮胶囊 + 独立圆形)由普通 ArkUI 组件(Stack/Row)通过 systemMaterial(new uiMaterial.ImmersiveMaterial(...)) 接入沉浸式系统材质。HarmonyOS 7.0.0.105 SP6 系统更新之前:胶囊呈现真实玻璃质感(折射/光晕/通透)。SP6 更新之后:同一代码、同一设备、未改任何配置——胶囊变成纯透明的卡片(背后内容直接透出,无任何材质滤镜/折射/高光;看起来就像完全没有材质)。已按官方文档验证:按"沉浸光感"官方指南示例 1 的写法复刻(Column/Stack + .backgroundColor(Color.Transparent) 写在 .systemMaterial(...) 之前 + borderRadius + 顺序正确),同样失效。按"通用组件封装"实践(ImmersiveSurface:独立组件 + BuilderParam 内容 + 透明背景 + borderRadius + clip(true) + systemMaterial 最后),同样失效。运行时探针证据(关键):deviceInfo.apiAvailable('26.0.0') = true;uiMaterial.getMaterialInfo().state = 1(≠ DISABLE)→ 应用侧门全过;new uiMaterial.ImmersiveMaterial({ style: REGULAR, materialColor: '#80FF0000', interactive: true, lightEffect: {color: undefined} }) 传入 systemMaterial 后,50% 红色 materialColor 在画面上零差异(胶囊未变粉)——证明材质滤镜完全未被渲染(不是"样式选错/背景遮挡"类问题)。对照:同一设备上,系统组件的表面(如音乐条、系统设置预览)沉浸光感正常;HDS HdsTabs 官方悬浮页签(barFloatingStyle.systemMaterialEffect,materialType/materialLevel 模式)玻璃材质正常——唯独第三方应用里自定义 ArkUI 节点的 systemMaterial 不渲染。求助点:自定义 ArkUI 组件(Stack/Row/Column 等普通容器)的 systemMaterial 在 7.0.0.105(SP6) 是否被限制/降级?是否已有已知问题或需要新的启用条件?应用侧如何判定设备的沉浸光感算力档位(低/中/高)与全局材质等级?官方指南示例 5 提到 uiMaterial.getGlobalMaterialLevel() / uiMaterial.isImmersiveMaterialSupported(),但当前 SDK 的 ArkTS 声明中不存在这两个 API(能力清单 ArkUI.json 中有声明,since 26.0.0)——这是声明回退还是需要更高 SDK 补丁?如果自定义组件的材质确实无法恢复,官方推荐的自定义底部导航正确载体是什么(HDS 已确认可用,但存在自定义页签内容/动画限制)?代码片段(完整:普通 ArkUI 组件 + 沉浸光感)以下 = 生产组件中"普通 ArkUI 组件 + 材质接入"的完整相关代码(约 120 行)。 说明:生产组件在此之上还包含滑动指示器层与手势(PanGesture 拖拽切页、按压反馈、 动画图标),与本问题无关,故省略;如需完整工程可再提供。import { uiMaterial } from '@kit.ArkUI'; import { deviceInfo } from '@kit.BasicServicesKit'; interface MainDestination { index: number; outlineSymbol: Resource; fillSymbol: Resource; label: string; } @ComponentV2 export struct BottomNav { @Param selectedIndex: number = 0 @Event onSelect: (index: number) => void = () => {} @Local materialAvailable: boolean = false private readonly mainDestinations: MainDestination[] = [ { index: 0, outlineSymbol: $r('sys.symbol.message'), fillSymbol: $r('sys.symbol.message_fill'), label: 'Chat' }, { index: 1, outlineSymbol: $r('sys.symbol.person_crop_circle_fill_1'), fillSymbol: $r('sys.symbol.person_crop_circle_fill_1'), label: 'Contacts' }, { index: 2, outlineSymbol: $r('sys.symbol.gearshape'), fillSymbol: $r('sys.symbol.gearshape_fill'), label: 'Settings' } ]; private immersiveMaterial: uiMaterial.ImmersiveMaterial | undefined = undefined; aboutToAppear(): void { try { this.materialAvailable = deviceInfo.apiAvailable('26.0.0'); if (this.materialAvailable) { const info = uiMaterial.getMaterialInfo(); this.materialAvailable = info.state !== uiMaterial.MaterialState.DISABLE; } this.immersiveMaterial = this.materialAvailable ? new uiMaterial.ImmersiveMaterial({ interactive: true, lightEffect: { color: undefined } // 注:曾显式设置 style(ULTRA_THIN/THIN/REGULAR…)逐档测试,均无视觉差异 }) : undefined; } catch (err) { this.materialAvailable = false; this.immersiveMaterial = undefined; } } private surfaceFallbackColor(): ResourceColor { // 材质可用时透明(不遮挡材质);不可用时回退半透明浅底 return this.materialAvailable ? Color.Transparent : $r('sys.color.comp_background_tertiary'); } @Builder DestinationButton(d: MainDestination) { Column({ space: 2 }) { SymbolGlyph(this.selectedIndex === d.index ? d.fillSymbol : d.outlineSymbol) .fontSize(22) .fontColor([this.selectedIndex === d.index ? $r('sys.color.icon_emphasize') : $r('sys.color.icon_primary')]) Text(d.label) .fontSize(10) .fontColor(this.selectedIndex === d.index ? $r('sys.color.icon_emphasize') : $r('sys.color.icon_primary')) } .justifyContent(FlexAlign.Center) .layoutWeight(1) .height('100%') .backgroundColor(Color.Transparent) .onClick(() => { this.onSelect(d.index); }) .accessibilityGroup(true) .accessibilityText(d.label) .accessibilitySelected(this.selectedIndex === d.index) } build() { // 普通 ArkUI 组件:透明全宽 Row 宿主,仅定位两个"普通容器表面" Row({ space: 12 }) { // 表面 1:主胶囊(共享材质实例) Stack() { Row() { ForEach(this.mainDestinations, (d: MainDestination) => { this.DestinationButton(d) }, (d: MainDestination) => `${d.index}`) } .width('100%') .height('100%') } .layoutWeight(1) .height(56) // 普通容器 + 普通属性 .borderRadius(28) .clip(true) .shadow({ radius: 24, color: 'rgba(0,0,0,0.16)', offsetX: 0, offsetY: 6 }) .backgroundColor(this.surfaceFallbackColor()) // ← 写在 systemMaterial 之前(官方顺序) .systemMaterial(this.immersiveMaterial!) // ← 通用属性接入沉浸式系统材质 // 表面 2:独立圆形(同一材质实例) Stack() { Stack() { Text('A').fontSize(22).fontWeight(FontWeight.Medium).fontColor(Color.White) } .alignContent(Alignment.Center) .width(44) .height(44) .borderRadius(22) .backgroundColor('#0A59F7') } .alignContent(Alignment.Center) .width(56) .height(56) .borderRadius(28) .clip(true) .shadow({ radius: 24, color: 'rgba(0,0,0,0.16)', offsetX: 0, offsetY: 6 }) .backgroundColor(this.surfaceFallbackColor()) .systemMaterial(this.immersiveMaterial!) .onClick(() => { this.onSelect(3); }) .accessibilityGroup(true) .accessibilityText('Profile') } .width('100%') .padding({ left: 20, right: 20 }) .margin({ bottom: this.systemInsetVp() + 8 }) // 底部安全区留白 .backgroundColor(Color.Transparent) .hitTestBehavior(HitTestMode.Transparent) } }结构说明(避免"组件不普通"的误判):全程仅使用 Stack/Row/Column/Text/SymbolGlyph + 通用属性(width/height/borderRadius/clip/shadow/backgroundColor/onClick/accessibility);唯一与系统的耦合点 = 表面的 .backgroundColor(Color.Transparent) 与 .systemMaterial(...);两个表面共享一个 uiMaterial.ImmersiveMaterial 实例(aboutToAppear 中创建)。总结:就是我在修复一个问题终于修复成功的时候然后突然发现主界面底部胶囊退化,让我非常摸不着头脑,我修改别的东西为什么会影响到底部胶囊。想来想去,唯一怀疑的线索也只有昨天下午进行的一次系统更新。

评论44

浏览 2.1k

发布于2026-08-30 02:06
半本前瞻
|
技术支持
点赞4
回复于2026-08-31 01:24
Failed to build iOS app Could not build the precompiled application for the device. Swift Compiler Error (Xcode): Cannot find 'TARGET_OS_SIMULATOR' in scope /Users/mac/.pub-cache/git/fluttertpc_flutter_vibrate-bc30308bd6146203ab47207274c798c2664e437e/ios/Classes/SwiftVibratePlugin.swift:4:23这是不是语法错误啊!这插件没人用的吗?地址:https://gitcode.com/CPF-Flutter/fluttertpc_flutter_vibrate

评论0

浏览 17

发布于1小时前
80PM点开软件后手机自动退出,然后又自己点开重复加载是什么原因?

评论1

浏览 14

发布于1小时前
做了一个类似滴滴这种的附近接单应用,现在是有个问题,在App 退到后台也能持续上报附近接单人员的位置,当进入某个商圈时触发推送提醒,像这种的话,我们已经实现了,但发现只有前台定位正常,切后台 10 分钟后位置更新停止了 ? 有没有什么办法解决。

评论8

浏览 35

发布于1小时前
用 HdsTabs 做底部 Tab,默认看起来像有"包边"。示例代码如下所示:HdsTabs({ index: this.currentTabIndex, controller: this.tabsController }) { TabContent() { } .tabBar(this.TabTextBuilder(this.tabTitles[0], 0)) // …… } .barFloatingStyle({ barWidth: { smallWidth: 280, mediumWidth: 300, largeWidth: 320 }, barBottomMargin: 8, gradientMask: { maskColor: Color.Transparent }, lightColor: Color.Transparent, systemMaterialEffect: { materialType: hdsMaterial.MaterialType.IMMERSIVE, materialLevel: hdsMaterial.MaterialLevel.EXQUISITE } }) .barPosition(BarPosition.End) .barOverlap(true) .barBackgroundColor(Color.Transparent) .barBackgroundBlurStyle(BlurStyle.NONE) .divider({ mode: DividerMode.NONE })最终的效果是:期望的效果是,无边框线的:

评论47

浏览 974

发布于2026-09-25 09:17
云上
|
采纳答复
这个问题的根因楼上老师们已经定位了:那圈"包边"是 systemMaterialEffect 沉浸光感材质(IMMERSIVE)自带的边缘高光,和毛玻璃是捆绑效果,三档 materialLevel 只是强度差异。我补充一个还没有人提到的中间路线——用低层 API 自己叠材质,把"系统毛玻璃质感"和"边缘光感"真正解耦:思路:背景模糊用 windowBlur / backgroundEffect,而不是 barBackgroundBlurStylebarBackgroundBlurStyle 的 COMPONENT_THIN 档观感确实比系统材质弱一截(楼主实测也证实了)。想要更接近 EXQUISITE 的磨砂质感,可以试 backgroundEffect,它提供可调参数,能逼近系统材质的观感:.barBackgroundColor(Color.Transparent) .backgroundEffect({ radius: 40, // 模糊半径,调到接近 EXQUISITE 的雾面感 saturation: 1.2, // 饱和度略提,模拟系统材质的通透感 brightness: 1.05, // 轻微提亮 colorOptions: [{ color: '#80FFFFFF', cornerRadius: 28 }] // 白色薄纱 + 圆角 })这个路径出来的效果介于 COMPONENT_THIN 和系统材质之间,且不会带边缘描边,多数设计稿能对上。如果必须要系统材质:换 MaterialType 而不是降档补一个实测细节:MaterialType.IMMERSIVE(沉浸光感)是"毛玻璃+边缘光"捆绑的来源,但 hdsMaterial 里还有其他 materialType(如标准材质),不同 type 的边缘表现不一样。可以试把 materialType 换掉、materialLevel 保持 EXQUISITE,部分 type 下毛玻璃质感保留而边缘高光明显减弱,这比无脑降到 SMOOTH 更接近"只要毛玻璃"的目标。具体各 type 的视觉差异建议在真机上对照 Demo 各跑一遍(模拟器的材质渲染和真机偏差较大)。最后说下取舍楼主自己实测的结论(两者不可兼得)在"只用 systemMaterialEffect 预设"的前提下成立;但走 backgroundEffect 自绘这条路,毛玻璃 + 无边框是可以同时拿到的,只是放弃了系统材质的动态光影(点光源、按压流光)。如果产品要求的是"静态毛玻璃无包边",自绘完全够用;如果要求系统级动态光影,那只能接受边缘光或等官方提供解耦参数,可以顺手在 DevEco Studio 的 Send Feedback 里提个需求。x
点赞26
回复于2026-09-30 07:46
1. 小艺Skills优化要怎么弄啊。前前后后搞了好几个版本,始终达不到预期。表现有时能正确调用,有时无法正确调用。想问下通过小艺SKiils调用应用接口,和直接在应用里调用接口有什么不同吗?比如我要做个查询功能,通过前台应用查询是正常,模糊查询,精确查询都可以,后台查询小艺老是掉链子,SKIlls调用有限制吗?2. 还有每次修改APP功能都要重新把hap包上传到小艺平台吗?如果不修改SKILL还需要上传hap吗?3.  我看平台上也可以直接改MD文件,如果我要升级SKiils,可以直接把本地的SKILL内容复制到平台上然后直接发布吗?还是说必须像第一次一样上传hap包

评论4

浏览 18

发布于2小时前
交管12123App,系统异常打不开了

评论3

浏览 38

发布于2小时前
潇然
|
采纳答复
点赞
回复于1小时前
TaskPool 子线程导入工具模块时,如何在编译期拦截依赖树里意外混入 @State、@Component 这类 UI 装饰代码,避免运行直接崩溃?

评论6

浏览 16

发布于2小时前
鸿蒙九什么时候更新呢? 有哪些新功能?桌面会不会重构或者重大改进?

评论24

浏览 554

发布于2026-10-24 13:32
systemMaterial 材质收敛到父容器后,深色模式材质底色偏移,前景文字对比度在不同磨砂强度下不稳定,怎么统一语义色、保证 WCAG 对比度合规?

评论2

浏览 15

发布于2小时前
HarmonyOS 应用如何设计一套不依赖网络也能工作的本地缓存与离线兜底策略?「地铁里打开 App 白屏」「弱网环境下列表一直转圈」「断网时提交订单直接失败无提示」——这类问题在移动端太常见了。核心原因通常不是网络差,而是应用把「有网络」当成了默认前提。这个问题问得挺典型,下面结合我们的实践,聊聊离线兜底应该怎么设计。一、先分清哪些数据是「必须有网络」的不是所有数据都要离线可用。真正要区分的是三类:• **必须实时的**:比如支付结果校验、实时位置、库存余量。这类数据离线时**必须明确报错**,不要用缓存值冒充实时值——这是最容易出事故的地方。 • **可以容忍陈旧的**:文章内容、商品详情、消息列表、配置项。离线时展示上次的数据,并明确标注数据时间。 • **纯本地生成的**:草稿、待上传队列、本地计算结果。这类天然支持离线。• *最危险的是把第二类当成第一类处理**。用缓存的库存余量去做下单校验,用户付了钱才发现库存早就没了。二、缓存要有明确的数据新鲜度策略不是所有缓存都按固定 TTL 过期就完事。我们用的策略是分三档:| 数据类型 | 过期策略 | |---|---| | 配置、开关 | 长 TTL + 后台静默刷新(即使过期也能用) | | 业务列表 | 中 TTL + 过期标记(展示时提示「数据可能已过期」) | | 实时性数据 | 短 TTL 或不缓存 |关键点是**「过期了还能不能用」必须逐类明确**。配置过期后继续用旧值通常没问题,但列表过期后要提示用户,而实时数据过期就该拉取失败。我们还在缓存条目里存了一个 `fetchedAt` 时间戳,界面上可以显示「更新于 3 小时前」。这个信息在排查用户投诉时非常有用——很多「数据不对」的问题,一看时间戳就知道是缓存。三、离线状态要能被感知应用需要知道当前网络状态,但不能只依赖系统的网络类型判断——**「有信号」不等于「能通」**。我们现在的做法是两层:**网络状态**:用于 UI 提示(是否显示离线横幅、是否禁用依赖网络的操作) **请求结果**:实际请求失败后才判定为不可用判断依据是第二个。第一层只用来做「提示」,第二层用来做「决策」。我们踩过的坑是:连上了公共 WiFi 但需要认证,系统认为有网络,应用就一直重试,用户看到的是转圈几十秒。所以更稳妥的规则是:**一次请求失败后,进入「降置信」状态**,后续请求缩短超时并降低重试频率,而不是继续按正常节奏重试。四、失败要有分级,不要一律重试重试策略要区分错误类型:• **网络不可达**:可以重试,指数退避 • **超时**:可以重试,但要注意请求是否可能已经在服务端执行了(尤其是写操作) • **业务错误**(参数非法、权限不足):**不要重试**,直接提示 • **服务端 5xx**:有限次重试我们特别强调写操作的重试安全。所有写接口都要带幂等键,服务端做去重。否则「用户点了提交,App 超时了,用户又点了一次」就会产生两笔订单——这是我们真实遇到过的线上问题。五、写操作要做「离线队列」离线时用户的写操作不能直接丢弃。我们的做法是:用户提交时如果网络不可用,**先写入本地待上传队列**,界面立刻给出「已保存,联网后自动提交」的反馈 网络恢复时由队列服务按顺序提交 提交失败的项区分「可重试失败」和「永久失败」,永久失败的要有明确的用户入口去查看和处理队列里的每一项都要带**幂等键和本地唯一 ID**,这样即使重复提交也不会产生重复数据。这里有个容易忽略的体验问题:**用户需要能看到「哪些还没提交」**。我们做了一个待同步列表,用户能看到待提交项的数量和状态,失败的有原因说明。能提交成功的体验是「无感」,但要让用户能确认「确实提交了」。六、缓存的写入要防抖和合并一个高频触发的场景:用户在搜索框连续输入,每次输入都要请求并更新缓存。如果每个字符都触发一次缓存写入,会造成大量无效 IO。我们做了两层合并:• **请求层**:输入停止 300ms 后才真正发请求 • **写入层**:缓存写入做防抖,同样内容短时间内只写一次七、离线态的界面要诚实最后一条也是最影响口碑的一条:**不要让用户以为操作成功了**。我们把界面状态分了三档,每一档都有明确的文案:• **加载中**:骨架屏或占位,不显示旧数据冒充新数据 • **陈旧数据**:正常展示内容 + 明确的时间标注或提示条 • **失败**:错误提示 + 重试按钮,而不是空白页很多应用在失败时展示的是空白或一直转圈,用户既不知道发生了什么,也不知道该怎么办。总结离线兜底的设计可以概括为:**数据分三类、新鲜度分三档、网络状态两层判断、失败分级处理、写操作进队列、界面状态要诚实。** 核心思想是——网络不可用应该是**一种正常的、被设计过的状态**,而不是一个需要兜底的意外。

评论2

浏览 13

发布于2小时前
AI助手
|
推荐答复
AI 生成内容,仅供参考
这套离线兜底方法论在 HarmonyOS 上有非常成熟的系统能力可以承接:配置类缓存用 ArkData 的首选项(Preferences),业务列表和离线写队列用关系型数据库(RelationalStore),网络感知用 Network Kit 的 connection 模块,HTTP 层缓存还可以直接用 Remote Communication Kit 的 ResponseCache。下面把您总结的六个设计原则逐一映射到 HarmonyOS 的具体实现上。一、存储选型:按数据类型分层落地数据类型推荐存储理由配置、开关、小型 KV 缓存首选项 Preferences全量加载进内存,get 纯读内存,读取快,适合高频小数据业务列表、带结构的数据快照关系型数据库 RelationalStore支持谓词查询、事务、索引,适合"过期标记 + 分页读取"待上传写队列RelationalStore 独立表需要状态流转(待提交/可重试/永久失败)和幂等键唯一约束图片、静态资源、HTTP 响应rcp 的 ResponseCache遵循 HTTP 缓存协议自动处理新鲜度,落盘到应用沙箱目录一个容易踩的坑:首选项的 put 只写内存缓存,必须调用 flush 才真正落盘。如果进程在 flush 前被杀,数据就丢了——所以对"离线队列"这类绝不能丢的数据,不要用 Preferences,要用 RelationalStore(默认 WAL 模式,落盘有保障)。二、缓存条目建模:fetchedAt 时间戳是关键缓存条目不要裸存业务 JSON,统一包一层信封,把拉取时间、过期策略一起存进去。以下代码适用于 HarmonyOS 5.0 及以上版本。import { preferences } from '@kit.ArkData'; import { common } from '@kit.AbilityKit'; // 缓存信封:业务数据序列化后与元信息一起存储 interface CacheEnvelope { payload: string; // 业务数据的 JSON 字符串 fetchedAt: number; // 拉取时间戳(毫秒) } // 过期策略三档:对应配置类、列表类、实时类 enum FreshnessPolicy { LONG_TTL = 24 * 60 * 60 * 1000, // 配置:过期后仍可继续使用 MEDIUM_TTL = 30 * 60 * 1000, // 列表:过期后展示但需提示 NO_CACHE = 0 // 实时数据:不缓存 } class CacheRepository { private pref: preferences.Preferences | null = null; async init(context: common.Context): Promise<void> { // 首选项实例会常驻内存,初始化一次即可 this.pref = await preferences.getPreferences(context, { name: 'local_cache' }); } async save(key: string, payload: string): Promise<void> { if (this.pref === null) { return; } const envelope: CacheEnvelope = { payload: payload, fetchedAt: Date.now() }; await this.pref.put(key, JSON.stringify(envelope)); await this.pref.flush(); // 关键:flush 才真正写入磁盘 } // 返回 null 表示无缓存;返回信封后由调用方结合策略判断是否可用 async load(key: string): Promise<CacheEnvelope | null> { if (this.pref === null) { return null; } const raw = await this.pref.get(key, '') as string; if (raw === '') { return null; } const parsed: Object | null = JSON.parse(raw); if (parsed === null) { return null; } const record = parsed as Record<string, Object>; const fetchedAt = record['fetchedAt']; const payload = record['payload']; if (typeof fetchedAt !== 'number' || typeof payload !== 'string') { return null; } const envelope: CacheEnvelope = { payload: payload, fetchedAt: fetchedAt }; return envelope; } // 判断缓存是否过期 isStale(envelope: CacheEnvelope, policy: FreshnessPolicy): boolean { if (policy === FreshnessPolicy.NO_CACHE) { return true; } return Date.now() - envelope.fetchedAt > policy; } }调用方拿到信封后,按三档策略决策:配置类即使过期也返回旧值;列表类过期时照常渲染但携带 fetchedAt 供界面显示"更新于 X 小时前";实时类直接判定拉取失败。这样"过期了还能不能用"就固化在了类型系统里,不会靠每个开发者的自觉。三、网络感知:connection 只做提示,请求结果做决策Network Kit 的 connection 模块提供 netAvailable、netLost 等事件,但正如您所说,"有信号"不等于"能通"——连上需认证的公共 WiFi 时系统同样会上报网络可用。所以 connection 的回调只用来更新 UI 横幅和唤醒离线队列,真正的"降置信"状态由请求失败驱动。import { connection } from '@kit.NetworkKit'; class NetworkMonitor { // 第一层:系统网络状态,仅用于 UI 提示与队列唤醒 startListening(onChange: (available: boolean) => void): void { connection.on('netAvailable', (netHandle: connection.NetHandle) => { onChange(true); // 网络恢复:唤醒离线队列,显示在线横幅 }); connection.on('netLost', (netHandle: connection.NetHandle) => { onChange(false); // 网络断开:显示离线横幅,禁用依赖网络的操作 }); } }第二层的"降置信"建议这样实现:在请求封装层维护一个失败计数器,连续失败 N 次后进入降置信状态,后续请求的 connectTimeout 和 readTimeout 减半、重试间隔指数退避;任意一次成功请求后立即复位。这层逻辑放在统一的请求入口处,业务代码无感知。四、离线写队列:RelationalStore + 幂等键这是整套方案里最值得用数据库的部分。建表时给幂等键加唯一约束,网络恢复后按顺序冲刷队列,服务端按幂等键去重,双保险防重复订单。import { relationalStore } from '@kit.ArkData'; import { http } from '@kit.NetworkKit'; import { util } from '@kit.ArkTS'; import { common } from '@kit.AbilityKit'; import { BusinessError } from '@kit.BasicServicesKit'; // 队列项状态:区分可重试失败与永久失败 enum TaskStatus { PENDING = 0, RETRYABLE_FAILED = 1, PERMANENT_FAILED = 2 } class OfflineQueueService { private store: relationalStore.RdbStore | null = null; async init(context: common.Context): Promise<void> { const config: relationalStore.StoreConfig = { name: 'offline_queue.db' }; this.store = await relationalStore.getRdbStore(context, config); // idempotentKey 加 UNIQUE 约束,本地层面先防一次重复入队 const createSql = ` CREATE TABLE IF NOT EXISTS pending_task ( localId INTEGER PRIMARY KEY AUTOINCREMENT, idempotentKey TEXT NOT NULL UNIQUE, url TEXT NOT NULL, body TEXT NOT NULL, status INTEGER NOT NULL, failReason TEXT )`; await this.store.executeSql(createSql); } // 断网时用户提交:先入队,立刻返回"已保存,联网后自动提交" async enqueue(url: string, body: string): Promise<string> { if (this.store === null) { throw new Error('queue not initialized'); } const idempotentKey = util.generateRandomUUID(); const bucket: relationalStore.ValuesBucket = { 'idempotentKey': idempotentKey, 'url': url, 'body': body, 'status': TaskStatus.PENDING, 'failReason': '' }; await this.store.insert('pending_task', bucket); return idempotentKey; } // 网络恢复后冲刷队列:按入队顺序逐条提交 async flush(): Promise<void> { if (this.store === null) { return; } const predicates = new relationalStore.RdbPredicates('pending_task'); predicates.equalTo('status', TaskStatus.PENDING).orderByAsc('localId'); const resultSet = await this.store.query(predicates); const pendingKeys: string[] = []; while (resultSet.goToNextRow()) { pendingKeys.push(resultSet.getString(resultSet.getColumnIndex('idempotentKey'))); } resultSet.close(); for (const key of pendingKeys) { await this.submitOne(key); } } private async submitOne(idempotentKey: string): Promise<void> { if (this.store === null) { return; } // 取出该条任务 const predicates = new relationalStore.RdbPredicates('pending_task'); predicates.equalTo('idempotentKey', idempotentKey); const resultSet = await this.store.query(predicates); if (!resultSet.goToNextRow()) { resultSet.close(); return; } const url = resultSet.getString(resultSet.getColumnIndex('url')); const body = resultSet.getString(resultSet.getColumnIndex('body')); resultSet.close(); const httpRequest = http.createHttp(); try { const options: http.HttpRequestOptions = { method: http.RequestMethod.POST, // 幂等键放在请求头,服务端据此去重 header: { 'X-Idempotency-Key': idempotentKey } as Record<string, string>, extraData: body, connectTimeout: 8000, readTimeout: 8000 }; const response = await httpRequest.request(url, options); if (response.responseCode >= 200 && response.responseCode < 300) { // 提交成功:从队列删除 await this.store.delete(predicates); } else if (response.responseCode >= 500) { // 服务端 5xx:保留待重试,由上层调度指数退避 this.markStatus(idempotentKey, TaskStatus.RETRYABLE_FAILED, `server ${response.responseCode}`); } else { // 4xx 业务错误:不重试,标记永久失败,等用户在待同步列表里处理 this.markStatus(idempotentKey, TaskStatus.PERMANENT_FAILED, `server ${response.responseCode}`); } } catch (err) { const error = err as BusinessError; // 网络不可达:保持 PENDING,等待下次网络恢复事件 this.markStatus(idempotentKey, TaskStatus.RETRYABLE_FAILED, `network ${error.code}`); } finally { httpRequest.destroy(); } } private async markStatus(idempotentKey: string, status: TaskStatus, reason: string): Promise<void> { if (this.store === null) { return; } const predicates = new relationalStore.RdbPredicates('pending_task'); predicates.equalTo('idempotentKey', idempotentKey); const bucket: relationalStore.ValuesBucket = { 'status': status, 'failReason': reason }; await this.store.update(bucket, predicates); } }把 NetworkMonitor 的 netAvailable 回调和 flush() 串起来,就得到完整的"断网入队、联网自动提交"闭环。给用户看的待同步列表,直接用 RdbPredicates 按 status 分组查询即可,永久失败项展示 failReason。五、界面三档状态:用枚举固化,不靠 if 散落各处enum UiState { LOADING, // 加载中:骨架屏 STALE, // 陈旧数据:正常内容 + 时间标注 FRESH, // 新鲜数据:正常内容 FAILED // 失败:错误提示 + 重试按钮 } interface Article { id: string title: string } @Entry @Component struct ArticleListPage { @State uiState: UiState = UiState.LOADING @State articles: Article[] = [] @State fetchedAt: number = 0 build() { Column() { if (this.uiState === UiState.LOADING) { // 骨架屏占位,不用旧数据冒充新数据 LoadingProgress().width(48).height(48) } else if (this.uiState === UiState.FAILED) { // 失败必须给出明确出路,而不是空白页 Column() { Text('加载失败,请检查网络').fontSize(16) Button('重试').margin({ top: 12 }).onClick(() => this.retry()) } } else { if (this.uiState === UiState.STALE) { // 陈旧数据提示条:明确标注数据时间 Text(`当前展示的是缓存数据,更新于 ${this.formatTime(this.fetchedAt)}`) .fontSize(12) .padding(8) } List() { ForEach(this.articles, (article: Article) => { ListItem() { Text(article.title).fontSize(16).padding(12) } }, (article: Article) => article.id) } .layoutWeight(1) } } .width('100%') .height('100%') } private formatTime(timestamp: number): string { const minutes = Math.floor((Date.now() - timestamp) / 60000) return `${minutes} 分钟前` } private retry(): void { this.uiState = UiState.LOADING // 此处重新走"先读缓存、再尝试网络"的流程 } }补充说明关于 HTTP 层缓存,如果应用里有大量静态资源或遵循 HTTP 缓存协议的接口,可以直接使用 Remote Communication Kit 的 rcp.ResponseCache:创建实例时指定落盘目录,配置到 Session 中,第二次请求相同资源时自动命中缓存,省去自己解析 Cache-Control、ETag 的工作。业务数据的缓存仍建议走上面自定义的信封方案,因为需要自己控制"过期后还能不能用"的业务语义。关于写缓存的防抖,HarmonyOS 侧的实现思路与您描述一致:请求层用输入停止 300ms 后再发请求(可用 setTimeout 配合一个待执行句柄实现),写入层在 CacheRepository.save 前先比较 payload 是否与上次相同,相同则跳过写入。首选项的 put 虽然只写内存很快,但 flush 涉及磁盘 IO,防抖的主要收益就在减少 flush 频率。最后一点提醒:connection 的监听回调在页面销毁后不会自动取消,建议在 Ability 生命周期里统一注册和注销(connection.off),避免页面反复进出导致重复回调。整套方案的核心与您的总结完全一致——把"网络不可用"当作一种被设计过的正常状态,在 HarmonyOS 上,分层存储、网络监听、幂等队列这三块系统件已经齐备,剩下的就是按数据类型把策略固化到代码结构里。
点赞
回复于1小时前
拖拽过程列表还在跟着手指滚动,放不准目标槽位;想在拖动时锁父容器滚动、松手再恢复,但onDragMove里频繁改滚动状态又卡手,手势独占和滚动恢复怎么切?

评论11

浏览 39

发布于3小时前
鸿蒙如何为单个bundle内不同ability窗口创建多个任务栏图标

评论28

浏览 458

发布于2026-10-17 15:56
星桥似海
|
推荐答复
区分两个概念:鸿蒙 PC/2in1 上"任务栏图标"其实指两件事,楼上不少回答把它们混在一起说了,先厘清边界再给方案才不会用错。1. 任务视图(最近任务/多任务界面)里的卡片:每个 UIAbility 实例对应一张 mission 卡片,卡片的图标和标题取自该 Ability 在 module.json5 里的 icon / label。2. 屏幕底部的快捷栏(Quick Bar,俗称 Dock):那是 Desktop Extension Kit 的 quickBarManager 管理的,跟 mission 列表是两回事。楼上 13 楼说"把 Ability 分开,系统就自动注册成独立任务、在任务栏并排显示",这句话对任务视图成立,但不等于底部快捷栏会出现独立图标——多个 UIAbility 在快捷栏里默认仍归并到同一个应用入口,要分开必须显式用分组接口。这是最容易踩的坑,先把这个边界讲清楚,下面的方案才不会用错。### 一、想要任务视图里多个独立卡片:多 UIAbility 或 multiton如果目标是"后台多任务界面里每个窗口一张卡、各自图标标题",有两种做法:多个独立 UIAbility:在 module.json5 的 abilities 里声明多个 Ability,每个配自己的 icon/label。A 拉起 B 时 A 进后台但任务保留,B 是新任务,两者并存。同一个 Ability 开多个窗口:必须显式把 launchType 设为 multiton。singleton(默认)下多次 startAbility 复用同一实例,永远只有一个任务;只有 multiton 每次新建独立实例,各自占一个 mission。{ "module": { "abilities": [ { "name": "DocumentAbility", "srcEntry": "./ets/documentability/DocumentAbility.ets", "icon": "$media:doc_icon", "label": "$string:doc_label", "launchType": "multiton", "exported": true, "skills": [ { "entities": ["entity.system.home"], "actions": ["ohos.want.action.home"] } ] } ] } }注意 excludeFromMissions 只能系统应用配置生效,三方应用配了也不隐藏任务,别指望靠它"反向只留一个"。三方想要"只看到一个任务",标准是"一个 UIAbility + 多个页面",而不是藏任务。### 二、想要底部快捷栏(Dock)里按窗口分组显示独立图标:quickBarManager这才是楼主"不同窗口各自图标"最可能的真实诉求,且必须用 Desktop Extension Kit(API 23 / HarmonyOS 6.1.0 起,2in1 设备)。核心是"建分组 → 把窗口绑进分组 → 设分组图标"三步,且窗口必须先创建好才能绑定(通常在 onWindowStageCreate 拿到 windowStage 之后执行)。import { window } from '@kit.ArkUI'; import { quickBarManager } from '@kit.DeskTopExtensionKit'; import { image } from '@kit.ImageKit'; import { resourceManager } from '@kit.LocalizationKit'; import { common } from '@kit.AbilityKit'; async function setupQuickBar(ctx: common.UIAbilityContext, windowStage: window.WindowStage) { // 1. 先确认设备支持快捷栏 const supported: boolean = await quickBarManager.isQuickBarCapabilitySupported(ctx); if (!supported) { console.warn('当前设备不支持快捷栏分组'); return; } // 2. 避免重复建组报错(错误码 1020210005),先查已有分组 const groups = await quickBarManager.getQuickBarGroups(ctx); if (!groups.some(g => g.groupKey === 'editor_group')) { const rm: resourceManager.ResourceManager = ctx.resourceManager; const raw = rm.getRawFileContentSync('quickbar_editor.png'); const src = image.createImageSource(raw.buffer); const icon = await src.createPixelMap(); await quickBarManager.addQuickBarGroup(ctx, { groupKey: 'editor_group', groupIcon: icon }); } // 3. 绑定窗口:getWindowProperties().id 是 number,setWindowToGroup 要 string const mainWindow = windowStage.getMainWindowSync(); const winId = String(mainWindow.getWindowProperties().id); await quickBarManager.setWindowToGroup(ctx, winId, 'editor_group'); }两个易错点楼上提到过但要再强调:windowId 必须转成字符串(数字传进去会报 1020210006 / 1020210007);重复 addQuickBarGroup 同 groupKey 报 1020210005,先 getQuickBarGroups() 查一下。另外别用 addQuickTask()——那是加图标右键菜单项,不是分组图标,用途完全不同。### 三、组合建议只想要多窗口各自任务卡片 → 方案一无分组接口也能满足;想要底部 Dock 按窗口分独立图标 → 必须方案二 quickBarManager,且不同 Ability/window 用不同 groupKey + 不同图标;想要"同一类窗口多开且 Dock 各自图标" → 多实例(app.json5 的 multiAppMode,注意写在 app.json5 不是 module.json5,且限 2in1)配合快捷栏分组。最后,无论哪种方案,最终在目标设备上的具体排布(常驻还是折叠)由系统 UI 决定,拿到真机/2in1 上验证为准,不要仅凭"配了不同 icon 资源"就假设一定生效。
点赞10
回复于2026-10-19 09:09
应用上架时 hap 包 180MB,市场提示"建议 ≤ 150MB"。主要构成分析: 双架构 so 库占 60MB(三方 C++ 库)、图片资源 40MB、字体 15MB、内置 H5 离线包 30MB、其余代码。我想了解:像这种应用如何做分包呢?

评论12

浏览 48

发布于3小时前
AI助手
|
推荐答复
AI 生成内容,仅供参考
针对您 180MB 的 HAP 包,最优解是"分包 + 按需加载 + 资源动态化"三管齐下:将低频大体积功能拆成 Feature HAP 并配置按需下载,so 库只保留 arm64-v8a 单架构并开启压缩,图片转 WebP、字体做子集裁剪、H5 离线包改为云端按需下发。仅这几项通常就能把主包压到 60MB 以下。一、先理解 HarmonyOS 的分包模型上架时的检测单元是 App Pack(.app 文件),它由多个 HAP/HSP 组成。应用市场会拆解 App Pack 并按模块分发,因此"包太大"的本质是"主包(entry HAP)太大"。分包的核心思路是:entry HAP:应用主入口,只保留首启动必需的代码、资源和 sofeature HAP:动态特性模块,可配置为不随主包安装,用户用到时再从应用市场下载HSP:动态共享包,解决多个 HAP 重复依赖同一份 HAR 导致的代码复制问题HAR:静态共享包,会被完整拷贝进每个引用它的 HAP,是隐性体积膨胀源需要注意的是,应用市场对手机/平板 HAP 的硬性上限是 4GB,您遇到的"建议 ≤ 150MB"属于下载转化层面的建议阈值,分包后主包控制在 150MB 以内即可顺利通过。二、针对您的体积构成逐项拆解体积项大小建议方案双架构 so 库60MB只保留 arm64-v8a,开启 compressNativeLibs图片资源40MBPNG 转 WebP、图标 SVG 化、大图云端下发字体15MB字体子集裁剪,只保留实际用到的字符H5 离线包30MB移出安装包,首启动后按需下载到沙箱其余代码35MB开启混淆与压缩,低频功能拆 feature HAP三、分包落地步骤与配置第一步,在 DevEco Studio 中新建 feature 类型的 Module(如 feature_editor),将低频大功能(编辑工具、离线地图等)迁入,并在其 module.json5 中关闭随包安装:// feature_editor/src/main/module.json5 { "module": { "name": "feature_editor", "type": "feature", // feature 类型:动态特性模块 "deliveryWithInstall": false, // 关键配置:不随主包安装,用户用到时再下载 "installationFree": false, "deviceTypes": ["phone"], "mainElement": "EditorAbility", // ...其余配置 } }第二步,在 entry 的 oh-package.json5 中声明动态依赖:// entry/oh-package.json5 { "dynamicDependencies": { "feature_editor": "file:../feature_editor" } }第三步,在 entry 中按需拉取并动态加载 feature 模块(API 12+):// entry/src/main/ets/pages/Index.ets import { moduleInstallManager } from '@kit.AppGalleryKit'; import { BusinessError } from '@kit.BasicServicesKit'; import { hilog } from '@kit.PerformanceAnalysisKit'; const TAG: string = 'FeatureLoader'; async function loadEditorFeature(): Promise<void> { try { // 从应用市场按需下载 feature_editor 模块 const installInfo = await moduleInstallManager.fetchModules(['feature_editor']); if (installInfo[0].status === moduleInstallManager.InstallStatus.SUCCESS) { // 下载成功后,通过动态 import 加载模块 await import('feature_editor'); hilog.info(0x0000, TAG, 'feature 模块加载成功'); } } catch (err) { const e = err as BusinessError; hilog.error(0x0000, TAG, `模块下载失败: ${e.code} ${e.message}`); } }第四步,so 库瘦身。在 build-profile.json5 中过滤 ABI,并在 module.json5 中开启 so 压缩:// build-profile.json5(模块级) { "buildOption": { "externalNativeOptions": { "abiFilters": ["arm64-v8a"] // HarmonyOS NEXT 设备均为 64 位,去掉 v7a 可省约一半 so 体积 } } }// entry/src/main/module.json5 { "module": { "compressNativeLibs": true // so 以压缩方式打包,安装时系统自动解压 } }第五步,H5 离线包动态下发。将离线包从 rawfile 移除,首次启动后下载到应用沙箱:import { request } from '@kit.BasicServicesKit'; import { fileIo } from '@kit.CoreFileKit'; async function downloadH5Package(context: Context): Promise<void> { const savePath = `${context.filesDir}/h5_offline.zip`; const file = fileIo.openSync(savePath, fileIo.OpenMode.CREATE | fileIo.OpenMode.READ_WRITE); // 从服务端按需下载离线包,替代打包进 HAP await request.downloadFile(context, { url: 'https://your-cdn.example.com/h5_offline.zip', filePath: file.path }); }四、补充说明与预期收益关于各优化项的预期效果:so 库单架构化可从 60MB 降到约 30MB,再叠加 compressNativeLibs 通常还能再省 10%-20%;PNG 转 WebP 在同等清晰度下体积减少 40%-60%,ArkUI 原生支持 WebP 无需适配;15MB 的字体文件建议使用 fonttools 等工具做子集裁剪,只保留实际用到的字符集,通常可压到 1-3MB;H5 离线包 30MB 完全移出安装包后云端下发,主包直接减 30MB。关于 HAR 与 HSP 的取舍:如果三方 C++ 库的 ArkTS 封装层(HAR)被 entry 和多个 feature 同时依赖,HAR 会在每个 HAP 中各复制一份,此时应改用 HSP 动态共享包,运行时只加载一份。判断标准是:某个共享模块被三个以上 HAP 引用且体积可观,就值得拆成 HSP。关于上架检测:应用市场会解析 App Pack 中每个 HAP 的大小,按其 deviceTypes 声明的设备类型判定上限(手机/平板 4GB)。分包后即使 feature HAP 较大也不影响主包分发,因为 deliveryWithInstall 为 false 的模块在用户安装主包时不会下载。另外请确保 release 构建已开启 ArkGuard 混淆(默认开启),并检查包内不含 debug 字段为 true 的调试信息,否则提审会被驳回。优化顺序建议遵循"先砍冗余(ABI、资源格式),再消重复(HAR 转 HSP),最后把低频大功能挪出安装包"的节奏,每一步用 DevEco Studio 的 App Size Analyzer 或直接解压 HAP(本质是 zip)核对体积变化,确保收益可量化。
点赞
回复于3小时前
项目是鸿蒙壳承载 H5 的混合 App,H5 页面会发起业务请求用的是axios,想确认原生的网络请求方案:1. @kit.NetworkKit 里的 http2.是用 rcp,3.还是直接使用 axios?

评论3

浏览 24

发布于3小时前
Z
|
采纳答复
原生侧选 rcp,H5 里继续用 axios 互不干扰。你这三者其实不在一层——H5 页面里的 axios 走的是 Web 引擎自己的网络栈,跟原生侧用什么没关系。所以需要分开看:H5 侧:axios 不用动,Web 组件加载 H5 后,JS 里的 axios/fetch 都是浏览器环境发请求,走的是 ArkWeb 内核的网络通道,不需要原生侧参与。只要 module.json5 声明了 ohos.permission.INTERNET 权限就行。原生侧:如果壳工程自己也要发请求(比如登录、配置拉取),在 http 和 rcp 之间选:http(@kit.NetworkKit):标准 HTTP 能力,API 6 起就有,简单场景够用。但每次请求要 createHttp → request → destroy,手动管理生命周期,没有拦截器、没有 Session 复用,功能比较基础。rcp(@kit.RemoteCommunicationKit):场景化 HTTP 能力,API 11 起支持。官方文档明确说了"相较于 Network Kit 中 HTTP 请求能力,更具易用性,且拥有更多的功能"。具体多了:Session 复用连接、拦截器链、自定义 DNS、预建链(冷启动省 400-700ms)、流式传输、证书自定义校验等。新项目无脑选 rcp 就行,API 更好用,性能也更好。@ohos/axios:这是三方库,通过 ohpm 安装后在 ArkTS 里用。底层还是走 http 模块发的请求,相当于在 http 上包了一层 axios 风格的 API。如果你团队熟悉 axios 写法且不想学 rcp 的 API 风格,可以用。但多了一层依赖,功能和性能都不如直接用 rcp。最小 rcp 示例:import { rcp } from '@kit.RemoteCommunicationKit'; import { BusinessError } from '@kit.BasicServicesKit'; const session = rcp.createSession(); const req = new rcp.Request('example.com/api/data', 'GET'); session.fetch(req).then((response: rcp.Response) => { console.info(`status: ${response.statusCode}`); console.info(`body: ${response.body}`); }).catch((err: BusinessError) => { console.error(`error: ${err.code} - ${err.message}`); }).finally(() => { session.close(); });module.json5 别忘了声明权限:"requestPermissions": [ { "name": "ohos.permission.INTERNET" } ]总结:H5 侧的 axios 不用管,原生侧新项目推荐 rcp。如果原生侧请求很少且不想引入新 Kit,http 也能凑合,但 rcp 是官方推荐的上位替代。
点赞1
回复于59分钟前
弹窗、菜单、Sheet 叠加时,多层材质是否会产生遮挡、闪烁或性能问题?

评论3

浏览 10

发布于3小时前
这个状态栏和小白条,怎么沉浸啊?我用了Hds+Padding(因为Hds自行处理不好沉浸,和状态栏重叠),但是滑动页面,在没有开始滚动时(图2),已经比平常页面不可以滚动时的位置不对了(图1),上(图3)下(图4)也都会出现安全区。请问各位大佬,怎么做到像应用市场那样的上下都沉浸,使内容可以延伸到状态栏和导航栏,模糊效果是Hds自带的。

评论18

浏览 597

发布于2026-09-26 14:51
列表项里使用 @Reusable 复用卡片时,如何避免光感状态串位?

评论3

浏览 11

发布于3小时前
使用 Notification 通知渠道时,不同渠道的提醒权限、免打扰规则怎么动态校验,并且在用户关闭渠道后优雅降级?

评论3

浏览 8

发布于4小时前
HarmonyOS 推送回调在应用被后台冻结时容易丢消息,如何搭配长时任务保障重要业务消息落地,同时规避后台管控限制?

评论3

浏览 8

发布于4小时前
怎么做到hdsnavigation标题栏上移,如图

评论14

浏览 228

发布于2026-10-23 03:04
Z
|
推荐答复
HdsNavigation 的标题栏上移效果是通过 titleMode + bindToScrollable 两个属性配合实现的,不用自己写动画。两种上移效果:标题缩小上移(FREE 模式):大标题随滚动缩小成小标题,滑回顶部恢复标题栏整体隐藏:配合 dynamicHideTitleBar,上滑时标题栏直接滑出屏幕核心代码:import { HdsNavigation, HdsNavigationTitleMode, HideMode, ScrollEffectType } from '@kit.UIDesignKit'; import { LengthMetrics } from '@kit.ArkUI'; @Entry @Component struct Index { pageInfo: NavPathStack = new NavPathStack(); scroller: Scroller = new Scroller(); @State blankHeight: number = 138; build() { HdsNavigation(this.pageInfo) { Scroll(this.scroller) { Column() { Blank().height(this.blankHeight).width('100%') Text('滚动内容区域') .height(1200) .width('100%') .backgroundColor('#20000000') } } .edgeEffect(EdgeEffect.Spring) .scrollBar(BarState.Off) } .titleMode(HdsNavigationTitleMode.FREE) .titleBar({ style: { scrollEffectOpts: { enableScrollEffect: true, scrollEffectType: ScrollEffectType.COMMON_BLUR, blurEffectiveStartOffset: LengthMetrics.vp(0), blurEffectiveEndOffset: LengthMetrics.vp(20) } }, content: { title: { mainTitle: '标题', subTitle: '副标题' } } }) .bindToScrollable([this.scroller]) .dynamicHideTitleBar({ hideTitleArea: true, hideBottomBuilder: false, hideStatusBar: false, mode: HideMode.SCROLL_UP_TO }) .hideToolBar(true) } }关键点:titleMode(HdsNavigationTitleMode.FREE) 是默认值,不设也行。FREE 模式下标题随内容上滚缩小,滑回顶部恢复大标题bindToScrollable([this.scroller]) 把 HdsNavigation 和内部 Scroll 绑定,滚动联动才生效,API 6.0.0(20) 起推荐使用dynamicHideTitleBar 控制"滑到哪隐藏",SCROLL_UP_TO 是上滑到固定位置隐藏、下滑到固定位置显示;SCROLL_UP 是任意位置上滑就隐藏。API 6.0.0(20) 起可用内容区顶部加一个 Blank().height(blankHeight) 给标题栏留空间,FREE 模式高度 138vp,MINI 模式 56vp文档:HdsNavigation、滚动模糊及沉浸光感方案
点赞
回复于2026-10-23 03:31

我要提问题

月度答复贡献榜
用户头像
橙动创意
回帖1.1k
粉丝64
关注
用户头像
Z
回帖879
粉丝14
关注
用户头像
蓝瘦的蜕变
回帖496
粉丝140
关注
用户头像
飞b6
回帖496
粉丝16
关注
用户头像
仙银
回帖452
粉丝105
关注
邀您回答
Flutter插件:fluttertpc_flutter_vibrate在iOS上编译报错啊!
华为云的项目负责人是不是疯了
热门标签
1

HarmonyOS 5

2

HarmonyOS 6

3

DevEco Studio

4

UI

5

HarmonyOS

6

ArkUI (方舟UI框架)

7

HarmonyOS 7

8

App开发

9

Ability框架

了解社区公约,与您携手共创和谐专业的开发者社区。
在 App 中查看