讲师中心 微信公众号
AI工具推荐 视频效率加速

如何在 Android Fragment 中正确获取文件选择器返回的文件路径

陌雪大大_4681

陌雪大大_4681

发布时间:2026-06-03 09:02:02

|

992人浏览过

|

来源于php中文网

原创

如何在 Android Fragment 中正确获取文件选择器返回的文件路径

本文介绍在 Android 中使用现代 Activity Result API 替代已废弃的 onActivityResult,在 Fragment 内安全、可靠地获取用户通过文件选择器(ACTION_GET_CONTENT)选中的文件 URI 及其路径。

本文介绍在 android 中使用现代 activity result api 替代已废弃的 `onactivityresult`,在 fragment 内安全、可靠地获取用户通过文件选择器(`action_get_content`)选中的文件 uri 及其路径。

在 Android 开发中,自 AndroidX Activity 1.2.0 和 Fragment 1.3.0 起,传统的 startActivityForResult() 和 onActivityResult() 已被官方标记为 deprecated(弃用)。尤其在 Fragment 中直接重写 onActivityResult() 不仅存在生命周期不可靠、回调丢失等风险,更无法保证 requestCode 的唯一性和上下文一致性——这正是你遇到“Log 无输出”的根本原因:Fragment 的 onActivityResult() 在较新版本中不会被自动调用,系统回调默认只分发给宿主 Activity。

✅ 正确做法是采用 ActivityResultLauncher + registerForActivityResult() 这一声明式、生命周期感知的现代 API。它支持 Fragment 独立注册回调,无需手动管理请求码,且天然避免内存泄漏与回调丢失问题。

✅ 步骤一:在 Fragment 中声明并注册 ActivityResultLauncher

请将以下代码添加到你的 KorepetitoriuiPatvirtintiMokiniai Fragment 类中(建议放在类成员变量区及 onCreateView() 之前):

private ActivityResultLauncher<Intent> filePickerLauncher;

@Override
public void onCreate(@Nullable Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    // 注册文件选择结果监听器
    filePickerLauncher = registerForActivityResult(
        new ActivityResultContracts.StartActivityForResult(),
        result -> {
            if (result.getResultCode() == Activity.RESULT_OK) {
                Intent data = result.getData();
                if (data != null && data.getData() != null) {
                    Uri uri = data.getData();
                    // ⚠️ 注意:uri.getPath() 通常返回 content:// URI 的路径(如 /document/primary:xxx),不等于真实文件系统路径
                    Log.d("FilePicker", "Selected URI: " + uri.toString());

                    // ✅ 推荐:通过 ContentResolver 获取真实文件信息(如文件名、MIME 类型、输入流)
                    try {
                        String displayName = getDisplayNameFromUri(uri);
                        Log.d("FilePicker", "Display Name: " + displayName);

                        // 如需读取内容(例如上传),推荐使用 getContentResolver().openInputStream(uri)
                        // InputStream is = requireContext().getContentResolver().openInputStream(uri);
                    } catch (Exception e) {
                        Log.e("FilePicker", "Failed to resolve URI", e);
                    }
                }
            }
        }
    );
}

? getDisplayNameFromUri() 是一个辅助方法,用于从 content:// URI 安全提取文件名(避免直接依赖 .getPath()):

Android Adb Skill
Android Adb Skill

Android 开发调试技能,通过系统 ADB 工具操作 Android 设备。以下场景必须触发此技能:(1) 直接 ADB 操作——安装 APK、查看设备列表、抓取 logcat 日志、查看已安装应用、清除应用数据、截图、重启设备、拉取/推送文件、查看 CPU/内存/电池信息、adb shell 操作;(2)...

下载
private String getDisplayNameFromUri(Uri uri) {
    String displayName = null;
    Cursor cursor = null;
    try {
        String[] projection = {OpenableColumns.DISPLAY_NAME};
        cursor = requireContext().getContentResolver().query(uri, projection, null, null, null);
        if (cursor != null && cursor.moveToFirst()) {
            int columnIndex = cursor.getColumnIndexOrThrow(OpenableColumns.DISPLAY_NAME);
            displayName = cursor.getString(columnIndex);
        }
    } finally {
        if (cursor != null) cursor.close();
    }
    return displayName != null ? displayName : "unknown_file";
}

✅ 步骤二:在 Popup 按钮点击时启动文件选择器(关键修正)

你当前在 Adapter 的 onBindViewHolder 中通过 ((Activity) context).startActivityForResult(...) 启动意图——这是错误且危险的:

  • context 可能不是 Activity(如 Application Context);
  • startActivityForResult() 已弃用;
  • Fragment 无法接收该回调。

✅ 正确方式:将 ActivityResultLauncher 从 Fragment 传递至 Adapter,并在点击时调用 launcher.launch(intent)。

修改 Adapter 构造函数(添加 launcher 参数):

private final ActivityResultLauncher<Intent> fileLauncher;

public KorepetitoriuiPatvirtintiMokiniaiCardAdapter(
        ArrayList<KorepetitoriuiPatvirtintasMokinysKortele> list,
        Context context,
        ActivityResultLauncher<Intent> launcher) { // ← 新增参数
    this.list = list;
    this.context = context;
    this.fileLauncher = launcher; // ← 保存引用
}

