android-app-with-storage/README.md

49 lines
1.4 KiB
Markdown

# 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")