@gdevelop/cordova-plugin-safariviewcontroller

中文文档
2.1.0发布于 2025/07/27MIT零依赖近 30 天下载 3236

忘记 iOS 的 InApp Browser - 这样在您的 PhoneGap app 中显示只读的网页内容更好 .

中文使用文档
文档目录8 节
  1. 指数
  2. 1. 说明
  3. 2. 截图
  4. 3. 安装
  5. 4. 使用费
  6. 5. 对Inpp浏览器的优势
  7. 6. 与科多瓦一起阅读萨法里数据和饼干
  8. 7. 变更日志

SafariView 控制器 Cordova 插件

NPM version Downloads TotalDownloads Twitter Follow

注:这是叉子 https://github.com/EddyVerbruggen/cordova-plugin-safariview Controller (中文(简体) ) 在等待更新的时候。 如果需要,这将会被清理并作为由GDevelop团队维护的npm模块发布.

指数

  1. 说明
  2. 截图
  3. 安装
  4. 使用量
  5. 优于 InApp浏览器
  6. 用 Cordova 读取 Safari 数据与饼干
  7. 更改日志

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 受 苯丙胺类兴奋剂此插件不是。 这表示你甚至可以装入 http URL没有将它们列入白名单.
  • 从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 保存的用户令牌, 这对于用户自动登录到您的应用程序可能有用 .

这样做:

  1. 安装 自定义 URL 方案插件

  2. 创建一个网页,读取关于负载的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>
    
  3. 打开您用隐藏的 Safari 视图创建的网页 :

    SafariViewController.show({
      url: 'http://mycoolapp.com/hidden.html',
      hidden: true,
      animated: false
    });
    
  4. 通过 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平台上发挥良好. 添加a transition 属性改为 show。 。 。 .
  • 1.2.0 将生命周期事件纳入成功处理者 show,并添加 animated 属性改为 show。 。 。 .

版本与发布记录

@gdevelop/cordova-plugin-safariviewcontroller 共发布 1 个版本,首次发布于 2025/07/27;过去 12 个月发布了 0 个版本。

版本发布日期距今
2.1.0latest2025/07/271.3 年前

关于 @gdevelop/cordova-plugin-safariviewcontroller 的常见问题

@gdevelop/cordova-plugin-safariviewcontroller 是什么?

忘记 iOS 的 InApp Browser - 这样在您的 PhoneGap app 中显示只读的网页内容更好 .

如何安装 @gdevelop/cordova-plugin-safariviewcontroller?

在项目目录运行 npm install @gdevelop/cordova-plugin-safariviewcontroller,或使用 pnpm add / yarn add / bun add。

@gdevelop/cordova-plugin-safariviewcontroller 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/gdevelop__cordova-plugin-safariviewcontroller 是否存在。

@gdevelop/cordova-plugin-safariviewcontroller 可以商用吗?

@gdevelop/cordova-plugin-safariviewcontroller 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@gdevelop/cordova-plugin-safariviewcontroller 的下载量有多少?

根据 npm 官方下载统计,@gdevelop/cordova-plugin-safariviewcontroller 在 2026/10/16 – 2026/11/14 这 30 天内被下载 3,236 次,日均约 108 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@gdevelop/cordova-plugin-safariviewcontroller 还在维护吗?

最新版本 2.1.0 发布于 2025/07/27(1.3 年前);至今共发布 1 个版本,其中过去 12 个月发布了 0 个;首次发布于 2025/07/27。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。