Skip to content
CAI
Software that uses CAICheck a score

Baseflow/flutter-permission-handler

58.5

Adequate · 13 November 2026

5.1k

lines of production code

Dart

with Java, Objective-C, C, C++, Swift

8

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

Features

Added Windows example application for the permission handler plugin

The example application in the \permission\_handler\_windows/example\ directory now includes full Windows support, allowing users to build and run the demo on Windows. This addition introduces the necessary CMake build configuration, a Win32 runner implementation (including window management, DPI awareness, and console attachment), and a Flutter \main.dart\ entry point that demonstrates requesting and checking permission statuses on the Windows platform.

_permission\_handler\windows/example · high confidence

Adds Windows example app support

The permission\_handler example application now includes a native Windows runner, enabling users to build, run, and test the plugin on Windows desktop. This addition includes the necessary CMake build configuration, a Win32 window host with high-DPI support, and the generated plugin registrant that registers the permission\_handler\_windows and url\_launcher\_windows plugins.

_permission\handler/example/windows · high confidence

Android example project scaffolded with comprehensive permission declarations

The Android example app for the permission handler plugin has been initialized with a complete set of Android manifest permissions, including granular media permissions (READ\_MEDIA\_IMAGES, VIDEO, AUDIO), NEARBY\_WIFI\_DEVICES, BODY\_SENSORS\_BACKGROUND, and POST\_NOTIFICATIONS, ensuring the example covers the full range of supported permissions. The project also includes standard Flutter Android configuration files (MainActivity, launch themes, gradle wrapper) to provide a functional, up-to-date template for developers testing the plugin.

_permission\_handler\android/example/android · high confidence

Initial Windows platform support for permission\_handler

This change introduces the first Windows implementation for the permission\_handler plugin. It adds the necessary C++ plugin code, CMake build configuration, and header files to enable the plugin on Windows. The implementation currently supports checking and requesting permissions for location and Bluetooth services, while other permissions are handled with a default 'granted' status to ensure compatibility.

_permission\_handler\windows/windows · high confidence

Introduce web platform implementation for permission\_handler

This change adds the \permission\_handler\_html\ package, providing the web-specific implementation for the permission handler plugin. It registers a \WebPermissionHandler\ that delegates permission requests and status checks to browser APIs (MediaDevices, Geolocation, Notifications, and Permissions API) via the new \package:web\ interop layer, ensuring compatibility with modern web standards and fixing previous crashes on Safari \<16 and with web 1.0.

_permission\_handler\html/lib · high confidence

New HTML example app for the permission handler plugin

An example Flutter application has been added to the \permission\_handler\_html\ package, providing a demo interface for testing permission requests on the web platform. The app lists available permissions, displays their current status (granted, denied, limited), and allows users to trigger permission requests and check service statuses directly from the UI.

_permission\_handler\html/example · high confidence

New callback-based permission request API and status shortcuts

The \permission\_handler\ library now exposes a fluent API for handling permission outcomes via new extension methods on the \Permission\ type. Users can attach specific callbacks for granted, denied, permanently denied, restricted, limited, and provisional states using methods like \onGrantedCallback\ and \onDeniedCallback\. When \request()\ is called, these callbacks are automatically invoked based on the result. Additionally, the library introduces \PermissionCheckShortcuts\ extension, providing convenient async getters (e.g., \isGranted\, \isDenied\, \isRestricted\, \isLimited\, \isProvisional\) to check permission status without explicitly calling \status\. The \ServicePermissionActions\ extension also remains available for checking associated service statuses.

_permission\handler/lib · high confidence

New iOS example app for permission handling

The iOS example application now includes a functional Flutter UI that demonstrates the permission handler plugin. Users can view the status of supported permissions, request them, and check service status for permissions that support it (indicated by an info icon). The app filters out permissions not relevant to iOS (such as Android-specific or media permissions) and visually indicates granted, denied, or limited statuses with color coding.

