ZWebView使用简单介绍-Android

移动开发 Android组件库
Zyao89 2018年3月4日星期日 22:23

ZWebView for Hybird App,建立移动端和Web的JS桥接框架,主要包含了多种常用协议的约束和定义。Android的WebView使用更方便。

# 最新

Github: ZWebView.git

# 更新说明

  • 1.0.0 创建Android库zweb
  • 1.0.1 更新一些简单问题
  • 1.0.2 添加新注解@ZJson,修复IOC实现方式无法传json参数
  • 1.0.3 添加新注解@ZData,传入字符串,web端接收到的参数格式为 { 'ZData', String }

# Web

# 分为三种方式

  1. Vue插件注入方式(有些问题,不建议使用)

使用Vue时,可导入vue-zweb插件使用。具体参考 vue-zweb

  1. H5标签协议注入方式

可通过在html文件中引入 <script> 标签,控制引入框架的位置。

协议在标签的 src 下,以地址方式注入,具体格式采用:zweb:// 开头。

目前支持的协议如下:

1. zweb://__init__
1

具体引入方式如下:

<script type="text/javascript" src="zweb://__init__"></script>
1
  1. 普通手动注入方式

# Android

# 引入方式

Gradle > v3.0

implementation 'com.zyao89.view:zweb:1.0.2'
1

Gradle < v3.0

compile 'com.zyao89.view:zweb:1.0.2'
1

# 安卓也对应采用三种交互方式

对应的3中枚举类型如下:

public enum InjectionMode
{
    // vue插件方式,引入  vue-zweb.js  例如:<script type="text/javascript" src="static/libs/vue-zweb.min.js"></script>
    VuePlugin,
    // 协议方式:zweb://  例如:<script type="text/javascript" src="zweb://__init__"></script>
    Protocol,
    // 普通人工引入 <script type="text/javascript" src="static/zweb.js"></script>
    Normal
}
1
2
3
4
5
6
7
8
9

# 基本使用方式

  • Step1,初始化:
    在自定义的Application中初始化 ZWebView,方法如下:
@Override
public void onCreate()
{
    super.onCreate();

    ZWebInstance.init(this);
}
1
2
3
4
5
6
7
  • Step2,构建 ZWebConfig 配置文件,并创建 ZWeb 对象实例。
String MAIN_HTML = "file:///android_asset/index.html";

// 1. 创建配置文件,并带入主页 URL
ZWebConfig config = new ZWebConfig.Builder(ZWebConstant.MAIN_HTML_TEST)
    // 注册状态监听
    .setOnStateListener(this)
    // 注册原生协议UI实现
    .setNativeMethodImplement(this)
    // 注册一些特殊的实现方法
//  .setOnSpecialStateListener(this)
    // 选择注入模式
    .setInjectionMode(InjectionMode.VuePlugin)
    // 自动注入框架脚本JS(建议配置)
    .autoInjectFramework()
    // 自动注入扩展方法
    .autoInjectExtendsJS()
    // 添加 assets 中js文件注入
//  .addInjectJSAssetsFile("js/test.js")
    // 添加 raw 中js文件注入
//  .addInjectJSRawFile(R.raw.index_test)
    .build();

// 2. 创建ZWeb对象实例.
mZWebInstance = ZWebInstance.createInstance(config);

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
  • Step3,传递Activity的生命周期,如下:
// mRootView 为根ViewGroup容器 (必须)
@Override
protected void onCreate(Bundle savedInstanceState)
{
    //...
    mZWebInstance.onActivityCreate(mRootView);
    //...
}

// 分别实现其他生命周期传递
@Override
public void onBackPressed()
{
    if (!mZWebInstance.onActivityBack())
    {
        super.onBackPressed();
    }
}

@Override
protected void onPause()
{
    mZWebInstance.onActivityPause();
    super.onPause();
}

@Override
protected void onResume()
{
    mZWebInstance.onActivityResume();
    super.onResume();
}

@Override
protected void onStart()
{
    mZWebInstance.onActivityStart();
    super.onStart();
}

@Override
protected void onStop()
{
    mZWebInstance.onActivityStop();
    super.onStop();
}

