Android WebView文件下载问题：如何启用指定域名的下载功能？

嘿，作为Android开发新手，你这个思路挺聪明的——用WebView做应用，更新网站就能同步更新应用，省了不少麻烦！不过WebView默认确实不会自动处理下载请求，得咱们手动配置一下，而且还要结合权限和域名过滤来实现指定网站的下载功能。下面一步步来帮你解决：

1. 给WebView设置下载监听器 #

WebView本身不会触发下载操作，你需要给它设置一个DownloadListener，在用户点击下载链接时捕获请求，然后用系统的DownloadManager来处理下载任务。

在你的MainActivity里，找到初始化WebView的代码，加上这段：

// 先声明几个成员变量用来暂存下载参数
private String pendingDownloadUrl;
private String pendingContentDisposition;
private String pendingMimeType;

// 初始化WebView时设置下载监听器
webView.setDownloadListener(new DownloadListener() {
    @Override
    public void onDownloadStart(String url, String userAgent, String contentDisposition, String mimeType, long contentLength) {
        // 替换成你允许下载的目标网站域名，比如"example.com"
        String allowedDomain = "你的指定域名";
        Uri uri = Uri.parse(url);
        // 校验域名，只处理指定网站的下载请求
        if (allowedDomain.equals(uri.getHost())) {
            // 检查权限后启动下载
            checkPermissionsAndStartDownload(url, contentDisposition, mimeType);
        } else {
            Toast.makeText(MainActivity.this, "仅允许下载指定网站的文件", Toast.LENGTH_SHORT).show();
        }
    }
});

2. 处理运行时权限 #

你已经在清单文件里声明了权限，但Android 6.0（API 23）及以上版本，WRITE_EXTERNAL_STORAGE和READ_EXTERNAL_STORAGE属于危险权限，需要在运行时动态申请。添加下面的权限检查方法：

private static final int REQUEST_STORAGE_PERMISSIONS = 1001;

private void checkPermissionsAndStartDownload(String url, String contentDisposition, String mimeType) {
    // 检查存储权限是否已授予
    if (ContextCompat.checkSelfPermission(this, Manifest.permission.WRITE_EXTERNAL_STORAGE)
            != PackageManager.PERMISSION_GRANTED) {
        // 暂存下载参数，权限申请成功后再执行
        this.pendingDownloadUrl = url;
        this.pendingContentDisposition = contentDisposition;
        this.pendingMimeType = mimeType;
        // 发起权限申请
        ActivityCompat.requestPermissions(this,
                new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE, Manifest.permission.READ_EXTERNAL_STORAGE},
                REQUEST_STORAGE_PERMISSIONS);
    } else {
        // 权限已授予，直接启动下载
        startDownload(url, contentDisposition, mimeType);
    }
}

// 处理权限申请结果
@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults);
    if (requestCode == REQUEST_STORAGE_PERMISSIONS) {
        if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
            // 权限申请成功，执行暂存的下载请求
            if (pendingDownloadUrl != null) {
                startDownload(pendingDownloadUrl, pendingContentDisposition, pendingMimeType);
                // 清空暂存参数
                pendingDownloadUrl = null;
                pendingContentDisposition = null;
                pendingMimeType = null;
            }
        } else {
            Toast.makeText(this, "需要存储权限才能下载文件", Toast.LENGTH_SHORT).show();
        }
    }
}

3. 实现下载逻辑（用DownloadManager） #

接下来实现startDownload方法，调用系统的DownloadManager来处理下载：

private void startDownload(String url, String contentDisposition, String mimeType) {
    DownloadManager.Request request = new DownloadManager.Request(Uri.parse(url));
    // 设置下载通知的标题和描述
    request.setTitle("文件下载");
    request.setDescription("正在下载，请稍候...");
    // 自动解析文件名，保存到公共下载目录
    String fileName = URLUtil.guessFileName(url, contentDisposition, mimeType);
    request.setDestinationInExternalPublicDir(Environment.DIRECTORY_DOWNLOADS, fileName);
    // 设置通知栏显示下载进度，下载完成后也会通知
    request.setNotificationVisibility(DownloadManager.Request.VISIBILITY_VISIBLE_NOTIFY_COMPLETED);
    // 获取DownloadManager实例并发起下载请求
    DownloadManager downloadManager = (DownloadManager) getSystemService(DOWNLOAD_SERVICE);
    if (downloadManager != null) {
        downloadManager.enqueue(request);
        Toast.makeText(this, "开始下载", Toast.LENGTH_SHORT).show();
    }
}

额外注意事项 #

• Android 10+适配：Android 10引入了分区存储，如果你要适配API 29+，可以在清单文件的<application>标签里添加android:requestLegacyExternalStorage="true"来暂时兼容旧的存储方式；如果要完全适配分区存储，需要改用MediaStore来保存文件（新手可以先从兼容模式入手）。
• 权限清单优化：你的清单里的ACCESS_DOWNLOAD_MANAGER并不是标准系统权限，不需要声明也能使用DownloadManager，可以把这个权限去掉。
• WebView基础配置：确保你的WebView启用了必要的设置，比如JavaScript（如果网站依赖的话）：

  WebSettings webSettings = webView.getSettings();
  webSettings.setJavaScriptEnabled(true);
  webSettings.setDomStorageEnabled(true);
  

这样配置之后，你的WebView就能只允许指定域名的文件下载，并且完美处理权限问题啦！

内容的提问来源于stack exchange，提问作者Simone