macOS webview编程

好像是macOS10.10之后，以及iOS8之后，新出现的WKWebview组件就迅速的替代了Webview及UIWebView。后者的确存在一些无法解决的bug,诸如架构导致的速度缓慢和内存泄漏。

但无法避免的问题总是有的，比如有些客户端软件，仍然要求兼容老版本的系统，这时候，很不想使用，但也不得不仍然把Webview塞到自己的代码中。

互联网是个喜新厌旧的圈子，网上搜索，几乎只有两类。一是WKWebview的文档，二是iOS类的文档。想要的macOS下面Webview的资料缈如黄鹤。

经过部分只言片语的资料指导和大量的实验，终于完成了工作。所以决定来烧烧冷灶，写出来记录一下。

1.添加Webview

最简单添加webview的方法就是直接在Interface Builder中把Webview拖入到窗口并且用鼠标拖动到指定位置和指定大小，随后在程序中加上对应的变量：

    @IBOutlet weak var webView: WebView!

如果必须动态程序实现，可以使用window.contentView?.addSubview(webView)把webview控件插入到界面中。

2.载入网页

可以直接导向到某个网页，也可以先在本地启动一个静态页面文件，后续一些工作可以在本地静态网页中用js处理。这种方法是比较多用的,因为程序启动速度会感觉快的很多。

        let path = Bundle.main.path(forResource: "somepage", ofType: "html")

        let url = NSURL.fileURL(withPath: path!)

        let request = URLRequest(url: url);

        self.webView.mainFrame.load(request);

把somepage.html添加到项目，并在项目设置中Build Phases->Copy Bundle Resources中添加上文件somepage.html，这样最后生成app文件的时候，somepage.html文件才会被打包到其中。
如果建立的项目使用沙箱(sandbox)模式，现在的应用，如果想上App Store，一般是强制要求使用沙箱的，需要在系统设置的Capabilities中允许incoming network/output networking。否则本地网页没问题，之后的任何网站都无法访问。
新版本的macOS及iOS都强制必须使用https网页访问，如果需要支持老的http网页，还需要在Info.plist中增加一行：App Transport Security Settings，类型为字典项，其中增加一项：Allow Arbitrary Loads，值为YES。

完成以上4项，网页已经可以访问了。

3.从swift调用js

假定在网页中有如下内容：

<script>

function callFromSwift(msg){

    document.getElementById('msgbox').innerHTML=msg;

    return("msg return from js");

}

</script>

<div id='msgbox'></div>

其中定义了一个函数callFromSwift,当被调用的时候，在下面预定义的div中显示传入的字符串，并且返回一个字符串“msg return from js”。

在swift中调用网页中的callFromSwift函数并获取其返回值可以这样做：

        let s=webView.windowScriptObject.evaluateWebScript("callFromSwift('Hello, JavaScript')")

        NSLog(s as! String)	//s是js函数的返回结果，可以是多种类型，本例要求是string

4.从js调用swift

前面的3部分都比较容易，跟WKWebview也大同小异。从JS到swift的调用要复杂的多了。

首先在初始化的时候，要加上一句：

        webView!.frameLoadDelegate=self;

对应的，要在类声明的位置加上一个继承：WebFrameLoadDelegate，随后加入代码：

	//为js对象声明一个接口

    func webView(_ webView: WebView!, didClearWindowObject windowObject: WebScriptObject!, for frame: WebFrame!) {

        self.webView.windowScriptObject.setValue(self, forKey: "swiftHost")

    }

	//这个是基本框架，声明了本类中有两个函数会开放给js对象，并供其调用

	//这里示例了两个，一个是callFromJS1,另一个是quit

	//注意swift中的函数名跟js中的函数名可以不一样，

	//#selector中指明的是swift中声明的函数名，因为selector是object-c中的机制，

	//所以后面在声明真正函数的时候，前面必须加@objc的标志

	//在后面return "xxx"的部分，返回的字符串js中会使用的名字，

	//本例中，swift中函数名跟js中函数名使用了相同的名字，我认为这是好习惯

    override class func webScriptName(for aSelector: Selector) -> String?

    {

        //NSLog("%@",aSelector.description)

        if aSelector == #selector(callFromJS1)

        {

            return "callFromJS1"

        }

        else

        if aSelector == #selector(quit)

        {

            return "quit"

        }

        else

        {

            return nil

        }

    }

	//这个函数顾名思义，应当是不允许在js中调用的，对所有的来值都返回false表示全部允许调用

    override class func isSelectorExcluded(fromWebScript aSelector: Selector) -> Bool

    {

        //NSLog("%@",aSelector.description)

        return false

    }

	//具体的函数

    @objc

    func callFromJS1(message:String)

    {

        NSLog(message)

    }

    @objc

    func quit()

    {

        NSLog("call for quit")

        NSApp.terminate(self);

    }

前三个函数是基本的框架，其中第二个麻烦一些，随后实际上工作的函数没有什么特别。

接着来看看js的部分：

    <a href='javascript:testCallSwift();'>testCallSwift</a><p>

    <a href='javascript:needQuit();'>Quit</a><p>

	<script>

		function testCallSwift(){

			//注意调用方式，window是js的对象

			//swiftHost是swift的接口

			//其后则是声明的swift函数

		    window.swiftHost.callFromJS1("hello swift");

		}

		function needQuit(){

		    window.swiftHost.quit();

		}

	</script>

5.截获webview每一次访问

跟上面类似，要再增加一个代理：

//初始化的时候增加：

        webView!.policyDelegate=self;

并且声明类的时候多一个继承:WebPolicyDelegate。随后代码中可以实现一个接口：

    func webView(_ webView: WebView!,

                 decidePolicyForNavigationAction actionInformation: [AnyHashable : Any]!,

                 request: URLRequest!,

                 frame: WebFrame!,

                 decisionListener listener: WebPolicyDecisionListener!) {

        NSLog("nav to %@",request.url!.absoluteString)  //这里是将要转向的网址

        listener.use()	//允许访问这个网址

        //listener.ignore()   //不允许访问这个网址则调用这个

    }

也有些程序中为了简化从js调用swift的工作量，会用链接的方式，在链接地址中传入一些指令，就可以用这个函数截获网址并且处理，被处理的网址通常使用listener.ignore()来禁止本次浏览器转向，免得影响当前页面。

6.响应js中的警告窗

通常的webview都是不允许js中的alert警告窗的，一方面是为了应用程序整体的效果；另一方面，webview作为一个空间，自己没有UI的控制权，所以类似的工作，是要有应用程序自己实现警告框窗口的。实现警告窗依然要给类增加一个集成WebUIDelegate,并在初始化中增加：

        webView!.uiDelegate=self;

//随后可以实现一个接口：

    func webView(_ sender: WebView!,

                 runJavaScriptAlertPanelWithMessage message: String!,

                 initiatedBy frame: WebFrame!){

        NSLog("msg of alert: %@",message)

    }

如果不满足于只是得到警告消息，要自己在这个函数中使用cocoa的警告窗来显示相关的信息。

7.其它

还可以实现从js中访问swift中的变量功能。使用isKeyExcludedFromWebScript和webScriptNameForKey函数，我用得少，如果需要，参考上面定义函数的方法，查一查官方文档自己来试试吧。

参考资料：

Swift & JavaScript integration

巴特西