flutter/dev/README.md
keyonghan c98a64f554
Add run_if property for existing LUCI try builders (#64180)
* add run_if property for existing try builders

* update

* update readme
2020-08-20 17:28:12 -07:00

47 lines
1.3 KiB
Markdown

This directory contains tools and resources that the Flutter team uses
during the development of the framework. The tools in this directory
should not be necessary for developing Flutter applications, though of
course, they may be interesting if you are curious.
The tests in this directory are run in the `framework_tests_misc-*`
shards.
## Luci builder file
`try_builders.json` and `prod_builders.json` contain the supported luci
try/prod builders for flutter.
### `try_builders.json`
It follows format:
```json
{
"builders":[
{
"name":"yyy",
"repo":"flutter",
"taskName":"zzz",
"enabled":true,
"run_if":["a/b/", "c/d/**"]
}
]
}
```
* enabled(optional): `true` is the default value if unspecified
* run_if(optional): will always be triggered if unspecified
### `prod_builders.json`
It follows format:
```json
{
"builders":[
{
"name":"yyy",
"repo":"flutter",
"taskName":"zzz",
"flaky":false
}
]
}
```
`try_builders.json` will be mainly used in
[`flutter/cocoon`](https://github.com/flutter/cocoon) to trigger/update pre-submit
flutter luci tasks, whereas `prod_builders.json` will be mainly used in `flutter/cocoon`
to refresh luci task statuses to [dashboard](https://flutter-dashboard.appspot.com).