Issue 4399 - Add WebView inheritor with ad blocking

README.md

 Adblock Plus Library for Android
 ========================
 
 An Android library project, tests and demo application for AdblockWebView widget.
 
 Updating the dependencies
 -------------------------
 
 Adblock Plus Library for Android has dependencies that aren't in this repository.
 To update those, call:
@@ skipping 27 matching lines @@
 -------------------
 
 ### Requirements
 
 All 'Building with Ant' requirements and additional requirements:
 
 * [Maven](https://maven.apache.org)
 
 ### Building
 
+Go to android sdk directory '/platforms/android-21' and run:
+
+    mvn install:install-file -Dfile=./android.jar -DgroupId=com.google.android -DartifactId=android
+     -Dversion=5.0 -Dpackaging=jar -DgeneratePom=true
+
 Set environment variable ANDROID_HOME to your Android SDK directory or pass it in command-line (below).
-In the 'libadblockplus-android' directory run:
+In the root directory run:
 
         mvn clean install [-Dandroid.sdk.path=/some/where/sdk]
 
-This will generate *.aar library artifact in the 'target' directory. 
+This will generate *.aar library artifacts in the 'libadblockplus-android/target',
+'libadblockplus-android-webview/target' directories and *.apk in
+'libadblockplus-android-webviewapp/target' directory.
 
 Building with Gradle/Android Studio
 -----------------------------------
 
 ### Requirements
 
 * [The Android SDK](http://developer.android.com/sdk)
 * Android SDK Build tools 22.0.1
 * [The Android NDK](https://developer.android.com/tools/sdk/ndk)
 
@@ skipping 75 matching lines @@
 You can find 'AdblockWebView' class in 'libadblockplus-android-webview' directory.
 
 `AdblockWebView` class provides built-in ad blocking
 (both resource loading filtering and element hiding) and inherits from Android
 ['WebView'](https://developer.android.com/reference/android/webkit/WebView.html).
 
 ### Usage
 
 In layout XML:
 
-    <org.adblockplus.android.AdblockWebView
+    <org.adblockplus.libadblockplus.android.webview.AdblockWebView
         android:id="@+id/main_webview"
         android:layout_width="match_parent"
         android:layout_height="match_parent"/>
 
 In java source code:
 
     AdblockWebView webView = (AdblockWebView) findViewById(R.id.main_webview);
 
+Use `setAdblockEnabled(boolean adblockEnabled)` to enable/disable adblocking.
+
 Use `setDebugMode(boolean debugMode)` to turn debug log output (Android log and JS console) on/off.
 
 Use `setAllowDrawDelay(int allowDrawDelay)` to set custom delay to start render webpage after 'DOMContentLoaded' event is fired.
 
-Use `setFilterEngine(FilterEngine newFilterEngine)` to use external filter engine
-If filter engine is not set, it's created by AdblockWebView instance automatically.
-
-Use `setAcceptableAdsEnabled(boolean enabled)` to enable/disable Acceptable Ads.
-
-Use `dispose()` to release resources (**required**).
+Use `setAdblockEngine(AdblockEngine adblockEngine)` to use external adblock engine
+If adblock engine is not set, it's created by AdblockWebView instance automatically.
+
+Use `dispose(Runnable disposeFinished)` to release resources (**required**).
+Note it can be invoked from background thread.
 
 ### Building
 
 Building with Ant
 -----------------
 
 In the 'libadblockplus-android-webview' directory create the file _local.properties_ and set
 _sdk.dir_ to where you installed it, e.g.:
 
     sdk.dir = /some/where/sdk
@@ skipping 36 matching lines @@
 This will generate *.apk in 'libadblockplus-android-webviewapp/bin/' directory.
 
 Building with Gradle
 --------------------
 
 In the project root directory run:
 
     ./gradlew assemble
 
 This will generate *.apk in 'libadblockplus-android-webviewapp/build/outputs/apk/' directory.