鸿蒙开发者社区

版本：v3.1Betaohos.account.osAccount(系统帐号管理)更新时间:2023021709:19本模块提供管理系统帐号的基础能力，包括系统帐号的添加、删除、查询、设置、订阅、启动等功能。说明本模块首批接口从APIversion7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。导入模块importaccountosAccountfrom'ohos.account.osAccount';accountosAccount.getAccountManagergetAccountManager():AccountManager获取系统帐号...

版本：v3.2Beta5UIAbility是系统调度的最小单元。在设备内的功能模块之间跳转时，会涉及到启动特定的UIAbility，该UIAbility可以是应用内的其他UIAbility，也可以是其他应用的UIAbility（例如启动三方支付UIAbility）。本章节将从如下场景分别介绍设备内UIAbility间的交互方式。对于跨设备的应用组件交互，请参见​​应用组件跨设备交互（流转）​​。​​启动应用内的UIAbility​​​​启动应用内的UIAbility并获取返回结果​...

版本：v3.2Beta5进程模型OpenHarmony的进程模型如下图所示：应用中（同一包名）的所有UIAbility、ServiceExtensionAbility、DataShareExtensionAbility运行在同一个独立进程中，即图中绿色部分的“MainProcess”。应用中（同一包名）的同一类型ExtensionAbility（除ServiceExtensionAbility和DataShareExtensionAbility外）运行在一个独立进程中，即图中蓝色部分的“FormExtensionAbilityProcess”、“InputMethodExtensionAbil...

版本：v3.2Beta5ServiceAbility组件概述ServiceAbility，即"基于Service模板的Ability"，主要用于后台运行任务（如执行音乐播放、文件下载等），不提供用户交互界面。ServiceAbility可由其他应用或PageAbility启动，即使用户切换到其他应用，ServiceAbility仍将在后台继续运行。ServiceAbility组件配置与PageAbility类似，ServiceAbility的相关配置在config.json配置文件的"module"对象的"abilities"对象中，与PageAbility的区...

版本：v3.2Beta5DataAbility组件概述DataAbility，即"使用Data模板的Ability"，主要用于对外部提供统一的数据访问抽象，不提供用户交互界面。DataAbility可由PageAbility、ServiceAbility或其他应用启动，即使用户切换到其他应用，DataAbility仍将在后台继续运行。使用DataAbility有助于应用管理其自身和其他应用存储数据的访问，并提供与其他应用共享数据的方法。DataAbility既可用于同设备不同应用的数据共享，也支持跨设备不...

版本：v3.1Betaohos.buffer(Buffer)readIntLEreadIntLE(offset:number,byteLength:number):number从指定的offset处的buf读取byteLength个字节，并将结果解释为支持最高48位精度的小端序、二进制补码有符号值。系统能力：SystemCapability.Utils.Lang参数：参数名类型必填说明offsetnumber是偏移量。默认值:0。byteLengthnumber是读取的字节数。返回值：类型说明number读取出的内容。错误码：以下错误码的详细介绍请参见​​语言...

版本：v3.2Beta5基本概念ArkTS提供了多维度的状态管理机制，在ArkUI开发框架中，和UI相关联的数据，不仅可以在组件内使用，还可以在不同组件层级间传递，比如父子组件之间、爷孙组件之间，也可以是应用全局范围内的传递。另外，从数据的传递形式来看，可分为只读的单向传递和可变更的双向传递。开发者可以灵活地利用这些能力来实现数据和UI的联动。页面级变量的状态管理装饰器装饰内容说明State基本数据类型，类，数组修饰的状...

版本：v3.1Betaohos.util.ArrayList(线性容器ArrayList)更新时间:2023030317:21ArrayList是一种线性数据结构，底层基于数组实现。ArrayList会根据实际需要动态调整容量，每次扩容增加50%。ArrayList和​​Vector​​相似，都是基于数组实现。它们都可以动态调整容量，但Vector每次扩容增加1倍。ArrayList和​​LinkedList​​相比，ArrayList的随机访问效率更高。但由于ArrayList的增删操作会影响数组内其他元素的移动，LinkedL...

版本：v3.2Beta5组件启动规则（Stage模型）启动组件是指一切启动或连接应用组件的行为：启动UIAbility、ServiceExtensionAbility、DataShareExtensionAbility，如使用startAbility()、startServiceExtensionAbility()、startAbilityByCall()等相关接口。连接ServiceExtensionAbility、DataShareExtensionAbility，如使用connectServiceExtensionAbility()、createDataShareHelper()等相关接口。在OpenHarmony中，为了保证用户具...

版本：v3.2Beta5ExtensionAbility组件概述ExtensionAbility组件是基于特定场景（例如服务卡片、输入法等）提供的应用组件，以便满足更多的使用场景。每一个具体场景对应一个​​ExtensionAbilityType​​，各类型的ExtensionAbility组件均由相应的系统服务统一管理，例如InputMethodExtensionAbility组件由输入法管理服务统一管理。当前支持的ExtensionAbility类型有：​​FormExtensionAbility​​：FORM类型的ExtensionAbilit...

