鸿蒙应用开发入门:ArkTS 和声明式 UI 的几个关键差异

举报
yd_271063030 发表于 2026/11/12 02:40:53 2026/11/12
【摘要】 从 Android 转鸿蒙,最容易踩的不是语言,是思维方式。这篇记录我从 Java/Kotlin 迁到 ArkTS 过程中,几个真正需要转变的地方。

从 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 会自动生成,直接在真机或模拟器上跑。

发布签名:

  1. 在 AppGallery Connect 创建应用
  2. 申请发布证书(.cer)和 Profile(.p7b)
  3. 在 DevEco 里配置签名信息

打包产物是 .hap,上架前还要打成 .app。

和 Android 对比的几个差异

维度 Android HarmonyOS
语言 Java / Kotlin ArkTS
UI XML + 命令式 / Compose 声明式
进程模型 多进程自由 应用沙箱更严格
权限 运行时申请 部分权限需静态声明
后台 Service / WorkManager 受限,需申请长时任务
生态 成熟 建设中

后台任务限制最明显。鸿蒙对后台驻留管得很严,Android 那套「常驻 Service 保活」的思路完全行不通。要做定时任务得用「后台任务」API 并申请对应权限。

学习路径建议

  1. 先跑通 Hello World,熟悉 DevEco Studio 和项目结构
  2. 把一个页面的 UI 用声明式写一遍,理解状态驱动
  3. 接一个网络请求,把数据渲染成列表
  4. 加一个页面跳转,理解路由和参数传递
  5. 做本地存储,理解 Preferences 和 RDB

整个流程走一遍,基本就能上手了。剩下的都是 API 细节,查文档就行。

小结

从 Android 转鸿蒙,语法不是障碍,思维才是。核心转变是:从「操作控件」到「描述状态」。

最容易踩的三个坑:数组/对象直接改不刷新、权限漏声明静默失败、preferences.put 后忘了 flush。

这三个踩过一次就不会再犯,但第一次遇到时都很难查——因为没有报错,只是「没效果」。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。