51242be72b
Android will ignore permission request and will not show the request dialog if the user's action implies "don't ask again." This leaves the app in a crippled state and the user confused. Google says "don't try to convince the user", so it returns false for `shouldShowRequestPermissionRationale`. To help the user proceed, we show the `Request permission` button only if `shouldShowRequestPermissionRationale == true` because there's a good chance the premission request dialog will not be ignored. If `shouldShowRequestPermissionRationale == false` we instead show the "rationale" message and a button to open the app info dialog where the user can explicitly grand the permission.
47 lines
1.7 KiB
Markdown
47 lines
1.7 KiB
Markdown
# Android
|
|
|
|
Notes and resources for MPD android maintainers.
|
|
|
|
## Android studio
|
|
|
|
### Version control
|
|
|
|
|
|
git ignoring .idea directory completely until a good reason emerges not to
|
|
|
|
* [How to manage projects under Version Control Systems (jetbrains.com)](https://intellij-support.jetbrains.com/hc/en-us/articles/206544839-How-to-manage-projects-under-Version-Control-Systems)
|
|
|
|
* [gradle.xml should work like workspace.xml? (jetbrains.com)](https://youtrack.jetbrains.com/issue/IDEA-55923)
|
|
|
|
### Native libraries
|
|
|
|
* [Include prebuilt native libraries (developer.android.com)](https://developer.android.com/studio/projects/gradle-external-native-builds#jniLibs)
|
|
|
|
|
|
### Permissions
|
|
|
|
#### Files access
|
|
|
|
The required permission depends on android SDK version:
|
|
|
|
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU)
|
|
Manifest.permission.READ_MEDIA_AUDIO
|
|
else
|
|
Manifest.permission.READ_EXTERNAL_STORAGE
|
|
|
|
#### Permission request
|
|
|
|
[Request runtime permissions](https://developer.android.com/training/permissions/requesting)
|
|
|
|
Since Android 6.0 (API level 23):
|
|
|
|
Android will ignore permission request and will not show the request dialog
|
|
if the user's action implies "don't ask again."
|
|
This leaves the app in a crippled state and the user confused.
|
|
Google says "don't try to convince the user", so it returns false for `shouldShowRequestPermissionRationale`.
|
|
|
|
To help the user proceed, we show the `Request permission` button only if `shouldShowRequestPermissionRationale == true`
|
|
because there's a good chance the permission request dialog will not be ignored.
|
|
|
|
If `shouldShowRequestPermissionRationale == false` we instead show the "rationale" message and a button to open
|
|
the app info dialog where the user can explicitly grand the permission. |