Error map

No connected devices / device not found flutter run: No connected devices found; check 'flutter doctor'. Expected at least one device

Flutter / Dart · layer 1, On your device

Open the full error page →

Centre: this error. First ring: errors it is linked with (12). Outer ring: what those are linked with. Colours show the layer of a request each error belongs to. Click any dot to re-centre the map on it; hover to follow its connections. The centre dot opens the error page.

No connected devices / device not found — flutter run: No connected devices found; check 'flutter doctor'. Expected at least one device (Flutter / Dart)No connecte…INSTALL_FAILED_USER_RESTRICTED — INSTALL_FAILED_USER_RESTRICTED: Install canceled by user (Xiaomi/MIUI, Oppo, Vivo) (Android)INSTALL_FAILED_USER…Failed to prepare device for development — Xcode: Failed to prepare device for development / iPhone is not available. Please reconnect the device (iOS)Failed to prepare d…adb unauthorized — adb: device unauthorized. This adb server's $ADB_VENDOR_KEYS is not set (Android)adb unauthorizedUntrusted Developer — Could not launch "App": process launch failed: Security / Untrusted Developer (iOS)Untrusted Developerno devices/emulators found — adb: no devices/emulators found / error: device not found (Android)no devices/emulator…BoxConstraints forces an infinite width — Flutter: BoxConstraints forces an infinite width. These invalid constraints were provided to RenderStack's layout() function (TextField in a Row) (Flutter / Dart)BoxConstraints forc…Cleartext HTTP traffic not permitted — Flutter (Android): java.io.IOException: Cleartext HTTP traffic to api.example.com not permitted (Flutter / Dart)Cleartext HTTP traf…CocoaPods: pod install failed / not installed — Flutter iOS: Error running pod install — CocoaPods not installed or out of date / [!] CocoaPods could not find compatible versions for pod (Flutter / Dart)CocoaPods: pod inst…Dependency requires compileSdk 34 or later — Android Gradle: Execution failed for task ':app:checkDebugAarMetadata'. Dependency requires libraries and applications that depend on it to compile against version 34 or later of the Android APIs (Flutter / Dart)Dependency requires…dependOnInheritedWidgetOfExactType called before initState completed — Flutter: dependOnInheritedWidgetOfExactType<_InheritedTheme>() or dependOnInheritedElement() was called before _HomeState.initState() completed (Flutter / Dart)dependOnInheritedWi…Android license status unknown / licenses not accepted — flutter doctor: Android license status unknown. Run `flutter doctor --android-licenses` to accept the SDK licenses (Flutter / Dart)Android license sta…cmdline-tools component is missing — flutter doctor: Android SDK is missing command-line tools; download from https://goo.gl/XxQghQ — cmdline-tools component is missing (Flutter / Dart)cmdline-tools compo…INSTALL_FAILED_INSUFFICIENT_STORAGE — INSTALL_FAILED_INSUFFICIENT_STORAGE: Failure [INSTALL_FAILED_INSUFFICIENT_STORAGE] (Android)INSTALL_FAILED_INSU…INSTALL_FAILED_NO_MATCHING_ABIS — INSTALL_FAILED_NO_MATCHING_ABIS: Failed to extract native libraries (Android)INSTALL_FAILED_NO_M…INSTALL_FAILED_OLDER_SDK — INSTALL_FAILED_OLDER_SDK / INSTALL_FAILED_DEPRECATED_SDK_VERSION (Android)INSTALL_FAILED_OLDE…doesn't include the currently selected device — Provisioning profile "x" doesn't include the currently selected device (iOS)doesn't include the…Signing requires a development team — Signing for "App" requires a development team. Select a development team in the Signing & Capabilities editor (iOS)Signing requires a …No such module — Swift: No such module 'X' (module not found) (iOS)No such moduleINSTALL_FAILED_UPDATE_INCOMPATIBLE — Android: INSTALL_FAILED_UPDATE_INCOMPATIBLE (Android)INSTALL_FAILED_UPDA…INSTALL_FAILED_TEST_ONLY — INSTALL_FAILED_TEST_ONLY: installPackageLI (Android)INSTALL_FAILED_TEST…adb server version doesn't match — adb server version (41) doesn't match this client (39); killing... (Android)adb server version …Failed to register bundle identifier — Failed to register bundle identifier: The app identifier "com.x" cannot be registered to your development team because it is not available (iOS)Failed to register …doesn't include signing certificate — Provisioning profile "x" doesn't include signing certificate "Apple Development: Name (ID)" (iOS)doesn't include sig…Command CodeSign failed — Command CodeSign failed with a nonzero exit code (errSecInternalComponent / resource fork, Finder information not allowed) (iOS)Command CodeSign fa…ActivityNotFoundException — ActivityNotFoundException: Unable to find explicit activity class; have you declared this activity in your AndroidManifest.xml? (Android)ActivityNotFoundExc…Can not perform this action after onSaveInstanceState — IllegalStateException: Can not perform this action after onSaveInstanceState (fragment transaction) (Android)Can not perform thi…Fragment not attached to a context — IllegalStateException: Fragment x not attached to a context / not attached to an activity (Android)Fragment not attach…measured with an infinity maximum height — Jetpack Compose: Vertically scrollable component was measured with an infinity maximum height constraints, which is disallowed (Android)measured with an in…A RenderFlex overflowed — Flutter: A RenderFlex overflowed by x pixels on the right/bottom (Flutter / Dart)A RenderFlex overfl…RenderBox was not laid out — Flutter: RenderBox was not laid out: RenderFlex#a1b2c relayoutBoundary=up2 NEEDS-PAINT — Failed assertion: 'hasSize' (Flutter / Dart)RenderBox was not l…NetworkOnMainThreadException — android.os.NetworkOnMainThreadException (Android)NetworkOnMainThread…NSURLErrorDomain Code=-1009 — Error Domain=NSURLErrorDomain Code=-1009 "The Internet connection appears to be offline." (iOS)NSURLErrorDomain Co…NSURLErrorDomain Code=-1001 — Error Domain=NSURLErrorDomain Code=-1001 "The request timed out." (iOS)NSURLErrorDomain Co…PhaseScriptExecution — Xcode: Command PhaseScriptExecution failed with a nonzero exit code (iOS)PhaseScriptExecutionCocoaPods compatible versions — CocoaPods could not find compatible versions for pod (iOS)CocoaPods compatibl…CDN: trunk URL couldn't be downloaded — [!] CDN: trunk URL couldn't be downloaded: https://cdn.cocoapods.org/... (iOS)CDN: trunk URL coul…Could not resolve — Gradle: Could not resolve all files for configuration / Could not resolve dependency (Android)Could not resolveManifest merger failed — Manifest merger failed: android:exported needs to be explicitly specified (Android)Manifest merger fai…Duplicate class — Duplicate class X found in modules A and B (Android)Duplicate classBadTokenException — WindowManager$BadTokenException: Unable to add window -- token null is not valid; is your activity running? (Android)BadTokenExceptionsetState() called after dispose() — Flutter: setState() called after dispose(): _MyState#1a2b3 (lifecycle state: defunct, not mounted) (Flutter / Dart)setState() called a…Looking up a deactivated widget's ancestor is unsafe — Flutter: Looking up a deactivated widget's ancestor is unsafe. At this point the state of the widget's element tree is no longer stable (Flutter / Dart)Looking up a deacti…SDK location not found — SDK location not found. Define a valid SDK location with an ANDROID_HOME environment variable or by setting the sdk.dir path in local.properties (Android)SDK location not fo…Default FirebaseApp is not initialized — IllegalStateException: Default FirebaseApp is not initialized in this process (Android)Default FirebaseApp…invalid active developer path — xcrun: error: invalid active developer path (/Library/Developer/CommandLineTools), missing xcrun (iOS)invalid active deve…PlatformException(sign_in_failed, ApiException: 10) — Flutter: PlatformException(sign_in_failed, com.google.android.gms.common.api.ApiException: 10: , null, null) (Flutter / Dart)PlatformException(s…minSdkVersion cannot be smaller than the library's — Android Gradle: uses-sdk:minSdkVersion 16 cannot be smaller than version 21 declared in library [:firebase_auth] (Flutter / Dart)minSdkVersion canno…The current Dart SDK version is x; package requires SDK >= y — Dart pub: The current Dart SDK version is 2.19.0. Because app requires SDK version >=3.0.0 <4.0.0, version solving failed (Flutter / Dart)The current Dart SD…

