Skip to content
CAI
Software that uses CAICheck a score

Baseflow/flutter-geolocator

71.4

Strong · 17 November 2026

7.2k

lines of production code

Dart

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

5

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

Features

Add Linux example application for geolocator

Introduces a complete Linux example application for the geolocator plugin, including the Flutter Dart code (main.dart) and the native Linux project files (CMakeLists.txt, main.cc, my\_application.cc). This allows users to run and test the geolocator plugin on Linux desktop environments.

_geolocator\linux/example · high confidence

Add Windows example app scaffolding with geolocator\_windows plugin

The Windows example application now includes the native C++ runner files and CMake build configuration required to run on Windows. The project is configured to register and use the geolocator\_windows plugin alongside url\_launcher\_windows, enabling users to test geolocation features on the Windows platform.

geolocator/example/windows · high confidence

Add macOS support to the geolocator example app

The example application now includes a complete macOS platform implementation, enabling users to build and run the geolocator demo on macOS. This change adds the necessary Xcode project structure, Swift application entry points (AppDelegate and MainFlutterWindow), and configuration files. It also configures the required location permissions in the Info.plist and entitlements, ensuring the example correctly requests and uses location services on the new platform.

geolocator/example/macos · high confidence

Android implementation federated with new platform-specific types and foreground service support

The Android location plugin is now a federated platform implementation that introduces Android-specific capabilities. Users can access detailed GNSS data, including satellite count and satellites used in the fix, via the new \AndroidPosition\ type. The plugin also supports foreground location services through \ForegroundNotificationConfig\, allowing apps to configure persistent notifications, custom icons, and lock settings to maintain location updates in the background. Additionally, users can force the use of the legacy \LocationManager\ via \AndroidSettings\ and opt into MSL altitude reporting from NMEA messages.

_geolocator\android · high confidence

Expanded Position model and new LocationSettings configuration

The location data model has been significantly enriched with new fields including vertical speed and its accuracy, floor level, and specific boolean flags (such as hasAccuracy, hasAltitude, etc.) that distinguish between a measured zero value and an unmeasured placeholder, allowing users to reliably filter out invalid readings. Additionally, a new LocationSettings class is introduced, enabling configuration of location accuracy, distance filters, and time limits for location updates.

_geolocator\_platform\interface/lib/src/models · high confidence

Initial Linux implementation for geolocator

This entry introduces the \geolocator\_linux\ package, providing the first official Linux platform support for the geolocator plugin. The implementation leverages the GeoClue2 D-Bus service to retrieve current and last known positions, stream location updates, and determine location accuracy. It includes specific handling for GNOME desktop environments via \GeolocatorGnome\, which monitors location service status through GSettings and allows users to open the system Location Settings panel. The package also integrates \package\_info\_plus\ to identify the application to the location service and adheres to the \geolocator\_platform\_interface\ version 4.1.0.

_geolocator\linux · high confidence

Initial Windows support for the geolocator plugin

This change introduces the official Windows implementation of the geolocator plugin, allowing Flutter applications to access location services on Windows. The package includes the native C++ plugin code, a CMake build configuration, and a complete example application demonstrating usage. It registers with the Flutter engine to handle method calls for checking permissions, retrieving current and last known positions, and monitoring location service status.

_geolocator\windows · high confidence

Initial implementation of MethodChannelGeolocator platform interface

This change introduces the \MethodChannelGeolocator\ class, which serves as the concrete implementation of the \GeolocatorPlatform\ interface for communicating with native device location services. It establishes the core API surface for location features, including checking and requesting permissions, retrieving the last known position, fetching the current position with optional timeouts, monitoring location service status, and accessing the live position stream. The implementation handles platform-specific method channel calls and maps native responses to Dart models, providing the foundational connectivity layer for the geolocator package.

_geolocator\_platform\interface/lib/src/implementations · high confidence

Initial release of the geolocator\_apple plugin for iOS and macOS

This entry introduces the official iOS and macOS implementation of the geolocator plugin. It provides native handlers for location services, including permission management, background location updates, and accuracy settings. The plugin supports both iOS and macOS, utilizing modern APIs like \requestTemporaryFullAccuracy\ on iOS 14+ and macOS 10.16+, and includes a privacy manifest for App Store compliance. It exposes methods for checking permissions, getting the current/last known position, and listening to location streams, while handling platform-specific nuances such as activity types and background indicators.

_geolocator\apple · high confidence

New example app for Android geolocator plugin

