# @gdevelop/cordova-plugin-safariviewcontroller 中文文档

规范地址：https://npmcn.com/package/%40gdevelop/cordova-plugin-safariviewcontroller/

版本：2\.1\.0
npm 元数据更新时间：2025-07-27T10:28:19.196Z
中文译文更新时间：2026-11-16T01:02:28.876Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40gdevelop/cordova-plugin-safariviewcontroller
原文对照：https://npmcn.com/package/%40gdevelop/cordova-plugin-safariviewcontroller/?lang=original
项目主页：https://github.com/GDevelopApp/cordova-plugin-safariviewcontroller#readme
源码仓库：https://github.com/GDevelopApp/cordova-plugin-safariviewcontroller

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：52 kB，16 个文件
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2025-07-27T10:28:18.593Z
- 最新版本发布：2025-07-27T10:28:18.893Z
- 近 30 天下载量：3236（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：1（近 12 个月 0 个）

## 中文简介

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

## 安装

```sh
npm install @gdevelop/cordova-plugin-safariviewcontroller
```

也可以使用：`pnpm add @gdevelop/cordova-plugin-safariviewcontroller`、`yarn add @gdevelop/cordova-plugin-safariviewcontroller`、`bun add @gdevelop/cordova-plugin-safariviewcontroller`

## README

# SafariView 控制器 Cordova 插件

[![NPM version](http://img.shields.io/npm/v/@gdevelop/cordova-plugin-safariviewcontroller.svg)](https://npmjs.org/package/@gdevelop/cordova-plugin-safariviewcontroller) [![Downloads](http://img.shields.io/npm/dm/@gdevelop/cordova-plugin-safariviewcontroller.svg)](https://npmjs.org/package/@gdevelop/cordova-plugin-safariviewcontroller) [![TotalDownloads](http://img.shields.io/npm/dt/@gdevelop/cordova-plugin-safariviewcontroller.svg?label=total%20downloads)](https://npmjs.org/package/@gdevelop/cordova-plugin-safariviewcontroller) [![Twitter Follow](https://img.shields.io/twitter/follow/eddyverbruggen.svg?style=social&label=Follow%20me)](https://twitter.com/eddyverbruggen)

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

## 指数

1.  [说明](https://npmcn.com/package/%40gdevelop/cordova-plugin-safariviewcontroller/#readme-1-description)
2.  [截图](https://npmcn.com/package/%40gdevelop/cordova-plugin-safariviewcontroller/#readme-2-screenshots)
3.  [安装](https://npmcn.com/package/%40gdevelop/cordova-plugin-safariviewcontroller/#readme-3-installation)
4.  [使用量](https://npmcn.com/package/%40gdevelop/cordova-plugin-safariviewcontroller/#readme-4-usage)
5.  [优于 InApp浏览器](https://npmcn.com/package/%40gdevelop/cordova-plugin-safariviewcontroller/#readme-5-advantages-over-inappbrowser)
6.  [用 Cordova 读取 Safari 数据与饼干](https://npmcn.com/package/%40gdevelop/cordova-plugin-safariviewcontroller/#readme-6-reading-safari-data-and-cookies-with-cordova)
7.  [更改日志](https://npmcn.com/package/%40gdevelop/cordova-plugin-safariviewcontroller/#readme-7-changelog)

## 1\. 说明

-   在不使用InApp浏览器的情况下使用
-   使用新的和强大的 iOS9 视图控制器在您的 PhoneGap app 中显示网络内容
-   需要 XCode 7 / iOS9 SDK 来构建
-   需要使用iOS9,更低的版本需要倒回InAppBrowser(下面的例子!)
-   [Chrome 自定义标签](https://developer.chrome.com/multidevice/android/customtabs) 是Android和SafariView Captain的平行 更适合自定义的UI。 您可以尝试使用此插件的最新版本 。 见 [维基百科](https://github.com/GDevelopApp/cordova-plugin-safariviewcontroller/wiki) 详细情况.

请注意,我没有决定对窗口进行打乱。 打开以在适用时覆盖 InApp浏览器 因为这意味着你永远不能使用InApp浏览器 以防你需要它的高级特性 在一个地方,并乐于在其他情况下使用简单的只读视图.

## 2\. 截图

从这些镜头中可以看到:你可以以阅读器模式或正常模式预装一页, safari给你选择使用共享表!

按下“ doe” 将用户返回到您的应用程序中, 如你所想 .

![](https://npmcn.com/package/%40gdevelop/cordova-plugin-safariviewcontroller/screenshots/01-demoapp.PNG)  ![](https://npmcn.com/package/%40gdevelop/cordova-plugin-safariviewcontroller/screenshots/02-demoapp.PNG)  ![](https://npmcn.com/package/%40gdevelop/cordova-plugin-safariviewcontroller/screenshots/03-demoapp.PNG)  ![](https://npmcn.com/package/%40gdevelop/cordova-plugin-safariviewcontroller/screenshots/04-demoapp.PNG)  ![](https://npmcn.com/package/%40gdevelop/cordova-plugin-safariviewcontroller/screenshots/05-curl.PNG)  ![](https://npmcn.com/package/%40gdevelop/cordova-plugin-safariviewcontroller/screenshots/06-flip.PNG) 

这个有个习惯 `tintColor` (检查按钮):

![](https://npmcn.com/package/%40gdevelop/cordova-plugin-safariviewcontroller/screenshots/07-tintColor.PNG)

在iOS 10上,您可以使用 `barColor` 财务报告和审定财务报表 `controlTintColor` 还有 (确保iOS 9 按钮在箱子中不是白色的,通过 a `tintColor` 还):

![](https://npmcn.com/package/%40gdevelop/cordova-plugin-safariviewcontroller/screenshots/08-barColor.PNG)

## 3\. 安装

从 npm 用 Cordova CLI 安装插件 :

```
$ cordova plugin add @gdevelop/cordova-plugin-safariviewcontroller
```

## 4\. 使用费

检查 [演示代码](https://npmcn.com/package/%40gdevelop/cordova-plugin-safariviewcontroller/demo/index.html) 以方便为例, 否则复制此选项:

```js
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` 受 [苯丙胺类兴奋剂](https://developer.apple.com/library/prerelease/ios/technotes/App-Transport-Security-Technote/)此插件不是。 这表示你甚至可以装入 `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 方案插件](https://github.com/EddyVerbruggen/Custom-URL-scheme)
    
2.  创建一个网页,读取关于负载的Safari数据,并将数据传递到URL方案:
    
    ```html
    <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 视图创建的网页 :
    
    ```js
    SafariViewController.show({
      url: 'http://mycoolapp.com/hidden.html',
      hidden: true,
      animated: false
    });
    ```
    
4.  通过 URL 方案获取从网页传递的数据 :
    
    ```js
    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 安卓的几处变化. 见 [这些已解决的问题](https://github.com/GDevelopApp/cordova-plugin-safariviewcontroller/milestone/7?closed=1)。 。 。 .
-   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 是什么？

忘记 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 和提交记录判断。

