Android端Epub3阅读导航跳转外部浏览器的Android Studio配置问询

你遇到的Epub3内部导航跳外部浏览器的问题，本质是渲染Epub内容的WebView默认未配置跳转拦截规则，遇到页面跳转请求会主动触发系统Intent调用外部浏览器打开，无需修改Calibre侧的上传逻辑，直接在Android端修改WebView配置即可解决。

1. 拦截WebView所有跳转请求 #

重写WebViewClient的shouldOverrideUrlLoading方法，识别Epub内部链接并强制在当前WebView加载，禁止触发外部跳转：

webView.webViewClient = object : WebViewClient() {
    override fun shouldOverrideUrlLoading(view: WebView?, request: WebResourceRequest?): Boolean {
        val targetUrl = request?.url.toString()
        // 适配两种场景：本地存储的Epub资源、CMS服务端存储的Epub资源
        val isInternalLink = targetUrl.startsWith("file://") || targetUrl.startsWith("你的CMS服务域名，如https://your-cms.com")
        return if (isInternalLink) {
            view?.loadUrl(targetUrl)
            true
        } else {
            // 非内部链接直接拦截，避免跳转到外部站点
            true
        }
    }
}

如果使用Java开发，对应重写同名方法逻辑一致即可。

2. 补充WebView基础配置 #

初始化WebView时添加以下配置，避免Calibre生成的Epub内嵌脚本触发跳转：

webView.settings.apply {
    // 允许加载Epub所需的本地资源
    allowFileAccess = true
    allowContentAccess = true
    // 禁用JS自动打开新窗口
    javaScriptCanOpenWindowsAutomatically = false
    setSupportMultipleWindows(false)
    // 开启JS支持，适配Epub3的交互逻辑
    javaScriptEnabled = true
}

3. 特殊场景适配 #

如果上述配置后仍存在跳转，可注入JS拦截全局打开新页面的逻辑，覆盖Calibre脚本的跳转方法：

// 等待页面加载完成后注入JS
webView.webViewClient = object : WebViewClient() {
    override fun onPageFinished(view: WebView?, url: String?) {
        super.onPageFinished(view, url)
        view?.evaluateJavascript("""
            window.open = function(url) {
                location.href = url;
                return null;
            }
        """.trimIndent(), null)
    }
}

配置完成后测试Epub的章节切换、锚点跳转、内嵌链接点击，所有内部导航操作都会在当前WebView内完成，不会触发外部浏览器启动，也不会跳转到应用外的站点。

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