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 64b2dfb77c Bump version 20 hours ago
.circleci Update Circle CI to API 29 8 months ago
.github Update FUNDING.yml 9 months ago
core Add link-to-issue comment 4 days ago
gradle/wrapper Update dependencies 2 weeks ago
mobile Fix handling of missing plugin 2 weeks ago
plugin Update dependencies 2 weeks ago
tv Add OSS licenses to tv 4 weeks ago
.gitignore Update overture and migrate to go mod 1 year ago
.gitmodules Use re2 2 months ago
.travis.yml Use api-28-ndk image for CI 1 year ago
AUTHORS add AUTHORS 3 years ago
CONTRIBUTING.md Clarifying instruction documents (#2213) 9 months ago
LICENSE Update README and LICENSE 3 years ago
README.md Update README.md 4 weeks ago
build.gradle Bump version 20 hours ago
detekt.yml Update dependencies 1 week ago
gradle.properties Update android plugin 6 months ago
gradlew Use coreLibraryDesugaring 1 month ago
gradlew.bat Improve gesture navigation on Android Q beta 5 7 months ago
privacy_policy.md Update privacy_policy.md 1 year ago
release.sh Update to NDK r19 1 year ago
settings.gradle Initial design for Android TV 1 year ago
translate.py Update translations 7 months ago

README.md

Shadowsocks for Android

CircleCI API Releases Codacy Badge

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

PREREQUISITES

  • JDK 1.8
  • Android SDK
    • Android NDK

BUILD

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

  • 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

mkdir build
sudo chown 3434:3434 build
docker run --rm -v ${PWD}/build:/build circleci/android:api-28-ndk bash -c "cd /build; git clone https://github.com/shadowsocks/shadowsocks-android; cd shadowsocks-android; git submodule update --init --recursive; ./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/.