Skip to content
CAI
Software that uses CAICheck a score

Lyokone/flutterlocation

62.6

Adequate · 17 November 2026

4k

lines of production code

Dart

with Kotlin, C++, Swift

5

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

Features

Add Windows location plugin implementation

This change introduces the Windows implementation for the location plugin, enabling location access on Windows desktop applications. It includes the C++ source code using WinRT APIs to retrieve and stream location data, the CMake build configuration requiring C++20 for coroutines, and the necessary header files for plugin registration.

packages/location/windows · high confidence

Added macOS example app support

The location example now includes a native macOS application, allowing developers to run and test the plugin on macOS. This addition provides the complete Xcode project structure, including the Runner target, Swift application entry points (AppDelegate and MainFlutterWindow), and necessary configuration files (Info.plist, entitlements, and xcconfigs). It also sets up CocoaPods integration for macOS dependencies and configures the required location usage descriptions in the app manifest.

packages/location/example/macos · high confidence

Android implementation migrated to Kotlin with enhanced location reliability

The Android plugin code has been rewritten from Java to Kotlin, introducing several reliability improvements for users. Concurrent location requests are now handled correctly, ensuring all pending calls resolve rather than only the last one. The plugin now gracefully falls back to the Android framework LocationManager on devices lacking Google Play Services, preventing crashes on certain ROMs. Satellite counts are accurately reported by parsing NMEA data instead of relying on a deprecated extras key. Additionally, the plugin now supports approximate location reporting on Android 31+, exposes whether background (Always) permission is granted, and allows configuring a specific update interval for background mode.

packages/location/android/src/main/kotlin · high confidence

Enhanced background location control and notification customization on Android

The location plugin now offers finer control over background location services and Android notifications. Users can customize the sticky background notification's title, subtitle, description, color, and icon (via resource name or raw bytes), and choose whether tapping the notification brings the app to the foreground. Background mode initialization now includes an optional \requireBackgroundPermission\ flag to start a foreground service without requesting the 'Allow all the time' permission. Additionally, \changeSettings\ supports a separate \backgroundInterval\ for Android, and a new \getLastKnownLocation\ method provides immediate access to cached location data.

packages/location/lib · high confidence

Introduces Swift Package Manager support for iOS and macOS

The location plugin now supports installation via Swift Package Manager on iOS and macOS. This change adds the necessary Swift source files (LocationPlugin.swift) and a privacy manifest (PrivacyInfo.xcprivacy) to the darwin package, along with a .gitignore to exclude SPM build artifacts. This allows developers to integrate the plugin using SPM in addition to existing CocoaPods or manual integration methods.

packages/location/darwin · high confidence

Native desktop runners added for Linux and Windows

The location example app now includes native build configurations for Linux (GTK) and Windows (Win32), enabling it to be built and run as a desktop application on these platforms. This adds the necessary CMake build files, platform-specific entry points, and window management code to support desktop deployment alongside existing mobile targets.

packages/location/example/linux, packages/location/example/windows · high confidence

Web demo now supports Progressive Web App (PWA) features

The web demo application now includes the necessary configuration files to function as a Progressive Web App. An index.html entry point has been added to register a service worker, enabling offline capabilities and background synchronization, while a manifest.json file defines the app's metadata, icons, and display preferences for installation on mobile and desktop browsers.

packages/location/example/web · high confidence

Removals

Removal of legacy Flutter example project files

The example directory has been cleaned up by deleting obsolete IDE and build artifacts, specifically the \.gitignore\, \README.md\, and several \.iml\ module files (\android.iml\, \location\_example.iml\, \location\_example\_android.iml\). This change removes legacy configuration files that are no longer required for the Flutter example project.

example · high confidence

Removal of legacy Location class implementation

The legacy \Location\ class, which previously exposed \getLocation\ and \onLocationChanged\ via the \lyokone/location\ MethodChannel, has been removed from the library. This deletion marks the end of support for the original API surface, requiring users to migrate to the updated service management and settings-based approach introduced in the same change set.

lib · high confidence

Removal of legacy example application

The previous example application located in example/lib/main.dart has been removed. This file contained the original Flutter demo code for the location plugin, including the main app entry point, state management for location updates, and basic UI scaffolding. Its deletion indicates that the example app structure has been reorganized or replaced by a different implementation in other parts of the repository.

example/lib · high confidence

iOS location plugin implementation removed

The iOS-specific implementation files for the location plugin (including the Objective-C header, Objective-C implementation, and the Swift plugin class) have been deleted from the repository. This change removes the native iOS code that previously handled location services, permission requests, and event streaming via the Flutter plugin registrar.

ios · high confidence

Architecture

Repository restructured into a multi-package monorepo with Melos and new documentation site

The project has been reorganized into a monorepo managed by Melos, introducing separate packages for the core plugin, platform interface, and web implementation. This structural change is accompanied by the addition of a new documentation site configuration (docs.json) and a comprehensive landing-page README that highlights support for Android, iOS, macOS, Web, Windows, and Linux, along with features like background tracking and real-time streams. Legacy IDE module files (.iml) and the old changelog have been removed, and the license has been standardized to MIT.

(repo-wide) · high confidence

Behavioural changes

2 commits (1 fix) modifying packages/location, packages/location\_platform\_interface, packages/location\_web

A change to existing behaviour in packages/location, packages/location\_platform\_interface, packages/location\_web — 2 commits (1 fix), 10 files: “docs: tighten changelog entries”; “fix: report null instead of fabricated zeros for unavailable fields”. Also in this area: Add Linux location support via GeoClue2.

packages/location/linux · medium confidence · unverified

37 commits (13 fixes) modifying android

