# Android App with "Storage Access" (build via docker/podman)

Simple Android App which is granted access to files on the "external storage"
Implementation for the frontend is to use a Webview, and have the javascript communicate
with the JAVA backend.

## build

0. clone this repo
1. run 

```
./build-android-app.sh
```

2. follow the configuration 
3. upon success the apk file created is in app/result/app.apk and can be installed via `adb`
```
adb install -r app/result/app.apk 
```

## the permissions include among others

```
android.permission.MANAGE_EXTERNAL_STORAGE
android.permission.MANAGE_DOCUMENTS
android.permission.MANAGE_MEDIA
android.permission.READ_MEDIA_AUDIO
android.permission.READ_MEDIA_IMAGES
android.permission.READ_MEDIA_VIDEO
android.permission.READ_MEDIA_VISUAL_USER_SELECTED
android.permission.READ_EXTERNAL_STORAGE (via android:maxSdkVersion="32")
android.permission.READ_SYNC_SETTINGS
android.permission.WRITE_EXTERNAL_STORAGE
android.permission.WRITE_MEDIA_STORAGE
android.permission.WRITE_SETTINGS
android.permission.WRITE_SYNC_SETTINGS"
```

which grant access to reading most files on the system's `/sdcard` filesystem
see [app/AndroidManifest.xml](app/AndroidManifest.xml) for details about the permissions


![Dialog to grant permission (shown once)](screenshots/allow-permission-dialog.avif "Dialog to grant permission (shown once)")
![Example output of files read](screenshots/example-read-sdcard.avif "Example output of files read")