android 文件下载DownloadManager

在Android系统中，`DownloadManager` 是一个系统服务，用于管理设备上的文件下载任务。它为应用程序提供了一种安全、可靠且后台运行的文件下载方式，使得用户可以在应用不活动时或者设备屏幕关闭的情况下继续下载。`DownloadManager` 通过Intent广播来通知应用下载的状态变化，从而让开发者能够灵活地处理不同情况下的下载结果。 ### 1. `DownloadManager` 的注册与获取 在使用`DownloadManager` 之前，你需要在AndroidManifest.xml中声明对`WRITE_EXTERNAL_STORAGE`权限的使用，因为下载通常涉及到外部存储： ```xml <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> ``` 然后，你可以通过以下代码在应用程序中获取`DownloadManager`实例： ```java DownloadManager downloadManager = (DownloadManager) getSystemService(Context.DOWNLOAD_SERVICE); ``` ### 2. 创建下载请求 创建一个`DownloadManager.Request`对象，设置下载的URL、目标存储位置、文件名等参数： ```java DownloadManager.Request request = new DownloadManager.Request(Uri.parse("http://example.com/file")); request.setTitle("文件名"); request.setDescription("这是文件的描述"); request.setDestinationInExternalPublicDir(Environment.DIRECTORY_DOWNLOADS, "filename.ext"); ``` 还可以设置其他高级选项，如是否允许在移动网络下下载、优先级、通知栏显示等。 ### 3. 提交下载请求 将`Request`对象提交给`DownloadManager`进行下载： ```java long downloadId = downloadManager.enqueue(request); ``` `enqueue()`方法返回一个唯一的`downloadId`，用于后续查询下载状态。 ### 4. 监听下载进度与状态 可以通过BroadcastReceiver监听下载进度和状态： ```java IntentFilter filter = new IntentFilter(DownloadManager.ACTION_DOWNLOAD_COMPLETE); BroadcastReceiver receiver = new BroadcastReceiver() { @Override public void onReceive(Context context, Intent intent) { if (DownloadManager.ACTION_DOWNLOAD_COMPLETE.equals(intent.getAction())) { long downloadId = intent.getLongExtra(DownloadManager.EXTRA_DOWNLOAD_ID, -1); Query query = new Query(); query.setFilterById(downloadId); Cursor cursor = downloadManager.query(query); if (cursor.moveToFirst()) { int status = cursor.getInt(cursor.getColumnIndex(DownloadManager.COLUMN_STATUS)); switch (status) { case DownloadManager.STATUS_SUCCESSFUL: // 下载成功，可以在这里处理文件 break; case DownloadManager.STATUS_FAILED: // 下载失败，可以查看错误原因 break; } } cursor.close(); } } }; registerReceiver(receiver, filter); ``` ### 5. 查询下载状态 如果你需要在任何时候查询下载的状态，可以使用`DownloadManager.Query`对象： ```java Query query = new Query(); query.setFilterById(downloadId); Cursor cursor = downloadManager.query(query); if (cursor.moveToFirst()) { int status = cursor.getInt(cursor.getColumnIndex(DownloadManager.COLUMN_STATUS)); // 获取其他状态信息，如文件路径、大小等 } cursor.close(); ``` ### 6. 使用`DownloadManager`的优点 - 自动管理下载任务，包括恢复中断的下载。 - 能够在后台运行，即使应用关闭或设备重启也能继续下载。 - 可以配置网络条件，如仅在Wi-Fi下下载。 - 提供了统一的API，简化了文件下载的实现。 ### 7. 注意事项 - 确保目标文件夹存在，否则`DownloadManager`可能无法保存文件。 - 保持`BroadcastReceiver`的生命周期管理，避免内存泄漏。 - 处理好权限问题，特别是Android 6.0（API 23）及更高版本，需要运行时权限。 以上就是关于Android中的`DownloadManager`服务的详细介绍，包括如何使用、监听下载状态以及其优势。通过合理使用`DownloadManager`，开发者可以构建高效、可靠的文件下载功能。