The \geolocator\_android/example\ directory now includes a complete Flutter example application (\main.dart\) that demonstrates the plugin's capabilities. This app provides a user interface for requesting location permissions, listening to real-time position updates, retrieving the current and last known positions, and accessing location accuracy settings. It also includes platform-specific actions for opening app and location settings on Android, serving as a reference implementation for integrating the geolocator Android platform implementation.

_geolocator\android/example · high confidence

New example app for geolocator\_apple

The geolocator\_apple example application has been introduced, providing a complete Flutter UI to demonstrate the plugin's capabilities. This demo app allows users to test core features such as requesting the current and last known positions, listening to continuous location updates, and checking service status. It also includes platform-specific actions for iOS, such as retrieving location accuracy and requesting temporary full accuracy, alongside standard settings navigation options.

_geolocator\apple/example · high confidence

New geolocator example application structure

The geolocator/example directory now contains a complete, version-controlled example application structure. This includes a .gitignore file tailored for Flutter/Dart projects, a .metadata file tracking the stable Flutter channel, a README.md with getting started resources, and an analysis\_options.yaml that includes the flutter\_lints package for static analysis. The core example app is implemented in lib/main.dart, demonstrating geolocator functionality such as requesting permissions, getting current/last known positions, and listening to position streams, using the baseflow\_plugin\_template for UI consistency.

geolocator/example · high confidence

New location permission and accuracy enums introduced

The platform interface now exposes a set of new enums to handle location-related states more granularly. Users can now check specific permission states via \LocationPermission\ (including \denied\, \deniedForever\, \whileInUse\, \always\, and \unableToDetermine\), request specific accuracy levels via \LocationAccuracy\ (such as \bestForNavigation\ and \reduced\), and monitor service status via \ServiceStatus\ (\enabled\/\disabled\). Additionally, \LocationAccuracyStatus\ is provided to distinguish between \precise\ and \reduced\ location data on iOS 14+.

_geolocator\_platform\interface/lib/src/enums · high confidence

New web example application for geolocator\_web

The geolocator\_web package now includes a complete example application located in the example directory. This demo app allows users to run the geolocator\_web package directly in a Flutter web application (specifically targeting Chrome), demonstrating core functionalities such as requesting location permissions, retrieving the current position, and listening to position updates. The example is structured as a standard Flutter web project with necessary configuration files like .gitignore, .metadata, and web manifest files to support local development and testing.

_geolocator\web/example · high confidence

Windows example app for Geolocator

An example application for the Geolocator plugin on Windows has been added, providing a user interface to demonstrate core location features. Users can now test getting the current and last known positions, monitoring location accuracy, and toggling continuous position updates via a play/pause control. The app also includes utilities to open app and location settings and handles permission and service status states.

_geolocator\windows/example · high confidence

Removals

Removal of Flutter Geolocator plugin implementation

The main library file \lib/flutter\_geolocator.dart\ has been deleted, removing the Flutter plugin implementation that previously exposed geolocation capabilities via MethodChannel and EventChannel. This change eliminates the ability to retrieve the current position or subscribe to position change streams through this package.

lib · high confidence

Removal of legacy Android example project files

The Android example project files for the geolocator package have been removed, including the AndroidManifest.xml, MainActivity.java, and .gitignore. This cleanup eliminates the old Java-based implementation and associated configuration, likely as part of a migration to a newer embedding version or a different example structure.

example/android · high confidence

Removal of legacy Android geolocator plugin implementation

The Android module for the geolocator plugin has been removed, including the Java source files (FlutterGeolocatorPlugin.java, LocationMapper.java), the AndroidManifest.xml, and the .gitignore. This deletes the legacy implementation that handled location permissions and fused location provider callbacks via the old Flutter plugin registration API, effectively stripping the Android-specific code from this directory.

android · high confidence

Removal of legacy Flutter Geolocator example app

The example application located in example/lib/main.dart has been removed. This file previously demonstrated the usage of the 'flutter\_geolocator' package, including basic position retrieval and streaming. Its deletion indicates that the legacy example code is no longer maintained or distributed with the library.

example/lib · high confidence

Removed iOS geolocator plugin implementation

The iOS implementation files for the geolocator plugin have been deleted, including the Objective-C registration class (FlutterGeolocatorPlugin.m) and the Swift plugin class (SwiftFlutterGeolocatorPlugin.swift). This removes the iOS-specific code that previously handled method channel registration and returned the iOS system version, effectively stripping iOS support from this location.

