中国优质的IT技术网站
专业IT技术创作平台
IT职业在线教育平台
本地优先不能被理解成“有网就上传，没网就算了”。仓库中的同步设计把比赛结束拆成两步：先把比分写入SessionStore，随后异步提交云事件；云端失败只登记同步失败，不撤销本地结果。这样可以把本地比赛事实与远端收敛状态区分开。这篇拆解本地提交、版本事件、冲突重试、快照替换和失败标记的代码路径，并说明失败标记只存在AppStorage、尚未形成持久outbox的设计边界。没有数据时，统计页保持可解释的空态排名依赖已完成比赛...
收藏按钮立即变色、切换页面后数字一致、重启应用后数据仍在，这三个体验分别涉及响应式状态、跨页面共享和磁盘持久化。羽球联盟用AppStorage作为内存镜像，用Preferences保存轻量数据，再由PrefStore提供统一写入口。本次工程构建通过，存储服务与业务页面能够一起生成HAP。两层状态各自负责什么Preferences是磁盘真相，适合保存收藏、历史、关注和设置；AppStorage是页面共享的响应式状态，让详情、收藏页和个人中心读取同一...
资讯类应用很容易从“一个首页”长成难以维护的页面集合。羽球联盟把入口壳、业务页面和公共能力分开后，首页、赛事、发现、个人中心仍能组合成一个产品，同时又不会把所有逻辑塞进同一文件。本次对当前工程执行Hvigor构建，结果为BUILDSUCCESSFUL，三个模块都进入了构建链路。先从用户路径反推工程边界用户打开应用后，会先看到搜索、Banner、功能入口和资讯列表，再通过底部四个入口进入赛事、发现与个人中心。这个路径决定了...
深色模式不是把背景换成黑色。文字、卡片、分割线、按钮和标签只要有一处仍使用浅色值，页面就会出现局部失配。羽球联盟先用语义Token统一颜色与尺寸，再由资源目录和入口生命周期决定实际色值。本次构建通过，主题资源已进入当前HAP。页面只引用语义，不记颜色值tsexportclassAppColors{staticreadonlyprimary:Resource$r('app.color.primary');staticreadonlytextPrimary:Resource$r('app.color.textprimary');staticreadonly...
内容型应用的数据不会永远来自同一个地方：冷启动依赖本地资源，刷新后可能拿到远程链接，详情正文又包含文本、单图和图集。羽球联盟把这些差异收进common模型层，让页面只消费稳定实体。本次当前工程构建通过，模型被业务页面和公共组件共同引用。默认值先消化空状态ArkTS严格模式下，随意拼对象字面量会让可选字段和类型分支扩散到每个页面。当前模型用class与默认值定义实体，使页面拿到对象后即可渲染基础字段。tsexportcla...
项目证据图：足球口袋教练搜索页输入“控球”后的结果。页面说明会从标题、模块、训练重点和描述检索，列出“基础控球”和“家庭标志物训练布置”等课程；点击结果进入课程详情，搜索只筛选现有课程目录而不复制课程对象。训练内容增多后，用户不应每次都从首页逐层寻找课程。搜索、收藏和快捷入口看似是三个独立功能，实际上都在解决同一件事：如何快速定位到同一份课程数据。足球口袋教练的当前实现以课程标识串起这些入口，...
项目证据图：重新启动后进入足球口袋教练数据页，累计分钟仍为2、计划进度仍为17，完成计划与成就数据仍可见。该证据支持训练记录和计划进度可恢复，不将瞬时页面状态描述为需要持久保存的内容。本地优先的训练应用，不等于把所有变量都持久化。真正需要保存的是用户下次打开仍应看到的事实，例如训练记录、计划、收藏与主题；正在打开哪个面板、倒计时还剩多少秒、搜索框是否聚焦，则是短暂页面状态。足球口袋教练的当前代码据...
写鸿蒙播放器的文章很多，但绝大多数只做一件事：在固定尺寸的手机屏上把封面、进度条、控制按钮摆好看。可一旦设备变成折叠屏，或者用户希望"每首歌都有自己的氛围"，这种单形态、写死配色的播放器就立刻显得单薄。这次我想挑战两个更难一点的诉求。第一个是形态自适应：同一个播放器在折叠态（小屏外屏）和展开态（大屏内屏）下，不是简单缩放，而是呈现完全不同的信息密度——折叠态是紧凑的迷你播放器，展开态是双栏沉浸式...
训练课程不应该只是卡片上的标题和一句简介。课程一旦进入计划、收藏、计时、语音提示和训练记录，同一个对象就必须在多个场景中保持稳定含义。足球口袋教练用TrainingItem作为本地课程目录的核心条目：详情页负责展示它，计划只保存它的ID，完成训练时再把必要信息写入记录。项目证据图：足球口袋教练当前“基础控球”课程详情。页面显示技巧训练分类、30分钟、中级难度、收藏状态、提示偏好、本次练习时长调节、场景、器材、...
前言做App首页，十有八九要用到底部导航栏。我之前用自己写的方式实现，代码一堆，切换动画还卡。后来发现HarmonyOS7的Tabs组件，5分钟就能搞定，而且自带丝滑切换。这篇聊聊Tabs组件怎么用，从基础布局到自定义TabBar，再到懒加载和Navigation联动，一次讲清楚。说实话，我一开始没把Tabs当回事。觉得不就是个底部导航嘛，自己画几个图标不就完了？结果自己写了一版，切换的时候白屏闪烁，状态还各种丢。痛定思痛，老老实实用T...
前言我之前上架一个App，审核直接打回来了——原因就是没适配暗黑模式。说实话当时挺不爽的，但用了几天暗黑模式后真香了。HarmonyOS7的暗黑模式适配其实没那么难，3步就能搞定，今天手把手教你。暗黑模式不是"换个黑色背景"那么简单。文字颜色、图片资源、分割线、阴影——所有视觉元素都得跟着调。如果硬编码颜色值，适配起来就是灾难。核心思路是：所有颜色和图片都走资源引用，系统自动帮你切换。为什么要适配暗黑模式除了...
前言一个App用起来爽不爽，很大程度取决于操作区设计得好不好。顶部菜单栏放什么操作，底部工具栏怎么排列，这些细节直接影响用户的操作效率。HarmonyOS7给我们提供了MenuBar和Toolbar两套组件，一个管菜单一个管工具栏，搭配起来用效果拔群。之前做工具类App，每次到了操作区设计就头疼。手写一堆按钮排列，状态管理乱七八糟，多级菜单更是一团糟。后来发现ArkUI自带ToolBar组件和Menu组件，直接省掉了大半工作量。这玩意儿用...
前言你有没有试过改了一行代码，结果三个页面炸了？我上个月就干过这事——改了个按钮颜色，把整个订单流程搞崩了。手动测了两天才把问题找全，人都麻了。从那以后我就在想：要是有一套自动化测试能替我点点点，该多好。折腾了一周UiTest框架，终于跑通了第一个UI自动化测试用例。今天把整个过程分享出来，帮你少踩坑。HarmonyOS7提供了官方的UI自动化测试框架UiTest，专门用来对ArkUI页面做自动化验证。说实话，之前我一直觉得...
前言上个月做了一个消息列表页面，后端一次返回500条数据，我顺手用ForEach渲染。结果页面加载要3秒，滑动卡得像PPT。组长在旁边看了眼说："你这是列表还是幻灯片？"长列表用ForEach，就是在给性能挖坟。后来换成LazyForEach，加载时间从3秒降到0.3秒，滑动丝滑如黄油。今天就聊聊怎么接入LazyForEach，以及那些官方文档没说清楚的坑。ForEachvsLazyForEach性能对比先看数据，用我实际项目测的（500条消息，每条含头像+昵称+内...
前言项目刚启动的时候，页面导航我直接用了ohos.router，毕竟API简单，三行代码搞定跳转。等到页面多了要加底部Tab、要传参、要做登录拦截……才发现Router根本撑不住这些需求，改得我怀疑人生。Router不是不能用，是用了之后路越走越窄。后来全面切到Navigation组件，才知道什么叫"专业的事交给专业的工具"。今天把这两种方案掰开了对比，帮你少走弯路。Router和Navigation的区别维度ohos.routerNavigation定位轻量级页面跳转...
前言说实话，我之前一直觉得通知推送不就是发个消息嘛，能有多难？结果一上手才发现，光是"通知权限被禁"这一个坑就够喝一壶的。本地通知倒还好，三步搞定；但推送Token的获取、通知点击跳转，这些都得单独处理。今天把通知推送的完整链路走一遍，帮大家少踩点坑。这篇文章分两块：本地通知（App自己发，不需要服务端）和推送能力（服务端通过PushKit下发）。本地通知是最常用的，像下载完成提醒、待办到期提醒这些场景都用得到...
前言视频播放这功能，看着简单——不就是个Video组件嘛。但真要做得像样，自定义控制器、全屏切换、手势控进度，一个比一个折腾。HarmonyOS7自带的Video组件默认控制器功能有限，样式也不可控。想要自己的播放器UI，就得手动搞一套。这篇文章从最基础的用法讲起，一路到自定义控制器+手势控制，够你做出一个像样的视频播放器。我的目标是：看完这篇，你能做出一个带自定义进度条、播放暂停按钮、全屏切换、手势拖动进度的视频播...
前言做App最容易被忽视、但最能拉开体验差距的是什么？转场动画。同样一个页面跳转，生硬地切过去和丝滑地滑过去，用户感受天差地别。之前我觉得动画这东西锦上添花，直到产品经理拿竞品跟我对比——人家的转场又顺又有层次感，我们这边像翻PPT。HarmonyOS7的Navigation组件提供了全套转场动画能力，从系统默认到自定义，从页面间转场到共享元素转场，玩明白了，你的App体验直接上一个大台阶。转场动画类型一览先搞清楚HarmonyO...
【HarmonyOSAI】鸿蒙开发者需要搞懂的AICoding概念一、前言最近群里聊AI、DevEcoCLI、DevEcoCode，Skill、MCP、知识库这几个词出镜率很高，但真问起来，不少人其实只停留在看着眼熟，知道个大概的层面。我一直推崇的就是费曼学习法，所以我坚持更新。所学所知，如果能完整表达，别人听后可以理解，这说明自己掌握牢固。这篇不堆术语，作为五年的鸿蒙开发者，今年也深入学习了AI，获得了相关AI的证书和能力认证，所以今天为了鸿...
前言你有没有遇到过这种情况：列表页加载5000条数据，排序逻辑一跑，整个页面直接冻住？用户疯狂点击屏幕没反应，心想这App怎么跟死机了一样。根本原因就是耗时任务占了主线程，UI没机会刷新。解决方案很简单——把耗时任务扔到子线程去跑，Worker就是干这个的。JavaScript天生是单线程的，ArkTS也没逃掉这个基因。但HarmonyOS7给了两个多线程方案：Worker和TaskPool。TaskPool用起来更简单，但Worker更灵活、更适合长任务。说...
