Android registerForActivityResult 详解

发布时间：2026/10/15 2:05:21

Android registerForActivityResult 详解
文章目录一、背景二、基本用法示例启动 Activity 并获取回传数据示例申请单个权限三、核心概念执行流程四、注册时机五、常用 Contract5.1 StartActivityForResult5.2 RequestPermission / RequestMultiplePermissions5.3 GetContent / GetMultipleContents5.4 TakePicture / CaptureVideo5.4 CreateDocument / OpenDocument5.5 内置 Contract 汇总六、自定义 Contract示例封装 Activity 跳转示例多选图片七、新旧对比一、背景在 Android 开发中从当前 Activity 发起一个操作并在完成后获取返回结果是常见的需求典型场景包括跳转到另一个 Activity等它关闭后获取回传数据向用户申请运行时权限从相册或文件管理器中选择文件调用系统相机拍照在 AndroidX Activity 1.2.0 之前这些场景依赖多套不同的 APIActivity 跳转用startActivityForResult/onActivityResult权限申请用requestPermissions/onRequestPermissionsResult。这些 API 存在一些共性问题代码分散发起请求和接收结果的逻辑分布在不同的方法中不利于阅读和维护。requestCode 管理繁琐需要手动维护整型常量多模块协作时容易产生冲突。回调膨胀所有返回结果汇聚到同一个回调方法中业务扩展后分支逻辑不断膨胀。API 风格不统一Activity 跳转和权限申请使用完全不同的回调机制。AndroidX 引入了registerForActivityResult来解决这些问题将所有发起—返回模式统一为一套声明式 API。二、基本用法registerForActivityResult的调用形式为ActivityResultLauncherIlauncherregisterForActivityResult(ActivityResultContractI,Ocontract,ActivityResultCallbackOcallback);// 触发操作launcher.launch(input);与旧 API 最直观的区别是不再需要requestCode也不再需要重写任何回调方法。发起和接收结果在同一个代码块中完成声明。示例启动 Activity 并获取回传数据ActivityResultLauncherIntentlauncherregisterForActivityResult(newActivityResultContracts.StartActivityForResult(),result-{if(result.getResultCode()RESULT_OKresult.getData()!null){Stringvalueresult.getData().getStringExtra(key);}});launcher.launch(newIntent(this,SecondActivity.class));示例申请单个权限ActivityResultLauncherStringlauncherregisterForActivityResult(newActivityResultContracts.RequestPermission(),granted-{if(granted){// 授权成功}else{// 授权被拒绝}});launcher.launch(Manifest.permission.CAMERA);可以看到Activity 跳转和权限申请现在使用完全相同的 API 风格代码结构一致。三、核心概念registerForActivityResult围绕三个核心概念构建概念类型职责ContractActivityResultContractI, O定义操作的类型输入 I 是什么输出 O 是什么以及如何生成启动 Intent、如何解析返回结果CallbackActivityResultCallbackO结果返回后的处理逻辑参数 O 的类型由 Contract 决定LauncherActivityResultLauncherI通过registerForActivityResult获得的启动器调用launch(I)触发操作执行流程launch(输入 I) ↓ Contract.createIntent(Context, I) → 生成 Intent → 打开目标组件 ↓ 目标组件关闭 ↓ Contract.parseResult(int, Intent) → 将返回数据解析为类型 O ↓ Callback.onActivityResult(O) → 执行业务逻辑四、注册时机registerForActivityResult必须在 Activity 生命周期进入STARTED状态之前调用。官方推荐在onCreate中进行注册。// 正确OverrideprotectedvoidonCreate(BundlesavedInstanceState){super.onCreate(savedInstanceState);launcherregisterForActivityResult(...);}// 错误privatevoidonButtonClick(){launcherregisterForActivityResult(...);// 此时生命周期已过 STARTED}原因当 Activity 因系统内存回收被销毁后重建时只会重新执行onCreate。如果在onCreate中注册重建时会自动重新注册之前在途的请求结果也不会丢失。若在事件回调中注册重建后注册缺失结果将无法兑现。五、常用 ContractAndroidX 内置了多种 Contract覆盖常见场景。5.1 StartActivityForResult启动一个 Activity 并接收返回结果。最常用的 Contract。ActivityResultLauncherIntentlauncherregisterForActivityResult(newActivityResultContracts.StartActivityForResult(),result-{if(result.getResultCode()RESULT_OKresult.getData()!null){Stringdataresult.getData().getStringExtra(extra_key);}});输入Intent输出ActivityResult封装了resultCode和data5.2 RequestPermission / RequestMultiplePermissions申请单个或多个运行时权限。// 单个权限ActivityResultLauncherStringsinglePermissionLauncherregisterForActivityResult(newActivityResultContracts.RequestPermission(),granted-{/* granted 为 Boolean */});// 多个权限ActivityResultLauncherString[]multiPermissionLauncherregisterForActivityResult(newActivityResultContracts.RequestMultiplePermissions(),result-{/* result 为 MapString, Boolean */});RequestPermission输入String权限名输出Boolean。RequestMultiplePermissions输入String[]权限名数组输出MapString, Boolean。5.3 GetContent / GetMultipleContents从系统文件选择器中选择文件。// 单选ActivityResultLauncherStringlauncherregisterForActivityResult(newActivityResultContracts.GetContent(),uri-{/* uri 为 Uri? */});launcher.launch(image/*);// MIME 类型launcher.launch(video/*);launcher.launch(*/*);// 任意文件// 多选ActivityResultLauncherStringmultiLauncherregisterForActivityResult(newActivityResultContracts.GetMultipleContents(),uris-{/* uris 为 ListUri */});5.4 TakePicture / CaptureVideo调用系统相机拍照或录像。// 拍照ActivityResultLauncherUritakePictureLauncherregisterForActivityResult(newActivityResultContracts.TakePicture(),success-{/* success 为 Boolean */});// 录像ActivityResultLauncherUricaptureVideoLauncherregisterForActivityResult(newActivityResultContracts.CaptureVideo(),success-{/* success 为 Boolean */});// 需要先准备输出文件的 UriUrioutputUri/* 由 FileProvider 生成 */;takePictureLauncher.launch(outputUri);5.4 CreateDocument / OpenDocument创建或打开文档。// 创建新文件ActivityResultLauncherStringcreateLauncherregisterForActivityResult(newActivityResultContracts.CreateDocument(text/plain),uri-{/* uri 为 Uri? */});createLauncher.launch(文件名.txt);// 打开已有文件ActivityResultLauncherString[]openLauncherregisterForActivityResult(newActivityResultContracts.OpenDocument(),uri-{/* uri 为 Uri? */});openLauncher.launch(newString[]{image/*,application/pdf});5.5 内置 Contract 汇总Contract输入输出用途RequestPermissionStringBoolean单个权限申请RequestMultiplePermissionsString[]MapString, Boolean多个权限申请StartActivityForResultIntentActivityResult通用 Activity 启动StartIntentSenderForResultIntentSenderRequestActivityResult启动 IntentSenderGetContentStringMIMEUri?选择单个文件GetMultipleContentsStringMIMEListUri选择多个文件TakePictureUriBoolean拍照并保存TakePicturePreview无Bitmap?拍照获取缩略图CaptureVideoUriBoolean录像并保存CreateDocumentStringMIMEUri?创建文件OpenDocumentString[]MIMEUri?打开文件OpenDocumentTreeUri?Uri?选择目录PickContact无Uri?选择联系人六、自定义 Contract当内置 Contract 无法满足需求时可以通过继承ActivityResultContractI, O实现自定义 Contract。需要覆写两个方法方法调用时机作用createIntent(Context, I)launch()调用时根据输入 I 生成启动目标组件的 IntentparseResult(int, Intent)目标组件关闭时将 resultCode 和 Intent 解析为输出 O示例封装 Activity 跳转将启动某个 Activity 并传递字符串的逻辑封装为 Contract调用方无需直接构造 IntentclassOpenTargetActivityContractextendsActivityResultContractString,ActivityResult{privatefinalClass?extendsActivitytargetClass;publicOpenTargetActivityContract(Class?extendsActivitytargetClass){this.targetClasstargetClass;}NonNullOverridepublicIntentcreateIntent(NonNullContextcontext,Stringinput){IntentintentnewIntent(context,targetClass);intent.putExtra(payload,input);returnintent;}NonNullOverridepublicActivityResultparseResult(intresultCode,NullableIntentdata){returnnewActivityResult(resultCode,data);}}// 使用ActivityResultLauncherStringlauncherregisterForActivityResult(newOpenTargetActivityContract(TargetActivity.class),result-{if(result.getResultCode()RESULT_OKresult.getData()!null){Stringbackresult.getData().getStringExtra(result);}});launcher.launch(要传递的内容);示例多选图片系统默认的GetMultipleContents已支持多选这里通过自定义 Contract 来演示实现思路classPickMultipleImagesContractextendsActivityResultContractVoid,ListUri{NonNullOverridepublicIntentcreateIntent(NonNullContextcontext,Voidinput){IntentintentnewIntent(Intent.ACTION_PICK);intent.setType(image/*);intent.putExtra(Intent.EXTRA_ALLOW_MULTIPLE,true);returnintent;}NonNullOverridepublicListUriparseResult(intresultCode,NullableIntentdata){if(resultCodeRESULT_OKdata!null){ListUriurisnewArrayList();ClipDataclipDatadata.getClipData();if(clipData!null){for(inti0;iclipData.getItemCount();i){uris.add(clipData.getItemAt(i).getUri());}}elseif(data.getData()!null){uris.add(data.getData());}returnuris;}returnCollections.emptyList();}}七、新旧对比对比维度旧 APIregisterForActivityResultActivity 回传startActivityForResultonActivityResultStartActivityForResultContract权限申请requestPermissionsonRequestPermissionsResultRequestPermissionContract文件选择手动构造 Intent onActivityResultGetContent/OpenDocumentContract代码组织发起和回调分离在两个方法在同一位置声明requestCode手动管理整型常量无类型安全回调参数无编译期约束泛型保证类型匹配可扩展性需覆写 Activity/Fragment 回调方法实现自定义 Contract

