Android不同API级别外部存储兼容问题：API29设备应用无法启动

你的代码在Android 10（API29）上崩溃的核心原因是：

• Environment.getExternalStoragePublicDirectory()方法在API29已被废弃且系统限制调用：当targetSdkVersion设为29时，调用该方法会直接抛出IllegalStateException，这就是应用无法启动的直接诱因。
• 你配置的android:requestLegacyExternalStorage="true"仅能让应用在Android10下沿用旧存储访问模型，但无法恢复该废弃方法的可用性——系统在API29中已彻底限制了这个方法的调用。

针对日志存储这种场景，优先选择应用私有外部存储目录（卸载应用时会自动清理，无需额外权限），以下是兼容各API级别的修正代码：

File logsDir;
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
    // Android 10及以上：使用应用私有外部存储
    // getExternalFilesDir(null) 获取应用在外部存储的私有根目录
    logsDir = new File(getExternalFilesDir(null), "agent_logs");
} else {
    // Android 9及以下：使用外部存储根目录
    String storageRoot = Environment.getExternalStorageDirectory().getAbsolutePath();
    logsDir = new File(storageRoot + "/agent_logs");
}

if (!logsDir.exists() && !logsDir.mkdirs()) {
    throw new RuntimeException("Unable to create directory");
}

额外说明 #

1. 权限优化：API19及以上，访问应用私有外部存储无需申请READ_EXTERNAL_STORAGE或WRITE_EXTERNAL_STORAGE权限，如果仅用于日志存储，可以从Manifest中移除这两个权限。
2. 公共目录替代方案：如果你一定要将日志存到公共Downloads目录，在API29及以上需要通过MediaStore API来创建文件，而不是直接操作File对象（示例仅作参考，不推荐日志用公共目录）：

   // Android 10+ 写入公共Downloads目录示例
   ContentValues values = new ContentValues();
   values.put(MediaStore.Downloads.DISPLAY_NAME, "agent_log.txt");
   values.put(MediaStore.Downloads.MIME_TYPE, "text/plain");
   values.put(MediaStore.Downloads.RELATIVE_PATH, Environment.DIRECTORY_DOWNLOADS + "/agent_logs");
   
   Uri uri = getContentResolver().insert(MediaStore.Downloads.EXTERNAL_CONTENT_URI, values);
   if (uri != null) {
       try (OutputStream outputStream = getContentResolver().openOutputStream(uri)) {
           // 写入日志内容
       } catch (IOException e) {
           e.printStackTrace();
       }
   }
   

3. MANAGE_EXTERNAL_STORAGE权限：这个权限是为API30+的全文件访问设计的，对API29无效，且需要用户手动授权系统设置，完全不适合日志存储这种场景，建议移除。

内容的提问来源于stack exchange，提问作者Milindi Senevirathne