macOS Big Sur: Flutter doctor error –

When setting up Flutter for development on macOS Big Sur, you may run into the following error if you are managing Ruby using RVM and trying to install Cocoapods via Gem.

[!] Xcode - develop for iOS and macOS (Xcode 12.2)
    ✗ CocoaPods installed but not working.
        You appear to have CocoaPods installed but it is not working.
        This can happen if the version of Ruby that CocoaPods was installed with is different from the one being used to invoke it.
        This can usually be fixed by re-installing CocoaPods. For more info, see https://github.com/flutter/flutter/issues/14293.
      To re-install CocoaPods, run:
        sudo gem install cocoapods

Flutter has an issue when RVM is being used to manage Ruby and Gem and Cocoapods is installed using Gem. It seems to detect that Cocoapods is installed but cannot properly access/execute it due to a Ruby version mismatch at execution.

To correct this I removed Cocoapods from Gem using ‘sudo gem uninstall cocoapods’ and I reinstalled Cocoapods using Brew instead:

> brew install cocoapods
> brew link --overwrite cocoapods

With that, ‘flutter doctor’ can now properly access/execute cocoapods.

Doctor summary (to see all details, run flutter doctor -v):
[✓] Flutter (Channel stable, 1.22.4, on macOS 11.0.1 20B29 darwin-x64, locale en-US)

[✓] Android toolchain - develop for Android devices (Android SDK version 30.0.2)
[✓] Xcode - develop for iOS and macOS (Xcode 12.2)

macOS Big Sur: Flutter doctor error – Bad state: Future already completed

If you are running into issues getting Flutter setup for development on macOS Big Sur and you are getting the following error when running the ‘flutter doctor’ command and you have Avast Antivirus running, there is a good chance Avast is your problem.

Error Message:

❯ flutter doctor -v
[✓] Flutter (Channel stable, 1.22.4, on macOS 11.0.1 20B29 darwin-x64, locale en-US)
    • Flutter version 1.22.4 at /Users/<user>/dev/env/flutter
    • Framework revision 1aafb3a8b9 (4 days ago), 2020-11-13 09:59:28 -0800
    • Engine revision 2c956a31c0
    • Dart version 2.10.4

⣽Unhandled exception:
Bad state: Future already completed
#0      _AsyncCompleter.complete (dart:async/future_impl.dart:43:31)
#1      _NativeSocket.startConnect.<anonymous closure>.connectNext.<anonymous closure> (dart:io-patch/socket_patch.dart:682:23)
#2      _NativeSocket.issueWriteEvent.issue (dart:io-patch/socket_patch.dart:1102:14)
#3      _NativeSocket.issueWriteEvent (dart:io-patch/socket_patch.dart:1109:12)
#4      _NativeSocket.multiplex (dart:io-patch/socket_patch.dart:1130:11)
#5      _RawReceivePortImpl._handleMessage (dart:isolate-patch/isolate_patch.dart:168:12)

Once I uninstalled Avast, the ‘flutter doctor’ command works without issue.