Guide users when multiple Xcode projects are present by markst · Pull Request #188934 · flutter/flutter

markst · 2026-07-03T02:35:43Z

Addresses the failure reported in #183747 (comment) and #78839.

When an iOS or macOS platform directory contains multiple .xcodeproj files, xcodebuild commands that do not specify -project fail with exit code 78. Automatically selecting one is unsafe because Flutter supports renamed host projects and the existing project lookup would otherwise choose the first match.

Following review feedback, this change keeps the existing project-selection behavior and instead provides a guided error explaining that additional Xcode projects should be moved into subdirectories, where they no longer conflict with host app project discovery.

Summary

Recognize exit code 78 from xcodebuild -list and confirm that the platform directory contains multiple .xcodeproj files
Detect the same ambiguous layout when Swift Package Manager dependency resolution fails
Name the projects found and guide users to move additional projects into a subdirectory, such as ios/Something/Foo.xcodeproj
Preserve support for renamed host projects rather than assuming Runner.xcodeproj

Test plan

flutter test packages/flutter_tools/test/general.shard/ios/xcodeproj_test.dart --name "getInfo"
flutter test packages/flutter_tools/test/general.shard/xcode_project_test.dart --name "prefetchSwiftPackages"
dart analyze packages/flutter_tools
dart format --output=none --set-exit-if-changed for all changed files

google-cla · 2026-07-03T02:35:59Z

Thanks for your pull request! It looks like this may be your first contribution to a Google open source project. Before we can look at your pull request, you'll need to sign a Contributor License Agreement (CLA).

View this failed invocation of the CLA check for more information.

For the most up to date status, view the checks section at the bottom of the pull request.

gemini-code-assist

Code Review

This pull request updates the Flutter tools to explicitly pass the -project argument with the absolute path of the Xcode project when running xcodebuild -list and -resolvePackageDependencies. It also updates the logic for finding the Xcode project directory to prefer the default host app name (e.g., Runner) when multiple projects exist. The feedback suggests caching entity.basename in a local variable to simplify the directory search loop, and moving the early return check in prefetchSwiftPackages before the command list construction to avoid redundant allocations.

Swift package prefetch and xcodebuild -list failed when ios/ contained more than one .xcodeproj because no project was specified. Prefer Runner when resolving the host project name.

Cache entity basename in the project lookup loop and check for an in-progress Swift package fetch before building the xcodebuild command.

`xcodebuild` cannot pick a project when the platform directory contains more than one `.xcodeproj` and no `-project` is passed, so it exits with code 78. That previously surfaced as an opaque crash. Treat 78 as a recognised failure and, after confirming on disk that more than one `.xcodeproj` is present, tool exit with a message that names the projects found and explains that the extra ones belong in a subdirectory, where they no longer interfere with the host app project lookup.

vashworth · 2026-07-31T19:37:58Z

+    'Flutter identifies the host app by looking for a single .xcodeproj directly within '
+    '$platformDirectory/, so xcodebuild is unable to determine which project to use.\n'
+    'Move the additional Xcode project(s) into a subdirectory, such as '
+    '$platformDirectory/Something/Foo.xcodeproj, and update any references to them.',


Suggested change

'Flutter identifies the host app by looking for a single .xcodeproj directly within '

'$platformDirectory/, so xcodebuild is unable to determine which project to use.\n'

'Move the additional Xcode project(s) into a subdirectory, such as '

'$platformDirectory/Something/Foo.xcodeproj, and update any references to them.',

"Only the Flutter application's .xcodeproj (usually named Runner.xcodeproj) is allowed directly within $platformDirectory/.\n"

'Move any additional .xcodeproj directories into a subdirectory, such as '

'$platformDirectory/Foo/Foo.xcodeproj, and update any references to them.',

