HarmonyOS 鸿蒙Next官方文档中的参数表格里的类型

HarmonyOS 鸿蒙Next官方文档中的参数表格里的类型 如下图

cke_338.png

这种类型一共有多少种,有文档专门介绍这个类型都有什么吗


更多关于HarmonyOS 鸿蒙Next官方文档中的参数表格里的类型的实战教程也可以访问 https://www.itying.com/category-93-b0.html

8 回复

背景知识:

在ArkTs中基础类型有:

  1. 数字类型(Number Types)

    • let age: number = 25;
  2. 字符串类型(String)

    • let firstName: string = 'zhangsan';
  3. 布尔类型(Boolean)

    • let isActive: boolean = true/false;
  4. 数组类型(Array)

    • let numbers: number[] = [1, 2, 3, 4, 5];
  5. 元组类型(Tuple)

    • let userInfo: [string, number, boolean] = ['John', 30, true];
  6. 枚举类型(Enum)

enum Direction {
    Up,      // 0
    Down,    // 1
    Left,    // 2
    Right    // 3
}

上图中写的是 MakeCallOptions 是一个对象类型。

cke_36145.png

参照:MakeCallOptions

注意:一般这种有超链接的可以直接点击过去查看参数属性。

更多关于HarmonyOS 鸿蒙Next官方文档中的参数表格里的类型的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


这个“类型”其实就是:

ArkTS / TypeScript 类型定义

鸿蒙官方文档里的参数表:

  • string
  • number
  • boolean
  • Array
  • Promise
  • Callback
  • Want
  • Context
  • BusinessError
  • xxxOptions
  • xxxInfo
  • xxxResult

这些本质上都是:

ArkTS 类型

或者:

HarmonyOS SDK 自定义对象类型

你截图里的 MakeCallOptions 是什么?

例如:

makeCall(phoneNumber: string, options?: MakeCallOptions)

这里:

MakeCallOptions

不是基础类型。

而是:

一个接口(interface)/ 类型定义

点进去一般会看到:

interface MakeCallOptions {
  accountId?: number
  videoState?: number
}

类似这样。


你问“这种类型一共有多少种”

严格来说:

没有固定数量

因为:

HarmonyOS 每个 Kit 都会定义自己的类型。

比如:

  • ArkUI
  • AbilityKit
  • TelephonyKit
  • MediaKit
  • LocationKit

都会有大量:

xxxOptions
xxxInfo
xxxResult
xxxConfig
xxxCallback

类型。

总量非常大。


官方其实没有一个“总类型大全”

因为:

类型是分散在各个 Kit 文档中的

例如:

电话服务

MakeCallOptions
CallState
DialParams

相机

CameraPosition
PhotoProfile
PreviewOutput

网络

HttpRequestOptions
BusinessError

但官方有“类型定义”的规律

你会发现大多数类型命名都类似:

类型后缀 含义
Options 配置参数
Info 信息对象
Result 返回结果
Callback 回调
Config 配置
Context 上下文
Params 参数
Data 数据
Event 事件
State 状态
Manager 管理器

最核心的其实就两大类

1. 基础类型(ArkTS/TS)

例如:

string
number
boolean
object
Array<T>
Promise<T>
Map
Set

这些是:

TypeScript 原生类型

2. HarmonyOS SDK 类型

例如:

Want
BusinessError
UIContext
AbilityContext

这些是:

鸿蒙SDK自己定义的类型

最推荐的查看方式(非常重要)

方法1:直接点蓝色类型名(推荐)

你截图里:

MakeCallOptions

蓝色可点击。

点进去:

就会进入:

该类型定义页

官方文档就是这么设计的。


方法2:查看 .d.ts 声明文件(高级开发推荐)

DevEco 安装后:

SDK 内部其实全是:

.d.ts

声明文件。

例如:

api/@kit.TelephonyKit.d.ts

里面会有:

export interface MakeCallOptions

这才是真正完整定义。


