AgentWeb瀏覽器庫

簡介:

AgentWeb是基于Android WebView一個功能完善小型瀏覽器庫高度封裝的 Android WebView ，簡單易用 ， 帶有進(jìn)度條 、 文件上傳 、 下載 、 簡化 Javascript 通信 、 鏈?zhǔn)秸{(diào)用 、 加強(qiáng) Web 安然的庫 。讓你幾行代碼集成一個小型瀏覽器在你的應(yīng)用

AgentWeb 功能:

點擊進(jìn)入↓
AgentWeb
功能

  • 支持進(jìn)度條以及自定義進(jìn)度條
  • 支持文件下載
  • 支持文件下載斷點續(xù)傳
  • 支持下載通知形式提示進(jìn)度
  • 簡化 Javascript 通信
  • 支持文件上傳
  • 支持注入 Cookies
  • 加強(qiáng) Web 安全
  • 支持全屏播放視頻
  • 兼容低版本 Js 安全通信
  • 更省電 。
  • 支持調(diào)起微信支付
  • 支持調(diào)起支付寶（請參照sample）
  • 默認(rèn)支持定位
  • 支持傳入 WebLayout（下拉回彈效果）
  • 支持自定義 WebView
  • 支持 JsBridge

使用方法 簡潔易用:

1.添加依賴

implementation 'com.just.agentweb:agentweb:4.1.3' // (必選)
implementation 'com.just.agentweb:filechooser:4.1.3'// (可選)
implementation 'com.download.library:Downloader:4.1.3'// (可選)

2.加載網(wǎng)頁，以京東首頁為例：

        mAgentWeb = AgentWeb.with(this)//傳入Activity  在Fragment中使用Activity和Fragment兩個都傳
                .setAgentWebParent(mWebView, new LinearLayout.LayoutParams(-1, -1))//傳入AgentWeb 的父控件 ，如果父控件為 RelativeLayout ， 那么第二參數(shù)需要傳入 RelativeLayout.LayoutParams
                .useDefaultIndicator(-1,1)// 使用默認(rèn)進(jìn)度條
                .setSecurityType(AgentWeb.SecurityType.STRICT_CHECK)//WebView安全類型
                .setMainFrameErrorView(R.layout.agentweb_error_page, -1)//錯誤占位圖
                .setOpenOtherPageWays(DefaultWebClient.OpenOtherPageWays.ASK)//打開其他應(yīng)用時，彈窗咨詢用戶是否前往其他應(yīng)用
                .interceptUnkownUrl()
                .createAgentWeb()
                .ready()
                .go("http://www.jd.com");

不用配置 Setting ， 不用添加 WebChromeClient 就有進(jìn)度條 。

3.使用
安卓調(diào)用JavaScript方法：

//Javascript 方法
function callByAndroid(){
      console.log("callByAndroid")
  }
//Android 端
mAgentWeb.getJsEntraceAccess().quickCallJs("callByAndroid");
//結(jié)果
consoleMessage:callByAndroid  lineNumber:27

JavaScript調(diào)用安卓方法：


//Android 端 ， AndroidInterface 是一個注入類 ，里面有一個無參數(shù)方法：callAndroid 
mAgentWeb.getJsInterfaceHolder().addJavaObject("android",new AndroidInterfaceWeb(mAgentWeb,this)); 
//H5端  在 Js 里就能通過 
window.android.callAndroid() //調(diào)用 Java 層的 AndroidInterface 類里 callAndroid 方法

上面AndroidInterfaceWeb里的代碼(記住是這新建的一個類 共JS調(diào)用的)：

public class AndroidInterfaceWeb {
    private AgentWeb agent;
    private Activity activity;

    public AndroidInterfaceWeb(AgentWeb agent, Activity activity) {
        this.agent = agent;
        this.activity = activity;
    }

    //注解供JS調(diào)用 不寫會報錯
    @JavascriptInterface
    public void callAndroid() {
        Toast.makeText(activity, "潘潘", Toast.LENGTH_SHORT).show();
    }
}

跟隨 Activity 或者 Fragment 生命周期 ， 釋放 CPU和資源， 更省電 。方法如下：

    /**
     * 跟隨 Activity 生命周期釋放CPU更省電 ↓↓↓↓↓
     */
    @Override
    protected void onPause() {
        mAgentWeb.getWebLifeCycle().onPause();
        super.onPause();
    }
    @Override
    protected void onResume() {
        mAgentWeb.getWebLifeCycle().onResume();
        super.onResume();
    }
    @Override
    protected void onDestroy() {
        mAgentWeb.getWebLifeCycle().onDestroy();
        super.onDestroy();
    }

清空Web緩存:

AgentWebConfig.clearDiskCache(this);

事件處理 (直接按下返回鍵會退出當(dāng)前Activity,由新的事件接管 建議使用在Fragment)：

    @Override
    public boolean onKeyDown(int keyCode, KeyEvent event) {

        if (mAgentWeb.handleKeyEvent(keyCode, event)) {
            return true;
        }
        return super.onKeyDown(keyCode, event);
    }

如果非得想設(shè)置設(shè)置Chrome客戶端和View客戶端可以通過以下代碼:


    //設(shè)置Chrome客戶端
    private WebViewClient mWebViewClient = new WebViewClient() {
        @Override
        public void onPageStarted(WebView view, String url, Bitmap favicon) {
            //do you  work
        }
    };

    ////設(shè)置View客戶端   (子線程)
    private WebChromeClient mWebChromeClient = new WebChromeClient() {
        @Override
        public void onProgressChanged(WebView view, int newProgress) {
            //do you work
            //加載進(jìn)度
//            tv_jdt.setText(newProgress + "%");
            //給H5網(wǎng)頁傳參數(shù)
         mAgentWeb.getJsAccessEntrace().quickCallJs("checkTicketPage.appHook","哇哈哈"); //第一個參數(shù)為方法名, 第二個參數(shù)為Js方法的入?yún)?        }
    };

返回上一頁:

            if (!mAgentWeb.back()) {
                this.finish();
            }

如果不想要進(jìn)度條:(把設(shè)置進(jìn)度條的第一個屬性改成0,你就會發(fā)現(xiàn)進(jìn)度條神奇的消失了)

.useDefaultIndicator(0,1)

全屏視頻播放

<!--如果你的應(yīng)用需要用到視頻 ， 那么請你在使用 AgentWeb 的 Activity 對應(yīng)的清單文件里加入如下配置-->
android:hardwareAccelerated="true"
android:configChanges="orientation|screenSize"

定位

<!--AgentWeb 是默認(rèn)允許定位的 ，如果你需要該功能 ， 請在你的 AndroidManifest 文件里面加入如下權(quán)限 。-->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

獲取 WebView

mAgentWeb.getWebCreator().getWebView();

查看 Cookies

String cookies=AgentWebConfig.getCookiesByUrl(targetUrl);

同步 Cookie

AgentWebConfig.syncCookie("http://www.jd.com","ID=XXXX");

AgentWeb 所需要的全部權(quán)限(在你工程中根據(jù)需求選擇加入權(quán)限 不用全部添加)

    <uses-permission android:name="android.permission.INTERNET"></uses-permission>
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"></uses-permission>
    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"></uses-permission>
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"></uses-permission>
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"></uses-permission>
    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"></uses-permission>
    <uses-permission android:name="android.permission.READ_PHONE_STATE"></uses-permission>
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"></uses-permission>
    <uses-permission android:name="android.permission.CAMERA"></uses-permission>
    <uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES"></uses-permission>

混淆(如果你的項目需要加入混淆 ， 請加入如下配置)

-keep class com.just.agentweb.** {
    *;
}
-dontwarn com.just.agentweb.**

Java 注入類不要混淆 ， 例如 sample 里面的 AndroidInterface 類 ， 需要 Keep

-keepclassmembers class com.just.agentweb.sample.common.AndroidInterface{ *; }

修改 AgentWeb 默認(rèn)的背景色

        FrameLayout frameLayout = mAgentWeb.getWebCreator().getWebParentLayout();
        frameLayout.setBackgroundColor(Color.BLACK);

注意事項:

  • 支付寶使用需要引入支付寶SDK ，并在項目中依賴 ， 微信支付不需要做任何操作。
  • AgentWeb 內(nèi)部使用了 AlertDialog 需要依賴 AppCompat 主題 。
  • setAgentWebParent 不支持 ConstraintLayout 。
  • mAgentWeb.getWebLifeCycle().onPause();會暫停應(yīng)用內(nèi)所有WebView 。
  • minSdkVersion 低于等于16以下自定義WebView請注意與 JS 之間通信安全。
  • AgentWeb v3.0.0以上版本更新了包名，混淆的朋友們，請更新你的混淆配置。
  • 多進(jìn)程無法取消下載，解決方案

基本打開效果圖:(只使用第 1,2 步驟就可以實現(xiàn)基本效果 其他功能按需求去添加使用)

image.png

與原生WebView對比:
image.png

以上是個人經(jīng)驗總結(jié) 轉(zhuǎn)載請標(biāo)明...

最后編輯于 ：
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成，瀏覽時請結(jié)合常識與多方信息審慎甄別。
平臺聲明：文章內(nèi)容（如有圖片或視頻亦包括在內(nèi)）由作者上傳并發(fā)布，文章內(nèi)容僅代表作者本人觀點，簡書系信息發(fā)布平臺，僅提供信息存儲服務(wù)。

友情鏈接更多精彩內(nèi)容