前言#

在移动应用开发中，WebView 是一个强大的工具，它允许我们在应用内展示网页内容，实现与网页的交互。本文将深入探讨 WebView 的各种功能和应用场景，并提供详细的代码示例，帮助开发者全面掌握 WebView 的使用。

一.获取WebView#

不同的平台或布局，获取 WebView 的方式有所不同。先说LuaWebView，在自行设置控件时，假设是这样的：

1
--省略框架
2
    {
3
      LuaWebView,
4
      id="LuaWebView",
5
      layout_width='wrap',
6
      layout_height='350dp',
7
    },
8
--省略框架
9
LuaWebView.loadUrl("https://baiyi.ink")--加载网页

那此时我们的WebView应该这样获取并进行设置：

1
local webSettings = LuaWebView.getSettings();
2
webSettings.setUseWideViewPort(true);
3
webSettings.setLoadWithOverviewMode(true);
4
--// 禁用缓存
5
local WebSettings = luajava.bindClass "android.webkit.WebSettings"
6
webSettings.setCacheMode(WebSettings.LOAD_NO_CACHE);
7
--// 开启js支持
8
webSettings.setJavaScriptEnabled(true);
9

10
local WebViewClient = luajava.bindClass "android.webkit.WebViewClient"
11

12
LuaWebView.setWebViewClient(luajava.override(WebViewClient,{
13
  shouldOverrideUrlLoading=function(superCall,view,webResourceRequest)
14
    --即将开始加载事件
15
    --返回true则拦截本次加载
16
    --拦截加载建议在这里操作
17
    --判断加载的链接
18
    if webResourceRequest.getUrl().toSafeString():find("") then
19
      return true
20
    end
21
    return false
22
  end,
23
  onReceivedSslError=function(superCall, view, sslErrorHandler, sslError)
24
    --ssl证书错误处理事件
25
    --需自行处理，否则在FA2中会导致卡死
26
    --返回true拦截原事件
27
    local sslErr = {
28
      [4] = "SSL_DATE_INVALID\n证书的日期无效",
29
      [1] = "SSL_EXPIRED\n证书已过期",
30
      [2] = "SSL_IDMISMATCH\n主机名称不匹配",
31
      [5] = "SSL_INVALID\n发生一般性错误",
32
      [6] = "SSL_MAX_ERROR\n此常量在API级别14中已弃用。此常数对于使用SslError API不是必需的，并且可以从发行版更改为发行版。",
33
      [0] = "SSL_NOTYETVALID\n证书尚未生效",
34
      [3] = "SSL_UNTRUSTED\n证书颁发机构不受信任"
35
    }
36
    print(sslError.getUrl().."遇到了SSL证书错误，错误类型:"..sslError.getPrimaryError().."\n"..sslErr[sslError.getPrimaryError()])
37
    --忽略错误
38
    sslErrorHandler.proceed()
39
    --取消加载(这是默认行为)
40
    --sslErrorHandler.cancel()
41
    return true
42
  end,
43
}))

再以 FA2 自带 WebView 为例，监听所有浏览页：

1
--监听全部浏览器的事件
2
--由于fa2手册自带的浏览器状态监听智能监听第一个浏览页
3
--Adam·Eva重新写了个监听所有浏览页的
4
import "net.fusionapp.core.ui.fragment.WebInterface"
5
import "androidx.viewpager.widget.ViewPager$OnPageChangeListener"
6
local uiManager=this.uiManager
7
local viewPager=uiManager.viewPager
8
local pagerAdapter=uiManager.pagerAdapter
9
local pagerCount=pagerAdapter.getCount()
10
function webInterface()
11
  for i = 0,pagerCount-1,1 do
12
    local fragment=uiManager.getFragment(i)
13
    if fragment then
14
      fragment.setWebInterface(WebInterface{onPageFinished=function(view,url)
15
          --页面加载结束事件
16
        end,
17
        onPageStarted=function(view,url,favicon)
18
          --页面开始加载事件
19
        end,
20
        onReceivedTitle=function(view,title)
21
          --获取到网页标题时加载的事件
22
        end,
23
        onLoadResource=function(view,url)
24
          --页面资源加载监听
25
          --可通过该方法获取网页上的资源
26
        end,
27
        onUrlLoad=function(view,url)
28
          --即将开始加载事件，url参数是即将加载的url
29
          --该函数返回一个布尔值
30
          --返回true则拦截本次加载
31
          return false
32
        end,
33
        onReceivedSslError=function(view, sslErrorHandler, sslError)
34
          --ssl证书错误处理事件
35
          --需自行处理，请返回true拦截原事件
36
          return false
37
        end
38
      })
39
    end
40
  end
41
end
42
webInterface()
43
viewPager.setOnPageChangeListener(OnPageChangeListener{
44
  onPageSelected=function(n)
45
    webInterface()
46
  end
47
})

二.浏览器控件API#

1
require "import"
2
import "android.net.Uri"
3
import "android.view.View"
4
import "android.webkit.WebSettings"
5
import "android.content.Intent"
6
import "android.widget.LinearLayout"
7
import "android.widget.Toast"
8
import "com.androlua.LuaWebView"
9
import "android.webkit.WebViewClient"
10
--浏览器控件讲解
11
layout=--全屏框架
12
{
13
  LinearLayout;--线性控件
14
  orientation='vertical';--布局方向
15
  layout_width='fill';--布局宽度
16
  layout_height='fill';--布局高度
17
  background='#ffeeeeee';--布局背景
18
  {
19
    LuaWebView;--浏览器控件
20
    layout_width='fill';--浏览器宽度
21
    layout_height='fill';--浏览器高度
22
    id='webView';--控件ID
23
  };
24
}
25

26
activity.setContentView(loadlayout(layout))
27

28
import "android.webkit.WebView"
29
webView.addJavascriptInterface({}, "JsInterface")--漏洞封堵代码
30

31
--现代 Web 特性支持：
32
-- 启用现代Web API
33
webView.getSettings().setDomStorageEnabled(true)
34
webView.getSettings().setDatabaseEnabled(true)
35
webView.getSettings().setGeolocationEnabled(true)
36

37
-- PWA 支持
38
webView.getSettings().setAppCacheEnabled(true)
39
webView.getSettings().setAppCachePath(activity.getCacheDir().toString())
40