修改 pasirinktiFaila.setOnClickListener:

pasirinktiFaila.setOnClickListener(v -> {
    Intent intent = new Intent(Intent.ACTION_GET_CONTENT);
    intent.setType("*/*"); // 或更精确类型,如 "application/pdf"
    intent.addCategory(Intent.CATEGORY_OPENABLE); // 强制可打开(推荐)
    fileLauncher.launch(intent); // ✅ 使用 launcher 启动,非 startActivityForResult
});

修改 Fragment 中创建 Adapter 的位置(onPostExecute 内):

// 在 onPostExecute 中,传入 this.filePickerLauncher
adapter = new KorepetitoriuiPatvirtintiMokiniaiCardAdapter(arrayList, getContext(), filePickerLauncher);

⚠️ 重要注意事项

  • ❌ 不要再使用 uri.getPath() 获取绝对文件路径:Android 10+(Scoped Storage)下 content:// URI 不对应真实文件系统路径,强行解析可能为空或抛异常。
  • ✅ 始终使用 ContentResolver 读取内容(如 openInputStream()),或通过 DocumentFile.fromSingleUri() 处理文档。
  • ? 若需上传文件,请勿尝试复制到应用私有目录再上传;直接流式上传 InputStream 更安全高效。
  • ? 测试时请确保目标设备/模拟器已授予存储权限(READ_EXTERNAL_STORAGE 在 Android 11+ 非必需,但部分旧 ROM 仍需)。

✅ 总结

传统方式 现代方式
startActivityForResult() + onActivityResult()(已弃用) registerForActivityResult() + ActivityResultLauncher(推荐)
Fragment 回调不可靠、易丢失 生命周期安全、Fragment 独立注册、类型安全
依赖 uri.getPath()(常失败) 使用 ContentResolver 安全访问文件元数据与流

迁移后,你的文件选择逻辑将稳定触发日志输出,并为后续上传、预览等操作打下坚实基础。

热门AI工具

更多
DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

相关专题

更多
android开发三大框架
android开发三大框架

android开发三大框架是XUtil框架、volley框架、ImageLoader框架。本专题为大家提供android开发三大框架相关的各种文章、以及下载和课程。

882

2023.08.14

android是什么系统
android是什么系统

Android是一种功能强大、灵活可定制、应用丰富、多任务处理能力强、兼容性好、网络连接能力强的操作系统。本专题为大家提供android相关的文章、下载、课程内容,供大家免费下载体验。

2567

2023.08.22

android权限限制怎么解开
android权限限制怎么解开

android权限限制可以使用Root权限、第三方权限管理应用程序、ADB命令和Xposed框架解开。详细介绍:1、Root权限,通过获取Root权限,用户可以解锁所有权限,并对系统进行自定义和修改;2、第三方权限管理应用程序,用户可以轻松地控制和管理应用程序的权限;3、ADB命令,用户可以在设备上执行各种操作,包括解锁权限;4、Xposed框架,用户可以在不修改系统文件的情况下修改应用程序的行为和权限。

4837

2023.09.19

android重启应用的方法有哪些
android重启应用的方法有哪些

android重启应用有通过Intent、PendingIntent、系统服务、Runtime等方法。本专题为大家提供Android相关的文章、下载、课程内容,供大家免费下载体验。

625

2023.10.18

Android语音播放功能实现方法
Android语音播放功能实现方法

实现方法有使用MediaPlayer实现、使用SoundPool实现两种。可以根据具体的需求选择适合的方法进行实现。想了解更多语音播放的相关内容,可以阅读本专题下面的文章。

924

2024.03.01

LLVM自定义Pass怎么写
LLVM自定义Pass怎么写

本专题聚焦LLVM自定义Pass开发,整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。

100

2026.09.30

LLVM RISC-V参数配置教程
LLVM RISC-V参数配置教程

本专题介绍LLVM对RISC-V基础ISA和扩展的支持方式,涵盖RV32、RV64、标准扩展、实验性扩展、厂商扩展、-menable-experimental-extensions和版本差异。

100

2026.09.30

LLVM IR中间表示入门指南
LLVM IR中间表示入门指南

本专题整理LLVM IR的核心概念,包括中间表示作用、模块结构、函数、基本块、SSA形式、类型系统和常见语法,帮助新手理解LLVM编译流程中的关键层。

80

2026.09.30

PDF转图片方法
PDF转图片方法

需要把 PDF 页面用于上传、预览、分享或图片归档时,PDF 转图片方法专题整理 JPG/PNG 格式选择、逐页导出、清晰度设置、批量下载和结果检查等流程,帮助用户稳定完成 PDF 图片化处理。

60

2026.09.30

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Excel 教程
Excel 教程

共162课时 | 43.9万人学习

Java 教程
Java 教程

共578课时 | 189.9万人学习

Uniapp从零开始实现新闻资讯应用
Uniapp从零开始实现新闻资讯应用

共64课时 | 9.5万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn