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.