41
--导航控制增强：
42
webView.setWebViewClient(luajava.override(WebViewClient, {
43
    shouldOverrideUrlLoading = function(view, request)
44
        -- 深度链接处理示例
45
        if request.url:find("tel:") then
46
            activity.startActivity(Intent(Intent.ACTION_DIAL, Uri.parse(request.url)))
47
            return true
48
        end
49
        return false
50
    end,
51

52
    onReceivedHttpError = function(view, request, errorResponse)
53
        -- 自定义错误页处理
54
        view.loadUrl("file:///android_asset/error.html")
55
    end
56
}))
57

58
--性能优化方案：
59
-- 启用现代Web特性
60
webView.getSettings().setMediaPlaybackRequiresUserGesture(false) -- 自动播放策略
61
webView.getSettings().setMixedContentMode(2) -- 混合内容处理
62

63
-- 内存管理优化
64
webView.setLayerType(View.LAYER_TYPE_HARDWARE, nil) -- 硬件加速
65
webView.clearCache(true) -- 定期清理缓存
66

67
--安全增强配置
68
-- 禁用危险接口
69
webView.removeJavascriptInterface("searchBoxJavaBridge_")
70
webView.removeJavascriptInterface("accessibility")
71
webView.removeJavascriptInterface("accessibilityTraversal")
72

73
-- 安全JS接口实现
74
local safeInterface = {
75
    showToast = function(text)
76
        Toast.makeText(activity, text, Toast.LENGTH_SHORT).show()
77
    end
78
}
79
webView.addJavascriptInterface(safeInterface, "SafeJsBridge")
80

81

82
--常用API
83
webView.loadUrl("https://www.baidu.com/")--加载网页
84
webView.loadUrl("file:///storage/sdcard0/index.html")--加载本地文件
85

86
webView.loadUrl("view-source:"..webView.url)--查看网页源码
87
webView.evaluateJavascript([[JavaScript代码]],nil)--加载JS代码
88

89
webView.requestFocusFromTouch()--设置支持获取手势焦点
90
webView.getSettings().setForceDark(WebSettings.FORCE_DARK_ON)--设置深色模式
91

92
webView.getSettings().setSupportZoom(true); --支持网页缩放
93
webView.getSettings().setBuiltInZoomControls(true); --支持缩放
94
webView.getSettings().setLoadWithOverviewMode(true);--缩放至屏幕的大小
95
webView.getSettings().setDisplayZoomControls(false); --隐藏自带的右下角缩放控件
96

97

98
webView.setVerticalScrollBarEnabled(false)--隐藏垂直滚动条
99

100
webView.getSettings().setLoadsImagesAutomatically(true);--图片自动加载
101
webView.getSettings().setUseWideViewPort(true) --图片自适应
102

103
webView.setHorizontalScrollBarEnabled(false)--设置是否显示水平滚动条
104
webView.setVerticalScrollbarOverlay(true)--设置垂直滚动条是否有叠加样式
105
webView.setScrollBarStyle(webView.SCROLLBARS_OUTSIDE_OVERLAY)--设置滚动条的样式
106

107
webView.getSettings().setDomStorageEnabled(true); --dom储存数据
108
webView.getSettings().setDatabaseEnabled(true); --数据库
109
webView.getSettings().setAppCacheEnabled(true); --启用缓存
110
webView.getSettings().setCacheMode(webView.getSettings().LOAD_CACHE_ELSE_NETWORK);--设置缓存加载方式
111
webView.getSettings().setAllowFileAccess(true);--允许访问文件
112
webView.getSettings().setSaveFormData(true); --保存表单数据，就是输入框的内容，但并不是全部输入框都会储存
113
webView.getSettings().setAllowContentAccess(true); --允许访问内容
114
webView.getSettings().setJavaScriptEnabled(true); --支持js脚本
115
webView.getSettings().supportMultipleWindows() --设置多窗口
116
webView.setLayerType(View.LAYER_TYPE_HARDWARE,nil);--硬件加速
117
webView.getSettings().setPluginsEnabled(true)--支持插件
118
webView.getSettings().setJavaScriptCanOpenWindowsAutomatically(true); --//支持通过JS打开新窗口
119
webView.getSettings().setUserAgentString('Mozilla/5.0 (Linux; Android 10.1.2; Build/NJH47F) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/65.0.3325.109 Safari/537.36')--设置浏览器标识(UA)
120
webView.getSettings().setDefaultTextEncodingName("utf-8")--设置编码格式
121
webView.getSettings().setTextZoom(100)--设置字体大小:100表示正常,120表示文字放大1.2倍
122
webView.getSettings().setAcceptThirdPartyCookies(true) --接受第三方cookie
123
webView.getSettings().setSafeBrowsingEnabled(true)--安全浏览
124
webView.getSettings().setGeolocationEnabled(true);--启用地理定位
125

126
webView.goForward()--网页前进
127
webView.goBack()--网页后退
128
webView.reload()--刷新网页
129
webView.stopLoading()--停止加载网页
130

131
webView.getTitle()--获取网页标题
132
webView.getUrl()--获取当前Url
133
webView.getFavicon()--获得当前网页的图标
134
webView.getProgress()--获得网页加载进度
135

136
--状态监听
137
webView.setWebViewClient{
138
  shouldOverrideUrlLoading=function(view,url)
139
    --Url即将跳转
140
  end,
141
  onPageStarted=function(view,url,favicon)
142
    --网页即将加载
143
  end,
144
  onPageFinished=function(view,url)
145
    --网页加载完成
146
  end,
147
  onReceivedError=function(view,code,des,url)
148
    --网页加载失败
149
  end,
150
  onLoadResource=function(view,url)
151
    --加载页面资源时
152
  end,
153
  shouldInterceptRequest=function(view,url)
154
    --加载url制定的资源
155
  end,
156
  onReceivedSslError=function(view,handler,err)
157
    --加载SSL证书错误时
158
  end,
159

160
}
161

162
webView.setWebChromeClient(luajava.override(luajava.bindClass "android.webkit.WebChromeClient",{
163
  onReceivedTitle=function(super,view,title)
164
    --获取到网页标题
165
  end,
166
  onReceivedIcon=function(super,view,title)
167
    --获取到网页图标
168
  end,
169
  onProgressChanged=function(view,progress)
170
    --页面加载进度
171
  end,
172

173
}))
174

