AdAway/AdAway


AdAway is an open source ad blocker for Android using the hosts file.

https://adaway.org

License: Other

Language: C

Keywords: ad-blocker, android, hosts


AdAway

AdAway is an open source ad blocker for Android using the hosts file.

For more information visit http://adaway.org

Authors

AdAway is currently maintained by 0-kaladin and Dāvis Mošenkovs. The original author is Dominik Schürmann.

Build with Gradle

Build Executables

  1. Have NDK directory in your PATH (http://developer.android.com/tools/sdk/ndk/index.html)
  2. Change to "AdAway" directory with cd AdAway
  3. Execute ndk-build to compile native binaries.

Build APK

  1. Have Android SDK "tools", "platform-tools", and "build-tools" directories in your PATH (http://developer.android.com/sdk/index.html)
  2. Open the Android SDK Manager (shell command: android). Expand the Extras directory and install "Android Support Repository"
  3. Export ANDROID_HOME pointing to your Android SDK
  4. Execute ./gradlew renameExecutables (IMPORTANT unusual step!)
  5. Execute ./gradlew build

Contribute

Fork AdAway and do a Pull Request. I will merge your changes back into the main project.

Development

I am using the newest Android Studio for development. Development with Eclipse is currently not possible because I am using the new project structure.

  1. Clone the project from github
  2. From Android Studio: File -> Import Project -> Select the cloned top folder
  3. Import project from external model -> choose Gradle

Translations

Translations are hosted on Transifex, which is configured by ".tx/config".

  1. To pull newest translations install transifex client (e.g. apt-get install transifex-client)
  2. Config Transifex client with "~/.transifexrc"
  3. Go into root folder of git repo
  4. execute tx pull (tx pull -a to get all languages)

see http://docs.transifex.com/client/

Coding Style

Code

  • Indentation: 4 spaces, no tabs
  • Maximum line width for code and comments: 100
  • Opening braces don't go on their own line
  • Field names: Non-public, non-static fields start with m.
  • Acronyms are words: Treat acronyms as words in names, yielding !XmlHttpRequest, getUrl(), etc.

See http://source.android.com/source/code-style.html

XML

  • XML Maximum line width 999
  • XML: Split multiple attributes each on a new line (Eclipse: Properties -> XML -> XML Files -> Editor)
  • XML: Indent using spaces with Indention size 4 (Eclipse: Properties -> XML -> XML Files -> Editor)

See http://www.androidpolice.com/2009/11/04/auto-formatting-android-xml-files-with-eclipse/

AdAway/jni

Forked from the following sources and slightly modified to compile!

Changes

Please review the following commits for the changes made to the sources above in order for them to compile in this project:

Licenses

AdAway is licensed under the GPLv3+.
The file LICENSE includes the full license text.

Details

AdAway is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

AdAway is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with AdAway. If not, see http://www.gnu.org/licenses/.

Libraries

Images

  • status_enabled.svg, status_disabled.svg, status_update.svg
    Dropbox Emblems Tango by Charles A.
    http://forums.dropbox.com/topic.php?id=7818&replies=19
    Creative Commons Attribution 3.0 Unported License

  • status_fail.svg
    Faenza Icons
    GPLv3

  • icon.svg, banner.svg
    AdAway by Dominik Schürmann
    New version by Alin Ţoţea-Radu
    GPLv3

  • Menu Icons
    Original Android Icons

Project Statistics

Sourcerank 9
Repository Size 26.8 MB
Stars 1,930
Forks 322
Watchers 131
Open issues 180
Dependencies 0
Contributors 10
Tags 18
Created
Last updated
Last pushed

Top Contributors See all

Dominik Schürmann 0-kaladin Dāvis Mošenkovs Lo Huot strel William Budington Phoenix09 Jan Chren Matthias Urhahn Bob Igo

Recent Tags See all

v3.1.1 April 14, 2016
v3.1 October 11, 2015
v3.0.2 September 01, 2015
v3.0.1 August 06, 2015
v3.0 April 09, 2015
v2.9.2 October 13, 2014
v2.9.1 September 05, 2014
v2.9 September 03, 2014
v2.8.1 February 26, 2014
v2.8 October 12, 2013
v2.7 September 02, 2013
v2.6 August 29, 2013
v2.5 August 18, 2013
v2.4 August 18, 2013
v2.3 March 13, 2013

Interesting Forks See all

PerfectSlayer/AdAway
AdAway is an open source ad blocker for Android using the hosts file.
C - GPL-3.0 - Last pushed - 8 stars - 1 forks
pec0ra/AdAway
AdAway is an open source ad blocker for Android using the hosts file.
C - Last pushed - 6 stars
d4rken/ad-away
AdAway is an open source ad blocker for Android using the hosts file.
C - GPL-3.0 - Last pushed - 5 stars - 1 forks
0-kaladin/ad-away
AdAway is an open source ad blocker for Android using the hosts file.
C - GPL-3.0 - Last pushed - 2 stars
djdagovs/AdAway
AdAway is an open source ad blocker for Android using the hosts file.
C - Updated - 1 stars

Something wrong with this page? Make a suggestion

Last synced: 2017-11-24 18:52:50 UTC

Login to resync this repository