mirror of
https://github.com/syncthing/syncthing-android.git
synced 2024-11-29 15:51:17 +00:00
7791787bbc
* Add script to update submodule * Update publish-release.sh * Add helper script to build syncthing submodule only * Enable HTTPS for REST/WebUI only if OS supports it (fixes #137) * Update ApiRequest to handle both http or https * Add Constants#osSupportsTLS12 * Update APK version to 0.14.54.2 / 4181 * Update README.md * Update whatsnew
71 lines
3.9 KiB
Markdown
71 lines
3.9 KiB
Markdown
# Fork of Syncthing-Android:
|
|
|
|
[](https://opensource.org/licenses/MPL-2.0)
|
|
<a href="https://github.com/Catfriend1/syncthing-android/releases" alt="GitHub release"><img src="https://img.shields.io/github/release/Catfriend1/syncthing-android/all.svg" /></a>
|
|
<a href="https://f-droid.org/de/packages/com.github.catfriend1.syncthingandroid" alt="F-Droid release"><img src="https://img.shields.io/f-droid/v/com.github.catfriend1.syncthingandroid.svg" /></a>
|
|
|
|
# Major enhancements in this fork are:
|
|
- Individual sync conditions can be applied per device and per folder (for expert users).
|
|
- Recent changes UI, click to open files.
|
|
- UI explains why syncthing is running or not running according to the run conditions set in preferences.
|
|
- "Battery eater" problem is fixed.
|
|
- Android 8 and 9 support.
|
|
- Many bug fixes, enhancements and more frequent releases.
|
|
|
|
A wrapper of [Syncthing](https://github.com/syncthing/syncthing) for Android. Head to the "releases" section or F-Droid for builds. Please open an issue under this fork if you need help. Important: Please don't file bugs at the upstream repository "syncthing-android" if you are using this fork.
|
|
|
|
<img src="app/src/main/play/en-GB/listing/phoneScreenshots/screenshot_phone_12.png" alt="screenshot 1" width="200" /> <img src="app/src/main/play/en-GB/listing/phoneScreenshots/screenshot_phone_11.png" alt="screenshot 2" width="200" /> <img src="app/src/main/play/en-GB/listing/phoneScreenshots/screenshot_phone_09.png" alt="screenshot 3" width="200" />
|
|
|
|
# Please participate in quality assurance testing
|
|
See https://github.com/Catfriend1/syncthing-android/issues/122 for more details and QA builds.
|
|
|
|
# Goal of the forked version
|
|
- Develop and try out enhancements together
|
|
- Release the wrapper more frequently to identify and fix bugs together caused by changes in the syncthing submodule
|
|
- Make enhancements configurable in the settings UI, e.g. users should be able to turn them on and off
|
|
- Let's get ready for newer Android versions that put limits on background syncing tools. We need your bug reports as detailed as possible
|
|
|
|
# Translations
|
|
|
|
The project is translated on [Transifex](https://www.transifex.com/projects/p/syncthing-android-1).
|
|
|
|
# Building
|
|
|
|
### Prerequisites
|
|
- Android SDK
|
|
`You can skip this if you are using Android Studio.`
|
|
- Android NDK r16b
|
|
`$ANDROID_NDK_HOME environment variable should point at the root directory of your NDK. If the variable is not set, build-syncthing.py will automatically try to download and setup the NDK.`
|
|
- Go 1.9.7
|
|
`Make sure, Go is installed and available on the PATH environment variable. If Go is not found on the PATH environment variable, build-syncthing.py will automatically try to download and setup GO on the PATH.`
|
|
- Python 2.7
|
|
`Make sure, Python is installed and available on the PATH environment variable.`
|
|
- Git (for Linux) or Git for Windows
|
|
`Make sure, git (or git.exe) is installed and available on the PATH environment variable. If Git is not found on the PATH environment variable, build-syncthing.py will automatically try to download and setup MinGit 2.19.0-x64 on the PATH.`
|
|
- Java Version 8 (you might need to set `$JAVA_HOME` accordingly)
|
|
|
|
### Build instructions
|
|
|
|
Make sure you clone the project with
|
|
`git clone https://github.com/Catfriend1/syncthing-android.git --recursive`.
|
|
Alternatively, run `git submodule init && git submodule update` in the project folder.
|
|
|
|
A Linux VM, for example running Debian, is recommended to build this.
|
|
|
|
Build Syncthing and the Syncthing-Android wrapper using the following commands:
|
|
|
|
`./gradlew buildNative`
|
|
|
|
`./gradlew lint assembleDebug`
|
|
|
|
You can also use Android Studio to build the apk after you manually ran the `./gradlew buildNative` command in the repository root.
|
|
|
|
To clean up all files generated during build, use the following commands:
|
|
|
|
`./gradlew cleanNative`
|
|
|
|
`./gradlew clean`
|
|
|
|
# License
|
|
|
|
The project is licensed under the [MPLv2](LICENSE).
|