本文档详细介绍了如何在 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 应用中启用文件下载功能。本文提供的代码示例可以作为快速入门的指南，帮助开发者快速实现该功能。
© 版权声明
文章版权归作者所有，未经允许请勿转载。
THE END
