KINWebBrowser 开源项目使用教程

1. 项目介绍

KINWebBrowser 是一个为 iOS 应用设计的 Web 浏览器模块。它基于 WKWebView 在 iOS 8 及以上版本中运行，同时兼容 iOS 7 使用 UIWebView。KINWebBrowser 提供了类似 Safari 的用户界面，支持自定义 UI、动画进度条、横竖屏切换等功能。它可以通过现有的 UINavigationController 进行导航，也可以作为模态视图控制器呈现。

2. 项目快速启动

安装

使用 CocoaPods 安装 KINWebBrowser：

platform :ios, '7.0'
pod 'KINWebBrowser'

使用示例

通过导航控制器推送

#import "KINWebBrowserViewController.h"

KINWebBrowserViewController *webBrowser = [KINWebBrowserViewController webBrowser];
[self.navigationController pushViewController:webBrowser animated:YES];
[webBrowser loadURLString:@"http://www.example.com"];

模态呈现

#import "KINWebBrowserViewController.h"

UINavigationController *webBrowserNavigationController = [KINWebBrowserViewController navigationControllerWithWebBrowser];
[self presentViewController:webBrowserNavigationController animated:YES completion:nil];

KINWebBrowserViewController *webBrowser = [webBrowserNavigationController rootWebBrowser];
[webBrowser loadURLString:@"http://www.example.com"];

3. 应用案例和最佳实践

应用案例

KINWebBrowser 可以用于以下场景：

• 内嵌浏览器：在应用中嵌入一个功能齐全的浏览器，方便用户在不离开应用的情况下浏览网页。
• 模态视图：作为模态视图控制器呈现，适用于需要临时浏览网页的场景。

最佳实践

• 自定义 UI：通过设置 tintColor 和 barTintColor 来自定义工具栏的颜色。
• 显示 URL 和标题：通过设置 showsURLInNavigationBar 和 showsPageTitleInNavigationBar 来控制导航栏中显示的内容。

4. 典型生态项目

KINWebBrowser 依赖以下两个开源项目：

• TUSafariActivity：提供“在 Safari 中打开”功能的 UIActivity 子类。
• ARChromeActivity：提供“在 Google Chrome 中打开”功能的 UIActivity 子类。

这两个项目与 KINWebBrowser 一起使用，可以为用户提供更多的浏览器选择。