Android WebView和H5交互总结

本文介绍: 本文附带了一点H5和JS的内容，所以需要有基本的JS知识。学习JS基本知识可以看菜鸟教程。我自己也看过总结了一下知识点我会写一个简单的demo，且demo不需要联网全程本地操作，在文章末尾贴上所有代码。

Android WebView和H5交互 总结

前言
1. WebView初始化和加载网页
2. H5调原生
3. 原生调H5
4. 关于项目实际
5. demo全代码

前言

本文附带了一点H5和JS的内容，所以需要有基本的JS知识。

学习JS基本知识可以看菜鸟教程。
我自己也看过总结了一下知识点 https://blog.csdn.net/qq_41872247/article/details/128901143

我会写一个简单的demo，且demo不需要联网全程本地操作，在文章末尾贴上所有代码。

1. WebView初始化和加载 网页

页面上面放两个按钮和一个WebView，WebView只需要提供Jav aSc rip t的支持就行，不需要特意做什么。

public class MainActivity extends AppCompatActivity {
	WebView webView;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        webView = findViewById(R.id.webview);

        findViewById(R.id.btn1).setOnClickListener(view -&gt; {

        });
        findViewById(R.id.btn2).setOnClickListener(view -&gt; {

        });

        initWebView();
    }

    private void initWebView() {
        WebSettings settings = webView.getSettings();
        settings.setJavaScriptEnabled(true); // 让网页支持JavaScript代码
        webView.setWebChromeClient(new WebChromeClient()); // 让H5的alert功能生效

        webView.loadUrl("file:///android_asset/test.html"); 
    }
}

同时我们在项目的app/src/main中创建 assets文件夹，把我们写的空页面放上去，准备就完成了。

<html&gt;
    <head&gt;
        <title>test.html</title>
        <script>
        </script>
    </head>

    <body>
        <button onclick="">按钮1</button>
        <button onclick="">按钮2</button>
    </body>
</html>

2. H5调原生

H5需要和原生交互，首先要原生提供对应的支持接口，然后H5就可以通过这个接口访问客对应方法了，代码如下（刚才出现过的代码会省略）：

public class MainActivity extends AppCompatActivity {
	// ...省略无关代码

	private void initWebView() {
		// ...省略无关代码
		
        MyInterface myInterface = new MyInterface(this);
        // 通过这个API增加和H5的交互接口，每个WebView的实例都要调用才会添加，name参数决定了这个接口的名称
        webView.addJavascriptInterface(myInterface, "interface1");
	}
}

class MyInterface {
    private final Context context;

    public MyInterface(Context context) {
        this.context = context;
    }

    /**
     * 只要在对应的方法上加上JavaScriptInterface的标签，这个方法就会变成和H5的交互接口
     */
    @JavascriptInterface
    public void testFunction1() {
        Toast.makeText(context, "我是原生测试方法", Toast.LENGTH_SHORT).show();
    }

    /**
     * 方法可以自带入参和返回值
     */
    @JavascriptInterface
    public String testFunction2(String param) {
        return param + ", helloworld";
    }
}

<html>
    <head>
        <title>test.html</title>
        <script>
            function appTest1() {
                // window是固定写法，interface1是App添加接口时写的具体名称，testFunction是具体的方法
                window.interface1.testFunction1()
            }
            function appTest2() {
                // 调用方法可以带入参，一般我们都用String，如果要传数据对象就把他json化
                var t = window.interface1.testFunction2('woshiH5')
                alert('我是带参数和返回值的测试方法：' + t)
            }
        </script>
    </head>

    <body>
        <button onclick="appTest1()">按钮1</button>
        <button onclick="appTest2()">按钮2</button>
    </body>
</html>

3. 原生调H5

原生调H5只需要像正常情况一样写H5的代码就行，代码如下：

public class MainActivity extends AppCompatActivity {

    WebView webView;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        webView = findViewById(R.id.webview);

        findViewById(R.id.btn1).setOnClickListener(view -> {
        	// 正常的调用网页中已声明的方法即可
        	// 同理，WebView可以自由的使用JS代码来操作网页，不仅是方法，实例和变量都能操作。
            webView.evaluateJavascript("h5Test1()", null);
        });

