[iOS] Clarify provisioning profile error instructions by mozammal-hossain · Pull Request #184051 · flutter/flutter

mozammal-hossain · 2026-03-24T07:47:48Z

What is this PR changing or adding, and why?

This PR improves the iOS provisioning profile/code-signing failure message in flutter_tools to make the cause and remediation steps clearer.

Previously, the output used generic wording and limited guidance.
Now, the message explicitly states that code signing failed and provides concrete, ordered steps in Xcode to resolve team/account/bundle-identifier configuration issues. This should reduce confusion and speed up troubleshooting when running on physical iOS devices.

Fixes #167595.

What changed

Replaced the generic provisioning-profile failure text with clearer messaging:
- Error: could not code sign the application.
Added step-by-step remediation guidance:
1. Open ios/Runner.xcworkspace
2. Check Runner > Signing & Capabilities (Team + Bundle Identifier)
3. Verify Apple account in Xcode Settings > Accounts
4. Run Product > Build and fix reported signing issues
Updated hermetic tests to assert the new error/help text in:
- build_ios_test.dart
- build_ipa_test.dart

If you had to change anything in the flutter/tests repo

No changes were made in the flutter/tests repo.

Pre-launch Checklist

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

….com/mozammal-hossain/flutter into fix/167595-ios-signing-error-message * 'fix/167595-ios-signing-error-message' of https://github.com/mozammal-hossain/flutter: [iOS] Clarify provisioning profile error instructions Roll Dart SDK from 788e347194a6 to f504293598f2 (1 revision) (flutter#184048) Roll Skia from fb6acef456ea to 62841a512deb (2 revisions) (flutter#184046) [Slider] Remove value indicator painter when animation is dismissed (flutter#182991) Manual roll ICU from 7971660ba630 to ee5f27adc28b (1 revision) (flutter#184041) Add scrollPadding property to DropdownMenu (flutter#183109) Roll pub packages (flutter#183895) Roll Skia from c2b58922e37d to fb6acef456ea (1 revision) (flutter#184033) Roll Dart SDK from b172bea4f008 to 788e347194a6 (2 revisions) (flutter#184035) chore: deflake Linux_android_emu android_display_cutout (flutter#183522) Add note about gclient sync network failures and workaround (flutter#183794) Roll Skia from a81bf411a5cb to c2b58922e37d (3 revisions) (flutter#184016) refactor(web): use positive logic and platform defaults for accessibility features (flutter#183907) [android][a11y] set "android.widget.ProgressBar" according to semantics role (flutter#183897) Add progress bar to artifact downloads (flutter#182836) Add windows instruction to `Forcing Flutter Tools Snapshot Regeneration` (flutter#183977)

gemini-code-assist

Code Review

This pull request improves the clarity of the iOS provisioning profile error message, making it more actionable for developers. The changes are well-implemented and include corresponding test updates. I have one minor suggestion to improve consistency in the command-line output.

… instructions

hellohuanlin · 2026-03-26T03:57:49Z

+    logger.printError('  2. In Runner > Signing & Capabilities, verify:');
    logger.printError(
-      'Verify that the Bundle Identifier in your project is your signing id in Xcode',
+      '     - Team is selected and valid for your Apple Developer account',


Nit: "Team" is set to a valid Apple Developer account

Updated as per your suggestion

hellohuanlin · 2026-03-26T03:58:30Z

+      '     - Team is selected and valid for your Apple Developer account',
    );
-    logger.printError('  open ios/Runner.xcworkspace');
+    logger.printError('     - Bundle Identifier matches your provisioning profile');


This is a bit unclear. Most people would just use auto managed profile

Updated this line. Is it ok now?