ios · high confidence

Removed legacy Position model class

The legacy \Position\ model class in \lib/models/position.dart\ has been removed from the codebase. This class previously handled the deserialization of location data from platform messages via a \fromMap\ method, defaulting numeric fields like altitude and accuracy to 0.0 if keys were missing. Its removal indicates a shift in how location data structures are defined or consumed, likely replacing this custom implementation with a different model or standard.

lib/models · high confidence

Architecture

Introduce GeolocatorPlatform interface for plugin extensibility

The \geolocator\_platform\_interface\ package now exposes the \GeolocatorPlatform\ abstract class, which defines the contract for platform-specific implementations. This interface includes methods for checking and requesting location permissions, retrieving the last known position, fetching the current position, monitoring location streams, and requesting temporary full accuracy on iOS. Platform plugins must extend this class to provide their own logic, ensuring that new methods added to the interface do not break existing implementations.

_geolocator\_platform\interface/lib/src · high confidence

Behavioural changes

Add integer-to-permission conversion extension

A new extension method \toLocationPermission()\ is now available on integer values, allowing native platform permission codes (0–3) to be safely converted into the corresponding \LocationPermission\ enum values (\denied\, \deniedForever\, \whileInUse\, \always\). This simplifies handling permission status updates from native platforms by providing a direct mapping and throwing an \InvalidPermissionException\ for unrecognized codes.

_geolocator\_platform\interface/lib/src/extensions · high confidence

Added iOS example workspace configuration

The iOS example app now includes a dedicated Xcode workspace configuration. This adds the workspace file referencing the main project and CocoaPods dependencies, enables the 32-bit warning check, and disables interface builder previews to streamline the build environment for the geolocator example.

geolocator/example/ios/Runner.xcworkspace · high confidence

Android example app migrated to Flutter v2 embedding and updated build configuration

The Android example app has been updated to use the Flutter v2 embedding, which requires declaring a NormalTheme in the AndroidManifest.xml and styles.xml to handle the transition from the native splash screen to the Flutter UI. The app's AndroidManifest.xml now explicitly declares location permissions (ACCESS\_FINE\_LOCATION, ACCESS\_COARSE\_LOCATION, and FOREGROUND\_SERVICE\_LOCATION) and the debug/profile manifests include INTERNET permission for debugging. Additionally, the Gradle wrapper has been upgraded from version 4.4 to 9.3.1, and the project structure has been reorganized to reflect the new geolocator/example location.

geolocator/example/android · high confidence

Android location service architecture refactored with foreground service support

The Android implementation has been restructured to use a dedicated \GeolocatorLocationService\ for handling location updates, replacing the previous activity-bound approach. This change introduces proper foreground service support for background location tracking, including configurable notification options (title, text, icon, color, and channel name) and wake/Wi-Fi locks. The plugin now manages multiple Flutter engines via a shared \GeolocationManager\ singleton and uses \SecureRandom\ for request codes. Additionally, the \LocationMapper\ now includes tests for mapping vertical speed and its accuracy from Android location extras.

_geolocator\android/android · high confidence

Export geolocator platform interface components

The geolocator\_platform\_interface library now exposes its internal source files (enums, errors, geolocator platform interface, extensions, and models) through a single entry point, allowing consumers to import these specific components directly from the main library file.

_geolocator\_platform\interface/lib · high confidence

Geolocator API restructured with platform-specific settings and deprecated legacy parameters

The geolocator library has been refactored to use a unified \LocationSettings\ object for configuring location requests, replacing the previous individual parameters like \desiredAccuracy\, \forceAndroidLocationManager\, and \timeLimit\ in \getCurrentPosition\. These legacy parameters are now marked as deprecated. The API now exposes platform-specific configuration classes (\AndroidSettings\, \AppleSettings\, \WebSettings\) to allow fine-grained control over location behavior on each platform. Additionally, the \WebSettings\ class is now publicly exported, enabling web-specific configurations such as controlling the maximum age of location updates.

geolocator/lib · high confidence

Geolocator plugin restructured with updated dependencies and documentation

