鸿蒙开发者社区

在HarmonyOSNext开发中，状态机是管理复杂业务逻辑的有效工具。结合枚举类型（enum）与模式匹配（match），可清晰定义状态、规范状态迁移，并确保类型安全。本文以智能家居设备控制、网络请求流程等场景为例，解析如何通过枚举和模式匹配构建健壮的状态机。一、状态机基础：枚举定义与状态建模1.枚举定义状态集合使用枚举列举状态机的所有可能状态，构造器可携带参数表示状态属性。cj智能家居设备状态机enumDeviceState{Off关机...

在HarmonyOSNext开发中，模式匹配不仅限于match表达式，还可直接用于变量定义和forin循环中。通过将模式置于等号左侧或for关键字后，可实现对复杂数据结构的安全解构。本文结合文档知识点，解析如何利用不可反驳模式（IrrefutablePattern）实现高效的数据提取与集合遍历。一、变量定义中的模式解构变量定义时，模式位于等号左侧，用于从值中提取特定字段或解构复杂类型。仅支持不可反驳模式，确保赋值必定成功。1.元组解构：提...

在HarmonyOSNext开发中，面对嵌套的复杂数据结构（如枚举包裹元组、元组嵌套枚举等），模式匹配的嵌套组合能力至关重要。仓颉语言支持在match表达式中混合使用枚举模式、元组模式及其他模式，实现多层数据的精准解构。本文结合文档知识点，解析模式嵌套的语法规则、应用场景及最佳实践。一、元组与枚举的嵌套匹配1.枚举构造器包含元组当枚举的构造器携带元组参数时，可通过嵌套元组模式提取字段：cjenumUserInfo{Profile((Strin...

病虫害详细页面信息视图中需要增加“保存”按钮，把新增的AI诊断结果保存到AGC云数据库、云存储。保存按钮的代码如下：新增病虫害，AI诊断成功后保存诊断结果到云数据库保存按钮Button('保存到我的诊断记录').width('100%').height(40).fontSize(16).fontWeight(FontWeight.Medium).backgroundColor('007DFF').margin({bottom:48,top:8}).visibility(this.isAddVisibility.Visible:Visibility.Hidden).onClick(()>{TODO:保存诊...

关键词鸿蒙应用内支付问题描述集成华为鸿蒙应用内支付服务服务端接口，按照​​生成服务端请求的token​​指导生成token时，返回错误信息java.lang.IllegalArgumentException:Illegalbase64charactera。cke142.png问题分析我找到华为技术支持（可以提交工单：​​https:developer.huawei.comconsumercnsupportfeedback​​），对方告诉我，参与base64编码的秘钥不能有换行或其他格式问题。重新检查了传的秘钥，我的秘钥字符串有...

关键词鸿蒙游戏，平板，PC问题描述我们游戏支持设备包含手机、平板和PC，刚开始接触鸿蒙，不太清楚在哪里设置兼容设备，研究了下文档并写下来做个记录。问题分析在工程项目的应用级的module.json5文件的deviceTypes配置下添加phone、tablet、2in1字段。cke177.pngcke178.png应用上架前，在华为AGC后台，选择“我的应用”，在应用信息栏下设置支持设备，勾选手机下的手机和平板。PC在后台没有对应的勾选项，可不用处理。cke179.p...

关键词鸿蒙游戏登录，服务器，getPlayerInfo，3001，​​https:josopenapi.cloud.huawei.comgameserviceapigbClientApi​​问题描述我们游戏参考​​文档​​接入游戏服务，使用postman调测服务器​​https:josopenapi.cloud.huawei.comgameserviceapigbClientApi​​接口获取玩家信息时，一直报错3001：cke117.png问题分析​​工单​​联系华为技术支持人员，技术支持建议我们按照如下步骤自检下：检查获取AccessToken的AuthCo...

关键词鸿蒙游戏登录，1001502003问题描述我们游戏参考​​游戏服务​​集成华为鸿蒙游戏登录功能，登录接口报错A03D00JSAPP:loginfail,error:%{public}s{"code":1001502003,"message":"checkandinitrequestparamfailed"}问题分析联系华为技术支持（​​工单联系​​），通过hdchilog>d:xx.log抓取全量日志后，华为技术支持答复，日志显示报错如下：行1617:020111:40:50.14813151315IA00000ACCOUNTTAG:NoclientIdincom.snailgame...

嗨～我是小L！在鸿蒙开发中，适配多设备屏幕尺寸就像「拼图游戏」——断点适配就是最关键的拼图技巧。今天带你解锁断点的核心玩法，让应用在手机、平板、车机上都能「颜值在线」！一、断点基础：屏幕尺寸的「刻度标尺」📏为什么需要断点？设备碎片化：鸿蒙生态覆盖1英寸手表→100英寸智慧屏布局灵活性：小屏用单列，大屏用多列，车机用分屏官方推荐断点划分（基于vp单位）断点名称宽度范围（vp）典型设备布局策略XS[0,320)折叠...

嗨～我是小L！在鸿蒙开发中，文件分享就像「数字高速公路」——URI和FD两种方式各有优势。今天带你掌握安全高效的分享技巧，让应用间数据交换更流畅～一、两种分享方式：URIvsFD🚗核心差异对比表维度URI分享FD分享操作难度简单（系统自动管理权限）复杂（需手动管理文件句柄）分享单位单个文件单个文件或目录权限时效临时授权（接收方退出即失效）永久授权（FD关闭后失效）典型场景文本、图片临时分享大文件、目录批量传输适用...

嗨～我是小L！在鸿蒙开发中，数据备份就像「电子保险箱」——保障用户数据在应用重装、设备迁移时不丢失。今天带你拆解鸿蒙数据备份的核心机制，掌握3个关键开发要点！一、备份框架：数据安全的「底层基建」🏗️核心原理沙箱隔离：每个应用拥有独立备份目录，数据按应用包名隔离存储自动触发：系统在应用卸载、OTA升级、设备迁移时自动启动备份恢复版本兼容：支持跨版本（如HarmonyOS3→Next）的数据平滑迁移备份目录结构datast...

嗨～我是小L！在鸿蒙开发中，提醒功能就像「贴心小秘书」——既能在后台精准触发通知，又能避免耗电。今天带你解锁代理提醒的核心玩法，让你的应用通知更智能！一、代理提醒：后台通知的「守护者」🔒核心优势进程无关：即使应用被杀，系统也会按时触发提醒低耗高效：由系统统一调度，避免应用常驻后台场景丰富：支持倒计时、日历、闹钟三种类型典型应用场景类型场景举例核心参数倒计时提醒会议开始前10分钟提醒triggerTimeInSec...

嗨～我是小L！在鸿蒙开发中，延迟任务就像「时间管家」，能让任务在WiFi连接、充电等特定条件下自动执行，既省电又省流量。今天用3个关键场景带你玩转后台调度～一、延迟任务：按需触发的「节能开关」🔦核心优势条件驱动：仅在满足网络、电量等条件时执行任务系统级优化：避免后台常驻，减少资源占用场景适配：完美匹配「非紧急但需特定环境」的需求典型应用场景场景触发条件任务内容WiFi下数据同步连接到WiFi网络同步大文件或...

嗨～我是小L！在鸿蒙开发中，延迟任务就像「智能管家」——能根据网络、电量等条件自动触发任务，避免资源浪费。今天教你3招玩转延迟任务调度～一、延迟任务：条件触发的「智能开关」🔌核心场景省流量同步：仅在连WiFi时更新数据低电量保护：电量1GB{if(status!WorkStatus.RUNNING){scheduleBackup();}});3.资源释放任务完成后必须调用stopWork避免在onStart中执行耗时操作，改为异步处理五、进阶玩法：跨设备协同调度场景：手...

嗨～我是小L！在鸿蒙开发里，后台任务就像「时间管家」——短时任务处理紧急小事，长时任务搞定持久工作。今天带你快速搞懂两者的区别和实战技巧～一、短时任务：后台的「加急快件」🚚适用场景紧急但耗时短：保存临时数据、发送即时消息、短时网络请求典型例子：退出应用前快速保存未提交的表单后台同步一次用户设置变更申请「三要素」1.时机：必须在前台或onBackground回调中申请2.2.数量：同一时刻最多3个，避免「堵车」3.3....

在HarmonyOSNext开发中，处理可能缺失值的循环场景时，whilelet表达式是保障类型安全的重要工具。它通过模式匹配实现对Option类型值的循环解构，确保在值存在时执行逻辑，缺失时优雅退出。本文结合文档知识点，解析whilelet的语法规则、应用场景及与其他模式的协同逻辑。一、whilelet的核心语法与执行逻辑whilelet表达式用于在循环条件中解构Option类型值，其语法结构如下：cjwhile(模式break}index+1}三、与其他循环结构的对比...

在HarmonyOSNext开发中，如何安全处理“可能不存在的值”是类型安全的核心问题之一。仓颉语言通过Option类型（泛型枚举）提供了优雅的解决方案。本文结合文档知识点，解析Option的设计原理、语义规则及与模式匹配的协同应用，帮助开发者避免空指针异常（NPE）。一、Option类型的本质：枚举驱动的空值安全Option类型是一个泛型枚举，用于表示“可能存在的值”或“明确的缺失”。其定义如下：cjenumOption{Some(T)存在值，携带类...

在HarmonyOSNext开发中，match表达式是实现模式匹配的核心控制结构。仓颉语言支持带匹配值的match表达式和不带匹配值的match表达式，二者在语法结构和应用场景上有显著差异。本文结合文档知识点，解析这两类表达式的核心用法、匹配逻辑及最佳实践。一、带匹配值的match表达式：精准值驱动的分支控制带匹配值的match表达式通过待匹配值与模式的逐一比较，实现条件分支逻辑，适用于枚举值判断、数值范围匹配等场景。1.基础语法结...

在HarmonyOSNext开发中，理解模式的Refutability（可反驳性）是掌握类型安全匹配的关键。仓颉语言将模式分为可反驳模式（RefutablePattern）和不可反驳模式（IrrefutablePattern），二者的本质差异在于是否可能匹配失败。本文结合文档知识点，解析两类模式的定义、应用场景及编译器行为。一、可反驳模式：可能匹配失败的风险模式可反驳模式在某些情况下可能无法匹配待匹配值，需通过逻辑处理避免运行时错误。这类模式要求开发者...

大家好，今天来分享一下仓颉开发语言中的状态存储。主要介绍AppStorage和PersistentStorage两部分内容。AppStorageAppStorage是应用全局级的状态存储，可以在应用的任何地方随时使用。先介绍一下AppStorage的存储方法，有set和setOrCreate两种方式，区别是set只能设置已经创建了的字段的值，相当于修改值，而setOrCreate方法的作用是如果没有字段时会自动创建，所以我推荐大家使用setOrCreate方法。letstore1AppStorage.set('na...