首页 > 文章 > 前端

AndroidWebView开启文件下载方法详解

时间：2025-09-10 18:26:35 286浏览收藏

推广推荐

支持 PC / 移动端，安全直达

想要在Android WebView中实现文件下载功能吗？本文详细讲解了如何为你的WebView应用开启文件下载能力，解决网页中JavaScript触发下载时遇到的问题。通过配置`DownloadListener`监听下载事件，动态申请存储权限，并利用`DownloadManager`实现安全可靠的文件下载。本文提供完整的代码示例，包括`DownloadListener`的配置、权限请求的处理、以及`downloadFile`方法的实现，助你轻松搞定WebView文件下载功能。立即阅读，让你的Android WebView应用支持文件下载！

在 Android WebView 应用中启用文件下载功能

本文档详细介绍了如何在 Android WebView 应用中启用文件下载功能，解决 WebView 应用无法直接下载网页中 JavaScript 代码触发的文件下载的问题。通过配置 DownloadListener、处理权限请求以及实现文件下载方法，使你的 WebView 应用能够安全可靠地下载文件。文章提供完整的代码示例，帮助开发者快速实现该功能。

配置 WebView 的 DownloadListener

首先，需要在 MainActivity 的 onCreate 方法中为 WebView 设置 DownloadListener。DownloadListener 负责监听下载事件，并在下载开始时执行相应的操作。

myWebView.setDownloadListener(new DownloadListener() {
    @Override
    public void onDownloadStart(String url, String userAgent, String contentDisposition, String mimetype, long contentLength) {
        String filename = URLUtil.guessFileName(url, contentDisposition, getFileType(url));
        sFileName = filename;
        sUrl = url;
        sUserAgent = userAgent;
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
            if (ContextCompat.checkSelfPermission(MainActivity.this, Manifest.permission.WRITE_EXTERNAL_STORAGE)
                    == PackageManager.PERMISSION_GRANTED) {
                downloadFile(filename, url, userAgent);
            } else {
                requestPermissions(new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE}, 1001);
            }
        } else {
            downloadFile(filename, url, userAgent);
        }
    }
});

这段代码首先尝试获取文件名，然后检查 Android 版本。如果版本高于 Android 6.0 (Marshmallow)，则需要动态申请 WRITE_EXTERNAL_STORAGE 权限。如果权限已授予，则调用 downloadFile 方法开始下载；否则，请求权限。对于较低版本的 Android，直接调用 downloadFile 方法。

处理权限请求

由于 Android 6.0 (Marshmallow) 引入了运行时权限，因此需要在用户授予权限后才能进行文件下载。在 onRequestPermissionsResult 方法中处理权限请求结果。

@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults);
    if (requestCode == 1001) {
        if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
            if (!sUrl.equals("") && !sFileName.equals("") && !sUserAgent.equals("")) {
                downloadFile(sFileName, sUrl, sUserAgent);
            }
        }
    }
}

这段代码检查请求码是否为 1001（与权限请求时使用的请求码一致），以及权限是否已授予。如果权限已授予，则调用 downloadFile 方法开始下载。

实现文件下载方法

downloadFile 方法使用 DownloadManager 下载文件。

private void downloadFile(String filename, String url, String userAgent) {
    try {
        DownloadManager.Request request = new DownloadManager.Request(
                Uri.parse(url));

        request.allowScanningByMediaScanner();
        request.setNotificationVisibility(DownloadManager.Request.VISIBILITY_VISIBLE_NOTIFY_COMPLETED); //Notify client once download is completed!
        request.setDestinationInExternalPublicDir(Environment.DIRECTORY_DOWNLOADS, filename);
        DownloadManager dm = (DownloadManager) getSystemService(DOWNLOAD_SERVICE);
        dm.enqueue(request);

        Toast.makeText(this, "Downloading File...", Toast.LENGTH_LONG).show();

        sUrl = "";
        sFileName = "";
        sUserAgent = "";
    } catch (Exception ignored) {
        Toast.makeText(this, ignored.toString(), Toast.LENGTH_SHORT).show();
    }
}

这段代码创建一个 DownloadManager.Request 对象，设置允许媒体扫描器扫描下载的文件、显示下载完成通知，以及设置下载文件的目标目录为公共下载目录。然后，通过 DownloadManager 将下载请求加入队列。

添加 WebChromeClient

为了处理网页中的权限请求，需要添加 WebChromeClient 并重写 onPermissionRequest 方法。

myWebView.setWebChromeClient(new WebChromeClient() {
    @Override
    public void onPermissionRequest(PermissionRequest request) {
        super.onPermissionRequest(request);
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
            request.grant(request.getResources());
        }
    }
});

WebSettings webSettings = myWebView.getSettings();
webSettings.setJavaScriptEnabled(true);

