guolindev/permissionx

PermissionX is an Android library that simplifies the process of asking users to grant app permissions. On Android, apps must ask the user at runtime before accessing things like the camera, contacts, or phone calls. The built-in Android API for doing this is verbose and requires handling several edge cases yourself. PermissionX wraps all of that into a shorter, more readable chain of method calls. A basic request takes three steps: initialize the library with an activity or fragment, specify which permissions you want, and call request. The callback tells you whether all permissions were granted, which ones were granted, and which were denied. You can then write whatever logic your app needs based on that result. Beyond the basics, the library handles two common complications. The first is when a user has denied a permission and you want to explain why your app needs it before asking again. PermissionX provides a method you can chain in to show a dialog with a custom explanation message. If the user clicks the positive button, the library automatically re-requests the permission. The second complication is when a user has denied a permission and checked the option to never be asked again. At that point Android will never show the request dialog. PermissionX detects this situation and provides a method to show a dialog that directs the user to the app settings screen, where they can enable the permission manually. When the user returns to the app, PermissionX automatically retries the request. You can also configure the library to show the explanation dialog before making any request at all, for situations where it is good practice to tell users upfront what you need and why. The built-in dialogs support Android's dark theme automatically. Adding the library requires a single line in the app's build.gradle file. It is written in Kotlin and works with any Android project using AndroidX.