A change to existing behaviour in android — 37 commits (13 fixs), 3 files: “Add request permissions result listener to registrar”; “style() remove log and update comment”; “add settings to request”; and 34 more (refs \#50, \#148, \#156, \#89, \#149, …).

android · medium confidence · unverified

7 commits (2 fixes) modifying packages/location/android

A change to existing behaviour in packages/location/android — 7 commits (2 fixs), 1 file: “feat(android): support a large icon image on the background notification”; “refactor(android): migrate plugin plumbing from Java to Kotlin”; “refactor(android): migrate FlutterLocation to Kotlin, modernize location APIs”; and 4 more.

packages/location/android · medium confidence · unverified

Android example app updated to Flutter v2 embedding and Android 12 compatibility

The Android example app has been updated to use the Flutter v2 embedding (FlutterActivity) and includes the necessary AndroidManifest permissions (INTERNET, FOREGROUND\_SERVICE, ACCESS\_BACKGROUND\_LOCATION) and resource files to support modern Android development practices, including Android 12 compatibility and null safety.

packages/location/example/android/app · high confidence

Example app configuration and scaffolding updates

The example application has been updated with new configuration files to support modern development workflows. A .gitignore file has been added to exclude standard Flutter build artifacts and IDE-specific files, while a .metadata file tracks the Flutter stable channel revision for migration purposes. The README has been refreshed with standard Flutter getting-started resources, and the analysis options now include the leancode\_lint package to enforce consistent code style.

packages/location/example · high confidence

Expanded LocationData model and new location management methods

The platform interface now exposes richer location metadata, including \isMock\ (to detect simulated locations) and \isProducedByAccessory\ (to identify external GPS hardware), along with Android-specific details like \headingAccuracy\, \elapsedRealtimeNanos\, \satelliteNumber\, and \provider\. The \LocationData\ class also adds \toJson\, \fromJson\, and \copyWith\ methods for easier serialization and manipulation. Additionally, the interface introduces \getLastKnownLocation\ to retrieve cached fixes and \isBackgroundPermissionGranted\ to check if background location access is explicitly allowed, while \changeSettings\ now supports a \backgroundInterval\ parameter for Android.

_packages/location\_platform\interface/lib/src · high confidence

Expanded location platform interface with background and notification controls

The location platform interface has been updated to expose new capabilities for managing background location and Android notification appearance. Users can now configure whether background location updates pause automatically and set a distinct update interval for background mode via \changeSettings\. The \enableBackgroundMode\ method now accepts a \requireBackgroundPermission\ flag to control whether the system's 'Allow all the time' permission is requested. Additionally, the interface introduces \getLastKnownLocation\ for immediate access to cached positions, \isBackgroundPermissionGranted\ to check specific background access status, and \changeNotificationOptions\ to customize the Android background notification's text, icon, color, and behavior.

_packages/location\_platform\interface/lib · high confidence

Removal of Android V1 embedding files

The Android example app has removed the legacy V1 embedding configuration, specifically deleting the AndroidManifest.xml, MainActivity.java, and .gitignore files that previously handled the old Flutter activity lifecycle and plugin registration. This change eliminates the manual setup required for the older embedding version, aligning the example with the newer Android embedding standards.

example/android · high confidence

Rewritten location example app with new background and notification controls

The example application in packages/location/example/lib has been completely rewritten to demonstrate the latest API capabilities. It now includes dedicated widgets for checking and requesting permissions and service status, retrieving both current and last known locations, and listening to location streams. New features allow users to toggle background mode, configure change settings (including accuracy, intervals, and the iOS pausesLocationUpdatesAutomatically flag), and customize Android notification options such as channel name, title, and icon. The app also fixes a deprecated DropdownButtonFormField usage by switching to initialValue.

packages/location/example/lib · high confidence

Web geolocation errors now map to PlatformException and permission checks are corrected

The web plugin implementation now converts browser Geolocation API errors into standard PlatformExceptions, ensuring that web-based location errors are catchable in the same way as Android and iOS errors. Additionally, permission status queries now use a proper PermissionDescriptor object to avoid browser rejections, and the permission request flow has been adjusted to prevent misreporting unrelated location failures as permission denials.

_packages/location\web/lib · high confidence

Web location API fixes and null-safety alignment

The web implementation now correctly handles permission checks by passing a proper JavaScript object literal to the Permissions API, preventing crashes when \hasPermission()\ is called. Browser geolocation errors are now mapped to standard \PlatformException\ codes (such as \PERMISSION\_DENIED\ or \TIMEOUT\), making error handling consistent with Android and iOS. Additionally, \hasPermission()\ no longer crashes in environments where the Permissions API is unavailable, and \requestPermission()\ no longer incorrectly reports \deniedForever\ for non-permission failures like GPS timeouts. The package also aligns with the platform interface's null-safety updates, ensuring latitude and longitude are treated as non-nullable.

_packages/location\web · high confidence

iOS example app migrated to modern Xcode and Flutter tooling standards

The iOS example app has been updated to build with modern Xcode and Flutter configurations. This includes migrating the project to Xcode 15 (objectVersion 54), adopting the UIScene lifecycle via new Info.plist entries, and updating the AppDelegate to use the implicit engine delegate pattern. The build system now relies on CocoaPods for dependency management, and the app bundle now correctly references Flutter build variables for versioning.

packages/location/example/ios · high confidence

location\_platform\_interface 7.0.0 introduces breaking nullability changes and new platform capabilities

The platform interface has been updated to version 7.0.0, introducing a breaking change where \LocationData.latitude\ and \LocationData.longitude\ are now non-nullable \double\ values; if underlying data omits these coordinates, \fromMap\/\fromJson\ will now throw an error instead of silently producing null values. This release also adds several new capabilities: \LocationData\ now includes serialization methods (\toJson\, \fromJson\, \copyWith\) and boolean flags \isMock\ and \isProducedByAccessory\ to indicate simulated or accessory-generated location data on Apple platforms. The \LocationPlatform\ interface expands with \isBackgroundPermissionGranted()\ to check for 'Always' access, \getLastKnownLocation()\ to retrieve cached coordinates immediately, and new parameters for background mode (\backgroundInterval\, \requireBackgroundPermission\) and notification customization (\imageName\, \iconBytes\, \imageBytes\).

_packages/location\_platform\interface · high confidence

Test coverage

Added unit tests for the location package; Added unit tests for the location platform interface.

Dependencies

Migrate to monorepo structure with Melos and update build toolchains

The project has been restructured into a monorepo managed by Melos, splitting the code into \location\, \location\_platform\_interface\, and \location\_web\ packages. This update upgrades the Android build environment to Gradle 8.11.1, Kotlin 2.2.20, and targets Android SDK 36, while also adding Swift Package Manager support for iOS and macOS. The example app has been modernized to require Flutter 3.27.0 and Dart 3.6.0, and the root workspace now uses \leancode\_lint\ for consistent code quality across all packages.

(dependencies) · high confidence

Update Gradle wrapper to version 8.14.3

The Android example app's build environment has been updated to use Gradle 8.14.3, ensuring compatibility with modern Android build tools and improving build performance and stability for developers running the example application.

packages/location/example/android/gradle · 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 59.8 → 62.6 (+2.8)
  • Rubric changed (rubric-2026.11.2 → rubric-2026.11.4) — scores are not directly comparable.

Lenses

  • Code Health 97.4 → 94.8 (-2.6)
  • Architecture 97.6 → 97.6 (0.0)
  • Maturity 53.5 → 56.5 (+3.0)
  • Readiness 46.9 → 51.8 (+4.9)
  • Security 75.0 → 75.0 (0.0)
  • Performance 100.0 → 100.0 (0.0)

Resolved (6)

  • Dependency hygiene PARTLY measured — Maven/Gradle declarations read, no dependency graph resolved
  • High: security finding (details withheld)
  • Hotspot: packages/location_platform_interface/lib/src/types.dart (packages/location_platform_interface/lib/src/types.dart)
  • Off-boarding risk: anonymized user #1
  • Repeated repair: packages/location/android/src/main/kotlin/com/lyokone/location/FlutterLocation.kt (packages/location/android/src/main/kotlin/com/lyokone/location/FlutterLocation.kt)
  • Repeated repair: packages/location/darwin/location/Sources/location/LocationPlugin.swift (packages/location/darwin/location/Sources/location/LocationPlugin.swift)

New (127)

  • Dependency hygiene PARTLY measured — Gradle build resolved part of the dependency graph, currency reported but not scored
  • Documentation: no build, run or usage example (packages/location_platform_interface/README.md)
  • Duplicated block (11 lines × 2) (packages/location/android/src/main/kotlin/com/lyokone/location/MethodCallHandlerImpl.kt)
  • Edited copies of one member (3 members, 16+ corresponding lines) (packages/location/example/lib/enable_in_background.dart)
  • Edited copies of one member (5 members, 30+ corresponding lines) (packages/location/example/lib/enable_in_background.dart)
  • Edited copy of a member (10 corresponding lines) (packages/location/android/src/main/kotlin/com/lyokone/location/MethodCallHandlerImpl.kt)
  • Edited copy of a member (16 corresponding lines) (packages/location_web/lib/location_web.dart)
  • FlutterLocation.locationToMap (cognitive 19) (packages/location/android/src/main/kotlin/com/lyokone/location/FlutterLocation.kt)
  • 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)
  • Off-boarding risk: anonymized user #1
  • Outdated (compile): ch.qos.logback:logback-classic
  • Outdated (compile): ch.qos.logback:logback-core
  • Outdated (compile): com.google.api.grpc:proto-google-common-protos
  • Outdated (compile): com.google.auto:auto-common
  • Outdated (compile): com.google.code.gson:gson
  • …and 107 more

