• In the add-to-app podhelper.rb ruby script file require (import) the Flutter SDK flutter_tools/bin/podhelper.rb version of this file to push as much logic as possible into the SDK instead of the module project, and allow sharing logic between these scripts.

• Introduce a new flutter_post_install method to the add-to-app podhelper.rb ruby script file. This calls the existing flutter_additional_ios_build_settings method in the SDK podhelper.rb

  flutter/packages/flutter_tools/bin/podhelper.rb

  Line 33 in ae805de

  def flutter_additional_ios_build_settings(target)

  
  This will update the host app Flutter plugin build settings to:

  1. Link against the right version of the Flutter.framework (simulator, debug, etc) in the artifacts cache, see Move Flutter.framework to build directory instead of ios/Flutter #70224. This will fix Flutter module with plugins requires "flutter build ios" in the module before being able to build for the simulator in host app #75296 since the plugin is now linking directly against the correct artifacts version instead of the last engine variant copied into the module project.

  2. Set EXCLUDED_ARCHS[sdk=iphonesimulator*] = $(inherited) i386 (Support iOS arm64 simulator #85642) and EXCLUDED_ARCHS[sdk=iphoneos*]= $(inherited) armv7 (Do not build for iOS armv7 #97341). This means Flutter plugins will not build for 32-bit armv7 iOS, unblocking Exclude arm7v from iOS architectures when building add-to-app plugins in host app with CocoaPods #101793

  3. Set ONLY_ACTIVE_ARCH = NO for plugins in debug mode. This means both arm64 and x86_64 simulator versions of the plugins will be built, so if a plugin doesn't support the arm64 simulators, the app can link against the x64 version of the plugins Build Flutter iOS plugins with all valid architectures #95293

• Add a fatal Ruby exception to fire on pod install that will instruct the user to add the following to their host app Podfile if it's missing:

post_install do |installer|
  flutter_post_install(installer)
end

Error looks like:

$ pod install
Add `flutter_post_install(installer)` to your Podfile `post_install` block to build Flutter plugins:

post_install do |installer|
  flutter_post_install(installer)
end

[!] Invalid `Podfile` file: Missing `flutter_post_install(installer)` in Podfile `post_install` block.

 #  from /Users/magder/Projects/samples/add_to_app/plugin/ios_using_plugin/Podfile:12
 #  -------------------------------------------
 #    # Pods for IOSUsingPlugin
 >    install_all_flutter_pods(flutter_application_path)
 #
 #  -------------------------------------------

Fixes #101793
Fixes #75296
Fixes #78368
Unblocks #101793

Samples update: flutter/samples#1079
Website update: flutter/website#7032

Pre-launch Checklist

• I read the Contributor Guide and followed the process outlined there for submitting PRs.
• I read the Tree Hygiene wiki page, which explains my responsibilities.
• I read and followed the Flutter Style Guide, including Features we expect every widget to implement.
• I signed the CLA.
• I listed at least one issue that this PR fixes in the description above.
• I updated/added relevant documentation (doc comments with ///).
• I added new tests to check the change I am making, or this PR is test-exempt.
• All existing and new tests are passing.

If you need help, consider asking for advice on the #hackers-new channel on Discord.