175
webView.setDownloadListener{
176
  onDownloadStart=function(url,userAgent,contentDisposition,mimetype,contentLength)
177
    --即将下载文件时(链接,UA,处理,类型,大小)
178
    local 大小=string.format("%.2f",contentLength/1048576).."MB"
179

180
  end,
181

182
}

三.WebView使用指南#

1
--WebView，看这一篇就够了！
2
--本项目亦可用作以WebView为主的项目的初始模板
3

4
local WebChromeClient = luajava.bindClass "android.webkit.WebChromeClient"
5
local WebViewClient = luajava.bindClass "android.webkit.WebViewClient"
6
local DownloadListener = luajava.bindClass "android.webkit.DownloadListener"
7
-- 本项目总结了WebViewClient，WebChromeClient和DownloadListener的常用操作
8
-- 本项目可以用做使用WebView项目的初始代码
9
-- WebViewClient主要负责浏览器相关行为
10
-- WebChromeClient主要负责JS等脚本行为
11
-- DownloadListener负责浏览器的下载行为
12
-- 形参中的"superCall"是 luajava.override 返回的是 com.luajava.LuaMethodInterceptor 的内部类 SuperCall 对象，用于调用父类的这个方法
13
-- author Adam·Eva
14

15
--本项目可以告诉你：
16
-- 1)如何避免SSL错误导致的卡死
17
-- 2)如何在WebView中执行自己想要的JavaScript脚本，例如通过JS删除指定元素，JS删除广告或其他内容
18
-- 3)如何禁止用户点击打开不允许打开的链接
19
-- 4)如何限制网页打开应用，以及获知有没有能打开的应用
20
-- 5)如何对网页中的原生JS弹窗进行处理
21
-- 6)如何上传文件
22
-- 7)如何掌握网页加载的整个流程
23
-- 8)如何监听下载文件
24
-- 9)如何获知用户点击了网页中的什么
25
-- 10)处理网页的定位请求
26
-- 11)通过CookieManager进行Cookie管理
27
-- 12)各种异常事件的处理
28
-- 13)自定义视频全屏和退出的行为和效果
29

30
--先拿WebView，根据不同平台或布局，获取方式自行修改
31
--此处以FA2自带WebView为例
32
--为方便多浏览页调试不同类型网页写了个循环，maxPage指浏览页的数量
33
local maxPage=1
34
for i=0,maxPage-1 do
35
  --上面的i只在下面这行用到了一次
36
  local fragment = activity.getUiManager().getFragment(i)
37
  local webView = fragment.getWebView()
38
  webView.loadUrl("https://httpstat.us/404")
39
  --上传文件页面
40
  --webView.loadUrl("https://imgse.com/")
41
  --视频测试
42
  --webView.loadUrl("http://devimages.apple.com/iphone/samples/bipbop/bipbopall.m3u8")
43
  -- 用于错误页
44
  local errView,errStatus
