Expose the app's build name and number as compile-time constants by Ortes · Pull Request #187935 · flutter/flutter

Ortes · 2026-06-12T17:11:42Z

The tool already injects FLUTTER_VERSION, FLUTTER_CHANNEL, framework/engine revisions (exposed as FlutterVersion) and FLUTTER_APP_FLAVOR (exposed as appFlavor) as dart-defines. The application's own version: from pubspec.yaml is the one missing field, even though the tool already parses it (FlutterManifest.buildName/buildNumber) and embeds it into version.json, Info.plist and build.gradle on every build.

Without it, the running version is unknowable on the web: version.json is fetched from the server at runtime, so a stale cached client reports the freshly deployed version instead of its own, and version gates / update prompts built on package_info_plus silently fail for exactly the users they exist for (fluttercommunity/plus_plugins#2675).

This PR:

injects FLUTTER_BUILD_NAME and FLUTTER_BUILD_NUMBER (the app's pubspec version, overridable via --build-name/--build-number) in FlutterCommand.getBuildInfo, following the FLUTTER_APP_FLAVOR pattern including its reserved-name guards;
exposes them as appBuildName / appBuildNumber constants in package:flutter/services.dart (new src/services/app_version.dart, same style as flavor.dart / flutter_version.dart);
adds tool tests (injection from pubspec, no injection without a version, environment/dart-define collision guards) and framework tests.

Like all String.fromEnvironment constants, these are tree-shaken when unreferenced, so nothing ships in the binary unless the app reads them.

package_info_plus is ready to consume these defines (fluttercommunity/plus_plugins#3874), which would make the fix transparent for the ecosystem. A companion proposal for the pure-Dart side (dart compile, servers/CLIs) is dart-lang/sdk#38855 — neither subsumes the other, since Flutter does not build through dartdev.

Fixes #187934

Pre-launch Checklist

gemini-code-assist

Code Review

This pull request introduces 'appBuildName' and 'appBuildNumber' constants to the services library, allowing applications to access their build name and build number at runtime. These values are injected into 'dartDefines' during the build process, with validation to prevent users from manually overriding them. Feedback suggests refining the validation logic when checking existing 'dartDefines' to avoid false positives on custom variables that share a prefix with the framework-defined build variables.

…allbacks PackageInfoEnvironment now resolves the web version from, in order: PACKAGE_INFO_PLUS_VERSION (explicit), FLUTTER_BUILD_NAME (flutter/flutter#187935, injected by flutter_tools like FLUTTER_APP_FLAVOR), and dart.package.version (dart-lang/sdk#38855). Once either upstream proposal lands, apps need no configuration at all.

bkonyi

This generally LGTM with some minor comments. We'll also need someone from the framework to sign off on the changes to packages/flutter/.

loic-sharma · 2026-06-30T22:49:07Z

Hello @Ortes, apologies for the late review! This looks good to me, but let's add an integration test for the framework side (see this comment).

Also, could you rebase these changes off the latest master branch?

Once that's done, I'll kick off tests and get this landed! :)

loic-sharma

Thanks for the wonderful contribution!

Ortes · 2026-07-01T23:33:47Z

Thanks for the wonderful contribution!

Thanks for your amazing maintainer work!

Ortes · 2026-07-02T11:53:05Z

CI was red on the Linux and Mac_arm64 tool_tests_commands shards. Exposing FLUTTER_BUILD_NAME / FLUTTER_BUILD_NUMBER prepends two entries to the -Pdart-defines argument passed to Gradle, which broke the hardcoded command expectations in build_apk_test.dart (6 tests) and build_aar_test.dart (1 test).

Fixed in ab03bcb by adding the two defines to those expected dart-defines maps. The shard passes locally now.

loic-sharma

Thanks!

auto-submit · 2026-07-08T00:27:27Z

autosubmit label was removed for flutter/flutter/187935, because - The status or check suite Linux web_skwasm_tests_0 has failed. Please fix the issues identified (or deflake) before re-applying this label.

Ortes · 2026-07-08T11:16:29Z

The Linux web_skwasm_tests_0 failure looks like an infra flake rather than an issue with this PR:

The build (8676892560572427201) ended as INFRA_FAILURE with a timeout, not a test failure.
The log shows 2,224 tests passing in under 3 minutes, then the runner goes silent while loading test/cupertino/text_field_restoration_test.dart until the build timeout cancelled the step ~40 minutes later. No error, exception, or failing test appears anywhere in the log.
The test added by this PR (test/services/app_version_test.dart) is not in shard 0's test list, and the sibling shard Linux web_skwasm_tests_1 passed.

Re-running the shard should clear it.

…12169) Manual roll Flutter from 91939cc4db78 to dc2a8703e12b (50 revisions) Manual roll requested by [email protected] flutter/flutter@91939cc...dc2a870 2026-07-09 [email protected] [ios,macos] Update swiftc.py flags to match swiftc (flutter/flutter#189174) 2026-07-09 [email protected] [AGP 9] Update Warn Version to AGP 9+ (flutter/flutter#189109) 2026-07-09 [email protected] Sync CHANGELOG.md from stable (flutter/flutter#189203) 2026-07-09 [email protected] [web] Roll Chrome to 145 (framework) (flutter/flutter#182861) 2026-07-09 [email protected] Roll Packages from 52d84d6 to 20928d5 (6 revisions) (flutter/flutter#189194) 2026-07-09 [email protected] [web] Avoid absolute positioning for base CanvasKit canvas (flutter/flutter#188337) 2026-07-09 [email protected] Roll Dart SDK from cdb7217e65aa to a11fb7ed40a5 (6 revisions) (flutter/flutter#189195) 2026-07-09 [email protected] Fix dereference of nullptr in the moved-to-rect signal in the Linux embedder (flutter/flutter#189152) 2026-07-09 [email protected] Fix data for design packages (flutter/flutter#189140) 2026-07-09 [email protected] Roll Skia from 7b42d1251d54 to ab3a7b98c94d (2 revisions) (flutter/flutter#189181) 2026-07-09 [email protected] Roll Skia from 05d9d214e0b7 to 7b42d1251d54 (2 revisions) (flutter/flutter#189175) 2026-07-09 [email protected] Roll Skia from 542c8bdd7f4f to 05d9d214e0b7 (4 revisions) (flutter/flutter#189169) 2026-07-09 [email protected] UberSDF rect handling for thin (line-like) rectangles (flutter/flutter#188821) 2026-07-09 [email protected] Roll Skia from dd572c07f63c to 542c8bdd7f4f (4 revisions) (flutter/flutter#189160) 2026-07-09 [email protected] [flutter_tools] Fix hot restart for WASM web builds (flutter/flutter#187898) 2026-07-08 [email protected] Split FlViewRenderer into OpenGL and software backends (flutter/flutter#188824) 2026-07-08 [email protected] Promote android_hardware_smoke_tests out of bringup in CI (flutter/flutter#189081) 2026-07-08 [email protected] Roll Skia from 8df24be66531 to dd572c07f63c (4 revisions) (flutter/flutter#189150) 2026-07-08 [email protected] Expose LinuxWindowRegistrar on _window_linux.dart in order to better support out of tree LinuxWindowingOwners (flutter/flutter#188917) 2026-07-08 [email protected] Roll pub packages (flutter/flutter#189149) 2026-07-08 [email protected] fix(ci): harden some workflows (flutter/flutter#189087) 2026-07-08 [email protected] Roll Skia from 51a62da33da0 to 8df24be66531 (1 revision) (flutter/flutter#189139) 2026-07-08 [email protected] Roll Dart SDK to Dart 3.13 beta3 (flutter/flutter#189122) 2026-07-08 [email protected] [flutter_tools] Don't crash on non-UTF-8 plugin pubspec.yaml (flutter/flutter#188976) 2026-07-08 [email protected] [flutter_tools] Watch transitive #include headers for FragmentProgram hot reload (flutter/flutter#187945) 2026-07-08 [email protected] Roll Skia from 040d9f55de00 to 51a62da33da0 (1 revision) (flutter/flutter#189135) 2026-07-08 [email protected] Roll Packages from 92525f5 to 52d84d6 (7 revisions) (flutter/flutter#189134) 2026-07-08 [email protected] [flutter_tools] Forcefully kill hung subprocesses 5 seconds after timeout (flutter/flutter#187178) 2026-07-08 [email protected] Expose the app's build name and number as compile-time constants (flutter/flutter#187935) 2026-07-08 [email protected] Roll Skia from 1ff92f879815 to 040d9f55de00 (1 revision) (flutter/flutter#189131) 2026-07-08 [email protected] Roll Skia from 6137414bef5c to 1ff92f879815 (6 revisions) (flutter/flutter#189126) 2026-07-08 [email protected] [test cross imports] More test/rendering + flutter_test/test fixes (flutter/flutter#188954) 2026-07-08 [email protected] engine: explain why each candidate build was skipped in Flutter web loader (flutter/flutter#186254) 2026-07-08 [email protected] vscode: add missing unicode.h (flutter/flutter#189102) 2026-07-08 [email protected] Roll Fuchsia Linux SDK from 7RjQJBW3m-3Jl-7jr... to QcRFUtvCw2EobfJ8s... (flutter/flutter#189104) 2026-07-08 [email protected] Roll Skia from 075fbe4778d9 to 6137414bef5c (10 revisions) (flutter/flutter#189106) 2026-07-08 [email protected] engine: warn on WASM load failure when not crossOriginIsolated (flutter/flutter#186252) 2026-07-08 [email protected] Roll Dart SDK from c9bccc09e733 to db2155f56bf3 (2 revisions) (flutter/flutter#189105) 2026-07-08 [email protected] [flutter_tools] Prevent interactive device selection in machine mode (flutter/flutter#188267) 2026-07-08 [email protected] [flutter_tools] Fix wireless ADB device discovery when serial contains spaces (flutter/flutter#187943) 2026-07-07 [email protected] [web] Fix grouped autofill on iOS Chrome (flutter/flutter#187459) 2026-07-07 [email protected] Fix TextSelectionOverlay crash when layout is degenerate (flutter/flutter#188672) 2026-07-07 [email protected] [flutter_tools] Provision Android NDK in the main Gradle invocation (flutter/flutter#186337) 2026-07-07 [email protected] Android_hardware_smoke_test: Migrate to AGP 9 (flutter/flutter#189082) ...

github-actions Bot added tool Affects the "flutter" command-line tool. See also t: labels. framework flutter/packages/flutter repository. See also f: labels. labels Jun 12, 2026

gemini-code-assist Bot reviewed Jun 12, 2026

View reviewed changes

Comment thread packages/flutter_tools/lib/src/runner/flutter_command.dart Outdated

Ortes force-pushed the expose-build-name-defines branch from 58b0f53 to ebcb817 Compare June 15, 2026 11:23

bkonyi added team-framework Owned by Framework team team-tool Owned by Flutter Tool team labels Jun 16, 2026

bkonyi reviewed Jun 16, 2026

View reviewed changes

Comment thread packages/flutter_tools/lib/src/runner/flutter_command.dart Outdated

Comment thread packages/flutter_tools/lib/src/runner/flutter_command.dart Outdated

kjxbyz mentioned this pull request Jun 18, 2026

Issues with the way appVersion is obtained fastforgedev/fastforge#207

Open

github-actions Bot removed the team-tool Owned by Flutter Tool team label Jun 18, 2026

Ortes force-pushed the expose-build-name-defines branch 2 times, most recently from 29b3949 to 72d3f13 Compare June 25, 2026 16:14

justinmc requested a review from loic-sharma June 30, 2026 22:25

loic-sharma reviewed Jun 30, 2026

View reviewed changes

Comment thread packages/flutter/test/services/app_version_test.dart

Ortes force-pushed the expose-build-name-defines branch from 72d3f13 to d3a9a37 Compare June 30, 2026 23:16

loic-sharma previously approved these changes Jul 1, 2026

View reviewed changes

loic-sharma added the CICD Run CI/CD label Jul 1, 2026

Ortes dismissed loic-sharma’s stale review via ab03bcb July 2, 2026 10:44

flutter-dashboard Bot removed the CICD Run CI/CD label Jul 2, 2026

Ortes force-pushed the expose-build-name-defines branch from ab03bcb to 2bb1531 Compare July 2, 2026 12:22

bkonyi approved these changes Jul 3, 2026

View reviewed changes

Ortes force-pushed the expose-build-name-defines branch from 2bb1531 to 2688822 Compare July 3, 2026 18:37

flutter-dashboard Bot removed the CICD Run CI/CD label Jul 3, 2026

Ortes requested a review from loic-sharma July 3, 2026 19:23

loic-sharma approved these changes Jul 7, 2026

View reviewed changes

loic-sharma added CICD Run CI/CD autosubmit Merge PR when tree becomes green via auto submit App labels Jul 7, 2026

auto-submit Bot removed the autosubmit Merge PR when tree becomes green via auto submit App label Jul 8, 2026

bkonyi added the autosubmit Merge PR when tree becomes green via auto submit App label Jul 8, 2026

auto-submit Bot added this pull request to the merge queue Jul 8, 2026

Merged via the queue into flutter:master with commit 8741012 Jul 8, 2026
177 checks passed

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

Piinks mentioned this pull request Jul 10, 2026

Flutter Notable Commits - 2026 #181433

Open

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Expose the app's build name and number as compile-time constants#187935

Expose the app's build name and number as compile-time constants#187935
auto-submit[bot] merged 5 commits into
flutter:masterfrom
Ortes:expose-build-name-defines

Ortes commented Jun 12, 2026 •

edited

Loading

Uh oh!

gemini-code-assist Bot left a comment

Uh oh!

Uh oh!

bkonyi left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

loic-sharma commented Jun 30, 2026

Uh oh!

loic-sharma left a comment

Uh oh!

Ortes commented Jul 1, 2026 •

edited

Loading

Uh oh!

Ortes commented Jul 2, 2026

Uh oh!

loic-sharma left a comment

Uh oh!

auto-submit Bot commented Jul 8, 2026

Uh oh!

Ortes commented Jul 8, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Uh oh!

Conversation

Ortes commented Jun 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

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!

bkonyi left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

loic-sharma commented Jun 30, 2026

Uh oh!

loic-sharma left a comment

Choose a reason for hiding this comment

Uh oh!

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

Uh oh!

Uh oh!

Ortes commented Jul 2, 2026

Uh oh!

loic-sharma left a comment

Choose a reason for hiding this comment

Uh oh!

auto-submit Bot commented Jul 8, 2026

Uh oh!

Ortes commented Jul 8, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Ortes commented Jun 12, 2026 •

edited

Loading

Ortes commented Jul 1, 2026 •

edited

Loading