原生移动开发 / 系统课时

页面数据传递

页面数据传递

页面跳转往往还要携带参数,并在目标页面处理完成后把结果带回来源页。本课用 Intent Extra、Bundle 和 Activity Result API 串起完整往返流程,同时说明适合传什么、不适合传什么。

学习目标

  • 能使用 Intent Extra 和 Bundle 向目标 Activity 传递简单数据
  • 能在目标 Activity 中安全读取传入参数
  • 能通过 Activity Result API 把结果返回给来源 Activity

使用 Extra 传递简单参数

Intent Extra 适合携带字符串、数字、布尔值以及轻量的 Parcelable 等数据。发送方用键值对写入,接收方使用相同键读取。键名最好集中定义,避免两端拼写不一致。

片段示例:下面代码假设从 UserActivity 打开 EditUserActivity。

kotlin
val intent = Intent(this, EditUserActivity::class.java).apply {
    // 只携带目标页真正需要的轻量参数。
    putExtra("user_id", 42L)
    putExtra("user_name", "Ada")
}
startActivity(intent)

预期结果:

text
EditUserActivity 启动,并可从自身 intent 中读取 user_id=42、user_name=Ada。

接收端要为缺失参数准备默认值或显式判空,不能假设每次启动都一定来自同一个页面。

kotlin
val userId = intent.getLongExtra("user_id", -1L)
val userName = intent.getStringExtra("user_name")

// 缺少必要参数时尽早停止,避免继续使用无效状态。
if (userId == -1L || userName == null) {
    finish()
}

预期结果:

text
参数完整:继续显示编辑页面。
参数缺失:结束当前 Activity,避免继续使用无效数据。

Bundle 适合组织一组相关参数

Bundle 本质上也是键值容器。参数较多、需要整体传递时,可以先放入 Bundle,再作为一个 Extra 交给目标页面。这样能把一组相关数据集中管理,但不会改变跨 Activity 传输的大小限制。

片段示例:发送方把同一业务上下文中的参数收进一个 Bundle。

kotlin
val args = Bundle().apply {
    putLong("user_id", 42L)
    putString("source", "profile")
}

val intent = Intent(this, EditUserActivity::class.java).apply {
    // 用一个键携带整组相关参数,接收端再统一解包。
    putExtra("args", args)
}
startActivity(intent)

预期结果:

text
EditUserActivity 启动,可通过 getBundleExtra("args") 取得同一组参数。

页面之间不要直接传大图片、大数组或完整数据库结果。Activity 间数据过大可能触发 TransactionTooLargeException。较大的内容应传 ID、URI 或文件位置,让目标页面自行加载。

使用 Activity Result API 返回结果

传统的 startActivityForResult() 与 onActivityResult() 已被 AndroidX Activity Result API 取代。新代码可由来源 Activity 注册结果回调,目标 Activity 再通过 setResult() 返回结果。

片段示例:来源页使用 ActivityResultContracts.StartActivityForResult。相关成员应在 Activity 创建阶段注册,而不是点击后临时注册。

kotlin
private val editUserLauncher =
    registerForActivityResult(ActivityResultContracts.StartActivityForResult()) { result ->
        // 只有 RESULT_OK 才读取目标页返回的数据。
        if (result.resultCode == Activity.RESULT_OK) {
            val name = result.data?.getStringExtra("updated_name")
            Toast.makeText(this, "更新为:$name", Toast.LENGTH_SHORT).show()
        }
    }

private fun openEditor() {
    val intent = Intent(this, EditUserActivity::class.java)
    editUserLauncher.launch(intent)
}

目标页保存完成后返回数据:

kotlin
private fun finishWithResult() {
    // 返回值仍通过 Intent Extra 携带给来源页。
    val resultIntent = Intent().putExtra("updated_name", "Grace")
    setResult(Activity.RESULT_OK, resultIntent)
    finish()
}

预期结果:

text
来源页打开 EditUserActivity。
目标页返回 RESULT_OK 后关闭。
来源页收到 updated_name=Grace,并显示“更新为:Grace”。

Activity 页面参数与结果返回数据流

选择传值方式时看数据生命周期

Extra 和 Bundle 都用于一次页面跳转中的轻量参数;Bundle 只是更方便地组织一组值。Activity Result API 解决的是“目标页面处理完成后,再把结果交回来源页”的反向通信问题,三者职责并不冲突。

如果数据需要被多个页面长期共享,或页面可能被系统重建,就不应把 Intent 当作应用级状态仓库。应根据场景使用 ViewModel、持久化存储或仓库层保存状态,而 Intent 只携带能够定位这些数据的最小信息。

实际开发时先问两个问题:数据是单向传给目标页,还是处理后还要返回;数据是少量参数,还是较大业务对象。前者决定使用 Extra/Bundle 还是 Activity Result,后者决定是否只传 ID 或 URI。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

页面数据传递

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通