相关新闻

gnuplot入门指南：跨平台安装与数据可视化实战

gnuplot入门指南：跨平台安装与数据可视化实战

1. 为什么我选择从gnuplot开始画图如果你和我一样，经常需要处理数据、生成图表，但又不想被那些庞大、臃肿的“现代”绘图软件（比如某些需要在线登录、订阅付费的桌面应用）所束缚，那么gnuplot绝对是一个值得你花时间了解…

2026/10/15 2:04:12 阅读更多 →
性能测试实战指南：从核心概念到IDEA集成与工具选型

性能测试实战指南：从核心概念到IDEA集成与工具选型

1. 项目概述：性能测试与IDEA的跨界碰撞最近在技术社区里看到一个挺有意思的讨论，标题是“最全性能测试 —— 性能测试概念、性能测试主流工具！，2024年最新IDEA太强悍了”。初看之下，这像是一个“标题党”，把…

2026/10/15 2:04:21 阅读更多 →
辐射防护原理与电子设备抗干扰技术解析

辐射防护原理与电子设备抗干扰技术解析

1. 地面能否有效屏蔽辐射？物理原理与实测分析当核电站事故或医疗放射源泄漏发生时，普通民众最关心的问题往往是：躲在地面以下能否有效减少辐射暴露？这个看似简单的问题背后涉及复杂的辐射物理学原理。作为从业十余年的核安全工程师…

