Andorid-LiteHybrid-WebView

Introduction: A android hybrid framework, works for H5 and native interactions via webview.
More: Author   ReportBugs   
Tags:

轻量级 H5 Native Hybrid 框架

轻量级 litehybrid 框架适合适合大多数 app 的 H5 Native 交互的,交互原理较为简单。 GIT 地址:LiteHybrid。其代码分两部分,litehybird 为框架代码。 主工程 为示例代码,

原理:

1. 封装原生 webview,使用 WebViewClient 与 WebChromeClient
2. H5 调用 Native 采用 js prompt 方式
3. Native 调用 H5 采用 loadurl API

使用说明:

  1. errorview 和 loadingview 可以自定义

  2. 对 WebView 设置可以通过 LHPreferences 传递,如 agent 等

  3. 通过 INVOKE 注解,来使 H5 调用相应 Native 函数,参见 INVOKE 类,结构合理。

使用方式:

其中,H5 调用 native,以 JSONObject 方式传递调用信息,格式约定如下:

{
  "invoke": "ANNOTATION_METHOD" 
  "paras": JSONObject
}

其中,"invoke" 值为字符串,对应调用方法,如下文中 popToast"paras" 为对应参数信息,参数内容约定为 JSONObject.

“ANNOTATION_METHOD” 声明如下,参见 WebViewActivity 里的 Invoker1:

@INVOKE("popToast")
public void popToast(JSONObject msgObj) {
...
}

注意事项:

1. 方法为 public,否则会有 IllegalAccessException
2. 方法约定一个参数,JSONObject paras,为 H5 传递来 paras 值
3. 方法 @INVOKE("popToast") 注解中的 popToast 等字段,对应 H5 传递来的 XXX_METHOD,采用字符串对比方式定位应该调用函数。

H5 调用 NA 调试

请在 handleJsPrompt 处设置断点,查看 H5 返回值,并进入函数体调试,看 json 解析是否抛出异常。

    @Override
    public boolean onJsPrompt(WebView view, String origin,
                              String message, String defaultValue,
                              final JsPromptResult result) {
        try {
            parentEngine.handleJsPrompt(message);
        } catch (JSONException e) {
            e.printStackTrace();
        }
        result.confirm();
        return true;
    }

NA 调用 JS 调试

在 WebViewActivity 里参考 javascript:window.changeBackground('red')

H5 页面加载过程中的状态处理

webview 通过 WebViewClient 处理 H5 页面加载过程中的状态,页面加载时候, WebviewClient 给出的回调调用顺序不同,通常使用的三种回调分析如下:

正常情况下 onPageStarted -> onPageFinished

失败情况下: onPageStarted -> onReceivedError -> onPageFinished

超时情况下: onPageStarted -> 30s-> onReceivedError -> onPageFinished

加载过程中重试: onPageStarted -> 重试-> onPageFinished -> onPageStarted

H5 内 JS 的回调处理

webview 通过 WebChromeClient 处理 H5 内 js 的回调,本框架使用了 onJsPrompt 方式,其他还有 alert 方式等。

其他 webview 使用经验

  1. webview 在被销毁后,litehybrid 的 LHWebView 中有标志位标志进行判断,因为 webview 销毁后并不立即为空,再调用可能会引发异常。此处同 Android SDK 中的的 webviewfragment 处理一致。

  2. 提前超时:提前超时时,使用了 loadurl("about:blank") 进行清除缓存,但 loadurl("about:blank") 会重新执行 webview 的生命周期,LHWebViewClient 有标志位进行处理。

  3. 账户信息应当采用诸如 cookie 方式注入提取,example 中未体现。

  4. webview onPagefinished 后,js 不一定完全加载成功。最好方式是用 JS 的回调通知 native 调用 H5 内 js 时机准备好。

PRFSC, 不好的地方指出来相互学习

QQ 群:77157252

Apps
About Me
GitHub: Trinea
Facebook: Dev Tools