_permission\_handler\apple/example · high confidence

Swift Package Manager now supports per-flavor permission compilation

Developers using Swift Package Manager can now declare a \permission\_handler.yaml\ file to map specific iOS flavors to their respective \Info.plist\ files, ensuring that only the permissions required for the active flavor are compiled into the binary. This prevents permission declarations from one flavor (e.g., \dev\) from leaking into another (e.g., \prod\), which helps avoid App Store rejection for unused usage descriptions. The package also provides a \dart run permission\_handler\_apple:select \<flavor\>\ command to record the active flavor and clear build caches, along with a build phase script to fail the build if the selected flavor mismatches the build configuration.

_permission\_handler\apple · high confidence

Removals

Removal of legacy example application entry point

The main entry point for the example application (example/lib/main.dart) has been removed. This file previously contained a basic Flutter app demonstrating how to check calendar permission status via the platform channel. Its deletion indicates that the example app structure has been refactored or replaced, and users relying on this specific file for a starting point should look for the new example implementation.

example/lib · high confidence

Removed legacy permission enums and handler implementation

The \permission\_enums.dart\ and \permission\_handler.dart\ files have been deleted from the library. This removes the previous definitions for \PermissionStatus\ and \PermissionGroup\ enums, as well as the static \PermissionHandler\ class that previously exposed the \checkPermissionStatus\ method via a MethodChannel. Users relying on these specific classes and enums for permission checks will need to adopt the new API structure provided by the updated plugin implementation.

lib · high confidence

Removed obsolete Android example project scaffolding

The Android example project's legacy Eclipse/Buildship configuration files (.project, .settings) and the old AndroidManifest.xml have been removed, along with the Kotlin MainActivity and Gradle wrapper scripts. This cleanup eliminates outdated build tooling and manifest definitions that are no longer required for the current Flutter federated plugin structure.

example/android · high confidence

Removed permission status codec utility

The \lib/utils/codec.dart\ file has been removed, eliminating the \Codec\ class that previously handled encoding and decoding of permission statuses and groups using JSON serialization. This change removes the utility functions used to translate between \PermissionGroup\ enums and their string representations, likely as part of a broader migration or refactoring of how permissions are handled in the application.

lib/utils · high confidence

Behavioural changes

2 commits (0 fixes) modifying android/.settings

A change to existing behaviour in android/.settings — 2 commits, 1 file: “Update project settings”; “Implemented Android API to check permissions”.

android/.settings · medium confidence · unverified

3 commits (0 fixes) modifying example/android/.settings

A change to existing behaviour in example/android/.settings — 3 commits, 1 file: “migrate Swift and Kotlin to ObjC and Java”; “Implemented Android API to check permissions”.

example/android/.settings · medium confidence · unverified

Added iOS example workspace configuration

The iOS example project now includes a dedicated Xcode workspace (Runner.xcworkspace) that groups the main Runner project and the CocoaPods dependencies (Pods.xcodeproj). This setup ensures that build settings, such as disabling previews and suppressing 32-bit warnings, are applied consistently across the entire example project when opened in Xcode.

_permission\handler/example/ios/Runner.xcworkspace · high confidence

Android permission status reporting and federated plugin structure

The plugin now follows the federated plugin architecture, separating the app-facing package from platform implementations and the shared interface. On Android, the \permission\_handler\_android\ package (version 14.1.0) changes how \Permission.x.status\ reports denied permissions: it now returns \denied\ for all denied states (including those previously reported as \permanentlyDenied\), reserving \permanentlyDenied\ exclusively for the result of \Permission.x.request()\. This prevents apps from getting stuck in settings loops when users reset permissions to 'Ask every time'. Users must update their code to check \request()\ results for permanent denial rather than relying on \status\ checks, and ensure their Android \compileSdk\ is set to 37.

(repo-wide) · high confidence

Android plugin implementation migrated to Flutter v2 embedding

