downloadmanager

在Android开发中，`DownloadManager` 是一个系统服务，用于管理长时间运行的下载任务，它提供了后台下载文件的能力，并且可以处理网络中断、设备重启等复杂情况。本篇将深入探讨`DownloadManager`的使用方法及其核心知识点。 一、`DownloadManager`简介 ------------------------- `DownloadManager` 是Android API Level 9（ Gingerbread）引入的一个类，位于`android.app`包下。它提供了一种可靠的方式来安排和监控文件下载。通过这个接口，开发者可以在应用中启动下载任务，而无需直接处理网络连接或文件I/O操作，极大地简化了文件下载的实现。 二、添加权限 -------------- 在使用`DownloadManager`之前，需要在AndroidManifest.xml中添加以下权限： ```xml <uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> ``` `INTERNET` 权限用于进行网络访问，`WRITE_EXTERNAL_STORAGE` 权限则允许应用写入外部存储。 三、获取`DownloadManager`实例 -------------------------------- 通过`Context`的`getSystemService()`方法，我们可以获取到`DownloadManager`的实例： ```java DownloadManager downloadManager = (DownloadManager) getSystemService(Context.DOWNLOAD_SERVICE); ``` 四、创建下载请求 ----------------- 创建一个`DownloadManager.Request`对象来配置下载任务的属性，如URL、文件名、通知设置、优先级等： ```java Uri downloadUri = Uri.parse("http://example.com/file.zip"); DownloadManager.Request request = new DownloadManager.Request(downloadUri); // 设置文件保存的位置 request.setDestinationInExternalPublicDir(Environment.DIRECTORY_DOWNLOADS, "file.zip"); // 设置其他属性，如可见性、通知等 request.setVisibleInDownloadsUi(true); request.setTitle("文件下载"); request.setDescription("这是一个使用DownloadManager的示例"); // 将请求加入到队列 long downloadId = downloadManager.enqueue(request); ``` 五、监听下载状态 ---------------- 可以通过注册`BroadcastReceiver`来监听下载任务的状态变化： ```java public class DownloadReceiver extends 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 != null && 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(); } } } } ``` 六、暂停与取消下载 ------------------ 通过`DownloadManager`的`remove()`方法，可以取消或者暂停下载任务： ```java downloadManager.remove(downloadId); ``` 七、其他高级功能 ------------------- - `DownloadManager`支持断点续传，当设备重启或者网络中断后，会自动恢复下载。 - 可以通过`setAllowedNetworkTypes()`限制在哪些网络类型（如Wi-Fi或移动数据）下进行下载。 - 使用`setNotificationVisibility()`控制通知栏显示。 - 通过`setAllowedOverRoaming()`设置是否允许在漫游状态下下载。 八、总结 ---------- `DownloadManager`是Android提供的一种强大而便捷的文件下载工具，它可以处理复杂的下载场景，简化开发者的工作。通过合理配置`Request`对象和监听下载状态，可以实现高效、稳定的文件下载功能。在实际开发中，可以根据项目需求灵活运用这些知识点，提升用户体验。