Skip to content

Embed Flutter and App frameworks for add-to-app on iOS#102538

Merged
fluttergithubbot merged 1 commit intoflutter:masterfrom
jmagman:add-to-app-embed
May 2, 2022
Merged

Embed Flutter and App frameworks for add-to-app on iOS#102538
fluttergithubbot merged 1 commit intoflutter:masterfrom
jmagman:add-to-app-embed

Conversation

@jmagman
Copy link
Member

@jmagman jmagman commented Apr 25, 2022 •
edited
Loading

Previously, the iOS Flutter module copied the Flutter.xcframework and created a dummy version of App.framework in the the ephemeral .ios directory, as well as two corresponding podspecs that pointed at these frameworks. On every compilation of the host app, flutter assemble would create the real App.framework and copy the right Flutter.framework variant into the Xcode BUILT_PRODUCTS_DIR. On the first build, CocoaPods would then copy/re-codesign/re-strip the frameworks and embed them into the app.

However, since flutter assemble updates the frameworks in BUILT_PRODUCTS_DIR and not the dummy frameworks in the ephemeral directory, on incremental builds CocoaPods would not run its copy script because the timestamp of the dummy ephemeral frameworks did not change. So the compiled dart code embedded in the app would not be updated, and would be stale until a hot reload.

  1. Stop creating the dummy ephemeral directory frameworks so CocoaPods can find them. Instead, use the existing tool podhelper scripts that embed the frameworks into the app. assemble already codesigns, bitcode strips, and debug symbol strips the frameworks, so all that's left it to rsync them to the right place in the app.
  2. Deduplicate engine/plugins logic in the add-to-app podhelper.rb ruby script to use 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.
  3. Update the SDK ruby script to use relative paths in places where it had assumed relative location from the Podfile (since now it's being called from host apps, which are located outside the Flutter module).

Fixes #101979
Probably would have resolved parts of #94481
Follow-up to #101943

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.

@jmagman jmagman added platform-ios iOS applications specifically tool Affects the "flutter" command-line tool. See also t: labels. a: existing-apps Integration with existing apps via the add-to-app flow labels Apr 25, 2022
@jmagman jmagman self-assigned this Apr 25, 2022
@flutter-dashboard flutter-dashboard bot added the c: contributor-productivity Team-specific productivity, code health, technical debt. label Apr 25, 2022
@jmagman jmagman force-pushed the add-to-app-embed branch 3 times, most recently from 86d0d33 to 2b32a72 Compare April 26, 2022 00:32
jmagman
jmagman commented Apr 26, 2022
View reviewed changes
dev/devicelab/bin/tasks/module_test_ios.dart Outdated
Copy link
Member Author

@jmagman jmagman Apr 26, 2022

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

.ios/Flutter/engine no longer exists

packages/flutter_tools/bin/podhelper.rb Outdated
Copy link
Member Author

@jmagman jmagman Apr 26, 2022 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is now called from the host app Podfile script, and the fake podspec is in the Flutter module, so don't assume they are sibling paths.

packages/flutter_tools/bin/xcode_backend.dart Outdated
Copy link
Member Author

@jmagman jmagman Apr 26, 2022

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This comment is already in parseFlutterBuildMode we don't need it twice.

packages/flutter_tools/templates/module/ios/library/Flutter.tmpl/podhelper.rb.tmpl Outdated
Copy link
Member Author

@jmagman jmagman Apr 26, 2022

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Instead of duplicating logic, call the ruby script in the tool

flutter/packages/flutter_tools/bin/podhelper.rb

Line 159 in aa5d7b6

def flutter_install_ios_engine_pod(ios_application_path = nil)

packages/flutter_tools/templates/module/ios/library/Flutter.tmpl/podhelper.rb.tmpl Outdated
Copy link
Member Author

@jmagman jmagman Apr 26, 2022

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Remove duplicated logic, call

flutter/packages/flutter_tools/bin/podhelper.rb

Line 238 in aa5d7b6

def flutter_install_plugin_pods(application_path = nil, relative_symlink_dir, platform)

packages/flutter_tools/templates/module/ios/library/Flutter.tmpl/podhelper.rb.tmpl Outdated
Copy link
Member Author

@jmagman jmagman Apr 26, 2022

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Stop making the dummy App.framework in the ephemeral module directory.
🐮

packages/flutter_tools/templates/module/ios/library/Flutter.tmpl/podhelper.rb.tmpl Outdated
Copy link
Member Author

@jmagman jmagman Apr 26, 2022

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Stop copying the engine into the module ephemeral directory. Let the tool handle copying the right version where it needs to go when assemble is called.

packages/flutter_tools/templates/module/ios/library/Flutter.tmpl/podhelper.rb.tmpl Outdated
Copy link
Member Author

@jmagman jmagman Apr 26, 2022 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Instead of letting CocoaPods copy/re-codesign/strip the frameworks from the ephemeral directory, instead let the tool copy it via embed_and_thin after the rest of the app has compiled. The tool already codesigned/stripped it during assemble.

Note this is the only real added logic to this PR, everything else is deletions or slight refactoring.

@jmagman jmagman marked this pull request as ready for review April 26, 2022 01:09
cyanglaz
cyanglaz approved these changes Apr 26, 2022
View reviewed changes
Copy link
Contributor

@cyanglaz cyanglaz left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@jmagman
Copy link
Member Author

jmagman commented Apr 30, 2022

friendly ping @christopherfujino

christopherfujino
christopherfujino approved these changes Apr 30, 2022
View reviewed changes
Copy link
Contributor

@christopherfujino christopherfujino left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sorry, thought I approved this, LGTM

@fluttergithubbot fluttergithubbot merged commit 36be63b into flutter:master May 2, 2022
@engine-flutter-autoroll engine-flutter-autoroll mentioned this pull request May 2, 2022
Merged
engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request May 2, 2022
@engine-flutter-autoroll
36be63b Embed Flutter and App frameworks for add-to-app on iOS (flutt…
7138e59 
…er/flutter#102538)
@jmagman jmagman deleted the add-to-app-embed branch May 2, 2022 17:48
@engine-flutter-autoroll engine-flutter-autoroll mentioned this pull request May 2, 2022
Merged
engine-flutter-autoroll added a commit to engine-flutter-autoroll/plugins that referenced this pull request May 2, 2022
@engine-flutter-autoroll
36be63b Embed Flutter and App frameworks for add-to-app on iOS (flutt…
469ea73 
…er/flutter#102538)
egramond pushed a commit to egramond/flutter that referenced this pull request May 5, 2022
@jmagman @egramond
Embed Flutter and App frameworks for add-to-app on iOS (flutter#102538)
fc76b78
@jmagman jmagman mentioned this pull request May 9, 2022
Closed
@ahmdmau ahmdmau mentioned this pull request Jan 31, 2023
Open
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

2 more reviewers

@cyanglaz cyanglaz cyanglaz approved these changes

@christopherfujino christopherfujino christopherfujino approved these changes

Reviewers whose approvals may not affect merge requirements

Assignees

@jmagman jmagman

Labels

a: existing-apps Integration with existing apps via the add-to-app flow c: contributor-productivity Team-specific productivity, code health, technical debt. platform-ios iOS applications specifically tool Affects the "flutter" command-line tool. See also t: labels.

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

[iOS]Flutter which is integrated into iOS projects as a Flutter Module, does not take effect when the code is modified.

4 participants

@jmagman @cyanglaz @christopherfujino @fluttergithubbot