The Android source code has been completely rewritten to use the modern Flutter v2 embedding (FlutterPlugin and ActivityAware interfaces), replacing the legacy v1 embedding. This change includes a new plugin entry point (PermissionHandlerPlugin) that correctly manages lifecycle events, a refactored method channel handler (MethodCallHandlerImpl), and the addition of an AppSettingsManager to allow users to open the app's system settings screen directly. The implementation also updates the build environment to Java 11 and Gradle 9.1.0.

_permission\_handler\android/android · high confidence

Example app now excludes specific permissions from the main list

The permission handler example app has been updated to filter out several permissions from its main display list. Specifically, the app no longer shows entries for assistant, backgroundRefresh, mediaLibrary, photosAddOnly, reminders, bluetooth, appTrackingTransparency, criticalAlerts, and unknown permissions. This change means users testing the example app will see a simplified list of permissions, with these specific capabilities removed from the interactive demo.

_permission\_handler\android/example · high confidence

Example app updated for iOS 17+ and modern Flutter standards

The iOS example app has been updated to support iOS 17+ Calendar Access Levels and includes usage descriptions for Siri, App Tracking Transparency, and other permissions. The app now uses the modern @main entry point, adopts Flutter build variables for versioning, and enables new iOS 17 features like indirect input events and minimum frame duration disabling.

_permission\handler/example/ios/Runner · high confidence

Example app updated to support Android 13 permissions and Flutter v2 embedding

The permission\_handler example app's Android manifest and resources have been updated to declare granular media permissions (READ\_MEDIA\_IMAGES, VIDEO, AUDIO) required for Android 13, alongside other permissions such as BODY\_SENSORS\_BACKGROUND, NEARBY\_WIFI\_DEVICES, and POST\_NOTIFICATIONS. The example activity now uses the Flutter v2 embedding (FlutterActivity) with the corresponding meta-data and theme styles, ensuring the example app correctly demonstrates permission handling on modern Android versions.

_permission\handler/example/android/app/src/main · high confidence

Migrated example app to CocoaPods and updated Xcode project settings

The iOS example app project has been restructured to use CocoaPods for dependency management, replacing the previous embedded Flutter and App frameworks with a Pods framework and associated build phases. The Xcode project file version was upgraded to 54, and project attributes were updated to target Xcode 9.3 compatibility with Swift 11.0 migration, while also cleaning up obsolete build references and configuration files.

_permission\handler/example/ios/Runner.xcodeproj · high confidence

Migration of Android implementation from Kotlin to Java

The Android source files in the permission handler plugin have been migrated from Kotlin to Java. This change involves deleting the existing Kotlin implementation files (including the main plugin class, data models, and utility codecs) and replacing them with their Java equivalents, aligning with the project's decision to standardize on Java for the Android platform.

android/src · high confidence

Modernized web implementation with web: 1.0.0 and WASM support

The web implementation of the permission handler has been modernized to support the \web: ^1.0.0\ package and WebAssembly (WASM) compilation. This update fixes compatibility issues with Safari versions prior to 16, resolves crashes on non-HTTPS protocols, and corrects errors related to \PermissionDescriptor\ and null checks in web release builds. Users benefit from improved stability and broader browser support for camera, microphone, and notification permissions on the web platform.

_permission\_handler\html · high confidence

New example app demonstrating permission handling

The example application has been updated to use the new plugin API, providing a comprehensive UI that lists all available permissions and allows users to request them. It now supports querying service status for permissions that require specific hardware or system services (indicated by the \PermissionWithService\ type) and correctly filters out platform-incompatible permissions for both iOS and Android.

_permission\handler/example · high confidence

Platform interface introduces service status checks and granular permission statuses

