OLD | NEW |
1 Adblock Plus Library for Android | 1 Adblock Plus Library for Android |
2 ================================ | 2 ================================ |
3 | 3 |
4 An Android library project, tests and demo application for AdblockWebView widget
. | 4 An Android library project, tests and demo application for AdblockWebView widget
. |
5 | 5 |
6 ## Updating the dependencies | 6 ## Updating the dependencies |
7 | 7 |
8 Adblock Plus for Android has dependencies that aren't in this repository. | 8 Adblock Plus for Android has dependencies that aren't in this repository. |
9 To update those, call: | 9 To update those, call: |
10 | 10 |
(...skipping 73 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
84 This will generate *.aar library artifact in the 'libadblockplus-android/build/o
utputs/aar/' directory. | 84 This will generate *.aar library artifact in the 'libadblockplus-android/build/o
utputs/aar/' directory. |
85 | 85 |
86 **Android permissions note** | 86 **Android permissions note** |
87 | 87 |
88 An app that uses the library have to add the following permissions to `AndroidMa
nifest.xml`: | 88 An app that uses the library have to add the following permissions to `AndroidMa
nifest.xml`: |
89 * `<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>` | 89 * `<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>` |
90 * `<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>` | 90 * `<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>` |
91 | 91 |
92 (added automatically if building with Gradle or should be added manually otherwi
se). | 92 (added automatically if building with Gradle or should be added manually otherwi
se). |
93 | 93 |
| 94 ### Building with prebuilt shared V8 |
| 95 |
| 96 This can be desired to use product's V8 (let's say Chromium) instead of built-in
V8. |
| 97 Put prebuilt shared V8 library file(s) in ARCH directories and set `SHARED_V8_LI
B_FILENAMES` |
| 98 environment variable before building. You can pass multiple filenames, separated
with space. |
| 99 Libadblockplus is required to be linked with that library file(s). |
| 100 |
| 101 For example (build with Gradle): |
| 102 |
| 103 SHARED_V8_LIB_FILENAMES=libv8.cr.so ./gradlew clean assemble |
| 104 |
| 105 or |
| 106 |
| 107 SHARED_V8_LIB_FILENAMES="libv8.cr.so libfoo.so" ./gradlew clean assemble |
| 108 |
| 109 for multiple library files. |
| 110 |
| 111 Note |
| 112 |
| 113 [Configuration] Excluding shared v8 library libv8.cr.so from AAR |
| 114 ... |
| 115 [Configuration] Linking dynamically with shared v8 library ./libadblockplus-
binaries/android_armeabi-v7a/libv8.cr.so |
| 116 ... |
| 117 |
| 118 output while building. |
| 119 |
94 ## Library tests | 120 ## Library tests |
95 | 121 |
96 Android tests for the library. | 122 Android tests for the library. |
97 You can find them in the 'libadblockplus-android-tests' directory. | 123 You can find them in the 'libadblockplus-android-tests' directory. |
98 | 124 |
99 ### Requirements | 125 ### Requirements |
100 | 126 |
101 Make sure _Library_ requirements are present. | 127 Make sure _Library_ requirements are present. |
102 | 128 |
103 ### Building with Ant | 129 ### Building with Ant |
(...skipping 194 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
298 | 324 |
299 This will generate *.apk in the 'libadblockplus-android-webviewapp/bin/' directo
ry. | 325 This will generate *.apk in the 'libadblockplus-android-webviewapp/bin/' directo
ry. |
300 | 326 |
301 #### Building with Gradle | 327 #### Building with Gradle |
302 | 328 |
303 In the project root directory run: | 329 In the project root directory run: |
304 | 330 |
305 ./gradlew assemble | 331 ./gradlew assemble |
306 | 332 |
307 This will generate *.apk in the 'libadblockplus-android-webviewapp/build/outputs
/apk/' directory. | 333 This will generate *.apk in the 'libadblockplus-android-webviewapp/build/outputs
/apk/' directory. |
OLD | NEW |