使用DownLoadManager实现Android文件下载功能（烟台杰瑞教育原创）

在Android开发中，`DownloadManager`是一个系统服务，用于在后台执行大文件的下载任务，尤其适合长时间运行的、非用户交互式的下载操作。本文将详细介绍如何利用`DownloadManager`来实现Android应用的文件下载功能。 ### 1. 引入DownloadManager 需要在AndroidManifest.xml中添加权限，允许应用程序进行网络访问和写入外部存储： ```xml <uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> ``` 如果目标API等级在23及以上，还需要在运行时请求相应的权限。 ### 2. 获取DownloadManager实例 在Java代码中，通过`Context`的`getSystemService`方法获取`DownloadManager`的实例： ```java DownloadManager downloadManager = (DownloadManager) getSystemService(Context.DOWNLOAD_SERVICE); ``` ### 3. 创建DownloadManager.Request 创建一个`DownloadManager.Request`对象，设置下载任务的基本属性，如下载URL、本地保存路径、文件名等： ```java Uri downloadUri = Uri.parse("http://example.com/file.mp4"); // 下载链接 String destinationPath = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOWNLOADS).getPath() + "/file.mp4"; // 本地保存路径 DownloadManager.Request request = new DownloadManager.Request(downloadUri); request.setTitle("文件下载"); // 设置显示的下载名称 request.setDescription("来自烟台杰瑞教育的文件"); // 设置描述信息 request.setDestinationUri(Uri.fromFile(new File(destinationPath))); // 设置保存位置 request.setVisibleInDownloadsUi(true); // 是否在下载管理器中显示 ``` ### 4. 启动下载任务 通过`DownloadManager`的`enqueue`方法启动下载任务，传入刚才创建的`Request`对象： ```java long downloadId = downloadManager.enqueue(request); ``` `enqueue`方法返回的`downloadId`是用于跟踪下载任务的唯一标识。 ### 5. 监听下载状态 可以通过ContentObserver监听下载状态的变化，或者通过BroadcastReceiver接收广播通知。这里我们使用BroadcastReceiver示例： ```java public class DownloadReceiver extends BroadcastReceiver { @Override public void onReceive(Context context, Intent intent) { long receivedId = intent.getLongExtra(DownloadManager.EXTRA_DOWNLOAD_ID, -1); if (receivedId == downloadId) { switch (intent.getAction()) { case DownloadManager.ACTION_DOWNLOAD_COMPLETE: Query query = new Query(); query.setFilterById(receivedId); Cursor cursor = downloadManager.query(query); if (cursor.moveToFirst()) { int status = cursor.getInt(cursor.getColumnIndex(DownloadManager.COLUMN_STATUS)); if (status == DownloadManager.STATUS_SUCCESSFUL) { Toast.makeText(context, "下载完成", Toast.LENGTH_SHORT).show(); } else if (status == DownloadManager.STATUS_FAILED) { Toast.makeText(context, "下载失败", Toast.LENGTH_SHORT).show(); } } cursor.close(); break; } } } } ``` 在Activity或Service中注册这个BroadcastReceiver： ```java IntentFilter filter = new IntentFilter(DownloadManager.ACTION_DOWNLOAD_COMPLETE); registerReceiver(new DownloadReceiver(), filter); ``` 别忘了在不再需要监听时注销BroadcastReceiver： ```java unregisterReceiver(downloadReceiver); ``` ### 6. 其他高级特性 - 设置网络类型：`setAllowedNetworkTypes(int types)`允许在特定类型的网络下进行下载。 - 设置优先级：`setPriority(int priority)`可以调整下载任务的优先级。 - 设置是否允许通过移动数据下载：`setRequiresBatteryNotLow(boolean requiresBatteryNotLow)`和`setRequiresCharging(boolean requiresCharging)`。 - 自定义通知：可以创建自定义的通知栏通知，以便更灵活地展示下载进度。 通过上述步骤，你就可以在Android应用中实现基于`DownloadManager`的文件下载功能了。`DownloadManager`提供了稳定且易于使用的接口，可以处理文件的暂停、恢复、断点续传等问题，是Android平台进行文件下载的首选方案。