The platform interface now supports checking the status of services associated with specific permissions (such as location and phone) via the new \checkServiceStatus\ method and \ServiceStatus\ enum, allowing apps to distinguish between disabled, enabled, and not-applicable states. Additionally, the \PermissionStatus\ enum has been expanded to include \limited\ (for partial access like iOS photo library picker) and \provisional\ (for iOS non-interruptive notifications), while the legacy \calendar\ permission is deprecated in favor of \calendarWriteOnly\ and \calendarFullAccess\ to better reflect platform-specific access levels.

_permission\_handler\_platform\interface/lib · high confidence

Removed legacy Flutter example project files

The example directory no longer includes the \.gitignore\, \README.md\, and IntelliJ IDEA module files (\.iml\). These deletions clean up the example project structure by removing legacy configuration and documentation files that are no longer part of the current setup.

example · high confidence

Updated iOS example app scheme for Xcode 15.1 and modernized build configuration

The iOS example app's Xcode scheme has been updated to target Xcode 15.1 (LastUpgradeVersion 1510), reflecting a migration from the previous version. This change includes enabling GPU validation mode for debugging, switching the profile build configuration from 'Release' to 'Profile', and cleaning up obsolete or empty elements like the language attribute and additional options. These adjustments ensure the example app builds and runs correctly with newer versions of Xcode and provides more accurate profiling data.

_permission\handler/example/ios/Runner.xcodeproj/xcshareddata · high confidence

Updated iOS example workspace configuration

The iOS example project's workspace settings have been updated to align with the Flutter federated plugin structure. This includes adding an IDE workspace check file to suppress the 32-bit warning, disabling previews in the workspace settings, and correcting the workspace file reference to point to the local project.

_permission\handler/example/ios/Runner.xcodeproj/project.xcworkspace · high confidence

Updated iOS minimum deployment target and CocoaPods include syntax in example app

The example app's iOS minimum deployment target has been raised from 8.0 to 12.0, and the CocoaPods configuration files (Debug.xcconfig and Release.xcconfig) now use the optional include syntax (\#include?) for the Pods support files to prevent build errors if the Pods directory is missing.

_permission\handler/example/ios/Flutter · high confidence

iOS plugin implementation migrated from Swift to Objective-C

The iOS implementation of the permission handler plugin has been migrated from Swift to Objective-C. The previous Swift-based plugin files (SwiftPermissionHandlerPlugin.swift and its Objective-C header wrapper) have been removed, indicating that the underlying logic for handling permission requests and checks on iOS is now provided by a different implementation, likely the newly added Objective-C or Java-based components mentioned in the commit history.

ios · medium confidence

Test coverage

1 commit adding/updating tests in permission\_handler\_android/android/jvm-tests; Added placeholder test for permission\_handler\_html; Added tests for MethodChannelPermissionHandler; Added unit tests for permission handler core APIs; Added unit tests for the permission handler platform interface; Removed example widget test.

Dependencies

Migrate to Flutter monorepo and modernize build infrastructure

The permission\_handler plugin has been restructured into a monorepo, separating platform-specific implementations into distinct packages (permission\_handler\_android, permission\_handler\_apple, permission\_handler\_html, permission\_handler\_windows) and introducing a shared platform interface. This update modernizes the build infrastructure by migrating Android projects to Kotlin DSL (Gradle 9.0.1, Kotlin 2.3.20, Java 17) and raising the iOS deployment target to 12.0. Dart dependencies have been updated to support SDK ^3.6.0 and Flutter \>=3.24.0, with the web package now depending on the \web\ package (\>=0.5.1 \<2.0.0).

(dependencies) · high confidence

Updated Gradle wrapper to version 9.1.0

The example Android project's Gradle wrapper has been updated to use Gradle 9.1.0. This ensures that the example app builds using the specified distribution, aligning the build environment with the latest wrapper configuration.

_permission\handler/example/android/gradle · high confidence

Housekeeping

Removed Eclipse IDE project metadata files

The Eclipse-specific project configuration files (.classpath and .project) have been removed from the Android module. This cleanup eliminates legacy IDE metadata, ensuring the project relies solely on its build system (Gradle) for configuration and no longer contains obsolete Eclipse build settings.

