Flutter文件选择插件ios_document_picker的使用

ios_document_picker 是一个用于在 Flutter 应用中集成 iOS 的 UIDocumentPickerViewController 的插件。它允许用户从设备中选择文件或目录。

使用

首先，你需要将 ios_document_picker 添加到你的 pubspec.yaml 文件中：

dependencies:
  ios_document_picker: ^版本号

然后，你可以使用以下代码来初始化并调用文件选择器：

import 'package:ios_document_picker/ios_document_picker.dart';

final _iosDocumentPickerPlugin = IosDocumentPicker();

var result = await _iosDocumentPickerPlugin.pick(/* DocumentPickerType.file or directory */);
if (result == null) {
  // 取消了选择。
  return;
}
print(result.url); // 打印文件的URL
print(result.path); // 打印文件的路径

选项

该插件提供了以下选项来定制文件选择器的行为：

• allowedUtiTypes: 允许的 UTI 类型列表。UTI（Uniform Type Identifier）是一种用于标识文件类型的统一标识符。
• multiple: 是否允许多个文件选择。

完整示例

以下是一个完整的示例代码，展示了如何在 Flutter 应用中使用 ios_document_picker 插件来选择文件或目录：

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

import 'package:ios_document_picker/ios_document_picker.dart';
import 'package:ios_document_picker/types.dart';

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

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

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  final _iosDocumentPickerPlugin = IosDocumentPicker();
  var _output = '';
  var _mode = IosDocumentPickerType.file;
  var _multiple = false;

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('插件示例应用'),
        ),
        body: SingleChildScrollView(
          child: Container(
            padding: const EdgeInsets.all(20),
            child: Column(
              children: [
                Text(_output),
                const SizedBox(
                  height: 10,
                ),
                ListTile(
                  title: const Text('文件'),
                  leading: Radio<IosDocumentPickerType>(
                    value: IosDocumentPickerType.file,
                    groupValue: _mode,
                    onChanged: (IosDocumentPickerType? value) {
                      setState(() {
                        _mode = value!;
                      });
                    },
                  ),
                ),
                ListTile(
                  title: const Text('目录'),
                  leading: Radio<IosDocumentPickerType>(
                    value: IosDocumentPickerType.directory,
                    groupValue: _mode,
                    onChanged: (IosDocumentPickerType? value) {
                      setState(() {
                        _mode = value!;
                      });
                    },
                  ),
                ),
                const SizedBox(
                  height: 10,
                ),
                CheckboxListTile(
                    value: _multiple,
                    onChanged: (value) {
                      setState(() {
                        _multiple = value!;
                      });
                    },
                    title: const Text('多选')),
                const SizedBox(
                  height: 10,
                ),
                OutlinedButton(onPressed: _start, child: const Text('选择'))
              ],
            ),
          ),
        ),
      ),
    );
  }

  Future<void> _start() async {
    var result = await _iosDocumentPickerPlugin.pick(_mode, multiple: _multiple);
    if (result == null) {
      setState(() {
        _output = '取消了选择';
      });
      return;
    }
    setState(() {
      _output = result.map((e) => e.toString()).join('\n\n');
    });
  }
}