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
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.