本文档详细介绍了如何在 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 方法。
ectouch多通道支付插件
下载
ectouch多通道支付插件可以为ectouch网站提供相应的在线支付功能。安装步骤：一、备份原ectouch网站源文件；二、下载以上“ectouch支付插件”附件；三、解压缩后上传“payment”目录至“ectouch”目录下的“plugins”目录中，覆盖原文件。四、安装完成
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 文件中声明了必要的权限：
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 应用中启用文件下载功能。本文提供的代码示例可以作为快速入门的指南，帮助开发者快速实现该功能。
