hey_sd_reader 是一个用于在 Flutter 应用中读取 Android 设备上外部存储（如 SD 卡）中的数字文件的插件。它提供了一种安全的方式来访问外部存储中的文件，并确保应用在访问这些文件时遵循 Android 的存储访问框架（SAF）。

以下是使用 hey_sd_reader 插件的基本步骤：

1. 添加依赖

首先，在 pubspec.yaml 文件中添加 hey_sd_reader 插件的依赖：

dependencies:
  flutter:
    sdk: flutter
  hey_sd_reader: ^1.0.0  # 请使用最新版本

然后运行 flutter pub get 来安装依赖。

2. 请求存储权限

在 Android 10 及以上版本中，访问外部存储需要请求 READ_EXTERNAL_STORAGE 权限。你可以在 AndroidManifest.xml 文件中添加以下权限：

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

然后，在 Flutter 代码中请求权限：

import 'package:permission_handler/permission_handler.dart';

Future<void> requestStoragePermission() async {
  if (await Permission.storage.request().isGranted) {
    // 权限已授予
  } else {
    // 权限被拒绝
  }
}

3. 使用 hey_sd_reader 读取文件

你可以使用 hey_sd_reader 插件来读取 SD 卡中的文件。以下是一个简单的示例：

import 'package:flutter/material.dart';
import 'package:hey_sd_reader/hey_sd_reader.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: HomeScreen(),
    );
  }
}

class HomeScreen extends StatefulWidget {
  @override
  _HomeScreenState createState() => _HomeScreenState();
}

class _HomeScreenState extends State<HomeScreen> {
  String _fileContent = '';

  Future<void> _readFileFromSDCard() async {
    // 使用 hey_sd_reader 读取文件
    final fileContent = await HeySdReader.readFile('/sdcard/your_file.txt');
    setState(() {
      _fileContent = fileContent;
    });
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('SD Card Reader'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            ElevatedButton(
              onPressed: _readFileFromSDCard,
              child: Text('Read File from SD Card'),
            ),
            SizedBox(height: 20),
            Text('File Content:'),
            Text(_fileContent),
          ],
        ),
      ),
    );
  }
}

4. 处理文件路径

在 Android 10 及以上版本中，访问外部存储需要使用 Storage Access Framework (SAF)。你可以使用 hey_sd_reader 插件来获取文件的 URI，然后读取文件内容。

Future<void> _readFileUsingSAF() async {
  // 使用 SAF 打开文件选择器
  final fileUri = await HeySdReader.pickFile();
  if (fileUri != null) {
    final fileContent = await HeySdReader.readFileFromUri(fileUri);
    setState(() {
      _fileContent = fileContent;
    });
  }
}

5. 处理异常

在处理文件读取时，可能会遇到文件不存在、权限不足等异常。建议使用 try-catch 块来捕获和处理这些异常。

try {
  final fileContent = await HeySdReader.readFile('/sdcard/your_file.txt');
  setState(() {
    _fileContent = fileContent;
  });
} catch (e) {
  print('Error reading file: $e');
}