From 59bd627c910a82e7566c247a981082bad4cb7730 Mon Sep 17 00:00:00 2001 From: amitthacker Date: Mon, 2 Nov 2026 15:32:07 +0530 Subject: [PATCH 1/2] Docs: stop telling Flutter developers to exclude arm64 from the iOS simulator build Four Flutter setup pages carried a Podfile line setting EXCLUDED_ARCHS for the iPhone simulator to 'arm64 i386', and a Warning below it telling Apple Silicon readers to narrow that to 'i386'. So each page held both the wrong instruction and its correction, with the wrong one in the copyable code block. On an Apple Silicon Mac the simulator runs on arm64, so a reader who copied the block removed the only architecture the simulator can use and the build stopped working. Narrowing to 'i386' would not have been right either, so the line is removed and the Podfile step with it. For each page I followed the dependency the page itself tells the reader to install, down to the iOS framework it resolves to, and read that XCFramework's own Info.plist. All three generations ship an arm64 simulator library: sdk/flutter/setup.mdx cometchat_sdk ^5.0.8 (5.0.9) -> CometChatSDK 4.1.0 ios-arm64_x86_64-simulator, archs [arm64, x86_64] sdk/flutter/v4/setup.mdx cometchat_sdk ^4.0.33 -> CometChatSDK 4.0.73 ios-arm64_x86_64-simulator, archs [arm64, x86_64] sdk/flutter/3.0/overview.mdx, sdk/flutter/3.0/setup.mdx cometchat: any (3.0.13) -> CometChatPro 3.0.920 ios-arm64_x86_64-simulator, archs [arm64, x86_64] The i386 half of the setting is inert. No supported Xcode builds an i386 simulator slice, and each of these three plugin versions already sets EXCLUDED_ARCHS to 'i386' in its own podspec, so the reader never needed to write it. The Podfile block held nothing but that line plus Flutter's own default post_install boilerplate, so the whole step goes and the steps after it are renumbered. Each Warning is replaced by a Note telling anyone who already followed the old page to take the exclusion out of their Podfile, since they are the readers who are actually broken. iOS calling pages are deliberately untouched and under separate review. Co-Authored-By: Claude Opus 5 --- sdk/flutter/3.0/overview.mdx | 39 ++++++--------------------------- sdk/flutter/3.0/setup.mdx | 42 ++++++------------------------------ sdk/flutter/setup.mdx | 42 ++++++------------------------------ sdk/flutter/v4/setup.mdx | 40 ++++++---------------------------- 4 files changed, 27 insertions(+), 136 deletions(-) diff --git a/sdk/flutter/3.0/overview.mdx b/sdk/flutter/3.0/overview.mdx index c3123cff7..6a6c535be 100644 --- a/sdk/flutter/3.0/overview.mdx +++ b/sdk/flutter/3.0/overview.mdx @@ -50,42 +50,15 @@ cometchat: any 2. For iOS change iOS deployment target to 11 or higher. -3. Add the following code to podfile inside iOS section of your app. - - -```rb -post_install do |installer| - -installer.pods_project.targets.each do |target| - -flutter_additional_ios_build_settings(target) - -//Copy from here-------> - -target.build_configurations.each do |build_configuration| - -build_configuration.build_settings['EXCLUDED_ARCHS[sdk=iphonesimulator*]'] = 'arm64 i386' - -end - -//Copy TILL here-------> - -end - -end -``` - - - - + +**Upgrading an existing app? Remove any `arm64` exclusion from your Podfile.** - -**Apple Silicon (M1/M2/M3) users:** Excluding `arm64` from the simulator build prevents the app from running natively on Apple Silicon Macs. If you are developing on an Apple Silicon Mac, consider excluding only `i386` instead of `arm64 i386` to enable native simulator builds. - +An earlier version of this page asked you to set `EXCLUDED_ARCHS[sdk=iphonesimulator*]` to `arm64 i386`. On an Apple Silicon Mac the iPhone simulator runs on arm64, so that setting stops your app building for the simulator. The CometChat SDK ships a simulator build for arm64, so there is nothing to exclude. The `cometchat` plugin already excludes `i386` on its own, so no Podfile change is needed here. + -4. For iOS navigate to your iOS folder in terminal or CMD and do `pod install` . For apple chip system use rosetta terminal. -5. import CometChat SDK using the following code in dart. +3. For iOS navigate to your iOS folder in terminal or CMD and do `pod install` . For apple chip system use rosetta terminal. +4. import CometChat SDK using the following code in dart. diff --git a/sdk/flutter/3.0/setup.mdx b/sdk/flutter/3.0/setup.mdx index 9a9deb717..861cc16b3 100644 --- a/sdk/flutter/3.0/setup.mdx +++ b/sdk/flutter/3.0/setup.mdx @@ -36,43 +36,15 @@ cometchat: any -2. Add following code to podfile inside iOS section of your app - - - -```rb -post_install do |installer| - -installer.pods_project.targets.each do |target| - -flutter_additional_ios_build_settings(target) - -//Copy from here-------> - -target.build_configurations.each do |build_configuration| - -build_configuration.build_settings['EXCLUDED_ARCHS[sdk=iphonesimulator*]'] = 'arm64 i386' - -end - -//Copy TILL here-------> - -end - -end -``` - - - + +**Upgrading an existing app? Remove any `arm64` exclusion from your Podfile.** - -**Apple Silicon (M1/M2/M3) users:** Excluding `arm64` from the simulator build prevents the app from running natively on Apple Silicon Macs. If you are developing on an Apple Silicon Mac, consider excluding only `i386` instead of `arm64 i386` to enable native simulator builds. - - +An earlier version of this page asked you to set `EXCLUDED_ARCHS[sdk=iphonesimulator*]` to `arm64 i386`. On an Apple Silicon Mac the iPhone simulator runs on arm64, so that setting stops your app building for the simulator. The CometChat SDK ships a simulator build for arm64, so there is nothing to exclude. The `cometchat` plugin already excludes `i386` on its own, so no Podfile change is needed here. + -3. For iOS, change the deployment target to `11` or higher. -4. For iOS, navigate to your iOS folder in terminal or CMD and do `pod install` . For apple chip system use rosetta terminal. -5. For iOS you can set the Enabled Bitcode settings to **NO** present in build settings of XCODE project +2. For iOS, change the deployment target to `11` or higher. +3. For iOS, navigate to your iOS folder in terminal or CMD and do `pod install` . For apple chip system use rosetta terminal. +4. For iOS you can set the Enabled Bitcode settings to **NO** present in build settings of XCODE project diff --git a/sdk/flutter/setup.mdx b/sdk/flutter/setup.mdx index a666f1012..1f04ad9fb 100644 --- a/sdk/flutter/setup.mdx +++ b/sdk/flutter/setup.mdx @@ -54,43 +54,15 @@ flutter pub get If you're migrating an existing app from CometChat SDK v4, check out the [Upgrading from v4](/sdk/flutter/upgrading-from-v4-guide) guide for breaking changes, deprecated methods, and migration instructions. -2. Add following code to podfile inside iOS section of your app - - - -```ruby -post_install do |installer| - -installer.pods_project.targets.each do |target| - -flutter_additional_ios_build_settings(target) - -//Copy from here-------> - -target.build_configurations.each do |build_configuration| - -build_configuration.build_settings['EXCLUDED_ARCHS[sdk=iphonesimulator*]'] = 'arm64 i386' - -end - -//Copy TILL here-------> - -end - -end -``` - - - - + +**Upgrading an existing app? Remove any `arm64` exclusion from your Podfile.** - -**Apple Silicon (M1/M2/M3) users:** Excluding `arm64` from the simulator build prevents the app from running natively on Apple Silicon Macs. If you are developing on an Apple Silicon Mac, consider excluding only `i386` instead of `arm64 i386` to enable native simulator builds. - +An earlier version of this page asked you to set `EXCLUDED_ARCHS[sdk=iphonesimulator*]` to `arm64 i386`. On an Apple Silicon Mac the iPhone simulator runs on arm64, so that setting stops your app building for the simulator. The CometChat SDK ships a simulator build for arm64, so there is nothing to exclude. The `cometchat_sdk` plugin already excludes `i386` on its own, so no Podfile change is needed here. + -3. For iOS, change the deployment target to `13` or higher. -4. For iOS, navigate to your iOS folder in terminal or CMD and do `pod install` . For apple chip system use rosetta terminal. -5. For iOS you can set the Enabled Bitcode settings to **NO** present in build settings of XCODE project +2. For iOS, change the deployment target to `13` or higher. +3. For iOS, navigate to your iOS folder in terminal or CMD and do `pod install` . For apple chip system use rosetta terminal. +4. For iOS you can set the Enabled Bitcode settings to **NO** present in build settings of XCODE project diff --git a/sdk/flutter/v4/setup.mdx b/sdk/flutter/v4/setup.mdx index 877c9e0e6..442028832 100644 --- a/sdk/flutter/v4/setup.mdx +++ b/sdk/flutter/v4/setup.mdx @@ -69,41 +69,15 @@ cometchat_sdk: ^4.0.33 ### iOS Setup -1. Add the following to your Podfile inside the iOS section of your app: + +**Upgrading an existing app? Remove any `arm64` exclusion from your Podfile.** - - -```ruby -post_install do |installer| - -installer.pods_project.targets.each do |target| - -flutter_additional_ios_build_settings(target) - -//Copy from here-------> - -target.build_configurations.each do |build_configuration| - -build_configuration.build_settings['EXCLUDED_ARCHS[sdk=iphonesimulator*]'] = 'arm64 i386' - -end - -//Copy TILL here-------> - -end - -end -``` - - - - -**Apple Silicon (M1/M2/M3) users:** Excluding `arm64` from the simulator build prevents the app from running natively on Apple Silicon Macs. If you are developing on an Apple Silicon Mac, consider excluding only `i386` instead of `arm64 i386` to enable native simulator builds. - +An earlier version of this page asked you to set `EXCLUDED_ARCHS[sdk=iphonesimulator*]` to `arm64 i386`. On an Apple Silicon Mac the iPhone simulator runs on arm64, so that setting stops your app building for the simulator. The CometChat SDK ships a simulator build for arm64, so there is nothing to exclude. The `cometchat_sdk` plugin already excludes `i386` on its own, so no Podfile change is needed here. + -2. Change the deployment target to `11` or higher. -3. Navigate to your iOS folder in terminal and run `pod install`. For Apple Silicon systems, use a Rosetta terminal. -4. Set **Enabled Bitcode** to **NO** in the Build Settings of your Xcode project. +1. Change the deployment target to `11` or higher. +2. Navigate to your iOS folder in terminal and run `pod install`. For Apple Silicon systems, use a Rosetta terminal. +3. Set **Enabled Bitcode** to **NO** in the Build Settings of your Xcode project. From 275231cac7d0964130c80dd2ea325784a4d8af79 Mon Sep 17 00:00:00 2001 From: amitthacker Date: Tue, 17 Nov 2026 16:18:12 +0530 Subject: [PATCH 2/2] Docs: drop the arm64 simulator exclusion from the React Native v4 call page The last page still setting EXCLUDED_ARCHS to 'arm64 i386' in a build snippet. On an Apple Silicon Mac the iPhone simulator runs arm64, so the setting stops the app building for the simulator. The exclusion line is gone and the Apple Silicon warning underneath it, which told the reader to exclude only i386, is replaced by a note for anyone upgrading an existing app. The note does not repeat the claim about the plugin excluding i386 on its own, which is unverified. The two other React Native pages that carried this line, calling-integration and call-features, were rewritten on main and no longer have it. Co-Authored-By: Claude Opus 5 --- ui-kit/react-native/v4/call-features.mdx | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/ui-kit/react-native/v4/call-features.mdx b/ui-kit/react-native/v4/call-features.mdx index 4973a64b7..6091bb91a 100644 --- a/ui-kit/react-native/v4/call-features.mdx +++ b/ui-kit/react-native/v4/call-features.mdx @@ -132,7 +132,6 @@ post_install do |installer| build_configuration.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '12.0' - build_configuration.build_settings['EXCLUDED_ARCHS[sdk=iphonesimulator*]'] = 'arm64 i386' build_configuration.build_settings['ENABLE_BITCODE'] = 'NO' end end @@ -143,9 +142,11 @@ end - -**Apple Silicon (M1/M2/M3) users:** Excluding `arm64` from the simulator build prevents the app from running natively on Apple Silicon Macs. If you are developing on an Apple Silicon Mac, consider excluding only `i386` instead of `arm64 i386` to enable native simulator builds. - + +**Upgrading an existing app? Remove any `arm64` exclusion from your Podfile.** + +An earlier version of this page asked you to set `EXCLUDED_ARCHS[sdk=iphonesimulator*]` to `arm64 i386`. On an Apple Silicon Mac the iPhone simulator runs on arm64, so that setting stops your app building for the simulator. + ## Add the Call Listeners