如何从设备下载文件夹加载带资源的HTML游戏文件到WebView

我来帮你梳理代码里的核心问题，再给出适配高版本Android的正确实现：

你的代码里存在的关键问题 #

• 本地文件路径缺少file://前缀：WebView加载本地文件必须以file://开头，你直接传入/storage/emulated/0/Download/index.html这种路径，WebView会把它当成网络URL，自然无法加载。
• Uri处理逻辑适配性差：通过uri1.getPath().split(":")拆分路径的方式只适用于旧版本Android，在Android 10+的Scoped Storage机制下，系统返回的是content://开头的Uri，这种拆分方法会直接失效，拿不到真实的文件路径。
• 错误调用evaluateJavascript：这个方法是用来执行JavaScript代码的，不是用来加载文件路径的，这行代码完全多余，还可能引发不必要的错误。
• Intent配置不规范：你用ACTION_GET_CONTENT时直接指定Download文件夹的Uri，这种写法在高版本Android下会被系统忽略，无法正确定位到初始目录。

正确的实现步骤与代码 #

1. 先申请必要的存储权限 #

在AndroidManifest.xml中添加权限声明：

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

如果你的App targetSdkVersion >=23，还需要动态申请权限：

private static final int REQUEST_PERMISSION_CODE = 1001;

// 在Activity onCreate或者文件选择前调用
private void requestStoragePermission() {
    if (ContextCompat.checkSelfPermission(this, Manifest.permission.READ_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED) {
        ActivityCompat.requestPermissions(this, new String[]{Manifest.permission.READ_EXTERNAL_STORAGE}, REQUEST_PERMISSION_CODE);
    }
}

2. 用适配高版本的文件选择Intent #

替换原来的Intent，用ACTION_OPEN_DOCUMENT更适配Scoped Storage，同时指定初始目录为Download文件夹：

private static final int PICKFILE_RESULT_CODE = 1002;

// 打开文件选择器的方法
private void openHtmlFilePicker() {
    Intent intent = new Intent(Intent.ACTION_OPEN_DOCUMENT);
    intent.addCategory(Intent.CATEGORY_OPENABLE);
    intent.setType("text/html");
    // 指定初始目录为Download（Android 10+支持）
    Uri downloadUri = MediaStore.Downloads.EXTERNAL_CONTENT_URI;
    intent.setDataAndType(downloadUri, "text/html");
    startActivityForResult(intent, PICKFILE_RESULT_CODE);
}

3. 正确处理返回的Uri并加载WebView #

因为高版本Android返回的content://Uri无法直接作为文件路径加载，我们可以把文件复制到App的私有目录，再加载私有目录里的文件（这种方式权限更稳定）：

@Override
protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    switch (requestCode) {
        case PICKFILE_RESULT_CODE:
            if (resultCode == RESULT_OK && data != null) {
                Uri uri = data.getData();
                if (uri != null) {
                    // 将选中的HTML文件复制到App私有目录
                    File localHtmlFile = copyContentUriToPrivateDir(this, uri, "game_html.html");
                    if (localHtmlFile != null && localHtmlFile.exists()) {
                        // 配置WebView并加载文件
                        setupWebViewSettings();
                        String loadUrl = "file://" + localHtmlFile.getAbsolutePath();
                        mywebview.loadUrl(loadUrl);
                    }
                }
            }
            break;
    }
}

// 复制content:// Uri对应的文件到App私有目录的工具方法
private File copyContentUriToPrivateDir(Context context, Uri uri, String fileName) {
    try {
        InputStream inputStream = context.getContentResolver().openInputStream(uri);
        if (inputStream == null) return null;
        
        File outputDir = context.getFilesDir();
        File outputFile = new File(outputDir, fileName);
        
        FileOutputStream outputStream = new FileOutputStream(outputFile);
        byte[] buffer = new byte[1024];
        int length;
        while ((length = inputStream.read(buffer)) != -1) {
            outputStream.write(buffer, 0, length);
        }
        
        inputStream.close();
        outputStream.close();
        return outputFile;
    } catch (IOException e) {
        e.printStackTrace();
        return null;
    }
}

// 配置WebView的必要设置
private void setupWebViewSettings() {
    mywebview.setWebContentsDebuggingEnabled(true);
    WebSettings webSettings = mywebview.getSettings();
    
    webSettings.setJavaScriptEnabled(true);
    webSettings.setBuiltInZoomControls(true);
    webSettings.setUseWideViewPort(true);
    // 允许文件相关的访问权限，确保HTML里的图片、音频、动画能正常加载
    webSettings.setAllowUniversalAccessFromFileURLs(true);
    webSettings.setAllowFileAccessFromFileURLs(true);
    webSettings.setAllowFileAccess(true);
    
    mywebview.clearCache(true);
    mywebview.setWebViewClient(new WebViewClientClass());
}

private class WebViewClientClass extends WebViewClient {
    @Override
    public boolean shouldOverrideUrlLoading(WebView view, String url) {
        // 只拦截本地文件的跳转，避免打开外部浏览器
        if (url.startsWith("file://")) {
            view.loadUrl(url);
            return true;
        }
        // 外部链接交给系统处理
        return super.shouldOverrideUrlLoading(view, url);
    }
}

额外注意事项 #

• 如果你的HTML游戏依赖同目录下的其他资源（比如图片、音频、JS脚本），只复制单个HTML文件是不够的，需要让用户选择整个文件夹（Android 11+支持ACTION_OPEN_DOCUMENT_TREE），然后复制整个目录到私有目录。
• 打开WebView调试模式后，你可以在Chrome浏览器的chrome://inspect页面查看WebView的控制台日志，方便排查资源加载失败的具体原因。
• Android 12+对WebView的权限限制更严格，确保你已经开启了所有必要的文件访问设置。

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