https://github.com/elastos/elastos.dittobox.android
https://github.com/elastos/elastos.dittobox.android
Last synced: 4 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/elastos/elastos.dittobox.android
- Owner: elastos
- License: gpl-2.0
- Created: 2018-03-16T04:14:20.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2019-04-23T03:35:51.000Z (about 7 years ago)
- Last Synced: 2025-04-03T10:51:23.397Z (over 1 year ago)
- Language: Java
- Size: 7.04 MB
- Stars: 3
- Watchers: 26
- Forks: 4
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.txt
Awesome Lists containing this project
README
DittoBox for Android
==================================
## Introduction
DittoBox is a demo application integrating ownCloud over elastos carrier network, and through which we can access or save personal files to ownCloud server that could be deployed **at home behind the router**.
## Highlights
This app demonstrates that all traditional http(/https)-based application can be refactored to elastos carrier apps running over carrier network. Being elastos carrier web app, the app server can be deployed without requirement of direct network accessibility.
For example, through elastos carrier network, you can deploy ownCloud server at local network at your home, and access ownCloud service at anywhere.
## Build from source
Run following commands to get full source code:
```shell
$ git clone --recurse-submodules git@github.com:elastos/Elastos.DittoBox.Android.git
```
or
```shell
$ git clone git@github.com:elastos/Elastos.DittoBox.Android.git
$ git submodule update --init --recursive
```
Then open this project with Android Studio to build distribution.
## Dependencies
### 1. ownCloud
See details for ownCloud in **README.ownCloud.md**.
### 2. Elastos Carrier
See details for elastos carrier in **https://github.com/elastos/Elastos.NET.Carrier.Android.SDK**, and build **org.elastos.carrier-debug(or release).aar** with instructions.
## Deployment
Before to run DittBox on Android, you need to have DittBox service to connect with. About how to build and install ownCloud server and DittBox agent, please refer to instructions in following repository:
```
https://github.com/elastos/Elastos.DittoBox.Server
```
## Run
After build and installation of DittoBox on Android, you need to scan QRcode of DittoBox agent address to pair at first. When pairing server succeeded, then you can use ownCloud to access and save files as origin ownCloud does.
Beaware, due to carrier is decentralized network, there would be a moment about 5~30s for DittoBox app to get completely connected to carrier network, as well as get friends connected(or online).
## Thanks
All works base on ownCloud and elastos carrier Android SDK. Thanks to ownCloud team (especially) and carrier team.
## License
GPLv2