@Override
protected void onDestroy()
{
    mZWebInstance.onActivityDestroy();
    super.onDestroy();
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53

# 一些内部状态监听实现

以下为实现监听状态接口时,所需要实现的方法。

/**
* 框架初始化成功后回调
*
* @param zWebHandler
* @param width 宽
* @param height 高
*/
void onZWebCreated(IZWebHandler zWebHandler, int width, int height);

/**
* 异常(JS如果有异常会在这里回调)
*
* @param zWebHandler
* @param errorCode 错误码
* @param message 错误信息
*/
void onZWebException(IZWebHandler zWebHandler, long errorCode, String message);

/**
* 网络请求处理
*
* @param zWebHandler
* @param url         链接
* @param method      请求方法
* @param data        数据
* @param type        返回类型
* @param controller
*/
void onZWebRequire(IZWebHandler zWebHandler, String url, String method, String data, String type, IZRequireController controller);

/**
* 异步消息请求
*
* @param zWebHandler
* @param cmd 命令名称
* @param data 数据
*/
void onZWebMessage(IZWebHandler zWebHandler, String cmd, String data, IZMessageController controller);

/**
* JS销毁
*
* @param zWebHandler
*/
void onZWebDestroy(IZWebHandler zWebHandler);

/**
* JS日志信息回调,可在这里记录或打印
*
* @param zWebHandler
* @param type        类型
* @param msg         信息
*/
void onZWebLog(IZWebHandler zWebHandler, String type, String msg);
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54

以上接口部分实现方式可参考 MainActivity.java

# IOC实现 js 请求方法封装

  1. 定义调用JS的方法接口
public interface RequireService
{
    @ZMethod("a") // callReceiver
    boolean callA(@ZKey("KeyA") String a, @ZKey("KeyB") String b, @ZKey("Time") long time);

    @ZFunction("init")
    boolean init(@ZKey("A") String a, @ZKey("B") String b, @ZKey("C") int c);

    @ZMethod(ZMethodName.ON_READY)
    void initParam(@ZKey("Msg") String msg, @ZKey("Skin") int skin, @ZKey("Color") int color);

    @ZFunction(ZFunctionName.REFRESH)
    void refresh();

    @ZFunction("newInit")
    boolean newInit(@ZJson String oJson);

    @ZFunction("newInit2")
    boolean newInit2(@ZData String str);
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

各种注解介绍:

@ZFunction("方法名称"): 用于调用JS中 ZWebSDK.extends('方法名称', function(oData){}); 扩展方法的调用。
@ZMethod("监听名称"):用于JS中 ZWebSDK.on('监听名称', function(oData){}); 注册监听的方法调用。
@ZKey("参数名称"):JS中Object参数键值名称。
@ZCmd("cmd名称"):用于 onZWebMessage 方法回调中,cmd参数的映射。具体使用方法可以参考Demo。(针对Message做映射解析时使用)。
@ZJson:JS中Object参数的字符串(json)。
@ZData:参数为字符串。

  1. 创建接口服务对象实例,并进行调用
mRequireService = mZWebInstance.create(RequireService.class);
1

通过使用 mRequireService 提供的方法,调用JS。如下:

mRequireService.callA("我是一个坚挺的消息。。。", "小A你好啊!", time);
1

# JS调用原生提供的方法

  1. 使用现有的 void onZWebMessage(IZWebHandler zWebHandler, String cmd, String data, IZMessageController controller); 进行方法解析,并异步返回结果。

    参数 cmd :定义的命令名称。

    参数 data: 定义的参数。

    controller :可进行异步的结果返回。或者利用 controller.parseMessage(this.mParseMessage); 此方法进行方法解析。

  2. 使用原生 @JavascriptInterface 注解的方法进行扩展。

    框架在 ZWebConfig 中提供了 setExposedName (String exposedName); 方法,可以扩展一个原生的接口协议名称。

    然后,利用 mZWebInstance.addJavascriptInterface(object); 进行对象中的方法注入。

# iOS

暂无

# Author Blog

zyao89.cn


作者:Zyao89;转载请保留此行,谢谢;
原文网站:https://www.zyao89.cn
祝你好运,谢谢支持

作者: Zyao89; 转载请保留
版权声明: 自由转载-非商用-非衍生-保持署名
上次编辑时间: 2023年11月27日星期一 11:18