Skip to content

Commit 38eafac

Browse files
authored
Clarify how/when FLUTTER_PREBUILT_ENGINE_VERSION is passed in Flutter's CI (flutter#167204)
See also: flutter/website#11903.
1 parent 3595e7d commit 38eafac

File tree

1 file changed

+18
-0
lines changed

1 file changed

+18
-0
lines changed

docs/tool/Engine-artifacts.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,7 @@
11
# How `flutter` fetches engine artifacts
22

3+
[flutter.dev/to/engine-artifacts](https://flutter.dev/to/engine-artifacts)
4+
35
While in the same repository, the `flutter` (tool), which is used to run and
46
test the framework, needs to know how to download the engine artifacts for the
57
current platform and target device. Engine artifacts include `dart` (the
@@ -49,6 +51,22 @@ stateDiagram-v2
4951
UseMergeBase --> [*]: Done
5052
```
5153

54+
## Flutter CI/CD Testing
55+
56+
On Cocoon (Flutter's internal CI/CD) we _often_ set
57+
`FLUTTER_PREBUILT_ENGINE_VERSION` to the following:
58+
59+
| Branch | Presubmit | Merge Queue | Postsubmit |
60+
| ------------------------- | ------------ | ------------------ | ------------------ |
61+
| `main` | `commit.sha` | _Uses normal flow_ | _Uses normal flow_ |
62+
| `flutter-x.x-candidate.x` | `commit.sha` | N/A[^1] | `commit.sha` |
63+
64+
> NOTE: `engine.version` is intentionally ignored in release candidate
65+
> post-submit builds. See
66+
> [#167010](https://github.com/flutter/flutter/issues/167010).
67+
68+
[^1]: Release candidates do not use a merge queue.
69+
5270
## References
5371

5472
The script(s) that compute (and test the computation of) the engine version:

0 commit comments

Comments
 (0)