45
  -- [[WebViewClient，用于浏览器操作
46
  webView.setWebViewClient(luajava.override(WebViewClient,{
47
    shouldOverrideUrlLoading=function(superCall,view,webResourceRequest)
48
      --即将开始加载事件
49
      --返回true则拦截本次加载
50
      --拦截加载建议在这里操作
51
      local String = luajava.bindClass "java.lang.String"
52
      local Intent = luajava.bindClass "android.content.Intent"
53
      local Uri = luajava.bindClass "android.net.Uri"
54
      print("即将开始",webResourceRequest.getMethod(),"加载",webResourceRequest.getUrl().toString())
55
      --判断加载的链接是http/s还是scheme
56
      if not webResourceRequest.getUrl().toSafeString():find("^https?://") then
57
        print("阻止了"..webResourceRequest.getUrl().toSafeString().."的加载\n并尝试启动外部应用")
58
        --给scheme创建一个intent
59
        local intent = Intent(Intent.ACTION_VIEW, Uri.parse(webResourceRequest.getUrl().toString()))
60
        --判断有没有对应的应用能打开这个scheme
61
        pm = activity.getPackageManager()
62
        local componentName = intent.resolveActivity(pm)
63
        if componentName == nil then
64
          print("没有用于打开的应用哦")
65
         else
66
          local PackageManager = luajava.bindClass "android.content.pm.PackageManager"
67
          local pkgname = componentName.getPackageName()
68
          local appname = pm.getApplicationLabel(pm.getApplicationInfo(pkgname,PackageManager.GET_META_DATA))
69
          print("有用于打开的应用哦：\n"..appname.."\n"..pkgname)
70
          --打开它
71
          --activity.startActivity(intent)
72
        end
73
        return true
74
      end
75
      return false
76
    end,
77
    shouldInterceptRequest=function(superCall,view,webResourceRequest)
78
      --控制网页中的资源加载，比如js/css等，并替换为自己的内容
79
      if webResourceRequest.getUrl().getPath():find("png") then
80
        --print("阻止了资源"..webResourceRequest.getUrl().getPath().."的加载")
81
        local WebResourceResponse = luajava.bindClass "android.webkit.WebResourceResponse"
82
        local ByteArrayInputStream = luajava.bindClass "java.io.ByteArrayInputStream"
83
        local String = luajava.bindClass "java.lang.String"
84
        local FileInputStream = luajava.bindClass "java.io.FileInputStream"
85
        --如果要阻止，则应该自己构建响应体以返回
86
        --这里以图片为例，拦截了png图片请求，所以读取了图片的二进制流
87
        --文本可以用java.io.ByteArrayInputStream读取为流
88
        local imgDir = activity.getLoader().getImagesDir("add")
89
        --根据文件类型，记得修改mime类型
90
        return WebResourceResponse("image/png", "UTF-8", FileInputStream(imgDir))
91
      end
92
      return nil
93
    end,
94
    onPageStarted=function(superCall,view,url,favicon)
95
      --页面开始加载事件
96
      --不建议用于禁止加载特定链接再goBack回去，这个行为应当使用shouldOverrideUrlLoading
97
      print(url.."开始加载")
98
      --但是可以把处理网页元素的方法扔在这里，或者onPageFinished里
99
      local ValueCallback = luajava.bindClass "android.webkit.ValueCallback"
100
      --要移除的元素，使用标准CSS选择器语法
101
      --学习参考 https://developer.mozilla.org/zh-CN/docs/Learn/CSS/First_steps
102
      local css = "a"
103
      --使用JS定时器移除元素，原因是有些元素可能会出来的非常晚，或执行某些操作后才出现
104
      view.evaluateJavascript([[
105
      setInterval(() => {
106
          elements = document.querySelectorAll("]]..css..[[")
107
          elements.forEach(e => e.style.display = "none")
108
          // if (elements.length > 0) alert("移除了" + elements.length + "个元素")
109
          },100
110
      )
111
      ]],nil)
112
      --因为navigator.permission在 WebView 中未定义
113
      --所以navigator.clipboard.writeText无法获取写权限
114
      --因而考虑传回原生层处理
115
      function copyText(text)
116
        local Context = luajava.bindClass "android.content.Context"
117
        activity.getSystemService(Context.CLIPBOARD_SERVICE).setText(tostring(text))
118
      end
119
      view.evaluateJavascript([[
120
        const oldWrite = navigator.clipboard.writeText
121
        navigator.clipboard.writeText = (text)=>{androlua.callLuaFunction("copyText",text)oldWrite(text)}
122
      ]],nil)
123
    end,
124
    onPageFinished=function(superCall,view,url)
125
      --页面加载结束事件
126
      --print(url.."加载结束")
127
      local ValueCallback = luajava.bindClass "android.webkit.ValueCallback"
128
      local Uri = luajava.bindClass "android.net.Uri"
129
      view.evaluateJavascript("((url)=>{alert(url);return url;})('"..url.."加载结束')",
130
      ValueCallback{
131
        onReceiveValue=function(res)
132
          print("evaluateJavascript回调:"..res)
133
        end
134
      })
135
      --获取CookieManager单例来管理cookie
136
      local CookieManager = luajava.bindClass "android.webkit.CookieManager"
137
      local cookieManager = CookieManager.getInstance()
138
      --清空cookie
139
      --让我看看有多少人抄东西不过脑子
140
      cookieManager.removeAllCookie()
141
      --设置cookie
142
      cookieManager.setCookie(url,"testCookie=this is a cookie")
143
      --读取所有cookie
144
      local testCookie = cookieManager.getCookie(url)
145
      print("获取"..Uri.parse(url).toSafeString().."的cookie："..testCookie)
146
      --有错误页且此次没有错误码
147
      if errView ~= nil and errStatus == nil then
148
        errView.getParent().removeView(errView)
149
      end
150
    end,
151
    onLoadResource=function(superCall,view,url)
152
      --页面资源加载监听
153
      --可通过该方法获取网页上的资源
154
      --print("加载资源: "..url)
155
    end,
156
    onReceivedSslError=function(superCall, view, sslErrorHandler, sslError)
157
      --ssl证书错误处理事件
158
      --需自行处理，否则在FA2中会导致卡死
159
      --返回true拦截原事件
160
      local sslErr = {
161
        [4] = "SSL_DATE_INVALID\n证书的日期无效",
162
        [1] = "SSL_EXPIRED\n证书已过期",
163
        [2] = "SSL_IDMISMATCH\n主机名称不匹配",
164
        [5] = "SSL_INVALID\n发生一般性错误",
165
        [6] = "SSL_MAX_ERROR\n此常量在API级别14中已弃用。此常数对于使用SslError API不是必需的，并且可以从发行版更改为发行版。",
166
        [0] = "SSL_NOTYETVALID\n证书尚未生效",
167
        [3] = "SSL_UNTRUSTED\n证书颁发机构不受信任"
168
      }
169
      print(sslError.getUrl().."遇到了SSL证书错误，错误类型:"..sslError.getPrimaryError().."\n"..sslErr[sslError.getPrimaryError()])
170
      --忽略错误
171
      sslErrorHandler.proceed()
172
      --取消加载(这是默认行为)
173
      --sslErrorHandler.cancel()
174
      return true
175
    end,
176
    onReceivedHttpError=function(superCall, view, webResourceRequest, webResourceResponse)
177
      --请求返回HTTP错误码时
178
      print(webResourceRequest.getUrl().toString().."遇到HTTP错误码:",webResourceResponse.getStatusCode(),"原因:",webResourceResponse.getReasonPhrase(),"响应体:",webResourceResponse.getData())
179
      --只考虑网页主请求
180
      if webResourceRequest.isForMainFrame() then
181
        --以下错误页布局仅在FA2中有效，其他编辑器请自行更换页面
182
        errStatus = webResourceResponse.getStatusCode()
183
        local errPage = luajava.bindClass"net.fusionapp.core.R".layout.web_error_page
184
        local inflater = luajava.bindClass "android.view.LayoutInflater".from(activity)
185
        errView = inflater.inflate(errPage, nil)
186
        view.getParent().addView(errView)
187
        errView.setBackgroundColor(luajava.bindClass "android.graphics.Color".parseColor("#ffffff"))
188
        errView.setOnClickListener(function()
189
          errStatus = nil
190
          -- view.reload()
191
          view.loadUrl("https://www.baidu.com")
192
        end)
193
      end
194
    end,
195
    onReceivedError=function(superCall, view, webResourceRequest,webResourceError)
196
      --页面加载异常事件
197
      print(webResourceRequest.getUrl().toSafeString().."\n加载异常，原因为:\n"..webResourceError.getDescription())
198
    end,
199
  }))--]]
200

201
  -- 这里定义的变量是用于在onActivityResult中判断来源
202
  local fileRequestCode = 12345
203
  -- 这里定义的变量是用于之后储存onShowCustomView的控件
204
  local customView
205
  -- 这里定义的变量是用于之后储存onShowCustomView时屏幕方向
206
  local orientation
207
  -- 这里定义的变量是用于之后储存onShowFileChooser的回调
208
  local uploadFile