Changes since last survey

  • 23 commits — 13 feature/other, 10 fixes

By area

  • packages/location — 10 commits
  • (repo) — 8 commits
  • docs/installation — 3 commits
  • .github/workflows — 2 commits

Notable commits

  • fix: Merge pull request #1104 from Lyokone/fix/null-instead-of-fabricated-zeros
  • fix: Merge pull request #1110 from Lyokone/fix/ios-no-always-authorization-selector
  • fix: Merge pull request #1112 from Lyokone/fix/android-builtin-kotlin-migration
  • fix: Merge pull request #1113 from Lyokone/fix/spm-flutterframework-dependency
  • fix: Merge remote-tracking branch 'origin/master' into fix/android-builtin-kotlin-migration
  • fix: Merge remote-tracking branch 'origin/master' into fix/null-instead-of-fabricated-zeros
  • fix: fix(android): stop applying the Kotlin Gradle plugin (Built-in Kotlin)
  • fix: fix(android): update plugin build tooling for Gradle 9
  • fix: fix(darwin): depend on FlutterFramework in Package.swift
  • fix: fix(ios): never reference requestAlwaysAuthorization on iOS
  • change: Merge pull request #1111 from Lyokone/docs/android-foreground-service-permissions
  • change: Merge pull request #1115 from Lyokone/chore/flutter-3.50
  • change: chore(example): build Android with AGP 9 and Built-in Kotlin
  • change: chore(example): migrate to package:material_ui
  • change: chore(example): use Swift Package Manager only and apply 3.50 migrations
  • change: ci: build fresh apps for the CocoaPods and minimum-Flutter jobs
  • change: ci: cover CocoaPods, web interop and the minimum Flutter version
  • change: docs(android): document bundled foreground service permissions
  • change: docs(changelog): note the Gradle 9 build tooling update
  • change: docs: changelog for #1105, #1106 and #1109
  • …and 3 more

Architecture

  • Containers 0 added · 0 removed · contexts 1 added · 1 removed · edges 0 added · 0 removed

Added bounded contexts (1)

  • packages/location/android

Removed bounded contexts (1)

  • packages/location/android

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

Survey your own repository

Lyokone/flutterlocation 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 17 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 178541f5875133afa1c5a794d3b74e49709d1305 — the exact code this score is about.
  • Scored under rubric-2026.11.4 — 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.85+preprod-eba6548ac50f.