# ffsky-app-dsbridge

**Repository Path**: pigadmin/ffsky-app-dsbridge

## Basic Information

- **Project Name**: ffsky-app-dsbridge
- **Description**: 基于 com.github.wendux:DSBridge-Android:3.0.0 项目升级webview，分离webview和dsbridge。
DSBridge Android
- **Primary Language**: Android
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 3
- **Created**: 2025-01-07
- **Last Updated**: 2025-01-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 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"
>

    <ScrollView
        android:layout_width="match_parent"
        android:layout_height="match_parent"
    >

        <LinearLayout
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:orientation="vertical"
            android:padding="16dp">

            <Button
                android:id="@+id/addValue"
                android:layout_width="match_parent"
                android:layout_height="wrap_content"
                android:text="addValue(3,4)"
                android:textAllCaps="false" />

            <Button
                android:id="@+id/append"
                android:layout_width="match_parent"
                android:layout_height="wrap_content"
                android:text="append('I','love','you')"
                android:textAllCaps="false" />

            <Button
                android:id="@+id/startTimer"
                android:layout_width="match_parent"
                android:layout_height="wrap_content"
                android:text="startTimer()"
                android:textAllCaps="false" />

            <Button
                android:id="@+id/synAddValue"
                android:layout_width="match_parent"
                android:layout_height="wrap_content"
                android:text="syn.addValue(5,6)"
                android:textAllCaps="false" />

            <Button
                android:id="@+id/synGetInfo"
                android:layout_width="match_parent"
                android:layout_height="wrap_content"
                android:text="syn.getInfo()"
                android:textAllCaps="false" />

            <Button
                android:id="@+id/asynAddValue"
                android:layout_width="match_parent"
                android:layout_height="wrap_content"
                android:text="asyn.addValue(5,6)"
                android:textAllCaps="false" />

            <Button
                android:id="@+id/asynGetInfo"
                android:layout_width="match_parent"
                android:layout_height="wrap_content"
                android:text="asyn.getInfo()"
                android:textAllCaps="false" />

            <Button
                android:id="@+id/hasMethodAddValue"
                android:layout_width="match_parent"
                android:layout_height="wrap_content"
                android:text="hasJavascriptMethod('addValue')"
                android:textAllCaps="false" />

            <Button
                android:id="@+id/hasMethodXX"
                android:layout_width="match_parent"
                android:layout_height="wrap_content"
                android:text="hasJavascriptMethod('XX')"
                android:textAllCaps="false" />

            <Button
                android:id="@+id/hasMethodAsynAddValue"
                android:layout_width="match_parent"
                android:layout_height="wrap_content"
                android:text="hasJavascriptMethod('asyn.addValue')"
                android:textAllCaps="false" />
            <Button
                android:id="@+id/hasMethodAsynXX"
                android:layout_width="match_parent"
                android:layout_height="wrap_content"
                android:text="hasJavascriptMethod('asyn.XX')"
                android:textAllCaps="false" />
            <com.gitee.hljdrl.dsbridge.DSWebView
                android:id="@+id/webview"
                android:layout_width="match_parent"
                android:layout_height="match_parent"
                android:visibility="gone" />

        </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;
        }

    }
}


```