209
  -- [[WebChromeClient，用于页面操作
210
  webView.setWebChromeClient(luajava.override(WebChromeClient,{
211
    onJsTimeout=function(superCall)
212
      --网页中JS执行超时
213
      --停止执行
214
      return true
215
      --继续执行，稍后会再次触发
216
      --return false
217
    end,
218
    onJsAlert=function(superCall,view,url,message,result)
219
      --网页提示弹框
220
      --在onJsAlert中，确认和取消没有区别
221
      --确认
222
      result.confirm()
223
      --取消
224
      --result.cancel()
225
      print("Alert消息: "..message)
226
      return true
227
    end,
228
    onJsConfirm=function(superCall,view,url,message,result)
229
      --网页确认弹框
230
      --确认
231
      result.confirm()
232
      --取消
233
      --result.cancel()
234
      print("Confirm消息: "..message)
235
      return true
236
    end,
237
    onJsPrompt=function(superCall,view,url,message,value,result)
238
      --网页输入弹框
239
      --空确认
240
      --result.confirm()
241
      --取消
242
      --result.cancel()
243
      --确认并返回输入文字
244
      result.confirm("这里是输入的内容")
245
      print("Prompt消息: "..message)
246
      return true
247
    end,
248
    onConsoleMessage=function(superCall,message)
249
      --控制台消息
250
      --print("Console消息: "..message.message())
251
      return true
252
    end,
253
    onReceivedTitle=function(superCall,view,title)
254
      --收到网页标题
255
      activity.uiManager.toolbar.titleText=title
256
    end,
257
    onReceivedIcon=function(superCall,view,bitmap)
258
      --收到网页图标，是个Bitmap对象
259
    end,
260
    onProgressChanged=function(superCall,view,progress)
261
      --网页加载进度变化，下面这句针对FA2，其他编辑器请自行修改
262
      view.parent.getChildAt(2).progress=progress
263
    end,
264
    onShowFileChooser=function(superCall, view, valueCallback, fileChooserParams)
265
      --上传文件
266
      local Intent = luajava.bindClass "android.content.Intent"
267
      --保存回调
268
      uploadFile=valueCallback
269
      --从fileChooserParams里取出Intent对象
270
      --这里的Intent对象已经设置好了参数
271
      local intent = fileChooserParams.createIntent()
272
      --允许多选
273
      intent.putExtra(Intent.EXTRA_ALLOW_MULTIPLE,true)
274
      activity.startActivityForResult(intent, fileRequestCode)
275
      return true
276
    end,
277
    onGeolocationPermissionsShowPrompt=function(superCall, origin, callback)
278
      --收到来自网页的定位请求，自API24起，仅支持安全请求(https)调用，非安全(http)会直接拒绝且不调用此方法
279
      print("请求定位："..origin)
280
      --参数依次为来源，是否允许，是否记住(String origin, boolean allow, boolean remember)
281
      --可以在这个情况弹窗询问用户
282
      --别忘了给你APP申请定位权限！
283
      callback.invoke(origin,true,false)
284
    end,
285
    onPermissionRequest=function(superCall,permissionRequest)
286
      local Arrays = luajava.bindClass "java.util.Arrays"
287
      print("来自网页"..permissionRequest.getOrigin().toSafeString().."的权限请求:",Arrays.asList(permissionRequest.getResources()))
288
      --搭配原生的权限请求函数使用
289
      --同意所有
290
      --permissionRequest.grant(permissionRequest.getResources())
291
      --拒绝所有(默认行为)
292
      permissionRequest.deny()
293
    end,
294
    onShowCustomView=function(superCall,view,callback)
295
      --重写 WebChromeClient 必须重写这个方法，否则影响视频全屏
296
      --Android开发者文档：如果这个方法没有被覆盖，WebView 将向网页报告它不支持全屏模式，并且不会接受网页在全屏模式下运行的请求。
297
      --视频全屏操作会执行这个方法，想要自己做全屏的可以在这里处理
298
      --callback 对象是 WebChromeClient.CustomViewCallback
299
      print("视频全屏")
300
      print(view.getClass())
301
      --保存一下屏幕方向。
302
      orientation = activity.getRequestedOrientation() or 0
303
      -- 设置跟随传感方向
304
      local ActivityInfo = luajava.bindClass "android.content.pm.ActivityInfo"
305
      activity.setRequestedOrientation(ActivityInfo.SCREEN_ORIENTATION_SENSOR)
306
      --保存view供之后退出全屏时移除
307
      customView = view
308
      --覆盖在根布局上面
309
      local FrameLayout = luajava.bindClass "android.widget.FrameLayout"
310
      local Gravity = luajava.bindClass "android.view.Gravity"
311
      local lp = FrameLayout.LayoutParams(FrameLayout.LayoutParams.MATCH_PARENT, FrameLayout.LayoutParams.MATCH_PARENT)
312
      activity.addContentView(view,lp)
313
    end,
314
    onHideCustomView=function(superCall)
315
      --视频退出全屏触发的方法，重写onShowCustomView必须同时重写这个方法
316
      print("退出全屏")
317
      --设置为原来的方向
318
      activity.setRequestedOrientation(orientation)
319
      --移除view
320
      customView.getParent().removeView(customView)
321
      --变量置空
322
      customView = nil
323
      orientation = nil
324
    end
325
  }))--]]
326

327
  --上传文件的回调在这里执行
328
  onActivityResult=function(requestCode,resultCode,intent)
329
    local Activity = luajava.bindClass "android.app.Activity"
330
    local Uri = luajava.bindClass "android.net.Uri"
331
    --如果是来自onShowFileChooser
332
    if requestCode == fileRequestCode then
333
      --如果通过返回键回到应用
334
      if resultCode == Activity.RESULT_CANCELED then
335
        --并且存在上传回调
336
        if uploadFile~=nil then
337
          --就返回空
338
          uploadFile.onReceiveValue(nil)
339
          return
340
        end
341
      end
342
      --定义结果变量，主要是为了确定作用域
343
      local results
344
      --如果正常返回
345
      if resultCode == Activity.RESULT_OK then
346
        --但是回调对象不对
347
        if uploadFile==nil or type(uploadFile)=="number" then
348
          --就直接结束
349
          return
350
        end
351
        --如果返回Intent对象非空
352
        if intent ~= nil then
353
          --拿到数据
354
          local dataString = intent.getDataString()
355
          local clipData = intent.getClipData()
356
          if clipData ~= nil then
357
            --结果转成定长Uri数组
358
            results = Uri[clipData.getItemCount()]
359
            --遍历并储存
360
            for i = 0,clipData.getItemCount()-1 do
361
              local item = clipData.getItemAt(i)
362
              results[i] = item.getUri()
363
            end
364
          end
365
          if dataString ~= nil then
