应用开发时如何获取SD Card的显示卷标而非存储路径
Android 获取外置SD卡自定义卷标实现方案
核心思路
你需要获取的是SD卡的卷标(Volume Label),也就是用户自定义的存储设备显示名称,和存储路径没有直接关联,以下是分版本的实现方案:
API 24 及以上稳定实现(推荐)
通过系统原生StorageManager服务查询,不需要额外申请存储权限,适配绝大多数官方ROM和主流定制ROM:
- 获取系统
StorageManager实例 - 调用
getStorageVolumes()获取所有存储卷列表,包含内置存储、外置SD卡、外接U盘等所有存储设备 - 遍历筛选可移除存储(
isRemovable() = true即为外置SD卡类设备) - 调用
getDisplayName()即可拿到用户自定义的卷标,也就是挂载到PC时文件管理器显示的名称
代码示例(Java)
StorageManager storageManager = getSystemService(StorageManager.class); List<StorageVolume> storageVolumes = storageManager.getStorageVolumes(); for (StorageVolume volume : storageVolumes) { // 筛选可移除的外置SD卡 if (volume.isRemovable()) { String sdCardCustomLabel = volume.getDisplayName(); // 此处直接使用拿到的卷标即可 } }
API 23 及以下兼容实现
如果需要兼容安卓6.0及更低版本,可以通过反射StorageManager的隐藏接口实现:
- 反射调用
StorageManager的getVolumes()方法获取所有存储卷对象 - 反射读取每个存储卷对象的
userLabel字段,即为用户自定义的卷标 - 需要提前申请
android.permission.READ_EXTERNAL_STORAGE权限才能正常读取
注意事项
- 部分小众定制ROM可能修改
StorageVolume的返回值,遇到适配问题可以针对对应ROM的存储逻辑做特殊处理 - 不要尝试通过解析SD卡挂载路径的方式提取卷标,多数定制ROM的挂载路径和卷标无关联,且会随系统版本变化
- 存在多个可移除存储设备时,可以通过
StorageVolume.getUuid()区分不同设备,避免展示重复
内容的提问来源于stack exchange,提问作者AlexLTI
相关产品推荐
相关产品推荐

