Android使用SAF保存文档至Documents文件夹遇兼容问题求助

核心思路：放弃获取真实文件路径，直接通过URI操作文件 #

Android 10+（API 29）引入分区存储后，获取真实文件路径的方式已被官方不推荐，不同厂商设备的DocumentsProvider实现差异（比如联想M10 Plus）会导致路径获取失败或第三方库回调异常。直接使用系统DocumentFile和ContentResolver操作URI是更可靠的方案。

具体步骤与代码实现 #

1. 替换原逻辑，直接通过URI创建并写入文件 #

放弃使用PickiT库获取路径，改用系统API直接在选定的Documents目录下创建文件并写入内容：

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    if (resultCode != RESULT_OK || data == null) {
        Log.d("GraphActivity", "Result not OK or data is null");
        return;
    }

    Uri treeUri = data.getData();
    // 持久化URI权限，避免重启APP后丢失权限
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
        int takeFlags = data.getFlags() & (Intent.FLAG_GRANT_READ_URI_PERMISSION | Intent.FLAG_GRANT_WRITE_URI_PERMISSION);
        getContentResolver().takePersistableUriPermission(treeUri, takeFlags);
    }

    DocumentFile pickedDir = DocumentFile.fromTreeUri(this, treeUri);
    String timestamp = new SimpleDateFormat("MM_dd_yy_hh.mm", Locale.getDefault()).format(new Date());
    String baseFilename = name + " " + timestamp;

    // 保存CSV文件（PDF保存只需修改MIME类型为"application/pdf"）
    DocumentFile csvFile = pickedDir.createFile("text/csv", baseFilename + ".csv");
    if (csvFile == null) {
        Log.d("GraphActivity", "Failed to create CSV file");
        return;
    }

    // 写入CSV内容（替换为你的实际内容）
    try (OutputStream os = getContentResolver().openOutputStream(csvFile.getUri())) {
        String csvContent = "Header1,Header2\nData1,Data2\nData3,Data4";
        os.write(csvContent.getBytes(StandardCharsets.UTF_8));
        Log.d("GraphActivity", "CSV saved successfully");
        showSaveDialog();
    } catch (IOException e) {
        Log.e("GraphActivity", "Error writing CSV file", e);
    }
}

2. 若仍想使用PickiT库，排查回调未触发问题 #

如果坚持使用PickiT，先确认以下几点：

• 确保在Activity的onCreate中正确初始化PickiT并绑定回调：

  private PickiT pickiT;
  
  @Override
  protected void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      // 其他初始化逻辑
      pickiT = new PickiT(this, this); // 第二个参数是实现了PickiTCallbacks的当前Activity
  }
  

• 检查是否在onDestroy中解绑回调（部分库需要）：

  @Override
  protected void onDestroy() {
      super.onDestroy();
      if (pickiT != null) {
          pickiT.stop();
      }
  }
  

• 确认联想设备上的文件管理器返回的URI格式是否被PickiT支持，部分厂商的自定义文件管理器返回的URI可能超出库的适配范围。

3. 权限适配补充 #

• 对于Android 13+，需在AndroidManifest.xml中添加READ_MEDIA_IMAGES/READ_MEDIA_VIDEO/READ_MEDIA_AUDIO权限，但保存文件到Documents目录主要依赖URI权限，无需额外申请外部存储权限。
• 若目标设备包含Android 9及以下版本，仍需申请WRITE_EXTERNAL_STORAGE运行时权限。

为什么原方案在联想设备上失效？ #

联想M10 Plus的DocumentsProvider实现可能对URI的解析逻辑与三星、台电设备不同，导致PickiT库无法正确处理URI，进而触发回调失败。而直接使用系统API绕开了路径解析，完全基于URI操作，兼容性更强。

内容的提问来源于stack exchange，提问作者Pink Jazz