鸿蒙开发者社区

版本：v3.1Beta色彩管理错误码更新时间:2023021709:1918600001参数值异常错误信息Parametervalueisabnormal.错误描述当参数值不符合接口调用要求时，系统会报此错误码。可能原因参数值超出接口调用范围会报错，如枚举值超出定义范围。处理步骤在定义接口参数前，确保参数值符合接口参数要求。屏幕错误码更新时间:2023021709:191400001无效的显示设备错误信息Invaliddisplayorscreen.错误描述当操作无效的显示设备，包括虚拟屏时...

版本：v3.1Beta通用错误码更新时间:2023021709:19通用错误码是指ArkTS接口在调用时均有可能出现的错误码信息，比如接口调用时参数检查失败、权限检查失败等场景。除通用错误码以外，其他错误码只会在对应领域的接口出现。201权限校验失败错误信息Permissionverificationfailed,usuallytheresultreturnedbyVerifyAccessToken.错误描述权限校验失败，应用无权限使用该API，需要申请权限。可能原因该错误码表示权限校验失败，通常...

版本：v3.1Betaohos.fileio(文件管理)更新时间:2023021709:19该模块提供文件存储管理能力，包括文件基本管理、文件目录管理、文件信息统计、文件流式读写等常用功能。说明本模块首批接口从APIversion6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。本模块接口从APIversion9开始废弃，建议使用​​ohos.file.fs​​替代。导入模块importfileiofrom'ohos.fileio';使用说明使用该功能模块对文件目录进行操作前...

版本：v3.1Betaohos.fileio(文件管理)fileio.chmod7+chmod(path:string,mode:number):Promise<void>改变文件权限，使用Promise异步回调。系统能力：SystemCapability.FileManagement.File.FileIO参数：参数名类型必填说明pathstring是所需变更权限的文件的应用沙箱路径。modenumber是改变文件权限，可给定如下权限，以按位或的方式追加权限。0o700：所有者具有读、写及可执行权限。0o400：所有者具有读权限。0o200：所有者具有...

版本：v3.1Betaohos.fileio(文件管理)fileio.fdopenStream7+fdopenStream(fd:number,mode:string):Promise<Stream>基于文件描述符打开文件流，使用Promise异步回调。系统能力：SystemCapability.FileManagement.File.FileIO参数：参数名类型必填说明fdnumber是待打开文件的文件描述符。modestring是r：打开只读文件，该文件必须存在。r+：打开可读写的文件，该文件必须存在。w：打开只写文件，若文件存在则文件长度清0，即该文...

版本：v3.2ReleaseSysCap，全称SystemCapability，即系统能力，指操作系统中每一个相对独立的特性。开发者使用某个接口进行开发前，建议先阅读​​SysCap使用指南​​，了解Syscap的定义和使用指导。再结合下文中的表格判断具体能力集是否支持某个设备，提高开发效率。说明：default代表了一个功能比较全面的OpenHarmony设备，具有大部分的通用能力。在尚未明确设备具体能力集的情况下，可使用default类型进行开发。SystemCapab...

版本：v3.1BetaAceInternalAbility类(Java语言，InternalAbility方式)更新时间:2023021709:19导入模块importohos.ace.ability.AceInternalAbility;AceInternalAbilityAceInternalAbility(bundleName:string,abilityName:string):ObjectAceInternalAbility的构造函数，生成一个InternalAbility对象。参数描述参数名类型必填说明bundleNamestring是Ability的包名称，需要与JS端请求匹配，区分大小写。abilityNamestring是Ability...

版本：v3.1Beta无障碍子系统错误码更新时间:2023031010:169300001输入无效的包名称或者Ability名称错误信息Invalidbundlenameorabilityname.错误描述当输入的包名称或者Ability名称无效时，方法将返回该错误码。可能原因该错误码表示输入无效的包名称或者Ability名称，可能原因如下：包名称不存在。包里面没有对应的Ability。处理步骤检查包名称是否正确。检查包名对应的Ability是否正确。9300002目标Ability已启用错误信息Targ...

作者：坚果团队：坚果派公众号："大前端之旅"润开鸿技术专家，华为HDE，CSDN博客专家，CSDN超级个体，CSDN特邀嘉宾，InfoQ签约作者，OpenHarmony布道师，电子发烧友专家博客，51CTO博客专家，擅长HarmonyOSOpenHarmony应用开发、熟悉服务卡片开发，在“战码先锋”活动中作为大队长，累计培养三个小队长，带领100+队员完成Pr的提交合入。欢迎通过主页或者私信联系我，加入坚果派，一起学习HarmonyOSOpenHarmony应用开发。NAPI是...

【本文正在参加2023年第一期优质创作者激励计划】简介在OpenHarmony应用开发中，我们常用两种方式来实现文件的下载：使用系统能力SystemCapability.Communication.NetStack（ohos.http）使用系统能力SystemCapability.MiscServices.Download（ohos.request）区别前者下载过程信息不可见，后者会在手机状态栏显示下载会话，并且可被应用监听前者请求下载后不会对文件作进一步处理，后者会直接保存到指定目录使用场景下载大体积文...

