如何在 Android Fragment 中正确获取文件选择器返回的文件路径-java教程-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);
                    }
                }
            }
        }
    );
}</intent>

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

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; // ← 保存引用
}</intent></korepetitoriuipatvirtintasmokinyskortele></intent>

修改 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 安全访问文件元数据与流

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