[Bug]: App crashes on iOS devices having iOS version lower than 26.x

Open
#287 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
38/100
Issue type
Bug
Clarity
Mostly clear
Activity status
Stale
Tech stack
dart, ios
Domain
mobile

Research direction

Start by inspecting the iOS plugin configuration and the geocoding_ios.framework linkage, using the reported Xcode 26.0.1 build and dyld failure as the reproduction case. Verify the plugin on an affected older iOS device; done means the framework uses only public SDKs and the app launches without the missing _LocationEssentials.framework error.

Written by the indexing model from the issue text.

Description

Please check the following before submitting a new issue.
Please select affected platform(s)
  • Android
  • iOS
Steps to reproduce
  • Install geocoding in a Flutter app
  • Build the iOS app with recent Xcode (Xcode 26.0.1)
  • Run the app on an affected real iOS device
  • App crashes immediately before showing any UI
  • Xcode logs show dyld failure referencing _LocationEssentials.framework
Expected results
  • The app should launch normally on all supported iOS devices
  • The geocoding_ios.framework should not link to private Apple frameworks
  • The plugin should be compiled against public SDKs and not cause dyld loader failures
  • No crash due to missing system frameworks
Actual results
  • The app crashes instantly on affected iOS devices
  • Flutter does not start; crash happens before main()
  • Crash trace from dyld indicates missing private framework:
    Library not loaded: /System/Library/Frameworks/_LocationEssentials.framework/_LocationEssentials
Code sample
Code sample 
The app crashes on startup even before geocoding code execution.
Screenshots or video
Screenshots or video demonstration

[Upload media here]

Version

4.0.0

Flutter Doctor output
Doctor output 
[✓] Flutter (Channel stable, 3.38.1, on macOS 26.0.1 25A362 darwin-x64, locale en-IN) [1,954ms]
    • Flutter version 3.38.1 on channel stable at /Users/vivekyadav/fvm/versions/3.38.1
    • Upstream repository https://github.com/flutter/flutter.git
    • Framework revision b45fa18946 (2 weeks ago), 2025-11-12 22:09:06 -0600
    • Engine revision b5990e5ccc
    • Dart version 3.10.0
    • DevTools version 2.51.1
    • Feature flags: enable-web, enable-linux-desktop, enable-macos-desktop, enable-windows-desktop, enable-android, enable-ios, cli-animations, enable-native-assets,
      omit-legacy-version-file, enable-lldb-debugging

[✓] Android toolchain - develop for Android devices (Android SDK version 36.1.0) [4.0s]
    • Android SDK at /Users/vivekyadav/Library/Android/sdk
    • Emulator version 36.2.12.0 (build_id 14214601) (CL:N/A)
    • Platform android-36, build-tools 36.1.0
    • Java binary at: /Users/vivekyadav/Applications/Android Studio.app/Contents/jbr/Contents/Home/bin/java
      This is the JDK bundled with the latest Android Studio installation on this machine.
      To manually set the JDK path, use: `flutter config --jdk-dir="path/to/jdk"`.
    • Java version OpenJDK Runtime Environment (build 21.0.8+-14018985-b1038.68)
    • All Android licenses accepted.

[✓] Xcode - develop for iOS and macOS (Xcode 26.0.1) [3.7s]
    • Xcode at /Applications/Xcode.app/Contents/Developer
    • Build 17A400
    • CocoaPods version 1.16.2

[✓] Chrome - develop for the web [17ms]
    • Chrome at /Applications/Google Chrome.app/Contents/MacOS/Google Chrome

[✓] Connected device (2 available) [7.2s]
    • macOS (desktop) • macos  • darwin-x64     • macOS 26.0.1 25A362 darwin-x64
    • Chrome (web)    • chrome • web-javascript • Google Chrome 142.0.7444.176
    ! Error: Browsing on the local area network for Suraj’s iPhone. Ensure the device is unlocked and attached with a cable or associated with the same local area network
      as this Mac.
      The device must be opted into Developer Mode to connect wirelessly. (code -27)

[✓] Network resources [1,294ms]
    • All expected network resources are available.

• No issues found
Dominant language
Dart
Stars
153
Forks
92
No merged PRs in 30d

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from Baseflow/flutter-geocoding

All issues in Baseflow/flutter-geocoding

Similar issues

More Dart issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.