366
            results = Uri[1]
367
            results[0]=Uri.parse(dataString)
368
          end
369
        end
370
      end
371
      if results~=nil then
372
        --返回选择结果
373
        uploadFile.onReceiveValue(results)
374
        uploadFile = nil
375
      end
376
    end
377
  end
378

379
  webView.setDownloadListener(DownloadListener{
380
    onDownloadStart=function(url, userAgent, contentDisposition, mimetype, contentLength)
381
      -- 详细的下载调用DownloadManager的代码我写的太长了
382
      -- 所以请参见我的"各种下载"项目
383
      print("发现下载行为，\n文件描述为: "..contentDisposition.."\n文件类型为: "..mimetype.."\n文件大小为"..contentLength.."\n下载链接是: "..url)
384
    end
385
  })
386

387
  --长按获取点击的元素(点击同理)
388
  webView.onLongClick=function()
389
    local WebView = luajava.bindClass "android.webkit.WebView"
390
    --print(webView.getContentHeight())
391
    --print(webView.onCheckIsTextEditor())
392
    local htr=webView.getHitTestResult()
393
    --print(htr.getType(),htr.getExtra())
394
    --通过type获得点击的类型，这里以图片为例
395
    if htr.getType()==WebView.HitTestResult.IMAGE_TYPE then
396
      local imageName=htr.getExtra():match("^.+/(.-)$")
397
      print(htr.getExtra(),imageName)
398
      --自己去下载就完事了，不会的话，参考我的WebView各种下载项目
399
    end
400
  end
401

402
  --由于WebView默认有自己的按键事件
403
  --当这个事件与我们activity的onKeyDown等冲突时
404
  --可以重写此方法
405
  local View = luajava.bindClass "android.view.View"
406
  webView.setOnKeyListener(View.OnKeyListener{
407
    onKey=function(v, keyCode, event)
408
      local KeyEvent = luajava.bindClass "android.view.KeyEvent"
409
      --判断按键事件为"按下"
410
      if event.getAction() == KeyEvent.ACTION_DOWN then
411
        --判断按的是返回键并且能回退网页
412
        if keyCode == KeyEvent.KEYCODE_BACK && webView.canGoBack() then
413
          --这里放你的操作
414
          webView.goBack()
415
          --直接返回true表明已经执行过返回键的操作
416
          return true
417
        end
418
      end
419
      --其它按键依旧按默认处理
420
      return false
421
    end
422
  })
423
end
424

425
--[[
426
附记：页面加载回调顺序
427
shouldOverrideUrlLoading
428
onProgressChanged[10]
429
shouldInterceptRequest
430
onProgressChanged[...]
431
onPageStarted
432
onProgressChanged[...]
433
onLoadResource
434
onProgressChanged[...]
435
onReceivedTitle/onPageCommitVisible
436
onProgressChanged[100]
437
onPageFinished
438
onReceivedIcon
439
]]

四.网页暗黑模式#

1
function isNightMode()
2
  local Configuration=luajava.bindClass"android.content.res.Configuration"
3
  currentNightMode = activity.getResources().getConfiguration().uiMode & Configuration.UI_MODE_NIGHT_MASK
4
  return currentNightMode == Configuration.UI_MODE_NIGHT_YES--夜间模式启用
5
end
6

7
-- 请浏览
8
-- https://developer.android.google.cn/develop/ui/views/layout/webapps/dark-theme?authuser=0&hl=zh-cn
9
-- 获取更多信息
10

11
-- 允许使用算法调暗功能（以 Android 13 或更高版本为目标平台的应用）(targetSdkVersion至少是33)
12
webView.getSettings().setAlgorithmicDarkeningAllowed(true)
13

14

15
-- 允许使用算法调暗功能（以 Android 12 或更低版本为目标平台的应用）(targetSdkVersion="32"或以下)
16
import "androidx.webkit.WebSettingsCompat"
17

18
if isNightMode() then -- 也可以使用自己的相关的业务来判断是否启用
19
  -- 启用
20
  WebSettingsCompat.setForceDark(webView.getSettings(),WebSettingsCompat.FORCE_DARK_ON)
21
 else
22
  WebSettingsCompat.setForceDark(webView.getSettings(),WebSettingsCompat.FORCE_DARK_OFF)
23
end

五.监听下载与上传#

1
--常用下载功能，包括直链下载，网页点击下载，下载进度监听等
2
--支持blob协议/data协议下载
3
--完善了文件名的逻辑
4
--如果需要修改储存路径，请阅读注释
5
--来源：Adam·Eva
6

7
require "import"
8
import "android.app.DownloadManager"
9
import "android.app.ProgressDialog"
10
import "android.content.Context"
11
import "android.net.Uri"
12
import "android.os.Environment"
13
import "android.util.Base64"
14
import "android.webkit.DownloadListener"
15
import "android.webkit.MimeTypeMap"
16
import "android.webkit.URLUtil"
17
import "com.androlua.Ticker"
18
import "java.io.File"
19
import "java.lang.System"
20
import "java.net.URLDecoder"
21
import "android.os.Build"
22

23
local uiManager=activity.getUiManager()
24
local webView=uiManager.getCurrentFragment().getWebView()
25

26
--http测试
27
webView.loadUrl("http://tool.liumingye.cn/music/?page=audioPage&type=migu&name=%E8%A7%A3%E8%8D%AF")
28
--blob测试
29
webView.loadUrl("https://app.xunjiepdf.com/text2voice/")
30
--data测试
31
--webView.loadUrl("")
32
--response只返回了URL的网站
33
--webView.loadUrl("http://music.vaiwan.com/")
34
--webView.loadUrl("https://viayoo.com")
35
--欢迎补充测试用例
36

37

