Skip to content
This repository was archived by the owner on Feb 25, 2025. It is now read-only.

Document the use of contexts on engine_v2 tests. #43013

Merged
auto-submit merged 2 commits into from
Jun 21, 2023
Merged

Document the use of contexts on engine_v2 tests. #43013

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
2c5b32b
Document the use of contexts on engine_v2 tests.
godofredoc Jun 20, 2023
40b3716
Fix typo.
godofredoc Jun 20, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 9 additions & 1 deletion ci/builders/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -283,7 +283,8 @@ configuration.
"impeller-vulkan",
"--engine-capture-core-dump"
],
"script": "flutter/testing/run_tests.py"
"script": "flutter/testing/run_tests.py",
"contexts": ["android_virtual_device"]
}
]
```
Expand All @@ -299,6 +300,9 @@ permissions to run in the target platform.
* **parameters** - flags or parameters passed to the script.
* **Script** - the path to the script to execute relative to the checkout
directory.
* **contexts** - a list of available contexts to add to the text execution step.
The list of supported contexts can be found [here](https://flutter.googlesource.com/recipes/+/refs/heads/main/recipe_modules/flutter_deps/api.py#687). As of 06/20/23 two contexts are supported:
"android_virtual_device" and "metric_center_token".

The test scripts will run in a deferred context (failing the step only after
logs have been uploaded). Tester and builder recipes provide an environment
Expand All @@ -307,6 +311,10 @@ test runner can place any logs|artifacts needed to debug issues. At the end
of the test execution the content of FLUTTER\_LOGS\_DIR will be uploaded to
Google Cloud Storage before signaling the pass | fail test state.

Contexts are free form python contexts that communicate with the test script
through environment variables. E.g. metric_center_token saves an access token
to an [environment variable "token_path"](https://flutter.googlesource.com/recipes/+/refs/heads/main/recipe_modules/token_util/api.py#14) for the test to access it.

Note that to keep the recipes generic they don’t know anything about what
the test script is doing and it is the responsibility of the test script to
copy the relevant files to the FLUTTER\_LOGS\_DIR directory.
Expand Down