SafariView 控制器 Cordova 插件
注:这是叉子 https://github.com/EddyVerbruggen/cordova-plugin-safariview Controller (中文(简体) ) 在等待更新的时候。 如果需要,这将会被清理并作为由GDevelop团队维护的npm模块发布.
指数
1. 说明
- 在不使用InApp浏览器的情况下使用
- 使用新的和强大的 iOS9 视图控制器在您的 PhoneGap app 中显示网络内容
- 需要 XCode 7 / iOS9 SDK 来构建
- 需要使用iOS9,更低的版本需要倒回InAppBrowser(下面的例子!)
- Chrome 自定义标签 是Android和SafariView Captain的平行 更适合自定义的UI。 您可以尝试使用此插件的最新版本 。 见 维基百科 详细情况.
请注意,我没有决定对窗口进行打乱。 打开以在适用时覆盖 InApp浏览器 因为这意味着你永远不能使用InApp浏览器 以防你需要它的高级特性 在一个地方,并乐于在其他情况下使用简单的只读视图.
2. 截图
从这些镜头中可以看到:你可以以阅读器模式或正常模式预装一页, safari给你选择使用共享表!
按下“ doe” 将用户返回到您的应用程序中, 如你所想 .
这个有个习惯 tintColor (检查按钮):
在iOS 10上,您可以使用 barColor 财务报告和审定财务报表 controlTintColor 还有
(确保iOS 9 按钮在箱子中不是白色的,通过 a tintColor 还):
3. 安装
从 npm 用 Cordova CLI 安装插件 :
$ cordova plugin add @gdevelop/cordova-plugin-safariviewcontroller
4. 使用费
检查 演示代码 以方便为例, 否则复制此选项:
function openUrl(url, readerMode) {
SafariViewController.isAvailable(function (available) {
if (available) {
SafariViewController.show({
url: url,
hidden: false, // default false. You can use this to load cookies etc in the background (see issue #1 for details).
animated: false, // default true, note that 'hide' will reuse this preference (the 'Done' button will always animate though)
transition: 'curl', // (this only works in iOS 9.1/9.2 and lower) unless animated is false you can choose from: curl, flip, fade, slide (default)
enterReaderModeIfAvailable: readerMode, // default false
tintColor: "#00ffff", // default is ios blue
barColor: "#0000ff", // on iOS 10+ you can change the background color as well
controlTintColor: "#ffffff" // on iOS 10+ you can override the default tintColor
},
// this success handler will be invoked for the lifecycle events 'opened', 'loaded' and 'closed'
function(result) {
if (result.event === 'opened') {
console.log('opened');
} else if (result.event === 'loaded') {
console.log('loaded');
} else if (result.event === 'closed') {
console.log('closed');
}
},
function(msg) {
console.log("KO: " + msg);
})
} else {
// potentially powered by InAppBrowser because that (currently) clobbers window.open
window.open(url, '_blank', 'location=yes');
}
})
}
function dismissSafari() {
SafariViewController.hide()
}
5. 对Inpp浏览器的优势
- InAppBrowser使用慢速的UIWebView(即使使用WKWebView插件!),这个插件使用超快的Safari网络视图.
- 现在苹果公司建议在您的应用中使用浏览器的方式.
- 与 Safari 和其他所有应用软件一致的更优等/更清洁的用户界面
SFSafariViewController。 。 。 . - 不过
cordova-plugin-inappbrowser受 苯丙胺类兴奋剂此插件不是。 这表示你甚至可以装入httpURL没有将它们列入白名单. - 从iOS 9.2或 9.3起,你可以刷取回你的应用程序. 不幸的是,为了支持这个苹果公司,在介绍Safari时放弃了提供自定义过渡(curl/flip/.)的选项.
6. 与科多瓦一起阅读萨法里数据和饼干
SFSafariView Captain执行"真实"的Safari,指像cookie和Keychain密码这样的私人数据可供用户使用. 然而,就安全而言,这意味着在SFSafariView Captain中无法提供诸如javascript,CSS注射等通信功能和一些在UIWebView中可用的回调功能.
要将 SFSafariView 控制器中装入的网页的数据传送回您的 Cordova 应用程序, 您可以使用自定义 URL 方案, 如 我的coolapp://data?to=通过。您需要安装一个附加插件,处理在您的 Cordova 应用程序中通过 URL 方案传递的数据.
在此插件中将 URL 方案技术与 HIDDEN 选项合并, 意味着您可以在您的 Cordova app 中有效读取 Safari 的数据 。 如果用户在 Safari 中已经保存了作为 cookie 保存的用户令牌, 这对于用户自动登录到您的应用程序可能有用 .
这样做:
-
安装 自定义 URL 方案插件
-
创建一个网页,读取关于负载的Safari数据,并将数据传递到URL方案:
<html> <head> <script type="javascript"> function GetCookieData() { var app = "mycoolapp"; // Your Custom URL Scheme var data = document.cookie; // Change to be whatever data you want to read window.location = app + '://?data=' + encodeURIComponent(data); // Pass data to your app } </script> </head> <body onload="GetCookieData()"> </body> </html> -
打开您用隐藏的 Safari 视图创建的网页 :
SafariViewController.show({ url: 'http://mycoolapp.com/hidden.html', hidden: true, animated: false }); -
通过 URL 方案获取从网页传递的数据 :
function handleOpenURL(url) { setTimeout(function() { SafariViewController.hide(); var data = decodeURIComponent(url.substr(url.indexOf('=')+1)); console.log('Browser data received: ' + data); }, 0); }
7. 变更日志
- 2.1.0 支持最新的Java版本
- 2.0.0 支持AndroidX
- 1.6.0 安卓的几处变化. 见 这些已解决的问题。 。 。 .
- 1.5.3 隐藏标签不被删除
hide()(iOS) (中文(简体) ). 谢谢104号! - 1.4.3 选项没有正确传递到本地代码。 谢谢19号!
- 1.4.2 在通过不以http/https开头的URL时,将引用错误回调.
- 1.4.1 现在可以设置导航栏和标签栏按钮的颜色。 谢谢16号!
- 1.4.0 添加a
hidden属性改为show。 。 。 . - 1.3.0 (单位:千美元)
isAvailable在非iOS平台上发挥良好. 添加atransition属性改为show。 。 。 . - 1.2.0 将生命周期事件纳入成功处理者
show,并添加animated属性改为show。 。 。 .