38
--如果是点击网页中的下载按钮
39
webView.setDownloadListener(DownloadListener{
40
  onDownloadStart=function(url, userAgent, contentDisposition, mimetype, contentLength)
41
    --activity.getSystemService(Context.CLIPBOARD_SERVICE).setText(url)
42
    print(url, contentDisposition, mimetype, contentLength)
43
    local ext = MimeTypeMap.getSingleton().getExtensionFromMimeType(mimetype)
44
    local filename = URLUtil.guessFileName(url,contentDisposition,mimetype)
45
    --受mime影响识别错误时再尝试一下
46
    if filename:match("%.bin$") then
47
      filename = URLUtil.guessFileName(url,contentDisposition,nil)
48
      ext = filename:match(".+%(.-)$") or ext
49
    end
50
    --print("guess",filename,ext)
51
    webView.evaluateJavascript("document.querySelector('[href=\"" .. url .. "\"]').download", function(result)
52
      --文件名处理
53
      if result ~= nil and result ~= "\"\"" and result ~= "null" then
54
        filename = result:gsub("\"", "") or filename
55
        if MimeTypeMap.getSingleton().hasExtension(filename:match(".+%.(.-)$")) then
56
          ext = filename:match(".+%.(.-)$") or ext
57
        end
58
      end
59
      --print("js",filename,ext)
60
      filename=URLDecoder.decode(filename)
61
      if filename == nil or filename == "" then
62
        filename = tostring(System.currentTimeMillis())
63
      end
64
      if not filename:match("%."..ext.."$") then
65
        filename = filename.."."..ext
66
      end
67
      print(filename)
68
      --路径处理
69
      --在这里设置储存设置路径，如Download
70
      local fullPath = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOWNLOADS)
71
      local path = fullPath
72
      if Build.VERSION.SDK_INT >= 29 then --Build.VERSION_CODES.Q
73
        path = Environment.DIRECTORY_DOWNLOADS
74
      end
75
      local file = File(fullPath,filename)
76
      --是否覆盖下载
77
      file.delete()
78
      --base64解码输出，这个方法需要文件读写权限，记得申请
79
      function base64write(data)
80
        make_Snackbar("下载开始",nil,nil)
81
        file.createNewFile()
82
        local Bdata=Base64.decode(data,Base64.DEFAULT)
83
        local output=activity.ContentResolver.openOutputStream(Uri.fromFile(file))
84
        output.write(Bdata)
85
        output.close()
86
        make_Snackbar("下载结束",nil,nil)
87
      end
88
      --根据下载链接类型选择下载方式
89
      --DownloadManager只能下载http/https协议的链接
90
      if URLUtil.isHttpUrl(url) or URLUtil.isHttpsUrl(url) then
91
        make_dialog("下载", filename, nil, "取消", "保存", nil, nil, function()
92
          if Build.VERSION.SDK_INT >= 29 then --Build.VERSION_CODES.Q
93
            download(url, path, filename)
94
           else
95
            download(url, fullPath, filename)
96
          end
97
        end)
98
        --其他的要自己实现
99
       elseif url:find("^blob") then
100
        function blob()
101
          local JSblob=[[
102
          fetch(']]..url..[[', {
103
            responseType: 'blob'
104
          }).then((res) =>{
105
          res.blob().then((data) =>{
106
          data.arrayBuffer().then((buffer) =>{
107
          window.androlua.callLuaFunction("base64write", btoa(String.fromCharCode(...new Uint8Array(buffer))))
108
          })
109
          })
110
          })
111
          ]]
112
          webView.loadUrl('javascript:'..JSblob)
113
        end
114
        make_dialog("下载",filename,"取消","保存",nil,nil,function() blob() end)
115
       elseif URLUtil.isDataUrl(url) then
116
        --是否base64编码
117
        if url:find("^data:(.-)(;base64),(.-)$") then
118
          local mime,data=url:match("^data:(.-);base64,(.-)$")
119
          base64write(data)
120
         else
121
          local mime,data=url:match("^data:(.-),(.-)$")
122
          io.open(path,"w+"):write(URLDecoder.decode(data)):close()
123
        end
124
       else
125
        --不认识的协议？那没办法
126
        make_Snackbar("您遇到了未知的下载类型，请去浏览器尝试下载","打开",function() openExtUrl(webView.getUrl()) end)
127
      end
128
    end)
129
  end
130
})
131

132
--监听下载进度，并使用ProgressDialog和定时器显示进度，如果ProgressDialog不好看你可以自己改改
133
--参数：url是文件直链,path是目录,file是文件名
134
function download(url, filepath, filename)
135
  local downloadId = downloadFile(url, filepath, filename)
136
  local dlDialog = ProgressDialog(this)
137
  dlDialog.setProgressStyle(ProgressDialog.STYLE_HORIZONTAL);
138
  --设置进度条的形式为水平进度条
139
  dlDialog.setTitle("即将开始下载...")
140
  dlDialog.setCancelable(false)--设置是否可以通过点击Back键取消
141
  dlDialog.setCanceledOnTouchOutside(false)--设置在点击Dialog外是否取消Dialog进度条
142
  dlDialog.setOnCancelListener{
143
    onCancel=function(l)
144
      make_Snackbar("将进入后台下载，请在通知栏检查下载进度",nil,nil)
145
    end}
146
  dlDialog.setMax(1)
147
  dlDialog.setProgress(0)
148
  dlDialog.show()
149

150
  local ti=Ticker()
151
  ti.Period=100
152
  ti.onTick=function()
153
    --事件
154
    local fileUri,status,totalSize,downloadedSize = query(downloadId)
155
    if totalSize and totalSize>0 then
156
      if status==1 then
157
        --等待下载
158
        dlDialog.setTitle("等待下载...")
159
        --print("等待下载")
160
       elseif status==2 then
161
        --正在下载
162
        dlDialog.setTitle("正在下载...")
163
        dlDialog.setMax(totalSize)
164
        dlDialog.setProgress(downloadedSize)
165
       elseif status==4 then
166
        --下载暂停
167
        dlDialog.setTitle("下载暂停...")
168
        --print("下载暂停")
169
       elseif status==8 then
170
        --下载成功
171
        dlDialog.setTitle("下载成功")
172
        dlDialog.setMax(totalSize)
173
        dlDialog.setProgress(totalSize)
174
        make_Snackbar("下载成功","打开",function()openExtUrl(fileUri)end)
175
        dlDialog.dismiss()
176
        ti.stop()
177
       elseif status==16 then
178
        --下载失败
179
        dlDialog.dismiss()
180
        make_Snackbar("下载失败，请重试",nil,nil)
181
        ti.stop()
182
      end
183
    end
184
  end
185
  ti.start()--启动Ticker定时器
186
end
187
--参数：url是文件直链,path是目录,file是文件名
188
function downloadFile(url, path, filename)
189
  local downloadManager=activity.getSystemService(Context.DOWNLOAD_SERVICE)
