原生移动开发 / 系统课时
页面数据传递
页面数据传递
页面跳转往往还要携带参数,并在目标页面处理完成后把结果带回来源页。本课用 Intent Extra、Bundle 和 Activity Result API 串起完整往返流程,同时说明适合传什么、不适合传什么。
学习目标
- 能使用 Intent Extra 和 Bundle 向目标 Activity 传递简单数据
- 能在目标 Activity 中安全读取传入参数
- 能通过 Activity Result API 把结果返回给来源 Activity
使用 Extra 传递简单参数
Intent Extra 适合携带字符串、数字、布尔值以及轻量的 Parcelable 等数据。发送方用键值对写入,接收方使用相同键读取。键名最好集中定义,避免两端拼写不一致。
片段示例:下面代码假设从 UserActivity 打开 EditUserActivity。
val intent = Intent(this, EditUserActivity::class.java).apply {
// 只携带目标页真正需要的轻量参数。
putExtra("user_id", 42L)
putExtra("user_name", "Ada")
}
startActivity(intent)预期结果:
EditUserActivity 启动,并可从自身 intent 中读取 user_id=42、user_name=Ada。接收端要为缺失参数准备默认值或显式判空,不能假设每次启动都一定来自同一个页面。
val userId = intent.getLongExtra("user_id", -1L)
val userName = intent.getStringExtra("user_name")
// 缺少必要参数时尽早停止,避免继续使用无效状态。
if (userId == -1L || userName == null) {
finish()
}预期结果:
参数完整:继续显示编辑页面。
参数缺失:结束当前 Activity,避免继续使用无效数据。Bundle 适合组织一组相关参数
Bundle 本质上也是键值容器。参数较多、需要整体传递时,可以先放入 Bundle,再作为一个 Extra 交给目标页面。这样能把一组相关数据集中管理,但不会改变跨 Activity 传输的大小限制。
片段示例:发送方把同一业务上下文中的参数收进一个 Bundle。
val args = Bundle().apply {
putLong("user_id", 42L)
putString("source", "profile")
}
val intent = Intent(this, EditUserActivity::class.java).apply {
// 用一个键携带整组相关参数,接收端再统一解包。
putExtra("args", args)
}
startActivity(intent)预期结果:
EditUserActivity 启动,可通过 getBundleExtra("args") 取得同一组参数。页面之间不要直接传大图片、大数组或完整数据库结果。Activity 间数据过大可能触发 TransactionTooLargeException。较大的内容应传 ID、URI 或文件位置,让目标页面自行加载。
使用 Activity Result API 返回结果
传统的 startActivityForResult() 与 onActivityResult() 已被 AndroidX Activity Result API 取代。新代码可由来源 Activity 注册结果回调,目标 Activity 再通过 setResult() 返回结果。
片段示例:来源页使用 ActivityResultContracts.StartActivityForResult。相关成员应在 Activity 创建阶段注册,而不是点击后临时注册。
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)
}目标页保存完成后返回数据:
private fun finishWithResult() {
// 返回值仍通过 Intent Extra 携带给来源页。
val resultIntent = Intent().putExtra("updated_name", "Grace")
setResult(Activity.RESULT_OK, resultIntent)
finish()
}预期结果:
来源页打开 EditUserActivity。
目标页返回 RESULT_OK 后关闭。
来源页收到 updated_name=Grace,并显示“更新为:Grace”。
选择传值方式时看数据生命周期
Extra 和 Bundle 都用于一次页面跳转中的轻量参数;Bundle 只是更方便地组织一组值。Activity Result API 解决的是“目标页面处理完成后,再把结果交回来源页”的反向通信问题,三者职责并不冲突。
如果数据需要被多个页面长期共享,或页面可能被系统重建,就不应把 Intent 当作应用级状态仓库。应根据场景使用 ViewModel、持久化存储或仓库层保存状态,而 Intent 只携带能够定位这些数据的最小信息。
实际开发时先问两个问题:数据是单向传给目标页,还是处理后还要返回;数据是少量参数,还是较大业务对象。前者决定使用 Extra/Bundle 还是 Activity Result,后者决定是否只传 ID 或 URI。