Flutter中如何获取WhatsApp .statuses目录的合法访问权限？

先搞懂“Use This Folder”的本质 #

这个不是系统权限列表里的常规权限，而是存储访问框架(SAF) 提供的目录授权机制——让用户手动选择并授权你的应用访问指定目录（也就是WhatsApp的.statuses目录），完全符合Google Play的政策要求，不会因为用了MANAGE_EXTERNAL_STORAGE被拒。

Flutter里的实现步骤 #

1. 加依赖 #

推荐用file_picker包，它已经封装了SAF的目录选择逻辑，在pubspec.yaml里添加：

dependencies:
  file_picker: ^6.1.1  # 可以用最新版本

然后执行flutter pub get拉取依赖。

2. 写目录选择与授权代码 #

调用SAF让用户手动选择.statuses目录，还要做路径验证：

import 'package:file_picker/file_picker.dart';
import 'dart:io';

Future<void> getWhatsAppStatusDirAccess() async {
  // 弹出SAF目录选择框
  final selectedDir = await FilePicker.platform.getDirectoryPath(
    dialogTitle: '请选择WhatsApp的.statuses目录',
    lockParentWindow: true,
  );

  if (selectedDir == null) {
    print('用户取消了目录选择');
    return;
  }

  // 验证是不是正确的.statuses目录
  if (selectedDir.endsWith('.statuses')) {
    print('已获得目录访问权限：$selectedDir');
    // 这里可以直接读取目录里的文件
    final statusFiles = Directory(selectedDir).listSync();
    for (var file in statusFiles) {
      print('找到状态文件：${file.path}');
    }
    // 建议把这个路径存到SharedPreferences里，下次启动直接用
  } else {
    print('请选择正确的WhatsApp.statuses目录');
  }
}

3. AndroidManifest配置 #

不需要额外加特殊权限，因为SAF是用户手动授权的。如果你的应用需要保存状态文件到本地，Android 13+可以加细粒度权限：

<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
<uses-permission android:name="android.permission.READ_MEDIA_VIDEO" />

低于Android 13的版本可以加READ_EXTERNAL_STORAGE，但这不是访问.statuses目录的必要条件，SAF授权后直接就能读。

4. 引导用户找对目录 #

很多用户不知道.statuses在哪，你得在应用里给提示：

• 标准路径：Android/data/com.whatsapp/files/.statuses
• 提醒用户在文件管理器里开启“显示隐藏文件”（因为.statuses是隐藏目录）

5. 复用授权 #

用户授权一次后，把选中的目录路径存到SharedPreferences里，下次启动直接读取，不用再让用户选：

import 'package:shared_preferences/shared_preferences.dart';

// 保存目录路径
Future<void> saveStatusDir(String path) async {
  final prefs = await SharedPreferences.getInstance();
  await prefs.setString('whatsapp_status_dir', path);
}

// 获取已保存的目录路径
Future<String?> getSavedStatusDir() async {
  final prefs = await SharedPreferences.getInstance();
  return prefs.getString('whatsapp_status_dir');
}

内容的提问来源于stack exchange，提问作者Umer Yaseen