一、WebView简介
WebView是Android中的原生UI控件,主要用于在app应用中方便地访问远程网页或本地html资源。同时,WebView也在Android中充当Java代码和JS代码之间交互的桥梁。实际上,也可以将WebView看做一个功能最小化的浏览器。
二、安卓交互功能封装
通过Android Studio将WebView相关调用接口封装成AAR包,以供后续Unity调用。
1、新建安卓工程
(1)创建工程
使用Android Studio创建新工程,选择为Empty Activity。
(2)选项配置
设置一下Name及Package name,注意一下Language是否选择Java。
2、创建模块
创建用于封装AAR包的模块。选中工程名,右键New-->Module。例如本项目创建名为WebView的模块。
注意,模块包名要与工程的包名一致。
3、Java类创建
(1)创建方法调用类
选中WebView模块-->src-->main-->java-->包名(com.xx.xx),右键New-->Java Class,创建名为MainActivity的方法调用Java类,内部写好供Unity调用的方法。写入以下代码。
import android.app.Activity;
import android.content.Context;
import android.content.Intent;
import android.widget.Toast;
public class MainActivity extends Activity{
private Context mContext;
private static MainActivity mMainActivity = null;
public MainActivity(Context context) {
this.mContext = context;
}
public static MainActivity getInstance(Context context){
if (mMainActivity == null) {
mMainActivity = new MainActivity(context);
}
return mMainActivity;
}
//Unity中会调用这个方法,从而开打WebView
public void StartWebView(String url,String label)
{
printLog("Welcome");
WebViewActivity.openUrl = url;
WebViewActivity.activityLabel = label;
Intent intent = new Intent(this.mContext,WebViewActivity.class);
this.mContext.startActivity(intent);
}
public boolean showToast(String content){
Toast.makeText(this.mContext,content,Toast.LENGTH_SHORT).show();
return true;
}
private void printLog(String s){
//Log.d("vivian",s);
showToast(s);
}
}
(2)创建WebView调用类
同样的方式,在MainActivity同级目录里创建名为WebViewActivity的WebView调用类,用于开启WebView。写入以下代码。
import android.app.Activity;
import android.content.Intent;
import android.net.Uri;
import android.os.Bundle;
import android.text.TextUtils;
import android.util.Log;
import android.view.View;
import android.view.View.OnClickListener;
import android.webkit.WebView;
import android.widget.Button;
public class WebViewActivity extends Activity {
public static String openUrl;//需要打开的链接
public static String activityLabel;//链接对应的Title,显示在WebView的标题栏
private WebView webView;
private Button close;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setTitle(activityLabel);//设置链接的Title
setContentView(R.layout.activity_webview);
webView = (WebView) findViewById(R.id.WebView);
webView.loadUrl(openUrl);
webView.getSettings().setJavaScriptEnabled(true);
webView.setWebViewClient(new WebViewClient());
close = (Button) findViewById(R.id.CloseButton);
close.setOnClickListener(new OnClickListener() {
@Override
public void onClick(View v) {
WebViewActivity.this.finish();
}
});
}
private class WebViewClient extends android.webkit.WebViewClient {
@Override
public boolean shouldOverrideUrlLoading(WebView view, String url) {
WebView.HitTestResult hit = view.getHitTestResult();
//hit.getExtra()为null或者hit.getType() == 0都表示即将加载的URL会发生重定向,需要做拦截处理
if (TextUtils.isEmpty(hit.getExtra()) || hit.getType() == 0) {
//通过判断开头协议就可解决大部分重定向问题了,有另外的需求可以在此判断下操作
Log.e("重定向", "重定向: " + hit.getType() + " && EXTRA()" + hit.getExtra() + "------");
Log.e("重定向", "GetURL: " + view.getUrl() + "\n" +"getOriginalUrl()"+ view.getOriginalUrl());
Log.d("重定向", "URL: " + url);
}
if (url.startsWith("http://") || url.startsWith("https://")) {//加载的url是http/https协议地址
view.loadUrl(url);
return false; //返回false表示此url默认由系统处理,url未加载完成,会继续往下走
} else { //加载的url是自定义协议地址
try {
Intent intent = new Intent(Intent.ACTION_VIEW, Uri.parse(url));
startActivity(intent);
} catch (Exception e) {
e.printStackTrace();
}
return true;
}
}
}
}
4、AndroidManifest.xml文件配置
在AndroidManifest.xml文件里配置创建的Java类及权限。
模块创建后默认写入了一些内容,如下所示:
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android">
</manifest>
在WebView模块-->src-->main下打开AndroidManifest.xml,写入以下内容:
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="包名">
<application
android:usesCleartextTraffic="true">
<activity android:name=".MainActivity">
</activity>
<activity android:name=".WebViewActivity"
android:label="@string/activity_name">
</activity>
</application>
<!-- 连接互联网的权限 -->
<uses-permission android:name="android.permission.INTERNET" />
</manifest>
5、创建res文件夹
选中WebView模块-->src-->main,右键New-->Directory,在弹窗里选择res,双击创建。
res文件夹后续用来存储布局文件及一些字符串配置文件。
创建后的目录层级如下:
6、创建WebView布局文件
布局文件用于WebView界面布局设计。选中res文件夹,右键New-->Directory,在弹窗里输入layout,回车创建。
创建完毕后,选中layout,右键New-->Layout Resource File,在弹窗里输入activity_webview(名字根据自己的上下文自定义),点击OK创建布局文件。
将界面选择为Code后,写入以下内容:
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="fill_parent"
android:layout_height="fill_parent"
android:orientation="vertical" >
<WebView
android:id="@+id/WebView"
android:layout_width="fill_parent"
android:layout_height="wrap_content"
android:layout_weight="1.0"
/>
<Button
android:id="@+id/CloseButton"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:backgroundTint="#009688"
android:text="返回"
android:textColor="#FFFFFF"
android:textColorHint="#000000" />
</LinearLayout>
7、创建strings.xml文件
选中res文件夹,右键New-->Directory,在弹窗里输入values,回车创建。
创建完毕后,选中values,右键New-->File,在弹窗里输入strings.xml后,回车创建。
创建完毕,打开strings.xml文件,写入以下内容:
<resources>
<string name="activity_name">B站</string>
</resources>
strings.xml文件用于设置WebView界面的标题,在WebViewActivity中动态修改其值。
8、修改编译和目标SDK
在WebView模块中,找到并打开build.gradle文件,将compileSdk和targetSdk修改为31或以上。
因为后续构建release版本AAR包时,需要31或以上版本的SDK。
9、修改Build变量为release
点击Build-->Select Build Variant...,在打开的界面中将WebView模块的Build Variant选择为release。
10、针对AAR包混淆处理
(1)build.gradle修改
在WebView模块中,找到并打开build.gradle文件,将buildTypes中release块的minifyEnabled修改为true。
(2)混淆文件修改
在WebView模块中,找到并打开proguard-rules.pro文件,写入以下内容:
-keep class 包名.MainActivity{public <methods>;}
此处是为了保持MainActivity中的public方法不被混淆处理,避免供Unity调用的方法混淆。若不加以限制,Unity将无法调用到AAR包里的方法。
11、构建AAR包
选中WebView模块,点击Build-->Make Module,或者直接Build-->Rebuild Project。
待编译完成后,在WebView模块-->build-->outputs-->aar里便可找到编译好的AAR包。
三、Unity调用
1、AAR包放置
直接将AAR包拖放至Unity的Assets-->Plugins-->Android路径下。
2、创建C#脚本,调用AAR包
写入以下内容,用来调用AAR包里的函数接口。
using System.Collections;
using System.Collections.Generic;
using UnityEngine;
public class SetWebViewUtils : MonoBehaviour
{
private AndroidJavaObject setWebViewUtils;
private string activityLabel;//安卓端Activity的Label,即打开的链接在WebView中的标题
// Start is called before the first frame update
void Start()
{
AndroidJavaClass UnityPlayer = new AndroidJavaClass("com.unity3d.player.UnityPlayer");
AndroidJavaObject currentActivity = UnityPlayer.GetStatic<AndroidJavaObject>("currentActivity");
AndroidJavaClass openAppUtilsClass = new AndroidJavaClass("包名.MainActivity");
setWebViewUtils = openAppUtilsClass.CallStatic<AndroidJavaObject>("getInstance", currentActivity);
}
//设置WebView的标题
public void SetTitle(string label)
{
activityLabel = label;
}
//打开WebView
public void SetWebView(string url)
{
setWebViewUtils.Call("StartWebView", url, activityLabel);
}
}
3、调用测试
在Unity编辑器里创建三个按钮,用来打开三个不同的链接。
将SetWebViewUtils脚本挂载至场景物体上。
三个按钮的调用方式如下,通过传入标题名称及需要打开的链接地址来打开相应的WebView。
4、切换至安卓平台,打包apk,安装测试便可
四、AAR包资源下载入口
如果有小伙伴看了以上教程还不知道如何封包,可以直接下载以下AAR包直接使用,里面有插件的包名,替换掉SetWebViewUtils脚本里的“包名”便可。