You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
Max Lv fbffc9841f Disable UDP relay if plugin is enabled and no fallback 3 months ago
.circleci Update NDK 4 months ago
.github Update issue templates with labels 5 months ago
buildSrc Bump version 4 months ago
core Disable UDP relay if plugin is enabled and no fallback 3 months ago
gradle/wrapper Update dependencies 4 months ago
mobile Use any address as default DNS 4 months ago
plugin Migrate to Kotlin DSL (#2490) 5 months ago
tv Migrate to Kotlin DSL (#2490) 5 months ago
.gitignore Update overture and migrate to go mod 1 year ago
.gitmodules Fix output name second attempt 4 months ago
.travis.yml Use api-28-ndk image for CI 1 year ago
AUTHORS add AUTHORS 4 years ago
CONTRIBUTING.md Clarifying instruction documents (#2213) 1 year ago
LICENSE Update README and LICENSE 3 years ago
README.md Update NDK 4 months ago
build.gradle.kts Update dependencies 4 months ago
detekt.yml Update dependencies 4 months ago
gradle.properties Update android plugin 1 year ago
gradlew Use coreLibraryDesugaring 8 months ago
gradlew.bat Update dependencies 5 months ago
privacy_policy.md Update privacy_policy.md 1 year ago
release.sh Update to NDK r19 1 year ago
repositories.gradle.kts Update dependencies 4 months ago
settings.gradle.kts Migrate to Kotlin DSL (#2490) 5 months ago
translate.py Update translations 1 year ago

README.md

Shadowsocks for Android

CircleCI API Releases Language: Kotlin Codacy Badge License: GPL-3.0

for Android & Chrome OS (beta)
for Android TV (beta)

PREREQUISITES

  • JDK 1.8
  • Android SDK
    • Android NDK
  • Rust with Android targets installed
    $ rustup target install armv7-linux-androideabi aarch64-linux-android i686-linux-android x86_64-linux-android

BUILD

You can check whether the latest commit builds under UNIX environment by checking Travis status.

  • Install prerequisites
  • Clone the repo using git clone --recurse-submodules <repo> or update submodules using git submodule update --init --recursive
  • Build it using Android Studio or gradle script

BUILD WITH DOCKER

  • Clone the repo using git clone --recurse-submodules <repo> or update submodules using git submodule update --init --recursive
  • Run docker run --rm -v ${PWD}:/build -w /build shadowsocks/android-ndk-go ./gradlew assembleDebug

CONTRIBUTING

If you are interested in contributing or getting involved with this project, please read the CONTRIBUTING page for more information. The page can be found here.

TRANSLATE

OPEN SOURCE LICENSES

LICENSE

Copyright (C) 2017 by Max Lv <max.c.lv@gmail.com>
Copyright (C) 2017 by Mygod Studio <contact-shadowsocks-android@mygod.be>

This program 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.

This program 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 this program. If not, see http://www.gnu.org/licenses/.