yanzhenjie/AndPermission
AndPermission
AndPermission is a unified API manager for coordinating runtime permissions, secure file sharing, and high-privilege system access on Android. It provides a lifecycle-aware wrapper for handling dangerous permissions and user consent callbacks through a centralized permissions manager.
The project distinguishes itself by managing special permissions that require high-privilege access, such as notification monitoring, screen overlays, and the ability to install applications from unknown sources. It also includes a dedicated tool for secure file sharing that generates temporary read and write access tokens via content URIs to share private files with external applications.
The framework covers a broad range of system-level capabilities, including requesting access to modify device settings and managing runtime permission requests. These operations are supported by infrastructure for asynchronous callback flows, fragment-aware dispatching, and state caching to prevent redundant system queries.
Features
- Android Permission Management - Provides a unified API for requesting and managing dangerous Android runtime permissions with lifecycle-aware callbacks.
- Runtime Permission Management - Provides a lifecycle-aware manager for requesting and validating dangerous runtime permissions on Android.
- Activity Result Management - Integrates with the AndroidX Activity Result API to link permission responses to the activity or fragment lifecycle.
- Activity Result Managers - Manages permission responses using the AndroidX Activity Result API for lifecycle-aware handling.
- Android Intent Integrations - Launches Android intents to request system-level permissions and monitors the resulting codes in the calling activity.
- Permission Response Handlers - Provides a lifecycle-aware wrapper to execute application workflows based on user responses to permission requests.
- System Intent Handlers - Utilizes Android system intents to trigger high-privilege permission requests, such as opening system settings.
- System Overlay Permissions - Requests system-level permissions required to draw visual layers and render UI content on top of other applications.
- Special System Permission Handling - Manages high-privilege special permissions such as overlay drawing, notification access, and unknown app installation.
- Mobile Notification Permissions - Handles requests for high-level permissions to monitor notification events and display alerts on mobile devices.
- Unknown App Installation Requests - Provides a unified API to request user permission for installing application packages from unknown sources.
- Content URI Temporary Permissions - Generates content URIs with temporary read/write permissions to share internal files securely with external applications.
- System Settings Navigators - Provides tools to guide users to Android system settings to grant permissions for modifying device settings.
- Android Secure File Sharing - Grants temporary read and write access to internal files using content URIs for secure sharing with other applications.
- Android Secure File Sharing Tools - Ships a utility for sharing private files by generating temporary content URIs with read and write permissions.
- Content URI Access Control - Provides secure file sharing by generating temporary read and write access tokens via content URIs.
- Permission Request Grouping - Groups related runtime permissions into a single request to minimize user interaction and streamline the grant flow.
Star history
How this analysis was created: This summary and feature list are AI-generated from collected project material and can contain mistakes. Stars, license and language are imported from GitHub. Inclusion does not mean that we have tested or audited this project. Check the source documentation for any feature you depend on. Learn more on our About page.
