Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/infomaniak/android-kdrive
https://github.com/infomaniak/android-kdrive
Last synced: 5 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/infomaniak/android-kdrive
- Owner: Infomaniak
- License: gpl-3.0
- Created: 2021-04-19T10:15:37.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2024-11-07T06:06:02.000Z (2 months ago)
- Last Synced: 2024-11-07T09:51:58.841Z (2 months ago)
- Language: Kotlin
- Homepage: https://play.google.com/store/apps/details?id=com.infomaniak.drive
- Size: 40.5 MB
- Stars: 109
- Watchers: 8
- Forks: 11
- Open Issues: 91
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Infomaniak kDrive app
## A modern Android application for [kDrive by Infomaniak](https://www.infomaniak.com/kdrive).
### Synchronise, share, collaborate. The Swiss cloud that’s 100% secure.
#### :cloud: All the space you need
Always have access to all your photos, videos and documents. kDrive can store up to 106 TB of data.
#### :globe_with_meridians: A collaborative ecosystem. Everything included.
Collaborate online on Office documents, organise meetings, share your work. Anything is possible!
#### :lock: kDrive respects your privacy
Protect your data in a sovereign cloud exclusively developed and hosted in Switzerland. Infomaniak doesn’t analyze or resell your data.
[
](https://play.google.com/store/apps/details?id=com.infomaniak.drive)
[
](https://f-droid.org/packages/com.infomaniak.drive/)
## License & Contributions
This project is under GPLv3 license.
If you see a bug or an enhanceable point, feel free to create an issue, so that we can discuss about it, and once approved, we or you (depending on the priority of the bug/improvement) will take care of the issue and apply a merge request.
Please, don't do a merge request before creating an issue.
## Tech things
### Languages
Layouts were made in **XML** with Android "Layout" components, the whole project is developed in **Kotlin**.
### Compatibility
The minimum needed version to execute the app is Android Lollipop 5.1 (API 22), anyway, we recommend to use the most recent version of Android, the majority of our tests having been carried out on Android 10 & 11 (API 29 & 30).
### Cache
We use [Realm.io](https://realm.io/) on both platforms (iOS and Android) to store the offline data of files, shares, app and user preferences (in different databases instances). [Android Room](https://developer.android.com/training/data-storage/room) is used to store API access token and basic user data.
### Structure
The structure of the app, its algorithms and the general functioning are common with the iOS app.
### Permissions
| Permission key | Usage
|---|---
| `GET_ACCOUNTS`, `AUTHENTICATE_ACCOUNTS`, `MANAGE_ACCOUNTS`, `USE_CREDENTIALS` | Used to access and manage AccountManager.
| `com.infomaniak.permission.ASK_CREDENTIAL`, `com.infomaniak.permission.RECEIVE_CREDENTIAL` | (*Unused for the moment*) Allow kDrive to communicate (get and give) credentials to other Infomaniak apps (in order to authenticate user without asking them to login).
| `INTERNET`, `ACCESS_NETWORK_STATE` | Used to determine if device has access to Internet in order to update UI and to restrict some features when offline.
| `READ_EXTERNAL_STORAGE`, `WRITE_EXTERNAL_STORAGE` | **READ** is used to access files on device to upload them on kDrive. **WRITE** is used to download files from kDrive on device and to use MediaStore.
| `READ_SYNC_SETTINGS`, `WRITE_SYNC_SETTINGS`, `READ_SYNC_STATS` | Used to manage automatic synchronization (e.g. determine if sync is enabled, enable it, etc.)
| `RECEIVE_BOOT_COMPLETED` | Determine when device is booted to restart sync service if needed.
| `FOREGROUND_SERVICE` | Used by Download Worker (for offline files) and Sync Service.
| `REQUEST_IGNORE_BATTERY_OPTIMIZATIONS` | Allow to download files in background.
| `USE_BIOMETRIC` | Used to (un)lock the app.
| `REQUEST_INSTALL_PACKAGES` | Allow users to execute an APK from kDrive app.
## Tests
In order to test the app with Unit and UI tests, you have to copy `Env-Example` class in AndroidTest package and name it `Env`.\
⚠️ Don't forget to disable 2FA on your Infomaniak account if you want to execute tests, this feature is not supported for AddUser test.\
Replace values contained in file by yours and launch the tests 👍