Android DownloadManager使用示例教程

在Android开发中，DownloadManager是一个系统级服务，用于处理大文件的下载任务。它为第三方应用提供了管理下载的API，使得应用能够在用户不可见的情况下，进行后台下载操作。这对于需要下载大量数据的应用来说非常有用，例如更新应用程序、下载媒体文件等。 ### DownloadManager的使用 #### 1. 创建下载请求 要使用DownloadManager，首先需要创建一个下载请求。可以通过DownloadManager类的静态内部类Request来创建。在这个请求中，可以指定许多选项，如下载的URL、下载的标题、描述、是否需要漫游、是否为可见文件等。请求一旦创建，就可以通过调用系统的DownloadManager服务进行下载。 #### 2. 启动下载任务 启动下载任务是通过系统服务完成的，即通过调用Activity的getContentResolver().enqueue方法。在这个方法中，需要传入前面创建的DownloadManager.Request对象。系统会为下载任务返回一个Long类型的下载ID，这个ID可以用来查询下载的状态或者取消下载任务。 #### 3. 查询下载状态 下载状态的查询可以通过DownloadManager的另一个静态内部类Query来进行。通过传入下载ID，可以查询到对应的下载任务的详细信息，包括下载的进度、状态、文件大小等。这些信息对于创建一个用户友好的下载界面非常有用，比如显示下载进度条、下载完成提示等。 #### 4. 处理下载完成 下载任务完成后，系统会触发一个广播，通知应用下载已经完成。应用需要注册一个广播接收器，监听下载完成的广播。广播接收器中的Intent将包含下载任务的ID，可以使用该ID来查询下载的文件路径，并进行后续处理，如打开文件、显示下载完成的提示等。 ### 实际使用示例 以下是一个简单的示例，展示了如何使用DownloadManager进行文件下载： ```java public void downloadFile(String url) { // 获取DownloadManager系统服务 DownloadManager downloadManager = (DownloadManager) getSystemService(DOWNLOAD_SERVICE); // 创建下载请求 DownloadManager.Request request = new DownloadManager.Request(Uri.parse(url)); // 设置允许漫游下载 request.setAllowedNetworkTypes(DownloadManager.Request.NETWORK_MOBILE | DownloadManager.Request.NETWORK_WIFI); // 设置可见性为公共，即在通知栏显示下载状态 request.setVisibleInDownloadsUi(true); // 设置通知的标题 request.setTitle("Download Example"); // 设置下载文件的MIME类型，这里假设下载的是PDF文件 request.setMimeType("application/pdf"); // 启动下载任务并获取下载ID long downloadId = downloadManager.enqueue(request); // 注册广播接收器，监听下载完成 IntentFilter filter = new IntentFilter(DownloadManager.ACTION_DOWNLOAD_COMPLETE); registerReceiver(mReceiver, filter); // 广播接收器，用于处理下载完成后的操作 private BroadcastReceiver mReceiver = new BroadcastReceiver() { @Override public void onReceive(Context context, Intent intent) { // 获取下载ID long referenceId = intent.getLongExtra(DownloadManager.EXTRA_DOWNLOAD_ID, -1); // 查询下载任务是否完成 DownloadManager.Query query = new DownloadManager.Query(); query.setFilterById(referenceId); Cursor cursor = downloadManager.query(query); if (cursor.moveToFirst()) { int columnIndex = cursor.getColumnIndex(DownloadManager.COLUMN_STATUS); if (DownloadManager.STATUS_SUCCESSFUL == cursor.getInt(columnIndex)) { // 下载成功，获取下载文件的路径 columnIndex = cursor.getColumnIndex(DownloadManager.COLUMN_LOCAL_URI); String uri = cursor.getString(columnIndex); // 可以根据得到的文件路径对文件进行操作，例如显示一个Toast消息 } } cursor.close(); // 取消注册广播接收器，避免内存泄漏 unregisterReceiver(mReceiver); } }; } ``` ### 注意事项 - 在AndroidManifest.xml中，需要添加对应的权限： ```xml <uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> ``` - 从Android 6.0（API 级别 23）开始，还需要在运行时请求WRITE_EXTERNAL_STORAGE权限。 ### 结语 通过Android的DownloadManager，开发者可以比较方便地实现复杂的下载功能，并且能够有效地管理下载任务。上述知识点涵盖了DownloadManager的基本使用方法和关键实现步骤，以帮助开发者在开发Android应用时，能够更高效地实现下载功能。