这段代码允许 WebView 请求权限，并启用 JavaScript。

声明必要的权限

确保在 AndroidManifest.xml 文件中声明了必要的权限：

<uses-permission android:name="android.permission.INTERNET"></uses-permission>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"></uses-permission>

INTERNET 权限用于访问网络，WRITE_EXTERNAL_STORAGE 权限用于将文件保存到外部存储。

完整代码示例

package com.example.stockapptestbeta;

import androidx.annotation.NonNull;
import androidx.appcompat.app.AppCompatActivity;
import androidx.core.content.ContextCompat;

import android.Manifest;
import android.app.DownloadManager;
import android.content.pm.PackageManager;
import android.net.Uri;
import android.os.Build;
import android.os.Bundle;
import android.os.Environment;
import android.webkit.CookieManager;
import android.webkit.DownloadListener;
import android.webkit.PermissionRequest;
import android.webkit.URLUtil;
import android.webkit.WebChromeClient;
import android.webkit.WebSettings;
import android.webkit.WebView;
import android.webkit.WebViewClient;
import android.widget.Toast;

public class MainActivity extends AppCompatActivity {

    private WebView myWebView;
    private String sFileName, sUrl, sUserAgent;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        myWebView = findViewById(R.id.webview);
        myWebView.setWebViewClient(new WebViewClient());

        myWebView.setDownloadListener(new DownloadListener() {
            @Override
            public void onDownloadStart(String url, String userAgent, String contentDisposition, String mimetype, long contentLength) {
                String filename = URLUtil.guessFileName(url, contentDisposition, getFileType(url));
                sFileName = filename;
                sUrl = url;
                sUserAgent = userAgent;
                if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
                    if (ContextCompat.checkSelfPermission(MainActivity.this, Manifest.permission.WRITE_EXTERNAL_STORAGE)
                            == PackageManager.PERMISSION_GRANTED) {
                        downloadFile(filename, url, userAgent);
                    } else {
                        requestPermissions(new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE}, 1001);
                    }
                } else {
                    downloadFile(filename, url, userAgent);
                }
            }
        });

        myWebView.setWebChromeClient(new WebChromeClient() {
            @Override
            public void onPermissionRequest(PermissionRequest request) {
                super.onPermissionRequest(request);
                if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
                    request.grant(request.getResources());
                }
            }
        });

        WebSettings webSettings = myWebView.getSettings();
        webSettings.setJavaScriptEnabled(true);

        myWebView.loadUrl("http://192.168.0.22"); // Replace with your URL
    }

    @Override
    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
        if (requestCode == 1001) {
            if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
                if (!sUrl.equals("") && !sFileName.equals("") && !sUserAgent.equals("")) {
                    downloadFile(sFileName, sUrl, sUserAgent);
                }
            }
        }
    }

    private void downloadFile(String filename, String url, String userAgent) {
        try {
            DownloadManager.Request request = new DownloadManager.Request(
                    Uri.parse(url));

            request.allowScanningByMediaScanner();
            request.setNotificationVisibility(DownloadManager.Request.VISIBILITY_VISIBLE_NOTIFY_COMPLETED); //Notify client once download is completed!
            request.setDestinationInExternalPublicDir(Environment.DIRECTORY_DOWNLOADS, filename);
            DownloadManager dm = (DownloadManager) getSystemService(DOWNLOAD_SERVICE);
            dm.enqueue(request);

            Toast.makeText(this, "Downloading File...", Toast.LENGTH_LONG).show();

            sUrl = "";
            sFileName = "";
            sUserAgent = "";
        } catch (Exception ignored) {
            Toast.makeText(this, ignored.toString(), Toast.LENGTH_SHORT).show();
        }
    }

    // Helper method to get file type
    private String getFileType(String url) {
        String type = null;
        String extension = MimeTypeMap.getFileExtensionFromUrl(url);
        if (extension != null) {
            type = MimeTypeMap.getSingleton().getMimeTypeFromExtension(extension);
        }
        return type;
    }

    @Override
    public void onBackPressed() {
        if (myWebView.canGoBack()) {
            myWebView.goBack();
        } else {
            super.onBackPressed();
        }
    }
}

注意事项：

确保替换 myWebView.loadUrl("http://192.168.0.22"); 为你的网页 URL。
getFileType 方法需要 android.webkit.MimeTypeMap 类，确保已导入。
在实际应用中，需要更完善的错误处理和用户体验优化。

总结：

通过配置 DownloadListener、处理权限请求以及使用 DownloadManager，可以轻松地在 Android WebView 应用中启用文件下载功能。本文提供的代码示例可以作为快速入门的指南，帮助开发者快速实现该功能。

终于介绍完啦！小伙伴们，这篇关于《AndroidWebView开启文件下载方法详解》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！