版本：v3.1Betaohos.bundle(Bundle模块)bundle.getAbilityLabel8+deprecated从APIversion9开始不再维护，建议使用​​bundleManager.getAbilityLabel​​替代。getAbilityLabel(bundleName:string,abilityName:string,callback:AsyncCallback<string>):void通过包名称和Ability组件名获取应用名称，使用callback形式返回结果。获取调用方自己的信息时不需要权限。需要权限：ohos.permission.GETBUNDLEINFOPRIVILEGED或ohos.perm...

版本：v3.1Betaohos.usb(USB管理)更新时间:2023031718:27本模块主要提供管理USB设备的相关功能，包括查询USB设备列表、批量数据传输、控制命令传输、权限控制等。说明本模块首批接口从APIversion8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。从APIversion9开始，该接口不再维护，推荐使用新接口​​ohos.usbV9​​。导入模块importusbfrom"ohos.usb";usb.getDevicesgetDevices():Array<Readonly<USBDevic...

版本：v3.1Betaohos.bundle(Bundle模块)更新时间:2023021709:19本模块提供应用信息查询能力，支持​​包信息​​​、​​应用信息​​​、​​Ability组件信息​​等信息的查询，以及应用禁用状态的查询、设置等。说明本模块首批接口从APIversion7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。导入模块importbundlefrom'ohos.bundle';权限列表权限权限等级描述ohos.permission.GETBUNDLEINFOnormal查询指...

版本：v3.1Betasystem.router(页面路由)更新时间:2023021709:19通过不同的uri访问不同的页面。说明从APIVersion8开始，该接口不再维护，推荐使用新接口​​ohos.router​​。本模块首批接口从APIversion3开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。导入模块importrouterfrom'system.router';router.pushpush(options:RouterOptions):void跳转到应用内的指定页面。系统能力：SystemCapability.ArkUI.ArkU...

版本：v3.1Betasystem.sensor(传感器)更新时间:2023021709:19模块说明sensor模块提供订阅传感器数据基本能力，主要包含查询传感器的列表、订阅取消传感器的数据、执行控制命令等。根据传感器的用途，可以将传感器分为六大类：运动类传感器、环境类传感器、方向类传感器、光线类传感器、健康类传感器、其他类传感器（如霍尔传感器），每一大类传感器包含不同类型的传感器，某种类型的传感器可能是单一的物理传感器，也可能是由多...

版本：v3.1Betasystem.request(上传下载)更新时间:2023021709:19system.request部件主要给应用提供上传下载文件的基础能力。说明从APIVersion9开始所有接口不再维护，推荐使用新接口​​ohos.request​​。本模块首批接口从APIversion3开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。导入模块importrequestfrom'system.request';request.uploadupload(options:UploadRequestOptions):void上传文件，无返回值...

版本：v3.1Betaohos.data.storage(轻量级存储)更新时间:2023031016:42轻量级存储为应用提供keyvalue键值型的文件数据处理能力，支持应用对数据进行轻量级存储及查询。数据存储形式为键值对，键的类型为字符串型，值的存储数据类型包括数字型、字符型、布尔型。说明本模块首批接口从APIversion6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。从APIVersion9开始，该接口不再维护，推荐使用新接口​​ohos.dat...

版本：v3.1Beta概述更新时间:2023021709:19说明本模块首批接口从APIversion4开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。方舟开发框架基于JS扩展的类Web开发范式框架提供了JSFA（FeatureAbility）调用JavaPA（ParticleAbility）的机制。该机制在HarmonyOS引擎内提供了一种通道来传递方法调用、数据返回、事件上报，开发者可根据需要自行实现FA和PA两端的对应接口完成对应的功能逻辑。JSFA调用JavaPA机制...

版本：v3.1Betaohos.reminderAgent(后台代理提醒)更新时间:2023021709:19本模块提供后台代理提醒的能力。开发应用时，开发者可以调用后台提醒发布的接口创建定时提醒，包括倒计时、日历、闹钟三种提醒类型。使用后台代理提醒能力后，应用可以被冻结或退出，计时和弹出提醒的功能将被后台系统服务代理。说明从APIVersion9开始，该接口不再维护，推荐使用新接口​​ohos.reminderAgentManager(后台代理提醒)​​本模块首批接口从A...

版本：v3.2Beta5绘制图形绘制能力主要是通过框架提供的绘制组件来支撑，支持svg标准绘制命令。本节主要学习如何使用绘制组件，绘制详情页食物成分标签（基本几何图形）和应用Logo（自定义图形）。绘制基本几何图形绘制组件封装了一些常见的基本几何图形，比如矩形Rect、圆形Circle、椭圆形Ellipse等，为开发者省去了路线计算的过程。FoodDetail页面的食物成分表里，给每一项成分名称前都加上一个圆形的图标作为成分标签。创建Ci...