Flutter存储设备路径管理插件sdcard_path_manager的使用

描述

sdcard_path_manager 是一个用于获取 Android 设备上可用 SD 卡路径及其大小的 Flutter 插件。通过该插件,您可以轻松地管理和访问 SD 卡的相关信息。


使用步骤

1. 添加依赖

pubspec.yaml 文件中添加以下依赖项:

dependencies:
  sdcard_path_manager: ^版本号

然后运行 flutter pub get 来安装插件。


2. 初始化插件并获取路径和大小

以下是基本的使用示例代码:

var isExistAvailableSDCardMemory = await SdcardPathManager.isExistAvailableSDCardMemory;

var downPath = await SdcardPathManager.getMemoryPath(dirName: 'download');
var freeSize = await SdcardPathManager.getAvailableMemorySize;

var downSDPath = await SdcardPathManager.getSDCardMemoryPath(dirName: 'download');
var freeSDSize = await SdcardPathManager.getAvailableSDCardMemorySize;
  • isExistAvailableSDCardMemory:判断是否存在可用的 SD 卡。
  • getMemoryPath:获取内部存储路径(如 /storage/emulated/0/download)。
  • getAvailableMemorySize:获取内部存储的可用空间大小(单位为字节)。
  • getSDCardMemoryPath:获取 SD 卡路径(如 /storage/external_SD/download)。
  • getAvailableSDCardMemorySize:获取 SD 卡的可用空间大小(单位为字节)。

完整示例代码

以下是一个完整的示例代码,展示了如何在 Flutter 应用中使用 sdcard_path_manager 插件:

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

import 'package:flutter/services.dart';
import 'package:sdcard_path_manager/sdcard_path_manager.dart';

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

class MyApp extends StatefulWidget {
  @override
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  var myTextSyle = TextStyle(fontSize: 20);

  // 是否存在可用的 SD 卡
  bool _isExistAvailableSDCardMemory = false;

  // 内部存储路径
  String _downPath = '';

  // SD 卡路径
  String _downSDPath = '';

  // 内部存储可用空间大小
  int _freeSize = 0;

  // SD 卡可用空间大小
  int _freeSDSize = 0;

  @override
  void initState() {
    super.initState();
    initPlatformState();
  }

  Future<void> initPlatformState() async {
    try {
      // 检查是否存在可用的 SD 卡
      var isExistAvailableSDCardMemory = await SdcardPathManager.isExistAvailableSDCardMemory;

      // 获取内部存储路径
      var downPath = await SdcardPathManager.getMemoryPath(dirName: 'download');

      // 获取内部存储可用空间大小
      var freeSize = await SdcardPathManager.getAvailableMemorySize;

      // 获取 SD 卡路径
      var downSDPath = await SdcardPathManager.getSDCardMemoryPath(dirName: 'download');

      // 获取 SD 卡可用空间大小
      var freeSDSize = await SdcardPathManager.getAvailableSDCardMemorySize;

      // 更新状态
      if (!mounted) return;
      setState(() {
        _isExistAvailableSDCardMemory = isExistAvailableSDCardMemory;
        _downPath = downPath;
        _freeSize = freeSize;
        _downSDPath = downSDPath;
        _freeSDSize = freeSDSize;
      });
    } on PlatformException catch (e) {
      print("Error: ${e.message}");
    }
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('SD 卡路径管理插件示例'),
        ),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.start,
            crossAxisAlignment: CrossAxisAlignment.center,
            children: [
              SizedBox(height: 30),
              Text('是否存在可用的 SD 卡: $_isExistAvailableSDCardMemory', style: myTextSyle),
              SizedBox(height: 30),
              Text('内部存储路径: \n$_downPath', style: myTextSyle),
              SizedBox(height: 30),
              Text('内部存储可用空间大小: $_freeSize 字节', style: myTextSyle),
              SizedBox(height: 30),
              Text('SD 卡路径: \n$_downSDPath', style: myTextSyle),
              SizedBox(height: 30),
              Text('SD 卡可用空间大小: $_freeSDSize 字节', style: myTextSyle),
            ],
          ),
        ),
      ),
    );
  }
}

运行效果