2026/10/14 20:57:53 阅读更多 →

最新新闻

暑期实训Python第二次课：列表字典、循环函数与成绩管理项目实战

暑期实训Python第二次课：列表字典、循环函数与成绩管理项目实战

/* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/15 2:05:13 阅读更多 →
alien-signals 响应式内核高频状态吞吐演进周报：零 GC 损耗与事务批量调度

alien-signals 响应式内核高频状态吞吐演进周报：零 GC 损耗与事务批量调度

在现代富交互前端应用中，响应式系统的性能边界直接决定了整个应用的体验天花板。无论是双 11 大促实时秒杀行情、高频 WebSocket 资产数据流，还是复杂画板与游戏引擎的坐标同步，传统基于 Proxy 动态 Set 依赖集合的响应式系统（如…

2026/10/15 2:05:13 阅读更多 →
OA办公系统源码部署与二次开发实战：环境搭建、审批流调试与避坑指南

OA办公系统源码部署与二次开发实战：环境搭建、审批流调试与避坑指南

简介：这是一套可直接运行测试的OA办公系统源码，基于.NET框架开发，面向需要搭建企业协同办公平台的技术团队与开发者。系统覆盖签发管理、公文起草、发文办理、收文办理、文件传阅、公文校核、档案管理、日程安排、网络会议、部门管理等十余个…

2026/10/15 2:05:13 阅读更多 →
门店 AI 落地到底有哪几条路？6 类场景的可行性、数据门槛与成本拆解

门店 AI 落地到底有哪几条路？6 类场景的可行性、数据门槛与成本拆解

结论先行：门店 AI 落地目前有 6 条可执行路径，其中 3 条对中小门店已经具备性价比；决定能不能做的从来不是模型有多强，而是数据够不够。先数数据、再选场景、最后才选模型——顺序错了，投入大概率收不回来。一、6 类场…

2026/10/15 2:05:13 阅读更多 →
学报投稿AI率要求多少？普刊和核心期刊AIGC标准对比

学报投稿AI率要求多少？普刊和核心期刊AIGC标准对比

最近被问得最多的问题：期刊没说要查AIGC，我还需要自己查吗？答案是需要。 AI率不是“用了AI才有”的东西。综述、总结这类写法高度模板化的段落，即使全程手写，也经常被判出20%-30%的AIGC疑似度。 每个期刊的AIGC率要求…

2026/10/15 2:05:13 阅读更多 →
PHPStan 从 1.x 升级到 2.0 完整指南：配置迁移、规则变化与扩展开发适配（object-enumerator 项目实践）

PHPStan 从 1.x 升级到 2.0 完整指南：配置迁移、规则变化与扩展开发适配（object-enumerator 项目实践）

开发工具 【免费下载链接】object-enumerator Traverses array structures and object graphs to enumerate all referenced objects 项目地址： https://gitcode.com/gh_mirrors/ob/object-enumerator 点击查看 免费下载 本篇指南以 PHPStan 官方升级文档&#xff…

2026/10/15 2:04:13 阅读更多 →

日新闻

Docker Compose 容器化部署 ChirpStack LoRaWAN 网络服务器实战

Docker Compose 容器化部署 ChirpStack LoRaWAN 网络服务器实战

1. 为什么选择容器化方式部署 LoRa 网络服务LoRa 物联网项目落地时，网络服务器是整个链路的核心枢纽。它负责接收网关上报的数据包、完成去重与解密、再把有效载荷分发给上层应用。早期大家习惯把网络服务器直接装在物理机上，依赖一堆系统库和特定版本的…

2026/10/15 0:00:46 阅读更多 →
共享LLM服务下的跨模型自动扩缩容：Kubernetes实战与避坑指南

共享LLM服务下的跨模型自动扩缩容：Kubernetes实战与避坑指南

1. 共享推理服务里，扩缩容到底难在哪做过大模型推理服务部署的人，大概都经历过这样的场景：一个团队共用一套推理集群，A 业务跑的是 7B 的小模型，B 业务跑的是 72B 的大模型，C 业务白天流量高、晚上几乎归零…

2026/10/15 0:00:46 阅读更多 →
Systemd 启动阶段根文件系统只读之谜：fstab 与 remount-fs 服务深度解析

Systemd 启动阶段根文件系统只读之谜：fstab 与 remount-fs 服务深度解析

1. 引子：一次内核恐慌引发的追查先从一个真实场景说起。某次我给一台老旧的嵌入式设备折腾系统裁减，为了把启动时间压进两秒以内，我手贱地把一串自认为“没用”的 systemd 服务给 disable 了，其中就包括systemd-remount-fs.servic…

2026/10/15 0:00:46 阅读更多 →

周新闻

流感时间序列预测实战：ARIMA/LSTM全流程拆解与避坑指南

流感时间序列预测实战：ARIMA/LSTM全流程拆解与避坑指南

简介：基于 ARIMA、LSTM、Transformer 等模型的流感时间序列预测 Python 源码，面向计算机相关专业课程设计与期末大作业学生，以及项目实战学习者。内容覆盖预处理、平稳性检验、定阶、残差分析、多模型对比预测的完整时序建模流程，…

2026/10/14 3:30:28 阅读更多 →
影刀RPA新手教程：键盘模拟输入实战——输入文本与模拟按键的区别

影刀RPA新手教程：键盘模拟输入实战——输入文本与模拟按键的区别

影刀RPA新手教程：键盘模拟输入实战——输入文本与模拟按键的区别 做影刀RPA自动化，十个新手有八个栽在"往输入框里填东西"这件事上：要么填不进去，要么填了一半，要么直接把原来内容追加在后面。这背后的根因&…

2026/10/14 16:30:29 阅读更多 →
影刀RPA新手教程：阅文起点小说数据采集实战——书籍信息与章节内容

影刀RPA新手教程：阅文起点小说数据采集实战——书籍信息与章节内容

影刀RPA新手教程：阅文起点小说数据采集实战——书籍信息与章节内容 1. 认识影刀：什么场景该用RPA采小说数据 起点中文网的页面结构相对稳定——分类榜单、书籍详情、章节内容三块独立页面，跳转链路清晰。这种场景非常适合影刀自动化&#x…

2026/10/14 3:29:58 阅读更多 →

月新闻

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

/* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/15 0:14:36 阅读更多 →
Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

/* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/14 22:45:47 阅读更多 →
黑夜航拍船只数据集训练YOLOV5模型全流程解析

黑夜航拍船只数据集训练YOLOV5模型全流程解析

/* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/14 7:53:34 阅读更多 →