方法3:IDE 跳转(最方便)

在 DevEco Studio:

MakeCallOptions

按:

Ctrl + 鼠标左键

或者:

Ctrl + B

直接跳类型定义。

这才是鸿蒙开发最常用方式。


你可能还会看到这些类型

联合类型

string | undefined

表示:

可能为空

泛型

Array<string>
Promise<Result>

回调类型

AsyncCallback<string>

枚举类型

AudioState
NetworkType

一个很关键的认知

鸿蒙官方文档:

本质就是 TypeScript API 文档

因为 ArkTS 本身就是:

TypeScript 超集

所以:

你学鸿蒙 API,

本质也在学:

TypeScript 类型系统

一句话总结

你截图里的:

MakeCallOptions

属于:

HarmonyOS SDK 自定义类型

不是基础类型。

这类类型没有统一总表,而是:

分散定义在各个 Kit 的 API 文档和 .d.ts 声明文件中

最推荐:

直接点击类型名查看定义

或者:

在 DevEco Studio 里 Ctrl+点击跳转

这是鸿蒙开发最标准的查类型方式。

ArkTS基于TypeScript。如果就是入门练习,可以在TS strict模式下练习。
ArkTS关于类型,介绍比较简单,本身也不多。《类型》

也有人总结:《arkts有几种数据类型》

这个没有专门的文档介绍的,我给你简单说一下吧。一般来说,API 文档里的类型分两类:

一种是 ArkTS(鸿蒙开发语言)的原生类型,比如你截图里的 string 就属于这一类:

string:字符串

number:数字(含整数、浮点数)

boolean:布尔值(true/false)

Array<T>:数组(比如 string[]、number[])

object:通用对象

null / undefined

还有枚举、联合类型(比如 string | number)、泛型等

详细的,你参考这个文档

ArkTS语言介绍-学习ArkTS语言-基础入门 - 华为HarmonyOS开发者

第二种就是API 自定义的类型

就是你截图里的 MakeCallOptions 这种,它们是某个 API 模块自己定义的结构体 / 接口类型,只在这个模块里用。

每个 API 模块(比如 @ohos.telephony.call、@ohos.web.webview)都会定义自己的专属类型

比如 MakeCallOptions 是 call 模块为 makeCall 接口定义的参数结构体

这类类型没有全局总数,每个模块都可能新增,所以没有 “总共有多少种” 的说法。每个 API 模块的文档里,都会单独列出它的自定义类型

您好,关于string等基础类型的介绍在ArkTS开发文档里有:

https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/introduction-to-arkts

像那些MakeCallOptions等都属于基础类型实际应用里的名称,例如它就是某个自定义的class类而已。

你不必刻意学习某个类型到底是什么结构,只需要用的时候按照开发文档里的参数使用就行了。

官方文档参数表格中的“类型”字段,指该参数在ArkTS(鸿蒙Next应用开发语言)中允许的数据类型。常见类型包括:string(字符串)、number(数字)、boolean(布尔)、ObjectArrayundefinednull,以及鸿蒙特有的Resource(资源引用)、ImageSource(图片源)等。类型名称对应TypeScript语法,用于约束输入值的格式和范围。

HarmonyOS Next 文档里参数表格中的类型,并没有一个“一共多少种”的固定总数——因为类型是随 API 不断扩展的,每个模块会定义专属的类型,但基础/通用类型的集合是有限的。
官方有专门的文档介绍通用类型:在 HarmonyOS Next API参考 的“通用参数类型”“Promise与Callback”或“接口/类型”章节,会集中说明 stringnumberbooleanArray<T>Promise<T>Callback<T>BusinessErrorErrorCallback 等基础与通用类型。某些模块还会有自己的枚举、接口,这些一般随模块自身的 API 说明呈现。
建议直接查看对应 API 参考页的“概述”或左侧目录的“数据类型”部分,可以快速定位当前可用类型及说明。

回到顶部