Matan Lurey 55c4543094 Implement .engine-release.version files for engine Skia Gold tests (flutter/engine#51739)
Work towards https://github.com/flutter/flutter/issues/144835.

Doc (_sorry, internal only_): [go/flutter-engine-goldens-workflow](http://goto.google.com/flutter-engine-goldens-workflow).

This implements the majority of the proposed workflow, that is, optionally having a plain-text version at the root of the directory, and using it to apply a unique suffix we can review in release branches. As it stands, this is a NO-OP outside of tests (it will have no impact, and can be ignored).

What's missing before using this feature in release branches:

- Optimization work with the infra team (not sure if blocking or not):
  https://github.com/flutter/flutter/issues/145842
- A dry-run of this with the release team to make sure it works as intended

@gaaclarke As implemented, I _think_ we don't need anything special for [`dir_contents_diff`](286169bb52/tools/dir_contents_diff), but maybe I'm wrong - I think only the _test_ names are being changed, not the names on disk.

/cc @zanderso as well.
2024-03-29 17:36:08 +00:00
..

package:litetest

This is a wrapper around package:async_helper from the Dart SDK source repo at //pkg/async_helper that works in the environment of flutter_tester. This wrapper is needed to ensure that all tests run to completion before the process exits. This is accomplished by opening a ReceivePort for each test, which is only closed when the test finishes running.

Limitations

This package is intended only for use in the flutter/engine repo by unit tests that run on flutter_tester. Even though the API resembles the API provided by package:test, it has all the same limitations that package:async_helper has.