版本：v3.2Beta5State、Prop、Link、Provide、Consume、ObjectLink、Observed和Watch用于管理页面级变量的状态。请参考​​状态变量多种数据类型声明的使用限制​​了解State、Provide、Link和Consume四种状态变量的约束条件。StateState装饰的变量是组件内部的状态数据，当这些状态数据被修改时，将会调用所在组件的build方法进行UI刷新。State状态数据具有以下特征：支持多种类型数据：支持class、number、boolean、string强...

版本：v3.1Betaohos.buffer(Buffer)更新时间:2023021709:19Buffer对象用于表示固定长度的字节序列，是专门存放二进制数据的缓存区。推荐使用场景：可用于处理大量二进制数据，图片处理、文件接收上传等。说明本模块首批接口从APIversion9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。导入模块importbufferfrom'ohos.buffer';BufferEncoding表示支持的编码格式字符串。系统能力：SystemCapability.Utils.La...

版本：v3.2Beta5线程模型OpenHarmony应用中每个进程都会有一个主线程，主线程有如下职责：负责管理其他线程同应用多个UIAbility组件共用一个主线程输入事件分发UI绘制应用代码回调（事件处理，生命周期）接收Worker发送的消息除主线程外，还有一类与主线程并行的独立线程Worker，主要用于执行耗时操作，但不可以直接操作UI。Worker线程在主线程中创建，与主线程相互独立。最多可以创建7个Worker：基于OpenHarmony的线程模型，不...

版本：v3.2Beta5UIAbility组件启动模式UIAbility的启动模式是指UIAbility实例在启动时的不同呈现状态。针对不同的业务场景，系统提供了三种启动模式：​​singleton（单实例模式）​​​​standard（标准实例模式）​​​​specified（指定实例模式）​​singleton启动模式singleton启动模式为单实例模式，也是默认情况下的启动模式。每次调用startAbility()方法时，如果应用进程中该类型的UIAbility实例已经存在，则复用系统中...

版本：v3.1Betaohos.account.osAccount(系统帐号管理)querySerialNumberByOsAccountLocalId9+querySerialNumberByOsAccountLocalId(localId:number):Promise<number>通过系统帐号ID获取与该系统帐号关联的SN码。使用Promise异步回调。系统能力：SystemCapability.Account.OsAccount参数：参数名类型必填说明localIdnumber是系统帐号ID。返回值：类型说明Promise<number>Promise对象，返回与该系统帐号关联的SN码。错误码：错误...

版本：v3.2Beta5应用程序包概述用户应用程序泛指运行在设备的操作系统之上，为用户提供特定服务的程序，简称“应用”。一个应用所对应的软件包文件，称为“应用程序包”。OpenHarmony提供了应用程序包开发、安装、查询、更新、卸载的管理机制，方便开发者开发和管理OpenHarmony应用，具体如下：应用软件所涉及的文件多种多样，开发者可通过OpenHarmony提供的集成开发工具将其开发的可执行代码、资源、三方库等文件整合到一起制...

版本：v3.2Beta5FA模型开发概述基于FA模型开发应用时，在应用模型部分，涉及如下开发过程。表1FA模型开发流程任务简介相关指导应用组件开发本章节介绍了如何使用FA模型的PageAbility、ServiceAbility、DataAbility以及服务卡片进行应用开发。​​应用组件级配置​​​​PageAbility开发指导​​​​ServiceAbility开发指导​​​​DataAbility开发指导​​​​服务卡片开发指导​​​​FA模型的Context​​​​信息传递载体Want...

版本：v3.2Beta5Want概述Want的定义与用途​​Want​​是一种对象，用于在应用组件之间传递信息。其中，一种常见的使用场景是作为​​startAbility()​​方法的参数。例如，当UIAbilityA需要启动UIAbilityB并向UIAbilityB传递一些数据时，可以使用Want作为一个载体，将数据传递给UIAbilityB。图1Want用法示意Want的类型显式Want：在启动Ability时，如果指定了abilityName和bundleName，则称为显式Want。显式Want通常用于在当前...

版本：v3.1Betasensor.getDeviceAltitude9+getDeviceAltitude(seaPressure:number,currentPressure:number):Promise<number>根据气压值获取海拔高度。系统能力：SystemCapability.Sensors.Sensor参数：参数名类型必填说明seaPressurenumber是海平面气压值，单位为hPa。currentPressurenumber是指定的气压值，单位为hPa。返回值：类型说明Promise<number>Promise对象，返回指定的气压值对应的海拔高度，单位为米。错误码：以下错...

版本：v3.1Betaohos.account.appAccount(应用帐号管理)更新时间:2023030317:21本模块提供应用帐号信息的添加、删除、修改和查询基础能力，并支持应用间鉴权和分布式数据同步功能。说明本模块首批接口从APIversion7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。导入模块importaccountappAccountfrom'ohos.account.appAccount';accountappAccount.createAppAccountManagercreateAppAccountManager():AppAcco...