MusicFree在比亚迪车机Android 10上的存储访问问题解决方案

童云然Supplanter

于 2025-06-19 09:23:55 发布

阅读量302

点赞数 5

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_07401/article/details/148757783

MusicFree在比亚迪车机Android 10上的存储访问问题解决方案

MusicFree 插件化、定制化、无广告的免费音乐播放器项目地址: https://gitcode.com/gh_mirrors/mu/MusicFree

问题背景

在比亚迪车机系统（基于Android 10 API 29）上使用MusicFree音乐播放器时，用户发现无法通过扫描本地音乐功能访问U盘和存储卡中的内容。相比之下，其他播放器如OPlayer能够正常显示这些存储设备的内容。

技术分析

这个问题本质上与Android系统的存储访问机制有关。从Android 4.4开始，Google引入了存储访问框架(Storage Access Framework, SAF)，对应用访问外部存储的权限进行了更严格的限制。特别是从Android 10开始，应用默认只能访问自己的私有目录和特定的媒体文件。

在比亚迪车机系统中，存储设备的挂载路径可能与标准Android设备有所不同。标准Android设备通常将外部存储挂载在/storage目录下，如：

/storage/emulated/0 - 内部存储
/storage/xxxx-xxxx - 外部存储设备（如U盘或SD卡）

解决方案

通过对MusicFree源代码的分析和修改，找到了以下解决方案：

修改文件选择器逻辑：在src/pages/fileSelector/index.tsx文件中，需要替换原有的外部存储目录获取方法。原方法使用的是getAllExternalFilesDirs()，这只能获取应用特定的外部存储目录。
实现新的存储路径获取方法：添加以下代码来直接扫描/storage目录下的所有子目录：

import RNFS from 'react-native-fs';

const getAllExternalStoragePaths = async () => {
  try {
    const dirs = await RNFS.readDir('/storage');
    const externalDirs = dirs
      .filter(dir => dir.isDirectory())
      .map(dir => `${dir.path}/Android/data`);
    return externalDirs;
  } catch (error) {
    console.error('读取外部存储目录失败:', error);
    return [];
  }
}

特殊路径处理：对于/storage/emulated目录，需要手动添加/0子目录，因为某些Android系统版本可能不会自动显示这个子目录。

技术细节说明

React Native文件系统访问：解决方案中使用了react-native-fs模块，这是一个为React Native提供文件系统访问能力的库。它提供了跨平台的文件系统API，可以访问设备上的各种存储位置。

Android存储权限：要使这个解决方案正常工作，应用需要声明适当的存储权限。在AndroidManifest.xml中应该包含：

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />