- 博客(939)
- 收藏
- 关注
RSS订阅原创 鸿蒙API14开发【@ohos.file.recent (最近访问列表)(系统接口)】文件基础服务
该模块提供了最近访问列表的管理功能，包括文件添加、移除和查询操作。支持从API 10开始，为系统级接口，目前仅限文件管理器调用。主要功能包括： add(uri) - 将指定URI文件加入最近访问列表 remove(uri) - 从列表中移除指定文件 listFile() - 查询列表中的文件信息，返回包含uri、路径、名称、权限、大小等属性的FileInfo数组 需要FILE_ACCESS_MANAGER权限，且仅支持Stage模型使用。FileInfo对象包含文件的详细元数据，所有属性均为只读。
2025-07-14 14:39:15
402
原创 鸿蒙API14开发【@ohos.file.fileExtensionInfo (公共文件访问与管理属性信息)(系统接口)】文件基础服务
摘要：该模块定义了文件管理相关的设备类型和设备能力标识，包括DeviceType枚举（如本地磁盘、网络设备等）和DeviceFlag、DocumentFlag属性（如读写支持标志）。适用于API 9及以上版本，仅支持Stage模型，需导入@ohos.file.fileExtensionInfo模块使用。系统能力要求UserFileService，主要用于描述RootInfo和FileInfo中的设备属性和文件权限。
2025-07-13 20:11:33
375
原创 鸿蒙API14开发【@ohos.file.environment (目录环境能力)(系统接口)】文件基础服务
本文介绍了Environment模块提供的环境目录获取能力，包含获取内存存储根目录和公共文件根目录的JS接口。该模块支持通过Promise和Callback两种异步方式调用，适用于系统应用开发。主要接口包括：getStorageDataDir()获取内存存储根目录、getUserDataDir()获取公共文件根目录，以及11+版本新增的getExternalStorageDir()获取外卡根目录沙箱路径。使用时需注意系统能力和权限要求，错误码202表示非系统应用调用，13900042表示未知错误。示例代码演
2025-07-13 19:08:17
587
原创 鸿蒙API14开发【@ohos.file.cloudSyncManager (端云同步管理能力)(系统接口)】文件基础服务
摘要 该模块为云空间应用提供端云同步管理功能，包括： 同步开关管理：修改应用的端云同步开关状态（开启/关闭）。 数据变更通知：当云端数据变化时，通知端云服务更新。 账号清理：支持账号退出时清理或保留云端相关文件。 接口说明： 首批接口从API 10开始支持，需系统权限调用。 提供changeAppCloudSwitch()异步修改同步开关，支持Promise和Callback两种形式。 notifyDataChange()可触发云端数据变更通知。 示例场景： 开发者在应用内调用接口控制云同步开关，或在数据更
2025-07-12 21:11:38
386
原创 鸿蒙API14开发【@ohos.file.cloudSync (端云同步能力)(系统接口)】文件基础服务
摘要 该文档介绍了端云同步模块GallerySync的功能和使用方法。GallerySync提供启动/停止端云同步、原图下载的能力，支持通过事件监听获取同步进度。开发需导入@kit.CoreFileKit模块，创建GallerySync实例后可使用on/off方法订阅/取消进度事件。使用该模块需申请ohos.permission.CLOUDFILE_SYNC权限，且仅限系统应用调用。文档提供了完整示例代码和错误码说明，包括参数校验失败、权限不足等常见错误。
2025-07-12 20:07:42
398
原创 鸿蒙API14开发【@ohos.application.BackupExtensionAbility (备份恢复扩展能力)(系统接口)】文件基础服务
摘要： BackupExtensionAbility模块是鸿蒙系统提供的备份恢复服务扩展能力，支持API 10及以上版本。该模块仅适用于Stage模型，包含系统级接口如getBackupInfo()，用于开发者自定义应用数据备份操作。示例代码展示了如何继承BackupExtensionAbility并实现数据查询功能。文章还提供了鸿蒙开发的学习资源获取方式，包括《HarmonyOS应用开发》等进阶资料。 （字数：149）
2025-07-12 19:06:20
294
原创 鸿蒙API14开发【@ohos.file.BackupExtensionContext (备份恢复扩展能力)】文件基础服务
摘要：BackupExtensionContext是用于备份恢复扩展的上下文环境，继承自ExtensionContext，提供访问特定备份资源的能力。该模块主要包含backupDir属性，用于获取备份恢复过程中的临时路径（仅支持el1/el2路径）。使用示例展示了如何在onBackup和onRestore方法中切换沙箱路径并获取对应目录。该模块需在Stage模型下使用，从API version 12开始支持。注意备份路径仅限临时使用，不可另作他用。
2025-07-11 21:53:30
349
原创 鸿蒙API14开发【@ohos.fileshare (文件分享)】文件基础服务
文件分享模块提供系统应用将公共目录文件URI授权给其他应用的能力，支持读写权限控制。主要功能包括：通过persistPermission接口对多个文件/目录URI进行持久化授权（最多500个），需FILE_ACCESS_PERSIST权限；定义OperationMode枚举区分读(0b1)、写(0b10)权限；提供PolicyErrorCode标识授权失败原因（如禁止持久化、无效路径等）。该模块从API 9开始支持，后续版本新增接口会单独标记。使用时需导入@ohos.fileshare模块，授权后应用可使用
2025-07-11 20:38:57
382
原创 鸿蒙API14开发【@ohos.file.storageStatistics (应用空间统计)】文件基础服务
摘要 本文档介绍了storageStatistics模块提供的空间查询功能，包括应用存储空间大小查询和内置存储总容量查询接口。该模块支持两种调用方式：Promise和AsyncCallback回调。 主要接口包括： getCurrentBundleStats() - 获取当前应用存储空间大小（字节） getTotalSize() - 获取内置存储总空间大小（字节） 所有接口均需导入@kit.CoreFileKit模块使用，并提供了错误码处理机制。调用示例展示了两种异步方式的典型用法，开发者可根据需要选择Pr
2025-07-11 19:30:06
391
原创 鸿蒙API14开发【@ohos.file.statvfs (文件系统空间统计)】文件基础服务
摘要：该模块提供文件系统存储信息查询功能，支持获取总字节数和空闲字节数。包含异步(Promise/callback)和同步方法，首批接口从API 9开始支持。开发示例展示了如何通过UIAbilityContext获取应用文件目录的存储空间信息。适用于需要管理文件系统存储空间的鸿蒙应用开发场景。
2025-07-11 17:24:28
294
原创 鸿蒙API14开发【@ohos.file.securityLabel (数据标签)】文件基础服务
文件安全等级模块摘要： 该模块提供文件数据安全等级设置功能，支持从S0到S4五个安全级别。开发者可通过异步(Promise/callback)或同步方式为文件/目录设置安全标签，安全等级仅能由低向高或平级调整。使用前需获取应用沙箱路径，接口从API 9开始支持。 主要特性： 提供DataLevel类型定义文件安全等级(S0-S4) 支持异步设置(setSecurityLabel)和同步设置(setSecurityLabelSync) 包含完善错误码体系，覆盖权限、参数、空间等常见异常情况 使用示例展示了如何
2025-07-11 15:56:56
242
原创 鸿蒙API14开发【@ohos.file.picker (选择器)】文件基础服务
该模块接口从API version 9开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。选择器(Picker)是一个封装PhotoViewPicker、DocumentViewPicker、AudioViewPicker等API模块，具有选择与保存的能力。应用可以自行选择使用哪种API实现文件选择和文件保存的功能。该类接口，需要应用在界面UIAbility中调用，否则无法拉起photoPicker应用或FilePicker应用。
2025-07-11 14:49:25
423
原创 鸿蒙API14开发【@ohos.file.hash (文件哈希处理)】文件基础服务
文件哈希计算模块摘要： 该模块提供文件内容哈希计算功能，支持多种算法（MD5、SHA1、SHA256）。开发者需先获取应用沙箱路径，然后通过hash()方法计算文件哈希值，返回十六进制大写字符串。模块提供Promise和Callback两种异步方式，并新增HashStream类（API12+）支持流式处理。典型应用场景包括文件完整性校验，建议优先使用安全性更高的SHA256算法。使用时需注意处理可能出现的参数错误和未知错误。
2025-07-11 13:37:13
290
原创 鸿蒙API14开发【@ohos.file.fileuri (文件URI)】文件基础服务
文件URI模块摘要 该模块提供文件URI与路径转换功能，支持应用沙箱和公共目录文件的URI处理。主要特性包括： URI转换：将文件路径转换为URI格式，支持应用沙箱路径和公共目录路径 属性获取：从URI中获取文件名和原始路径 路径操作： 获取文件所在目录URI（API 11+） 判断是否为远端文件URI（API 12+） 版本支持：基础功能从API 9开始支持，新增功能在后续版本单独标记 使用前需获取应用沙箱路径，可通过UIAbility上下文获取filesDir。注意处理字符编码和路径校验问题，提供错误码
2025-07-10 21:44:18
773
原创 鸿蒙API14开发【USB设备管理】文件基础服务
本文介绍了环境目录模块的核心功能，该模块提供获取各类预授权目录沙箱路径的JS接口。主要包含三个方法：getUserDownloadDir获取下载目录路径、getUserDesktopDir获取桌面目录路径、getUserDocumentDir获取文档目录路径，均仅支持2in1设备使用。每个方法都通过try-catch处理可能出现的错误码801（能力不支持）和13900042（未知错误）。文中提供了完整的导入模块说明、接口定义、参数返回值说明以及调用示例代码，帮助开发者正确使用这些文件目录获取功能。
2025-07-10 20:40:43
371
原创 鸿蒙API14开发【@ohos.file.cloudSync (端云同步能力)】文件基础服务
端云同步模块提供了文件同步和下载功能，支持实时状态监控和错误处理。主要特性包括： 同步状态管理（上传/下载/完成/失败等） 全面的错误类型检测（网络、电量、存储空间等） 进度跟踪功能（已处理数据量、文件大小等） 事件监听机制 该模块适用于需要实现云端文件同步的应用场景，通过API可控制同步流程并获取实时状态。系统能力要求较高，需SystemCapability.FileManagement.DistributedFileService.CloudSync.Core支持。
2025-07-10 19:36:56
883
原创 鸿蒙API14开发【@ohos.application.BackupExtensionAbility (备份恢复扩展能力)】后台任务开发
BackupExtensionAbility模块为应用提供数据备份恢复的扩展能力，支持API版本10及以上，仅适用于Stage模型。主要功能包括： BundleVersion：定义恢复时所需的版本信息，包含版本号(code)和版本名称(name)。 核心方法： onBackup()：执行备份数据时的回调接口 onRestore()：执行恢复数据时的回调接口，接收BundleVersion参数 onBackupEx() (API 12+)：增强的备份接口，支持传递参数 onRestoreEx() (API 1
2025-07-10 16:51:59
255
原创 鸿蒙API14开发【WorkSchedulerExtensionContext (系统接口)】后台任务开发
摘要：WorkSchedulerExtensionContext是WorkSchedulerExtensionAbility的上下文环境，提供访问特定资源的能力。该模块从API 10开始支持，仅适用于Stage模型下的系统接口。通过WorkSchedulerExtensionAbility实例获取上下文后，可使用startServiceExtensionAbility方法启动ServiceExtensionAbility（需传入Want对象参数）。该方法返回Promise异步回调，并包含详细的错误码说明，如
2025-07-10 15:51:34
439
原创 鸿蒙API14开发【WorkSchedulerExtensionContext】后台任务开发
摘要：WorkSchedulerExtensionContext是WorkSchedulerExtensionAbility的上下文环境，提供访问特定资源的能力。该模块从API 10开始支持，仅适用于Stage模型。通过继承WorkSchedulerExtensionAbility的子类实例可获取上下文，示例代码展示了在onWorkStart方法中获取WorkSchedulerExtensionContext的过程。
2025-07-10 14:47:51
363
原创 鸿蒙API14开发【@ohos.resourceschedule.deviceStandby (设备待机模块)(系统接口)】后台任务开发
设备待机模式简介 设备长时间未使用或通过按键可进入待机模式，此模式不影响应用使用，同时可延长电池续航时间。系统提供待机资源管理接口，允许查询设备及应用是否为待机模式，并为应用申请/取消待机资源管控权限。 主要接口功能： getExemptedApps - 获取待机豁免应用名单 支持Callback和Promise两种异步回调方式 需DEVICE_STANDBY_EXEMPTION权限 参数为资源类型组合(如TIMER|NETWORK) 返回豁免应用信息数组 典型错误码包括权限错误(201)、参数错误(401
2025-07-10 13:47:31
237
原创 鸿蒙API14开发【@ohos.resourceschedule.backgroundTaskManager (后台任务管理)(系统接口)】后台任务开发
本模块提供后台任务管理接口，允许应用申请能效资源以维持后台运行。主要功能包括申请能效资源和释放全部能效资源。申请时需指定资源类型、超时时间等参数，支持CPU等资源类型。该模块为系统级能力，需系统应用权限使用。开发者可通过示例代码了解接口调用方式，错误码涵盖权限、参数校验等异常情况。
2025-07-09 21:43:56
968
原创 鸿蒙API14开发【@ohos.WorkSchedulerExtensionAbility (延迟任务调度回调)】后台任务开发
本文介绍了延迟任务回调模块的功能与使用方法。该模块提供延迟任务调度能力，开发者可通过重写接口实现任务触发时的回调处理。仅支持Stage模型，API version 9及以上可用。主要包含WorkSchedulerExtensionContext上下文环境和WorkSchedulerExtensionAbility类，其中onWorkStart和onWorkStop方法分别用于处理任务开始和结束时的回调逻辑。使用时需导入@kit.BackgroundTasksKit模块，并继承WorkSchedulerExt
2025-07-09 20:37:29
374
原创 鸿蒙API14开发【@ohos.resourceschedule.workScheduler (延迟任务调度)】后台任务开发
本文介绍了延迟任务调度模块的主要功能，包括任务注册、取消和查询能力。该模块适用于处理实时性要求不高的后台任务，会根据系统资源状况智能调度。文章详细说明了startWork和stopWork两个核心接口的使用方法、参数要求、错误代码及调用示例。本模块仅支持Stage模型，从API version 9开始提供，后续版本新增接口会单独标记。开发者可通过该模块优化应用性能，合理利用系统资源。
2025-07-09 19:35:50
570
原创 鸿蒙API14开发【@ohos.resourceschedule.backgroundTaskManager (后台任务管理)】后台任务开发
摘要：本模块提供后台任务管理接口，允许应用退至后台时申请短时或长时任务，避免进程被终止。主要功能包括申请短时任务(requestSuspendDelay)和查询剩余时间(getRemainingDelayTime)。使用时需注意参数校验和错误处理，支持从API version 9开始。示例代码展示了如何申请短时任务及获取剩余时间。
2025-07-09 17:59:23
810
原创 鸿蒙API14开发【@ohos.reminderAgentManager (后台代理提醒)】后台任务开发
摘要 该模块提供了后台代理提醒功能，支持应用冻结或退出后由系统服务代理计时和提醒。开发者可创建倒计时、日历和闹钟三种类型的提醒。接口从API 9开始支持，需申请通知权限并使用ohos.permission.PUBLISH_AGENT_REMINDER权限。 主要接口： publishReminder：发布代理提醒，支持Callback/Promise方式，返回提醒ID。若通知未开启或提醒数量超限会报错。 cancelReminder：取消指定ID的提醒，成功无返回，失败返回错误码（如提醒不存在）。 示例代码
2025-07-09 16:28:52
878
原创 鸿蒙API14开发【自定义组件使用说明】JS服务卡片UI组件
本文介绍了自定义组件的使用方法与配置规范。自定义组件通过封装现有组件提高代码复用性，使用element标签引入，支持props属性传递数据和默认值设置。父子组件通信遵循单向数据流原则，子组件通过proxy触发自定义事件，父组件监听处理。文章包含组件配置属性说明、事件绑定示例和props数据传递示例，强调组件命名规范与数据单向性限制。
2025-07-09 15:05:15
400
原创 鸿蒙API14开发【text】JS服务卡片UI组件
本文介绍了API Version 8及以上版本支持的文本样式属性，包括子组件支持、通用属性及样式扩展。详细说明了文本颜色、字体大小、间距、粗细、修饰、对齐、行高、溢出处理等样式配置，并新增动态字号调整功能，支持预设字号集合、最小/最大字号及步长设置。该特性适用于灵活适配不同显示场景的文本渲染需求。
2025-07-09 13:57:52
885
原创 鸿蒙API14开发【progress】JS服务卡片UI组件
本文介绍了进度条组件的属性和样式配置。进度条支持多种类型（线性、环形、弧形等），每种类型都有特定的属性和样式控制。主要配置包括：类型选择（type）、进度百分比（percent）、次级进度（secondarypercent）、颜色设置（color/background-color）以及尺寸控制（stroke-width/radius等）。示例展示了不同类型进度条的基本用法，通过CSS设置尺寸和布局。该组件适用于展示内容加载或操作的处理进度，可根据不同场景需求选择合适的样式类型。
2025-07-08 22:30:33
723
原创 鸿蒙API14开发【input】JS服务卡片UI组件
本文介绍了支持单选框功能的交互式组件，包括其主要属性（type、checked、name、value）、支持的事件（change、click）以及使用示例。该组件从API Version 8开始支持，允许在多个同名选项中选择一个，并通过change事件返回选中值。示例代码展示了三个单选框的布局和样式实现，以及事件处理逻辑，最终效果呈现在4*4卡片中。
2025-07-08 20:37:55
182
原创 鸿蒙API14开发【image】JS服务卡片UI组件
摘要：图片组件是用于渲染展示图片的基础组件，支持本地路径和内存图片读取（禁止使用网络URL）。主要属性包括图片路径(src)和占位图(alt)；样式支持缩放类型(object-fit)、文字方向跟随(match-text-direction)和原尺寸适应(fit-original-size)等设置。组件提供图片加载完成(complete)和加载失败(error)的事件回调，示例展示了通过stack布局和contain缩放模式显示本地图片的基本用法。（148字）
2025-07-08 19:30:50
409
原创 鸿蒙API14开发【clock】JS服务卡片UI组件
时钟组件提供表盘界面显示功能，支持日间/夜间两种模式，可配置表盘、指针资源和样式。主要属性包括：1）clockconfig设置日间/夜间的表盘、指针资源及数字颜色；2）showdigit控制是否显示表盘数字；3）hourswest设置时区偏移。组件要求资源为PNG格式，不支持SVG，指针图片需满足特定尺寸比例要求，数字位置和大小可通过比率参数调整。API Version 8开始支持。
2025-07-08 15:50:50
1011
原创 鸿蒙API14开发【calendar】JS服务卡片UI组件
日历组件API文档摘要（148字）： 该文档介绍了日历组件的功能和使用方法，支持API 8及以上版本。组件包含日期选择、卡片样式设置、工作日显示等功能，支持自定义起始周、休息日配置。关键属性包括date（当前日期）、cardcalendar（卡片模式）、calendardata（月视图数据JSON格式）。提供两种事件：selectedchange（日期/月份切换触发）和requestdata（请求新数据时触发）。样式可设置背景颜色。示例展示了HTML、CSS和JS的集成用法，包括事件处理和数据绑定。组件支持
2025-07-08 14:39:46
593
原创 鸿蒙API14开发【calendar】JS服务卡片UI组件
日历组件API文档摘要（148字）： 该文档介绍了日历组件的功能和使用方法，支持API 8及以上版本。组件包含日期选择、卡片样式设置、工作日显示等功能，支持自定义起始周、休息日配置。关键属性包括date（当前日期）、cardcalendar（卡片模式）、calendardata（月视图数据JSON格式）。提供两种事件：selectedchange（日期/月份切换触发）和requestdata（请求新数据时触发）。样式可设置背景颜色。示例展示了HTML、CSS和JS的集成用法，包括事件处理和数据绑定。组件支持
2025-07-08 13:39:46
787
原创 鸿蒙API14开发【button】JS服务卡片UI组件
本文介绍了HarmonyOS按钮组件的使用规范，包括三种类型：胶囊按钮、圆形按钮和文本按钮。详细说明了从API8开始支持的属性配置，如按钮类型、文本值、图标路径及布局位置等，并列出各类型按钮支持的样式设置限制。通过示例代码展示了不同类型按钮的实现方式，包含HML结构定义和CSS样式配置。最后提供了4*4卡片效果展示图，并邀请开发者加入鸿蒙学习阵营获取更多学习资料。该文档适用于HarmonyOS应用开发人员参考使用。
2025-07-07 22:07:50
626
原创 鸿蒙API14开发【div】JS服务卡片UI组件
摘要：本文介绍了滑动容器(Swiper)组件的功能特性，主要包括：1)支持子组件切换显示；2)提供多种属性配置如索引值、导航指示器、滑动方向等；3)支持自定义样式包括指示器颜色、位置等；4)包含示例代码展示基础使用方式。该组件从API Version 8开始支持，适用于构建轮播图等滑动切换场景。文章还提供了相关学习资源获取方式，帮助开发者快速掌握鸿蒙应用开发技术。（148字）
2025-07-07 20:48:19
377
原创 鸿蒙API14开发【list】JS服务卡片UI组件
列表组件（List）支持相同宽度的列表项展示，适用于连续多行同类数据呈现。主要特性包括：支持子组件list-item、缓存控制（cachedcount）、滚动条样式（scrollbar）、滑动效果（scrolleffect）、分隔线（divider）、形状模式（shapemode）、更新动画（updateeffect）、初始显示位置设置（initialindex/initialoffset）以及选中项标记（selected）。样式方面支持分隔线颜色/高度/长度设置、flex布局方向调整等。建议在卡片场景中控
2025-07-07 17:23:19
971
原创 鸿蒙API14开发【div】JS服务卡片UI组件
摘要 基础容器组件用于构建页面结构或内容分组，支持API Version 8及以上版本。主要特性包括： 布局功能：支持flex和grid两种布局模式 flex布局提供主轴/交叉轴对齐、换行等样式控制 grid布局支持行列模板设置、间距调整和单元格定位 样式属性： 通用属性样式 特有布局样式如flex-direction、justify-content等 grid模板支持百分比、固定值、自适应等多种维度设置 子组件支持：可作为容器嵌套其他组件 注意事项：部分属性如flex-wrap、display不支持动态修
2025-07-07 16:04:49
564
原创 鸿蒙API14开发【badge】JS服务卡片UI组件
应用中如果有需用户关注的新事件提醒，可以采用新事件标记来标识。从API Version 8 开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
2025-07-07 14:49:58
393
原创 鸿蒙API14开发【原子布局】JS服务卡片UI组件
摘要： 原子布局是一种自适应布局能力，适用于不同屏幕尺寸的设备。它提供隐藏能力（通过display-index控制元素显示优先级）和占比能力（通过flex-weight分配空间比例）来实现灵活布局。此外，固定比例功能（aspect-ratio）可保持元素宽高比。这些特性从API 8开始支持，帮助开发者在多形态屏幕上快速实现设计效果的自适应呈现。（150字）
2025-07-07 13:35:36
238
空空如也
空空如也
TA创建的收藏夹 TA关注的收藏夹
TA关注的人