mirror of
https://github.com/syncthing/syncthing-android.git
synced 2024-12-23 19:31:30 +00:00
51 lines
3 KiB
Markdown
51 lines
3 KiB
Markdown
# syncthing-android
|
|
|
|
[](http://android.syncthing.net/job/Syncthing-Android/)
|
|
[](https://tip4commit.com/github/syncthing/syncthing-android)
|
|
|
|
A wrapper of [Syncthing](https://github.com/syncthing/syncthing) for Android.
|
|
|
|
<img src="graphics/screenshot_phone_1.png" alt="screenshot 1" width="200" />
|
|
<img src="graphics/screenshot_phone_2.png" alt="screenshot 2" width="200" />
|
|
<img src="graphics/screenshot_phone_3.png" alt="screenshot 3" width="200" />
|
|
|
|
[](https://play.google.com/store/apps/details?id=com.nutomic.syncthingandroid) [](https://f-droid.org/repository/browse/?fdid=com.nutomic.syncthingandroid)
|
|
|
|
# Translations
|
|
|
|
The project is translated on [Transifex](https://www.transifex.com/projects/p/syncthing-android/).
|
|
|
|
Translations can be updated using the [Transifex client](http://docs.transifex.com/developer/client/), using commands `tx push -s` and `tx pull -a`.
|
|
|
|
# Building
|
|
|
|
### Requirements
|
|
- Android SDK Platform (for the `compileSdkVersion` specified in [build.gradle](build.gradle))
|
|
- Android Support Repository
|
|
|
|
### Build instructions
|
|
|
|
Use `./gradlew assembleDebug` in the project directory to compile the APK.
|
|
|
|
To check for updated gradle dependencies, run `gradle dependencyUpdates`. Additionally, the git submodule in `ext/syncthing/src/github.com/syncthing/syncthing` may need to be updated.
|
|
|
|
|
|
### Building on Windows
|
|
|
|
To build the Syncthing app on Windows we need to include the native Syncthing binaries:
|
|
- Download the `syncthing-linux-386` and `syncthing-linux-arm` archives from [Syncthing releases](https://github.com/syncthing/syncthing/releases) and extract them. In each there is a `syncthing` executable. Rename and place both of these to `libs/x86/libsyncthing.so` and `libs/armeabi/libsyncthing.so` respectively.
|
|
You will also need to replace the standard `build.gradle` file with [this one](https://gist.github.com/Moter8/9cfc191434d1989d86be).
|
|
|
|
|
|
### Development Notes
|
|
|
|
It is recommended to change the GUI and Listen Address ports for the debug app, eg to 8385 and 22001 respectively.
|
|
|
|
The Syncthing backend used for this android application provides a web interface by default. It can be accessed via the Settings menu -> 'Web GUI'. It is quite helpful to access this web interface from your development machine. Read [android documentation](http://developer.android.com/tools/devices/emulator.html#redirection) on how to access the network of your emulator. Or use the following steps to connect to the single currently running emulator/AVD.
|
|
- `telnet localhost 5554`
|
|
- `redir add tcp:18384:8384`
|
|
- Start Syncthing app on your emulator and access the web interface from you favorite browser of your development machine via [http://127.0.0.1:18384](http://127.0.0.1:18384)
|
|
|
|
# License
|
|
|
|
The project is licensed under the [MPLv2](LICENSE).
|