829

I am trying to get a large (and working on Xcode 11!) project building in Xcode 12 (beta 5) to prepare for iOS 14. The codebase was previously in Objective-C, but now it contains both Objective-C and Swift, and uses pods that are Objective-C and/or Swift as well.

I have pulled the new beta of CocoaPods with Xcode 12 support (currently 1.10.0.beta 2).

Pod install is successful. When I do a build, I get the following error on a pod framework:

building for iOS Simulator, but linking in object file built for iOS, for architecture arm64

and possibly also the error:

Unable to load standard library for target 'arm64-apple-ios11.0'

When I go run lipo -info on the framework, it has: armv7s armv7 i386 x86_64 arm64.

Previously, the project had Valid Architectures set to: armv7, armv7s and arm64.

In Xcode 12, that setting goes away, as per Apple's documentation. Architectures is set to $(ARCHS_STANDARD). I have nothing set in excluded architectures.

What may be going on here? I have not been able to reproduce this with a simpler project yet.

13
  • 3
    This is worked for me: stackoverflow.com/questions/24924809/… Sep 23, 2020 at 10:12
  • 3
    Check out the article: milanpanchal24.medium.com/… Dec 14, 2020 at 8:01
  • 37
    I have an Apple Silicon M1, and am still running into this arm64 error. Why would that be the case?
    – Adrienne
    Dec 23, 2020 at 20:24
  • 3
    Same here, Apple M1, just started to happen. None of the solutions I can find seem to work.. any one any idea?? building for iOS Simulator, but linking in object file built for iOS, file '/.............../Pods/GoogleMaps/Maps/Frameworks/GoogleMapsCore.framework/GoogleMapsCore' for architecture arm64
    – martin010
    Feb 28, 2021 at 22:36
  • 16
    TLDR; XCode 13 + Apple M1: (1) Open Xcode using Rosetta (Applications -> Right-Click Xcode -> Get Info -> Check Open with Rosetta). (2) Add arm64 to excluded architectures (Build Settings) (3) Clean Build Folder (4) Run app Jan 21, 2022 at 5:55

59 Answers 59

1201

Basically, you have to exclude arm64 for the simulator architecture, both from your project and the Pod project.

  • To do that, navigate to Build Settings of your project and add Any iOS Simulator SDK with value arm64 inside Excluded Architecture.

    Enter image description here

OR

  • If you are using custom XCConfig files, you can simply add this line for excluding simulator architecture.

    EXCLUDED_ARCHS[sdk=iphonesimulator*] = arm64
    

    Then

    You have to do the same for the Pod project until all the Cocoa pod vendors are done adding following in their Podspec.

    s.pod_target_xcconfig = { 'EXCLUDED_ARCHS[sdk=iphonesimulator*]' => 'arm64' }
    s.user_target_xcconfig = { 'EXCLUDED_ARCHS[sdk=iphonesimulator*]' => 'arm64' }
    

    You can manually add the Excluded Architecture in your Pod project's Build Settings, but it will be overwritten when you use pod install.

    In place of this, you can add this snippet in your Podfile. It will write the necessary Build Settings every time you run pod install.

    post_install do |installer|
      installer.pods_project.build_configurations.each do |config|
        config.build_settings["EXCLUDED_ARCHS[sdk=iphonesimulator*]"] = "arm64"
      end
    end
    
39
  • 11
    The extra detail about CocoaPods here is nice. Note that without [sdk=iphonesimulator*] after EXCLUDED_ARCHS, XCode will fail to find your pods when building for an actual device since none of the pods will be built for arm64.
    – mwu
    Sep 22, 2020 at 17:34
  • 17
    Worked for me! Note that there is already a post_install do |installer| section in most Podfiles due to flipper. Paste the inner section installer.pods_project.build_configurations.each do |config| config.build_settings["EXCLUDED_ARCHS[sdk=iphonesimulator*]"] = "arm64" end behind the flipper_post_install(installer) line. Sep 29, 2020 at 9:59
  • 36
    I am getting building for iOS Simulator, but linking in object file built for macOS, for architecture x86_64. How to fix it? Oct 1, 2020 at 13:56
  • 3
    This solution is excellent and I would add that if you are building your own pod, take note particularly of the 2 lines the author suggests after "...until all the cocoa pod vendors are done adding in their Podspec" as the absence of these in my own framework's Podspec was causing linting failures when I attempted to push it to my private repo. Thanks!
    – Danny
    Oct 3, 2020 at 6:19
  • 19
    This ends up working sometimes, but is actually wrong and broken. EXCLUDED_ARCHS for arm64 on the simulator means that people with Apple Silicon macs won't be able to use your framework. The fix that actually worked for me was to clear out VALID_ARCHS as per stackoverflow.com/a/63714000/234 Dec 6, 2020 at 9:40
276

TL;DR;

Set "Build Active Architecture Only (ONLY_ACTIVE_ARCH)" to Yes for your libraries/apps, even for release mode.


While trying to identify the root cause of the issue I realized some fun facts about Xcode 12.

  1. Xcode 12 is actually the stepping stone for Apple silicon which unfortunately is not yet available (when the answer was written). But with that platform we are going to get an arm64-based macOS where simulators will also run on the arm64 architecture unlike the present Intel-based x86_64 architecture.

  2. Xcode usually depends on the "Run Destination" to build its libraries/applications. So when a simulator is chosen as the "Run Destination", it builds the app for available simulator architectures and when a device is chosen as the "Run Destination" it builds for the architecture that the device supports (arm*).

  3. xcodebuild, in the Xcode 12+ build system considers arm64 as a valid architecture for simulator to support Apple silicon. So when a simulator is chosen as the run destination, it can potentially try to compile/link your libs/apps against arm64 based simulators, as well. So it sends clang(++) some -target flag like arm64-apple-ios13.0-simulator in <architecture>-<os>-<sdk>-<destination> format and clang tries to build/link against an arm64-based simulator that eventually fails on an Intel based Mac.

  4. But xcodebuild tries this only for Release builds. Why? Because, "Build Active Architecture Only (ONLY_ACTIVE_ARCH)" build settings is usually set to "No" for the "Release" configuration only. And that means xcodebuild will try to build all architectural variants of your libs/apps for the selected run destination for release builds. And for the Simulator run destination, it will includes both x86_64 and arm64 now on, since arm64 in Xcode 12+ is also a supported architecture for simulators to support Apple silicon.

Simply putting, Xcode will fail to build your application anytime it tries the command line, xcodebuild, (which defaults to release build, see the general tab of your project setting) or otherwise and tries to build all architectural variants supported by the run destination. So a simple workaround to this issue is to set "Build Active Architecture Only (ONLY_ACTIVE_ARCH)" to Yes in your libraries/apps, even for release mode.

Enter image description here

Enter image description here

If the libraries are included as Pods and you have access to .podspec you can simply set:

spec.pod_target_xcconfig = { 'ONLY_ACTIVE_ARCH' => 'YES' }

spec.user_target_xcconfig = { 'ONLY_ACTIVE_ARCH' => 'YES' } # not recommended

I personally don't like the second line since pods shouldn't pollute the target project and it could be overridden in the target settings, itself. So it should be the responsibility of the consumer project to override the setting by some means. However, this could be necessary for successful linting of podspecs.

However, if you don't have access to the .podspec, you can always update the settings during installation of the pods:

post_install do |installer|
  installer.pods_project.targets.each do |target|
    target.build_configurations.each do |config|
      config.build_settings["ONLY_ACTIVE_ARCH"] = "YES"
    end
  end
end

One thing I was concerned about that what will be the impact of this when we actually archive the libraries and applications. During archiving applications usually take the "Release" configuration and since this will be creating a release build considering only the active architecture of the current run destination, with this approach, we may lose the slices for armv7, armv7s, etc. from the target build. However, I noticed the documentation says (highlighted in the attached picture) that this setting will be ignored when we choose "Generic iOS Device/Any Device" as the run destination, since it doesn't define any specific architecture. So I guess we should be good if we archive our app choosing that as a run destination.

29
  • 7
    This is really a surprising change from Apple and costed me half a day to figure out that I feel Apple should compensate :). This is not a documented update (at least as I know of) and certainly going to affect everyone upgrading to Xcode 12. I only hope everybody finds their own way to get over with it once they know the basics. Oct 1, 2020 at 20:12
  • 2
    If multiple pod specs use user_target_xcconfig and the values don't match exactly, CocoaPods will emit warnings like this [!] Can't merge user_target_xcconfig for pod targets: [... list of pods ...]. Singular build setting EXCLUDED_ARCHS[sdk=<...>] has different values. The podspec syntax reference says this attribute is "not recommended" guides.cocoapods.org/syntax/podspec.html#user_target_xcconfig. So please don't use user_target_xcconfig for this to save many developers the trouble. Oct 16, 2020 at 7:12
  • 2
    Right! And I think I already have mentioned that in my answer. Oct 16, 2020 at 13:39
  • 2
    I managed to get it all working in the end with 'EXCLUDED_ARCHS[sdk=iphonesimulator*]' => 'arm64' but only in pod_target_xcconfig, and only on the problem pod (which included a prebuilt library) and the single pod which depended on the problem pod. Everything else was left clean. I decided I preferred that to the active arch solution. Oct 28, 2020 at 16:31
  • 2
    On Apple Silicon, doing this lead to another error. This may be due to some specific pods. I opened a specific question for theses cases. stackoverflow.com/questions/65364886/…
    – Xiiryo
    Dec 19, 2020 at 12:51
139

I found a solution! SwiftUI Previews not working with Firebase

If you set excluded architectures for the simulator to arm64 it will compile.

Excluding architectures for the simulator

8
  • Fair enough, the issue I was having was with a manually linked library however it did not cause a problem with our pods we're using either. Aug 31, 2020 at 12:55
  • 13
    I was testing on Release mode so I had to add it to Release too
    – MujtabaFR
    Sep 20, 2020 at 18:40
  • 6
    This worked for me, but only when I build for arm64; simulators don't work. Small rant: xCode is ridiculous, 12.5 gigs, tons of pods. Building for Android is a walk in the park compared to this experience. Apr 13, 2022 at 3:16
  • 5
    This won't work on M1 mac
    – atineoSE
    May 11, 2022 at 13:23
  • 1
    I only needed this for M1 Mac and it works (without Rosetta; with Rosetta I didn't have this problem at all) The answer, for me, is in the project that I'm trying to compile 1. Architectures are standard 2. Build active is NO 3. Excluded is Debug -> Any iOS Sim SDK -> arm64 but all other slots are blank Hopefully this helps somebody else, too. May 22, 2022 at 21:04
105

The proposed answers are outdated/incorrect.

You should initially try to update both CocoaPods and the dependencies for your library/app, and then, if that doesn't work, contact the vendors of any dependencies you are using to see if they have an update in progress to add support for arm64 Simulator slices on M1 Macs.

There are a lot of answers on here marked as correct suggesting that you should exclude arm64 from the list of supported architectures. This is at best a very temporary workaround, and at worst it will spread this issue to other consumers of your libraries. If you exclude the arm64 Simulator slice, there will be performance impacts on apps that you're developing in the Simulator (which in turn can lead to reduced battery time for your shiny new M1 kit while you're developing your amazing ideas).

5
  • 5
    That's true, as mangling with excluding or including architectures works solely on i386-based machines.
    – elfenlaid
    Feb 21, 2021 at 11:26
  • 1
    Tell that to GOOGLE... They still don't support SPM. It'll be years. Sep 28, 2021 at 4:21
  • 4
    this answer should be the correct accepted answer. @BeauNouvelle Google recently opened sourced lots of their SDKs (like GoogleSignIn) which now supports xcframework with arm64 simulator slices ;)
    – Buju
    Oct 4, 2021 at 14:21
  • 1
    I agree, this is the correct answer, however, sometimes you have to deal with legacy stuff. On Intel I had to go with the answer from @AyanSengupta to being able to test my debug build. Feb 4, 2022 at 12:01
  • 1
    This is correct, but still doesn't offer a workable alternative for unmaintained projects unfortunately 😅 Apr 22, 2022 at 12:46
76

The Valid Architectures build setting has been removed in Xcode 12. If you had values in this build setting, they're causing a problem and need to be removed.

I was able to "clear out" the VALID_ARCHS build setting by adding it back in as a user-defined build setting (with no values), running the project (which failed), and then deleting the VALID_ARCHS build setting. After that, I was able to run on the simulator.

My Architectures build setting is Standard Architectures.

You can add a user-defined setting from the plus button in Build Settings:

User-defined setting

13
  • 15
    This should be the accepted answer. Make sure the app project is selected not the Target. Otherwise, you won't be able to delete the VALID_ARCHS from Build Settings. :)
    – Bionicle
    Sep 5, 2020 at 7:55
  • 2
    @trishcode Even after doing this i'm getting same error(xcode12 beta4), any work arounds Sep 8, 2020 at 10:16
  • 3
    @SivakrishnaPerla If you can open the project in Xcode 11, then you can see exactly which targets Valid Architectures is used on. You could even clear the setting in Xcode 11, and then try the project again in Xcode 12. If you still need a workaround and you're getting the error on an embedded framework, then SlashDevSlashGnoll's answer should work. If you need a workaround and you're getting the error on a Cocoapod, then exclude the arm64 architecture in the Podfile post install.
    – trishcode
    Sep 8, 2020 at 12:57
  • 2
    @trishcode Thanks, Setting arm64 in excluded architecture and removing VALID_ARCHS worked. Sep 8, 2020 at 13:35
  • 1
    If I remove VALID_ARCHS and add arm64 to Excluded architecture, I get this error - Check dependencies No architectures to compile for (ARCHS=arm64 x86_64, VALID_ARCHS=, EXCLUDED_ARCHS=( arm64 )).
    – nOOb iOS
    Sep 14, 2020 at 16:08
65

Hidden Gem in all these answers

I had changed "Excluded Architectures" in my target for the main project, but not for the PODS project. It is a truly hidden gem. I have been with this problem for weeks now.

Excluding arm64 in PODS PROJECT

5
  • 1
    Will this affect the build in production for some devices? Oct 5, 2021 at 14:51
  • @MohamedAbdou arm64 is used for physical devices, so I assume there might be a conflict when trying to simulate it on a real iPhone. Either way, you could try it as is, and in any case, you remove arm64 as an Excluded Architecture. For actual production and release, I suggest you simulate it successfully on both physical and virtual devices and use those settings for the release.
    – Tomas Ward
    Oct 5, 2021 at 14:55
  • 1
    not perfect answer either, now your project doesn't compile on M1 & simulator, because all pods are excluded Jan 10, 2022 at 14:33
  • Remember to set excluded archs for the project and not the targets so that all targets inherit the excluded archs setting Apr 22, 2022 at 12:14
  • Actually it will given error in production when you test it on real device. It will show error "the developer of this App needs to be update it to work with this version of iOS". This is because as per apple "In iOS 11 and later, all apps use the 64-bit architecture" so if you exclude arm 64 for the main project you will not be able to open the app on real device. So to fix this you just have to exclude the arm64 for simulator only, it will work on all the machines including M1 or M2. Aug 29, 2022 at 8:53
52

Easy fix

  1. Right click on xcode in Applications folder
  2. Get info
  3. Select "Open using Rosetta"

Run.

Xcode get info

6
  • 4
    This was enough for me! Cordova project with many plugins (including Firebase) started getting this error when we moved to the M1 mac.
    – pauloya
    Nov 11, 2021 at 16:24
  • 6
    This is the only answer that works for me on the Apple M1 processor.
    – instanceof
    Dec 12, 2021 at 19:48
  • 1
    This is the only answer works for me on M1 and xCode 13. The other options suggested doesn't even exist in xCode 13.
    – Murilo
    Jan 5, 2022 at 14:04
  • 8
    not great, now you are running Xcode on Rosetta emulator, which means your stuff runs slow Jan 10, 2022 at 14:31
  • This worked for me, but (probably due to my code base) iOS 14 and 15 Simulators were not working. I had to use version 13.5.
    – Klarence
    Aug 16, 2022 at 16:04
47

Xcode 12.3

I solved this problem by setting Validate Workspace to Yes

enter image description here

7
  • Solved my issue. Easiest fix! I'm glad this is resolved, but can someone explain how this fixes the issue? Dec 30, 2020 at 20:21
  • I had the issue with UI Tests and KIF library (it's an Xcode Unit Test using KIF). I tried all the other solutions and nothing worked until I enabled the "Validate Workspace" just for those Unit Tests.. thanks! Feb 1, 2021 at 14:03
  • This is the only solution that worked for me, however it does keep a "Target Integrity" warning in the debugger. Feb 11, 2021 at 16:11
  • 4
    What is it supposed to do? Why does it work? Preferably, update your answer. (But without "Edit:", "Update:", or similar - the answer should appear as if it was written today.) Sep 11, 2021 at 17:31
  • 4
    The option is not showing for me, I'm on xcode 14.0.1
    – Jalil
    Oct 21, 2022 at 17:48
39

After trying and searching different solutions, I think the most safest way is adding the following code at the end of the Podfile

post_install do |pi|
   pi.pods_project.targets.each do |t|
       t.build_configurations.each do |bc|
          bc.build_settings['ARCHS[sdk=iphonesimulator*]'] =  `uname -m`
       end
   end
end

This way you only override the iOS simulator's compiler architecture as your current cpu's architecture. Compared to others, this solution will also work on computers with Apple Silicon.

2
  • 21
    It's great to see someone at least understands the issue and is not suggesting just removing Apple Silicon support for the iOS Simulator.
    – Camsoft
    Dec 26, 2020 at 15:33
  • 1
    For Apple Silicon, it's the only one that works Dec 6, 2021 at 14:22
32

For me the following setting worked:

Build SettingsExcluded Architectures.

I added "arm64" to both Release and Debug mode for the "Any iOS Simulator SDK" option.

Enter image description here

1
  • This fixed my issue with the error: Framework not found Pods_OneSignalNotificationServiceExtension. Was working on the simulator but not the device. Thanks! Jun 2, 2021 at 9:19
26

Go to Targets section, select each target and do the following:

  • Set Build Active Architecture Only to YES
  • Add Excluded Architectures and set its value to arm64 (See attached)
  • Set Active scheme (on toolbar next to project name) to any iOS Simulator
  • Clean Build folder from Product Menu and build.

enter image description here

2
  • Excluding arm64 conflicts with Facebook SDK. It wants arm64, and if arm64 is excluded, it says "Could not find module 'FBSDKCoreKit' for target 'x86_64-apple-ios-simulator'; found: arm64, arm64-apple-ios-simulator" Sep 22, 2021 at 9:45
  • Architecture is not visible in most targets. Why is that? Mar 8, 2022 at 13:19
19

Xcode Version 13.2.1 and macOS Monterey 12.0.1

Almost everybody is facing the same issue with old projects and pods after switching to new M1 chip system.

"in /Users//Desktop/_iOS_app/Pods/iOS/framework/(CLSInternalReport.o), building for iOS Simulator, but linking in object file built for iOS, file '/Users/y/Desktop/_iOS_app/Pods/iOS/.framework/for architecture arm64"

I have come to a solution which is working perfectly.

First thing first, to all the developer who are suggesting exclude arm64 for your project will work yes it will compile but after installation when you try to open it, it will show a popup with the message, "the developer of this App needs to be update it to work with this version of iOS". This is because as per apple "In iOS 11 and later, all apps use the 64-bit architecture" and if you exclude arm64 for your project it will not open App on iOS 11 and later.

App will not open in iOS 11 and later if exclude arm64 and will show this popup

So instead of selecting whole project only excluded architectures for the simulator to arm64.

Steps: On top of project files, Select target > build setting > architecture > excluded architecture. now add select "any iOS simulator SDK" and give it a value arm64.

See the image below for refrence.

only select "any iOS simulator SDK" in excluded architecture instead of excluding it for whole project.

0
19

As of Sep 19, 2022, none of the existing answers worked for me. Most answers suggests to exclude arm64 from build settings, after this is done, it gives fatal error: module map file not found

What worked for me is to open Xcode using Rosseta,

  1. Right click on Xcode in applications folder
  2. Get Info
  3. Check Open using Rosetta
  4. Open Xcode
  5. Open project
  6. Clean build folder
  7. Run project

By opening Xcode using Rosseta, no other build settings or configurations are needed.

References:

1
  • I got this working as of now. There is no need to use Rosetta. It's extremely slow. Add the exclude architecture not just in the application but in the pods as well as stated in one of the replies below. Oct 4, 2022 at 4:07
17

I found that

  1. Using Rosetta (Find Xcode in Finder > Get Info > Open using Rosetta)
  2. Build Active Architecture Only set to YES for everything, in both Project and Target
  3. (You might not need it, read comment below) And including this in the podfile:
post_install do |installer|
  installer.pods_project.targets.each do |target|
    target.build_configurations.each do |config|
      config.build_settings["ONLY_ACTIVE_ARCH"] = "YES"
    end
  end
end

worked for me.

We had both Pods and SPM and they didn't work with any of the combinations of other answers. My colleagues all use Intel MacBooks and everything still works for them too!

2
  • The podfile code might not be necessary. I have found I no longer need it by some magic power when its absence would once make Xcode fail to build. As of today it is no longer in the podfile and everything still works, so FYI. "Build to Active Arch only" is still set to yes for Project and Target (for my Dev builds since that's all I do as I'm not in charge of releases, but I doubt it would break much to use it for Release builds too) Mar 25, 2021 at 10:52
  • 4
    OMG, after 4 hours of digging, your answer solved my issue! I am on a M1 Mac and using CocoaPods and SPM too. I think all above answers are for fixing CocoaPods only, but does not fix issues for SPM. And you are right, I did not actually need your step 3, just first 2 steps and it's all working! Thank you!
    – Daniel Hu
    Apr 24, 2021 at 22:58
17

If you have trouble in Xcode 12 with simulators, not real device, yes you have to remove VALID_ARCHS settings because it's not supported anymore. Go to "builds settings", search "VALID_ARCHS", and remove the user-defined properties. Do it in every target you have.

Still, you may need to add a script at the bottom of your podfile to have pods compiling with the right architecture and deployment target:

post_install do |installer|
  installer.pods_project.targets.each do |target|
    target.build_configurations.each do |config|
      config.build_settings.delete 'IPHONEOS_DEPLOYMENT_TARGET'
      config.build_settings['ONLY_ACTIVE_ARCH'] = 'NO'
     end
  end
end
3
  • 1
    Removing the VALID_ARCHS from my project worked fine. I changed nothing to the podfile nor the pods project. Nov 7, 2020 at 22:24
  • Thanks @ÁngelTéllez worked for me as well. saved my time
    – Ravi
    Mar 3, 2021 at 4:47
  • then any solution for iphone device?
    – famfamfam
    May 26, 2021 at 12:12
16

I solved the problem by adding "arm64" in "Excluded Architectures" for both the project target and pod target.

Xcode → Target ProjectBuild SettingExcluded Architectures → *"arm64"

Xcode → Pod TargetBuild SettingExcluded Architectures → *"arm64"

0
15

After upgrading to Xcode 12 I was still able to build for a real device, but not the simulator. The Podfile build was working only for the real device.

I deleted VALID_ARCHS under Build Settings > User-Defined and it worked! Bashing my head for some time before finding this.

0
14

1.Add arm64 to Build settings -> Exclude Architecture in all the targets.

Xcode ScreenShoot

2.Close Xcode and follow the steps below to open

  1. Right-click on Xcode in Finder
  2. Get Info
  3. Open with Rosetta
1
  • Works, thanks, open with rosetta was the key
    – Denes
    Jul 23, 2021 at 22:28
12

I was having issues building frameworks from the command line. My framework depends on other frameworks that were missing support for ARM-based simulators. I ended up excluding support for ARM-based simulators until I upgrade my dependencies.

I needed the EXCLUDED_ARCHS=arm64 flag when building the framework for simulators from the command line.

xcodebuild archive -project [project] -scheme [scheme] -destination "generic/platform=iOS Simulator" -archivePath "archives/[scheme]-iOS-Simulator" SKIP_INSTALL=NO BUILD_LIBRARY_FOR_DISTRIBUTION=YES EXCLUDED_ARCHS=arm64
1
  • 3
    Same here. Key "problem" in this scenario is actually building for a generic destination via -destination "generic/platform=iOS Simulator". This leads to building for all available architectures, which includes arm64 since Xcode 12.
    – Sascha
    Oct 14, 2020 at 12:14
10

Xcode 12

Removing VALID_ARCH from Build settings under User-Defined group work for me.

enter image description here

2
  • Removing? Do you mean changing its value to something empty'ish? Sep 11, 2021 at 16:46
  • Yeah, Remove it from the build setting. It's worked for me. Sep 13, 2021 at 15:53
8

Preface

When you build an app, you build for a specific platform and CPU Architecture combination.

iOS Platforms:

  • iOS device "generic/platform=iOS"
  • Simulator "generic/platform=iOS Simulator"

CPU Architectures:

  • Arm64
  • X86_64

Will you always be building for one combination?

No. If you're using a Release config, then you'll end up archiving your product for BOTH arm64 and x86_64 architectures.

This is why 'Debug' builds onto your physical devices won't fail, but then when 'Release' config gets used during the archive process (often in your CI/CD) then things will fail because the simulator architectures are selected as well.

The default Xcode settings for this are:

enter image description here

I have an Intel MacBook. If I don't exclude any architecture and platform, what will happen?

  • If you're building a debug config, then it will only build for the CPU architecture of the destination's platform. Meaning:

    • If you're building into your iPhone, you'll just need to support ARM64
    • If you're building into a simulator, you'll just need to support X86_64
  • If you're building a release config, then it will:

    • Build for both platforms and all possible architectures.

I have an M1 MacBook. If I don't exclude any architecture and platform, what will happen?

  • If you're building a debug config, then it will only build for the CPU architecture of the destination's platform. Meaning:

    • If you're building into your iPhone, you'll just need to support ARM64
    • If you're building into a simulator, you'll just need to support ARM64
    • Alternatively you can enable Rosetta for Xcode. In that case if you'r building into a simulator, then you need to support X86_64 as well.
  • If you're building a release config, then will: - Build for both platforms and all possible architectures.

Why is it different for Release builds?

During active development, you want to build things fast. It doesn't make sense for you to actively build architectures you don't need to use. That means if you're building into a device, then you only want to build for that platform-architecture combo. You don't want to build the other combinations.

However if you're releasing it — for others. Then because you don't want to limit/dictate how they build your app, then you have to build for all possible combinations and make sure your framework compiles for all of them.

For an app it may make less sense to make an archive for the simulator platform, however for a framework, your consumer is another developer. That developer will be building your framework into a simulator and into a real device. Hence you need to support both platforms and architectures.

Is CocoaPods the source of the problem?

It depends. If the pod has excluded a certain architecture, and you're trying to build for that architecture, then you have to ask the pod owner to not excluded it.

Otherwise if all of your pods are supporting the given platform/architecture that you're trying to build for, then it's a problem from within the code you you wrote yourself in your host app.

Solution

Update pre-compiled libraries with Apple silicon support

If the library named in the error message is from a vendor, see Update pre-compiled libraries from vendors. If you have source code for the library, rebuild the library as an XCFramework with support for the simulator on Apple silicon. To learn how to build an XCFramework, see Creating a multiplatform binary framework bundle.

Update pre-compiled libraries from vendors

If the library producing the build error is a pre-compiled library from a vendor and you don’t have the source code, contact the vendor for an updated XCFramework supporting Apple silicon. If an update isn’t available from the vendor, temporarily use the EXCLUDED_ARCHS build setting to exclude arm64 for the simulator SDK as shown in the figure below. Do not exclude arm64 for any other SDK.

From Docs

More Questions in regard to the outcome of the solution:

What happens if I exclude ARM64 for the 'iOS Simulator' Platform?

You won't be able to build into M1 simulators directly. You'd have to Use Xcode with Rosetta on M1 then. Which is a hack and is slightly slower.

What happens if I exclude X86 for the 'iOS Simulator' Platform?

You won't be able to build into Intel based simulators. Nor you'd be able to build into a simulator using Rosetta.

What happens if exclude ARM64 for the 'iOS' Platform?

You won't be able to build into physical devices. Nor archive for them. Terrible idea!

So I should exclude architectures?

Strive for your app, including all of its pre-compiled libraries, to always build for the complete set of architectures defined by the default value of the ARCHS build setting. Only use the EXCLUDED_ARCHS build setting on targets where the final released app is not using the target’s functionality on a specific architecture, such as a Mac app that only supports a legacy feature on Intel-based Mac computers. Do not modify the ARCHS build setting to achieve the same result.

Additionally in big teams, some developers may be on an M1, while some others are on older Intel based MacBooks. You never know maybe some day there'd be an M5 Macbook, that will have a distinct architecture. So it's good to be considerate of how you make your project/product/framework compatible for your own devs and its consumers.

Do we have an iOS device with Intel X86_64?

Such a thing doesn't

How do inspect a binary?

lipo -info <path-to-binary>

On the arm64 directory within an xcframework packaging, I see:

Non-fat file: /Users/mfaani/Video.xcframework/ios-arm64/Video.framework/Video is architecture: arm64

For the sims I see:

Architectures in the fat file: /Users/mfaani/Video.xcframework/ios-arm64_x86_64-simulator/Video.framework/Video are: x86_64 arm64 

You can go into your mac's /Applications, right click; 'show Package Contents' for any app; find the app's associated binary. And then inspect it using lipo.

To be clear, a framework or an app can both be inspected with lipo. Similarly if you access the build folder on the simulator, you can inspect the binary as well.

What's the difference between an XCFramework and a FAT binary?

  • A FAT binary, is just a binary — with two (or more) architectures combined into a single binary. It's just named FAT because it's fattened. It's other names are 'multi-architecture binary' or universal binary.
  • An XCFramework is just a structured folder, a wrapper. Nothing more. That has distinct folders per platform. Within each folder there's a binary. That binary can be FAT binary or non-FAT (single architecture).

Also note, a FAT binary can be either a framework or the binary of an app. An XCFramework is just a framework. It's never the app itself.

Does my app get bloated with all the other platforms-architecture combinations I don't need?

XCFramework won't bloat app store submissions, because an archive for the iOS device will just pick up each framework from a directory that's isolated from simulator platform.

However with FAT binaries, given that it was just a single binary, you had to thin/slice the dependencies before submitting to Apple store. Otherwise you'd get the following error:

Unsupported Architecture. Your executable contains unsupported architecture '[x86_64, i386]'."

For more on that and its previous solution, see here

To be perfectly clear, this was an issue in pre-xcode 12. But not every project setup would face this. You'd only face this if you had some pre-compiled dependency from a vendor (who didn't share their source code, but just shared the FAT binary so you can build the app for both device and sim), otherwise if you had access to the source code then your archive wouldn't contain compilations for both architectures. It would only contain binaries for targeted architecture.

Also see this great blog post for about some more details and historical context.

What does the Folder structure of a FAT look like?

It's just a binary. It's not a folder. The binary works for two or more architectures.

What does the Folder structure of an xcframework look like?

ios-arm64
   - binary
ios-arm64_x86_64-simulator
   - (FAT) binary

If an XCFramework is made to work with mac Catalyst then the folder structure would be like:

ios-arm64
    - binary
ios-arm64_x86_64-simulator
    - (FAT) binary
ios-x86_64-maccatalyst
    - binary

For a more comprehensive list of possible platforms. See XCFrameworsk: Demonstration of creating and integrating xcframeworks and their co-op with static libraries and Swift packages

Why doesn't my vendor support ios-arm64-simulator?

It could be for a number of reasons.

  • migration effort: Often it's just that when the compiled they didn't have an M1, and it's been a long time since they've compiled and if they compile they have to make some changes. Like you have to understand it's been years that that there wasn't a need for a new architecture-platform combination. So this is new and not everyone understands it. The fact that Swift is now ABI compatible with its previous versions reduce the need for framework owners to recompile their app with every new Swift release. So they could go on years without the need to recompile...
  • limitation: The pre-compiled library depends on another pre-compiled library which isn't compiled for arm64-sim.
  • The owner of the framework doesn't have an Intel machine. Or the person who knows about those stuff has left the company.

Any last words?

Make sure you look into ALL Project and Target and Pod Project and Pod Target settings. If one of them excludes a certain architecture then you can't build for that architecture. Often this could be in your Podfile.

Or if the pod/framework is being compiled in a totally different repo, then the settings that you have set there, are what matters the most.

If you pay attention to the error message you get, it should be easy to navigate your way to the target that doesn't support.

7

I believe I found the answer. Per the Xcode 12 beta 6 release notes:

"The Build Settings editor no longer includes the Valid Architectures build setting (VALID_ARCHS), and its use is discouraged. Instead, there is a new Excluded Architectures build setting (EXCLUDED_ARCHS). If a project includes VALID_ARCHS, the setting is displayed in the User-Defined section of the Build Settings editor. (15145028)"

I was able to resolve this issue by manually editing the project file (I could not figure out how to remove the item from the project file using Xcode) and removing all lines referring to VALID_ARCHS. After that, I am able to build for the simulator fine.

2
  • 2
    Using Xcode, VALID_ARCHS is in select Project (not Target) then `Build Setting -> User-Defined". select it and delete it.
    – Akshay
    Sep 19, 2020 at 4:58
  • This solution worked for me. The solution suggested by some others didn't work as just adding value 'arm64' to the 'Exclude Architecture' field started giving some 'File Permission' error for the generated .app file. Sep 21, 2020 at 14:53
6

Go to finder -> Applications -> Xcode -> Right click on Xcode -> Select open using rosetta

enter image description here

1
  • While this will allow you to build your project is definitely NOT advisable. You will be running Xcode in an x86 emulated environment. This will likely be much slower and not take advantage of your M1 processor.
    – MobileVet
    May 24, 2022 at 15:20
5

After trying almost every answer to the question and reading through Apple developer forums I found only one solution worked for me.

I am building a universal framework that is consumed in a Swift app. I was unable to build to the simulator without architecture errors.

In my framework project I have a Universal Framework task in my build phases. If this is the case for you:

  • Add the following to your xcodebuild task inside the build phase: EXCLUDED_ARCHS="arm64"

Next you have to change the following project Build Settings:

  • Delete the VALID_ARCHS user defined setting
  • Set ONLY_ACTIVE_ARCH to YES ***

*** If you are developing a framework and have a demo application as well, this setting has to be turned on in both projects.

0
5

I was facing the same issue and trying to launch a React Native app on an M1 Mac. Note that my Intel Mac with the same project worked well without this error.

What solved the problem for me was to force Xcode to open through Rosetta.

To achieve this:

Right click on Xcode in Applications folder* → Get Info → check 'Open using Rosetta' checkbox.

1
5

Xcode 13.2.1, macOS v12 (Monterey), target iOS 14.0, and CocoaPods 1.11.2

I had a similar issue when including LogRocket and/or Plaid -- they are xcframeworks and work fine on my local, but they can't be built on bitrise. I'd tried all answers above:

  • EXCLUDED_ARCHS arm64
  • setting ONLY_ACTIVE_ARCH to YES in Podfile
  • VALIDATE_WORKSPACE to YES
  • setting ARCHS[sdk=iphonesimulator*] to uname -m in Podfile

None of them works.

But by specifying a target iOS version or deleting it would work:

post_install do |installer|
  installer.pods_project.targets.each do |target|
    target.build_configurations.each do |config|
      config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '14.0'
      # OR
      config.build_settings.delete 'IPHONEOS_DEPLOYMENT_TARGET'
    end
  end
end
1
  • Do you know how can we do the same but for SPM? Mar 31, 2022 at 6:34
5

Please, don't forget to clean the build folder after you add arm64 to excluded architecture.

You can do that by going to Menu > Product > Clean Build Folder or simply Command+Shift+K.

2
  • How? By some menu command? By manually deleting files or folders? Can you elaborate? Please respond by editing (changing) your answer, not here in comments (without "Edit:", "Update:", or similar - the answer should appear as if it was written today). Sep 11, 2021 at 17:35
  • @PeterMortensen Menu > Product > Clean Build Folder (Xcode 13.4.1)
    – mdehghani
    Sep 4, 2022 at 13:55
4

Updates: Oct 2020

You can simply set arm64 only for Debug > Simulator - iOS 14.O SDK under Excluded Architecture.

enter image description here

2
  • 7
    Are you sure? Doesn't this mean it won't actually run on a machine with Apple Silicon? Feb 24, 2021 at 4:28
  • On Apple Silicon it will try to build and run with Rosetta if arm64 is excluded
    – Legonaftik
    Mar 9, 2022 at 2:25
4

I was also experiencing the same issue with specific library that was installed through carthage. For those who are using Carthage, as Carthage doesn't work out of the box with Xcode 12, this document will guide through a workaround that works for most cases. Well, shortly, Carthage builds fat frameworks, which means that the framework contains binaries for all supported architectures. Until Apple Sillicon was introduced it all worked just fine, but now there is a conflict as there are duplicate architectures (arm64 for devices and arm64 for simulator). This means that Carthage cannot link architecture specific frameworks to a single fat framework.

You can follow the instruction here. Carthage XCODE 12

Then after you configure the Carthage. Put the arm64 in the "Excluded Architectures" on build settings. enter image description here

Try to run your project using simulator. Simulator should run without any errors.

0
4

In your xxx.framework podspec file, add the following configuration. Avoid a pod package that contains arm64 simulator architectures.

s.pod_target_xcconfig = { 'EXCLUDED_ARCHS[sdk=iphonesimulator*]' => 'arm64' }
s.user_target_xcconfig = { 'EXCLUDED_ARCHS[sdk=iphonesimulator*]' => 'arm64' }
7
  • It worked! However this means that the Pod cannot be used in Apple Silicon based Macs?
    – tomacco
    Sep 30, 2020 at 6:26
  • Is it confirmed @tomacco? Oct 1, 2020 at 17:02
  • 2
    @FernandoReynoso I have just received an Developer Transition Kit, (ARM MacMini) will test and report later today
    – tomacco
    Oct 2, 2020 at 10:50
  • @tomacco Have you been able to test it?
    – Houman
    Oct 14, 2020 at 13:48
  • If multiple pod specs use user_target_xcconfig and the values don't match exactly, CocoaPods will emit warnings like this [!] Can't merge user_target_xcconfig for pod targets: [... list of pods ...]. Singular build setting EXCLUDED_ARCHS[sdk=<...>] has different values. The podspec syntax reference says this attribute is "not recommended" guides.cocoapods.org/syntax/podspec.html#user_target_xcconfig. So please don't use user_target_xcconfig for this to save many developers the trouble. Oct 16, 2020 at 7:11

Not the answer you're looking for? Browse other questions tagged or ask your own question.