Apache Cordova WKWebView 引擎插件使用教程

2024-09-02 03:30:06作者：晏闻田Solitary

cordova-plugin-wkwebview-engine

Apache Cordova Plugin WKWebView Engine: 这是一个Apache Cordova插件，用于在Cordova应用程序中使用苹果的WKWebView引擎。WKWebView引擎是苹果官方推荐的Web视图引擎，提供了更好的性能和安全性。适合用于开发需要使用Web视图引擎的Cordova应用程序，特别是需要运行在iOS平台上的应用程序。特点包括使用WKWebView引擎、跨平台支持和易于集成。

1. 项目的目录结构及介绍

cordova-plugin-wkwebview-engine/
├── src/
│   ├── ios/
│   │   ├── CDVWKWebViewEngine.m
│   │   ├── CDVWKWebViewEngine.h
│   │   ├── CDVWKWebViewUIDelegate.m
│   │   ├── CDVWKWebViewUIDelegate.h
│   │   └── WKWebViewEngine.m
│   └── android/
│       └── placeholder.txt
├── www/
│   └── CDVWKWebViewEngine.js
├── plugin.xml
├── package.json
├── README.md
└── RELEASENOTES.md

src/: 包含插件的源代码，分为 iOS 和 Android 两个平台。
- ios/: iOS 平台的源代码文件。
- android/: Android 平台的占位文件。
www/: 包含插件的 JavaScript 文件。
plugin.xml: 插件的配置文件，定义了插件的元数据和依赖关系。
package.json: 插件的 npm 包配置文件。
README.md: 插件的说明文档。
RELEASENOTES.md: 插件的版本更新记录。

2. 项目的启动文件介绍

在 src/ios/ 目录下，主要的启动文件是 CDVWKWebViewEngine.m 和 CDVWKWebViewEngine.h。这些文件定义了 WKWebView 引擎的核心功能和接口。

CDVWKWebViewEngine.m: 实现 WKWebView 引擎的具体功能。
CDVWKWebViewEngine.h: 定义 WKWebView 引擎的接口和类。

3. 项目的配置文件介绍

plugin.xml: 该文件是 Cordova 插件的配置文件，定义了插件的名称、版本、依赖关系以及如何集成到 Cordova 项目中。

<plugin xmlns="http://apache.org/cordova/ns/plugins/1.0"
        id="cordova-plugin-wkwebview-engine"
        version="1.2.1">
    <name>WKWebView Engine</name>
    <description>Apache Cordova WKWebView Engine Plugin</description>
    <license>Apache 2.0</license>
    <keywords>cordova,wkwebview</keywords>
    <engines>
        <engine name="cordova" version=">=3.0.0"/>
    </engines>
    <js-module src="www/CDVWKWebViewEngine.js" name="CDVWKWebViewEngine">
        <clobbers target="CDVWKWebViewEngine" />
    </js-module>
    <platform name="ios">
        <config-file target="config.xml" parent="/*">
            <feature name="CDVWKWebViewEngine">
                <param name="ios-package" value="CDVWKWebViewEngine"/>
            </feature>
        </config-file>
        <header-file src="src/ios/CDVWKWebViewEngine.h"/>
        <source-file src="src/ios/CDVWKWebViewEngine.m"/>
        <header-file src="src/ios/CDVWKWebViewUIDelegate.h"/>
        <source-file src="src/ios/CDVWKWebViewUIDelegate.m"/>
    </platform>
</plugin>

package.json: 该文件定义了插件的 npm 包信息，包括名称、版本、依赖等。

{
  "name": "cordova-plugin-wkwebview-engine",
  "version": "1.2.1",
  "description": "Apache Cordova WKWebView Engine Plugin",
  "cordova": {
    "id": "cordova-plugin-wkwebview-engine",
    "platforms": [
      "ios"
    ]
  },
  "repository": {
    "type": "git",
    "url": "https://github.com/apache/cordova-plugin-wkwebview-engine.git"
  },
  "keywords": [
    "cordova",
    "wkwebview"
  ],
  "author": "Apache Software Foundation",