blockads-android

(★ 1,753)

Block ads system-wide on Android using local VPN-based DNS filtering. No root needed. No data collection.

  • .gitignore
  • build.gradle.kts
  • Gemfile
  • Gemfile.lock
  • gradle.properties
  • gradlew
  • gradlew.bat
  • ISSUES_ANALYSIS.md
  • ISSUES_REPORT_2026-06-11.md
  • LICENSE
  • README.md
  • settings.gradle.kts

# 설치 가이드

1. 코드 내려받기
git clone https://github.com/pass-with-high-score/blockads-android

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd blockads-android

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. 공식 설치 스크립트

쉬움 추천
사전 준비물
  • Go go install 명령어를 쓰려면 Go가 필요합니다.
go install golang.org/x/mobile/cmd/gomobile@v0.0.0-20240404231514-09dbf07665ed

지정된 버전을 바로 다운로드해서 설치합니다. 레포를 직접 클론할 필요가 없습니다.

설치 후 새 터미널을 열고, 프로그램의 버전 확인 명령(예: --version)으로 정상 설치됐는지 확인하세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

3. Gradle (Java/Kotlin)

보통
사전 준비물
  • Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
  • JDK (Java) Java/Kotlin 프로젝트를 빌드/실행하려면 필요합니다.
  • Gradle 레포에 포함된 gradlew(Gradle Wrapper)를 쓰면 Gradle을 따로 설치할 필요가 없습니다.
./gradlew buildGoTunnel

Gradle로 빌드를 진행합니다.

./gradlew assembleDebug

Gradle로 빌드를 진행합니다.

./gradlew bundleRelease # requires signing key

Gradle로 빌드를 진행합니다.

BUILD SUCCESSFUL 메시지가 뜨면 성공입니다. build/ 폴더에 결과물이 생성됩니다.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

4. Go

보통
사전 준비물
  • Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
  • Go Go 언어 컴파일러 및 도구 모음입니다.
go install golang.org/x/mobile/cmd/gomobile@v0.0.0-20240404231514-09dbf07665ed

지정된 버전을 바로 다운로드해서 설치합니다. 레포를 직접 클론할 필요가 없습니다.

빌드가 에러 없이 끝나면 성공입니다. go run . 을 썼다면 터미널 출력을 확인하세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

5. Ruby

쉬움
사전 준비물
  • Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
  • Ruby bundle 명령어를 쓰려면 Ruby가 필요합니다.
bundle install

Gemfile에 명시된 루비 라이브러리를 설치합니다.

bundle install이 에러 없이 끝나면 README에 안내된 실행 명령어(예: rails server)로 마저 실행해보세요.
// repository documentation