vashworth · 2026-07-31T19:42:53Z

        await _swiftPackageFetchStderrSubscription?.cancel();
      });
      if (exitCode != 0) {
+        throwToolExitIfMultipleXcodeProjects(hostAppRoot);


Why is this here? We shouldn't throw here indiscriminately, we should check if it's failing due to the expected reason

github-actions · 2026-09-03T22:15:55Z

This pull request is being closed because it has not been updated in the last 21 days after a request for more information.

If you are still working on this, please feel free to reopen it or file a new pull request.

Thanks for your contribution.

markst requested review from a team as code owners July 3, 2026 02:35

github-actions Bot added platform-ios iOS applications specifically tool Affects the "flutter" command-line tool. See also t: labels. team-ios Owned by iOS platform team team-macos Owned by the macOS platform team labels Jul 3, 2026

markst mentioned this pull request Jul 3, 2026

Warn about slow SwiftPM downloads and centralize SwiftPM cache #183747

Merged

10 tasks done

markst force-pushed the fix-xcodebuild-multi-xcodeproj branch from 5de53b4 to 2d5bca4 Compare July 3, 2026 02:41

gemini-code-assist Bot reviewed Jul 3, 2026

View reviewed changes

Comment thread packages/flutter_tools/lib/src/xcode_project.dart Outdated

Comment thread packages/flutter_tools/lib/src/xcode_project.dart Outdated

hellohuanlin requested a review from vashworth July 9, 2026 21:44

vashworth reviewed Jul 22, 2026

View reviewed changes

Comment thread packages/flutter_tools/lib/src/ios/xcodeproj.dart Outdated

LongCatIsLooong added the waiting for response The Flutter team cannot make further progress on this issue until the original reporter responds label Jul 23, 2026

markst added 2 commits July 30, 2026 12:29

Pass -project to xcodebuild when multiple .xcodeproj exist

1041671

Swift package prefetch and xcodebuild -list failed when ios/ contained more than one .xcodeproj because no project was specified. Prefer Runner when resolving the host project name.

Address review feedback for multi-xcodeproj fix

e6d0b66

Cache entity basename in the project lookup loop and check for an in-progress Swift package fetch before building the xcodebuild command.

markst force-pushed the fix-xcodebuild-multi-xcodeproj branch from 84d1d59 to 5620e9a Compare July 30, 2026 02:31

markst changed the title ~~Pass -project to xcodebuild when multiple .xcodeproj exist~~ Guide users when multiple Xcode projects are present Jul 30, 2026

markst force-pushed the fix-xcodebuild-multi-xcodeproj branch from 5620e9a to 843e6dc Compare July 30, 2026 03:16

markst force-pushed the fix-xcodebuild-multi-xcodeproj branch from 843e6dc to a69ae6c Compare July 30, 2026 03:18

github-actions Bot removed the waiting for response The Flutter team cannot make further progress on this issue until the original reporter responds label Jul 30, 2026

vashworth reviewed Jul 31, 2026

View reviewed changes

vashworth added the waiting for response The Flutter team cannot make further progress on this issue until the original reporter responds label Aug 13, 2026

github-actions Bot closed this Sep 3, 2026

Navigation Menu

Repository navigation

Guide users when multiple Xcode projects are present - #188934

Guide users when multiple Xcode projects are present#188934
markst wants to merge 3 commits into
flutter:masterfrom
markst:fix-xcodebuild-multi-xcodeproj

markst commented Jul 3, 2026 •

edited

Loading

Uh oh!

google-cla Bot commented Jul 3, 2026

Uh oh!

gemini-code-assist Bot left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

vashworth Jul 31, 2026

Uh oh!

vashworth Jul 31, 2026

Uh oh!

github-actions Bot commented Sep 3, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

markst commented Jul 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Test plan

Uh oh!

google-cla Bot commented Jul 3, 2026

Uh oh!

gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

Code Review

Uh oh!

Uh oh!

Uh oh!

Uh oh!

vashworth Jul 31, 2026

Choose a reason for hiding this comment

Uh oh!

vashworth Jul 31, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot commented Sep 3, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

markst commented Jul 3, 2026 •

edited

Loading