android · high confidence

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

How this codebase got here

This is the PUBLIC form of this artifact. Findings are listed in full, but the details of SECURITY findings — which rule fired, in which file, on which line, and how to fix it — are deliberately withheld, and any secret-scanner results are excluded entirely. Where detail is absent here it was REMOVED FOR PUBLICATION; it is not missing from the analysis. The complete artifact is available from the repository owner.

Score

  • CAI 56 → 59 (+2.9)
  • Rubric changed (rubric-2026.10.5 → rubric-2026.11.3) — scores are not directly comparable.

Lenses

  • Code Health 64 → 61 (-3.9)
  • Architecture 99 → 99 (+0.2)
  • Maturity 48 → 68 (+20.9)
  • Readiness 50 → 47 (-2.7)
  • Security 71 → 70 (-1.0)
  • Performance 100 → 100 (+0.0)

Resolved (22)

  • Documentation: no installation or build instructions (README.md)
  • High: security finding (details withheld)
  • High: security finding (details withheld)
  • High: security finding (details withheld)
  • High: security finding (details withheld)
  • High: security finding (details withheld)
  • High: security finding (details withheld)
  • High: security finding (details withheld)
  • High: security finding (details withheld)
  • High: security finding (details withheld)
  • High: security finding (details withheld)
  • High: security finding (details withheld)
  • High: security finding (details withheld)
  • High: security finding (details withheld)
  • High: security finding (details withheld)
  • Medium: security finding (details withheld)
  • Medium: security finding (details withheld)
  • No ADRs found
  • PR-triggered workflow without a permissions block (.github/workflows/permission_handler_android.yaml)
  • PR-triggered workflow without a permissions block (.github/workflows/permission_handler_apple.yaml)
  • …and 2 more

New (14)

  • Edited copy of a member (31 corresponding lines) (permission_handler/example/lib/main.dart)
  • Edited copy of a member (31 corresponding lines) (permission_handler_html/lib/web_delegate.dart)
  • Edited copy of a member (6 corresponding lines) (permission_handler/example/ios/Runner/AppDelegate.swift)
  • High: security finding (details withheld)
  • High: security finding (details withheld)
  • High: security finding (details withheld)
  • High: security finding (details withheld)
  • High: security finding (details withheld)
  • High: security finding (details withheld)
  • High: security finding (details withheld)
  • High: security finding (details withheld)
  • High: security finding (details withheld)
  • No ADRs found (permission_handler_apple/bin/select.dart)
  • Workflow holding a long-lived secret is unscoped (.github/workflows/permission_handler_package.yaml)

Changes since last survey

  • 7 commits — 4 feature/other, 3 fixes

By area

  • (root) — 2 commits
  • permission_handler_windows/CHANGELOG.md — 2 commits
  • .github/workflows — 1 commit
  • permission_handler_android/android — 1 commit
  • permission_handler_apple/CHANGELOG.md — 1 commit

Notable commits

  • fix: Point contributor docs at main and fix stale commands (#1579)
  • fix: fix(apple): prevent double completionHandler call in PhonePermissionStrategy (#1566)
  • fix: fix(windows): build with Visual Studio 2026 (#1569)
  • change: Add AGENTS.md and CLAUDE.md (#1580)
  • change: Lazily create Windows geolocator (#1546)
  • change: Merge commit from fork
  • change: Run CI through a single workflow with one required check (#1582)

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

Survey your own repository

Baseflow/flutter-permission-handler was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.

About this page

  • The score is its most recent published measurement, taken on 13 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
  • Measured at commit dd5055571a1f8cddcaae714e54d3f6c347e50ec5 — the exact code this score is about.
  • Scored under rubric-2026.11.3 — the same rubric and the same method as every other entry in this index.
  • Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.57+preprod-8ebfb01cf4c0.