uniapp在android 10+不支持当前路径是怎么回事？

uniapp在Android 10+设备上运行时报错“不支持当前路径”，具体表现为文件操作或路径访问失败。请问这是什么原因导致的？是Android权限限制还是uniapp的兼容性问题？需要如何修改代码才能适配高版本Android系统？

2 回复

Android 10+加强了文件存储权限管理，限制了应用对公共目录的直接访问。UniApp需使用uni.saveFile等API将文件保存到应用私有目录，或通过用户授权访问外部存储。


在 Android 10（API 级别 29）及以上版本中，UniApp 无法直接访问某些文件路径（如 file:// 路径）是由于 Android 系统的分区存储（Scoped Storage） 限制。这旨在增强用户隐私和数据安全。

原因：

  • Android 10+ 默认禁止应用通过绝对路径访问外部存储（如 SD 卡），除非应用拥有特定权限或使用系统提供的 API（如 MediaStore）。
  • UniApp 默认使用的 file:// URI 可能被系统拦截，导致文件操作（如读取、写入）失败。

解决方案：

  1. 使用 UniApp 提供的路径 API：

    • 通过 uni.env.USER_DATA_PATH 获取应用私有目录路径，该路径在 Android 10+ 下可正常读写。
    • 示例代码：
      // 获取应用私有目录路径（如：/data/user/0/your.app.package/files）
const filePath = `${uni.env.USER_DATA_PATH}/example.txt`;
// 写入文件
uni.writeFile({
  path: filePath,
  data: 'Hello UniApp',
  success: () => console.log('文件写入成功')
});

  2. 处理外部文件时使用系统选择器：

    • 通过 uni.chooseFile 让用户主动选择文件，获取临时路径（系统授权后的安全路径）。
    • 示例代码：
      uni.chooseFile({
  count: 1,
  success: (res) => {
    const tempPath = res.tempFilePaths[0]; // 临时路径，可用于后续操作
    console.log('文件路径:', tempPath);
  }
});

  3. 配置权限和适配：

    • 在 manifest.json 中声明 android:requestLegacyExternalStorage="true"（仅对 Android 10 有效，Android 11+ 需使用分区存储）。
    • 对于 Android 11+，考虑使用 MediaStore 或 SAF（Storage Access Framework）进行文件访问，但 UniApp 可能需通过原生插件实现。

注意事项：

  • 避免硬编码路径（如 file:///sdcard/），优先使用 UniApp 封装的方法。
  • 测试时注意 Android 版本差异，确保兼容性。

通过以上方法，可解决 Android 10+ 的路径兼容性问题。如果涉及复杂操作（如访问公共目录），可能需要开发原生插件扩展功能。

回到顶部