JackyAnn
diff --git a/‎.circleci/config.yml‎
Lines changed: 41 additions & 0 deletions b/‎.circleci/config.yml‎
Lines changed: 41 additions & 0 deletions
diff --git a/‎.github/FUNDING.yml‎
Lines changed: 1 addition & 0 deletions b/‎.github/FUNDING.yml‎
Lines changed: 1 addition & 0 deletions
diff --git a/‎.github/ISSUE_TEMPLATE/bug_report.md‎
Lines changed: 61 additions & 0 deletions b/‎.github/ISSUE_TEMPLATE/bug_report.md‎
Lines changed: 61 additions & 0 deletions
diff --git a/‎.github/ISSUE_TEMPLATE/feature_request.md‎
Lines changed: 22 additions & 0 deletions b/‎.github/ISSUE_TEMPLATE/feature_request.md‎
Lines changed: 22 additions & 0 deletions
diff --git a/‎.github/ISSUE_TEMPLATE/questions-support-requests-other.md‎
Lines changed: 10 additions & 0 deletions b/‎.github/ISSUE_TEMPLATE/questions-support-requests-other.md‎
Lines changed: 10 additions & 0 deletions
diff --git a/‎.github/doc-json.md‎
Lines changed: 109 additions & 0 deletions b/‎.github/doc-json.md‎
Lines changed: 109 additions & 0 deletions
diff --git a/‎.github/faq.md‎
Lines changed: 6 additions & 13 deletions b/‎.github/faq.md‎
Lines changed: 6 additions & 13 deletions
diff --git a/‎.github/faq.ru.md‎
Lines changed: 10 additions & 17 deletions b/‎.github/faq.ru.md‎
Lines changed: 10 additions & 17 deletions
diff --git a/‎.github/issue_template.md‎
Lines changed: 0 additions & 44 deletions b/‎.github/issue_template.md‎
Lines changed: 0 additions & 44 deletions
@@ -0,0 +1,41 @@
+version: 2
+jobs:
+  build:
+    working_directory: ~/code
+    docker:
+      - image: shadowsocks/android-ndk-go
+    environment:
+      GRADLE_OPTS: -Dorg.gradle.workers.max=1 -Dorg.gradle.daemon=false -Dkotlin.compiler.execution.strategy="in-process"
+    steps:
+      - checkout
+      - run: git submodule update --init --recursive
+      - run: rustup default nightly-2022-08-28
+      - run: cd core/src/main/rust/shadowsocks-rust && rustup target add armv7-linux-androideabi aarch64-linux-android i686-linux-android x86_64-linux-android
+      - restore_cache:
+          key: jars-{{ checksum "build.gradle.kts" }}
+      - run:
+          name: Run Build and Tests
+          command: ./gradlew assembleDebug check -PCARGO_PROFILE=debug
+      - save_cache:
+          paths:
+            - ~/.gradle
+            - ~/.android/build-cache
+          key: jars-{{ checksum "build.gradle.kts" }}
+      - store_artifacts:
+          path: mobile/build/outputs/apk
+          destination: apk/mobile
+      - store_artifacts:
+          path: tv/build/outputs/apk
+          destination: apk/tv
+      - store_artifacts:
+          path: core/build/reports
+          destination: reports/core
+      - store_artifacts:
+          path: mobile/build/reports
+          destination: reports/mobile
+      - store_artifacts:
+          path: plugin/build/reports
+          destination: reports/plugin
+      - store_artifacts:
+          path: tv/build/reports
+          destination: reports/tv
@@ -0,0 +1 @@
+github: [Mygod]
@@ -0,0 +1,61 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: bug
+assignees: ''
+
+---
+
+Please read contributing guidelines. Thanks.
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Smartphone (please complete the following information):**
+ - Android/Chrome OS version: [e.g. "7.0.0_r14" or "71.0.3578.94 (32-bit)", more detailed description is preferred]
+ - Device: [e.g. Google Pixel XL]
+ - Version: [e.g. version code "v3.0.0" or commit ID "a073f85"]
+ - Last version that did not exhibit the issue: [not applicable]
+
+**Configuration**
+Put an `x` inside the [ ] that applies.
+
+* [ ] IPv4 server address
+* [ ] IPv6 server address
+* [ ] Client IPv4 availability
+* [ ] Client IPv6 availability
+* Encrypt method:
+* Route
+  * [ ] All
+  * [ ] Bypass LAN
+  * [ ] Bypass China
+  * [ ] Bypass LAN & China
+  * [ ] GFW List
+  * [ ] China List
+  * [ ] Custom rules
+* [ ] IPv6 route
+* [ ] Apps VPN mode
+  * [ ] Bypass mode
+* Remote DNS: 8.8.8.8
+* [ ] DNS over UDP
+* Plugin configuration (if applicable):
+* [ ] Auto Connect
+* [ ] TCP Fast Open
+* If you're not using VPN mode, please supply more details here:
+
+**Additional context**
+Add any other context about the problem here.
@@ -0,0 +1,22 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: enhancement
+assignees: ''
+
+---
+
+Please read contributing guidelines. Thanks.
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.
@@ -0,0 +1,10 @@
+---
+name: Questions/Support requests/Other
+about: You should probably use the forum
+title: ''
+labels: question
+assignees: ''
+
+---
+
+Please use the forum at https://discourse.shadowsocks.org/c/implementations/shadowsocks-android instead. Your issue will probably be closed.
@@ -0,0 +1,109 @@
+# Documentation for JSON format
+
+shadowsocks-android accepts processing Shadowsocks configs through JSON files.
+This documentation is targeted towards Shadowsocks server maintainers, who might need to distribute server configs through subscription JSON files, which is supported since [v5.0.0](https://github.com/shadowsocks/shadowsocks-android/releases/tag/v5.0.0).
+
+## `Profile` JSON object
+
+In general, shadowsocks-android respects [the specification at shadowsocks.org](https://shadowsocks.org/en/config/quick-guide.html).
+A JSON object is recognized as a `Profile` (i.e. a valid server config), if all of the following required fields are present and valid:
+
+* `server`
+* `server_port`
+* `password`
+* `method`
+
+These fields have the same meaning as specified by shadowsocks.org.
+The specification at shadowsocks.org additionally specifies two additional fields, which is not used by shadowsocks-android:
+
+* `local_port`: This field is configured globally through "SOCKS5 proxy port".
+* `timeout`: This field is hardcoded to 600 in shadowsocks-android (however, it is only used as a write timeout, so long idle connections like GMS heartbeat are allowed).
+
+Additionally, shadowsocks-android accepts the following optional fields:
+
+* `plugin`: shadowsocks-android plugin ID or [alias](https://github.com/shadowsocks/shadowsocks-android/pull/2431).
+* `plugin_opts`: Plugin options [as specified in shadowsocks.org](https://shadowsocks.org/en/spec/Plugin.html).
+* `remarks`: "Profile Name". (also used by [shadowsocks-windows](https://github.com/shadowsocks/shadowsocks-windows))
+* `udp_fallback`: "UDP Fallback", should be a `Profile` JSON object or null.
+
+The following optional fields are "Feature Settings" in shadowsocks-android, if omitted, their values will be copied from currently selected profile:
+
+* `route`: "Route", should be one of `all`, `bypass-lan`, `bypass-china`, `bypass-lan-china`, `gfwlist`, `china-list`, `custom-rules`.
+* `ipv6`: "IPv6 Route", Boolean.
+* `proxy_apps`: "Apps VPN mode", is a JSON object with the following fields:
+  - `enabled`: Boolean.
+  - `bypass`: Boolean, whether the app specified should be bypassed or proxied.
+  - `android_list`: An array of strings, specifying a list of Android app [package names](https://developer.android.com/studio/build/application-id).
+* `udpdns`: "Send DNS over UDP", Boolean.
+
+`Profile` objects can have additional fields, which will be ignored by shadowsocks-android.
+
+
+## Parsing/Importing JSON
+
+shadowsocks-android imports JSON using the following logic, which should support all reasonable formats of JSON files containing `Profile`s, including `gui-config.json` used by shadowsocks-windows.
+
+1. On input a JSON file, try to recognize it as a `Profile`.
+2. If input is an object and all the required fields of a `Profile` is present, return the parsed `Profile`.
+3. Otherwise if input is an object, recursively search for `Profile`s in each field and return all found `Profile`s.
+4. Otherwise if input is an array, recursively search for `Profile`s for each element and return all found `Profile`s.
+5. Conclude that there is no `Profile` in input.
+
+In general, subscription JSON file can be in any structure, as long as they contain the `Profile` JSON objects recognized by the above procedure.
+
+
+## Exporting JSON
+
+The easiest way to write JSON files is to configure them in shadowsocks-android and export the JSON file using the app.
+The output will be a JSON file consisting of a JSON array with all the `Profile`s.
+
+
+## Subscription update behavior
+
+In shadowsocks-android, `Profile` is indexed by the triple `(server, server_port, remarks)`.
+If two `Profile`s share the exact same triple, they will be treated as the exact same `Profile`, despite possibly having different plugins, passwords, or even encryption methods.
+
+When doing subscription updates,
+
+* If an old `Profile` shares the same triple as a new `Profile`, the following field in the old `Profile` will be updated: `password`, `method`, `plugin`, `plugin_opts`, `udp_fallback`.
+  This ensures that user configured feature settings and traffic stats are preserved.
+* If two `Profile` across all the subscriptions share the exact same triple, the behavior is undefined.
+  Please avoid this if possible.
+
+
+## Appendix: Sample exported JSON file
+
+```json
+[
+  {
+    "server": "198.199.101.152",
+    "server_port": 8388,
+    "password": "u1rRWTssNv0p",
+    "method": "aes-256-cfb",
+    "remarks": "Example 1"
+  },
+  {
+    "server": "198.199.101.12",
+    "server_port": 8388,
+    "password": "u1rRWTssNv0p",
+    "method": "aes-256-cfb",
+    "plugin": "v2ray",
+    "plugin_opts": "host=www.example.com",
+    "remarks": "Example 2",
+    "route": "bypass-lan-china",
+    "remote_dns": "dns.google",
+    "ipv6": true,
+    "metered": false,
+    "proxy_apps": {
+      "enabled": true,
+      "bypass": true,
+      "android_list": [
+        "com.eg.android.AlipayGphone",
+        "com.wudaokou.hippo",
+        "com.zhihu.android"
+      ]
+    },
+    "udpdns": false
+  }
+]
+```
@@ -12,11 +12,6 @@ Crash: [Submit an issue](https://github.com/shadowsocks/shadowsocks-android/issu
 
 Use [Tasker](http://tasker.dinglisch.net/) integration.
 
-### How to add QR code from local gallery?
-
-Scan it with a third-party scanner like [QuickMark Barcode Scanner](https://play.google.com/store/apps/details?id=tw.com.quickmark) and click the `ss` url.
-
-
 ### Why is NAT mode deprecated?
 
 1. Requiring ROOT permission;
@@ -31,14 +26,18 @@ The exclamation mark in the Wi-Fi/cellular icon appears because the system fails
 
 1. Some ROM has broken VPNService implementation, especially for IPv6;
 2. Some ROM has aggressive (or called broken) background service killing policy;
-3. Some ROM like [Flyme](https://github.com/shadowsocks/shadowsocks-android/issues/1589) has **very** broken direct boot support;
+3. Some ROM like [Flyme](https://github.com/shadowsocks/shadowsocks-android/issues/1821) is basically broken **in every way possible**;
 4. If you have Xposed framework and/or battery saver apps, it's likely that this app wouldn't work well with these either.
 
-* Fixes for MIUI: [#772](https://github.com/shadowsocks/shadowsocks-android/issues/772) [#888](https://github.com/shadowsocks/shadowsocks-android/issues/888)
+* Fixes for MIUI: [#772](https://github.com/shadowsocks/shadowsocks-android/issues/772)
+* Fixes for EMUI: [#888](https://github.com/shadowsocks/shadowsocks-android/issues/888)
 * Fixes for Huawei: [#1091 (comment)](https://github.com/shadowsocks/shadowsocks-android/issues/1091#issuecomment-276949836)
 * Related to Xposed: [#1414](https://github.com/shadowsocks/shadowsocks-android/issues/1414)
 * Samsung and/or Brevent: [#1410](https://github.com/shadowsocks/shadowsocks-android/issues/1410)
+* Another Samsung: [#1712](https://github.com/shadowsocks/shadowsocks-android/issues/1712)
+* Samsung with GMS: [#2138](https://github.com/shadowsocks/shadowsocks-android/issues/2138)
 * Don't install this app on SD card because of permission issues: [#1124 (comment)](https://github.com/shadowsocks/shadowsocks-android/issues/1124#issuecomment-307556453)
+* `INTERACT_ACROSS_USERS` permission missing: [#1184](https://github.com/shadowsocks/shadowsocks-android/issues/1184)
 
 ### How to pause Shadowsocks service?
 
@@ -58,12 +57,6 @@ More details: https://kb.adguard.com/en/android/solving-problems/battery
 
 Allow this app to consume background data in app settings.
 
-### Why Camera permission is required on devices below Android 6.0?
-
-To scan the QR code through the integrated QR scanner.
-
-By the way, upgrade your Android system already.
-
 ### How to use Transproxy mode?
 
 1. Install [AFWall+](https://github.com/ukanth/afwall);
 
@@ -12,11 +12,6 @@
 
 Использйте интеграцию с [Tasker](http://tasker.dinglisch.net/).
 
-### Как добавить QR код из локальной галереи?
-
-Отсканируйте его при помощи стороннего сканера, например [QuickMark Barcode Scanner](https://play.google.com/store/apps/details?id=tw.com.quickmark) и нажмите на `ss` ссылку.
-
-
 ### Почему режим NAT более не поддерживается?
 
 1. Требуются ROOT права;
@@ -30,14 +25,18 @@
 ### Почему мой ROM не поддерживается?
 
 1. Некоторые ROM используют неправильную реализацию службы VPN, особенно IPv6;
-2. Некоторые ROM используют агрессивную (или так называемую неправильную) фоновую службу с ошибочной политикой остановки;
-3. Если вы используете фреймворк Xposed и/или приложения для энергосбережения, вероятно наше приложение не будет нормально работать с ними.
+2. Некоторые ROM используют агрессивную (или так называемую испорченную) неправильную политику остановки фоновых служб;
+3. Некоторые ROM, такие как [Flyme](https://github.com/shadowsocks/shadowsocks-android/issues/1821) просто не работают **в любом случае**;
+4. Если вы используете фреймворк Xposed и/или приложения для энергосбережения, вероятно наше приложение не будет нормально работать с ними.
 
-* Иправления для MIUI: [#772](https://github.com/shadowsocks/shadowsocks-android/issues/772)
+* Исправления для MIUI: [#772](https://github.com/shadowsocks/shadowsocks-android/issues/772)
+* Исправления для EMUI: [#888](https://github.com/shadowsocks/shadowsocks-android/issues/888)
 * Иправления для Huawei: [#1091 (комментарий)](https://github.com/shadowsocks/shadowsocks-android/issues/1091#issuecomment-276949836)
-* Вызванные из-за Xposed: [#1414](https://github.com/shadowsocks/shadowsocks-android/issues/1414)
+* Связанные с Xposed: [#1414](https://github.com/shadowsocks/shadowsocks-android/issues/1414)
 * Samsung и/или Brevent: [#1410](https://github.com/shadowsocks/shadowsocks-android/issues/1410)
+* Ещё Samsung: [#1712](https://github.com/shadowsocks/shadowsocks-android/issues/1712)
 * Не устанавливайте это приложение на SD карту, из-за проблем с разрешениями: [#1124 (комментарий)](https://github.com/shadowsocks/shadowsocks-android/issues/1124#issuecomment-307556453)
+* Отсутствует разрешение `INTERACT_ACROSS_USERS`: [#1184](https://github.com/shadowsocks/shadowsocks-android/issues/1184)
 
 ### Как приостановить службу Shadowsocks?
 
@@ -49,21 +48,15 @@
 
 Так как Shadowsocks работает со всем траффиком устройства, заряд батареи используемый другими приложениями также считается за тот, что использует Shadowsocks. Таким образом использование батареи Shadowsocks'ом равен сумме всей активности устройства в сети. Shadowsocks сам по себе в общем-то является приложением связанного процесса ввода/вывода на современных Android устройствах, которое, ожидаемо, не потребляет значительного количества энергии.
 
-Так что если вы заметите значительное увеличение потребляемой энергии после того, как вы использовали Shadowsocks, это скорее всего вызванно другими приложениями. Например, сервисы Google Play могут потреблять больше энергии после того, как подключатся к Google, и т.д.
+Так что если вы заметите значительное увеличение потребляемой энергии после того, как вы использовали Shadowsocks, это скорее всего вызванно другими приложениями. Например, сервисы Google Play могут потреблять больше энергии после того, как смогут подключиться к Google, и т.д.
 
 Больше информации: https://kb.adguard.com/en/android/solving-problems/battery
 
 ### Оно прекрасно работает при Wi-Fi но не может подключиться через сотовую связь?
 
 Разрешите этому приложению передачу данных в фоновом режиме в настройках приложения.
 
-Если у вас оперератор Yota, то измените точку доступа APN с `yota.ru` на `client.yota.ru`
-
-### Почему требуется разрешение камере на устройствах младше Android 6.0?
-
-Чтобы сканировать QR код через встроенный QR сканер.
-
-Кстати, обновите уже свою версию Android.
+Если у вас оперератор Yota, то увы, но они запрещают P2P-траффик, коим является (или просто определяется фильтрами оператора как P2P-траффик) Shadowsocks. Оператор не будет предпринимать никаких действий для решения данной проблемы.
 
 ### Как использовать режим Transproxy (прозрачный прокси)?