Rietveld Code Review Tool
Help | Bug tracker | Discussion group | Source code

Unified Diff: README.md

Issue 29782630: Issue 6000 - Rename "libadblockplus-android" (Closed)
Patch Set: Created May 15, 2018, 9:30 p.m.
Use n/p to move between diff chunks; N/P to move between comments.
Jump to:
View side-by-side diff with in-line comments
Download patch
« no previous file with comments | « no previous file | adblock-android-settings/AndroidManifest.xml » ('j') | no next file with comments »
Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
Index: README.md
===================================================================
--- a/README.md
+++ b/README.md
@@ -1,24 +1,24 @@
-Adblock Plus Library for Android
+Adblock Android SDK
================================
-An Android library project, tests and demo application for AdblockWebView widget.
+An Android library project, tests, settings fragments and demo application for AdblockWebView.
## Updating the dependencies
-Adblock Plus for Android has dependencies that aren't in this repository.
+Adblock Android SDK has dependencies that aren't in this repository.
To update those, call:
./ensure_dependencies.py
## Library
An Android library that provides the core functionality of Adblock Plus.
-You can find it in the 'libadblockplus-android' directory.
+You can find it in the 'adblock-android' directory.
### Building
#### Requirements
* [The Android SDK](https://developer.android.com/sdk)
* Android SDK Build tools 25.0.0
* [The Android NDK, 16b](https://developer.android.com/ndk)
@@ -32,17 +32,17 @@
sdk.dir = /some/where/sdk
ndk.dir = /some/where/ndk
In the project root directory run:
./gradlew assembleDebug
-This will generate *.aar library artifact in the 'libadblockplus-android/build/outputs/aar/' directory.
+This will generate *.aar library artifact in the 'adblock-android/build/outputs/aar/' directory.
**Android permissions note**
An app that uses the library have to add the following permissions to `AndroidManifest.xml`:
* `<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>`
* `<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>`
(added automatically if building with Gradle or should be added manually otherwise).
@@ -83,61 +83,61 @@
[Configuration] Excluding shared v8 library libv8.cr.so from AAR
...
[Configuration] Linking dynamically with shared v8 library ./libadblockplus-binaries/android_armeabi-v7a/libv8.cr.so
...
output while building.
Set `SHARED_V8_LIB_DIR` environment variable as full absolute path to pass
-specific directory instead of default one (`libadblockplus-android/jni/libadblockplus-binaries`).
+specific directory instead of default one (`adblock-android/jni/libadblockplus-binaries`).
### Building for single ARCH
-By default libadblockplus-android is built for both ARM and x86 and it can be filtered when
+By default adblock-android is built for both ARM and x86 and it can be filtered when
building end-user android application. However sometimes it can be desired to build
-"libadblockplus-android.aar" for single ARCH.
+"adblock-android.aar" for single ARCH.
Pass `abi_arm` or `abi_x86` to build it for single arch or `abi_all` for all ARCHs:
`./gradlew clean assembleAbi_arm`
Note
- [Configuration] Using libadblockplus-android ABI flavor: abi_arm
+ [Configuration] Using adblock-android ABI flavor: abi_arm
output while building.
## Library tests
Android tests for the library.
-You can find them in the 'libadblockplus-android-tests' directory.
+You can find them in the 'adblock-android-tests' directory.
### Requirements
Make sure _Library_ requirements are present.
### Building
Make sure you've created the _local.properties_ file to build the library (see above).
In the project root directory run:
./gradlew assembleDebugAndroidTest
-This will generate *.apk in the 'libadblockplus-android-tests/build/outputs/apk/' directory.
+This will generate *.apk in the 'adblock-android-tests/build/outputs/apk/' directory.
### Testing
You can select test class/method and click 'Run ..Test'. The library and test app will be
compiled, installed to emulator/device and launched automatically.
## Settings
An Android library that provides a configuration interface for Adblock Plus.
-You can find it in the 'libadblockplus-android-settings' directory:
+You can find it in the 'adblock-android-settings' directory:
* GeneralSettingsFragment - main fragment
* WhitelistedDomainsSettingsFragment - whitelisted domains fragment
### Usage
Create `AdblockEngineProvider` instance and `AdblockSettingsStorage` instance.
You can use `SharedPrefsStorage` implementation to store settings in `SharedPreferences`.
Or you can use AdblockHelper:
@@ -202,22 +202,22 @@
Insert `GeneralSettingsFragment` fragment instance in runtime to start showing settings UI.
### Building
In the project root directory run:
./gradlew assemble
-This will generate *.aar in the 'libadblockplus-android-settings/build/outputs/aar' directory.
+This will generate *.aar in the 'adblock-android-settings/build/outputs/aar' directory.
## WebView
An Android library that provides a WebView component with Adblock Plus integrated.
-You can find it in the 'libadblockplus-android-webview' directory.
+You can find it in the 'adblock-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:
@@ -248,24 +248,24 @@
Note it can be invoked from background thread.
### Building
In the project root directory run:
./gradlew assemble
-This will generate *.aar in the 'libadblockplus-android-webview/build/outputs/aar' directory.
+This will generate *.aar in the 'adblock-android-webview/build/outputs/aar' directory.
## WebView Application
An Android application that demonstrates how to use AdblockWebView.
-You can find it in the 'libadblockplus-android-webviewapp' directory.
+You can find it in the 'adblock-android-webviewapp' directory.
### Building
Make sure _Library_ requirements are present.
In the project root directory run:
./gradlew assemble
-This will generate *.apk in the 'libadblockplus-android-webviewapp/build/outputs/apk/' directory.
+This will generate *.apk in the 'adblock-android-webviewapp/build/outputs/apk/' directory.
« no previous file with comments | « no previous file | adblock-android-settings/AndroidManifest.xml » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld