iOS Build Issues

[Enisco]

If you are looking for help, please confirm the following...

• I confirm I have searched the Docs, Codemagic Sample Projects, and GitHub Discussions.
• I confirm the software versions on my local computer match the ones in CI environment (e.g. Xcode version, Gradle version). See here
• I confirm I am able to do a fresh clone of the repository and build the project on my local computer.

Which mobile framework are you using?

Flutter (Dart)

Steps to reproduce

I get the following error while trying to push my iOS app to the App store. I understand this error is due to the incorrect installation of Cocoapods on the Mac M2 instance I'm assigned to use in building the app on Codemagic.

Archiving com.d818.d818-food-app...
Automatically signing iOS for device deployment using specified development team in Xcode project: 445A85337F
Warning: CocoaPods is installed but broken. Skipping pod install.
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.
To re-install see https://guides.cocoapods.org/using/getting-started.html#installation for instructions.

CocoaPods not installed or not in valid state.

Build failed :|
Failed to build for iOS

Expected results

iOS app successfully built

Actual results

Warning: CocoaPods is installed but broken. Skipping pod install.
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.

Build id (optional)

679860de50c88cb026ef9f75

[majdkz97]

@Enisco
I encountered the same issue and found a few possible solutions that worked (it seems like there are some incompatibility issues):

1. Check Local Versions: Verify the Xcode version and CocoaPods version on your local machine using the following commands:

xcodebuild -version
pod --version

Ensure these match the versions used in your Codemagic workflow. If there’s a mismatch, try updating or downgrading accordingly.

2. Use the Default CocoaPods Version: Some users have resolved this issue by selecting the default/pre-installed CocoaPods version under the CocoaPods dropdown in the Codemagic Workflow Editor (especially when using Xcode 15.1).

3. Manually Set CocoaPods Version: If needed, explicitly set the CocoaPods version to 1.16.2 in codemagic.yaml to prevent compatibility issues:

scripts:
  - name: Install specific CocoaPods version
    script: |
      gem install cocoapods -v 1.16.2
      pod --version

I hope this helps others facing the same issue.

[dam-ease]

Thank for sharing this @majdkz97!
@Enisco Seeing that you are using the Workflow Editor, the second solution here should work in your case. Select the default cocoapods version or use solution 3 in your pre-build script.
I hope these help.