运行上述代码后,应用界面会显示以下内容:

  • 是否存在可用的 SD 卡。
  • 内部存储路径。
  • 内部存储的可用空间大小。
  • SD 卡路径。
  • SD 卡的可用空间大小。

注意事项

  1. 权限声明: 在 Android 10 及更高版本中,需要在 AndroidManifest.xml 中添加存储权限:
    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>

更多关于Flutter存储设备路径管理插件sdcard_path_manager的使用的实战教程也可以访问 https://www.itying.com/category-92-b0.html

1 回复

更多关于Flutter存储设备路径管理插件sdcard_path_manager的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html


flutter_sdcard_path_manager 是一个用于在 Flutter 应用中获取 Android 设备上 SD 卡路径的插件。它可以帮助你获取内部存储和外部存储(如 SD 卡)的路径,以便在应用中进行文件操作。

安装插件

首先,你需要在 pubspec.yaml 文件中添加 flutter_sdcard_path_manager 插件的依赖:

dependencies:
  flutter:
    sdk: flutter
  flutter_sdcard_path_manager: ^1.0.0

然后运行 flutter pub get 来安装插件。

使用插件

1. 导入插件

在你的 Dart 文件中导入插件:

import 'package:flutter_sdcard_path_manager/flutter_sdcard_path_manager.dart';

2. 获取存储路径

你可以使用 SdcardPathManager 类来获取设备的存储路径。以下是一些常用的方法:

  • 获取内部存储路径
String? internalStoragePath = await SdcardPathManager.getInternalStoragePath();
print('Internal Storage Path: $internalStoragePath');
  • 获取外部存储路径(SD 卡)
String? externalStoragePath = await SdcardPathManager.getExternalStoragePath();
print('External Storage Path: $externalStoragePath');
  • 获取所有存储路径
List<String>? storagePaths = await SdcardPathManager.getAllStoragePaths();
print('All Storage Paths: $storagePaths');

3. 处理路径

获取到路径后,你可以使用这些路径进行文件操作,例如读取、写入文件等。

if (internalStoragePath != null) {
  // 在内部存储路径下创建一个文件
  File file = File('$internalStoragePath/myfile.txt');
  file.writeAsStringSync('Hello, World!');
  print('File created at: ${file.path}');
}

if (externalStoragePath != null) {
  // 在外部存储路径下创建一个文件
  File file = File('$externalStoragePath/myfile.txt');
  file.writeAsStringSync('Hello, SD Card!');
  print('File created at: ${file.path}');
}

注意事项

  1. 权限:在 Android 上访问外部存储(如 SD 卡)需要相应的权限。确保在 AndroidManifest.xml 文件中添加以下权限:

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

    并且在运行时请求这些权限。

  2. 兼容性flutter_sdcard_path_manager 插件主要用于 Android 设备。在 iOS 或其他平台上,可能需要使用其他方法来获取存储路径。

  3. 路径有效性:获取到的路径可能为空或无效,特别是在设备没有外部存储(如 SD 卡)的情况下。因此,在使用路径之前,建议进行有效性检查。

示例代码

以下是一个完整的示例代码,展示了如何使用 flutter_sdcard_path_manager 插件获取存储路径并进行文件操作:

import 'package:flutter/material.dart';
import 'package:flutter_sdcard_path_manager/flutter_sdcard_path_manager.dart';
import 'dart:io';

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('SD Card Path Manager Example'),
        ),
        body: Center(
          child: ElevatedButton(
            onPressed: () async {
              String? internalStoragePath = await SdcardPathManager.getInternalStoragePath();
              String? externalStoragePath = await SdcardPathManager.getExternalStoragePath();

              if (internalStoragePath != null) {
                File file = File('$internalStoragePath/myfile.txt');
                file.writeAsStringSync('Hello, Internal Storage!');
                print('File created at: ${file.path}');
              }

              if (externalStoragePath != null) {
                File file = File('$externalStoragePath/myfile.txt');
                file.writeAsStringSync('Hello, External Storage!');
                print('File created at: ${file.path}');
              }
            },
            child: Text('Create Files'),
          ),
        ),
      ),
    );
  }
}
回到顶部