Directly related (12)

INSTALL_FAILED_USER_RESTRICTEDAndroid

INSTALL_FAILED_USER_RESTRICTED: Install canceled by user (Xiaomi/MIUI, Oppo, Vivo)

The phone’s manufacturer layer blocked installs over USB — Xiaomi/MIUI, Oppo/ColorOS and Vivo require extra developer settings.

Failed to prepare device for developmentiOS

Xcode: Failed to prepare device for development / iPhone is not available. Please reconnect the device

Xcode couldn’t set up the device — usually the device’s iOS version is newer than Xcode supports, Developer Mode is off, or pairi…

adb unauthorizedAndroid

adb: device unauthorized. This adb server's $ADB_VENDOR_KEYS is not set

The phone hasn’t accepted your computer’s RSA key for USB debugging yet.

Untrusted DeveloperiOS

Could not launch "App": process launch failed: Security / Untrusted Developer

The app installed, but iOS won’t run it because the developer certificate hasn’t been trusted on the device (common with free/ent…

no devices/emulators foundAndroid

adb: no devices/emulators found / error: device not found

adb can’t see any connected device or running emulator.

BoxConstraints forces an infinite widthFlutter / Dart

Flutter: BoxConstraints forces an infinite width. These invalid constraints were provided to RenderStack's layout() function (TextField in a Row)

A widget that needs a finite width, like a `TextField` or `Container` with no size, was placed where the parent offers unlimited…

Cleartext HTTP traffic not permittedFlutter / Dart

Flutter (Android): java.io.IOException: Cleartext HTTP traffic to api.example.com not permitted

Android 9+ blocks plain `http://` requests by default; the app must use HTTPS or explicitly allow cleartext for that host.

CocoaPods: pod install failed / not installedFlutter / Dart

Flutter iOS: Error running pod install — CocoaPods not installed or out of date / [!] CocoaPods could not find compatible versions for pod

The iOS build cannot install its native dependencies because CocoaPods is missing, outdated or a pod's version constraints confli…

Dependency requires compileSdk 34 or laterFlutter / Dart

Android Gradle: Execution failed for task ':app:checkDebugAarMetadata'. Dependency requires libraries and applications that depend on it to compile against version 34 or later of the Android APIs

A dependency was built against a newer Android API than your project's `compileSdk`.

dependOnInheritedWidgetOfExactType called before initState completedFlutter / Dart

Flutter: dependOnInheritedWidgetOfExactType<_InheritedTheme>() or dependOnInheritedElement() was called before _HomeState.initState() completed

`Theme.of(context)`, `MediaQuery.of(context)` or `Provider.of(context)` was used in `initState`, where inherited widgets are not…

Android license status unknown / licenses not acceptedFlutter / Dart

flutter doctor: Android license status unknown. Run `flutter doctor --android-licenses` to accept the SDK licenses

The Android SDK licenses have not been accepted, so builds cannot download or use SDK components.

cmdline-tools component is missingFlutter / Dart

flutter doctor: Android SDK is missing command-line tools; download from https://goo.gl/XxQghQ — cmdline-tools component is missing

The Android SDK Command-line Tools package is not installed, so Flutter cannot run `sdkmanager` or accept licenses.

Two steps away (36)

INSTALL_FAILED_INSUFFICIENT_STORAGEAndroid

INSTALL_FAILED_INSUFFICIENT_STORAGE: Failure [INSTALL_FAILED_INSUFFICIENT_STORAGE]

The device or emulator doesn’t have enough free internal storage to install the APK.

INSTALL_FAILED_NO_MATCHING_ABISAndroid

INSTALL_FAILED_NO_MATCHING_ABIS: Failed to extract native libraries

The APK contains native (.so) libraries only for CPU architectures the device doesn’t support — e.g. x86 emulator with arm-only l…

INSTALL_FAILED_OLDER_SDKAndroid

INSTALL_FAILED_OLDER_SDK / INSTALL_FAILED_DEPRECATED_SDK_VERSION

The device’s Android version is lower than the app’s minSdk (OLDER_SDK), or the app’s targetSdk is too old for this Android versi…

doesn't include the currently selected deviceiOS

Provisioning profile "x" doesn't include the currently selected device

The development profile doesn’t list this iPhone’s UDID, so Xcode can’t install the build on it.

Signing requires a development teamiOS

Signing for "App" requires a development team. Select a development team in the Signing & Capabilities editor

No Apple developer team is selected for the target, so Xcode can’t sign the app.

No such moduleiOS

Swift: No such module 'X' (module not found)

Xcode can’t find a Swift package, pod or framework you import.

INSTALL_FAILED_UPDATE_INCOMPATIBLEAndroid

Android: INSTALL_FAILED_UPDATE_INCOMPATIBLE

An app with the same package name but a different signing key is already installed on the device.

INSTALL_FAILED_TEST_ONLYAndroid

INSTALL_FAILED_TEST_ONLY: installPackageLI

The APK is marked testOnly (built by Android Studio’s Run button), so normal installs refuse it.

adb server version doesn't matchAndroid

adb server version (41) doesn't match this client (39); killing...

Two different adb binaries are running — e.g. Android Studio’s SDK adb and another one on PATH (Homebrew, Genymotion, older SDK).

Failed to register bundle identifieriOS

Failed to register bundle identifier: The app identifier "com.x" cannot be registered to your development team because it is not available

Another developer team already owns that bundle identifier, so Xcode can’t create it for your team.

doesn't include signing certificateiOS

Provisioning profile "x" doesn't include signing certificate "Apple Development: Name (ID)"

The profile was created with a different certificate than the one installed in your keychain.

Command CodeSign failediOS

Command CodeSign failed with a nonzero exit code (errSecInternalComponent / resource fork, Finder information not allowed)

codesign failed — the keychain is locked (CI/SSH), the private key is inaccessible, or files carry extended attributes that can’t…

ActivityNotFoundExceptionAndroid

ActivityNotFoundException: Unable to find explicit activity class; have you declared this activity in your AndroidManifest.xml?

An Intent targets an Activity that isn’t declared in the manifest, or an implicit intent has no app to handle it.

Can not perform this action after onSaveInstanceStateAndroid

IllegalStateException: Can not perform this action after onSaveInstanceState (fragment transaction)

A FragmentTransaction (or DialogFragment.show/navigation) ran after the Activity saved its state, typically from an async callbac…

Fragment not attached to a contextAndroid

IllegalStateException: Fragment x not attached to a context / not attached to an activity

Code called requireContext()/requireActivity()/getString() after the Fragment was detached — usually in an async callback.

measured with an infinity maximum heightAndroid

Jetpack Compose: Vertically scrollable component was measured with an infinity maximum height constraints, which is disallowed

A LazyColumn (or verticalScroll) is placed inside another vertically scrolling container, so it gets infinite height.

A RenderFlex overflowedFlutter / Dart

Flutter: A RenderFlex overflowed by x pixels on the right/bottom

A Row or Column’s children need more space than available, so Flutter draws the yellow-black overflow stripes.

RenderBox was not laid outFlutter / Dart

Flutter: RenderBox was not laid out: RenderFlex#a1b2c relayoutBoundary=up2 NEEDS-PAINT — Failed assertion: 'hasSize'

A widget was asked for its size or painted before layout finished, usually because a parent gave it unbounded or conflicting cons…

NetworkOnMainThreadExceptionAndroid

android.os.NetworkOnMainThreadException

The app made a network call on the main (UI) thread, which Android forbids.

NSURLErrorDomain Code=-1009iOS

Error Domain=NSURLErrorDomain Code=-1009 "The Internet connection appears to be offline."

URLSession couldn’t reach the network — the device is offline, the app’s cellular data is disabled, or the simulator lost network…

NSURLErrorDomain Code=-1001iOS

Error Domain=NSURLErrorDomain Code=-1001 "The request timed out."

The server didn’t respond within URLSession’s timeout (60 s default) — slow server, unreachable host on this network, or a stalle…

PhaseScriptExecutioniOS

Xcode: Command PhaseScriptExecution failed with a nonzero exit code

A Run Script build phase (CocoaPods, React Native, Flutter, SwiftLint, Crashlytics…) failed. The real error is above this line in…

CocoaPods compatible versionsiOS

CocoaPods could not find compatible versions for pod

pod install can’t satisfy the version constraints — outdated spec repo, a higher deployment target required, or two pods needing…

CDN: trunk URL couldn't be downloadediOS

[!] CDN: trunk URL couldn't be downloaded: https://cdn.cocoapods.org/...

CocoaPods couldn’t reach its CDN spec repo — network/proxy issues, rate limiting, or an outdated CocoaPods.

Could not resolveAndroid

Gradle: Could not resolve all files for configuration / Could not resolve dependency

Gradle couldn’t download a dependency — wrong coordinates/version, missing repository, offline mode, or network/proxy issues.

Manifest merger failedAndroid

Manifest merger failed: android:exported needs to be explicitly specified

Targeting Android 12 (API 31)+ requires `android:exported` on every activity, service or receiver that has an intent-filter.

Duplicate classAndroid

Duplicate class X found in modules A and B

Two dependencies ship the same class — typically old Android Support libraries mixed with AndroidX, or Kotlin stdlib-jdk7/jdk8 ve…

BadTokenExceptionAndroid

WindowManager$BadTokenException: Unable to add window -- token null is not valid; is your activity running?

A dialog or popup was shown with a context whose Activity is finishing/destroyed, or with the Application context.

setState() called after dispose()Flutter / Dart

Flutter: setState() called after dispose(): _MyState#1a2b3 (lifecycle state: defunct, not mounted)

An async callback (network, timer, stream) finished after the widget was removed and then called setState.

Looking up a deactivated widget's ancestor is unsafeFlutter / Dart

Flutter: Looking up a deactivated widget's ancestor is unsafe. At this point the state of the widget's element tree is no longer stable

You used a `BuildContext` after its widget was removed from the tree — typically after an `await` when the user already navigated…

SDK location not foundAndroid

SDK location not found. Define a valid SDK location with an ANDROID_HOME environment variable or by setting the sdk.dir path in local.properties

Gradle doesn’t know where the Android SDK is installed.

Default FirebaseApp is not initializedAndroid

IllegalStateException: Default FirebaseApp is not initialized in this process

Firebase couldn’t initialise because google-services.json or the Google Services Gradle plugin is missing/misapplied, or initiali…

invalid active developer pathiOS

xcrun: error: invalid active developer path (/Library/Developer/CommandLineTools), missing xcrun

The Xcode Command Line Tools are missing or broken — typical right after a macOS update.

PlatformException(sign_in_failed, ApiException: 10)Flutter / Dart

Flutter: PlatformException(sign_in_failed, com.google.android.gms.common.api.ApiException: 10: , null, null)

Google Sign-In failed on Android because the app's SHA-1 fingerprint or package name is not registered for the OAuth client.

minSdkVersion cannot be smaller than the library'sFlutter / Dart

Android Gradle: uses-sdk:minSdkVersion 16 cannot be smaller than version 21 declared in library [:firebase_auth]

A plugin requires a higher Android minimum SDK than your app declares.

The current Dart SDK version is x; package requires SDK >= yFlutter / Dart

Dart pub: The current Dart SDK version is 2.19.0. Because app requires SDK version >=3.0.0 <4.0.0, version solving failed

A package (or your own pubspec) requires a newer Dart SDK than the one your Flutter installation provides.