[go: up one dir, main page]

Skip to content

Infomaniak/android-kDrive

Repository files navigation

Infomaniak kDrive app

A modern Android application for kDrive by Infomaniak.

Synchronise, share, collaborate. The Swiss cloud that’s 100% secure.

☁️ All the space you need

Always have access to all your photos, videos and documents. kDrive can store up to 106 TB of data.

🌐 A collaborative ecosystem. Everything included.

Collaborate online on Office documents, organise meetings, share your work. Anything is possible!

🔒 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.

Download from Google Play Get it on F-Droid

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 on both platforms (iOS and Android) to store the offline data of files, shares, app and user preferences (in different databases instances). Android 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 👍