鸿蒙应用开发入门:ArkTS 和声明式 UI 的几个关键差异
从 Android 转鸿蒙,最容易踩的不是语言,是思维方式。这篇记录我从 Java/Kotlin 迁到 ArkTS 过程中,几个真正需要转变的地方。
ArkTS 不是 TypeScript
ArkTS 基于 TypeScript,但限制了不少特性:
不支持 any 和 unknown。所有变量必须明确类型。
不支持结构化类型。TS 里只要结构一样就能赋值,ArkTS 要求必须显式声明 implements。
不支持动态属性。obj[key] = value 这种写法不行,必须提前定义好属性。
不支持 eval、Function 构造器。出于安全考虑禁掉了。
这些限制一开始很别扭,但写久了会发现:编译期能查出来的问题变多了,运行时崩溃变少了。
声明式 UI 的核心是状态驱动
Android 里改 UI 是「找到控件,设置属性」:
textView.text = "新内容"
textView.visibility = View.VISIBLE
ArkTS 里是「改状态,框架自动更新」:
@Entry
@Component
struct Index {
@State message: string = '初始内容'
@State visible: boolean = true
build() {
Column() {
if (this.visible) {
Text(this.message)
.fontSize(20)
}
Button('改一下')
.onClick(() => {
this.message = '新内容'
this.visible = !this.visible
})
}
}
}
关键理解:你不是在「操作 UI」,而是在「描述 UI 应该长什么样」。数据变了,框架重新渲染。
这带来一个常见的坑:直接改变量不会触发刷新。
@State items: string[] = ['a', 'b']
// 错:这样不会刷新
this.items.push('c')
// 对:要重新赋值
this.items = [...this.items, 'c']
数组和对象的内容变化,ArkTS 检测不到,必须整体替换引用。
装饰器是重点
ArkTS 的状态管理全靠装饰器:
| 装饰器 | 作用 |
|---|---|
@State |
组件内部状态,变化触发自身刷新 |
@Prop |
父传子,单向同步 |
@Link |
父传子,双向同步 |
@Provide / @Consume |
跨层级传递,不用一层层传 |
@Observed / @ObjectLink |
对象内部属性变化也能监听 |
@StorageLink |
和应用级存储双向绑定 |
最容易混的是 @Prop 和 @Link:
@Prop:子组件改了不影响父组件(值拷贝)@Link:子组件改了父组件也变(引用传递)
@Component
struct Child {
@Link count: number // 双向
@Prop label: string // 单向
build() {
Button(`${this.label}: ${this.count}`)
.onClick(() => { this.count++ }) // 父组件的 count 也会变
}
}
页面路由的变化
Android 用 Intent 或 Navigation,鸿蒙用 router:
import router from '@ohos.router'
// 跳转
router.pushUrl({
url: 'pages/Detail',
params: { id: 123 }
})
// 接收参数
const params = router.getParams() as Record<string, Object>
const id = params['id']
// 返回
router.back()
注意 pushUrl 是压栈,replaceUrl 是替换。用错了会导致返回键行为不对。
页面要在 main_pages.json 里注册,漏了会白屏:
{
"src": [
"pages/Index",
"pages/Detail"
]
}
网络请求
鸿蒙用 @ohos.net.http:
import http from '@ohos.net.http'
async function fetchData(url: string): Promise<string> {
const httpRequest = http.createHttp()
try {
const resp = await httpRequest.request(url, {
method: http.RequestMethod.GET,
connectTimeout: 10000,
readTimeout: 10000
})
if (resp.responseCode === 200) {
return resp.result as string
}
throw new Error(`HTTP ${resp.responseCode}`)
} finally {
httpRequest.destroy()
}
}
必须调 destroy(),否则连接不释放,多次请求后会耗尽。
网络权限要在 module.json5 里声明:
{
"requestPermissions": [
{ "name": "ohos.permission.INTERNET" }
]
}
漏了会静默失败,不报错但请求发不出去——这个坑很难查。
数据持久化
轻量数据用 @ohos.data.preferences:
import preferences from '@ohos.data.preferences'
const pref = await preferences.getPreferences(context, 'my_store')
await pref.put('token', 'xxx')
await pref.flush()
const token = await pref.get('token', '')
必须 flush() 才落盘,只 put 不 flush 的话应用被杀就丢了。
关系型数据用 @ohos.data.relationalStore(RDB),API 和 SQLite 类似,但要经过 ResultSet 遍历。
打包和签名
鸿蒙的签名比 Android 严格。开发阶段用调试签名,发布要申请正式证书。
调试签名:DevEco Studio 会自动生成,直接在真机或模拟器上跑。
发布签名:
- 在 AppGallery Connect 创建应用
- 申请发布证书(.cer)和 Profile(.p7b)
- 在 DevEco 里配置签名信息
打包产物是 .hap,上架前还要打成 .app。
和 Android 对比的几个差异
| 维度 | Android | HarmonyOS |
|---|---|---|
| 语言 | Java / Kotlin | ArkTS |
| UI | XML + 命令式 / Compose | 声明式 |
| 进程模型 | 多进程自由 | 应用沙箱更严格 |
| 权限 | 运行时申请 | 部分权限需静态声明 |
| 后台 | Service / WorkManager | 受限,需申请长时任务 |
| 生态 | 成熟 | 建设中 |
后台任务限制最明显。鸿蒙对后台驻留管得很严,Android 那套「常驻 Service 保活」的思路完全行不通。要做定时任务得用「后台任务」API 并申请对应权限。
学习路径建议
- 先跑通 Hello World,熟悉 DevEco Studio 和项目结构
- 把一个页面的 UI 用声明式写一遍,理解状态驱动
- 接一个网络请求,把数据渲染成列表
- 加一个页面跳转,理解路由和参数传递
- 做本地存储,理解 Preferences 和 RDB
整个流程走一遍,基本就能上手了。剩下的都是 API 细节,查文档就行。
小结
从 Android 转鸿蒙,语法不是障碍,思维才是。核心转变是:从「操作控件」到「描述状态」。
最容易踩的三个坑:数组/对象直接改不刷新、权限漏声明静默失败、preferences.put 后忘了 flush。
这三个踩过一次就不会再犯,但第一次遇到时都很难查——因为没有报错,只是「没效果」。
- 点赞
- 收藏
- 关注作者
评论(0)