The geolocator package has been reorganized, introducing a new .metadata file for Flutter tooling and updating the CHANGELOG to reflect dependency bumps for geolocator\_android (^5.1.0), geolocator\_platform\_interface (^4.4.0), and other platform-specific packages. The README has been expanded with detailed configuration instructions for Android (including Android 14's FOREGROUND\_SERVICE\_LOCATION permission), iOS (including background modes and temporary accuracy), macOS, Web, and Windows. The example app's web assets (index.html, manifest.json) are now included, and linting is configured via flutter\_lints.

geolocator · high confidence

Introduction of specific exception types for geolocation errors

The geolocator platform interface now exposes distinct exception classes to provide clearer error handling for users. New types include ActivityMissingException for Android background context issues, AlreadySubscribedException when multiple position streams are active, InvalidPermissionException for unknown permission values, LocationServiceDisabledException when device services are off, PermissionDefinitionsNotFoundException for missing manifest/plist entries, PermissionDeniedException for user-denied access, PermissionRequestInProgressException for overlapping requests, and PositionUpdateException for general update failures. These are exported via the errors.dart barrel file.

_geolocator\_platform\interface/lib/src/errors · high confidence

Migration to federated plugin architecture

The plugin has been restructured from a single monolithic package into a federated architecture, separating the app-facing interface from platform-specific implementations. The README now documents distinct packages for Android (\geolocator\_android\), Apple platforms (\geolocator\_apple\), Web (\geolocator\_web\), and Windows (\geolocator\_windows\), alongside the core \geolocator\ and \geolocator\_platform\_interface\ packages. This change requires users to depend on the new modular structure rather than the previous single package.

(repo-wide) · high confidence

Refactored web geolocation with abstracted permission and geolocation managers

The web platform implementation has been restructured to separate concerns into abstract interfaces and specific HTML-based implementations. A new \GeolocationManager\ interface and \HtmlGeolocationManager\ implementation now handle position retrieval and watching, supporting \maximumAge\ for cached positions. Additionally, a \PermissionsManager\ interface and \HtmlPermissionsManager\ implementation abstract the browser's Permission API for querying geolocation access status. Utility functions in \utils.dart\ handle the conversion of browser-specific objects to the common \Position\ and \LocationPermission\ types, ensuring consistent behavior across the platform.

_geolocator\web/lib/src · high confidence

Removal of legacy iOS Runner configuration files

The example iOS project has removed the \AppDelegate.swift\, \Runner-Bridging-Header.h\, and \.gitignore\ files. This eliminates the manual plugin registration logic and associated build artifacts, indicating a shift to a newer iOS project structure or tooling that handles these aspects automatically.

example/ios · high confidence

Web platform now supports maximumAge setting and exposes WebSettings

The geolocator\_web plugin now allows web users to control the maximum age of cached positions via a new \WebSettings\ class, which is publicly exported. This setting is passed to the underlying HTML5 Geolocation API during \getCurrentPosition\ and \getPositionStream\ calls. Additionally, the web implementation now correctly maps \LocationAccuracy.reduced\ to low-accuracy requests (previously it was incorrectly treated as high accuracy), and \isLocationServiceEnabled\ consistently returns true for web platforms.

_geolocator\web/lib · high confidence

iOS example app configuration updates

The iOS example app's build configuration has been updated to require iOS 11.0 or later (previously 8.0) and now uses the $(DEVELOPMENT\_LANGUAGE) variable for the development region. Additionally, the Debug and Release xcconfig files now explicitly include the Pods support files, ensuring CocoaPods dependencies are correctly linked during the build process.

geolocator/example/ios/Flutter · high confidence

iOS example app now supports precise location access

The iOS example application has been updated to request precise location permissions. This is achieved by adding the \NSLocationWhenInUseUsageDescription\ and \NSLocationTemporaryUsageDescriptionDictionary\ keys to the Info.plist, allowing the app to access the device's precise location when in use and temporarily for higher accuracy. The example app bundle name has also been updated from \flutter\_geolocator\_example\ to \geolocator\_example\.

geolocator/example/ios/Runner · high confidence

iOS example project migrated to modern Xcode and CocoaPods configuration

The iOS example app's Xcode project has been updated to Xcode 10.2 compatibility (objectVersion 50) and migrated from Swift to Objective-C (AppDelegate.swift replaced by AppDelegate.h/m). The build system now uses CocoaPods for dependency management (libPods-Runner.a) instead of embedding Flutter.framework directly, and the build script was changed to 'embed\_and\_thin' to support this new structure.

geolocator/example/ios/Runner.xcodeproj · high confidence

Test coverage

Added tests for LocationAccuracy and LocationPermission enum values; Added tests for Position model equality and unmeasured value handling; Added tests for integer-to-permission extension; Added unit tests for Geolocator public API; Added unit tests for MethodChannelGeolocator implementation; Added unit tests for geolocator error exceptions; Added unit tests for geolocator\_web plugin; Added unit tests for the Linux geolocator implementation; Added unit tests for the geolocator platform interface; Removed example widget test.

Dependencies

Migrate example apps to new plugin structure and update dependencies

The example apps for the geolocator plugin and its platform-specific packages (Android, Apple, Linux, Web, Windows) have been restructured into a federated plugin layout, moving from a single monolithic example to individual \example/\ directories within each package. This change updates the Dart SDK constraint to \^3.5.0\ and upgrades \flutter\_lints\ to \^6.0.0\ across all packages. On Android, the example apps now use the new \dev.flutter.flutter-gradle-plugin\ with the Android Gradle Plugin \9.1.0\, Java 17 compatibility, and the new \namespace\ property, while the \geolocator\_android\ package itself updates its dependency on \play-services-location\ to \21.2.0\ and \androidx.core:core\ to \1.16.0\. The Apple implementation adds a Swift Package Manager manifest and a privacy manifest resource bundle.

(dependencies) · 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

Score

  • CAI 68.4 → 71.3 (+2.9)
  • Rubric changed (rubric-2026.11.2 → rubric-2026.11.4) — scores are not directly comparable.

Lenses

  • Code Health 80.2 → 72.4 (-7.8)
  • Architecture 99.4 → 99.4 (0.0)
  • Maturity 62.5 → 70.3 (+7.8)
  • Readiness 69.6 → 76.4 (+6.8)
  • Security 66.8 → 66.8 (0.0)
  • Performance 100.0 → 100.0 (0.0)

Resolved (6)

  • Duplicated block (13 lines × 2) (geolocator/example/lib/main.dart)
  • Duplicated block (13 lines × 2) (geolocator_linux/example/lib/main.dart)
  • Duplicated block (14 lines × 3) (geolocator/example/lib/main.dart)
  • Duplicated block (24 lines × 3) (geolocator/example/lib/main.dart)
  • Duplicated block (30 lines × 3) (geolocator_android/lib/src/geolocator_android.dart)
  • Off-boarding risk: anonymized user #1

New (20)

  • Duplicated block (13 lines × 2) (geolocator/example/lib/main.dart)
  • Duplicated block (13 lines × 2) (geolocator_linux/example/lib/main.dart)
  • Duplicated block (14 lines × 3) (geolocator/example/lib/main.dart)
  • Duplicated block (24 lines × 3) (geolocator/example/lib/main.dart)
  • Duplicated block (30 lines × 3) (geolocator_android/lib/src/geolocator_android.dart)
  • Edited copies of one member (3 members, 21+ corresponding lines) (geolocator_android/example/lib/main.dart)
  • Edited copies of one member (3 members, 4+ corresponding lines) (geolocator_android/lib/src/geolocator_android.dart)
  • Edited copies of one member (3 members, 4+ corresponding lines) (geolocator_android/lib/src/geolocator_android.dart)
  • Edited copies of one member (3 members, 4+ corresponding lines) (geolocator_android/lib/src/geolocator_android.dart)
  • Edited copies of one member (3 members, 41+ corresponding lines) (geolocator_android/lib/src/geolocator_android.dart)
  • Edited copies of one member (6 members, 4+ corresponding lines) (geolocator/example/lib/main.dart)
  • Edited copy of a member (13 corresponding lines) (geolocator_linux/lib/src/geolocator_linux.dart)
  • Edited copy of a member (13 corresponding lines) (geolocator_windows/example/lib/main.dart)
  • Edited copy of a member (15 corresponding lines) (geolocator_android/android/src/main/java/com/baseflow/geolocator/utils/Utils.java)
  • Edited copy of a member (40 corresponding lines) (geolocator/example/lib/main.dart)
  • Edited copy of a member (42 corresponding lines) (geolocator_apple/example/lib/main.dart)
  • Edited copy of a member (50 corresponding lines) (geolocator_android/example/lib/main.dart)
  • Edited copy of a member (54 corresponding lines) (geolocator_linux/example/lib/main.dart)
  • Edited copy of a member (9 corresponding lines) (geolocator_android/android/src/main/java/com/baseflow/geolocator/MethodCallHandlerImpl.java)
  • Off-boarding risk: anonymized user #1

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-geolocator 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 2837d963d3fc02b209fce34ff4672b58749a967f — 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.