README.en.md · hljdrl/ffsky-app-dsbridge

# ffsky-app-dsbridge

#### 介绍
ffsky-app-dsbridge 组件
1. 基于 [DSBridge-Android 3.0.0修改优化而来  https://github.com/wendux/DSBridge-Android.git ]
2. 简化WebView中js插件开发、迭代、维护，专注于业务开发.

类

| 原项目类名                    | 优化后类名                 | 备注                                           |
|--------------------------|-----------------------|----------------------------------------------|
| DWebView                 | DSWebView             | webview扩展                                    |
| CompletionHandler        | DSCallback<T>         | js调用Native,Native回调js callback               |
| OnReturnValue<T>         | DSResultListener<T>   | Native调用js后，接收js回调结果                         |
| JsCloseWindowListener    | OnWindowListener      | 页面关闭前，关闭页上层Dialog或者其它View                    |
| DsUtil                   | 迁移到 BasicBridge       | 方法合并                                         |
| CallInfo                 | DSCallInfo            | 修改类作用域                                       
| FileChooser              | 移除                    | 使用WebChromeClient onShowFileChooser 方法实现文件选择 | 
| -                        | -                     | -                                            |
|                          | WebViewEvent          | 新增                                           |
|                          | DSPlugin              | 新增                                           |
|                          | BasicBridge           | 新增                                           |
|                          | DSPluginProvider      | 新增                                            |
| innerJavascriptInterface | DSExecute             | 分离                                           |
| new Object(...),_dsb     | DSChannel             | 分离                                           |

#### 使用说明

1.  引入库

```gradle
api "com.gitee.hljdrl:dsbridge:1.0.0"

```
### JsToNative

```xml
<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:id="@+id/activity_main"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

<com.gitee.hljdrl.dsbridge.DSWebView
        android:id="@+id/webview"
        android:layout_width="match_parent"
        android:layout_height="match_parent" />
</RelativeLayout>

```

```Java

package com.ffsky.template.demo.app;

import android.os.Bundle;

import androidx.appcompat.app.AppCompatActivity;

import com.ffsky.template.demo.R;
import com.ffsky.template.demo.jsapi.JsApi;
import com.ffsky.template.demo.jsapi.JsEchoApi;
import com.gitee.hljdrl.dsbridge.DSWebView;

public class JsToNativeActivity extends AppCompatActivity {

@Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_js_call_native);
        final DSWebView webView=  findViewById(R.id.webview);
        // set debug mode
        DSWebView.setWebContentsDebuggingEnabled(true);
//        dwebView.addJavascriptObject(new JsApi(), null);
//        dwebView.addJavascriptObject(new JsEchoApi(),"echo");
        webView.addDSPlugin("echo", JsEchoApi.class);
        webView.addDSPlugin(null, JsApi.class);
        webView.loadUrl("file:///android_asset/js-call-native.html");
    }
}

```

### NativeToJs

```xml
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:id="@+id/activity_main"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
>

</LinearLayout>
    </ScrollView>

</LinearLayout>

```

```java

package com.ffsky.template.demo.app;

import android.os.Bundle;
import android.view.View;
import android.widget.Toast;

import androidx.appcompat.app.AppCompatActivity;

import com.ffsky.template.demo.R;
import com.gitee.hljdrl.dsbridge.DSWebView;
import com.gitee.hljdrl.dsbridge.basis.DSResultListener;
import com.gitee.hljdrl.dsbridge.jsapi.DSChannel;

import org.json.JSONObject;

public class NativeToJsActivity extends AppCompatActivity implements View.OnClickListener {
    DSWebView dWebView;

public <T extends View> T getView(int viewId) {
        View view = findViewById(viewId);
        return (T) view;
    }
    protected DSChannel dsChannel;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_call_javascript);
        getView(R.id.addValue).setOnClickListener(this);
        getView(R.id.append).setOnClickListener(this);
        getView(R.id.startTimer).setOnClickListener(this);
        getView(R.id.synAddValue).setOnClickListener(this);
        getView(R.id.synGetInfo).setOnClickListener(this);
        getView(R.id.asynAddValue).setOnClickListener(this);
        getView(R.id.asynGetInfo).setOnClickListener(this);
        getView(R.id.hasMethodAddValue).setOnClickListener(this);
        getView(R.id.hasMethodXX).setOnClickListener(this);
        getView(R.id.hasMethodAsynAddValue).setOnClickListener(this);
        getView(R.id.hasMethodAsynXX).setOnClickListener(this);
        DSWebView.setWebContentsDebuggingEnabled(true);
        dWebView= getView(R.id.webview);
        dsChannel = dWebView.getDSChannel();
        dWebView.loadUrl("file:///android_asset/native-call-js.html");

}

void showToast(Object o) {
        Toast.makeText(this, o.toString(), Toast.LENGTH_SHORT).show();
    }

@Override
    public void onClick(View v) {
        switch (v.getId()) {
            case R.id.addValue:
                dsChannel.callHandler("addValue", new Object[]{3, 4}, new DSResultListener<Integer>() {
                    @Override
                    public void onDSResult(Integer retValue) {
                        showToast(retValue);
                    }
                });
                break;
            case R.id.append:
                dsChannel.callHandler("append", new Object[]{"I", "love", "you"}, new DSResultListener<String>() {
                    @Override
                    public void onDSResult(String retValue) {
                        showToast(retValue);
                    }
                });
                break;
            case R.id.startTimer:
                dsChannel.callHandler("startTimer", new DSResultListener<Integer>() {
                    @Override
                    public void onDSResult(Integer retValue) {
                        showToast(retValue);
                    }
                });
                break;
            case R.id.synAddValue:
                dsChannel.callHandler("syn.addValue", new Object[]{5, 6}, new DSResultListener<Integer>() {
                    @Override
                    public void onDSResult(Integer retValue) {
                        showToast(retValue);
                    }
                });
                break;
            case R.id.synGetInfo:
                dsChannel.callHandler("syn.getInfo", new DSResultListener<JSONObject>() {
                    @Override
                    public void onDSResult(JSONObject retValue) {
                        showToast(retValue);
                    }
                });
                break;
            case R.id.asynAddValue:
                dsChannel.callHandler("asyn.addValue", new Object[]{5, 6}, new DSResultListener<Integer>() {
                    @Override
                    public void onDSResult(Integer retValue) {
                        showToast(retValue);
                    }
                });
                break;
            case R.id.asynGetInfo:
                dsChannel.callHandler("asyn.getInfo", new DSResultListener<JSONObject>() {
                    @Override
                    public void onDSResult(JSONObject retValue) {
                        showToast(retValue);
                    }
                });
                break;
            case R.id.hasMethodAddValue:
                dsChannel.hasJavascriptMethod("addValue", new DSResultListener<Boolean>() {
                    @Override
                    public void onDSResult(Boolean retValue) {
                        showToast(retValue);
                    }
                });
                break;
            case R.id.hasMethodXX:
                dsChannel.hasJavascriptMethod("XX", new DSResultListener<Boolean>() {
                    @Override
                    public void onDSResult(Boolean retValue) {
                        showToast(retValue);
                    }
                });
                break;
            case R.id.hasMethodAsynAddValue:
                dsChannel.hasJavascriptMethod("asyn.addValue", new DSResultListener<Boolean>() {
                    @Override
                    public void onDSResult(Boolean retValue) {
                        showToast(retValue);
                    }
                });
                break;
            case R.id.hasMethodAsynXX:
                dsChannel.hasJavascriptMethod("asyn.XX", new DSResultListener<Boolean>() {
                    @Override
                    public void onDSResult(Boolean retValue) {
                        showToast(retValue);
                    }
                });
                break;
        }

}
}

```

hljdrl/ffsky-app-dsbridge

简介

发行版

贡献者

近期动态

hljdrl/ffsky-app-dsbridge .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

hljdrl/ffsky-app-dsbridge