WebViewJavascriptBridge 教程

WebViewJavascriptBridge 教程

WebViewJavascriptBridgeAn iOS/OSX bridge for sending messages between Obj-C and JavaScript in UIWebViews/WebViews项目地址:https://gitcode.com/gh_mirrors/we/WebViewJavascriptBridge

1. 项目目录结构及介绍

WebViewJavascriptBridge 的目录结构如下：

• Example Apps: 包含示例应用代码，展示了如何在实际项目中使用WebViewJavascriptBridge。
• Tests: 测试相关的代码，用于验证桥接功能的工作情况。
• WebViewJavascriptBridge: 该项目的核心代码库，包括Objective-C和JavaScript部分。
• .gitignore: Git忽略文件列表，指定不需要版本控制的文件或目录。
• COPYRIGHT: 项目的版权信息。
• Changelog: 更新日志，记录每次版本更新的内容。
• LICENSE: 许可证文件，说明了项目的授权方式。
• Makefile: 构建脚本，可以用来编译和打包项目。
• README.md: 项目的基本介绍和使用指南。
• Roadmap.md: 项目的发展路线图。
• WebViewJavascriptBridge.podspec: CocoaPods的配置文件，用于依赖管理和安装。
• circle.yml: CircleCI持续集成配置文件。

2. 项目的启动文件介绍

在Objective-C端，初始化WebViewJavascriptBridge通常在Web视图加载前进行。以下是一个基本的启动流程：

#import "WebViewJavascriptBridge.h"

// 创建一个WKWebView或UIWebView实例
WKWebView *webView;

// 初始化JavaScript桥接对象
WebViewJavascriptBridge *bridge = [WebViewJavascriptBridge bridgeForWebView:webView];

// 注册处理函数
[bridge registerHandler:@"myHandler" handler:^(id data, WVJBResponseCallback responseCallback) {
    NSLog(@"接收到JavaScript的调用: %@", data);
    // 处理数据并响应JavaScript回调
    responseCallback(@[@"这是一个", @"从Objective-C返回的数据"]);
}];

然后，在JavaScript端，调用setupWebViewJavascriptBridge来初始化JavaScript端的桥接功能。这个函数会在页面加载完成后自动触发。

// 调整此片段以适配升级到v6.x的情况
if (window.webkit && window.webkit.messageHandlers) {
    // ...
} else {
    // 兼容老版本
    var WVJBIframe = document.createElement('iframe');
    WVJBIframe.style.display = 'none';
    WVJBIframe.src = 'https://__bridge_loaded__';
    document.documentElement.appendChild(WVJBIframe);
    setTimeout(function() {
        document.documentElement.removeChild(WVJBIframe);
    }, 0);
}

3. 项目的配置文件介绍

Podfile

如果你使用CocoaPods管理依赖，你需要创建一个Podfile并在其中添加以下内容：

platform :ios, '9.0'
use_frameworks!

target 'YourTarget' do
  pod 'WebViewJavascriptBridge', '~> 6.0'
end

运行pod install命令来安装WebViewJavascriptBridge库。

Build File

对于Android平台，你需要将DSBridge(基于WebViewJavascriptBridge)的依赖添加到你的构建文件中：

allprojects {
    repositories {
        ...
        maven { url 'https://jitpack.io' }
    }
}

dependencies {
    implementation 'com.github.wendux:WebViewJavascriptBridge:master-SNAPSHOT'
}

添加依赖后，就可以在项目中导入并使用DSBridge。

请注意，对于WebViewJavascriptBridge的配置，大部分工作是在代码中完成的，如上所述的初始化和注册处理器。官方仓库并没有单独的配置文件，而是通过Podspec或Gradle文件管理依赖。

WebViewJavascriptBridgeAn iOS/OSX bridge for sending messages between Obj-C and JavaScript in UIWebViews/WebViews项目地址:https://gitcode.com/gh_mirrors/we/WebViewJavascriptBridge