[iOS]使用WKWebView遇到的问题总结

1. 获取UserAgent为nil

在使用WKWebView获取userAgent的时候, 如果要全局配置, 使所有的WKWebView都能生效, 我们可能的做法是在AppDelegate中来配置, 但是需要一个WKWebView实例对象, 所以可能是这么写的:

let webView = WKWebView()
webView.evaluateJavaScript("navigator.userAgent") { (info, error) in
            // 获取默认值
            if var userAgent = info as? String {
                // 添加自定义的内容
                if userAgent.hasSuffix("/ios-app") == false {
                    userAgent += "/ios-app"
                }
                // 设置global User-Agent
                let dic = ["UserAgent": userAgent]
                UserDefaults.standard.register(defaults: dic)
                UserDefaults.standard.synchronize()
            }
        }

这样, 你会发现设置一直是无效的, 在回调里打印一下:

print(info)
print(error)

这时发现获取到的 info 字段为nil, 并且error信息如下:

Error Domain=WKErrorDomain Code=3 "WKWebView 已失效" UserInfo={NSLocalizedDescription=WKWebView 已失效}

个人猜测: 这是因为, WKWebView的evaluateJavaScript方法是异步执行的, 当WKWebView回调这个方法的时候, 其实例对象已经从内存中释放了, 所以导致回调出错.
我做了如下验证, 在回调方法里输出webView实例对象:

let webView = WKWebView()
webView.evaluateJavaScript("navigator.userAgent") { (info, error) in

          print(info)
          print(error)
          print(webView)
            // 获取默认值
            if var userAgent = info as? String {
                // 添加自定义的内容
                if userAgent.hasSuffix("/ios-app") == false {
                    userAgent += "/ios-app"
                }
                // 设置global User-Agent
                let dic = ["UserAgent": userAgent]
                UserDefaults.standard.register(defaults: dic)
                UserDefaults.standard.synchronize()
            }
        }

会发现输出是info有值, 而error为nil, webView有值, 又正常了, 有人说了,看样子不是这个问题! 真的么? 仔细想一下会发现, 在webView的方法回调闭包里使用了webView实例, 会发生什么? 对, 循环引用! webView实例此时不为nil, 这也验证了, 如果webView实例正常的话, 获取结果是不会有误的! 继续上面的验证, 我们弱引用一下:

let webView = WKWebView()
webView.evaluateJavaScript("navigator.userAgent") {[weak webView] (info, error) in

          print(info)
          print(error)
          print(webView)
            // 获取默认值
            if var userAgent = info as? String {
                // 添加自定义的内容
                if userAgent.hasSuffix("/ios-app") == false {
                    userAgent += "/ios-app"
                }
                // 设置global User-Agent
                let dic = ["UserAgent": userAgent]
                UserDefaults.standard.register(defaults: dic)
                UserDefaults.standard.synchronize()
            }
        }

这时, 会发现: info和webView都为nil, error值为上面那个错误!!!

这样, 基本验证出现这个问题的原因是: webView 提前释放了!

但是为了添加这个设置, 而将webView 设为全局变量, 仿佛有点得不偿失, 这时可以在使用webView的页面进行设置, 或者使用UIWebView替换:

// 获取默认值
        if let oldAgent = UIWebView().stringByEvaluatingJavaScript(from: "navigator.userAgent") {
            var newAgent = oldAgent

            // 添加自定义的内容
            if oldAgent.hasSuffix("/artron-cgyc") == false {
                newAgent += "/artron-cgyc"
            }

            // 设置global User-Agent
            let dic = ["UserAgent": newAgent]
            UserDefaults.standard.register(defaults: dic)
            UserDefaults.standard.synchronize()
        }
2. 无需传参时注入的交互协议无效

在做JS与原生交互的时候, 使用下面方法注入的协议无效:

 let user = WKUserContentController()
 // 向js中注入协议, 作为ios和js交互的依据
 user.add(self, name: "appProtocol")

然后在js端使用的时候: 这里不需要传参数, 直接这么写的

window.webkit.messageHandlers.appProtocol.postMessage();

这样, 没有响应js端的事件!!!
在代理方法中:

func userContentController(_ userContentController: WKUserContentController, didReceive message: WKScriptMessage) {
        
        if message.name == "appProtocol" {
            print(message.body)
        }
    }

一直没有收到回调!!!
其实, 并不是注入协议失败, 这么使用也没问题, 问题就出在postMessage的参数上, 如果是带参数的:

window.webkit.messageHandlers.appProtocol.postMessage({info: 'info', num: '123456788', price: '100'});

这么写, 是完全没有问题的, 所以如果不需传参数的话, 可以这么写:

// 无参数使用
window.webkit.messageHandlers.appProtocol.postMessage({});

给一个空的字典, 就能正常交互了!!!

3. 屏蔽页面长按手势

在WKWebView加载的HTML页面上, 如果长按会弹出一些选择框, 在文字上长按, 会弹出UIMenuController选择框:

长按文字

而在图片上长按, 会弹出一个alertSheet:

屏幕快照 2017-11-30 下午3.20.31.png

这里可以保存图片到系统相册(如果有权限), 或者复制到剪切板. 但是这些需求并不是我们需要, 如何禁止这些行为呢?需要从JS入手, 只需要执行下面两句js即可:

// 禁止图片长按事件
document.documentElement.style.webkitTouchCallout='none';
//禁止文本长按事件
document.documentElement.style.webkitUserSelect='none';

可以在创建WKWebView的时候注入:

let config = WKWebViewConfiguration()
config.userContentController = WKUserContentController()
let jsStr = """
    document.documentElement.style.webkitTouchCallout='none';
    document.documentElement.style.webkitUserSelect='none';
          """
let noneSelectJS = WKUserScript(source: jsStr, injectionTime: WKUserScriptInjectionTime.atDocumentEnd, forMainFrameOnly: true)
config.userContentController.addUserScript(noneSelectJS)
let web = WKWebView(frame: .zero, configuration: config)

也可以在页面加载完成后的代理方法中执行:

func webView(_ webView: WKWebView, didFinish navigation: WKNavigation!) {

        // 结束加载
        let jsStr = """
                    document.documentElement.style.webkitTouchCallout='none';
                    document.documentElement.style.webkitUserSelect='none';
                """
        webView.evaluateJavaScript(jsStr) { (info, error) in
            
        }
    }
4. 页面中出现第三方的广告悬浮框(Ta)

在加载的HTML页面中, 无端出现一个广告的悬浮框:

第三方广告悬浮框

打开之后是这样的:

第三方广告页面

而且只会在移动4G网络下才会出现, 其实这是移动的流量劫持, 强加的广告推广，目前网上有一些解决方式，常用的有:

  1. 使用IP地址访问：将域名改为IP地址访问数据；
  2. 使用HTTPS；
  3. 前端的小伙伴想想办法

其他的可参考这篇文章 iOS 客户端对于运营商劫持的一点点对抗方式
。

5. 显示HTML页面不是最新的内容

在联调的时候, 前端的同学改了一些东西, 例如页面的布局, 显示元素, 或者js方法, 而APP端没反应!!!

这是因为, WKWebView有缓存, 为了保证每次加载的都是最新的页面, 可以在加载的链接后面加上一个时间戳, 例如你的HTML地址为:

http://your host name/test/20171127.html

一般使用是这样的:

let urlStr = "http://your host name/test/20171127.html"

      if let url = URL(string: urlStr) {
            let request = URLRequest(url: url)
            webView.load(request)
}

这样的话是有缓存, 加载一次之后, 再去加载也不是最新的页面, 可以这样使用:

let time = Date().timeIntervalSince1970   
let urlStr = "http://your host name/test/20171127.html?_t=\(time)"
                
        if let url = URL(string: urlStr) {
            let request = URLRequest(url: url)
            webView.load(request)
        }

这样每次加载的时候都会是最新的, 当然弊端就是, 每次都会耗费一些额外的流量.

6. 当前页面无导航时不能填充状态栏（iOS11+ 会下移状态栏的高度）

在页面无导航的情况下，系统会自动调节滚动视图的contentInset，使其视图永远处于状态栏之下，但是如果我们想让滚动视图的Y坐标从屏幕顶端（状态栏）开始，我们都知道怎么修改，但是 WKWebView不是继承自UIScrollView 的，所以不能直接设置，可以这么写：

if (@available(iOS 11.0, *)) {
        self.webView.scrollView.contentInsetAdjustmentBehavior = UIScrollViewContentInsetAdjustmentNever;
    } else {
        // Fallback on earlier versions
        self.automaticallyAdjustsScrollViewInsets = NO;
    }
7. Attempt to add script message handler with name 'action_toiOS' when one already exists.

这个闪退发生在与 JS 进行交互，使用下面的方法注册协议时：

 let user = WKUserContentController()
 // 向js中注入协议, 作为ios和js交互的依据
 user.add(self, name: "action_toiOS")

如果重复注册了相同名称的协议，就会发生闪退，所以在使用完webView的时候，一定要记得移除已注册的协议：

self.wkWeb.configuration.userContentController.removeScriptMessageHandler(forName: "action_toiOS")
8. Invalid parameter not satisfying: targetNod

app首页使用 WKWebView 来承载的内容，在启动时，如果添加了引导页/广告页，这时如果有手势操作，例如在出现广告页时点击屏幕，就会闪退，并在控制台输出：


Terminating app due to uncaught exception 'NSInternalInconsistencyException', reason: 'Invalid parameter not satisfying: sourceNode'
*** First throw call stack:
(0x1d7131ea4 0x1d6301a50 0x1d7047a2c 0x1d7b361d0 0x203ed4984 0x203ed34e4 0x203edb728 0x203ee144c 0x203edd398 0x203edd2cc 0x203edd09c 0x204308cb4 0x2042e7fcc 0x2043b6e38 0x2043b9830 0x2043b2320 0x1d70c20e0 0x1d70c2060 0x1d70c1944 0x1d70bc810 0x1d70bc0e0 0x1d9335584 0x2042ccc00 0x1042c47a4 0x1d6b7abb4)

添加一个全局断点，调试发现崩溃信息为

 Assertion failure in -[UIGestureGraphEdge initWithLabel:sourceNode:targetNode:directed:], /BuildRoot/Library/Caches/com.apple.xbs/Sources/UIKitCore/UIKit-3698.94.14/Source/GestureGraph/UIGestureGraphEdge.m:24

查了些资料，没找到具体原因，但是了解到和 +load方法有关，我是在 +load 方法内初始化的广告页的信息，把这些放在 didFinishLaunchingWithOptions 进行初始化，就不会有这个问题；

解决：
将广告/引导页视图的初始化放在 didFinishLaunchingWithOptions 方法内。

最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
平台声明：文章内容（如有图片或视频亦包括在内）由作者上传并发布，文章内容仅代表作者本人观点，简书系信息发布平台，仅提供信息存储服务。

推荐阅读更多精彩内容