Flutter 文件管理插件 android_download_manager 的使用

简介

android_download_manager 插件允许你通过 Android 原生下载管理器下载文件。该插件仅适用于 Android 平台。

版本和许可

• 版本:
• 许可:

开始使用

权限

在使用 android_download_manager 插件之前，需要在 AndroidManifest.xml 中添加以下权限：

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

如何下载文件？

以下是一个简单的示例，展示了如何使用 android_download_manager 下载文件：

import 'dart:developer';
import 'package:android_download_manager/android_download_manager.dart';
import 'package:flutter/material.dart';
import 'dart:io';

void main() {
  // 监听下载完成事件
  AndroidDownloadManager.listen((data) {
    String id = data["id"];
    log("Download complete with ID: $id");
  });

  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('Android Download Manager Example'),
        ),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: <Widget>[
              ElevatedButton(
                child: Text('Download File'),
                onPressed: () async {
                  // 下载文件
                  AndroidDownloadManager.enqueue(
                    downloadUrl: "https://raw.githubusercontent.com/ableco/test-files/master/images/test-image-png_4032x3024.png",
                    downloadPath: Directory.systemTemp.path,
                    fileName: "test.png",
                    description: "Downloading test image",
                    headers: {"Authorization": "Bearer your_token_here"},
                    allowScanningByMediaScanner: true,
                    notificationVisibility: NotificationVisibility.VISIBLE_NOTIFY_COMPLETED,
                  );
                },
              ),
              Text("Press the button to start downloading"),
            ],
          ),
        ),
      ),
    );
  }
}

参数说明

监听下载完成事件

你可以通过 AndroidDownloadManager.listen 方法监听下载完成事件，并获取已完成下载的 ID：

AndroidDownloadManager.listen((data) {
  String id = data["id"];
  log("Download complete with ID: $id");
});

这里我们接收到已完成下载的 ID。

完整示例代码

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

import 'dart:developer';
import 'package:android_download_manager/android_download_manager.dart';
import 'package:flutter/material.dart';
import 'dart:io';

void main() {
  // 监听下载完成事件
  AndroidDownloadManager.listen((data) {
    String id = data["id"];
    log("Download complete with ID: $id");
  });

  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('Android Download Manager Example'),
        ),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: <Widget>[
              ElevatedButton(
                child: Text('Download File'),
                onPressed: () async {
                  // 下载文件
                  AndroidDownloadManager.enqueue(
                    downloadUrl: "https://raw.githubusercontent.com/ableco/test-files/master/images/test-image-png_4032x3024.png",
                    downloadPath: Directory.systemTemp.path,
                    fileName: "test.png",
                    description: "Downloading test image",
                    headers: {"Authorization": "Bearer your_token_here"},
                    allowScanningByMediaScanner: true,
                    notificationVisibility: NotificationVisibility.VISIBLE_NOTIFY_COMPLETED,
                  );
                },
              ),
              Text("Press the button to start downloading"),
            ],
          ),
        ),
      ),
    );
  }
}

希望这个示例能帮助你更好地理解和使用 android_download_manager 插件。如果有任何问题或需要进一步的帮助，请随时提问！