        findViewById(R.id.btn2).setOnClickListener(view -> {
            webView.evaluateJavascript("h5Test2()", new ValueCallback<String>() {
                /**
                 * 返回值的类型只能是String，所以我们一般用JSON格式来传递数据
                 */
                @Override
                public void onReceiveValue(String value) {
                    Toast.makeText(MainActivity.this, value, Toast.LENGTH_SHORT).show();
                }
            });
        });
    }
    //...省略刚才出现过的代码
}

<html>
    <head>
        <title>test.html</title>
        <script>
        	// ...省略无关代码
            function h5Test1() {
                alert('我是测试方法1，我被调用了!')
            }
            function h5Test2() {
                var t = '我是测试方法2，我是个字符串'
                return t
            }
        </script>
    </head>

    <body>
    	<!-- 省略无关代码-->
    </body>
</html>

4. 关于项目实际

一般来说在H5和原生的互相交互中，我们都是将实际的对象转化为JSON串，然后进行交互，所以我们互相传递数据时的参数都是String格式
如果需要异步处理，或者说需要原生H5互相调用时附带回调处理的时候，可以将回调的方法转为String格式传给原生，原生通过evaluateJavascript方法在调用该回调即可。

5. demo全代码

直接复制到空项目里面，解决 import后就能运行

public class MainActivity extends AppCompatActivity {

    WebView webView;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        webView = findViewById(R.id.webview);

        findViewById(R.id.btn1).setOnClickListener(view -> {
            webView.evaluateJavascript("h5Test1()", null);
        });

        findViewById(R.id.btn2).setOnClickListener(view -> {
            webView.evaluateJavascript("h5Test2()", new ValueCallback<String>() {
                /**
                 * 返回值的类型只能是String，所以我们一般用JSON格式来传递数据
                 */
                @Override
                public void onReceiveValue(String value) {
                    Toast.makeText(MainActivity.this, value, Toast.LENGTH_SHORT).show();
                }
            });
        });

        initWebView();
    }

    private void initWebView() {
        WebSettings settings = webView.getSettings();
        settings.setJavaScriptEnabled(true);
        settings.setJavaScriptCanOpenWindowsAutomatically(true);
        webView.setWebChromeClient(new WebChromeClient());

        webView.loadUrl("file:///android_asset/test.html");

        MyInterface myInterface = new MyInterface(this);
        // 通过这个API增加和H5的交互接口，每个WebView的实例都要调用才会添加，name参数决定了这个接口的名称
        webView.addJavascriptInterface(myInterface, "interface1");

    }
}

class MyInterface {
    private final Context context;

    public MyInterface(Context context) {
        this.context = context;
    }

    /**
     * 只要在对应的方法上加上JavaScriptInterface的标签，这个方法就会变成和H5的交互接口
     */
    @JavascriptInterface
    public void testFunction1() {
        Toast.makeText(context, "我是原生测试方法", Toast.LENGTH_SHORT).show();
    }

    /**
     * 方法可以自带入参和返回值
     */
    @JavascriptInterface
    public String testFunction2(String param) {
        return param + ", helloworld";
    }
}

网页全代码，新建html文件之后用文本文档打开，复制进去即可。

<html>
    <head>
        <title>test.html</title>
        <script>
            function appTest1() {
                // window是固定写法，interface1是App添加接口时写的具体名称，testFunction是具体的方法
                window.interface1.testFunction1()
            }
            function appTest2() {
                // 调用方法可以带入参，一般我们都用String，如果要传数据对象就把他json化
                var t = window.interface1.testFunction2('woshiH5')
                alert('我是带参数和返回值的测试方法：' + t)
            }


            function h5Test1() {
                alert('我是测试方法1，我被调用了!')
            }
            function h5Test2() {
                var t = '我是测试方法2，我是个字符串'
                return t
            }
        </script>
    </head>

    <body>
        <button onclick="appTest1()">按钮1</button>
        <button onclick="appTest2()">按钮2</button>
    </body>
</html>