hellohuanlin · 2026-03-27T05:13:53Z

    logger.printError(
-      'Verify that the Bundle Identifier in your project is your signing id in Xcode',
+      '     - Bundle Identifier is correct for your app (with automatic signing, '
+      'Xcode manages the provisioning profile)',


It's possible that developers don't use automatic signing. Can you mention both cases? (one with automatic signing, and one with manual signing)?

Updated. this time, I've explicitly mentioned, automatic and manual signing.

…verification

mozammal-hossain · 2026-04-06T11:37:03Z

@LouiseHsu , I've updated this branch with the flutter main branch. Could you please review it again?

LouiseHsu

lgtm, can you fix the failing analyze test?

mozammal-hossain · 2026-04-06T20:59:50Z

can you fix the failing analyze test?

ok, I'm on it.

LouiseHsu · 2026-04-06T21:42:47Z

[2026-04-06 14:40:33.398653] [STDOUT] stdout: Analyzing flutter sdk...                                        
[2026-04-06 14:40:33.400831] [STDOUT] stdout: Analysis benchmark written to analysis_benchmark.json ({time: 71.692, issues: 3}).
[2026-04-06 14:40:33.400897] [STDOUT] stdout: 
[2026-04-06 14:40:33.402589] [STDOUT] stdout:    info • Unnecessary use of double quotes. Try using single quotes unless the string contains single quotes • packages/flutter_tools/lib/src/ios/mac.dart:1144:23 • prefer_single_quotes
[2026-04-06 14:40:33.402678] [STDOUT] stdout:    info • Unnecessary use of double quotes. Try using single quotes unless the string contains single quotes • packages/flutter_tools/test/commands.shard/hermetic/build_ios_test.dart:1174:20 • prefer_single_quotes
[2026-04-06 14:40:33.402702] [STDOUT] stdout:    info • Unnecessary use of double quotes. Try using single quotes unless the string contains single quotes • packages/flutter_tools/test/commands.shard/hermetic/build_ipa_test.dart:1761:18 • prefer_single_quotes
[2026-04-06 14:40:33.402763] [STDOUT] stdout:

mozammal-hossain · 2026-04-06T23:03:32Z

[2026-04-06 14:40:33.398653] [STDOUT] stdout: Analyzing flutter sdk...                                        
[2026-04-06 14:40:33.400831] [STDOUT] stdout: Analysis benchmark written to analysis_benchmark.json ({time: 71.692, issues: 3}).
[2026-04-06 14:40:33.400897] [STDOUT] stdout: 
[2026-04-06 14:40:33.402589] [STDOUT] stdout:    info • Unnecessary use of double quotes. Try using single quotes unless the string contains single quotes • packages/flutter_tools/lib/src/ios/mac.dart:1144:23 • prefer_single_quotes
[2026-04-06 14:40:33.402678] [STDOUT] stdout:    info • Unnecessary use of double quotes. Try using single quotes unless the string contains single quotes • packages/flutter_tools/test/commands.shard/hermetic/build_ios_test.dart:1174:20 • prefer_single_quotes
[2026-04-06 14:40:33.402702] [STDOUT] stdout:    info • Unnecessary use of double quotes. Try using single quotes unless the string contains single quotes • packages/flutter_tools/test/commands.shard/hermetic/build_ipa_test.dart:1761:18 • prefer_single_quotes
[2026-04-06 14:40:33.402763] [STDOUT] stdout:

I've given single quote on the log messages

mozammal-hossain · 2026-04-08T11:00:08Z

This branch was behind of flutter main, so it has blocked by github action. could you please add the ci/cd again?

@LouiseHsu

mozammal-hossain · 2026-04-15T18:12:42Z

@LouiseHsu would you like to approve this PR, as it has passed all the test caes?

mozammal-hossain · 2026-04-15T18:13:20Z

@hellohuanlin please approve this PR.

LouiseHsu · 2026-04-15T18:30:48Z

@LouiseHsu would you like to approve this PR, as it has passed all the test caes?

i was going to approve last week but looks like google testing is stuck. let me try again.

fluttergithubbot · 2026-04-15T18:31:05Z

An existing Git SHA, c03fffd48a74b78edaf5de91a74a919a66f4d312, was detected, and no actions were taken.

To re-trigger presubmits after closing or re-opeing a PR, or pushing a HEAD commit (i.e. with --force) that already was pushed before, push a blank commit (git commit --allow-empty -m "Trigger Build") or rebase to continue.

mozammal-hossain · 2026-04-16T11:17:40Z

@hellohuanlin could you please approve it again?

okorohelijah

from triage: lg

…ter/flutter#184051)

flutter/flutter@31f1802...8e8a194 2026-04-17 98614782+auto-submit[bot]@users.noreply.github.com Reverts "Fix ImageInfo.isCloneOf to correctly compare scale values (fixes #184626) (#184643)" (flutter/flutter#185203) 2026-04-17 98614782+auto-submit[bot]@users.noreply.github.com Reverts "Roll Fuchsia Test Scripts from R2EllDf4DgBXVNuiN... to dQ4PjIJB5kZFU8Y32... (#185192)" (flutter/flutter#185199) 2026-04-17 [email protected] [iOS] Migrate FlutterLaunchEngine to Swift (flutter/flutter#185151) 2026-04-17 [email protected] Remove unused `FlutterRunArguments.java` file (flutter/flutter#184160) 2026-04-17 [email protected] Roll Fuchsia Test Scripts from R2EllDf4DgBXVNuiN... to dQ4PjIJB5kZFU8Y32... (flutter/flutter#185192) 2026-04-17 [email protected] [Impeller] Fix morphology filter asymmetric dilation/erosion (flutter/flutter#184913) 2026-04-17 [email protected] `AnimationStyle` methods (flutter/flutter#182333) 2026-04-17 [email protected] Fix _scheduleSystemFontsUpdate assertion during non-idle scheduler phase (flutter/flutter#184332) 2026-04-17 [email protected] Revert "Unpin sdk package dependencies" (flutter/flutter#185186) 2026-04-16 [email protected] Clarify why the `child` is nullable in `AnimatedTransitionBuilder` (flutter/flutter#182995) 2026-04-16 [email protected] Roll Fuchsia Linux SDK from IdBT8fSMYrYSip65j... to di3JdYrdE9OFu8Iyl... (flutter/flutter#185173) 2026-04-16 [email protected] Add dart_skills_lint to dev/tool with test and update readme instructions for new skills authors (flutter/flutter#185033) 2026-04-16 [email protected] [Impeller] Provide std::optional getter for stroke property (flutter/flutter#185112) 2026-04-16 [email protected] Validate itemExtent with geometry in RenderSliverFixedExtentBoxAdaptor (flutter/flutter#185159) 2026-04-16 [email protected] [iOS] Clarify provisioning profile error instructions (flutter/flutter#184051) 2026-04-16 [email protected] [Widget Preview] Fix flaky integration test timeout during flutter clean (flutter/flutter#184991) 2026-04-16 [email protected] Roll Dart SDK from fbddcbe0cd96 to 7c2564c18770 (2 revisions) (flutter/flutter#185143) 2026-04-16 [email protected] Unpin sdk package dependencies (flutter/flutter#184821) 2026-04-16 [email protected] Fix ImageInfo.isCloneOf to correctly compare scale values (fixes #184626) (flutter/flutter#184643) 2026-04-16 [email protected] Roll Skia from 391cdbe3ffe9 to d8415c5d7b91 (2 revisions) (flutter/flutter#185141) 2026-04-16 [email protected] Sync CHANGELOG.md from stable (flutter/flutter#185166) 2026-04-16 [email protected] Revert "Move widget_preview_scaffold into pub workspace" (flutter/flutter#185164) If this roll has caused a breakage, revert this CL and stop the roller using the controls here: https://autoroll.skia.org/r/flutter-packages Please CC [email protected],[email protected] on the revert to ensure that a human is aware of the problem. To file a bug in Packages: https://github.com/flutter/flutter/issues/new/choose To report a problem with the AutoRoller itself, please file a bug: https://issues.skia.org/issues/new?component=1389291&template=1850622 Documentation for the AutoRoller is here: https://skia.googlesource.com/buildbot/+doc/main/autoroll/README.md

…r#11523) flutter/flutter@31f1802...8e8a194 2026-04-17 98614782+auto-submit[bot]@users.noreply.github.com Reverts "Fix ImageInfo.isCloneOf to correctly compare scale values (fixes #184626) (#184643)" (flutter/flutter#185203) 2026-04-17 98614782+auto-submit[bot]@users.noreply.github.com Reverts "Roll Fuchsia Test Scripts from R2EllDf4DgBXVNuiN... to dQ4PjIJB5kZFU8Y32... (#185192)" (flutter/flutter#185199) 2026-04-17 [email protected] [iOS] Migrate FlutterLaunchEngine to Swift (flutter/flutter#185151) 2026-04-17 [email protected] Remove unused `FlutterRunArguments.java` file (flutter/flutter#184160) 2026-04-17 [email protected] Roll Fuchsia Test Scripts from R2EllDf4DgBXVNuiN... to dQ4PjIJB5kZFU8Y32... (flutter/flutter#185192) 2026-04-17 [email protected] [Impeller] Fix morphology filter asymmetric dilation/erosion (flutter/flutter#184913) 2026-04-17 [email protected] `AnimationStyle` methods (flutter/flutter#182333) 2026-04-17 [email protected] Fix _scheduleSystemFontsUpdate assertion during non-idle scheduler phase (flutter/flutter#184332) 2026-04-17 [email protected] Revert "Unpin sdk package dependencies" (flutter/flutter#185186) 2026-04-16 [email protected] Clarify why the `child` is nullable in `AnimatedTransitionBuilder` (flutter/flutter#182995) 2026-04-16 [email protected] Roll Fuchsia Linux SDK from IdBT8fSMYrYSip65j... to di3JdYrdE9OFu8Iyl... (flutter/flutter#185173) 2026-04-16 [email protected] Add dart_skills_lint to dev/tool with test and update readme instructions for new skills authors (flutter/flutter#185033) 2026-04-16 [email protected] [Impeller] Provide std::optional getter for stroke property (flutter/flutter#185112) 2026-04-16 [email protected] Validate itemExtent with geometry in RenderSliverFixedExtentBoxAdaptor (flutter/flutter#185159) 2026-04-16 [email protected] [iOS] Clarify provisioning profile error instructions (flutter/flutter#184051) 2026-04-16 [email protected] [Widget Preview] Fix flaky integration test timeout during flutter clean (flutter/flutter#184991) 2026-04-16 [email protected] Roll Dart SDK from fbddcbe0cd96 to 7c2564c18770 (2 revisions) (flutter/flutter#185143) 2026-04-16 [email protected] Unpin sdk package dependencies (flutter/flutter#184821) 2026-04-16 [email protected] Fix ImageInfo.isCloneOf to correctly compare scale values (fixes #184626) (flutter/flutter#184643) 2026-04-16 [email protected] Roll Skia from 391cdbe3ffe9 to d8415c5d7b91 (2 revisions) (flutter/flutter#185141) 2026-04-16 [email protected] Sync CHANGELOG.md from stable (flutter/flutter#185166) 2026-04-16 [email protected] Revert "Move widget_preview_scaffold into pub workspace" (flutter/flutter#185164) If this roll has caused a breakage, revert this CL and stop the roller using the controls here: https://autoroll.skia.org/r/flutter-packages Please CC [email protected],[email protected] on the revert to ensure that a human is aware of the problem. To file a bug in Packages: https://github.com/flutter/flutter/issues/new/choose To report a problem with the AutoRoller itself, please file a bug: https://issues.skia.org/issues/new?component=1389291&template=1850622 Documentation for the AutoRoller is here: https://skia.googlesource.com/buildbot/+doc/main/autoroll/README.md

[iOS] Clarify provisioning profile error instructions

c2f0972

mozammal-hossain requested a review from a team as a code owner March 24, 2026 07:47

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 labels Mar 24, 2026

[iOS] Clarify provisioning profile error instructions

0745d22

mozammal-hossain force-pushed the fix/167595-ios-signing-error-message branch from c2f0972 to 0745d22 Compare March 24, 2026 07:49

gemini-code-assist Bot reviewed Mar 24, 2026

View reviewed changes

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

chore: [iOS] Update error message formatting for provisioning profile…

02c7c4a

… instructions

hellohuanlin reviewed Mar 26, 2026

View reviewed changes

[iOS] Enhance error messages for provisioning profile verification

98bbb2e

mozammal-hossain requested a review from hellohuanlin March 26, 2026 06:07

hellohuanlin reviewed Mar 27, 2026

View reviewed changes

chore: [iOS] Further enhance error messages for provisioning profile …

66d5915

…verification

mozammal-hossain requested a review from hellohuanlin March 27, 2026 06:19

hellohuanlin previously approved these changes Mar 27, 2026

View reviewed changes

LouiseHsu self-requested a review April 2, 2026 21:54

LouiseHsu added the CICD Run CI/CD label Apr 2, 2026

Merge branch 'master' into fix/167595-ios-signing-error-message

57c0e68

LouiseHsu added CICD Run CI/CD and removed CICD Run CI/CD labels Apr 3, 2026

Merge branch 'flutter:master' into fix/167595-ios-signing-error-message

de73571

github-actions Bot removed the CICD Run CI/CD label Apr 6, 2026

LouiseHsu added the CICD Run CI/CD label Apr 6, 2026

LouiseHsu previously approved these changes Apr 6, 2026

View reviewed changes

chore: format code with dart formatter

5922979

mozammal-hossain dismissed LouiseHsu’s stale review via 5922979 April 6, 2026 21:15

fix: Update single quotation marks in error messages for consistency

be9e0a1

github-actions Bot removed the CICD Run CI/CD label Apr 6, 2026

LouiseHsu added the CICD Run CI/CD label Apr 7, 2026

Merge branch 'flutter:master' into fix/167595-ios-signing-error-message

c03fffd

github-actions Bot removed the CICD Run CI/CD label Apr 8, 2026

LouiseHsu added the CICD Run CI/CD label Apr 9, 2026

LouiseHsu added CICD Run CI/CD and removed CICD Run CI/CD labels Apr 15, 2026

Merge branch 'master' into fix/167595-ios-signing-error-message

2c1b2f3

LouiseHsu added CICD Run CI/CD and removed CICD Run CI/CD labels Apr 15, 2026

LouiseHsu approved these changes Apr 15, 2026

View reviewed changes

okorohelijah approved these changes Apr 16, 2026

View reviewed changes

okorohelijah added the autosubmit Merge PR when tree becomes green via auto submit App label Apr 16, 2026

auto-submit Bot added this pull request to the merge queue Apr 16, 2026

Merged via the queue into flutter:master with commit dabfef6 Apr 17, 2026
159 of 160 checks passed

flutter-dashboard Bot removed the autosubmit Merge PR when tree becomes green via auto submit App label Apr 17, 2026

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request Apr 17, 2026

dabfef6e3 [iOS] Clarify provisioning profile error instructions (flut…

6a16790

…ter/flutter#184051)

engine-flutter-autoroll mentioned this pull request Apr 17, 2026

Roll Flutter from 31f1802cb859 to 8e8a194923dc (22 revisions) flutter/packages#11523

Merged

Uh oh!

Conversation

mozammal-hossain commented Mar 24, 2026

What is this PR changing or adding, and why?

What changed

If you had to change anything in the flutter/tests repo

Pre-launch Checklist

Uh oh!

gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

Code Review

Uh oh!

Uh oh!

hellohuanlin Mar 26, 2026

Choose a reason for hiding this comment

Uh oh!

mozammal-hossain Mar 26, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

hellohuanlin Mar 26, 2026

Choose a reason for hiding this comment

Uh oh!

mozammal-hossain Mar 26, 2026

Choose a reason for hiding this comment

Uh oh!

hellohuanlin Mar 27, 2026

Choose a reason for hiding this comment

Uh oh!

mozammal-hossain Mar 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

mozammal-hossain commented Apr 6, 2026

Uh oh!

LouiseHsu left a comment

Choose a reason for hiding this comment

Uh oh!

mozammal-hossain commented Apr 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

LouiseHsu commented Apr 6, 2026

Uh oh!

mozammal-hossain commented Apr 6, 2026

Uh oh!

mozammal-hossain commented Apr 8, 2026

Uh oh!

mozammal-hossain commented Apr 15, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

mozammal-hossain commented Apr 15, 2026

Uh oh!

LouiseHsu commented Apr 15, 2026

Uh oh!

fluttergithubbot commented Apr 15, 2026

Uh oh!

mozammal-hossain commented Apr 16, 2026

Uh oh!

okorohelijah left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

mozammal-hossain Mar 26, 2026 •

edited

Loading

mozammal-hossain Mar 27, 2026 •

edited

Loading

mozammal-hossain commented Apr 6, 2026 •

edited

Loading

mozammal-hossain commented Apr 15, 2026 •

edited

Loading