在android应用开发中，我们经常需要处理文件下载的需求，例如从firebase storage获取文件的下载链接（downloadurl），然后将文件保存到用户的设备上。常见的做法是直接在浏览器中打开这些链接，但这通常不符合用户期望，用户可能更希望文件能够直接下载并存储到本地。本教程将指导您如何使用android系统内置的downloadmanager服务来实现这一功能。
1. 理解文件下载需求
假设您的应用从Firebase Storage获取到文件（如PDF、图片或文本文件）的下载URL，并将其展示在RecyclerView中。当用户点击列表项时，期望的行为是将文件下载到手机的特定文件夹，而不是跳转到浏览器查看。这正是DownloadManager发挥作用的场景。
2. 配置必要的权限
为了让应用能够访问网络并写入外部存储，您需要在AndroidManifest.xml文件中声明以下权限：
注意： 从Android 6.0 (API 23) 开始，WRITE_EXTERNAL_STORAGE和READ_EXTERNAL_STORAGE属于危险权限，需要在运行时动态请求用户授权。
3. 运行时权限检查与请求
在执行文件下载操作之前，您需要检查应用是否已获得WRITE_EXTERNAL_STORAGE和READ_EXTERNAL_STORAGE权限。如果未获得，则需要向用户请求。
首先，定义一个辅助方法来检查权限：
Android应用程序消息处理机制分析 中文WORD版
下载
Android应用程序是通过消息来驱动的，系统为每一个应用程序维护一个消息队例，应用程序的主线程不断地从这个消息队例中获取消息（Looper），然后对这些消息进行处理（Handler），这样就实现了通过消息来驱动应用程序的执行，本文将详细分析Android应用程序的消息处理机制。有需要的朋友可以下载看看
import android.content.Context;
import android.content.pm.PackageManager;
import androidx.core.app.ActivityCompat;
public class PermissionUtils {
public static boolean hasPermissions(Context context, String... permissions) {
if (context != null && permissions != null) {
for (String permission : permissions) {
if (ActivityCompat.checkSelfPermission(context, permission) != PackageManager.PERMISSION_GRANTED) {
return false;
}
}
}
return true;
}
}然后，在您的Activity或Fragment中，调用此方法并在必要时请求权限：
import android.Manifest;
import android.app.Activity;
import android.content.pm.PackageManager;
import android.os.Build;
import android.widget.Toast;
import androidx.annotation.NonNull;
import androidx.core.app.ActivityCompat;
public class YourActivity extends Activity {
private static final int PERMISSION_REQUEST_CODE = 100;
private String fileDownloadUrl; // 存储待下载文件的URL
// ... 其他Activity生命周期方法 ...
public void startFileDownload(String url) {
this.fileDownloadUrl = url; // 保存URL以便在权限授予后使用
String[] permissions = {
Manifest.permission.WRITE_EXTERNAL_STORAGE,
Manifest.permission.READ_EXTERNAL_STORAGE
};
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M && !PermissionUtils.hasPermissions(this, permissions)) {
// 如果是Android 6.0及以上，并且没有权限，则请求权限
ActivityCompat.requestPermissions(this, permissions, PERMISSION_REQUEST_CODE);
} else {
// 已有权限或Android 6.0以下，直接开始下载
downloadFile(fileDownloadUrl);
}
}
@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
super.onRequestPermissionsResult(requestCode, permissions, grantResults);
if (requestCode == PERMISSION_REQUEST_CODE) {
if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
// 权限已授予，开始下载
downloadFile(fileDownloadUrl);
} else {
// 权限被拒绝
Toast.makeText(this, "存储权限被拒绝，无法下载文件", Toast.LENGTH_SHORT).show();
}
}
}
// ... downloadFile 方法将在下一节实现 ...
}4. 使用 DownloadManager 下载文件
一旦权限就绪，您就可以使用DownloadManager来执行文件下载操作。
import android.app.DownloadManager;
import android.content.Context;
import android.net.Uri;
import android.os.Environment;
import android.webkit.MimeTypeMap;
import java.io.File;
public class YourActivity extends Activity { // 假设这是您的Activity
// ... (权限检查和请求代码) ...
private void downloadFile(String url) {
// 创建下载请求
DownloadManager.Request request = new DownloadManager.Request(Uri.parse(url));
// 设置下载通知的标题和描述
request.setDescription("文件下载中...");
request.setTitle("下载文件");
// 允许媒体扫描器扫描文件，以便文件下载完成后在媒体库中可见
request.allowScanningByMediaScanner();
// 设置通知栏的可见性，下载完成后显示完成通知
request.setNotificationVisibility(DownloadManager.Request.VISIBILITY_VISIBLE_NOTIFY_COMPLETED);
// 获取文件扩展名，用于生成文件名
String fileName = getFileNameFromUrl(url); // 辅助方法，用于从URL中提取文件名
if (fileName == null || fileName.isEmpty()) {
// 如果无法从URL中提取，可以设置一个默认名或根据URL内容生成
fileName = "downloaded_file_" + System.currentTimeMillis() + ".pdf"; // 示例：默认PDF
}
// 设置文件保存的目标目录和文件名
// Environment.DIRECTORY_DOWNLOADS 是公共的下载目录
request.setDestinationInExternalPublicDir(Environment.DIRECTORY_DOWNLOADS, fileName);
// 获取DownloadManager服务并加入下载队列
DownloadManager manager = (DownloadManager) getSystemService(Context.DOWNLOAD_SERVICE);
if (manager != null) {
manager.enqueue(request);
Toast.makeText(this, "文件开始下载", Toast.LENGTH_SHORT).show();
} else {
Toast.makeText(this, "下载服务不可用", Toast.LENGTH_SHORT).show();
}
}
/**
* 辅助方法：尝试从URL中提取文件名。
* 实际应用中可能需要更健壮的解析逻辑。
*/
private String getFileNameFromUrl(String url) {
// 示例：从URL路径中提取最后一部分作为文件名
// https://firebasestorage.googleapis.com/.../08-11-2022_15%3A43%3A02_dummy.pdf?alt=media&token=...
try {
Uri uri = Uri.parse(url);
String path = uri.getPath();
if (path != null) {
return path.substring(path.lastIndexOf('/') + 1);
}
} catch (Exception e) {
e.printStackTrace();
}
return null;
}
}5. DownloadManager.Request 关键方法说明
- DownloadManager.Request(Uri uri): 构造函数，传入待下载文件的URI。
- setDescription(CharSequence description): 设置下载任务在通知栏中显示的描述信息。
- setTitle(CharSequence title): 设置下载任务在通知栏中显示的标题。
- allowScanningByMediaScanner(): 允许系统媒体扫描器扫描下载的文件，使其在图库或其他媒体应用中可见。
- setNotificationVisibility(int visibility): 设置下载通知的可见性。常用的值有：
- VISIBILITY_VISIBLE_NOTIFY_COMPLETED: 下载过程中显示通知，下载完成后显示完成通知。
- VISIBILITY_VISIBLE: 下载过程中始终显示通知。
- VISIBILITY_HIDDEN: 不显示任何通知。
- setDestinationInExternalPublicDir(String dirType, String subPath): 设置文件保存的公共目录和子路径。Environment.DIRECTORY_DOWNLOADS是一个常用的公共下载目录。subPath是文件名。
6. 注意事项与最佳实践
- 文件名处理： 从URL中直接提取文件名可能不够健壮。更好的做法是，如果您的Firebase Storage存储路径包含有意义的文件名，可以从路径中解析；或者在上传文件时，将原始文件名与下载URL一起存储在数据库中，下载时直接使用。
- 网络状态： 在开始下载前，建议检查设备的网络连接状态，避免在无网络时启动下载任务。
- 用户反馈： 除了Toast提示，您还可以通过监听DownloadManager的广播来获取下载进度和完成状态，从而提供更详细的用户反馈。
- Android 10 (API 29) 及以上： 对于Android 10及更高版本，引入了分区存储（Scoped Storage）。虽然Environment.DIRECTORY_DOWNLOADS仍然是可用的公共目录，但如果您的应用需要访问特定私有目录或对文件进行更复杂的操作，可能需要适配分区存储的API（如MediaStore）。本教程中的方法对于下载到公共目录是有效的。
- 错误处理： DownloadManager在下载失败时会更新通知状态。您可以注册一个BroadcastReceiver来监听DownloadManager.ACTION_DOWNLOAD_COMPLETE广播，并在其中检查下载状态，以便处理下载失败的情况。
通过遵循本教程的步骤，您可以在Android应用中优雅地实现从Firebase Storage下载文件到用户设备的本地存储，从而提升用户体验。
