1. 插件介绍

path_provider 是一个广泛使用的 Flutter 插件，用于获取宿主平台文件系统上的常用位置，如临时目录和应用数据目录。它提供了跨平台的文件路径访问能力，使开发者能够轻松地在不同平台上管理应用的文件存储。

在 OpenHarmony（鸿蒙）平台上，该插件已完成适配，允许开发者在鸿蒙设备上使用相同的 API 来访问文件系统路径，实现了真正的跨平台开发体验。

2. 如何使用插件

2.1 包的引入

由于这是针对鸿蒙系统的自定义修改版本，需要通过 Git 形式引入依赖。在项目的 pubspec.yaml 文件中，添加以下配置：

dependencies:
  path_provider:
    git:
      url: "https://gitcode.com/openharmony-tpc/flutter_packages.git"
      path: "packages/path_provider/path_provider"

添加依赖后，执行以下命令获取包：

flutter pub get

2.2 API 的调用

path_provider 插件提供了一系列静态方法来获取不同类型的文件路径。以下是一些常用 API 的使用示例：

2.2.1 获取临时目录

临时目录用于存储临时文件，系统可能会在适当的时候清理这些文件：

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

Future<void> getTemporaryDirectoryExample() async {
  Directory tempDir = await getTemporaryDirectory();
  String tempPath = tempDir.path;
  print('临时目录路径：$tempPath');
}

2.2.2 获取应用文档目录

应用文档目录用于存储应用的持久化数据，这些数据不会被系统自动清理：

Future<void> getApplicationDocumentsDirectoryExample() async {
  Directory appDocsDir = await getApplicationDocumentsDirectory();
  String appDocsPath = appDocsDir.path;
  print('应用文档目录路径：$appDocsPath');
}

2.2.3 获取应用支持目录

应用支持目录用于存储应用的支持文件，这些文件通常不直接向用户展示：

Future<void> getApplicationSupportDirectoryExample() async {
  Directory supportDir = await getApplicationSupportDirectory();
  String supportPath = supportDir.path;
  print('应用支持目录路径：$supportPath');
}

2.2.4 获取下载目录

获取设备上的公共下载目录：

Future<void> getDownloadsDirectoryExample() async {
  Directory? downloadsDir = await getDownloadsDirectory();
  if (downloadsDir != null) {
    String downloadsPath = downloadsDir.path;
    print('下载目录路径：$downloadsPath');
  } else {
    print('设备不支持下载目录');
  }
}

2.2.5 在文档目录中创建和写入文件

以下示例展示了如何在应用文档目录中创建并写入一个文本文件：

Future<void> writeToFileExample() async {
  // 获取应用文档目录
  Directory appDocsDir = await getApplicationDocumentsDirectory();
  
  // 创建文件路径
  File file = File('${appDocsDir.path}/example.txt');
  
  // 写入内容
  await file.writeAsString('Hello, OpenHarmony!');
  print('文件已写入：${file.path}');
  
  // 读取内容
  String content = await file.readAsString();
  print('文件内容：$content');
}

3. 完整示例应用

以下是一个简单的 Flutter 应用示例，展示了如何在鸿蒙系统上使用 path_provider 插件：

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

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

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Path Provider Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: const MyHomePage(title: 'Path Provider 示例'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key, required this.title});
  final String title;

  @override
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  String _tempPath = '';
  String _appDocsPath = '';
  String _supportPath = '';
  String _downloadsPath = '';
  String _fileOperationResult = '';

  Future<void> _getPaths() async {
    // 获取临时目录
    Directory tempDir = await getTemporaryDirectory();
    
    // 获取应用文档目录
    Directory appDocsDir = await getApplicationDocumentsDirectory();
    
    // 获取应用支持目录
    Directory supportDir = await getApplicationSupportDirectory();
    
    // 获取下载目录
    Directory? downloadsDir = await getDownloadsDirectory();

    setState(() {
      _tempPath = tempDir.path;
      _appDocsPath = appDocsDir.path;
      _supportPath = supportDir.path;
      _downloadsPath = downloadsDir?.path ?? '不支持';
    });
  }

  Future<void> _fileOperation() async {
    try {
      // 获取应用文档目录
      Directory appDocsDir = await getApplicationDocumentsDirectory();
      
      // 创建文件
      File file = File('${appDocsDir.path}/demo.txt');
      
      // 写入内容
      await file.writeAsString('这是一个在鸿蒙系统上创建的文件！');
      
      // 读取内容
      String content = await file.readAsString();
      
      setState(() {
        _fileOperationResult = '文件操作成功！\n文件路径：${file.path}\n文件内容：$content';
      });
    } catch (e) {
      setState(() {
        _fileOperationResult = '文件操作失败：$e';
      });
    }
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
      ),
      body: Center(
        child: SingleChildScrollView(
          padding: const EdgeInsets.all(20.0),
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: <Widget>[
              ElevatedButton(
                onPressed: _getPaths,
                child: const Text('获取文件路径'),
              ),
              const SizedBox(height: 20),
              Text('临时目录：$_tempPath'),
              const SizedBox(height: 10),
              Text('应用文档目录：$_appDocsPath'),
              const SizedBox(height: 10),
              Text('应用支持目录：$_supportPath'),
              const SizedBox(height: 10),
              Text('下载目录：$_downloadsPath'),
              const SizedBox(height: 30),
              ElevatedButton(
                onPressed: _fileOperation,
                child: const Text('执行文件操作'),
              ),
              const SizedBox(height: 20),
              Text(_fileOperationResult),
            ],
          ),
        ),
      ),
    );
  }
}

4. 运行示例

要在鸿蒙设备上运行示例应用，需要按照以下步骤操作：

1. 编译 Flutter 兼容 OpenHarmony 的 Engine，参考：https://gitcode.com/openharmony-sig/flutter_engine/blob/master/README.md

2. 下载 Flutter 兼容 OpenHarmony 的 SDK，并配置相关环境，参考：https://gitcode.com/openharmony-sig/flutter_flutter/blob/master/README.md

3. 进入示例目录，运行以下命令：

flutter run --local-engine=<兼容ohos的engine产物路径>

5. 总结

通过 path_provider 插件，Flutter 开发者可以在鸿蒙系统上轻松访问各种文件系统路径，实现了跨平台的文件操作能力。该插件提供了简洁易用的 API，使开发者能够专注于应用逻辑的开发，而不必担心不同平台之间的文件系统差异。

使用 Git 形式引入依赖，可以确保获取到针对鸿蒙系统优化的最新版本，为应用在鸿蒙设备上的稳定运行提供保障。

欢迎加入开源鸿蒙跨平台社区：https://openharmonycrossplatform.csdn.net