190
  local dlurl=Uri.parse(url)
191
  local request=DownloadManager.Request(dlurl)
192
  request.setAllowedNetworkTypes(DownloadManager.Request.NETWORK_MOBILE|DownloadManager.Request.NETWORK_WIFI)
193
  request.setDestinationInExternalPublicDir(path, filename)
194
  request.setNotificationVisibility(DownloadManager.Request.VISIBILITY_VISIBLE)--|DownloadManager.Request.VISIBILITY_VISIBLE_NOTIFY_COMPLETED)
195
  request.setVisibleInDownloadsUi(true)
196
  --如果下载链接有referer验证，加上这句
197
  --request.addRequestHeader("referer",验证域名)
198
  local downloadId=downloadManager.enqueue(request)
199
  return downloadId
200
end
201
--查询状态
202
function query(downloadId)
203
  local downloadManager=activity.getSystemService(Context.DOWNLOAD_SERVICE);
204
  local downloadQuery = DownloadManager.Query();
205
  downloadQuery.setFilterById({downloadId});
206
  local cursor = downloadManager.query(downloadQuery);
207
  if (cursor != null and cursor.moveToFirst()) then
208
    local fileUri = cursor.getString(cursor.getColumnIndex(DownloadManager.COLUMN_LOCAL_URI))
209
    -- 下载请求的状态
210
    local status = cursor.getInt(cursor.getColumnIndex(DownloadManager.COLUMN_STATUS))
211
    -- 下载文件的总字节大小
212
    local totalSize = cursor.getLong(cursor.getColumnIndex(DownloadManager.COLUMN_TOTAL_SIZE_BYTES))
213
    -- 已下载的字节大小
214
    local downloadedSize = cursor.getLong(cursor.getColumnIndex(DownloadManager.COLUMN_BYTES_DOWNLOADED_SO_FAR))
215
    cursor.close()
216
    return fileUri,status,totalSize,downloadedSize
217
  end
218
end
219

220
--下面是其他相关调用的函数，你可以按需使用
221

222
--弹窗的
223
function make_dialog(title, text, NeutralButton, NegativeButton, PositiveButton, funa, funb, func)
224
  import "androidx.appcompat.app.AlertDialog"
225
  if not activity.isFinishing() then
226
    if funa==nil then
227
      funa=function() end
228
    end
229
    if funb==nil then
230
      funb=function() end
231
    end
232
    if func==nil then
233
      func=function() end
234
    end
235
    dialog=AlertDialog.Builder(activity)
236
    .setTitle(title)
237
    .setMessage(text)
238
    .setCancelable(false)
239
    .setNeutralButton(NeutralButton,{
240
      onClick=funa
241
    })
242
    .setNegativeButton(NegativeButton,{
243
      onClick=funb
244
    })
245
    .setPositiveButton(PositiveButton,{
246
      onClick=func
247
    })
248
    .show()
249
  end
250
end
251

252
--弹出信息的
253
function make_Snackbar(text, btn, fun)
254
  import "com.google.android.material.snackbar.Snackbar"
255
  import "android.view.View"
256
  if not activity.isFinishing() then
257
    if btn==nil then
258
      btn="确定"
259
    end
260
    if fun==nil then
261
      fun=function(v) end
262
    end
263
    local anchor=activity.findViewById(android.R.id.content)
264
    Snackbar.make(anchor, text, Snackbar.LENGTH_LONG).setAction(btn, View.OnClickListener{
265
      onClick=fun
266
    }).show()
267
  end
268
end
269

270
--浏览器打开链接的
271
function openExtUrl(extURL)
272
  import "android.content.Intent"
273
  import "android.webkit.MimeTypeMap"
274
  import "androidx.core.content.FileProvider"
275
  local intent = Intent(Intent.ACTION_VIEW)
276
  local fileUri = Uri.parse(extURL)
277
  if Build.VERSION.SDK_INT >= 29 and fileUri.getScheme() == "file" then
278
    local extName = extURL:match(".+%.(.-)$")
279
    local mime = MimeTypeMap.getSingleton().getMimeTypeFromExtension(extName)
280
    local authorities = activity.getPackageName()..".FileProvider"
281
    fileUri = FileProvider.getUriForFile(activity, authorities, File(extURL))
282
    intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION)
283
  end
284
  intent.setDataAndType(extURL, mime)
285
  activity.startActivity(intent)
286
end
287

288

289
--WebView上传文件
290
--补充多选支持
291
--Source: Adam·Eva
292

293
local uiManager=activity.getUiManager()
294
local webView=uiManager.getCurrentFragment().getWebView()
295
-- [[
296
local WebChromeClient = luajava.bindClass "android.webkit.WebChromeClient"
297
webView.setWebChromeClient(luajava.override(WebChromeClient,{
298
  onShowFileChooser=function(a, view, valueCallback, fileChooserParams)
299
    --print(a, view, valueCallback, fileChooserParams)
300
    uploadFile=valueCallback
301
    local intent = fileChooserParams.createIntent()
302
    activity.startActivityForResult(intent, 1);
303
    return true;
304
  end,
305
}))
306
--]]
307
onActivityResult=function(req,res,intent)
308
  local Activity = luajava.bindClass "android.app.Activity"
309
  local Uri = luajava.bindClass "android.net.Uri"
310
  if res == Activity.RESULT_CANCELED then
311
    if uploadFile~=nil then
312
      uploadFile.onReceiveValue(nil);
313
    end
314
  end
315
  local results
316
  if res == Activity.RESULT_OK then
317
    if uploadFile==nil or type(uploadFile)=="number" then
318
      return;
319
    end
320
    if intent ~= nil then
321
      local dataString = intent.getDataString();
322
      local clipData = intent.getClipData();
323
      if clipData ~= nil then
324
        results = Uri[clipData.getItemCount()];
325
        for i = 0,clipData.getItemCount()-1 do
326
          local item = clipData.getItemAt(i);
327
          results[i] = item.getUri();
328
        end
329
      end
330
      if dataString ~= nil then
331
        results = Uri[1];
332
        results[0]=Uri.parse(dataString)
333
      end
334
    end
335
  end
336
  if results~=nil then
337
    uploadFile.onReceiveValue(results);
338
    uploadFile = nil;
339
  end
340
end